Metadata-Version: 2.1
Name: tableschema-to-template
Version: 0.0.12
Summary: Given a Frictionless Table Schema, generates an Excel template with input validation
Home-page: https://github.com/hubmapconsortium/tableschema-to-template
Author: Chuck McCallum
Author-email: mccallucc+tableschema@gmail.com
License: UNKNOWN
Description: # tableschema-to-template
        
        Given a [Frictionless Table Schema](https://specs.frictionlessdata.io/table-schema/)
        (like [this](https://raw.githubusercontent.com/hubmapconsortium/tableschema-to-template/main/tests/fixtures/schema.yaml)),
        generate an Excel template with input validation
        (like [this](https://raw.githubusercontent.com/hubmapconsortium/tableschema-to-template/main/tests/fixtures/template.xlsx)).
        
        ## Usage
        
        Download a [sample `schema.yaml`](https://raw.githubusercontent.com/hubmapconsortium/tableschema-to-template/main/tests/fixtures/schema.yaml), and then:
        
        ```sh
        pip install tableschema-to-template
        ts2xl.py schema.yaml template.xlsx
        # Open with Excel:
        open template.xlsx
        ```
        
        Or to use inside Python:
        ```python
        from tableschema_to_template import create_xlsx
        schema = {'fields': [{
          'name': 'a_number',
          'description': 'A number!',
          'type': 'number'
        }]}
        create_xlsx(schema, '/tmp/template.xlsx')
        ```
        
        Additional docs:
        - [For CLI users](https://github.com/hubmapconsortium/tableschema-to-template/blob/main/README-cli.md#readme)
        - [For Python users](https://github.com/hubmapconsortium/tableschema-to-template/blob/main/README-py.md#readme)
        - [For project developers](https://github.com/hubmapconsortium/tableschema-to-template/blob/main/README-dev.md#readme)
        
        ## Features
        
        - Enum constraints transformed into pull-downs.
        - Field descriptions transformed into comments in header.
        - Float, integer, and boolean type validation, with range checks on numbers.
        
        More details in the [changelog](https://github.com/hubmapconsortium/tableschema-to-template/blob/main/CHANGELOG.md#readme).
        
        ## Related work
        
        If you want to construct Excel files programmatically, [XlsxWriter](https://xlsxwriter.readthedocs.io/) is great!
        
        For validated data entry, from the Frictionless community:
        - [`table-schema-resource-template`](https://pypi.org/project/table-schema-resource-template/): Generates templates, but doesn't go beyond row headers. 
        - [`data-curator`](https://github.com/qcif/data-curator): Desktop application for data entry based on Table Schema.
        - [`csv-gg`](https://github.com/etalab/csv-gg): Web app which serves data entry form, and uses [Validata API](https://git.opendatafrance.net/validata/) for validation. 
        
        From the biomedical ontologies community:
        - [`CEDAR`](https://more.metadatacenter.org/): Data entry tool based on ontologies.
        - [`Webulous`](https://www.ebi.ac.uk/spot/webulous/): Google sheets plugin that adds pulldowns based on ontology terms.
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
