Skip to main content

Minimalistic Python documentation for dendrophiles.

Project description

Build Status PyPI version Downloads Black License: MIT

Minimalistic Python documentation for dendrophiles.

treedoc prints minimalistic Python documentation in a tree structure, aiming to hit the sweet spot between detailed information about a single object and superficial information about object attributes.

treedoc is great for:

  • Getting an overview of a package without endlessly scrolling through a website.
  • Searching through documentation.
  • Printing essential information about different Python objects.

Installation

Install from Python Package Index (PyPI) using pip install treedoc.

Usage

treedoc can be used directly through the command-line interface, or interactively in a Python shell or Jupyter notebook. For more information about arguments, see treedoc --help or help(treedoc).

Command-line interface

Example 1 - See the GitHub repo

Example 2 - See the GitHub repo

Example 3 - See the GitHub repo

Python shell and notebooks

treedoc can be imported and used just like any other package, e.g. in an interactive Python interpreter session or a Jupyter notebook.

Interpreter

Example 4 - See the GitHub repo

Jupyter notebook

Example 5 - See the GitHub repo

Contributing

Contributions are welcome. If you wish to work on a problem, please create a draft pull request to get feedback. We aim for:

  • Zero dependencies, but dependencies for testing are ok.
  • Idiomatic, clean Python code. Readability matters.
  • Thorough testing and code formatting, see .travis.yml for commands run by continuous integration.

Project details


Download files

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

Source Distribution

treedoc-0.4.1.tar.gz (1.2 MB view details)

Uploaded Source

File details

Details for the file treedoc-0.4.1.tar.gz.

File metadata

  • Download URL: treedoc-0.4.1.tar.gz
  • Upload date:
  • Size: 1.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3

File hashes

Hashes for treedoc-0.4.1.tar.gz
Algorithm Hash digest
SHA256 3e95e87a1f6dad34a3912e4c09b552097d8cff99dca570090fec51e6cf078b3e
MD5 6621b17fd42d324501184e1cb7e8cc68
BLAKE2b-256 b40b6b49f64854d2da80f85d115ee99ca17cc643aaf3b32718c393bbb612731f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page