A generator for python files docstrings
Project description
Cosmo Docs
Cosmo Docs is a powerful package that serves as a parser for describing functions and classes in a Python script. It provides detailed information about functions and classes, and can generate the information in markdown format. This makes it easy to document and share code documentation in a standardized and readable format.
With Cosmo Docs, you can effortlessly extract information about the structure, parameters, and return values of functions and classes in your Python code. This package is particularly useful for generating documentation for libraries, frameworks, and large codebases, where maintaining up-to-date documentation can be a challenging task.
Whether you are a developer looking to document your own code or a user exploring a Python package, Cosmo Docs simplifies the process of understanding and utilizing the available functions and classes. By providing clear and concise documentation in markdown format, Cosmo Docs enhances code readability and promotes collaboration among developers.
Get started with Cosmo Docs today and unlock the power of comprehensive code documentation!
Getting Started
Installation
To install Cosmo Docs, run the following command:
pip install cosmo-docs
Usage
To use Cosmo Docs, import the cosmo_docs
module and call the generate_docs
function. The generate_docs
function takes in a Python script as input and returns a string containing the documentation in markdown format.
from cosmo_docs import CosmoDocs
cosmos = CosmosDocs("tests/data/sample_file.py")
# to get the file information in CosmoDocsInfo dict format
# if you want use it for easy intellisense: from cosmo_docs import CosmoDocsInfo
print(cosmos.file_info)
# to get the file information in markdown format
print(cosmos.markdown)
Note: You can create your own formats from
comos.file_info
dict.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for cosmodocs-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5b95ffff7befe0734db63dffe508882af837433d7341c03b4b3e9d0f83339e30 |
|
MD5 | cbbe2061dd50cf6c7102679fb56ca053 |
|
BLAKE2b-256 | 577faaedcc71bf4b18f1ac116412d034955376eed7e1a853058f85a68d3f228c |