skip to navigation
skip to content

Not Logged In

django-botscout 0.0.1

Latest Version: 0.0.2

django-botscout
===============

This provides an easy hook into the Botscout system for Django forms

Available Settings
------------------
```python
# All settings are optional. They are displayed here with their defaults
BOTSCOUT_API_KEY = None
BOTSCOUT_API_URL = 'http://botscout.com/test/'
BOTSCOUT_CACHE_TIMEOUT = 1800
BOTSCOUT_NETWORK_TIMEOUT = 5
```

Additionally, you can set the following variables on individual forms to alter
their behavior:

```python
BOTSCOUT_NAME_FIELD = 'name'
BOTSCOUT_EMAIL_FIELD = 'email'
BOTSCOUT_ERROR_MESSAGE = 'This request was matched in the BotScout database'
```


Basic Usage
-----------
In forms.py:

```python
from botscout import BotScoutForm
from django import forms


class ContactForm(BotScoutForm, forms.Form):
    name = forms.CharField('Name')
    email = forms.EmailField('Email')
```

In views.py:

```python
from .forms import ContactForm


def contact(request):
    if request.method == 'POST':
        form = ContactForm(request=request, data=request.POST)
        if form.is_valid():
            ...
    else:
        form = ContactForm(request=request)
    ...
```

Advanced Usage
--------------
```python
from botscout import BotScoutForm
from django import forms
from django.db import models


class Person(models.Model):
    full_name = models.CharField('Full name', max_length=255)
    email_address = models.EmailField('Email')


class MyForm(BotScoutForm, forms.ModelForm):
    BOTSCOUT_NAME_FIELD = 'full_name'
    BOTSCOUT_EMAIL_FIELD = 'email_address'
    BOTSCOUT_ERROR_MESSAGE = 'GO AWAY SPAM BOT!'

    class Meta:
        model = Person
```
 
File Type Py Version Uploaded on Size
django-botscout-0.0.1.tar.gz (md5) Source 2013-12-05 3KB
  • Downloads (All Versions):
  • 58 downloads in the last day
  • 111 downloads in the last week
  • 294 downloads in the last month