pyattackforge 0.2.0__py3-none-any.whl → 0.2.2__py3-none-any.whl

pyattackforge-0.2.2.dist-info/RECORD

@@ -0,0 +1,21 @@
+pyattackforge/__init__.py,sha256=ebRH36uyrbMl6C4H9JejeW0cA6S9xTTzScyD69I0Jso,97
+pyattackforge/cache.py,sha256=zTGWzL4F6n4u6opCNCi0CYkkSWPx5ShZMVmDagMpPQ0,933
+pyattackforge/client.py,sha256=C_nCWuQByRr3GwZVIVUjdsrNA5j-Gv0ttkqig1GkwFg,5664
+pyattackforge/config.py,sha256=d71w7hlV34uIWI_YeyrWE77eEpMPBEL3GuA8Jq6gRTo,2240
+pyattackforge/exceptions.py,sha256=YFzV7VQ3UkOGXKpHhXctuM7fZUtR4LgYuPR_po4pksA,592
+pyattackforge/transport.py,sha256=slYM9zqleyWlTiUpZZfF0CVB95I0u8UMkqsK09Qa9W4,6500
+pyattackforge/resources/__init__.py,sha256=Tim25zMXM8FoprSyh_r2PJQjouWUq4FxfqMvNT6RI_g,646
+pyattackforge/resources/assets.py,sha256=cVe4PrLp3Afxv52SBekQZaiDvQpV7zCKN6bLkUHl-uA,1420
+pyattackforge/resources/base.py,sha256=x5C8SG2MfwCtOkcRi8plDTF6TkJqXz-b58KS4qkP0Zw,1286
+pyattackforge/resources/findings.py,sha256=krl-IODoUFQ1pfsx4SkTCuKICdSsp1Zc1MWwrF2iYRM,34147
+pyattackforge/resources/groups.py,sha256=vnQjY_RCsgLuE2igqtDLd9d-hvISiYR7uszcN8QqS6w,618
+pyattackforge/resources/notes.py,sha256=r-TR3QuatrhGzwmoR7AQt7wiHXTrvmMvm7rYtkBCOkQ,5741
+pyattackforge/resources/projects.py,sha256=1QP-rs53LVqSWXpVglsQdk19qWgqcNrdTp7ezpyTRVs,8893
+pyattackforge/resources/reports.py,sha256=43wDK8SB2qqz-tjerjFBOV4G9EcgLk5WL3O8H-On5b0,805
+pyattackforge/resources/users.py,sha256=8SF_3QdNQalsyU-60V_oJtsJbo6nHkI3WPbCBebEkrk,2275
+pyattackforge/resources/writeups.py,sha256=iBShGQFrwYie3Gx8F0ekSOW0rf_ZzziRDsRpdQYUsSg,3001
+pyattackforge-0.2.2.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
+pyattackforge-0.2.2.dist-info/METADATA,sha256=mFEmP0KNy-Au5eZETE1TbvwniRcVPH7J2a-YcF62ZHU,46131
+pyattackforge-0.2.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+pyattackforge-0.2.2.dist-info/top_level.txt,sha256=1rDeMkWvFWuX3MS8V65no7KuybYyvtfIgbYSt5m_uPU,14
+pyattackforge-0.2.2.dist-info/RECORD,,

pyattackforge-0.2.0.dist-info/METADATA

@@ -1,178 +0,0 @@
-Metadata-Version: 2.4
-Name: pyattackforge
-Version: 0.2.0
-Summary: Python SDK for the AttackForge SSAPI
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: httpx>=0.27
-Requires-Dist: h2>=4.1.0
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0; extra == "dev"
-Requires-Dist: python-dotenv>=1.0; extra == "dev"
-Dynamic: license-file
-
-# PyAttackForge
-
-Next-generation Python SDK for the AttackForge SSAPI (Python 3.10+).
-
-## AI Documentation
-
-`DOCUMENTATION.md` is written for AI coding assistants (Codex/Claude) to implement or extend the library.
-
-## Install (local)
-
-```bash
-pip install -e .
-```
-
-## Install (PyPI)
-
-```bash
-pip install pyattackforge
-```
-
-## Build
-
-```bash
-python -m build --sdist --wheel
-```
-
-## Configuration
-
-Environment variables:
-- `ATTACKFORGE_BASE_URL`
-- `ATTACKFORGE_API_KEY`
-- `ATTACKFORGE_TEST_PROJECT_ID` (only needed for live integration tests)
-- `ATTACKFORGE_FINDINGS_VISIBLE_DEFAULT` (optional, set to `true` to make new findings visible; default is pending/hidden)
-- `ATTACKFORGE_FINDINGS_SUBSTATUS_KEY` (optional, default `substatus`)
-- `ATTACKFORGE_FINDINGS_SUBSTATUS_VALUE` (optional, default `Observed`)
-- `ATTACKFORGE_UI_BASE_URL` (optional, UI base URL for project testcase uploads/verification)
-- `ATTACKFORGE_UI_TOKEN` (optional, UI authorization token for project testcase uploads/verification)
-
-Example `.env`:
-
-```env
-ATTACKFORGE_BASE_URL=https://demo.attackforge.com
-ATTACKFORGE_API_KEY=replace-me
-ATTACKFORGE_TEST_PROJECT_ID=replace-me
-ATTACKFORGE_FINDINGS_VISIBLE_DEFAULT=false
-ATTACKFORGE_FINDINGS_SUBSTATUS_KEY=substatus
-ATTACKFORGE_FINDINGS_SUBSTATUS_VALUE=Observed
-ATTACKFORGE_UI_BASE_URL=https://demo.attackforge.com
-ATTACKFORGE_UI_TOKEN=replace-me
-```
-
-## Usage (sync)
-
-```python
-from pyattackforge import AttackForgeClient
-
-with AttackForgeClient() as client:
-    projects = client.projects.get_projects()
-    print(projects)
-```
-
-Touch a testcase (updates `last_tested` and `testcase_type` in `project_testcase_custom_fields`):
-
-```python
-from pyattackforge import AttackForgeClient
-
-with AttackForgeClient() as client:
-    client.testcases.touch_testcase("project_id", "testcase_id")
-```
-
-By default, the SDK merges `last_tested` and `testcase_type` into existing project testcase custom fields. Use `overwrite=True` to replace the list.
-Default format for `last_tested` is `YYYY-MM-DD` (date picker friendly). Override by supplying `timestamp=`.
-Default `testcase_type` is `Security Test Case`. Override by supplying `testcase_type=`.
-
-Create a testcase note with optional deduplication (case-insensitive, trimmed):
-
-```python
-from pyattackforge import AttackForgeClient
-
-with AttackForgeClient() as client:
-    payload = {"note": "Observed weak password policy", "note_type": "PLAINTEXT"}
-    client.testcases.create_testcase_note("project_id", "testcase_id", payload, dedupe=True)
-```
-
-When `dedupe=True`, the SDK compares against notes returned by the project testcase listing. If notes are not included in that response, the check is best-effort and the note will be created.
-If a UI token is configured (`ATTACKFORGE_UI_TOKEN`), the SDK will also check the UI notes endpoint to avoid duplicates.
-
-Upload vulnerability evidence with FIFO retention and dedupe:
-
-```python
-from pyattackforge import AttackForgeClient
-
-with AttackForgeClient() as client:
-    client.findings.upload_vulnerability_evidence("vuln_id", "evidence.png")
-    # keep_last defaults to 2 (FIFO, keep most recent). Set keep_last=None to disable.
-    client.findings.upload_vulnerability_evidence("vuln_id", "evidence.png", dedupe=True)
-```
-
-For more reliable FIFO/dedupe, pass `project_id` so the SDK can use the project vulnerability listing (which contains evidence metadata):
-
-```python
-client.findings.upload_vulnerability_evidence("vuln_id", "evidence.png", project_id="project_id")
-```
-
-Upload project testcase evidence with FIFO retention and dedupe:
-
-```python
-from pyattackforge import AttackForgeClient
-
-with AttackForgeClient() as client:
-    client.testcases.upload_testcase_file("project_id", "testcase_id", "evidence.png")
-    # keep_last defaults to 2 (FIFO, keep most recent). Set keep_last=None to disable.
-    client.testcases.upload_testcase_file("project_id", "testcase_id", "evidence.png", dedupe=True)
-```
-
-When a UI token is configured, FIFO cleanup for testcase evidence uses the UI delete endpoint:
-`/api/projects/:projectId/meta/:fileId/delete` (UI expects GET/POST semantics).
-
-Helper methods (examples):
-
-```python
-with AttackForgeClient() as client:
-    project = client.projects.find_project_by_name("Tantalum Labs Fake Pentest")
-    suite = client.testsuites.find_testsuite_by_name("OWASP Web App Penetration Test")
-    if suite:
-        testcases = client.testsuites.get_testsuite_testcases(suite["id"])
-    client.link_vulnerability_to_testcases("project_id", "vuln_id", ["testcase_id"])
-```
-
-## Testing
-
-Unit tests:
-
-```bash
-python3 -m pytest
-```
-
-Integration tests (require env vars):
-
-```bash
-python3 -m pytest -m integration
-```
-
-Integration tests create and modify data in the target tenant and will attempt cleanup. They read `ATTACKFORGE_BASE_URL`, `ATTACKFORGE_API_KEY`, and `ATTACKFORGE_TEST_PROJECT_ID`.
-
-## Status
-
-This is a from-scratch rewrite. See `COVERAGE.md` for endpoint coverage and assumptions.
-
-## Scripts
-
-Import writeups from a JSON export:
-
-```bash
-python3 scripts/import_writeups.py --input writeups.json
-```
-
-By default the script will ensure custom libraries exist. If the SSAPI returns an error for a custom library key, it will create a small bootstrap writeup in that library. Use `--no-ensure-library` to skip.
-
-Add missing writeup custom fields (Settings -> Writeups) based on the import file:
-
-```bash
-python3 scripts/import_writeups.py --input writeups.json --ensure-writeup-fields
-```

pyattackforge-0.2.0.dist-info/RECORD

@@ -1,20 +0,0 @@
-pyattackforge/__init__.py,sha256=ebRH36uyrbMl6C4H9JejeW0cA6S9xTTzScyD69I0Jso,97
-pyattackforge/cache.py,sha256=zTGWzL4F6n4u6opCNCi0CYkkSWPx5ShZMVmDagMpPQ0,933
-pyattackforge/client.py,sha256=E99KuD71q_geRiwMLdcJMUi_hdRJJUu8lPyC6Q-hVAk,5590
-pyattackforge/config.py,sha256=U7kkUIDdC-ES8BC4jI-gM3dOyVNvvtRD644xPQKhOkQ,2240
-pyattackforge/exceptions.py,sha256=YFzV7VQ3UkOGXKpHhXctuM7fZUtR4LgYuPR_po4pksA,592
-pyattackforge/transport.py,sha256=5vUc4PASo_8PBdXPw54n7eAG0NiFTFDtmI5Zbn4SpmQ,4535
-pyattackforge/resources/__init__.py,sha256=n0C-HZDqBHKfxM7utqKXkGtDES3i-7OzEHcRyUstXHY,589
-pyattackforge/resources/assets.py,sha256=cVe4PrLp3Afxv52SBekQZaiDvQpV7zCKN6bLkUHl-uA,1420
-pyattackforge/resources/base.py,sha256=x5C8SG2MfwCtOkcRi8plDTF6TkJqXz-b58KS4qkP0Zw,1286
-pyattackforge/resources/findings.py,sha256=w1S8Ex-rFLcaVa7mE3MkexmgBW3Z09RilM-KFgG6hSI,27945
-pyattackforge/resources/notes.py,sha256=r-TR3QuatrhGzwmoR7AQt7wiHXTrvmMvm7rYtkBCOkQ,5741
-pyattackforge/resources/projects.py,sha256=6pDvOp7s81KvzNgONo04rqWzVXGggbdPXvOnEnBEz9A,7262
-pyattackforge/resources/reports.py,sha256=43wDK8SB2qqz-tjerjFBOV4G9EcgLk5WL3O8H-On5b0,805
-pyattackforge/resources/users.py,sha256=8SF_3QdNQalsyU-60V_oJtsJbo6nHkI3WPbCBebEkrk,2275
-pyattackforge/resources/writeups.py,sha256=iBShGQFrwYie3Gx8F0ekSOW0rf_ZzziRDsRpdQYUsSg,3001
-pyattackforge-0.2.0.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
-pyattackforge-0.2.0.dist-info/METADATA,sha256=-U3I0OQrPuONAZvP1mLbGSWadBGPQ6I0RMvbhGggG0A,5827
-pyattackforge-0.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-pyattackforge-0.2.0.dist-info/top_level.txt,sha256=1rDeMkWvFWuX3MS8V65no7KuybYyvtfIgbYSt5m_uPU,14
-pyattackforge-0.2.0.dist-info/RECORD,,