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.
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.2.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | bc07d459ce4f968a174de1ea25c64d232b5ac5654973a88b0db61425880493b7 |
|
| MD5 | 923aa98557df3a783e3714b40a73ccd6 |
|
| BLAKE2b-256 | fb7124e5d0c2d2d6bc99a52d2e967ae825530ae27eddd5d84ba95b4631fc36f5 |
Close
Hashes for table_schema_to_markdown-0.4.2-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | f36e64b9293eae1862060dcb0e37e8d4de724319e9bc9596c961d61a21315c44 |
|
| MD5 | 89d8bc7440b495d8c4e2494e0ee5dc3d |
|
| BLAKE2b-256 | 4abe6acabdca8bf11834f5be79f4aa5216f21f566e9c6b1426c087853d28d874 |
