Metadata-Version: 2.1
Name: doks
Version: 0.9.3
Summary: Automatically generated READMEs
Home-page: https://github.com/rec/doks
Author: Tom Ritchford
Author-email: tom@swirly.com
License: MIT
Keywords: documentation
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Utilities
Requires-Dist: impall
Requires-Dist: pyyaml
Requires-Dist: safer

📚 doks: Automatically create READMEs from your code 📚
====================================================================

Reads the comments from your file and puts them into a servicable .rst
file.

Very suitable for single-file Python libraries that want to keep the code
and documentation in sync without issues

USAGE
-------

.. code-block:: bash

    doks my_file.py [README.rst]

API
***

``doks.doks.doks(source, target=None)``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

(`doks/doks.py, 32-59 <https://github.com/rec/doks/blob/master/doks/doks.py#L32-L59>`_)


Print documentation for a file or module

ARGUMENTS
  path
    path to the Python file or module.

  target
    path to the output file or ``None``, in which case
    output is printed to stdout

(automatically generated by `doks <https://github.com/rec/doks/>`_ on 2020-05-29T15:57:37.715176)


