/pymarkdoc

Generate Markdown documentation from your Python docstrings

Primary LanguagePythonISC LicenseISC

Python Markdown Doc

Travis-CI Build Status PyPI Package latest release PyPI Wheel Updates Join the chat at https://gitter.im/Pawamoy/pymarkdoc

Generate Markdown doc from your Python docstrings

License

Software licensed under ISC license.

Installation

pip install pymarkdoc

Documentation

http://pymarkdoc.readthedocs.io/en/latest/

Development

To run all the tests: tox

I need help to make this tool available on command line. The thing is that getdoc needs a module as an object to get its documentation, so we have to import it. To import it, all the modules it is importing have to be installed (either on the system or in the current virtual environment). Python path also must have been set correctly. Even more, in the case of a Django project, settings have to be set up. This require many options and checks to be developed!

Todo:

  • Make tool available on command line
  • Add a command-line option to specify a virtualenv to activate
  • Add command-line options to work with frameworks (Django, Flask, ...)
  • Add command-line options to configure the rendering method