Metadata-Version: 2.1
Name: zds-schema
Version: 0.2.1
Summary: Schema-generatie tooling
Home-page: https://github.com/maykinmedia/gemma-zaken-common
Author: Maykin Media, VNG-Realisatie
Author-email: support@maykinmedia.nl
License: EUPL 1.2
Keywords: openapi,swagger,django,vng
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Django
Classifier: Framework :: Django :: 2.0
Classifier: Intended Audience :: Developers
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Provides-Extra: tests
Provides-Extra: docs
Provides-Extra: coverage
Provides-Extra: release
Provides-Extra: pep8
Requires-Dist: django
Requires-Dist: django-choices
Requires-Dist: django-filter
Requires-Dist: djangorestframework-camel-case
Requires-Dist: drf-yasg
Requires-Dist: drf-nested-routers
Requires-Dist: iso-639
Requires-Dist: isodate
Requires-Dist: pyyaml
Requires-Dist: requests
Requires-Dist: unidecode
Provides-Extra: coverage
Requires-Dist: pytest-cov; extra == 'coverage'
Provides-Extra: docs
Requires-Dist: sphinx; extra == 'docs'
Requires-Dist: sphinx-rtd-theme; extra == 'docs'
Provides-Extra: pep8
Requires-Dist: flake8; extra == 'pep8'
Provides-Extra: release
Requires-Dist: zest.releaser; extra == 'release'
Provides-Extra: tests
Requires-Dist: pytest; extra == 'tests'
Requires-Dist: pytest-django; extra == 'tests'
Requires-Dist: tox; extra == 'tests'
Requires-Dist: isort; extra == 'tests'

====================================
ZDS-Schema - Schema-generatietooling
====================================

ZDS-Schema voorziet een generieke API schema-generatiestrategie die gedeeld
wordt tussen verschillende componenten betrokken in zaakgericht werken.

.. contents::

.. section-numbering::

Features
========

* Centraal beheer van cosntanten 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)
* Custom inspectors voor drf-yasg:
    * Support voor ``rest_framework_gis`` ``GeometryField``
    * URL-based related resource filtering (``django-filter`` support)
* Management command ``generate_swagger`` overloaded om default versie mee te
  nemen en server-informatie domein-agnostisch te maken
* Support voor ISO 8601 durations
* Custom model fields:
    * ``RSINField``
    * ``BSNField``
    * ``LanguageField``
    * ``VertrouwelijkheidsAanduidingField``
    * ``DaysDurationField``


Installatie
===========

Benodigdheden
-------------

* Python 3.6 of hoger
* setuptools 30.3.0 of higher

Installeren
-----------

.. code-block:: bash

    pip install -e git+https://github.com/maykinmedia/gemma-zaken-common.git@master#egg=zds_schema

Gebruik
=======

Zie de referentie-implementaties voor `ZRC`_, `DRC`_ en `ZTC`_.

.. _ZRC: https://github.com/VNG-Realisatie/gemma-zaakregistratiecomponent
.. _DRC: https://github.com/VNG-Realisatie/gemma-documentregistratiecomponent
.. _ZTC: https://github.com/VNG-Realisatie/gemma-zaaktypecatalogus


