sdtp


Namesdtp JSON
Version 0.2.5 PyPI version JSON
download
home_pageNone
SummaryA Python implementation of the Simple Data Transfer Protocol data structures, function, and server
upload_time2024-09-19 23:08:04
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseNone
keywords data access data analytics
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            #  The Simple Data Transfer Protcol

This is a reference server and library  for the Simple Data Transfer Protocol.  It demonstrates the Simple Data Transfer Protocol Server API.  It also functions as an open framework, so new Tables can be attached to the Simple Data Transfer Protocol server by providing a Class with a `get_rows()` method and a `columns` property.
The README.md file in each directory gives the documentation for the utilities and classes in that directory.  

The structure is as follows:
```
├── sdtp
│   ├── sdtp_server: A reference SDTP server and middleware
│   ├── sdtp: The basic SDTP types, including Filters and Tables

  
# The Simple Data Transfer Protocol

The SDTP Server implements the Simple Data Transfer Protocol, a universal way to query and transmit tabular data.  The SDTP uses http/https as the underlying transport protocol.  There is no client; rather, a program accessing an SDTP server creates a `RemoteSDMLTable` (see `sdtp.sdtp_table.py`) and accesses that through the standard SDTP Table methods.

This is a quick summary of the Simple Data Transfer Protocol.  A more extended description can be found at:


## Basic Data Structure
The core data structure of the SDTP is a _table_, which is simply a list of list of values. Conceptually, it is equivalent to a SQL database table; each column has a specific type and each row is of the same, fixed length.  The Python definitions are in sdtp.sdtp_table.py.  `Columns` is the only mandatory entry for a table.  It is a list of columns, each of which is a dictionary with two mandatory fields: `name` and `type`.  Other fields (e.g., to express units or other metadata) are permitted.

The Python implementation of table types is in  `sdtp.sdtp_table.py`

### Simple Data Transfer Protocol Data Types
This is a list of the permissible types.  Each column of a table is of one of these types
See sdtp.sdtp_utils.py.  The native types these convert to are language-specific
1. SDML_STRING: A string.  In Python, class str.
2. SDML_NUMBER: A real or an integer.  In Python, class float or class int.
3. SDML_BOOLEAN: true or false. In Python, class bool.
4. SDML_DATE: A date.  In Python, class datetime.date
5. SDML_DATETIME: A datetime.  In Python, class datetime.datetime
6. SDML_TIME_OF_DAY: A time.  In Python, class datetime.time


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "sdtp",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "Data access, Data analytics",
    "author": null,
    "author_email": "Rick McGeer <rick@mcgeer.com>",
    "download_url": "https://files.pythonhosted.org/packages/f1/9d/09e23856b7090d51520060133b23c3746cf59c30ebf61fd07b86263f4548/sdtp-0.2.5.tar.gz",
    "platform": null,
    "description": "#  The Simple Data Transfer Protcol\r\n\r\nThis is a reference server and library  for the Simple Data Transfer Protocol.  It demonstrates the Simple Data Transfer Protocol Server API.  It also functions as an open framework, so new Tables can be attached to the Simple Data Transfer Protocol server by providing a Class with a `get_rows()` method and a `columns` property.\r\nThe README.md file in each directory gives the documentation for the utilities and classes in that directory.  \r\n\r\nThe structure is as follows:\r\n```\r\n\u251c\u2500\u2500 sdtp\r\n\u2502   \u251c\u2500\u2500 sdtp_server: A reference SDTP server and middleware\r\n\u2502   \u251c\u2500\u2500 sdtp: The basic SDTP types, including Filters and Tables\r\n\r\n  \r\n# The Simple Data Transfer Protocol\r\n\r\nThe SDTP Server implements the Simple Data Transfer Protocol, a universal way to query and transmit tabular data.  The SDTP uses http/https as the underlying transport protocol.  There is no client; rather, a program accessing an SDTP server creates a `RemoteSDMLTable` (see `sdtp.sdtp_table.py`) and accesses that through the standard SDTP Table methods.\r\n\r\nThis is a quick summary of the Simple Data Transfer Protocol.  A more extended description can be found at:\r\n\r\n\r\n## Basic Data Structure\r\nThe core data structure of the SDTP is a _table_, which is simply a list of list of values. Conceptually, it is equivalent to a SQL database table; each column has a specific type and each row is of the same, fixed length.  The Python definitions are in sdtp.sdtp_table.py.  `Columns` is the only mandatory entry for a table.  It is a list of columns, each of which is a dictionary with two mandatory fields: `name` and `type`.  Other fields (e.g., to express units or other metadata) are permitted.\r\n\r\nThe Python implementation of table types is in  `sdtp.sdtp_table.py`\r\n\r\n### Simple Data Transfer Protocol Data Types\r\nThis is a list of the permissible types.  Each column of a table is of one of these types\r\nSee sdtp.sdtp_utils.py.  The native types these convert to are language-specific\r\n1. SDML_STRING: A string.  In Python, class str.\r\n2. SDML_NUMBER: A real or an integer.  In Python, class float or class int.\r\n3. SDML_BOOLEAN: true or false. In Python, class bool.\r\n4. SDML_DATE: A date.  In Python, class datetime.date\r\n5. SDML_DATETIME: A datetime.  In Python, class datetime.datetime\r\n6. SDML_TIME_OF_DAY: A time.  In Python, class datetime.time\r\n\r\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A Python implementation of the Simple Data Transfer Protocol data structures, function, and server",
    "version": "0.2.5",
    "project_urls": {
        "homepage": "https://github.com/rickmcgeer/sdtp",
        "issues": "https://github.com/rickmcgeer/sdtp/issues"
    },
    "split_keywords": [
        "data access",
        " data analytics"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "53dfb656187070f5a0c786670501d52b1fec4ee51bcfba75d2561361cf3ac3a0",
                "md5": "09daa0ea2b79bcf6278023a632fce0c1",
                "sha256": "86d3b7b3ee9867e6c2dc4529f114dd5c436ddacebec54d766f89193b352d4125"
            },
            "downloads": -1,
            "filename": "sdtp-0.2.5-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "09daa0ea2b79bcf6278023a632fce0c1",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": ">=3.8",
            "size": 31995,
            "upload_time": "2024-09-19T23:08:02",
            "upload_time_iso_8601": "2024-09-19T23:08:02.606730Z",
            "url": "https://files.pythonhosted.org/packages/53/df/b656187070f5a0c786670501d52b1fec4ee51bcfba75d2561361cf3ac3a0/sdtp-0.2.5-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f19d09e23856b7090d51520060133b23c3746cf59c30ebf61fd07b86263f4548",
                "md5": "e496ed214eb6a096f3fdaa2671e6dbc2",
                "sha256": "4111f882d5245d014484459acb90438d7cd46e5da2b5cd85ef892a5b46c2c485"
            },
            "downloads": -1,
            "filename": "sdtp-0.2.5.tar.gz",
            "has_sig": false,
            "md5_digest": "e496ed214eb6a096f3fdaa2671e6dbc2",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 39559,
            "upload_time": "2024-09-19T23:08:04",
            "upload_time_iso_8601": "2024-09-19T23:08:04.038655Z",
            "url": "https://files.pythonhosted.org/packages/f1/9d/09e23856b7090d51520060133b23c3746cf59c30ebf61fd07b86263f4548/sdtp-0.2.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-09-19 23:08:04",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "rickmcgeer",
    "github_project": "sdtp",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "sdtp"
}
        
Elapsed time: 0.35300s