Metadata-Version: 2.1
Name: django-random-queryset
Version: 0.1.3
Summary: Pull random records using Django ORM.
Home-page: http://github.com/rremizov/django-random-queryset
Author: Roman M. Remizov
Author-email: rremizov@yandex.ru
License: MIT
Platform: any
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.11
Classifier: Framework :: Django :: 2.0
Classifier: Framework :: Django :: 2.1
Classifier: Framework :: Django :: 2.2
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
License-File: LICENSE
Requires-Dist: django>=1.11

django-random-queryset |Build status|
=====================================

Pull random records using Django ORM.


Requirements
------------

- Python 2.7, 3.6, 3.7
- Django 1.11, 2.0, 2.1, 2.2.
- Postgres


Installation
------------

.. code:: sh

    $ pip install django-random-queryset


Setup
-----


Add ``RandomManager`` to desired model:

.. code:: python

    from django.db import models

    from django_random_queryset import RandomManager


    class Model(models.Model):

        objects = RandomManager()

        # ...


Use it:

.. code:: python

    queryset = Model.objects.filter(field=value)
    queryset.random()   # to get one random record
    queryset.random(5)  # pass amount to get more records
    queryset.random().values()  # other queryset methods available


.. |Build status| image:: https://travis-ci.org/rremizov/django-random-queryset.svg?branch=master
   :target: https://travis-ci.org/rremizov/django-random-queryset
