blackops-cli 0.1.5__py3-none-any.whl

blackops_cli/severity.py

@@ -0,0 +1,95 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# Copyright (c) 2026 CommonHuman-Lab
+"""Severity levels for scan findings — shared across all BlackOpsSQL tools.
+
+Usage::
+
+    from blackops_cli.severity import Severity, severity_colour, CRITICAL, HIGH
+
+    # In a finding dataclass:
+    severity: str = Severity.HIGH
+
+    # In output code:
+    colour_fn = severity_colour(finding.severity)
+    print(colour_fn(f"[{finding.severity}] {finding.url}"))
+"""
+
+from __future__ import annotations
+
+from typing import Callable
+
+from blackops_cli.colour import RED, YELLOW, CYAN, GREEN, DIM
+
+__all__ = [
+    "Severity",
+    "CRITICAL", "HIGH", "MEDIUM", "LOW", "INFO",
+    "severity_colour",
+    "severity_label",
+    "SEVERITY_ORDER",
+]
+
+
+class Severity:
+    """String constants for finding severity levels.
+
+    Designed as a simple namespace of constants rather than an Enum so that
+    finding dataclasses can use ``severity: str = Severity.HIGH`` without
+    importing an Enum type — keeping finding dataclasses dependency-light.
+    """
+    CRITICAL = "critical"
+    HIGH     = "high"
+    MEDIUM   = "medium"
+    LOW      = "low"
+    INFO     = "info"
+
+
+# Convenience aliases at module level
+CRITICAL = Severity.CRITICAL
+HIGH     = Severity.HIGH
+MEDIUM   = Severity.MEDIUM
+LOW      = Severity.LOW
+INFO     = Severity.INFO
+
+# Ordered from most to least severe (useful for sorting / filtering)
+SEVERITY_ORDER: list[str] = [CRITICAL, HIGH, MEDIUM, LOW, INFO]
+
+# Numeric scores for sorting / ranking
+_SEVERITY_SCORE: dict[str, int] = {
+    CRITICAL: 4,
+    HIGH:     3,
+    MEDIUM:   2,
+    LOW:      1,
+    INFO:     0,
+}
+
+
+def severity_colour(severity: str) -> Callable[[str], str]:
+    """Return the terminal colour function appropriate for *severity*.
+
+    Falls back to DIM for unknown values.
+
+    Example::
+
+        colour = severity_colour(Severity.HIGH)
+        print(colour("[HIGH] Reflected XSS confirmed"))
+    """
+    return {
+        CRITICAL: RED,
+        HIGH:     RED,
+        MEDIUM:   YELLOW,
+        LOW:      CYAN,
+        INFO:     DIM,
+    }.get(severity, DIM)
+
+
+def severity_label(severity: str) -> str:
+    """Return a fixed-width uppercase severity label for display.
+
+    Example: ``severity_label("high")`` → ``"HIGH    "``
+    """
+    return severity.upper().ljust(8)
+
+
+def severity_score(severity: str) -> int:
+    """Return a numeric score for sorting (higher = more severe)."""
+    return _SEVERITY_SCORE.get(severity, 0)

blackops_cli-0.1.5.dist-info/METADATA

@@ -0,0 +1,19 @@
+Metadata-Version: 2.4
+Name: blackops-cli
+Version: 0.1.5
+Summary: Shared CLI/terminal UX primitives for BlackOpsSQL tools
+Project-URL: Homepage, https://github.com/roc1t1z3not/BlackOpsSQL
+Author: roc1t1z3not
+License: AGPL-3.0-or-later
+License-File: LICENSE
+Keywords: ansi,cli,logging,pentest,security,terminal
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3
+Classifier: Operating System :: OS Independent
+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: Topic :: Security
+Requires-Python: >=3.10

blackops_cli-0.1.5.dist-info/RECORD

@@ -0,0 +1,14 @@
+blackops_cli/__init__.py,sha256=hMoXwLI5NwUS8nAFc3ZUNqyi9FXzxbHiTQbhlTG-UHE,2145
+blackops_cli/colour.py,sha256=SWELnfaViW_D5tIRYi-dF_r66nqk4TiOzqMvjxHMWik,814
+blackops_cli/entrypoint.py,sha256=dLYibBOsQ7cuZRcSC01f5RGWD8lcZ-2Evf-0HiNK2yI,2789
+blackops_cli/logging.py,sha256=NsA8lNR1VtqBItbOYIou77lOx4AtPoSAiDJuYqgOLP4,2681
+blackops_cli/output.py,sha256=636Wi08e-r2c4w2J20DSKiylrcHBBrTj8yrGiaBoxpc,6474
+blackops_cli/prompts.py,sha256=CglDNx_z2M3Hj3ULvk5qlyyDCZxVZBf859sSfh0mduM,1721
+blackops_cli/report_html.py,sha256=-5NJb9wWtz85A9X8qGq5BT0arwfFSAMZ71f9DXhRQL0,13554
+blackops_cli/report_sarif.py,sha256=ehxo7hVDaCIpPZFYSALgp0xOlDxhV9Qv3R5i4jABAW8,7540
+blackops_cli/reporter.py,sha256=MCXsFW9NzOQ3O6_8bt07lRPPH97rJ_fkLcEVxS_XiF0,3339
+blackops_cli/severity.py,sha256=53OKrfuOFZ-CWiBPe24QTpWtvC9DzmOA_nX8QbLbgtY,2449
+blackops_cli-0.1.5.dist-info/METADATA,sha256=isEhpGenVVaZgnJ5iyqCn4lant0H5bWpJPsZ6c9labs,781
+blackops_cli-0.1.5.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+blackops_cli-0.1.5.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
+blackops_cli-0.1.5.dist-info/RECORD,,

blackops_cli-0.1.5.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any