Giter Club home page Giter Club logo

documember's Introduction

Documember

A Python application to scan a given module for undocumented members.

Usage

With Python 3.11+ and Git, you can install this application with:

pip install git+https://github.com/thegamecracks/documember@v0.1.5

Then invoke the CLI using documember or python -m documember.

Examples

Showing public members in a module:

$ pip install git+https://github.com/thegamecracks/asyreader
$ documember asyreader
asyreader (undocumented)
  reader (undocumented)
    AsyncReader
      close()
      read()
      start()
    Readable (inherited)
      close() (undocumented)
      read() (undocumented)
  AsyncReader
    close()
    read()
    start()
  Readable (inherited)
    close() (undocumented)
    read() (undocumented)

Showing public and private members:

$ documember asyreader --include-private
asyreader (undocumented)
  reader (undocumented)
    AsyncReader
      ._read_queue
      ._thread
      ._file
      ._start_fut
      ._is_closing
      ._close_fut
      _cancel_queue() (undocumented)
      _open_file() (undocumented)
      ...

Showing dunder/magic methods:

$ documember asyreader --include-dunder
asyreader (undocumented)
  reader (undocumented)
    AsyncReader
      __aenter__() (undocumented)
      __aexit__() (undocumented)
      __init__() (inherited)
      close()
      ...

Showing imported members:

$ documember asyreader --include-imported
asyreader (undocumented)
  reader (undocumented)
    AsyncReader
      close()
      read()
      start()
    Readable (inherited)
      close() (undocumented)
      read() (undocumented)
    typing.Any
    typing.Generic
    typing.ParamSpec
    typing.Protocol
    ...

Showing docstrings for members that are documented:

$ documember asyreader --show-docstrings
asyreader (undocumented)
  reader (undocumented)
    AsyncReader
      close()
        Close the current file and wait for the reader to stop.
      read()
        Request the file to be read by the reader thread.
      ...
$ documember asyreader --show-full-docstrings
asyreader (undocumented)
  reader (undocumented)
    AsyncReader
      close()
        Close the current file and wait for the reader to stop.

        If a function was given to open the file, any exceptions raised
        by it will be propagated here.

        This method is idempotent.
      ...

Showing members in a module that defines __all__:

# In this case,
# __all__ = ("ModuleSummary", "parse_module", "format_module_summary")
$ documember documember
documember (__all__)
  ModuleSummary
    .name
    .qualname
    .all
    .doc
    .submodules
    .classes
    .functions
  format_module_summary
  parse_module

$ documember documember --ignore-all
documember (__all__)
  DocstringDetail (undocumented)
    FULL
    NONE
    ONE_LINE
  ModuleSummary
    ...
  format_module_summary
  main (undocumented)
  parse_module

Resources

License

This project can be used under the MIT License.

documember's People

Contributors

thegamecracks avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.