influenzanet.surveys


Nameinfluenzanet.surveys JSON
Version 1.0.5 PyPI version JSON
download
home_page
SummaryInfluenzanet surveys management library
upload_time2023-09-01 11:51:52
maintainer
docs_urlNone
author
requires_python>=3.9
licenseApache-2.0
keywords influenzanet surveys
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            Influenzanet Survey Management
=====

influenzanet.surveys is a python library to work with influenzanet surveys, mainly validation and transformation

The purpose of this library is to work with existing surveys in json, it's not designed to create new survey json from scratch (for this use the typescript libraries).

## Installation

```python
pip install influenzanet.surveys

# To use validation
pip install influenzanet.surveys[validator]
```

## Features

- Parse json Survey definition into python object
- Parse [standards survey definition](https://github.com/influenzanet/surveys-standards), standards define the common questions/responses encoding for Influenzanet 
- Export survey in several format : html document, readable yaml (see formats) 
- Check survey internal consistency (reference for keys) and compliance to a standard definition

## Format

- html : view of a survey definition in a static html document (this is survey definition for humans)
- readable : a simplified view of a survey to see survey structure. Expression are transformed into function call-like text to be more readable. 

Each format accepts a "context" for the transformation, allowing, for example, to select the languages to be used in the output.

An helper is provided to build html for all json in a directory :

```python

from influenzanet.surveys.html import build_html_from_dir

## Accept glob patterns and transform all surveys json into html (if a json is not a survey it will be ignored)
## Creates an html file in the same directory for each json, replacing existing html if already exists
build_html_from_dir("output/**/surveys", languages=["en","fr"])
```

## Validation and Survey check

TBD

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "influenzanet.surveys",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": "",
    "keywords": "influenzanet,surveys",
    "author": "",
    "author_email": "Clement Turbelin <clement.turbelin@iplesp.upmc.fr>",
    "download_url": "https://files.pythonhosted.org/packages/4d/59/ac97be27932e7fc75a5f97b782bdaf65c9931dfaf604f13428b865511c1c/influenzanet.surveys-1.0.5.tar.gz",
    "platform": null,
    "description": "Influenzanet Survey Management\n=====\n\ninfluenzanet.surveys is a python library to work with influenzanet surveys, mainly validation and transformation\n\nThe purpose of this library is to work with existing surveys in json, it's not designed to create new survey json from scratch (for this use the typescript libraries).\n\n## Installation\n\n```python\npip install influenzanet.surveys\n\n# To use validation\npip install influenzanet.surveys[validator]\n```\n\n## Features\n\n- Parse json Survey definition into python object\n- Parse [standards survey definition](https://github.com/influenzanet/surveys-standards), standards define the common questions/responses encoding for Influenzanet \n- Export survey in several format : html document, readable yaml (see formats) \n- Check survey internal consistency (reference for keys) and compliance to a standard definition\n\n## Format\n\n- html : view of a survey definition in a static html document (this is survey definition for humans)\n- readable : a simplified view of a survey to see survey structure. Expression are transformed into function call-like text to be more readable. \n\nEach format accepts a \"context\" for the transformation, allowing, for example, to select the languages to be used in the output.\n\nAn helper is provided to build html for all json in a directory :\n\n```python\n\nfrom influenzanet.surveys.html import build_html_from_dir\n\n## Accept glob patterns and transform all surveys json into html (if a json is not a survey it will be ignored)\n## Creates an html file in the same directory for each json, replacing existing html if already exists\nbuild_html_from_dir(\"output/**/surveys\", languages=[\"en\",\"fr\"])\n```\n\n## Validation and Survey check\n\nTBD\n",
    "bugtrack_url": null,
    "license": "Apache-2.0",
    "summary": "Influenzanet surveys management library",
    "version": "1.0.5",
    "project_urls": {
        "Bug Tracker": "https://github.com/influenzanet/python-influenzanet-surveys/issues",
        "Homepage": "https://github.com/influenzanet/python-influenzanet-surveys"
    },
    "split_keywords": [
        "influenzanet",
        "surveys"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "aef8c17655a3251e5ca3e07cad7bb2e2cfd80602f28898f4e44300826deb897f",
                "md5": "6b2b36a3c1b4003fec27511db6e4d9e2",
                "sha256": "d0ec6b63295933d117604f96a14c99b34a5cc54c303167bf6a864de89b045953"
            },
            "downloads": -1,
            "filename": "influenzanet.surveys-1.0.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "6b2b36a3c1b4003fec27511db6e4d9e2",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 44380,
            "upload_time": "2023-09-01T11:51:51",
            "upload_time_iso_8601": "2023-09-01T11:51:51.455266Z",
            "url": "https://files.pythonhosted.org/packages/ae/f8/c17655a3251e5ca3e07cad7bb2e2cfd80602f28898f4e44300826deb897f/influenzanet.surveys-1.0.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4d59ac97be27932e7fc75a5f97b782bdaf65c9931dfaf604f13428b865511c1c",
                "md5": "1946496af6ec3b3b3b2b0b97c611f998",
                "sha256": "ac96c0aec37d132c2060e072139486a01b27817a213c3019b33042e3cfbdb816"
            },
            "downloads": -1,
            "filename": "influenzanet.surveys-1.0.5.tar.gz",
            "has_sig": false,
            "md5_digest": "1946496af6ec3b3b3b2b0b97c611f998",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 35740,
            "upload_time": "2023-09-01T11:51:52",
            "upload_time_iso_8601": "2023-09-01T11:51:52.711297Z",
            "url": "https://files.pythonhosted.org/packages/4d/59/ac97be27932e7fc75a5f97b782bdaf65c9931dfaf604f13428b865511c1c/influenzanet.surveys-1.0.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-09-01 11:51:52",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "influenzanet",
    "github_project": "python-influenzanet-surveys",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "influenzanet.surveys"
}
        
Elapsed time: 0.13048s