Skip to main content

Generate Markdown documentation from a table schema file from Frictionless Data

Project description

Software License CircleCI PyPI PyPI Python version

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

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

table_schema_to_markdown-0.4.3.tar.gz (8.7 kB view details)

Uploaded Source

Built Distribution

table_schema_to_markdown-0.4.3-py3-none-any.whl (8.3 kB view details)

Uploaded Python 3

File details

Details for the file table_schema_to_markdown-0.4.3.tar.gz.

File metadata

  • Download URL: table_schema_to_markdown-0.4.3.tar.gz
  • Upload date:
  • Size: 8.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/51.0.0 requests-toolbelt/0.9.1 tqdm/4.54.1 CPython/3.8.6

File hashes

Hashes for table_schema_to_markdown-0.4.3.tar.gz
Algorithm Hash digest
SHA256 9006d99cf4638f96fc4b3b2d9f3c307782b6c27577af27687c447e9c39a1c97d
MD5 0cfbd7485a3fbbcdd033c4a6643c8d43
BLAKE2b-256 d03dbbc90d9b5c848661a7d2bebe2ea0fd1f9cab8dbc60c8bd3354e81cbc9150

See more details on using hashes here.

Provenance

File details

Details for the file table_schema_to_markdown-0.4.3-py3-none-any.whl.

File metadata

  • Download URL: table_schema_to_markdown-0.4.3-py3-none-any.whl
  • Upload date:
  • Size: 8.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/51.0.0 requests-toolbelt/0.9.1 tqdm/4.54.1 CPython/3.8.6

File hashes

Hashes for table_schema_to_markdown-0.4.3-py3-none-any.whl
Algorithm Hash digest
SHA256 15e6efe0c7174fbf94afe4a15a41b3fb3e9da15e49c00b08fc82e81f2206039a
MD5 1cf4a5bf1c6f43886a8da0a5a8a7826e
BLAKE2b-256 9a33e052a1be1f5a0ccba3f997dd898dfbd45d5588e3a203c0032d8a6f8c6946

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page