Metadata-Version: 2.0
Name: clamd
Version: 1.0.2
Summary: Clamd is a python interface to Clamd (Clamav daemon).
Home-page: https://github.com/graingert/python-clamd
Author: Thomas Grainger
Author-email: python-clamd@graingert.co.uk
License: UNKNOWN
Keywords: python,clamav,antivirus,scanner,virus,libclamav,clamd
Platform: UNKNOWN
Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)

clamd
=====

.. image:: https://travis-ci.org/graingert/python-clamd.png?branch=master
   :alt: travis build status
   :target: https://travis-ci.org/graingert/python-clamd

About
-----
`clamd` is a portable Python module to use the ClamAV anti-virus engine on 
Windows, Linux, MacOSX and other platforms. It requires a running instance of 
the `clamd` daemon.

This is a fork of pyClamd v0.2.0 created by Philippe Lagadec and published on his website: http://www.decalage.info/en/python/pyclamd which in turn is a slightly improved version of pyClamd v0.1.1 created by Alexandre Norman and published on his website: http://xael.org/norman/python/pyclamd/

Usage
-----

To use with a unix socket::

    >>> import clamd
    >>> cd = clamd.ClamdUnixSocket()
    >>> cd.ping()
    'PONG'
    >>> cd.version()                             # doctest: +ELLIPSIS
    'ClamAV ...
    >>> cd.reload()
    'RELOADING'

To scan a file::

    >>> open('/tmp/EICAR','wb').write(clamd.EICAR)
    >>> cd.scan('/tmp/EICAR')
    {'/tmp/EICAR': ('FOUND', 'Eicar-Test-Signature')}

To scan a stream::

    >>> from six import BytesIO
    >>> cd.instream(BytesIO(clamd.EICAR))
    {'stream': ('FOUND', 'Eicar-Test-Signature')}


License
-------
`clamd` is released as open-source software under the LGPL license.

clamd Install
-------------
How to install the ClamAV daemon `clamd` under Ubuntu::

    sudo apt-get install clamav-daemon clamav-freshclam clamav-unofficial-sigs
    sudo freshclam
    sudo service clamav-daemon start


Changes
=========

1.0.2 (2014-08-21)
------------------

- Remove all dependencies. clamd is now standalone!
- Use plain setuptools no d2to1.
- Create universal wheel.


1.0.1 (2013-03-06)
------------------

- Updated d2to1 dependency


1.0.0 (2013-02-08)
------------------

- Change public interface, including exceptions
- Support Python 3.3, withdraw 2.5 support


0.3.4 (2013-02-01)
------------------

- Use regex to parse file status reponse instead of complicated string split/join


0.3.3 (2013-01-28)
------------------

- First version of clamd that can be installed from PyPI