Metadata-Version: 2.3
Name: mitreattack-python
Version: 5.4.3
Summary: MITRE ATT&CK python library
Author: MITRE ATT&CK
Author-email: MITRE ATT&CK <attack@mitre.org>
License: Apache-2.0
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Security
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Requires-Dist: colour>=0.1.5
Requires-Dist: deepdiff>=6.6.0
Requires-Dist: drawsvg>=2.4.0
Requires-Dist: loguru>=0.6.0
Requires-Dist: markdown>=3.5
Requires-Dist: numpy>=1.26.1
Requires-Dist: openpyxl>=3.1.2
Requires-Dist: pandas>=2.1.1
Requires-Dist: pooch>=1.7.0
Requires-Dist: python-dateutil>=2.8.2
Requires-Dist: pillow>=10.1.0
Requires-Dist: requests>=2.31.0
Requires-Dist: rich>=13.6.0
Requires-Dist: stix2>=3.0.1
Requires-Dist: tabulate>=0.9.0
Requires-Dist: tqdm>=4.66.1
Requires-Dist: typer>=0.9.0
Requires-Dist: typing-extensions>=4.0.0
Requires-Dist: wheel>=0.41.2
Requires-Dist: xlsxwriter>=3.1.8
Requires-Dist: uv>=0.10.4 ; extra == 'ci'
Requires-Dist: check-wheel-contents>=0.6.1 ; extra == 'dev'
Requires-Dist: commitizen>=4.9.1 ; extra == 'dev'
Requires-Dist: pre-commit>=4.0.0 ; extra == 'dev'
Requires-Dist: pytest>=8.4.2 ; extra == 'dev'
Requires-Dist: pytest-cov>=7.0.0 ; extra == 'dev'
Requires-Dist: pytest-dotenv>=0.5.2 ; extra == 'dev'
Requires-Dist: python-semantic-release>=10.5.0 ; extra == 'dev'
Requires-Dist: responses>=0.25.8 ; extra == 'dev'
Requires-Dist: ruff>=0.14.2 ; extra == 'dev'
Requires-Dist: sphinx>=8.2.3 ; extra == 'docs'
Requires-Dist: sphinx-rtd-theme>=3.0.2 ; extra == 'docs'
Requires-Python: >=3.11, <4.0
Project-URL: homepage, https://github.com/mitre-attack/mitreattack-python/
Project-URL: repository, https://github.com/mitre-attack/mitreattack-python/
Project-URL: documentation, https://mitreattack-python.readthedocs.io/
Provides-Extra: ci
Provides-Extra: dev
Provides-Extra: docs
Description-Content-Type: text/markdown

# mitreattack-python

This repository contains a library of Python tools and utilities for working with ATT&CK data.
For more information, see the [full documentation](https://mitreattack-python.readthedocs.io/) on ReadTheDocs.

## Install

To use this package, install the mitreattack-python library with [pip](https://pip.pypa.io/en/stable/):

```shell
pip install mitreattack-python
```

## MitreAttackData Library

The ``MitreAttackData`` library is used to read in and work with MITRE ATT&CK STIX 2.0 content. This library provides
the ability to query the dataset for objects and their related objects. This is the main content of mitreattack-python;
you can read more about other modules in this library under "Additional Modules".

## Related MITRE Work

### CTI

[Cyber Threat Intelligence repository](https://github.com/mitre/cti) of the ATT&CK catalog expressed in STIX 2.0 JSON.
This repository also contains [our USAGE document](https://github.com/mitre/cti/blob/master/USAGE.md) which includes
additional examples of accessing and parsing our dataset in Python.

### ATT&CK

ATT&CK® is a curated knowledge base and model for cyber adversary behavior, reflecting the various phases of
an adversary’s lifecycle, and the platforms they are known to target.
ATT&CK is useful for understanding security risk against known adversary behavior,
for planning security improvements, and verifying defenses work as expected.

<https://attack.mitre.org>

### STIX

Structured Threat Information Expression (STIX<sup>™</sup>) is a language and serialization format used to exchange cyber threat intelligence (CTI).

STIX enables organizations to share CTI with one another in a consistent and machine-readable manner,
allowing security communities to better understand what computer-based attacks they are most likely to
see and to anticipate and/or respond to those attacks faster and more effectively.

STIX is designed to improve many capabilities, such as collaborative threat analysis, automated threat exchange, automated detection and response, and more.

<https://oasis-open.github.io/cti-documentation/>

## Contributing

To contribute to this project, either through a bug report, feature request, or merge request,
please see the [Contributors Guide](https://github.com/mitre-attack/mitreattack-python/blob/main/docs/CONTRIBUTING.md).
