Install python-ptrace
*********************

python-ptrace supports Python 3.6 and newer.


Linux packages
==============

* Debian: python-ptrace Debian package.

* Mandriva: python-ptrace Mandriva package

* OpenEmbedded: python-ptrace recipe

* Arch Linux: python-ptrace Arch Linux package

* Gentoo: dev-python/python-ptrace

See also python-ptrace on Python Package Index (PyPI)


Install from source
===================


Download tarball
----------------

Get the latest tarball at the Python Package Index (PyPI).


Download development version
----------------------------

Download the development version using Git:

   git clone https://github.com/vstinner/python-ptrace.git

Browse python-ptrace source code.


Option dependency
-----------------

* distorm disassembler (optional) http://www.ragestorm.net/distorm/


Installation
------------

Note: pip is strongly recommanded.

Type as root:

   python3 setup.py install

Or using sudo program:

   sudo python3 setup.py install


cptrace
=======

For faster debug and to avoid ctypes, you can also install cptrace:
Python binding of the ptrace() function written in C:

   python3 setup_cptrace.py install


Run tests
=========


Run tests with tox
------------------

To run all tests, just type:

   tox

The tox project creates a clean virtual environment to run tests.


Run tests manually
------------------

Type:

   python3 runtests.py
   python3 test_doc.py

It's also possible to run a specific test:

   PYTHONPATH=$PWD python3 tests/test_strace.py
