Commit 207ca8a7ff71617f0ccaae937b5042647d132ff5

Authored by Christian Herdtweck
1 parent cb072e36

ppt_parser: add warning that this might be replaced

Want to discourage people working on ppt_parser, which would increase the
amount of code required to reprodcue in ppt_record_parser in order for it
to replace ppt_parser
Showing 1 changed file with 10 additions and 1 deletions
oletools/ppt_parser.py
... ... @@ -6,11 +6,19 @@ Code much influenced by olevba._extract_vba but much more object-oriented
6 6 (possibly slightly excessively so)
7 7  
8 8 Currently quite narrowly focused on extracting VBA from ppt files, no slides or
9   -stuff, but built to be extended to parsing more/all of the file
  9 +stuff, but built to be extended to parsing more/all of the file. For better
  10 +"understanding" of ppt files, see module ppt_record_parser, which will probably
  11 +replace this module some time soon.
10 12  
11 13 References:
12 14 * https://msdn.microsoft.com/en-us/library/dd921564%28v=office.12%29.aspx
13 15 and links there-in
  16 +
  17 +WARNING!
  18 +Before thinking about understanding or even extending this module, please keep
  19 +in mind that module ppt_record_parser has a better "understanding" of the ppt
  20 +file structure and will replace this module some time soon!
  21 +
14 22 """
15 23  
16 24 # === LICENSE =================================================================
... ... @@ -24,6 +32,7 @@ References:
24 32 # - license
25 33 # - make buffered stream from output of iterative_decompress
26 34 # - maybe can merge the 2 decorators into 1? (with_opened_main_stream)
  35 +# - REPLACE THIS MODULE with ppt_record_parser
27 36  
28 37  
29 38 # CHANGELOG:
... ...