File: ANNOUNCE

package info (click to toggle)
decompyle 2.3.2-4.1
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 2,324 kB
  • ctags: 66,233
  • sloc: python: 70,351; ansic: 2,329; makefile: 43; sh: 14
file content (108 lines) | stat: -rw-r--r-- 3,209 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

Announcing:

             decompyle -- A Python byte-code decompiler

                      version 2.3


'decompyle' converts Python byte-code back into equivalent Python
source. It accepts byte-code from any Python version starting with 1.5
up to 2.3.

The generated source is very readable: docstrings, lists, tuples and
hashes get pretty-printed.

'decompyle' may also verify the equivalence of the generated source by
by compiling it and comparing both byte-codes.


New Features 
------------

Since Release 2.2beta1:

  * Now decompyles byte-code from Python versions 1.5 up to 2.3

  * Use the marshal and dis code from each python version to make
    decompilation independent of the interpreter decompyle runs with.
    (One can for example decompile python2.3 bytecode while running 
     under python 2.2)

  * Runs under python 2.2 and 2.3


Since Release 0.6.0:

  * Now decompyles byte-code from Python versions 1.5 up to 2.2

  * Now requires Python 2.2 but is able to decompyle older byte-code,
    too. Prior version of decompyle had to be run with the Python
    version which generated the byte-code.

  * pretty-prints docstrings, hashes, lists and tuples

  * decompyle is now a script and a package

  * Now adds an emacs mode-hint and tab-width to the output files

  * enhanced test suite: more test patterns, .pyc/.pyo included

  * avoids unnecessary 'global' statements

  * many internal changes and code overhouls

  Please refere to the file 'CHANGES' for a list of changes in this
  release.


Where to get it?
----------------

(Edited 3 July 2004, Ben Burton)

The original website from which this software was obtained is no longer
available.  It has now become a commercial decompilation service, with
no software available for download.

Any developers seeking to make alterations or enhancements to this code
should therefore consider these debian packages an appropriate starting
point.


Simple Help Needed!
-------------------

Please help testing 'decompyle'! 

The EXTENDED_ARG token is untested (this is a new token for Python 2.0
which is used only if many items exist within a code object). If you
have byte-code which does or may include this token, please try to
decompyle your application.

It's easy: the script 'test_pythonlib' which is included in the source
           distribution does the job for you. Just read the simple
           instruction there.


Requirements
------------

'decompyle' requires Python 2.2 or later.


Known Bugs/Restrictions
-----------------------

* The EXTENDED_ARG token is untested (this is a new token for Python
  2.0 which is used only if many items exist within a code object).

* Byte-code generated by Python 2.2 differs byte-code generated by a
  prior version even for the same source. This is due the intruduction
  of iterators. Currently 'Decompyle' fails verifying the source if
  the byte-code was generated by an older version of Python.

* Verifying decompyled source with optizimzed byte code (.pyo) when
  running without optimizations (option '-O' not given) fails in most
  cases. Same is true for vis-a-versa. This is due to the fact that
  Python generated different bytecode depending on option '-O'.