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.
cd path/to/folder
mkdocs serve
- Build and deploy documentation
Seemkdocs
documentation.
Alternative usage
- Create pandera schema
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 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.
from data_documenter.pandera_plugin import pandera_to_markdown
text_markdown = pandera_to_markdown(schema, title = 'Homepage')
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.3.tar.gz
(5.3 kB
view hashes)
Built Distribution
Close
Hashes for data_documenter-0.3.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cb754d3f66619b7f9f24f3a4f2e3e92cae3a6cc01f85b96721db529a4e5bf0d6 |
|
MD5 | 6b8d3fc2d92e64971f7adb1ed0ad86f6 |
|
BLAKE2b-256 | f59107807356fcd1d1ac47dabe36ff8dd96ebe2aef918ecfe2a98cbb14b95b50 |