{ "info": { "author": "The MITRE Corporation", "author_email": "stix@mitre.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "stixmarx\r\n========\r\n\r\nA Python API for marking STIX data.\r\n\r\n:Source: https://github.com/mitre/stixmarx/\r\n:Documentation: http://stixmarx.readthedocs.org/\r\n:Information: https://stixproject.github.io/\r\n\r\n|travis_badge| |landscape.io_badge| |version_badge|\r\n\r\nData Markings Concept\r\n---------------------\r\n\r\nLearn more about the Data Markings concept `here `_.\r\n\r\nExamples\r\n--------\r\n\r\nThe following examples demonstrate the intended use of the stixmarx library.\r\n\r\nAdding Markings\r\n~~~~~~~~~~~~~~~\r\n\r\n.. code-block:: python\r\n\r\n # stixmarx imports\r\n import stixmarx\r\n\r\n # python-stix imports\r\n from stix.indicator import Indicator\r\n from stix.data_marking import MarkingSpecification\r\n from stix.extensions.marking.tlp import TLPMarkingStructure as TLP\r\n\r\n\r\n # Create a new stixmarx MarkingContainer with a\r\n # new STIXPackage object contained within it.\r\n container = stixmarx.new()\r\n\r\n # Get the associated STIX Package\r\n package = container.package\r\n\r\n # Create an Indicator object\r\n indicator = Indicator(title='Indicator Title', description='Gonna Mark This')\r\n\r\n # Add the Indicator object to our STIX Package\r\n package.add(indicator)\r\n\r\n # Build MarkingSpecification and add TLP MarkingStructure\r\n red_marking = MarkingSpecification(marking_structures=TLP(color=\"RED\"))\r\n amber_marking = MarkingSpecification(marking_structures=TLP(color=\"AMBER\"))\r\n green_marking = MarkingSpecification(marking_structures=TLP(color=\"GREEN\"))\r\n\r\n\r\n # Mark the indicator with our TLP RED marking\r\n # This is the equivalent of a component marking. Applies to all descendants\r\n # nodes, text and attributes.\r\n container.add_marking(indicator, red_marking, descendants=True)\r\n\r\n\r\n # Mark the indicator with TLP GREEN. If descendants is false, the marking\r\n # will only apply to the indicator node. Does NOT include text, attributes\r\n # or descendants.\r\n container.add_marking(indicator, green_marking)\r\n\r\n\r\n # Mark the description text.\r\n # >>> type(indicator.description.value) \r\n indicator.description.value = container.add_marking(indicator.description.value, amber_marking)\r\n # >>> type(indicator.description.value) \r\n\r\n\r\n # Mark the indicator timestamp attribute.\r\n # >>> type(indicator.timestamp) \r\n indicator.timestamp = container.add_marking(indicator.timestamp, amber_marking)\r\n # >>> type(indicator.timestamp) \r\n\r\n # Print the XML!\r\n print container.to_xml()\r\n\r\nRetrieving Markings\r\n~~~~~~~~~~~~~~~~~~~\r\n\r\n.. code-block:: python\r\n\r\n # stixmarx\r\n import stixmarx\r\n\r\n # Parse the input into a MarkingContainer\r\n container = stixmarx.parse(\"stix-document.xml\")\r\n\r\n # Get container package\r\n package = container.package\r\n\r\n # Get the markings that apply to the entire XML document\r\n global_markings = container.get_markings(package)\r\n\r\n # Print the dictionary representation for our only global marking\r\n marking = global_markings[0]\r\n print marking.to_dict()\r\n\r\n # Get our only indicator from the STIX Package\r\n indicator = package.indicators[0]\r\n\r\n # Get the markings from the Indicator.\r\n # Note: This will include the global markings and any other markings\r\n # applied by an ancestor!\r\n indicator_markings = container.get_markings(indicator)\r\n\r\n # Print the Indicator markings!\r\n for marking in indicator_markings:\r\n print marking.to_dict()\r\n\r\nNotice\r\n------\r\n\r\nThis software was produced for the U. S. Government, and is subject to the\r\nRights in Data-General Clause 52.227-14, Alt. IV (DEC 2007).\r\n\r\nCopyright (c) 2017, The MITRE Corporation. All Rights Reserved.\r\n\r\n.. |travis_badge| image:: https://travis-ci.org/mitre/stixmarx.svg?branch=master&style=flat-square\r\n :target: https://travis-ci.org/mitre/stixmarx\r\n :alt: Travis CI Build Status\r\n.. |landscape.io_badge| image:: https://landscape.io/github/mitre/stixmarx/master/landscape.svg?style=flat-square\r\n :target: https://landscape.io/github/mitre/stixmarx/master\r\n :alt: Landscape.io Code Health\r\n.. |version_badge| image:: https://img.shields.io/pypi/v/stixmarx.svg?maxAge=3600&style=flat-square\r\n :target: https://pypi.python.org/pypi/stixmarx/\r\n :alt: PyPI Package Index\r\n\r\n\r\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/mitre/stixmarx", "keywords": "", "license": "BSD", "maintainer": "", "maintainer_email": "", "name": "stixmarx", "package_url": "https://pypi.org/project/stixmarx/", "platform": "", "project_url": "https://pypi.org/project/stixmarx/", "project_urls": { "Homepage": "https://github.com/mitre/stixmarx" }, "release_url": "https://pypi.org/project/stixmarx/1.0.6/", "requires_dist": [ "stix (<1.2.1.0,>=1.1.1.8)" ], "requires_python": "", "summary": "A data marking API for STIX 1 content.", "version": "1.0.6" }, "last_serial": 5793747, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "f0691416b947a2e7f7ae74d815af5757", "sha256": "39085aac6485b3aa8c35345172214ada683545b22caea0c2d2f490691f1c499e" }, "downloads": -1, "filename": "stixmarx-1.0.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "f0691416b947a2e7f7ae74d815af5757", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 78955, "upload_time": "2017-05-10T19:43:26", "url": "https://files.pythonhosted.org/packages/59/22/59fd309766bc4032017565ea9a7dcafbc5d9d9b80eda6b37f206c8f4ccbc/stixmarx-1.0.0-py2.py3-none-any.whl" } ], "1.0.1": [ { "comment_text": "", "digests": { "md5": "04ba83671a011795b5edcd4844fc4f63", "sha256": "e7cdde03f3309740967442f9f603043ebf70f0566d9cecbd0d56075578c20f28" }, "downloads": -1, "filename": "stixmarx-1.0.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "04ba83671a011795b5edcd4844fc4f63", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 79032, "upload_time": "2017-05-12T15:52:35", "url": "https://files.pythonhosted.org/packages/7a/be/c94d01d2d6eaba808a933802337a229e058e1def1a0f512fac85d6309a6f/stixmarx-1.0.1-py2.py3-none-any.whl" } ], "1.0.2": [ { "comment_text": "", "digests": { "md5": "36544cc85d5de7ef61dee85515abe41d", "sha256": "dfaa2f52c9797cacdb8f81fb2438954599a260072fa9565189638abbcc0ae3fd" }, "downloads": -1, "filename": "stixmarx-1.0.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "36544cc85d5de7ef61dee85515abe41d", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 80563, "upload_time": "2017-06-01T11:54:42", "url": "https://files.pythonhosted.org/packages/e3/67/099ce6ef8ae9a4bf9cbeb381b721df858a20e7f3a3585e7312f8a5a34505/stixmarx-1.0.2-py2.py3-none-any.whl" } ], "1.0.3": [ { "comment_text": "", "digests": { "md5": "eaaa67190ceed82428332abd8d32e553", "sha256": "46bc0bc4444150b6575c6a06d07d754a96717e4b51fdf86a2c9f36c0ef36520b" }, "downloads": -1, "filename": "stixmarx-1.0.3-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "eaaa67190ceed82428332abd8d32e553", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 121555, "upload_time": "2018-03-21T17:41:05", "url": "https://files.pythonhosted.org/packages/82/ee/87b23107c159a08bbcd4a534e5f58434473f18d8f66f4b493daea5f54251/stixmarx-1.0.3-py2.py3-none-any.whl" } ], "1.0.4": [ { "comment_text": "", "digests": { "md5": "3789825e54f74e9c508b7fa2e06af2a5", "sha256": "5b61b38ae5e5f512e6fe36613fde5b2c130b195816f263bb78bab2686632ea5b" }, "downloads": -1, "filename": "stixmarx-1.0.4-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "3789825e54f74e9c508b7fa2e06af2a5", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 121514, "upload_time": "2018-10-04T14:26:22", "url": "https://files.pythonhosted.org/packages/e7/8c/29230862bcb42e2316be96dd6461eab18d86dc71cc6238d8c0030bc5e520/stixmarx-1.0.4-py2.py3-none-any.whl" } ], "1.0.5": [ { "comment_text": "", "digests": { "md5": "eca3b1b82fba6d8c59b25953da3db776", "sha256": "4169682ef0a9d85885e2b209579d23abc1f6be312a130d13a8b1a72758a3d2f7" }, "downloads": -1, "filename": "stixmarx-1.0.5-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "eca3b1b82fba6d8c59b25953da3db776", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 120211, "upload_time": "2019-01-14T18:28:35", "url": "https://files.pythonhosted.org/packages/f4/96/01f48edd3b24256a2f0e7132440b2cdfff243a57f33d1fa0bc3eb2e69576/stixmarx-1.0.5-py2.py3-none-any.whl" } ], "1.0.6": [ { "comment_text": "", "digests": { "md5": "e6ecb04cada931faba8cdeb680d5c49b", "sha256": "1068ead867509117c3e4ea6f42cf10021a9c57067491c2b56dc8df8ec472cbf2" }, "downloads": -1, "filename": "stixmarx-1.0.6-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "e6ecb04cada931faba8cdeb680d5c49b", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 120194, "upload_time": "2019-09-06T20:13:14", "url": "https://files.pythonhosted.org/packages/51/a2/4f36c69a6ee8c93ec1ef3c46846546773d9a01a8bde79256aa2ae6c91207/stixmarx-1.0.6-py2.py3-none-any.whl" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "e6ecb04cada931faba8cdeb680d5c49b", "sha256": "1068ead867509117c3e4ea6f42cf10021a9c57067491c2b56dc8df8ec472cbf2" }, "downloads": -1, "filename": "stixmarx-1.0.6-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "e6ecb04cada931faba8cdeb680d5c49b", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 120194, "upload_time": "2019-09-06T20:13:14", "url": "https://files.pythonhosted.org/packages/51/a2/4f36c69a6ee8c93ec1ef3c46846546773d9a01a8bde79256aa2ae6c91207/stixmarx-1.0.6-py2.py3-none-any.whl" } ] }