ssdeep Python Wrapper
=====================
This is a straightforward Python wrapper for `ssdeep by Jesse Kornblum`_, which is a library for computing context
triggered piecewise hashes (CTPH). Also called fuzzy hashes, CTPH can match inputs that have homologies. Such inputs
have sequences of identical bytes in the same order, although bytes in between these sequences may be different in both
content and length.
.. image:: https://img.shields.io/pypi/v/ssdeep.svg
:target: https://pypi.python.org/pypi/ssdeep/
:alt: Latest Version
.. image:: https://img.shields.io/pypi/l/ssdeep.svg
:target: https://pypi.python.org/pypi/ssdeep/
:alt: License
.. image:: https://img.shields.io/pypi/pyversions/ssdeep.svg
:target: https://pypi.python.org/pypi/ssdeep/
:alt: Python Versions
.. image:: https://readthedocs.org/projects/python-ssdeep/badge/
:target: https://python-ssdeep.readthedocs.io/en/latest/
:alt: Latest Docs
.. image:: https://travis-ci.org/DinoTools/python-ssdeep.svg?branch=master
:target: https://travis-ci.org/DinoTools/python-ssdeep
.. image:: https://ci.dinotools.org/buildStatus/icon?job=python-ssdeep-master
:target: https://ci.dinotools.org/job/python-ssdeep-master/
:alt: Build state
How to use it
=============
To compute a fuzzy hash, use ``hash`` function:
.. code-block:: pycon
>>> import ssdeep
>>> hash1 = ssdeep.hash('Also called fuzzy hashes, Ctph can match inputs that have homologies.')
>>> hash1
'3:AXGBicFlgVNhBGcL6wCrFQEv:AXGHsNhxLsr2C'
>>> hash2 = ssdeep.hash('Also called fuzzy hashes, CTPH can match inputs that have homologies.')
>>> hash2
'3:AXGBicFlIHBGcL6wCrFQEv:AXGH6xLsr2C'
The ``compare`` function returns the match between 2 hashes, an integer value from 0 (no match) to 100.
.. code-block:: pycon
>>> ssdeep.compare(hash1, hash2)
22
More examples are available in the `python-ssdeep documentation`_.
Install
=======
If all requirements are met it is possible to install the wrapper by using pip or easy_install.
.. code-block:: console
$ pip install ssdeep
The build will fail if the ssdeep library isn't installed.
To use the included version of the ssdeep library use the following command.
.. code-block:: console
$ BUILD_LIB=1 pip install ssdeep
For more information have a look at the `python-ssdeep documentation`_.
Tested on ...
=============
* CentOS 7
* Debian 8, 9
* Ubuntu 14.04, 16.04, 18.04
Documentation
=============
Feel free to use the prebuild `python-ssdeep documentation`_ or use the steps below to build the documentation.
.. code-block:: console
$ cd docs
$ pip install -r requirements.txt
$ make html
Licensing
=========
The code is licensed under the terms of the LGPLv3+.
This wrapper includes the unchanged source distribution of `ssdeep version 2.14.1`_. It is licensed under the GPLv2.
.. _ssdeep by Jesse Kornblum: https://ssdeep-project.github.io/ssdeep/
.. _ssdeep version 2.14.1: https://github.com/ssdeep-project/ssdeep/releases/tag/release-2.14.1
.. _python-ssdeep documentation: https://python-ssdeep.readthedocs.io
Raw data
{
"_id": null,
"home_page": "http://github.com/DinoTools/python-ssdeep",
"name": "ssdeep",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "ssdeep",
"author": "PhiBo (DinoTools)",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/e0/d3/f17602a7dde1231d332f4067fdd421057ffe335c3bbc295e7ccfab769d95/ssdeep-3.4.tar.gz",
"platform": "",
"description": "ssdeep Python Wrapper\n=====================\n\nThis is a straightforward Python wrapper for `ssdeep by Jesse Kornblum`_, which is a library for computing context\ntriggered piecewise hashes (CTPH). Also called fuzzy hashes, CTPH can match inputs that have homologies. Such inputs\nhave sequences of identical bytes in the same order, although bytes in between these sequences may be different in both\ncontent and length.\n\n.. image:: https://img.shields.io/pypi/v/ssdeep.svg\n :target: https://pypi.python.org/pypi/ssdeep/\n :alt: Latest Version\n\n.. image:: https://img.shields.io/pypi/l/ssdeep.svg\n :target: https://pypi.python.org/pypi/ssdeep/\n :alt: License\n\n.. image:: https://img.shields.io/pypi/pyversions/ssdeep.svg\n :target: https://pypi.python.org/pypi/ssdeep/\n :alt: Python Versions\n\n.. image:: https://readthedocs.org/projects/python-ssdeep/badge/\n :target: https://python-ssdeep.readthedocs.io/en/latest/\n :alt: Latest Docs\n\n.. image:: https://travis-ci.org/DinoTools/python-ssdeep.svg?branch=master\n :target: https://travis-ci.org/DinoTools/python-ssdeep\n\n.. image:: https://ci.dinotools.org/buildStatus/icon?job=python-ssdeep-master\n :target: https://ci.dinotools.org/job/python-ssdeep-master/\n :alt: Build state\n\n\nHow to use it\n=============\n\nTo compute a fuzzy hash, use ``hash`` function:\n\n.. code-block:: pycon\n\n >>> import ssdeep\n >>> hash1 = ssdeep.hash('Also called fuzzy hashes, Ctph can match inputs that have homologies.')\n >>> hash1\n '3:AXGBicFlgVNhBGcL6wCrFQEv:AXGHsNhxLsr2C'\n >>> hash2 = ssdeep.hash('Also called fuzzy hashes, CTPH can match inputs that have homologies.')\n >>> hash2\n '3:AXGBicFlIHBGcL6wCrFQEv:AXGH6xLsr2C'\n\nThe ``compare`` function returns the match between 2 hashes, an integer value from 0 (no match) to 100.\n\n.. code-block:: pycon\n\n >>> ssdeep.compare(hash1, hash2)\n 22\n\n\nMore examples are available in the `python-ssdeep documentation`_.\n\nInstall\n=======\n\nIf all requirements are met it is possible to install the wrapper by using pip or easy_install.\n\n.. code-block:: console\n\n $ pip install ssdeep\n\nThe build will fail if the ssdeep library isn't installed.\nTo use the included version of the ssdeep library use the following command.\n\n.. code-block:: console\n\n $ BUILD_LIB=1 pip install ssdeep\n\nFor more information have a look at the `python-ssdeep documentation`_.\n\nTested on ...\n=============\n\n* CentOS 7\n* Debian 8, 9\n* Ubuntu 14.04, 16.04, 18.04\n\nDocumentation\n=============\n\nFeel free to use the prebuild `python-ssdeep documentation`_ or use the steps below to build the documentation.\n\n.. code-block:: console\n\n $ cd docs\n $ pip install -r requirements.txt\n $ make html\n\nLicensing\n=========\n\nThe code is licensed under the terms of the LGPLv3+.\n\nThis wrapper includes the unchanged source distribution of `ssdeep version 2.14.1`_. It is licensed under the GPLv2.\n\n.. _ssdeep by Jesse Kornblum: https://ssdeep-project.github.io/ssdeep/\n.. _ssdeep version 2.14.1: https://github.com/ssdeep-project/ssdeep/releases/tag/release-2.14.1\n.. _python-ssdeep documentation: https://python-ssdeep.readthedocs.io",
"bugtrack_url": null,
"license": "LGPLv3+",
"summary": "Python wrapper for the ssdeep library",
"version": "3.4",
"project_urls": {
"Homepage": "http://github.com/DinoTools/python-ssdeep"
},
"split_keywords": [
"ssdeep"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e0d3f17602a7dde1231d332f4067fdd421057ffe335c3bbc295e7ccfab769d95",
"md5": "8439f88b0f2942c5bc432b87685cee59",
"sha256": "1b5510716bc495a2b18300ea837fcf944552a1cc678bb74e384bce251d99a85f"
},
"downloads": -1,
"filename": "ssdeep-3.4.tar.gz",
"has_sig": false,
"md5_digest": "8439f88b0f2942c5bc432b87685cee59",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 110839,
"upload_time": "2019-10-03T20:50:23",
"upload_time_iso_8601": "2019-10-03T20:50:23.924264Z",
"url": "https://files.pythonhosted.org/packages/e0/d3/f17602a7dde1231d332f4067fdd421057ffe335c3bbc295e7ccfab769d95/ssdeep-3.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2019-10-03 20:50:23",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "DinoTools",
"github_project": "python-ssdeep",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"tox": true,
"lcname": "ssdeep"
}
JSON
