Skip to main content

First, what Doc-Gen is not: it does not build documentation nor does it serve any role in what you do after you write the documentation. In fact, it does what its name says: it helps you write documentation.

When I code, I often find it hard to write docstrings; these bits of inline documentation make navigating around the file a hassle. To move all docstrings out of file yet still have them remain recognizable to other libraries, that is the purpose of this library.

How to use this library

This library has a shell script, doc, and a decorator, doc. Pretty easy to remember. To use this library, you have to decorate the functions which you want with doc, like so:

# source.py

@doc
def function(x, y):
     return 2 * x + y

Then, in the terminal, you should type doc source.py, and you should see a prompt asking you for a docstring for function.

After that, drop into the shell and check out the docstring of function:

>>> import source
>>> source.function.__doc__
'<whatever you wrote>'

Sweet, isn’t it?

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

doc-gen-0.0.1.tar.gz (7.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

doc_gen-0.0.1-py2.py3-none-any.whl (4.6 kB view details)

Uploaded Python 2Python 3

File details

Details for the file doc-gen-0.0.1.tar.gz.

File metadata

  • Download URL: doc-gen-0.0.1.tar.gz
  • Upload date:
  • Size: 7.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.25.1

File hashes

Hashes for doc-gen-0.0.1.tar.gz
Algorithm Hash digest
SHA256 c57f580541071a0a1f267a75dc1ff26b66f45df91fd1b14cbd70693c7ebdfe96
MD5 a7ac49606a8ff524639f9a98dee2774b
BLAKE2b-256 a578453c97cb09556f286ef8ef0363fda61b3fe877992b7a96d3b70eaf96f8ba

See more details on using hashes here.

File details

Details for the file doc_gen-0.0.1-py2.py3-none-any.whl.

File metadata

  • Download URL: doc_gen-0.0.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 4.6 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.25.1

File hashes

Hashes for doc_gen-0.0.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 975f27062288e991d527a1a124f8fa673336bd47357de0c286f5e029e8a54714
MD5 1d57e534d5b335d8339d9697d7e5172a
BLAKE2b-256 23095b18f3f66acf5f07667f52a72db9466fe716476b84a1b7b7f0e343eda171

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.0.1 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page