Metadata-Version: 2.4
Name: psengine
Version: 2.3.1
Summary: psengine is a simple, yet elegant, library for rapid development of integrations with Recorded Future.
Author-email: Moise Medici <moise.medici@recordedfuture.com>, Patrick Kinsella <patrick.kinsella@recordedfuture.com>, Ernest Bartosevic <ernest.bartosevic@recordedfuture.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/RecordedFuture-ProfessionalServices/psengine
Project-URL: Changelog, https://recordedfuture-professionalservices.github.io/psengine/CHANGELOG/
Keywords: API,Recorded Future,Cyber Security Engineering,Threat Intelligence
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python
Classifier: Intended Audience :: Developers
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: <3.14,>=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.27.1
Requires-Dist: jsonpath_ng<=1.6.1,>=1.5.3
Requires-Dist: stix2~=3.0.1
Requires-Dist: python-dateutil>=2.7.0
Requires-Dist: more-itertools<=10.2.0,>=9.0.0
Requires-Dist: pydantic<3.0.0,>=2.7
Requires-Dist: pydantic-settings[toml]<2.11.0,>=2.5.2
Requires-Dist: markdown-strings==3.4.0
Provides-Extra: dev
Requires-Dist: pytest==8.3.4; extra == "dev"
Requires-Dist: pytest-cov==6.0.0; extra == "dev"
Requires-Dist: pytest-mock==3.14.0; extra == "dev"
Requires-Dist: pytest-md==0.2.0; extra == "dev"
Requires-Dist: pytest-random-order==1.1.1; extra == "dev"
Requires-Dist: pytest-httpdbg==0.9.0; extra == "dev"
Requires-Dist: ruff~=0.11.0; extra == "dev"
Requires-Dist: mimesis>=12.1.0; extra == "dev"
Requires-Dist: build==1.3.0; extra == "dev"
Requires-Dist: wheel==0.45.1; extra == "dev"
Requires-Dist: setuptools==80.9.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: ruff~=0.11.0; extra == "docs"
Requires-Dist: mike~=2.1.3; extra == "docs"
Requires-Dist: mkdocs~=1.6.1; extra == "docs"
Requires-Dist: mkdocs-material~=9.6.18; extra == "docs"
Requires-Dist: mkdocstrings[python]>=0.18; extra == "docs"
Requires-Dist: griffe-typingdoc~=0.2.8; extra == "docs"
Requires-Dist: mkdocs-codeinclude-plugin~=0.2.1; extra == "docs"
Requires-Dist: markdown-include~=0.8.1; extra == "docs"
Requires-Dist: mkdocs-exclude~=1.0.2; extra == "docs"
Requires-Dist: rich; extra == "docs"
Requires-Dist: logging-tree; extra == "docs"
Dynamic: license-file

**Documentation**: <https://recordedfuture-professionalservices.github.io/psengine/>

**Github**: <https://github.com/RecordedFuture-ProfessionalServices/psengine>

**PyPi**: <https://pypi.org/project/psengine/>

---

PSEngine is a simple, yet elegant, library for rapid development of integrations with Recorded Future.

PSEngine allows you to interact with the Recorded Future API extremely easily. There’s no need to manually build the URLs and query parameters, just use the modules dedicated to individual API endpoints.

PSEngine is a Python package solely built and maintained by the Cyber Security Engineering team powering a number of high profile integrations, such as: Elasticsearch, QRadar, Anomali, Jira, TheHive, etc.

## Installation

PSEngine is a Python package that can be installed using `pip`. To install PSengine, run the following command:

```bash
pip install psengine
```

PSEngine officially supports Python >= 3.9, < 3.14.


## Supported Features & Best Practices

PSEngine is ready for the demands of building robust and reliable integrations.

It can easily interact with the following Recorded Future datasets:

- Analyst Notes
- Collective Insights
- Classic & Playbook Alerts
- Detection Rules
- Fusion File management
- Identity Exposures management
- List management
- Malware Sandbox reports download
- On demand IOC enrichment
- Risklists
- Risk History
- STIX conversion


And facilitate the development with features like:

- Built-in logging
- Easy configuration management
- Markdown creation from certain data types
- Proxy support

