No project description provided
Project description
Data Documenter
A package to generate documentation from pandera schema using mkdocs material.
Installation
pip install data-documenter
Quick start
- Create schema using
pandera
from pandera import DataFrameSchema, Column
schema = DataFrameSchema(
title="Title of dataset",
description="Description of dataset",
columns={
"COLUMN_NAME": Column(
dtype="str",
nullable=False,
unique=True,
description="Description of column",
title="Column Name"
),
},
)
- Create documentation using schema
from data_documenter.pandera_plugin import create_documentation
docs = create_documentation(
schema,
docs_path = 'docs_folder',
title = 'page title',
filename = 'index.md'
)
- Run server
docs.run()
- Stop server
docs.stop()
!!!
It is better to use mkdocs
command instead of run
, stop
for better control of processes. See alternative usage.
sh cd path/to/folder mkdocs serve
- Build and deploy documentation
Seemkdocs
documentation.
Alternative usage
- Create new folder for documentation server.
from data_documenter.metadocs import MetaDocs
docs = MetaDocs(docs_path = 'my_docs')
docs.new()
This will simply run mkdocs new my_docs
and replace mkdocs.yml
file.
- Save documentation for schema in a markdown file.
text_markdown = pandera_to_markdown(schema)
docs.save_markdown(text_markdown, filename = 'index.md')
- See documentation.
cd my_docs
mkdocs serve
- Build and deploy
Seemkdocs
documentation.
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
data_documenter-0.3.1.tar.gz
(5.3 kB
view hashes)
Built Distribution
Close
Hashes for data_documenter-0.3.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9462241a8a43217d35b27679bf923ed9f041315a90c1880aa94d4180bea9aaae |
|
MD5 | 60a1d4ce9a59c34f86e672ca5ef9d7cb |
|
BLAKE2b-256 | feecef49171b01fffa484eb4d652798802ec962a3ed4d65173c34ed488347ce5 |