Metadata-Version: 2.1
Name: pydoc2md
Version: 0.0.0.2
Summary: Converts python code to markdown docs
Home-page: https://github.com/FedeClaudi/pydoc2md
Author: Federico Claudi
License: UNKNOWN
Description: # pydoc2md
        inspired by https://github.com/gbowerman/py2md
        
        
        `pydoc2md` is lightweight python application that generates markdown (`.md`) files from a repository of `.py`. The idea is to easily generate bare bones documentation for a python project by providing a list of all classes and functions, each with their docstring. 
        
        ----
        
        A `.md` file is generated for each `.py` in the input didirectoryrection or in its subfolders. 
        This `.md` file includes all class/functions defined in the `.py` with a brief description. The result is something that looks like this: 
        ![](screenshots/pydoc2md.png)
        
        ## Roadmap
        This package is currently under development, bugs and breaking changes are almost garuanteed. 
        Features that will be added soon:
        
        - [x] output folder structure: option to save the output `md` in a folder structure mirroring that of the input package
        - [x] overall table of content: table of content with an overview of all `.md` files and how they're organised
        - [ ] > suggest new features you'd like to see added?
        
        
        ## Usage
        **using pydoc2md** is very simple. From the command line:
        ```
            pydoc2md project/path output/path
        ```
        
        For instance, the `.md` files in [Docs](Docs) where generated with
        ```
            pydoc2md Github/pydoc2md/pydoc2md Github/pydoc2md/Docs
        ```
        
        ## Installation
        Currently you can isntall  with:
        
        ```
        pip install git+https://github.com/FedeClaudi/pydoc2md.git
        ```
        
        though a pip installable version will be released when the project is more mature.
        
Platform: UNKNOWN
Requires-Python: >=3.6,
Description-Content-Type: text/markdown
