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.3.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 9006d99cf4638f96fc4b3b2d9f3c307782b6c27577af27687c447e9c39a1c97d |
|
| MD5 | 0cfbd7485a3fbbcdd033c4a6643c8d43 |
|
| BLAKE2b-256 | d03dbbc90d9b5c848661a7d2bebe2ea0fd1f9cab8dbc60c8bd3354e81cbc9150 |
Close
Hashes for table_schema_to_markdown-0.4.3-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 15e6efe0c7174fbf94afe4a15a41b3fb3e9da15e49c00b08fc82e81f2206039a |
|
| MD5 | 1cf4a5bf1c6f43886a8da0a5a8a7826e |
|
| BLAKE2b-256 | 9a33e052a1be1f5a0ccba3f997dd898dfbd45d5588e3a203c0032d8a6f8c6946 |
