|
|
- Metadata-Version: 2.1
- Name: olefile
- Version: 0.46
- Summary: Python package to parse, read and write Microsoft OLE2 files (Structured Storage or Compound Document, Microsoft Office)
- Home-page: https://www.decalage.info/python/olefileio
- Author: Philippe Lagadec
- Author-email: nospam@decalage.info
- License: BSD
- Download-URL: https://github.com/decalage2/olefile/tarball/master
- Platform: UNKNOWN
- Classifier: Development Status :: 5 - Production/Stable
- Classifier: Intended Audience :: Developers
- Classifier: Intended Audience :: Information Technology
- Classifier: Intended Audience :: Science/Research
- Classifier: Intended Audience :: System Administrators
- Classifier: License :: OSI Approved :: BSD License
- Classifier: Operating System :: OS Independent
- Classifier: Programming Language :: Python
- Classifier: Programming Language :: Python :: 2
- Classifier: Programming Language :: Python :: 2.7
- Classifier: Programming Language :: Python :: 3
- Classifier: Programming Language :: Python :: 3.4
- Classifier: Programming Language :: Python :: 3.5
- Classifier: Programming Language :: Python :: 3.6
- Classifier: Programming Language :: Python :: 3.7
- Classifier: Programming Language :: Python :: Implementation :: CPython
- Classifier: Programming Language :: Python :: Implementation :: PyPy
- Classifier: Topic :: Software Development :: Libraries :: Python Modules
- Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
-
- olefile
- =======
-
- |Build Status TravisCI| |Build Status AppVeyor| |Coverage Status|
- |Documentation Status| |PyPI| |Can I Use Python 3?| |Say Thanks!|
-
- `olefile <https://www.decalage.info/olefile>`__ is a Python package to
- parse, read and write `Microsoft OLE2
- files <http://en.wikipedia.org/wiki/Compound_File_Binary_Format>`__
- (also called Structured Storage, Compound File Binary Format or Compound
- Document File Format), such as Microsoft Office 97-2003 documents,
- vbaProject.bin in MS Office 2007+ files, Image Composer and FlashPix
- files, Outlook messages, StickyNotes, several Microscopy file formats,
- McAfee antivirus quarantine files, etc.
-
- **Quick links:** `Home page <https://www.decalage.info/olefile>`__ -
- `Download/Install <http://olefile.readthedocs.io/en/latest/Install.html>`__
- - `Documentation <http://olefile.readthedocs.io/en/latest>`__ - `Report
- Issues/Suggestions/Questions <https://github.com/decalage2/olefile/issues>`__
- - `Contact the author <https://www.decalage.info/contact>`__ -
- `Repository <https://github.com/decalage2/olefile>`__ - `Updates on
- Twitter <https://twitter.com/decalage2>`__
-
- News
- ----
-
- Follow all updates and news on Twitter: https://twitter.com/decalage2
-
- - **2018-09-09 v0.46**: OleFileIO can now be used as a context manager
- (with...as), to close the file automatically (see
- `doc <https://olefile.readthedocs.io/en/latest/Howto.html#open-an-ole-file-from-disk>`__).
- Improved handling of malformed files, fixed several bugs.
- - 2018-01-24 v0.45: olefile can now overwrite streams of any size,
- improved handling of malformed files, fixed several
- `bugs <https://github.com/decalage2/olefile/milestone/4?closed=1>`__,
- end of support for Python 2.6 and 3.3.
- - 2017-01-06 v0.44: several bugfixes, removed support for Python 2.5
- (olefile2), added support for incomplete streams and incorrect
- directory entries (to read malformed documents), added getclsid,
- improved `documentation <http://olefile.readthedocs.io/en/latest>`__
- with API reference.
- - 2017-01-04: moved the documentation to
- `ReadTheDocs <http://olefile.readthedocs.io/en/latest>`__
- - 2016-05-20: moved olefile repository to
- `GitHub <https://github.com/decalage2/olefile>`__
- - 2016-02-02 v0.43: fixed issues
- `#26 <https://github.com/decalage2/olefile/issues/26>`__ and
- `#27 <https://github.com/decalage2/olefile/issues/27>`__, better
- handling of malformed files, use python logging.
- - see
- `changelog <https://github.com/decalage2/olefile/blob/master/CHANGELOG.md>`__
- for more detailed information and the latest changes.
-
- Download/Install
- ----------------
-
- If you have pip or setuptools installed (pip is included in Python
- 2.7.9+), you may simply run **pip install olefile** or **easy_install
- olefile** for the first installation.
-
- To update olefile, run **pip install -U olefile**.
-
- Otherwise, see http://olefile.readthedocs.io/en/latest/Install.html
-
- Features
- --------
-
- - Parse, read and write any OLE file such as Microsoft Office 97-2003
- legacy document formats (Word .doc, Excel .xls, PowerPoint .ppt,
- Visio .vsd, Project .mpp), Image Composer and FlashPix files, Outlook
- messages, StickyNotes, Zeiss AxioVision ZVI files, Olympus FluoView
- OIB files, etc
- - List all the streams and storages contained in an OLE file
- - Open streams as files
- - Parse and read property streams, containing metadata of the file
- - Portable, pure Python module, no dependency
-
- olefile can be used as an independent package or with PIL/Pillow.
-
- olefile is mostly meant for developers. If you are looking for tools to
- analyze OLE files or to extract data (especially for security purposes
- such as malware analysis and forensics), then please also check my
- `python-oletools <https://www.decalage.info/python/oletools>`__, which
- are built upon olefile and provide a higher-level interface.
-
- Documentation
- -------------
-
- Please see the `online
- documentation <http://olefile.readthedocs.io/en/latest>`__ for more
- information.
-
- Real-life examples
- ------------------
-
- A real-life example: `using OleFileIO_PL for malware analysis and
- forensics <http://blog.gregback.net/2011/03/using-remnux-for-forensic-puzzle-6/>`__.
-
- See also `this
- paper <https://computer-forensics.sans.org/community/papers/gcfa/grow-forensic-tools-taxonomy-python-libraries-helpful-forensic-analysis_6879>`__
- about python tools for forensics, which features olefile.
-
- License
- -------
-
- olefile (formerly OleFileIO_PL) is copyright (c) 2005-2018 Philippe
- Lagadec (https://www.decalage.info)
-
- All rights reserved.
-
- Redistribution and use in source and binary forms, with or without
- modification, are permitted provided that the following conditions are
- met:
-
- - Redistributions of source code must retain the above copyright
- notice, this list of conditions and the following disclaimer.
- - Redistributions in binary form must reproduce the above copyright
- notice, this list of conditions and the following disclaimer in the
- documentation and/or other materials provided with the distribution.
-
- THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
- IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
- TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
- PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
- HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
- SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
- TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
- PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
- SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
- --------------
-
- olefile is based on source code from the OleFileIO module of the Python
- Imaging Library (PIL) published by Fredrik Lundh under the following
- license:
-
- The Python Imaging Library (PIL) is
-
- - Copyright (c) 1997-2009 by Secret Labs AB
- - Copyright (c) 1995-2009 by Fredrik Lundh
-
- By obtaining, using, and/or copying this software and/or its associated
- documentation, you agree that you have read, understood, and will comply
- with the following terms and conditions:
-
- Permission to use, copy, modify, and distribute this software and its
- associated documentation for any purpose and without fee is hereby
- granted, provided that the above copyright notice appears in all copies,
- and that both that copyright notice and this permission notice appear in
- supporting documentation, and that the name of Secret Labs AB or the
- author not be used in advertising or publicity pertaining to
- distribution of the software without specific, written prior permission.
-
- SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO
- THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
- FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR BE LIABLE FOR
- ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
- RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
- CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
- CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-
- .. |Build Status TravisCI| image:: https://travis-ci.org/decalage2/olefile.svg?branch=master
- :target: https://travis-ci.org/decalage2/olefile
- .. |Build Status AppVeyor| image:: https://ci.appveyor.com/api/projects/status/github/decalage2/olefile?svg=true
- :target: https://ci.appveyor.com/project/decalage2/olefile
- .. |Coverage Status| image:: https://coveralls.io/repos/github/decalage2/olefile/badge.svg?branch=master
- :target: https://coveralls.io/github/decalage2/olefile?branch=master
- .. |Documentation Status| image:: http://readthedocs.org/projects/olefile/badge/?version=latest
- :target: http://olefile.readthedocs.io/en/latest/?badge=latest
- .. |PyPI| image:: https://img.shields.io/pypi/v/olefile.svg
- :target: https://pypi.org/project/olefile/
- .. |Can I Use Python 3?| image:: https://caniusepython3.com/project/olefile.svg
- :target: https://caniusepython3.com/project/olefile
- .. |Say Thanks!| image:: https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg
- :target: https://saythanks.io/to/decalage2
-
-
|