Metadata-Version: 1.1
Name: django-vote
Version: 2.1.6
Summary: A simple Django app to conduct vote.
Home-page: https://github.com/Beeblio/django-vote
Author: shellfly
Author-email: shell0fly@gmail.com
License: BSD License
Description: ## Django Vote
        
        ``django-vote`` is a simple Django app to conduct vote for django model.
        
        This project is inspired by [django-taggit](https://github.com/alex/django-taggit)
        
        [![Build Status](https://travis-ci.org/shanbay/django-vote.svg?branch=develop)](https://travis-ci.org/shanbay/django-vote)
        [![Codecov](https://codecov.io/gh/shanbay/django-vote/coverage.svg?branch=master)](https://codecov.io/gh/shanbay/django-vote?branch=master)
        [![PyPI version](https://badge.fury.io/py/django-vote.svg)](https://badge.fury.io/py/django-vote)
        
        ### Quick start
        
        #### Install `django-vote` by pip
        
        ```shell
        pip install django-vote
        ```
        
        #### Add `'vote'` to your `INSTALLED_APPS` setting like this
        
        ```python
        INSTALLED_APPS = (
          ...
          'vote',
        )
        ```
        
        #### Add `VoteModel` to the model you want to vote
        
        ```python
        from vote.models import VoteModel
        
        class ArticleReview(VoteModel, models.Model):
            ...
        ```
        
        #### Run migrate
        
        ```shell
        manage.py makemigrations
        manage.py migrate
        ```
        
        
        #### Use vote API
        
        ```python
        review = ArticleReview.objects.get(pk=1)
        
        # Up vote to the object
        review.votes.up(user_id)
        
        # Down vote to the object
        review.votes.down(user_id)
        
        # Removes a vote from the object
        review.votes.delete(user_id)
        
        # Check if the user already voted the object
        review.votes.exists(user_id)
        
        # Returns the number of votes for the object
        review.votes.count()
        
        # Returns a list of users who voted and their voting date
        review.votes.user_ids()
        
        
        # Returns all instances voted by user
        Review.votes.all(user_id)
        
        ```
        
        ``django-vote`` now requires Django 1.7 or greater. (for Django < 1.7, please install previous release `django-vote==1.1.3`)
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.7
Classifier: Framework :: Django :: 1.8
Classifier: Framework :: Django :: 1.9
Classifier: Framework :: Django :: 1.10
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.5
