maltego-transforms 1.0.0__tar.gz

maltego_transforms-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maltego Technologies GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

maltego_transforms-1.0.0/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.3
+Name: maltego-transforms
+Version: 1.0.0
+Summary: Maltego Transform development framework with async support and standalone Transform server
+License: MIT
+Keywords: maltego,osint,transforms,sdk,graph
+Author: Maltego Technologies GmbH
+Requires-Python: >=3.10,<3.15
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+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 :: Software Development :: Libraries :: Python Modules
+Provides-Extra: tracing
+Requires-Dist: Pillow (>=12.3.0,<13.0.0)
+Requires-Dist: aiofiles (>=24.1.0,<25.0.0)
+Requires-Dist: authlib (>=1.6.11,<1.7.0)
+Requires-Dist: cachetools (>=6.1.0,<7.0.0)
+Requires-Dist: cryptography (>=48.0.1,<49.0.0)
+Requires-Dist: fastapi (>=0.137.1,<0.138.0)
+Requires-Dist: fastapi-restful (>=0.5,<0.6)
+Requires-Dist: frozenlist (>=1.4.1,<2.0.0)
+Requires-Dist: httpx (>=0.27.2,<0.28.0)
+Requires-Dist: idna (>=3.15,<4.0)
+Requires-Dist: joserfc (>=1.6.8,<2.0.0)
+Requires-Dist: markdown (>=3.4.0,<4.0.0)
+Requires-Dist: nh3 (>=0.3.6,<0.4.0)
+Requires-Dist: opentelemetry-api (>=1.26,<2.0) ; extra == "tracing"
+Requires-Dist: opentelemetry-exporter-otlp-proto-grpc (>=1.26,<2.0) ; extra == "tracing"
+Requires-Dist: opentelemetry-instrumentation-fastapi (>=0.47b0,<1.0) ; extra == "tracing"
+Requires-Dist: opentelemetry-propagator-b3 (>=1.26,<2.0) ; extra == "tracing"
+Requires-Dist: opentelemetry-sdk (>=1.26,<2.0) ; extra == "tracing"
+Requires-Dist: packaging (>=25.0,<26.0)
+Requires-Dist: pycryptodome (>=3.20,<4.0)
+Requires-Dist: pydantic (>=2.13,<3.0)
+Requires-Dist: pydantic-settings (>=2.1,<3.0)
+Requires-Dist: python-dateutil (>=2.8.2,<3.0.0)
+Requires-Dist: signxml (>=4.4.0,<5.0.0)
+Requires-Dist: starlette (>=1.3.1,<2.0.0)
+Requires-Dist: typing-extensions (>=4.9,<5.0)
+Requires-Dist: typing-inspect (>=0.9,<0.10)
+Requires-Dist: uvicorn (>=0.35.0,<0.36.0)
+Project-URL: Documentation, https://docs.maltego.com/en/support/solutions/articles/15000062349-maltego-transforms-sdk-overview
+Project-URL: Homepage, https://github.com/MaltegoTech/maltego-transforms
+Project-URL: Repository, https://github.com/MaltegoTech/maltego-transforms
+Description-Content-Type: text/markdown
+
+# maltego-transforms
+
+**The Python SDK for building Maltego transform servers.**
+
+<!-- Badges activate once the repo goes public and the ci.yml workflow lands; they won't render against a private repo. -->
+![Tests](https://github.com/MaltegoTech/maltego-transforms/actions/workflows/ci.yml/badge.svg)
+![PyPI](https://img.shields.io/pypi/v/maltego-transforms.svg)
+![Python](https://img.shields.io/pypi/pyversions/maltego-transforms.svg)
+![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
+<!-- ![Coverage](https://codecov.io/gh/MaltegoTech/maltego-transforms/branch/main/graph/badge.svg) — add once Codecov is configured -->
+
+---
+
+A **transform** takes one or more Maltego entities as input — an IP address, a domain, a person, a document, or your own custom object — and returns related entities as output. Transforms are how Maltego expands a graph, and `maltego-transforms` is the fastest way to write and run your own.
+
+## Install
+
+```bash
+pip install maltego-transforms
+```
+
+Requires Python `>=3.10,<3.15`.
+
+## Your first transform
+
+```python
+from maltego.server import (
+    MaltegoContext,
+    MaltegoEntity,
+    MaltegoServerSettings,
+    register_transform,
+    run_server,
+    setup,
+)
+
+
+@register_transform(
+    display_name="Hello World [My Transforms]",
+    transform_set="My Transforms",
+)
+async def hello_world(
+    input_entity: MaltegoEntity,
+    context: MaltegoContext,
+) -> MaltegoEntity:
+    context.log.inform(f"Hello from {context.remote_ip}")
+    return MaltegoEntity["maltego.Phrase"](f"Hello, {input_entity.value}")  # type: ignore
+
+
+if __name__ == "__main__":
+    settings = MaltegoServerSettings(
+        server_name="My Transform Server",
+        ns="my.transforms",
+        author="i@example.com",
+    )
+    setup(settings)
+    run_server(settings=settings, ssl=False)  # plain HTTP for local development
+```
+
+Save this as `project.py` and run it:
+
+```bash
+python project.py
+```
+
+This starts a local HTTP server on `127.0.0.1:3000`, serving a seed URL at `/seed`. Add that URL to Maltego to discover and install your transforms. SSL is on by default for anything beyond local dev — see [HTTPS, Certificates, and Browser Trust](https://docs.maltego.com/en/support/solutions/articles/15000062366-https-certificates-and-browser-trust), which the Graph Browser client requires.
+
+Prefer a ready-made project over a blank file?
+
+```bash
+maltego-transforms start my_project
+cd my_project
+python -m venv .venv && source .venv/bin/activate
+pip install -r requirements.txt
+python project.py
+```
+
+This scaffolds a runnable project with example transforms covering the most common patterns.
+
+## Runbooks
+
+Repository runbooks live in [`runbooks/`](runbooks/) and capture repeatable
+workflows for contributors and coding agents, including writing PRPs for
+non-trivial changes and choosing the right test command.
+
+## Features
+
+- **Decorator-based registration** — `@register_transform` turns any function into a discoverable transform
+- **Typed input and output** — plain Python type hints; the SDK infers and validates entity types for you
+- **Async and streaming** — write `async def` transforms, or use `AsyncGenerator` to stream results as they're found
+- **OAuth** — built-in support for OAuth-authenticated transforms
+- **Transform settings** — expose configurable options (API keys, limits, toggles) that users fill in from the Maltego client
+- **Input constraints** — control which entities a transform is even offered for, before it runs
+- **Middlewares** — hook into the request/response lifecycle for logging, auth, or shared setup
+
+## Standard entities
+
+Want typed entity classes instead of raw dictionaries? [`maltego-transforms-std-entities`](https://docs.maltego.com/en/support/solutions/articles/15000062357-standard-entities-overview) ships ready-made classes like `Person`, `DNSName`, and `IPv4Address`:
+
+```bash
+pip install maltego-transforms-std-entities
+```
+
+```python
+from maltego.entities import DNSName, IPv4Address
+from maltego.server import register_transform
+
+@register_transform
+async def dns_to_ip(input_entity: DNSName) -> IPv4Address:
+    return IPv4Address("1.1.1.1")
+```
+
+## Building with an AI coding agent
+
+Scaffold a project with agent skills for authoring and testing transforms:
+
+```bash
+maltego-transforms start my-project --with-skills
+```
+
+This drops a skill index into `.agents/skills/` that points your coding agent at the right focused skill for the task at hand — building a new transform, migrating an existing one, or debugging discovery. See [Using AI Agent Skills with the SDK](https://docs.maltego.com/en/support/solutions/articles/15000062361-using-ai-agent-skills-with-the-sdk) for details.
+
+## Documentation
+
+Full docs — configuration, authentication, entity modeling, pagination, and the complete API reference — start at the **[Maltego Transforms SDK overview](https://docs.maltego.com/en/support/solutions/articles/15000062349-maltego-transforms-sdk-overview)**.
+
+## Support
+
+Questions or issues? Reach out through the [Maltego Support Portal](https://support.maltego.com/) or your Maltego account contact.
+
+## Contributing
+
+Contributions are welcome — see [`CONTRIBUTING.md`](CONTRIBUTING.md) for guidelines.
+
+## License
+
+`maltego-transforms` is licensed under the [MIT License](LICENSE).
+

maltego_transforms-1.0.0/README.md

@@ -0,0 +1,136 @@
+# maltego-transforms
+
+**The Python SDK for building Maltego transform servers.**
+
+<!-- Badges activate once the repo goes public and the ci.yml workflow lands; they won't render against a private repo. -->
+![Tests](https://github.com/MaltegoTech/maltego-transforms/actions/workflows/ci.yml/badge.svg)
+![PyPI](https://img.shields.io/pypi/v/maltego-transforms.svg)
+![Python](https://img.shields.io/pypi/pyversions/maltego-transforms.svg)
+![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
+<!-- ![Coverage](https://codecov.io/gh/MaltegoTech/maltego-transforms/branch/main/graph/badge.svg) — add once Codecov is configured -->
+
+---
+
+A **transform** takes one or more Maltego entities as input — an IP address, a domain, a person, a document, or your own custom object — and returns related entities as output. Transforms are how Maltego expands a graph, and `maltego-transforms` is the fastest way to write and run your own.
+
+## Install
+
+```bash
+pip install maltego-transforms
+```
+
+Requires Python `>=3.10,<3.15`.
+
+## Your first transform
+
+```python
+from maltego.server import (
+    MaltegoContext,
+    MaltegoEntity,
+    MaltegoServerSettings,
+    register_transform,
+    run_server,
+    setup,
+)
+
+
+@register_transform(
+    display_name="Hello World [My Transforms]",
+    transform_set="My Transforms",
+)
+async def hello_world(
+    input_entity: MaltegoEntity,
+    context: MaltegoContext,
+) -> MaltegoEntity:
+    context.log.inform(f"Hello from {context.remote_ip}")
+    return MaltegoEntity["maltego.Phrase"](f"Hello, {input_entity.value}")  # type: ignore
+
+
+if __name__ == "__main__":
+    settings = MaltegoServerSettings(
+        server_name="My Transform Server",
+        ns="my.transforms",
+        author="i@example.com",
+    )
+    setup(settings)
+    run_server(settings=settings, ssl=False)  # plain HTTP for local development
+```
+
+Save this as `project.py` and run it:
+
+```bash
+python project.py
+```
+
+This starts a local HTTP server on `127.0.0.1:3000`, serving a seed URL at `/seed`. Add that URL to Maltego to discover and install your transforms. SSL is on by default for anything beyond local dev — see [HTTPS, Certificates, and Browser Trust](https://docs.maltego.com/en/support/solutions/articles/15000062366-https-certificates-and-browser-trust), which the Graph Browser client requires.
+
+Prefer a ready-made project over a blank file?
+
+```bash
+maltego-transforms start my_project
+cd my_project
+python -m venv .venv && source .venv/bin/activate
+pip install -r requirements.txt
+python project.py
+```
+
+This scaffolds a runnable project with example transforms covering the most common patterns.
+
+## Runbooks
+
+Repository runbooks live in [`runbooks/`](runbooks/) and capture repeatable
+workflows for contributors and coding agents, including writing PRPs for
+non-trivial changes and choosing the right test command.
+
+## Features
+
+- **Decorator-based registration** — `@register_transform` turns any function into a discoverable transform
+- **Typed input and output** — plain Python type hints; the SDK infers and validates entity types for you
+- **Async and streaming** — write `async def` transforms, or use `AsyncGenerator` to stream results as they're found
+- **OAuth** — built-in support for OAuth-authenticated transforms
+- **Transform settings** — expose configurable options (API keys, limits, toggles) that users fill in from the Maltego client
+- **Input constraints** — control which entities a transform is even offered for, before it runs
+- **Middlewares** — hook into the request/response lifecycle for logging, auth, or shared setup
+
+## Standard entities
+
+Want typed entity classes instead of raw dictionaries? [`maltego-transforms-std-entities`](https://docs.maltego.com/en/support/solutions/articles/15000062357-standard-entities-overview) ships ready-made classes like `Person`, `DNSName`, and `IPv4Address`:
+
+```bash
+pip install maltego-transforms-std-entities
+```
+
+```python
+from maltego.entities import DNSName, IPv4Address
+from maltego.server import register_transform
+
+@register_transform
+async def dns_to_ip(input_entity: DNSName) -> IPv4Address:
+    return IPv4Address("1.1.1.1")
+```
+
+## Building with an AI coding agent
+
+Scaffold a project with agent skills for authoring and testing transforms:
+
+```bash
+maltego-transforms start my-project --with-skills
+```
+
+This drops a skill index into `.agents/skills/` that points your coding agent at the right focused skill for the task at hand — building a new transform, migrating an existing one, or debugging discovery. See [Using AI Agent Skills with the SDK](https://docs.maltego.com/en/support/solutions/articles/15000062361-using-ai-agent-skills-with-the-sdk) for details.
+
+## Documentation
+
+Full docs — configuration, authentication, entity modeling, pagination, and the complete API reference — start at the **[Maltego Transforms SDK overview](https://docs.maltego.com/en/support/solutions/articles/15000062349-maltego-transforms-sdk-overview)**.
+
+## Support
+
+Questions or issues? Reach out through the [Maltego Support Portal](https://support.maltego.com/) or your Maltego account contact.
+
+## Contributing
+
+Contributions are welcome — see [`CONTRIBUTING.md`](CONTRIBUTING.md) for guidelines.
+
+## License
+
+`maltego-transforms` is licensed under the [MIT License](LICENSE).

maltego_transforms-1.0.0/pyproject.toml

@@ -0,0 +1,133 @@
+[build-system]
+requires = ["poetry-core>=1.5.0"]
+build-backend = "poetry.core.masonry.api"
+
+[[tool.poetry.source]]
+name = "PyPI"
+priority = "primary"
+
+[tool.poetry]
+name = "maltego-transforms"
+version = "1.0.0"
+description = "Maltego Transform development framework with async support and standalone Transform server"
+authors = [
+    "Maltego Technologies GmbH",
+]
+license = "MIT"
+readme = "README.md"
+homepage = "https://github.com/MaltegoTech/maltego-transforms"
+repository = "https://github.com/MaltegoTech/maltego-transforms"
+documentation = "https://docs.maltego.com/en/support/solutions/articles/15000062349-maltego-transforms-sdk-overview"
+keywords = ["maltego", "osint", "transforms", "sdk", "graph"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+packages = [
+    { include = "maltego", from = "src" },
+]
+# Belt-and-suspenders exclusion of credentials/key material from built artifacts.
+# These globs are evaluated relative to the source tree that poetry packages up; they
+# complement the existing built-artifact assertion tests in src/tests/packaging/.
+exclude = [
+    "**/*.key",
+    "**/*.pem",
+    "**/*.crt",
+    "**/.env",
+    "**/.env.*",
+]
+
+[tool.poetry.scripts]
+maltego-transforms = 'maltego._cli:execute_from_command_line'
+
+
+[tool.poetry.dependencies]
+python = ">=3.10,<3.15"
+uvicorn = "^0.35.0"
+fastapi = "^0.137.1"
+aiofiles = "^24.1.0"
+cachetools = "^6.1.0"
+typing-extensions = "^4.9"
+httpx = "^0.27.2"
+python-dateutil = "^2.8.2"
+Pillow = "^12.3.0"
+pycryptodome = "^3.20"
+markdown = "^3.4.0"
+frozenlist = "^1.4.1"
+pydantic = "^2.13"
+fastapi-restful = "^0.5"
+typing-inspect = "^0.9"
+pydantic-settings = "^2.1"
+authlib = ">=1.6.11,<1.7.0"
+packaging = "^25.0"
+cryptography = "^48.0.1"
+joserfc = "^1.6.8"
+signxml = "^4.4.0"
+idna = "^3.15"
+starlette = ">=1.3.1,<2.0.0"
+nh3 = "^0.3.6"
+opentelemetry-api = {version = ">=1.26,<2.0", optional = true}
+opentelemetry-sdk = {version = ">=1.26,<2.0", optional = true}
+opentelemetry-instrumentation-fastapi = {version = ">=0.47b0,<1.0", optional = true}
+opentelemetry-propagator-b3 = {version = ">=1.26,<2.0", optional = true}
+opentelemetry-exporter-otlp-proto-grpc = {version = ">=1.26,<2.0", optional = true}
+
+[tool.poetry.extras]
+tracing = [
+    "opentelemetry-api",
+    "opentelemetry-sdk",
+    "opentelemetry-instrumentation-fastapi",
+    "opentelemetry-propagator-b3",
+    "opentelemetry-exporter-otlp-proto-grpc",
+]
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8"
+pytest-asyncio = "^0"
+pytest-cov = "^4"
+xmltodict = "^0"
+autopep8 = "^2"
+pylint= "^3"
+mypy = "^1"
+toml = "^0"
+types-aiofiles = "^22"
+types-cachetools = "^5"
+types-certifi = "^2021"
+types-chardet = "^5"
+types-python-dateutil = "^2"
+types-requests = "^2"
+types-markdown = "^3"
+types-xmltodict = "^0"
+types-Pillow = "^9"
+types-toml = "^0"
+syrupy = "^4"
+cyclonedx-bom = "^7.3.0"
+detect-secrets = "^1.5.0"
+pip-audit = "^2.10.1"
+ruff = "^0.14.11"
+pre-commit = "^4.6.0"
+commitizen = "<4.16.4"
+
+[tool.commitizen]
+name = "cz_conventional_commits"
+tag_format = "$version"
+version_scheme = "pep440"
+version_provider = "poetry"
+update_changelog_on_bump = true
+
+[tool.ruff]
+line-length = 120
+
+[tool.ruff.lint]
+ignore = [
+    "F403",
+    "F405",
+]