Metadata-Version: 1.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
Description: 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
        
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
