Metadata-Version: 2.1
Name: thug
Version: 6.5
Summary: Low-interaction honeyclient Thug
Author-email: Angelo Dell'Aera <angelo.dellaera@honeynet.org>
Maintainer-email: Angelo Dell'Aera <angelo.dellaera@honeynet.org>
License: GPLv2
Project-URL: homepage, https://github.com/buffer/thug
Project-URL: documentation, https://thug-honeyclient.readthedocs.io/en/latest/
Project-URL: bugs, https://github.com/buffer/thug/issues
Project-URL: funding, https://buffer.github.io/thug/
Keywords: honeyclient,low-interaction,client-honeypot,security-tools
Platform: linux
Platform: darwin
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Security
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE.txt
Requires-Dist: appdirs==1.4.4
Requires-Dist: beautifulsoup4==4.12.3
Requires-Dist: charset-normalizer==3.3.2
Requires-Dist: cssutils==2.10.2
Requires-Dist: dhash==1.4
Requires-Dist: html5lib==1.1
Requires-Dist: importlib-resources==6.0.1; python_version < "3.9"
Requires-Dist: lxml==5.2.1
Requires-Dist: networkx==3.2.1; python_version < "3.10"
Requires-Dist: networkx==3.3; python_version > "3.9"
Requires-Dist: pefile==2023.2.7
Requires-Dist: pillow==10.3.0
Requires-Dist: promise==2.3
Requires-Dist: pylibemu==1.0
Requires-Dist: pymongo==4.6.3
Requires-Dist: pysocks==1.7.1
Requires-Dist: python-magic==0.4.27
Requires-Dist: rarfile==4.2
Requires-Dist: requests==2.31.0
Requires-Dist: requests-futures==1.0.1
Requires-Dist: setuptools>=65.5.1
Requires-Dist: ssdeep==3.4
Requires-Dist: stpyv8==12.3.219.16
Requires-Dist: yara-python==4.5.0
Requires-Dist: zope.interface==6.2
Provides-Extra: elasticsearch
Requires-Dist: elasticsearch; extra == "elasticsearch"
Provides-Extra: exploitgraph
Requires-Dist: pygraphviz; extra == "exploitgraph"
Provides-Extra: image
Requires-Dist: imgkit==1.1.0; extra == "image"
Requires-Dist: pytesseract; extra == "image"
Provides-Extra: shellcode
Requires-Dist: speakeasy-emulator; extra == "shellcode"
Provides-Extra: test
Requires-Dist: thug[elasticsearch,exploitgraph,image,shellcode]; extra == "test"
Requires-Dist: mock; extra == "test"
Requires-Dist: mongomock; extra == "test"
Requires-Dist: pre-commit; extra == "test"
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Requires-Dist: pytest-timeout; extra == "test"
Requires-Dist: safety; extra == "test"
Requires-Dist: tox; extra == "test"

Thug
====

|version badge| |github badge| |codefactor badge| |codecov badge| |bandit badge|

The number of client-side attacks has grown significantly in the past few years
shifting focus on poorly protected vulnerable clients. Just as the most known
honeypot technologies enable research into server-side attacks, honeyclients
allow the study of client-side attacks.

A complement to honeypots, a honeyclient is a tool designed to mimic the behavior
of a user-driven network client application, such as a web browser, and be
exploited by an attacker's content.

Thug is a Python low-interaction honeyclient aimed at mimicking the behavior of a
web browser in order to detect and emulate malicious contents.


Documentation
-------------

|docs badge|

Documentation about Thug installation and usage can be found at http://thug-honeyclient.readthedocs.io/.


Contributions
-------------

|donate badge|

Thug is open source and we welcome contributions in all forms!

Thug is free to use for any purpose (even commercial ones). If you use and appreciate Thug, please consider
supporting the project with a donation using Paypal.


Testing
-------

To run the full test suite using tox_, run the command:

.. code-block:: bash

    tox

Since tox builds and installs dependencies from scratch, using `pytest`_ for faster testing is recommended:

.. code-block:: bash

    pytest --cov thug


License information
-------------------

Copyright (C) 2011-2024 Angelo Dell'Aera <angelo.dellaera@honeynet.org>

License: GNU General Public License, version 2


.. |version badge| image:: https://img.shields.io/pypi/v/thug.svg
   :target: https://pypi.python.org/pypi/thug/
.. |github badge| image:: https://github.com/buffer/thug/workflows/Build/badge.svg
   :target: https://github.com/buffer/thug
.. |codefactor badge| image:: https://www.codefactor.io/repository/github/buffer/thug/badge
   :target: https://www.codefactor.io/repository/github/buffer/thug
.. |codecov badge| image:: https://codecov.io/gh/buffer/thug/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/buffer/thug
.. |bandit badge| image:: https://img.shields.io/badge/security-bandit-yellow.svg
   :target: https://github.com/PyCQA/bandit
.. |docs badge| image:: https://readthedocs.com/projects/thug-honeyclient-thug/badge/?version=latest
   :target: https://thug-honeyclient-thug.readthedocs-hosted.com/en/latest/?badge=latest
.. |donate badge| image:: https://img.shields.io/badge/Donate-PayPal-green.svg
   :target: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=XTDF8AHJ28CXY
.. _virtualenv: https://virtualenv.pypa.io/
.. _tox: https://tox.readthedocs.io/
.. _`pytest`: http://pytest.org/
