Generate Markdown documentation from a table schema file from Frictionless Data
Project description
Table Schema to Markdown
Create a Markdown documentation file from a Table Schema file.
The original scripts are coming from doc-generator for the Validata project, which are now available as an npm package.
Installation
pip install table-schema-to-markdown
Usage
Command line tool
The package provides a command line tool.
$ table-schema-to-md -h
usage: table-schema-to-md [-h] [-o OUTPUT] [--log LOG] table_schema
positional arguments:
table_schema path or URL of table schema file
optional arguments:
-h, --help show this help message and exit
-o OUTPUT, --output OUTPUT
Output file name
--log LOG level of logging messages
Example:
# Print generated Markdown
table-schema-to-md schema.json
# Save to Markdown file
table-schema-to-md schema.json -o documentation.md
In Python
from table_schema_to_markdown import convert_source
# Generate a Markdown documentation from a JSON file
table_schema = '/tmp/schema.json'
with open('/tmp/doc.md', 'a') as out:
convert_source(table_schema, out)
# Generate Markdown documentation in a string
import io
with io.StringIO() as buff:
convert_source(table_schema, buff)
documentation = buff.getvalue()
Generated documentation example
This table schema file is rendered in Markdown in this file.
Find a generated documentation file below.
Métadonnées d'un répertoire Git
- Auteur : Antoine Augusti antoine.augusti@example.com
- Schéma créé le : 12/31/18
- Site web : https://github.com/AntoineAugusti/data-codes-sources-fr
- Clé primaire :
repertoire_url
Modèle de données
Nom | Type | Description | Exemple | Propriétés |
---|---|---|---|---|
nom | chaîne de caractères | Le nom du répertoire | nom-repertoire | Valeur obligatoire |
organisation_nom | chaîne de caractères | Le nom de l'organisation | etalab | Valeur obligatoire |
plateforme | chaîne de caractères | La plateforme de dépôt de code | GitHub | Valeur obligatoire, Valeurs autorisées : GitHub |
repertoire_url | chaîne de caractères (format uri ) |
L'URL vers le répertoire | https://github.com/etalab/nom-repertoire | Valeur obligatoire |
description | chaîne de caractères | La description du répertoire | Ce répertoire est utile | Valeur optionnelle |
est_fork | booléen | Indique si le répertoire est un fork | false | Valeur obligatoire |
date_creation | date et heure | La date de création du répertoire | 2018-12-01T20:00:55Z | Valeur obligatoire |
derniere_mise_a_jour | date et heure | La date de dernière mise à jour du répertoire | 2018-12-01T20:00:55Z | Valeur obligatoire |
page_accueil | chaîne de caractères | URL vers la page d'accueil du projet | https://etalab.gouv.fr | Valeur optionnelle |
nombre_stars | nombre entier | Le nombre de fois où le répertoire a été ajouté aux favoris | 42 | Valeur obligatoire, Valeur minimale : 0 |
nombre_forks | nombre entier | Le nombre de fois où le répertoire a été forké | 13 | Valeur obligatoire, Valeur minimale : 0 |
licence | chaîne de caractères | La licence du répertoire, telle que détectée par la plateforme | MIT | Valeur optionnelle |
nombre_issues_ouvertes | nombre entier | Le nombre d'issues actuellement ouvertes | 0 | Valeur obligatoire, Valeur minimale : 0 |
langage | chaîne de caractères | Le langage principal du répertoire, tel que détecté par la plateforme | Python | Valeur optionnelle |
topics | chaîne de caractères | Les tags du répertoire | utile,france,opendata | Valeur optionnelle |
Notice
This software is available under the MIT license.
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
Close
Hashes for table_schema_to_markdown-0.4.6.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 95f087ee0362a0446f1ed23249904ff3f6a4019e2d0620fc114c5718e1074ff1 |
|
MD5 | d04a4af4de73ccb8e7c6aa1d6242fc7e |
|
BLAKE2b-256 | 70840a1feee0224917d948a2ed5181a875f50f9e9ddd40cce6de455787ca43d8 |
Close
Hashes for table_schema_to_markdown-0.4.6-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a2b471b994b62f490451e3593f93a6075d4f73753705e87d88fd5bf05bcb17fb |
|
MD5 | de779ac7774a48c23b5096bfb8a23492 |
|
BLAKE2b-256 | c33514a40abc6e758ae02bfff6defba217b7dd1e9f39da09fa0723b3a82774b3 |