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,11 +6,19 @@ Code much influenced by olevba._extract_vba but much more object-oriented
6 (possibly slightly excessively so) 6 (possibly slightly excessively so)
7 7
8 Currently quite narrowly focused on extracting VBA from ppt files, no slides or 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 References: 13 References:
12 * https://msdn.microsoft.com/en-us/library/dd921564%28v=office.12%29.aspx 14 * https://msdn.microsoft.com/en-us/library/dd921564%28v=office.12%29.aspx
13 and links there-in 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 # === LICENSE ================================================================= 24 # === LICENSE =================================================================
@@ -24,6 +32,7 @@ References: @@ -24,6 +32,7 @@ References:
24 # - license 32 # - license
25 # - make buffered stream from output of iterative_decompress 33 # - make buffered stream from output of iterative_decompress
26 # - maybe can merge the 2 decorators into 1? (with_opened_main_stream) 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 # CHANGELOG: 38 # CHANGELOG: