# Spine Database API
[![Documentation Status](https://readthedocs.org/projects/spine-database-api/badge/?version=latest)](https://spine-database-api.readthedocs.io/en/latest/?badge=latest)
[![Unit tests](https://github.com/spine-tools/Spine-Database-API/workflows/Unit%20tests/badge.svg)](https://github.com/spine-tools/Spine-Database-API/actions?query=workflow%3A"Unit+tests")
[![codecov](https://codecov.io/gh/spine-tools/Spine-Database-API/branch/master/graph/badge.svg)](https://codecov.io/gh/spine-tools/Spine-Database-API)
[![PyPI version](https://badge.fury.io/py/spinedb-api.svg)](https://badge.fury.io/py/spinedb-api)
A Python package to access and manipulate Spine databases in a customary, unified way.
## License
Spine Database API is released under the GNU Lesser General Public License (LGPL) license. All accompanying
documentation and manual are released under the Creative Commons BY-SA 4.0 license.
## Getting started
### Installation
To install the package run:
$ pip install spinedb_api
To upgrade to the most recent version, run:
$ pip install --upgrade spinedb_api
You can also specify a branch, or a tag, for instance:
$ pip install spinedb_api==0.12.1
To install the latest development version use the Git repository url:
$ pip install --upgrade git+https://github.com/spine-tools/Spine-Database-API.git
## Building the documentation
Source files for the documentation can be found in `docs/source` directory. In order to
build the HTML docs, you need to install the additional documentation building requirements
by running:
$ pip install -r dev-requirements.txt
This installs Sphinx (among other things), which is required in building the documentation.
When Sphinx is installed, you can build the HTML pages from the source files by running:
> docs\make.bat html
or
$ pushd docs
$ make html
$ popd
depending on your operating system.
After running the build, the index page can be found in `docs/build/html/index.html`.
<hr>
<center>
<table width=500px frame="none">
<tr>
<td valign="middle" width=100px>
<img src=fig/eu-emblem-low-res.jpg alt="EU emblem" width=100%></td>
<td valign="middle">This project has received funding from European Climate, Infrastructure and Environment Executive Agency under the European Union’s HORIZON Research and Innovation Actions under grant agreement N°101095998.</td>
<tr>
<td valign="middle" width=100px>
<img src=fig/eu-emblem-low-res.jpg alt="EU emblem" width=100%></td>
<td valign="middle">This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement No 774629.</td>
</table>
</center>
Raw data
{
"_id": null,
"home_page": null,
"name": "spinedb-api",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8.1",
"maintainer_email": null,
"keywords": "energy system modelling, workflow, optimisation, database",
"author": null,
"author_email": "Spine Project consortium <spine_info@vtt.fi>",
"download_url": "https://files.pythonhosted.org/packages/83/97/56fd9ea90d15f483efb02f09930fd9d9f0f55dc2dc71b7c36ce244c50014/spinedb_api-0.31.1.tar.gz",
"platform": null,
"description": "# Spine Database API\n\n[![Documentation Status](https://readthedocs.org/projects/spine-database-api/badge/?version=latest)](https://spine-database-api.readthedocs.io/en/latest/?badge=latest)\n[![Unit tests](https://github.com/spine-tools/Spine-Database-API/workflows/Unit%20tests/badge.svg)](https://github.com/spine-tools/Spine-Database-API/actions?query=workflow%3A\"Unit+tests\")\n[![codecov](https://codecov.io/gh/spine-tools/Spine-Database-API/branch/master/graph/badge.svg)](https://codecov.io/gh/spine-tools/Spine-Database-API)\n[![PyPI version](https://badge.fury.io/py/spinedb-api.svg)](https://badge.fury.io/py/spinedb-api)\n\nA Python package to access and manipulate Spine databases in a customary, unified way.\n\n## License\n\nSpine Database API is released under the GNU Lesser General Public License (LGPL) license. All accompanying\ndocumentation and manual are released under the Creative Commons BY-SA 4.0 license.\n\n## Getting started\n\n### Installation\n\nTo install the package run:\n\n $ pip install spinedb_api\n\nTo upgrade to the most recent version, run:\n\n $ pip install --upgrade spinedb_api\n\nYou can also specify a branch, or a tag, for instance:\n\n $ pip install spinedb_api==0.12.1\n\nTo install the latest development version use the Git repository url:\n\n $ pip install --upgrade git+https://github.com/spine-tools/Spine-Database-API.git\n\n\n## Building the documentation\n\nSource files for the documentation can be found in `docs/source` directory. In order to \nbuild the HTML docs, you need to install the additional documentation building requirements\nby running:\n\n $ pip install -r dev-requirements.txt \n\nThis installs Sphinx (among other things), which is required in building the documentation.\nWhen Sphinx is installed, you can build the HTML pages from the source files by running:\n\n > docs\\make.bat html\n \nor\n\n $ pushd docs\n $ make html\n $ popd\n \ndepending on your operating system. \n \nAfter running the build, the index page can be found in `docs/build/html/index.html`.\n\n \n<hr>\n<center>\n<table width=500px frame=\"none\">\n<tr>\n<td valign=\"middle\" width=100px>\n<img src=fig/eu-emblem-low-res.jpg alt=\"EU emblem\" width=100%></td>\n<td valign=\"middle\">This project has received funding from European Climate, Infrastructure and Environment Executive Agency under the European Union\u2019s HORIZON Research and Innovation Actions under grant agreement N\u00b0101095998.</td>\n<tr>\n<td valign=\"middle\" width=100px>\n<img src=fig/eu-emblem-low-res.jpg alt=\"EU emblem\" width=100%></td>\n<td valign=\"middle\">This project has received funding from the European Union\u2019s Horizon 2020 research and innovation programme under grant agreement No 774629.</td>\n</table>\n</center>\n",
"bugtrack_url": null,
"license": "LGPL-3.0-or-later",
"summary": "An API to talk to Spine databases.",
"version": "0.31.1",
"project_urls": {
"Repository": "https://github.com/spine-tools/Spine-Database-API"
},
"split_keywords": [
"energy system modelling",
" workflow",
" optimisation",
" database"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f7d1f26ab5b63ebaea4a9d418cf58f9e909cbd8208caed50fa471f549d4f5345",
"md5": "d8f68a9bad720bf31327836b9c3de18f",
"sha256": "6a1ba69c5b8d18c9bb97c32f1cc8c81eafa8141de4c64c3d24f7c42138822d88"
},
"downloads": -1,
"filename": "spinedb_api-0.31.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d8f68a9bad720bf31327836b9c3de18f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8.1",
"size": 222909,
"upload_time": "2024-05-14T13:38:58",
"upload_time_iso_8601": "2024-05-14T13:38:58.166104Z",
"url": "https://files.pythonhosted.org/packages/f7/d1/f26ab5b63ebaea4a9d418cf58f9e909cbd8208caed50fa471f549d4f5345/spinedb_api-0.31.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "839756fd9ea90d15f483efb02f09930fd9d9f0f55dc2dc71b7c36ce244c50014",
"md5": "9d0e8fe45ca18672128125092ea172f5",
"sha256": "b0941907551d96451edf6704a31b91e2abcf2eb0591ae9b9d98a8aaaaaddaa76"
},
"downloads": -1,
"filename": "spinedb_api-0.31.1.tar.gz",
"has_sig": false,
"md5_digest": "9d0e8fe45ca18672128125092ea172f5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.1",
"size": 313739,
"upload_time": "2024-05-14T13:39:03",
"upload_time_iso_8601": "2024-05-14T13:39:03.635464Z",
"url": "https://files.pythonhosted.org/packages/83/97/56fd9ea90d15f483efb02f09930fd9d9f0f55dc2dc71b7c36ce244c50014/spinedb_api-0.31.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-14 13:39:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "spine-tools",
"github_project": "Spine-Database-API",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "spinedb-api"
}