maltego-transforms-std-entities 1.0.0__tar.gz

maltego_transforms_std_entities-1.0.0/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## v1.0.0 (2026-06-19)
+
+### Feat
+
+- Provide Python classes for the Maltego standard entity catalog.
+- Include Casefile entities under `maltego.entities.casefile`.
+- Export standard and Casefile entities from `maltego.entities`.
+- Include icon classes, category definitions, packaged icon assets, and `py.typed`.

maltego_transforms_std_entities-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_std_entities-1.0.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.3
+Name: maltego-transforms-std-entities
+Version: 1.0.0
+Summary: Python classes for the Maltego standard entity catalog.
+License: MIT
+Author: Maltego Technologies GmbH
+Requires-Python: >=3.11,<3.15
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: maltego-transforms (>=1,<4)
+Project-URL: Documentation, https://docs.maltego.com/en/support/solutions/articles/15000062357-standard-entities-overview
+Description-Content-Type: text/markdown
+
+# Maltego Standard Entities
+
+`maltego-transforms-std-entities` exposes Maltego's standard entity catalog as Python classes for transform authors.
+
+Maltego Graph Browser and Maltego Graph Desktop discover standard entity definitions from standard entity servers. Installing this package gives Python transforms reusable classes for the same standard entity type names, so transforms can emit and consume entities that pivot cleanly between each other in the graph.
+
+## Installation
+
+```bash
+pip install maltego-transforms-std-entities
+```
+
+## Basic Usage
+
+```python
+from maltego.entities import Domain, EmailAddress, IPv4Address, Website
+
+domain = Domain("example.org")
+website = Website("https://example.org")
+address = IPv4Address("203.0.113.10")
+email = EmailAddress("analyst@example.org")
+
+print(domain.TYPE_NAME, website.TYPE_NAME, address.TYPE_NAME, email.TYPE_NAME)
+```
+
+Casefile entities are part of the same catalog and can also be imported from `maltego.entities.casefile`:
+
+```python
+from maltego.entities import BankAccount, Gun
+from maltego.entities.casefile import Businessman, IdentificationNumber
+
+print(BankAccount.TYPE_NAME, Gun.TYPE_NAME)
+print(Businessman.TYPE_NAME, IdentificationNumber.TYPE_NAME)
+```
+
+## When To Extend
+
+Prefer an existing standard entity when its type name and properties match the data your transform returns. Reusing standard entities makes downstream pivots easier because other transforms already know those schemas.
+
+Extend a standard class when your data is the same kind of thing but needs additional properties:
+
+```python
+from maltego.entities import Person
+from maltego.server import MaltegoEntityConfig, MaltegoEntityProperty
+
+
+class StaffMember(Person):
+    Config = MaltegoEntityConfig(display_name="Staff Member")
+
+    employee_id: str = MaltegoEntityProperty(
+        display_name="Employee ID",
+        sample_value="E-42",
+    )
+```
+
+Create a custom entity only when no standard entity expresses the object without losing meaning or overloading unrelated fields.
+
+## Package Scope
+
+This package provides the shared Python catalog for Maltego standard entities. It includes reusable entity classes, Casefile entity classes, icon classes with packaged icon assets, category definitions, and inline type information for transform authors and server implementations.
+
+Maltego already provides discovery for these standard entities in the Graph Browser and Desktop clients, so you don't need to register them yourself. Import the classes and use them directly in your transforms.
+

maltego_transforms_std_entities-1.0.0/README.md

@@ -0,0 +1,62 @@
+# Maltego Standard Entities
+
+`maltego-transforms-std-entities` exposes Maltego's standard entity catalog as Python classes for transform authors.
+
+Maltego Graph Browser and Maltego Graph Desktop discover standard entity definitions from standard entity servers. Installing this package gives Python transforms reusable classes for the same standard entity type names, so transforms can emit and consume entities that pivot cleanly between each other in the graph.
+
+## Installation
+
+```bash
+pip install maltego-transforms-std-entities
+```
+
+## Basic Usage
+
+```python
+from maltego.entities import Domain, EmailAddress, IPv4Address, Website
+
+domain = Domain("example.org")
+website = Website("https://example.org")
+address = IPv4Address("203.0.113.10")
+email = EmailAddress("analyst@example.org")
+
+print(domain.TYPE_NAME, website.TYPE_NAME, address.TYPE_NAME, email.TYPE_NAME)
+```
+
+Casefile entities are part of the same catalog and can also be imported from `maltego.entities.casefile`:
+
+```python
+from maltego.entities import BankAccount, Gun
+from maltego.entities.casefile import Businessman, IdentificationNumber
+
+print(BankAccount.TYPE_NAME, Gun.TYPE_NAME)
+print(Businessman.TYPE_NAME, IdentificationNumber.TYPE_NAME)
+```
+
+## When To Extend
+
+Prefer an existing standard entity when its type name and properties match the data your transform returns. Reusing standard entities makes downstream pivots easier because other transforms already know those schemas.
+
+Extend a standard class when your data is the same kind of thing but needs additional properties:
+
+```python
+from maltego.entities import Person
+from maltego.server import MaltegoEntityConfig, MaltegoEntityProperty
+
+
+class StaffMember(Person):
+    Config = MaltegoEntityConfig(display_name="Staff Member")
+
+    employee_id: str = MaltegoEntityProperty(
+        display_name="Employee ID",
+        sample_value="E-42",
+    )
+```
+
+Create a custom entity only when no standard entity expresses the object without losing meaning or overloading unrelated fields.
+
+## Package Scope
+
+This package provides the shared Python catalog for Maltego standard entities. It includes reusable entity classes, Casefile entity classes, icon classes with packaged icon assets, category definitions, and inline type information for transform authors and server implementations.
+
+Maltego already provides discovery for these standard entities in the Graph Browser and Desktop clients, so you don't need to register them yourself. Import the classes and use them directly in your transforms.

maltego_transforms_std_entities-1.0.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["poetry-core>=1.5.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry]
+name = "maltego-transforms-std-entities"
+version = "1.0.0"
+description = "Python classes for the Maltego standard entity catalog."
+authors = [
+    "Maltego Technologies GmbH",
+]
+license = "MIT"
+readme = "README.md"
+packages = [
+    { include = "maltego", from = "src" },
+]
+include = [
+    "CHANGELOG.md",
+    "LICENSE",
+]
+
+[tool.poetry.urls]
+Documentation = "https://docs.maltego.com/en/support/solutions/articles/15000062357-standard-entities-overview"
+
+[tool.poetry.dependencies]
+python = ">=3.11,<3.15"
+maltego-transforms = ">=1,<4"
+
+[tool.poetry.group.dev.dependencies]
+commitizen = ">=4,<5"
+pytest = ">=7,<10"
+pytest-cov = "^4"
+ruff = ">=0.14.11"
+
+[tool.ruff]
+line-length = 120
+
+[tool.ruff.lint]
+ignore = [
+    "F403",
+    "F405",
+]
+
+[tool.commitizen]
+name = "cz_conventional_commits"
+version_provider = "poetry"
+tag_format = "v$version"
+update_changelog_on_bump = true

maltego_transforms_std_entities-1.0.0/src/maltego/categories/__init__.py

@@ -0,0 +1,23 @@
+# Copyright (c) Maltego Technologies GmbH.
+from enum import Enum
+
+__all__ = [
+    "EntityCategories",
+]
+
+
+class EntityCategories(str, Enum):
+    CRYPTOCURRENCY = "Cryptocurrency"
+    DEVICES = "Devices"
+    EVENTS = "Events"
+    GROUPS = "Groups"
+    INFRASTRUCTURE = "Infrastructure"
+    LOCATION = "Locations"
+    MALWARE = "Malware"
+    PERSONAL = "Personal"
+    SOCIAL_NETWORK = "Social Network"
+    STIX2 = "STIX2"
+    STIX2_DOMAIN_OBJECTS = "STIX 2 domain objects"
+    STIX2_OBSERVABLES = "STIX 2 observables"
+    STIX2_RELATIONSHIP_OBJECTS = "STIX 2 relationship objects"
+    TECHNOLOGY = "Technology"

maltego_transforms_std_entities-1.0.0/src/maltego/entities/__init__.py

@@ -0,0 +1,15 @@
+# Copyright (c) Maltego Technologies GmbH.
+# pylint: disable=unused-wildcard-import
+from maltego.entities.core import *
+from maltego.entities.cryptocurrency import *
+from maltego.entities.devices import *
+from maltego.entities.events import *
+from maltego.entities.groups import *
+from maltego.entities.infrastructure import *
+from maltego.entities.locations import *
+from maltego.entities.malware import *
+from maltego.entities.personal import *
+from maltego.entities.casefile import *
+from maltego.entities.social_network import *
+from maltego.entities.stix2 import *
+from maltego.entities.technology import *