A Python library for parsing, manipulating, and generating
Malware Attribute Enumeration and Characterization (MAEC™) <https://maecproject.github.io/>_ v4.1 content.
|travis badge| |landscape.io badge| |version badge| |downloads badge|
.. |travis badge| image:: https://api.travis-ci.org/MAECProject/python-maec.svg?branch=master :target: https://travis-ci.org/MAECProject/python-maec :alt: Build Status .. |landscape.io badge| image:: https://landscape.io/github/MAECProject/python-maec/master/landscape.svg?style=flat :target: https://landscape.io/github/MAECProject/python-maec/master :alt: Code Health .. |Version Badge| image:: https://img.shields.io/pypi/v/maec.svg?maxAge=3600 :target: https://pypi.python.org/pypi/maec/ .. |Downloads Badge| image:: https://img.shields.io/pypi/dm/maec.svg?maxAge=3600 :target: https://pypi.python.org/pypi/maec/
A primary goal of the python-maec library is to remain faithful to both the MAEC standard and to customary Python practices. There are places where these will conflict, and the goal is to make the library intuitive both to those familiar with the XML schemas (but less familiar with Python) and also to experienced Python developers who want to add MAEC support to their programs.
There are currently two levels of APIs for dealing with MAEC content:
generateDS <http://www.rexx.com/~dkuhlman/generateDS.html>_. With these, any MAEC content can be parsed from or written to XML, but requires a bit more knowledge of the actual MAEC schemas. These "binding classes" are all located in the
The python-maec library is tested against Python 2.7 and 3.4+.
Releases of the python-maec library will be given version numbers of the form
correspond to the MAEC version being supported. The
revision number is used
to indicate new versions of the python-maec library itself.
The python-maec library can be installed via the distutils setup.py script included at the root directory:
$ python setup.py install
The python-maec library is also hosted on
PyPI <https://pypi.python.org/pypi/maec/> and can be installed with
$ pip install maec
maec package depends on the following Python libraries:
setuptools (only if installing using setup.py)
For Windows installers of the above libraries, we recommend looking here: http://www.lfd.uci.edu/~gohlke/pythonlibs. python-cybox can be found at https://github.com/CybOXProject/python-cybox/releases.
lxml on Ubuntu, you will need the following packages from the
Ubuntu package repository:
For more information about installing lxml, see http://lxml.de/installation.html.
Bug reports and feature requests are welcome and encouraged. Pull requests are
especially appreciated. Feel free to use the issue tracker on GitHub, join the
MAEC Community Email Discussion List <https://maec.mitre.org/community/discussionlist.html>_, or send an email directly to email@example.com.