IDAPython 1.5.3

- IDA Pro 6.2 support
- added set_idc_func_ex(): it is now possible to add new IDC functions using Python
- added visit_patched_bytes() (see ex_patch.py)
- added support for the multiline text input control in the Form class
- added support for the editable/readonly dropdown list control in the Form class
- added execute_sync() to register a function call into the UI message queue
- added execute_ui_requests() / check ex_uirequests.py
- added add_hotkey() / del_hotkey() to bind Python methods to hotkeys
- added register_timer()/unregister_timer(). Check ex_timer.py
- added the IDC (Arrays) netnode manipulation layer into idc.py
- added idautils.Structs() and StructMembers() generator functions
- removed the "Run Python Statement" menu item. IDA now has a unified dialog. 
  Use RunPlugin("python", 0) to invoke it manually.
- better error messages for script plugins, loaders and processor modules
- bugfix: Dbg_Hooks.dbg_run_to() was receiving wrong input
- bugfix: A few Enum related functions were not properly working in idc.py
- bugfix: GetIdaDirectory() and GetProcessName() were broken in idc.py
- bugfix: idaapi.get_item_head() / idc.ItemHead() were not working

Author: skochinsky@gmail.com

AUTHORS.txt

@@ -7,7 +7,7 @@ The IDAPython Team:
 
 * Hex-Rays - http://www.hex-rays.com/ - <support@hex-rays.com>
 
-    Hex-Rays joined the project in September 2009 and started contributing.
+    Hex-Rays joined the IDAPython project in September 2009 and started contributing.
     It is primarily maintained by Elias Bachaalany.
 
 
@@ -21,3 +21,4 @@ The IDAPython Team:
     Igor Skochinsky
     Sebastian Muniz
     cbwhiz
+    Arnaud Diederen

BUILDING.txt

@@ -1,6 +1,6 @@
-----------------------------------------------------------
-IDAPython - Python plugin for Interactive Disassembler Pro
-----------------------------------------------------------
+------------------------------------------------------
+IDAPython - Python plugin for Interactive Disassembler
+------------------------------------------------------
 Building From Source
 --------------------
 
@@ -36,10 +36,10 @@ BUILDING
 
 Make sure all the needed tools (compiler, swig) are on the PATH.
 
-1. Unpack the IDAPython source and IDA Pro SDK into the following
+1. Unpack the IDAPython source and IDA SDK into the following
    directory structure:
 
-   swigsdk-versions/x.y/          - A supported version of the IDA Pro SDK
+   swigsdk-versions/x.y/          - A supported version of the IDA SDK
    idapython/                     - IDAPython source code
 
 2. On Mac OS X copy libida.dylib from the IDA install directory to

CHANGES.txt

@@ -1,12 +1,32 @@
 Please see http://code.google.com/p/idapython/source/list for a detailed list of changes.
 
 
+Changes from version 1.5.2 to 1.5.3
+------------------------------------
+- added set_idc_func_ex(): it is now possible to add new IDC functions using Python
+- added visit_patched_bytes() (see ex_patch.py)
+- added support for the multiline text input control in the Form class
+- added support for the editable/readonly dropdown list control in the Form class
+- added execute_sync() to register a function call into the UI message queue
+- added execute_ui_requests() / check ex_uirequests.py
+- added add_hotkey() / del_hotkey() to bind Python methods to hotkeys
+- added register_timer()/unregister_timer(). Check ex_timer.py
+- added the IDC (Arrays) netnode manipulation layer into idc.py
+- added idautils.Structs() and StructMembers() generator functions
+- removed the "Run Python Statment" menu item. IDA now has a unified dialog. 
+  Use RunPlugin("python", 0) to invoke it manually.
+- better error messages for script plugins, loaders and processor modules
+- bugfix: Dbg_Hooks.dbg_run_to() was receiving wrong input
+- bugfix: A few Enum related functions were not properly working in idc.py
+- bugfix: GetIdaDirectory() and GetProcessName() were broken in idc.py
+- bugfix: idaapi.get_item_head() / idc.ItemHead() were not working
+
 Changes from version 1.5.1 to 1.5.2
 ------------------------------------
 - added ui_term/ui_save/ui_saved/ui_get_ea_hint UI notifications
 - added ph_get_operand_info() to retrieve operand information while debugging
 - added PteDump.py script
-- some code refactoring
+- bugfix: read/write_dbg_memory() and dbg_get_thread_sreg_base() were not working with all debugger modules
 - bugfix: idaapi.netnode.getblob() was limited to MAXSPECSIZE
 - bugfix: idc.GetString()/idaapi.get_ascii_contents()/idautils.Strings() were limited to MAXSTR string length
 - bugfix: idaapi.del_menu_item() was failing to delete some menu items

README.txt

@@ -1,8 +1,8 @@
-----------------------------------------------------------
-IDAPython - Python plugin for Interactive Disassembler Pro
-----------------------------------------------------------
+------------------------------------------------------
+IDAPython - Python plugin for Interactive Disassembler
+------------------------------------------------------
 
-WHAT IS IDAPTYHON?
+What is IDAPython?
 ------------------
 
 IDAPython is an IDA plugin which makes it possible to write scripts
@@ -12,7 +12,7 @@ access to both the IDA API and any installed Python module.
 Check the scripts in the examples directory to get an quick glimpse.
 
 
-AVAILABILITY
+Availability
 ------------
 
 Latest stable versions of IDAPython are available from
@@ -22,7 +22,7 @@ Development builds are available from
   http://code.google.com/p/idapython/
 
 
-RESOURCES
+Resources
 ---------
 
 The full function cross-reference is readable online at
@@ -35,22 +35,23 @@ Mailing list for the project is hosted by Google Groups at
   http://groups.google.com/group/idapython
 
 
-INSTALLATION FROM BINARIES
+Installation from binaries
 --------------------------
 
 1. Install 2.6 or 2.7 from http://www.python.org/
-2. Copy "python" directory to %IDADIR%
-3. Copy "plugins" directory to the %IDADIR%\plugins\
+2. Copy the whole "python" directory to %IDADIR%
+3. Copy the contents of the "plugins" directory to the %IDADIR%\plugins\
 4. Copy "python.cfg" to %IDADIR%\cfg
 
-USAGE
+Usage
 -----
 
  - Run script: File / Script file (Alt-F7)
  - Execute Python statement(s) (Ctrl-F3)
  - Run previously executed script again: View / Recent Scripts (Alt+F9)
 
-Batch mode execution:
+
+* Batch mode execution:
 
 Start IDA with the following command line options:
 
@@ -75,7 +76,7 @@ Where N can be:
   1: run script when UI is ready
   2: run script immediately on plugin load (shortly after IDA starts and before processor modules and loaders)
 
-User init file:
+* User init file
 
 You can place your custom settings to a file called 'idapythonrc.py'
 that should be placed to
@@ -89,3 +90,25 @@ or
 The user init file is read and executed at the end of the init process.
 
 Please note that IDAPython can be configured with "python.cfg" file.
+
+* Invoking Python from IDC
+
+The IDAPython plugin exposes a new IDC function "RunPythonStatement(string idc_code)" that allows execution
+of Python code from IDC
+
+* Invoking IDC from Python
+
+It is possible to use the idc.Eval() to evaluate IDC expressions from Python
+
+* Making Python the default language
+
+By default, IDA will use IDC to evaluate expressions. It is possible to change the default language to use
+Python instead of IDC.
+
+In order to do that, please use the following IDC code:
+
+RunPlugin("python", 3)
+
+To disable Python language and revert back to IDC:
+RunPlugin("python", 4)
+

Scripts/VirusTotal.py

@@ -20,7 +20,7 @@
 
 # -----------------------------------------------------------------------
 # Configuration file
-VT_CFGFILE = idaapi.get_user_idadir() + os.sep + "virustotal.cfg"
+VT_CFGFILE = os.path.join(idaapi.get_user_idadir(), "virustotal.cfg")
 
 # -----------------------------------------------------------------------
 # VirusTotal Icon in PNG format

build.py

@@ -1,8 +1,8 @@
 #!/usr/bin/env python
 #---------------------------------------------------------------------
-# IDAPython - Python plugin for Interactive Disassembler Pro
+# IDAPython - Python plugin for Interactive Disassembler
 #
-# Copyright (c) 2004-2010 Gergely Erdelyi <gergely.erdelyi@d-dome.net>
+# (c) The IDAPython Team <idapython@googlegroups.com>
 #
 # All rights reserved.
 #
@@ -24,19 +24,19 @@
 VERBOSE = True
 
 IDA_MAJOR_VERSION = 6
-IDA_MINOR_VERSION = 1
+IDA_MINOR_VERSION = 2
 
 if 'IDA' in os.environ:
     IDA_SDK = os.environ['IDA']
 else:
-    IDA_SDK = ".." + os.sep + "swigsdk-versions" + os.sep + "%d.%d" % (IDA_MAJOR_VERSION, IDA_MINOR_VERSION)
+    IDA_SDK = os.path.join("..", "swigsdk-versions", ("%d.%d" % (IDA_MAJOR_VERSION, IDA_MINOR_VERSION)))
 
 # End of user configurable options
 
 # IDAPython version
 VERSION_MAJOR  = 1
 VERSION_MINOR  = 5
-VERSION_PATCH  = 2
+VERSION_PATCH  = 3
 
 # Determine Python version
 PYTHON_MAJOR_VERSION = int(platform.python_version()[0])
@@ -72,6 +72,8 @@
     "docs/notes.txt",
     "examples/chooser.py",
     "examples/colours.py",
+    "examples/ex_idphook_asm.py",
+    "examples/ex_uirequests.py",
     "examples/debughook.py",
     "examples/ex_cli.py",
     "examples/ex1.idc",
@@ -87,13 +89,18 @@
     "examples/ex_choose2.py",
     "examples/ex_debug_names.py",
     "examples/ex_graph.py",
+    "examples/ex_hotkey.py",
+    "examples/ex_patch.py",
+    "examples/ex_expr.py",
+    "examples/ex_timer.py",
     "examples/ex_dbg.py",
     "examples/ex_custview.py",
     "examples/ex_prefix_plugin.py",
     "examples/ex_pyside.py",
     "examples/ex_pyqt.py",
     "examples/ex_askusingform.py",
     "examples/ex_uihook.py",
+    "examples/ex_idphook_asm.py",
     "examples/ex_imports.py"
 ]
 
@@ -216,7 +223,7 @@ def __init__(self):
         self.include_delimiter = "-I"
         self.macro_delimiter = "-D"
         self.libpath_delimiter = "-L"
-        self.compiler_parameters = "-fpermissive"
+        self.compiler_parameters = "-fpermissive -Wno-write-strings"
         self.linker_parameters = "-shared"
         self.basemacros = [ ]
         self.compiler = "g++ -m32"
@@ -279,21 +286,21 @@ def build_distribution(manifest, distrootdir, ea64, nukeold):
         if type(f) == types.TupleType:
             srcfilepath = f[0]
             srcfilename = os.path.basename(srcfilepath)
-            dstdir = distrootdir + os.sep + f[1]
-            dstfilepath = dstdir + os.sep + srcfilename
+            dstdir = os.path.join(distrootdir, f[1])
+            dstfilepath = os.path.join(dstdir, srcfilename)
         else:
             srcfilepath = f
             srcfilename = os.path.basename(f)
             srcdir  = os.path.dirname(f)
             if srcdir == "":
                 dstdir = distrootdir
             else:
-                dstdir = distrootdir + os.sep + srcdir
+                dstdir = os.path.join(distrootdir, srcdir)
 
         if not os.path.exists(dstdir):
             os.makedirs(dstdir)
 
-        dstfilepath = dstdir + os.sep + srcfilename
+        dstfilepath = os.path.join(dstdir, srcfilename)
         shutil.copyfile(srcfilepath, dstfilepath)
         zip.write(dstfilepath)
 
@@ -304,14 +311,14 @@ def build_plugin(platform, idasdkdir, plugin_name, ea64):
     global SWIG_OPTIONS
     """ Build the plugin from the SWIG wrapper and plugin main source """
     # Path to the IDA SDK headers
-    ida_include_directory = idasdkdir + os.sep + "include"
+    ida_include_directory = os.path.join(idasdkdir, "include")
 
     builder = None
     # Platform-specific settings for the Linux build
     if platform == "linux":
         builder = GCCBuilder()
         platform_macros = [ "__LINUX__" ]
-        python_libpath = sysconfig.EXEC_PREFIX + os.sep + "lib"
+        python_libpath = os.path.join(sysconfig.EXEC_PREFIX, "lib")
         python_library = "-lpython%d.%d" % (PYTHON_MAJOR_VERSION, PYTHON_MINOR_VERSION)
         ida_libpath = os.path.join(idasdkdir, "lib", ea64 and "x86_linux_gcc_64" or "x86_linux_gcc_32")
         ida_lib = ""
@@ -320,7 +327,7 @@ def build_plugin(platform, idasdkdir, plugin_name, ea64):
     elif platform == "win32":
         builder = MSVCBuilder()
         platform_macros = [ "__NT__" ]
-        python_libpath = sysconfig.EXEC_PREFIX + os.sep + "libs"
+        python_libpath = os.path.join(sysconfig.EXEC_PREFIX, "libs")
         python_library = "python%d%d.lib" % (PYTHON_MAJOR_VERSION, PYTHON_MINOR_VERSION)
         ida_libpath = os.path.join(idasdkdir, "lib", ea64 and "x86_win_vc_64" or "x86_win_vc_32")
         ida_lib = "ida.lib"

examples/chooser.py

@@ -9,7 +9,7 @@
 
 #
 # Modal chooser
-# 
+#
 
 # Get a modal Choose instance
 chooser = Choose([], "MyChooser", 1)
@@ -21,28 +21,30 @@
 ch = chooser.choose()
 # Print the results
 if ch > 0:
-	print "You chose %d which is %s" % (ch, chooser.list[ch-1])
+    print "You chose %d which is %s" % (ch, chooser.list[ch-1])
 else:
-	print "Escape from chooser"
+    print "Escape from chooser"
 
 #
 # Normal chooser
 #
 class MyChoose(Choose):
-	"""
-	You have to subclass Chooser to override the enter() method
-	"""
-	def __init__(self, list=[], name="Choose"):
-		Choose.__init__(self, list, name)
-		# Set the width
-		self.width = 50
+    """
+    You have to subclass Chooser to override the enter() method
+    """
+    def __init__(self, list=[], name="Choose"):
+        Choose.__init__(self, list, name)
+        # Set the width
+        self.width = 50
+        self.deflt = 1
 
-	def enter(self, n):
-		print "Enter called. Do some stuff here."
-		print "The chosen item is %d = %s" % (n, self.list[n-1])
-		print "Now press ESC to leave."
+    def enter(self, n):
+        print "Enter called. Do some stuff here."
+        print "The chosen item is %d = %s" % (n, self.list[n-1])
+        print "Now press ESC to leave."
 
 # Get a Choose instance
 chooser = MyChoose([ "First", "Second", "Third" ], "MyChoose")
+
 # Run the chooser
 ch = chooser.choose()