This is a fork of https://github.com/vstoykov/django-clamd => https://github.com/QueraTeam/django-clamav with some minor customizations.
This project integrates python-clamd with Django for easy scanning files for viruses on upload
Install django-clamav package.
pip install git+https://github.com/atqan-dev/django-clamav.git
Aditioanlly if you want translations to work you need to add it to installed apps.
INSTALLED_APPS = (
...
'django_clamav',
...
)
You can use it in forms:
from django import forms
from django_clamav.validators import validate_file_infection
class UploadForm(forms.Form):
upload_file = forms.FileField(validators=[validate_file_infection])
Or you can add it as validator directly in your model:
from django.db import models
from django_clamav.validators import validate_file_infection
class FileModel(models.Model):
document = models.FileField(validators=[validate_file_infection])
You will have automatically scanning of upladed files in Django Admin and also when create ModelForm's for that model.
By default django-clamav tries to be smart and with good defaults.
You can still configure how to connect to Clamd. Default values are:
CLAMAV_UNIX_SOCKET = '/var/run/clamav/clamd.ctl'
CLAMAV_USE_TCP = False
CLAMAV_TCP_PORT = 3310
CLAMAV_TCP_ADDR = '127.0.0.1'
Note: When you are running on Fedora or CentOS and :code:clamav-scanner
package is installed then default value for :code:CLAMAV_UNIX_SOCKET is:
CLAMAV_UNIX_SOCKET = '/var/run/clamd.scan/clamd.sock'
You also can disable virus scanning for development with:
CLAMAV_ENABLED = False
Note: This is primary for make it easy to run a project on development without the need of installing Clamd on devlopment machine.
django-clamav is released as open-source software under the LGPL license.