# Django REST Framework extensions by Amsterdam Datapunt
Extensions to Django REST Framework by Amsterdam Datapunt. Amsterdam Datapunt
provides access to municipal data through, at times, public APIs. This project
provides some basic classes and instructions to set the behavior
of Django REST Framework API to the standards of Amsterdam Datapunt.
## Installation instructions
Given that you have a Django project that generates a REST API using Django
REST Framework:
```shell
pip install drf_amsterdam
```
To use the API page styling provided by this package you must add it to the
Django settings file in INSTALLED_APPS, ahead of 'rest_framework' so that the
templates and static files included in drf_amsterdam override those included
with Django REST Framework.
## Running tests
Run the tests in a virtualenv and run the script runtests.py from project root.
requirements: spatialite, sqlite extension
or use docker-compose:
```shell
docker-compose build
docker-compose run --rm tests pytest --cov
```
## Changelog
### 1.0.0
- Added types
- Tidied up code
- Added tests to reach 100% code coverage
#### Breaking changes
- `LinksField` now extends `RelatedField` instead of `HyperLinkedIdentityField`. The reason for this is that
`HyperLinkedIdentityField` has to return a `HyperLink` object in order to comply with the rules of covariance,
which is not what we desire it to return.
Raw data
{
"_id": null,
"home_page": "",
"name": "drf-amsterdam",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Amsterdam Datapunt",
"author_email": "datapunt@amsterdam.nl",
"download_url": "https://files.pythonhosted.org/packages/60/20/43661651600d298e66f6c664e76ab536517fa8048b818d0664a330009234/drf_amsterdam-1.0.1.tar.gz",
"platform": null,
"description": "# Django REST Framework extensions by Amsterdam Datapunt\n\n\nExtensions to Django REST Framework by Amsterdam Datapunt. Amsterdam Datapunt\nprovides access to municipal data through, at times, public APIs. This project\nprovides some basic classes and instructions to set the behavior\nof Django REST Framework API to the standards of Amsterdam Datapunt.\n\n## Installation instructions\n\nGiven that you have a Django project that generates a REST API using Django\nREST Framework:\n\n```shell\npip install drf_amsterdam\n```\n\nTo use the API page styling provided by this package you must add it to the\nDjango settings file in INSTALLED_APPS, ahead of 'rest_framework' so that the\ntemplates and static files included in drf_amsterdam override those included\nwith Django REST Framework.\n\n## Running tests\n\nRun the tests in a virtualenv and run the script runtests.py from project root.\n\nrequirements: spatialite, sqlite extension\n\nor use docker-compose:\n\n```shell\ndocker-compose build\ndocker-compose run --rm tests pytest --cov\n```\n\n## Changelog\n\n### 1.0.0\n- Added types\n- Tidied up code\n- Added tests to reach 100% code coverage\n\n#### Breaking changes\n- `LinksField` now extends `RelatedField` instead of `HyperLinkedIdentityField`. The reason for this is that\n`HyperLinkedIdentityField` has to return a `HyperLink` object in order to comply with the rules of covariance,\nwhich is not what we desire it to return.\n",
"bugtrack_url": null,
"license": "Mozilla Public License Version 2.0",
"summary": "Amsterdam Datapunt code and style for Django REST Framework.",
"version": "1.0.1",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8b5659f8934e6bcfeb2a09efaa2e648d1a71bf52605e9e9a76c90cdc6df6f144",
"md5": "55a99e4c0512583f42f1eb4a2543ff65",
"sha256": "9b9586ee45d04c757828c4c55093164aa84113fc82a8289559370ff56027b609"
},
"downloads": -1,
"filename": "drf_amsterdam-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "55a99e4c0512583f42f1eb4a2543ff65",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 64435,
"upload_time": "2023-12-06T09:05:38",
"upload_time_iso_8601": "2023-12-06T09:05:38.027158Z",
"url": "https://files.pythonhosted.org/packages/8b/56/59f8934e6bcfeb2a09efaa2e648d1a71bf52605e9e9a76c90cdc6df6f144/drf_amsterdam-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "602043661651600d298e66f6c664e76ab536517fa8048b818d0664a330009234",
"md5": "346da20e133307b7e986a8f6f3da34b4",
"sha256": "b92c491767e56e783bf176da57c015f745c8016d6667da32b16c6a7705675f70"
},
"downloads": -1,
"filename": "drf_amsterdam-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "346da20e133307b7e986a8f6f3da34b4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 62205,
"upload_time": "2023-12-06T09:05:39",
"upload_time_iso_8601": "2023-12-06T09:05:39.828351Z",
"url": "https://files.pythonhosted.org/packages/60/20/43661651600d298e66f6c664e76ab536517fa8048b818d0664a330009234/drf_amsterdam-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-06 09:05:39",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "drf-amsterdam"
}
JSON