Metadata-Version: 2.1
Name: wq.db
Version: 1.2.2
Summary: Django design patterns and REST API for citizen science field data collection.
Home-page: https://wq.io/wq.db
Author: S. Andrew Sheppard
Author-email: andrew@wq.io
License: MIT
Project-URL: Homepage, https://wq.io/wq.db
Project-URL: Documentation, https://wq.io/docs/
Project-URL: Source, https://github.com/wq/wq.db
Project-URL: Release Notes, https://github.com/wq/wq.db/releases
Project-URL: Issues, https://github.com/wq/wq.db/issues
Project-URL: CI, https://travis-ci.org/wq/wq.db
Description: [![wq.db](https://raw.github.com/wq/wq/master/images/256/wq.db.png)](https://wq.io/wq.db)
        
        [wq.db](https://wq.io/wq.db) is a collection of Python modules for building robust, flexible schemas and REST APIs for use in creating field data collection apps and (more generally) mobile-first websites with progressive enhancement.  wq.db is the backend component of [wq] and is geared primarily for use with [wq.app], though it can be used separately.  wq.db is built on the [Django] platform.
        
        
        [![Latest PyPI Release](https://img.shields.io/pypi/v/wq.db.svg)](https://pypi.org/project/wq.db)
        [![Release Notes](https://img.shields.io/github/release/wq/wq.db.svg)](https://github.com/wq/wq.db/releases)
        [![Documentation](https://img.shields.io/badge/Docs-1.2-blue.svg)](https://wq.io/wq.db)
        [![License](https://img.shields.io/pypi/l/wq.db.svg)](https://wq.io/license)
        [![GitHub Stars](https://img.shields.io/github/stars/wq/wq.db.svg)](https://github.com/wq/wq.db/stargazers)
        [![GitHub Forks](https://img.shields.io/github/forks/wq/wq.db.svg)](https://github.com/wq/wq.db/network)
        [![GitHub Issues](https://img.shields.io/github/issues/wq/wq.db.svg)](https://github.com/wq/wq.db/issues)
        
        [![Travis Build Status](https://img.shields.io/travis/wq/wq.db/master.svg)](https://travis-ci.org/wq/wq.db)
        [![Python Support](https://img.shields.io/pypi/pyversions/wq.db.svg)](https://pypi.org/project/wq.db)
        [![Django Support](https://img.shields.io/pypi/djversions/wq.db.svg)](https://pypi.org/project/wq.db)
        
        #### Support Matrix
        
        wq.db is compatible with Python >= 3.4 and Django >= 1.11.
        
        &nbsp;      | Python | Django | Django REST Framework
        ------------|--------|--------|-----------------------
        **wq.db 1.0** | 2.7, 3.4 &ndash; 3.6 | 1.8, 1.10, 1.11 | 3.6
        **wq.db 1.1** | 2.7*, 3.4 &ndash; 3.7 | 1.11, 2.0, 2.1 | 3.9
        **wq.db 1.2** | 3.4 &ndash; 3.8 | 1.11, 2.x, 3.0, 3.1 | 3.9 &ndash; 3.12
        **wq.db 2.0 (Future)** | 3.5+ | 2.2+ | 3.11+
        
        &#42; Python 2.7 support is no longer tested, but is known to work in wq.db 1.1 and earlier.
        
        ## Getting Started
        
        ```bash
        
        # Recommended: create virtual environment
        # python3 -m venv venv
        # . venv/bin/activate
        
        # Install entire wq suite (recommended)
        python3 -m pip install wq
        
        # Install only wq.db
        python3 -m pip install wq.db
        ```
        
        See [the documentation] for more information.
        
        ## Features
        
        ### [wq.db.rest][rest]
        Extends [Django REST Framework] with model-based views and serializers that facilitate creating an integrated [website, REST API, and mobile app][url-structure].  The core of the library is an admin-like [ModelRouter] that connects REST urls to registered models, and provides a descriptive [configuration object] for consumption by [@wq/app].  wq.db.rest also includes a GeoJSON serializer/renderer.
        
        ### [wq.db.patterns][patterns]
        A collection of abstract models and serializers for use in constructing advanced [design patterns][patterns] including [nested forms], [EAV structures][EAV], and [natural keys].  Includes [wq.db.patterns.identify][identify], an installable Django app module to help manage third-party entity identifers.
        
        [wq]: https://wq.io
        [wq.app]: https://wq.io/wq.app
        [Django]: https://www.djangoproject.com/
        [the documentation]: https://wq.io/docs/
        
        [rest]: https://wq.io/docs/about-rest
        [Django REST Framework]: http://django-rest-framework.org
        [url-structure]: https://wq.io/docs/url-structure
        [ModelRouter]: https://wq.io/docs/router
        [configuration object]: https://wq.io/docs/config
        [@wq/app]: https://wq.io/docs/app-js
        
        [patterns]: https://wq.io/docs/about-patterns
        [nested forms]: https://wq.io/docs/nested-forms
        [EAV]: https://wq.io/docs/eav-vs-relational
        [natural keys]: https://github.com/wq/django-natural-keys
        [identify]: https://wq.io/docs/identify
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.11
Classifier: Framework :: Django :: 2.0
Classifier: Framework :: Django :: 2.1
Classifier: Framework :: Django :: 2.2
Classifier: Framework :: Django :: 3.0
Classifier: Framework :: Django :: 3.1
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Text Processing :: Markup :: HTML
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Database :: Database Engines/Servers
Description-Content-Type: text/markdown
