Metadata-Version: 2.4
Name: mitreattack-python
Version: 5.2.1
Summary: MITRE ATT&CK python library
License: Apache-2.0
License-File: LICENSE.txt
License-File: NOTICE.txt
Author: MITRE ATT&CK
Author-email: attack@mitre.org
Requires-Python: >=3.11,<4.0
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Security
Requires-Dist: Markdown (>=3.5)
Requires-Dist: Pillow (>=10.1.0)
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: 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: 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: wheel (>=0.41.2)
Requires-Dist: xlsxwriter (>=3.1.8)
Project-URL: Documentation, https://mitreattack-python.readthedocs.io/
Project-URL: Homepage, https://github.com/mitre-attack/mitreattack-python/
Project-URL: Repository, https://github.com/mitre-attack/mitreattack-python/
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).

