Django REST framework QueryFields

|travis|_ |coveralls|_ |pypi|_ |womm|_

.. |travis| image:: https://travis-ci.org/wimglenn/djangorestframework-queryfields.svg?branch=master .. _travis: https://travis-ci.org/wimglenn/djangorestframework-queryfields

.. |coveralls| image:: https://coveralls.io/repos/github/wimglenn/djangorestframework-queryfields/badge.svg?branch=master .. _coveralls: https://coveralls.io/github/wimglenn/djangorestframework-queryfields?branch=master

.. |pypi| image:: https://img.shields.io/pypi/v/djangorestframework-queryfields.svg .. _pypi: https://pypi.org/project/djangorestframework-queryfields

.. |womm| image:: https://cdn.rawgit.com/nikku/works-on-my-machine/v0.2.0/badge.svg .. _womm: https://github.com/nikku/works-on-my-machine

Allows clients to control which fields will be sent in the API response. Fields are specified in the query, e.g.

.. code-block::

# You want a list of users but you're only interested in the fields "id" and "username":

GET /users/?fields=id,username

[
  {
    "id": 1,
    "username": "tom"
  },
  {
    "id": 2,
    "username": "wim"
  }
]


# You want to see every field except "id" for the specific user wim:

GET /users/2/?fields!=id

{
  "username": "wim",
  "email": "[email protected]",
  "spirit_animal": "raccoon"
}

Supported Django versions: 1.7 - 2.2+. Check the CI matrix <https://github.com/wimglenn/djangorestframework-queryfields/blob/master/.travis.yml/>_ for details.

Documentation is hosted on Read The Docs <http://djangorestframework-queryfields.readthedocs.io/>_.

Developers, developers, developers!

Want to contribute to the project? This is how to run the test suite:

.. code-block:: bash

get the codez

git clone https://github.com/wimglenn/djangorestframework-queryfields.git

create and/or activate your virtualenv, this or something like it:

cd djangorestframework-queryfields python3 -m venv .venv source .venv/bin/activate

installing the app in your venv

pip install --editable ".[dev]" git checkout -b myfeature

hack away, then ...

pytest