capstone/bindings/python
Nguyen Anh Quynh 377bced8c4 python: correct comment on default value of @detail 2014-01-11 09:51:48 +08:00
..
capstone python: correct comment on default value of @detail 2014-01-11 09:51:48 +08:00
pyx python: revert the directory name change, so rename 'cython' back to 'pyx' 2014-01-10 10:32:25 +08:00
Makefile python: revert the directory name change, so rename 'cython' back to 'pyx' 2014-01-10 10:32:25 +08:00
README python: instructions on installing Cython as dependency 2014-01-10 11:23:51 +08:00
setup.py python: cleanup setup*.py 2014-01-09 09:29:36 +08:00
setup_cython.py python: revert the directory name change, so rename 'cython' back to 'pyx' 2014-01-10 10:32:25 +08:00
test.py python: correct CS_OPT_SYNTAX_NOREGNAME & add 1 more test to test.py. issue reported by Dang Hoang Vu 2014-01-08 10:23:07 +08:00
test_arm.py python: update following the change to detail mode in the core 2014-01-07 23:39:40 +08:00
test_arm64.py python: update following the change to detail mode in the core 2014-01-07 23:39:40 +08:00
test_detail.py python: update following the change to detail mode in the core 2014-01-07 23:39:40 +08:00
test_mips.py python: update following the change to detail mode in the core 2014-01-07 23:39:40 +08:00
test_ppc.py python: update following the change to detail mode in the core 2014-01-07 23:39:40 +08:00
test_x86.py python: update following the change to detail mode in the core 2014-01-07 23:39:40 +08:00

README

1. To install Python binding on *nix, simply run below command:

		$ sudo make install

	For better performance, install Cython-based binding with:

		$ sudo make install_cython

	NOTE: to install Cython, depending on if you already have pip or
	easy_install installed, simply do either:

		$ sudo pip install cython
	or:
		$ sudo pip install cython


This directory contains some test code to show how to use Capstone API.

- test.py
  This code shows the most simple form of API where we only want to get basic
  information out of disassembled instruction, such as address, mnemonic and
  operand string.

- test_detail.py:
  This code shows how to access to architecture-neutral information in disassembled
  instructions, such as implicit registers read/written, or groups of instructions
  that this instruction belong to.

- test_<arch>.py
  These code show how to access architecture-specific information for each
  architecture.


2. To install Python binding on Windows:

Recommended method:

	Use the Python module installer for 32/64 bit Windows from:

		http://www.capstone-engine.org/download.html


Manual method:

	If the module installer fails to locate your Python install, or if you have
	additional Python installs (e.g. Anaconda / virtualenv), run the following
	command in command prompt:

		C:\> C:\location_to_python\python.exe setup.py install

	Next, copy libcapstone.dll from the 'Core engine for Windows' package available
	on the same Capstone download page and paste it in the path:

		C:\location_to_python\Lib\site-packages\capstone\