===================================================
Commonground-API-common - Tooling voor RESTful APIs
===================================================
|build-status| |code-quality| |coverage| |docs| |black|
|python-versions| |django-versions| |pypi-version|
Commonground-API-common biedt generieke implementaties en tooling voor RESTful APIs
in een Common Ground gegevenslandschap.
Dit project is een fork van commonground-api-common.
Zie de uitgebreide `documentatie`_ voor de features en het gebruik.
.. contents::
.. section-numbering::
Features
========
* Centraal beheer van constanten die de verschillende componenten overstijgen
* GeoJSON OpenAPI definities
* Support voor Geo CRS negotation
* Ingebouwde support voor nested viewsets met declaratievere syntax voor
registratie
* Vaak voorkomende validators:
* RSIN/BSN validator
* Numerieke waarde validator
* Niet-negatieve waarde validator
* Alfanumerieke waarde (zonder diacritics)
* URL-validator (test dat URL bestaat) met pluggable link-checker
* ``UntilNowValidator`` - valideer datetimes tot en met *nu*.
* ``UniekeIdentificatieValidator`` (in combinatie met organisatie)
* ``InformatieObjectUniqueValidator`` om te valideren dat M2M entries
slechts eenmalig voorkomen
* ``IsImmutableValidator`` - valideer dat bepaalde velden niet gewijzigd
worden bij een (partial) update, maar wel mogen gezet worden bij een create
* ``ResourceValidator`` - valideer dat een URL een bepaalde resource ontsluit
* Custom inspectors voor drf-yasg:
* Support voor ``rest_framework_gis`` ``GeometryField``
* SUpport voor ``django-extra-fields`` ``Base64FieldMixin``
* URL-based related resource filtering (``django-filter`` support)
* verzameling van mogelijke error-responses per operation
* Management command ``generate_swagger`` overloaded
* neemt default versie mee en maakt server-informatie domein-agnostisch
* optie om informatiemodel-resources naar markdown te renderen met backlinks
naar gemmaonline.nl
* Support voor ISO 8601 durations
* Custom model fields:
* ``RSINField``
* ``BSNField``
* ``LanguageField``
* ``VertrouwelijkheidsAanduidingField``
* ``DaysDurationField``
* Mocks voor de validators die netwerk IO hebben, eenvoudig via
``@override_settings`` toe te passen
* Test utilities
* Optionele notificaties applicatie:
* ontvangen van webhook events
* configureren en registreren van notificatiecomponent/webhooks
.. |build-status| image:: https://github.com/maykinmedia/commonground-api-common/workflows/ci-build/badge.svg
:alt: Build status
:target: https://github.com/maykinmedia/commonground-api-common/actions?query=workflow%3A%22ci-build%22
.. |code-quality| image:: https://github.com/maykinmedia/commonground-api-common/workflows/Code%20quality%20checks/badge.svg
:alt: Code quality checks
:target: https://github.com/maykinmedia/commonground-api-common/actions?query=workflow%3A%22Code+quality+checks%22
.. |coverage| image:: https://codecov.io/gh/maykinmedia/commonground-api-common/branch/main/graph/badge.svg
:target: https://codecov.io/gh/maykinmedia/commonground-api-common
:alt: Coverage status
.. |docs| image:: https://readthedocs.org/projects/commonground-api-common/badge/?version=latest
:target: https://commonground-api-common.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. |python-versions| image:: https://img.shields.io/pypi/pyversions/commonground-api-common.svg
.. |django-versions| image:: https://img.shields.io/pypi/djversions/commonground-api-common.svg
.. |pypi-version| image:: https://img.shields.io/pypi/v/commonground-api-common.svg
:target: https://pypi.org/project/commonground-api-common/
.. |black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
:target: https://github.com/psf/black
.. _documentatie: https://commonground-api-common.readthedocs.io/en/latest/?badge=latest
Raw data
{
"_id": null,
"home_page": "https://github.com/maykinmedia/commonground-api-common",
"name": "commonground-api-common",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "openapi, swagger, django",
"author": "Maykin Media, VNG-Realisatie",
"author_email": "support@maykinmedia.nl",
"download_url": "https://files.pythonhosted.org/packages/d9/55/90dc5e90267beef4b58152c4cc5cd594bbbf579c0c526f20c57fb7f3a77c/commonground_api_common-2.4.1.tar.gz",
"platform": null,
"description": "===================================================\nCommonground-API-common - Tooling voor RESTful APIs\n===================================================\n\n|build-status| |code-quality| |coverage| |docs| |black|\n\n|python-versions| |django-versions| |pypi-version|\n\nCommonground-API-common biedt generieke implementaties en tooling voor RESTful APIs\nin een Common Ground gegevenslandschap.\n\nDit project is een fork van commonground-api-common.\n\nZie de uitgebreide `documentatie`_ voor de features en het gebruik.\n\n.. contents::\n\n.. section-numbering::\n\nFeatures\n========\n\n* Centraal beheer van constanten die de verschillende componenten overstijgen\n* GeoJSON OpenAPI definities\n* Support voor Geo CRS negotation\n* Ingebouwde support voor nested viewsets met declaratievere syntax voor\n registratie\n* Vaak voorkomende validators:\n * RSIN/BSN validator\n * Numerieke waarde validator\n * Niet-negatieve waarde validator\n * Alfanumerieke waarde (zonder diacritics)\n * URL-validator (test dat URL bestaat) met pluggable link-checker\n * ``UntilNowValidator`` - valideer datetimes tot en met *nu*.\n * ``UniekeIdentificatieValidator`` (in combinatie met organisatie)\n * ``InformatieObjectUniqueValidator`` om te valideren dat M2M entries\n slechts eenmalig voorkomen\n * ``IsImmutableValidator`` - valideer dat bepaalde velden niet gewijzigd\n worden bij een (partial) update, maar wel mogen gezet worden bij een create\n * ``ResourceValidator`` - valideer dat een URL een bepaalde resource ontsluit\n* Custom inspectors voor drf-yasg:\n * Support voor ``rest_framework_gis`` ``GeometryField``\n * SUpport voor ``django-extra-fields`` ``Base64FieldMixin``\n * URL-based related resource filtering (``django-filter`` support)\n * verzameling van mogelijke error-responses per operation\n* Management command ``generate_swagger`` overloaded\n * neemt default versie mee en maakt server-informatie domein-agnostisch\n * optie om informatiemodel-resources naar markdown te renderen met backlinks\n naar gemmaonline.nl\n* Support voor ISO 8601 durations\n* Custom model fields:\n * ``RSINField``\n * ``BSNField``\n * ``LanguageField``\n * ``VertrouwelijkheidsAanduidingField``\n * ``DaysDurationField``\n* Mocks voor de validators die netwerk IO hebben, eenvoudig via\n ``@override_settings`` toe te passen\n* Test utilities\n* Optionele notificaties applicatie:\n * ontvangen van webhook events\n * configureren en registreren van notificatiecomponent/webhooks\n\n.. |build-status| image:: https://github.com/maykinmedia/commonground-api-common/workflows/ci-build/badge.svg\n :alt: Build status\n :target: https://github.com/maykinmedia/commonground-api-common/actions?query=workflow%3A%22ci-build%22\n\n.. |code-quality| image:: https://github.com/maykinmedia/commonground-api-common/workflows/Code%20quality%20checks/badge.svg\n :alt: Code quality checks\n :target: https://github.com/maykinmedia/commonground-api-common/actions?query=workflow%3A%22Code+quality+checks%22\n\n.. |coverage| image:: https://codecov.io/gh/maykinmedia/commonground-api-common/branch/main/graph/badge.svg\n :target: https://codecov.io/gh/maykinmedia/commonground-api-common\n :alt: Coverage status\n\n.. |docs| image:: https://readthedocs.org/projects/commonground-api-common/badge/?version=latest\n :target: https://commonground-api-common.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\n.. |python-versions| image:: https://img.shields.io/pypi/pyversions/commonground-api-common.svg\n\n.. |django-versions| image:: https://img.shields.io/pypi/djversions/commonground-api-common.svg\n\n.. |pypi-version| image:: https://img.shields.io/pypi/v/commonground-api-common.svg\n :target: https://pypi.org/project/commonground-api-common/\n\n.. |black| image:: https://img.shields.io/badge/code%20style-black-000000.svg\n :target: https://github.com/psf/black\n\n.. _documentatie: https://commonground-api-common.readthedocs.io/en/latest/?badge=latest\n",
"bugtrack_url": null,
"license": "EUPL 1.2",
"summary": "Commonground API tooling",
"version": "2.4.1",
"project_urls": {
"Homepage": "https://github.com/maykinmedia/commonground-api-common"
},
"split_keywords": [
"openapi",
" swagger",
" django"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e9ac66637059b993955c8f2e3b664e48db377c47f82ae3283018cc30758b9358",
"md5": "475d490e071ac1e83712db31569b88bf",
"sha256": "01392271b8a00c5457a3f26e7bd9c5d2627823b03c087fee9cc3c893d224a900"
},
"downloads": -1,
"filename": "commonground_api_common-2.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "475d490e071ac1e83712db31569b88bf",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 1445602,
"upload_time": "2025-01-14T14:54:35",
"upload_time_iso_8601": "2025-01-14T14:54:35.794519Z",
"url": "https://files.pythonhosted.org/packages/e9/ac/66637059b993955c8f2e3b664e48db377c47f82ae3283018cc30758b9358/commonground_api_common-2.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d95590dc5e90267beef4b58152c4cc5cd594bbbf579c0c526f20c57fb7f3a77c",
"md5": "0e2b589871f2476640fa93217dcb12b9",
"sha256": "714383f7bfab350ae8a24f66d03ab4f65f7e282d448cf3d3c1a07f5a65a0498c"
},
"downloads": -1,
"filename": "commonground_api_common-2.4.1.tar.gz",
"has_sig": false,
"md5_digest": "0e2b589871f2476640fa93217dcb12b9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 1411966,
"upload_time": "2025-01-14T14:54:38",
"upload_time_iso_8601": "2025-01-14T14:54:38.190882Z",
"url": "https://files.pythonhosted.org/packages/d9/55/90dc5e90267beef4b58152c4cc5cd594bbbf579c0c526f20c57fb7f3a77c/commonground_api_common-2.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-14 14:54:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "maykinmedia",
"github_project": "commonground-api-common",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "commonground-api-common"
}
JSON
