certgraph 0.2.0__tar.gz → 0.4.0__tar.gz

certgraph-0.4.0/PKG-INFO

@@ -0,0 +1,169 @@
+Metadata-Version: 2.4
+Name: certgraph
+Version: 0.4.0
+Summary: Utility for exploring and mapping X509 certificate chains.
+Author: Chris Adshead
+License: MIT License
+        
+        Copyright (c) 2026 Chris Adshead
+        
+        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.
+        
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography
+Requires-Dist: networkx
+Requires-Dist: pydot
+Requires-Dist: rapidfuzz
+Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Dynamic: license-file
+
+# certgraph
+
+[![PyPI version](https://img.shields.io/pypi/v/certgraph)](https://pypi.org/project/certgraph/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Python package for creating, exploring and displaying directed graphs of X.509 certificates.
+
+Build a directed graph by importing PEM/DER/`x509.Certificate` objects using subject/issuer relationships. Explore the
+generated digraph with the built in functions and then export the graph rendered in the DOT language.
+
+Basic example graph generated to DOT source with `certgraph.export_dot()` and then rendered to SVG with `dot` command line tool:
+
+![Basic example certificate graph](readme_basic_example.svg)
+
+## Features
+
+* Import certificates from:
+  * PEM strings (individually or whole PKIs)
+  * DER bytes
+  * `cryptography.x509.Certificate` objects
+* Dynamically built directed graphs from imported certificates
+* Imported certificates fuzzy-searchable based on distinguised name
+* Issuer and child certificates walkable to follow chains
+* Identify certificates not valid at a given time
+* Export DOT language graphs, with:
+  * RFC4514 distinguised names
+  * Valid time range
+  * Node highlighting for invalid certificates
+
+**Note on _fingerprints_**: This code relies extensively on certificate _fingerprints_. This is a SHA256 hash of the public bytes in the certificate. Nodes in the graph are stored with the fingerprint as their key and are indexed using the fingerprint value. While this initially seems awkward, it prevents malformed (or maliciously designed) distinguished names or serial numbers from clashing with other imported certificates. You can use `certgraph.fingerprint_from_distinguished_name()` to map from distinguised names to fingerprints for ease of use.
+
+## Installation
+
+### PyPI
+
+Install the latest version of the package from PyPI via `pip` with:
+
+```bash
+pip install certgraph
+```
+
+For development dependencies, install with:
+
+```bash
+pip install certgraph[dev]
+```
+
+### Optional
+
+* `dot` command line tool
+  * Used to render generated DOT language graphs into PNG/SVG/etc.
+  * E.g. `dot -Tsvg <generated_file>.dot -o graph.svg`
+  * Alternatively can use online tools.
+
+## Basic Examples
+
+Import the `certgraph` class from the module:
+
+```python
+>>> from certgraph import certgraph as cg
+```
+
+Load some varied data for later examples:
+
+```python
+>>> with open("path/to/cert.pem") as f:
+>>>   pem_data = f.read() # 1 cert
+>>> with open("path/to/pki.pem") as f:
+>>>   pki_data = f.read() # 3 certs in 1 PEM file
+>>> with open("path/to/cert.der", "rb") as f:
+>>>   der_data = f.read() # 1 cert
+```
+
+Import a PEM file with 1 certificate in it:
+
+```python
+>>> graph = cg().import_certificates(pem_data)
+>>> len(graph)
+1
+```
+
+Import mixed PEM/DER dataset, including PEMs with PKIs, using function chaining:
+
+```python
+>>> graph = (
+>>>   cg()
+>>>     .import_certificates(pem_data)
+>>>     .import_certificates(pki_data)
+>>>     .import_certificates(der_data)
+>>> )
+>>> len(graph)
+5
+```
+
+Get an imported certificate (as `cryptography.x509.Certificate`) by using a fingerprint. The fingerprint of the desired certificate can be retrieved using a fuzzy-searching function based on the distinguised name:
+
+```python
+>>> dn = "CN=f3ec133b-4"
+>>> fingerprint = cg.fingerprint_from_distinguished_name(dn) # Fuzzy-search the distinguised name in the list of imported certificates for the best match
+>>> print(fingerprint)
+"77c4b5b12b79887b8c709df826cff89a7268071593de5cc84053b8c00302b2fb"
+>>> cert = cg.get_certificate(fingerprint) # Get the certificate associated with the fingerprint
+>>> print(cert.subject.rfc4514_string())
+"CN=f3ec133b-4"
+```
+
+Get predecessor (issuer) and successor (child) fingerprints from a certificate fingerprint:
+
+```python
+>>> fingerprint = "77c4b5b12b79887b8c709df826cff89a7268071593de5cc84053b8c00302b2fb"
+>>> cg.get_issuer_fingerprint(fingerprint)
+"965e8d87f96ccf564726ff5e97ea4d6b18731d9b762ef9510479f628bc85837e"
+>>> cg.get_child_certificates(fingerprint)
+["3cf372288714b52298222bb1f8cf51dce3f1e60147ec53f9ee3dc28e8766c734", "2caf1b256bcbb327aea8d1442ba12e0fc6582b3c2980ee9f31d4ae3a62f62673"]
+```
+
+Export graph to DOT language and write to a file, where it can be rendered with the `dot` command line tool.
+
+```python
+>>> with open("path/to/output.dot", "w") as f:
+>>>   dot_str = cg.export_dot()
+>>>   f.write(dot_str)
+```
+
+See more complex examples in the `examples` directory of the repository (**WIP**).
+
+## Documentation
+
+**WIP**

certgraph-0.4.0/README.md

@@ -0,0 +1,129 @@
+# certgraph
+
+[![PyPI version](https://img.shields.io/pypi/v/certgraph)](https://pypi.org/project/certgraph/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Python package for creating, exploring and displaying directed graphs of X.509 certificates.
+
+Build a directed graph by importing PEM/DER/`x509.Certificate` objects using subject/issuer relationships. Explore the
+generated digraph with the built in functions and then export the graph rendered in the DOT language.
+
+Basic example graph generated to DOT source with `certgraph.export_dot()` and then rendered to SVG with `dot` command line tool:
+
+![Basic example certificate graph](readme_basic_example.svg)
+
+## Features
+
+* Import certificates from:
+  * PEM strings (individually or whole PKIs)
+  * DER bytes
+  * `cryptography.x509.Certificate` objects
+* Dynamically built directed graphs from imported certificates
+* Imported certificates fuzzy-searchable based on distinguised name
+* Issuer and child certificates walkable to follow chains
+* Identify certificates not valid at a given time
+* Export DOT language graphs, with:
+  * RFC4514 distinguised names
+  * Valid time range
+  * Node highlighting for invalid certificates
+
+**Note on _fingerprints_**: This code relies extensively on certificate _fingerprints_. This is a SHA256 hash of the public bytes in the certificate. Nodes in the graph are stored with the fingerprint as their key and are indexed using the fingerprint value. While this initially seems awkward, it prevents malformed (or maliciously designed) distinguished names or serial numbers from clashing with other imported certificates. You can use `certgraph.fingerprint_from_distinguished_name()` to map from distinguised names to fingerprints for ease of use.
+
+## Installation
+
+### PyPI
+
+Install the latest version of the package from PyPI via `pip` with:
+
+```bash
+pip install certgraph
+```
+
+For development dependencies, install with:
+
+```bash
+pip install certgraph[dev]
+```
+
+### Optional
+
+* `dot` command line tool
+  * Used to render generated DOT language graphs into PNG/SVG/etc.
+  * E.g. `dot -Tsvg <generated_file>.dot -o graph.svg`
+  * Alternatively can use online tools.
+
+## Basic Examples
+
+Import the `certgraph` class from the module:
+
+```python
+>>> from certgraph import certgraph as cg
+```
+
+Load some varied data for later examples:
+
+```python
+>>> with open("path/to/cert.pem") as f:
+>>>   pem_data = f.read() # 1 cert
+>>> with open("path/to/pki.pem") as f:
+>>>   pki_data = f.read() # 3 certs in 1 PEM file
+>>> with open("path/to/cert.der", "rb") as f:
+>>>   der_data = f.read() # 1 cert
+```
+
+Import a PEM file with 1 certificate in it:
+
+```python
+>>> graph = cg().import_certificates(pem_data)
+>>> len(graph)
+1
+```
+
+Import mixed PEM/DER dataset, including PEMs with PKIs, using function chaining:
+
+```python
+>>> graph = (
+>>>   cg()
+>>>     .import_certificates(pem_data)
+>>>     .import_certificates(pki_data)
+>>>     .import_certificates(der_data)
+>>> )
+>>> len(graph)
+5
+```
+
+Get an imported certificate (as `cryptography.x509.Certificate`) by using a fingerprint. The fingerprint of the desired certificate can be retrieved using a fuzzy-searching function based on the distinguised name:
+
+```python
+>>> dn = "CN=f3ec133b-4"
+>>> fingerprint = cg.fingerprint_from_distinguished_name(dn) # Fuzzy-search the distinguised name in the list of imported certificates for the best match
+>>> print(fingerprint)
+"77c4b5b12b79887b8c709df826cff89a7268071593de5cc84053b8c00302b2fb"
+>>> cert = cg.get_certificate(fingerprint) # Get the certificate associated with the fingerprint
+>>> print(cert.subject.rfc4514_string())
+"CN=f3ec133b-4"
+```
+
+Get predecessor (issuer) and successor (child) fingerprints from a certificate fingerprint:
+
+```python
+>>> fingerprint = "77c4b5b12b79887b8c709df826cff89a7268071593de5cc84053b8c00302b2fb"
+>>> cg.get_issuer_fingerprint(fingerprint)
+"965e8d87f96ccf564726ff5e97ea4d6b18731d9b762ef9510479f628bc85837e"
+>>> cg.get_child_certificates(fingerprint)
+["3cf372288714b52298222bb1f8cf51dce3f1e60147ec53f9ee3dc28e8766c734", "2caf1b256bcbb327aea8d1442ba12e0fc6582b3c2980ee9f31d4ae3a62f62673"]
+```
+
+Export graph to DOT language and write to a file, where it can be rendered with the `dot` command line tool.
+
+```python
+>>> with open("path/to/output.dot", "w") as f:
+>>>   dot_str = cg.export_dot()
+>>>   f.write(dot_str)
+```
+
+See more complex examples in the `examples` directory of the repository (**WIP**).
+
+## Documentation
+
+**WIP**

{certgraph-0.2.0 → certgraph-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "certgraph"
-version = "0.2.0"
+version = "0.4.0"
 description = "Utility for exploring and mapping X509 certificate chains."
 readme = "README.md"
 requires-python = ">=3.12"

{certgraph-0.2.0 → certgraph-0.4.0}/src/certgraph/certgraph.py

@@ -1,17 +1,22 @@
 from cryptography import x509
 from cryptography.hazmat.primitives import hashes
+from datetime import datetime, timezone
 import networkx as nx
 from rapidfuzz import fuzz
 
 
 class certgraph:
-    """Class for creating and exploring directed graphs of X509 certificates."""
+    """Class for creating and exploring directed graphs of X.509 certificates."""
 
     def __init__(self) -> None:
         """Initialise an empty certgraph object."""
         self._certlist: set[x509.Certificate] = []
         self._graph = nx.DiGraph()
 
+    def __len__(self) -> int:
+        """Get number of certificates imported."""
+        return len(self._certlist)
+
     def import_certificates(
         self,
         certificates: (
@@ -88,25 +93,39 @@ class certgraph:
         """
         return [f"{edge[0][:8]} -> {edge[1][:8]}" for edge in self._graph.edges()]
 
-    def export_dot(self, format: str = "svg") -> str:
-        """Function to export the current certificate digraph in the dot language. NOTE: Still in progress."""
-        allowed_types = ["svg", "png"]
-
-        if format not in allowed_types:
-            raise ValueError(
-                f"Cannot export dot graph of type {format} - must be one of {allowed_types}"
-            )
+    def export_dot(self) -> str:
+        """
+        Export the current certificate digraph in the dot language.
 
+        Returns:
+            The certificate digraph rendered as a dot language string.
+        """
         dot_graph = nx.DiGraph()
 
         for fingerprint, data in self._graph.nodes(data=True):
-            label = data["certificate"].subject.rfc4514_string()
-            dot_graph.add_node(fingerprint, label=label)
-        dot_graph.add_edges_from(self._graph.edges())
+            cert: x509.Certificate = data["certificate"]
+            validity_time_str = f"{cert.not_valid_before_utc.isoformat()} → {cert.not_valid_after_utc.isoformat()}"
+            invalid = self.certificate_invalid_at(fingerprint)
 
-        nx.drawing.nx_pydot.write_dot(dot_graph, "./test_out.dot")
+            label = f"DN: {cert.subject.rfc4514_string()}"
+            label += f"\nValid: {validity_time_str}"
 
-        return "dot"
+            if invalid:
+                node_color = "tomato"
+            else:
+                node_color = "white"
+
+            dot_graph.add_node(
+                fingerprint,
+                label=label,
+                shape="box",
+                style="filled",
+                fillcolor=node_color,
+            )
+
+        dot_graph.add_edges_from(self._graph.edges())
+
+        return nx.drawing.nx_pydot.to_pydot(dot_graph).to_string()
 
     def clear(self) -> certgraph:
         """
@@ -170,7 +189,7 @@ class certgraph:
 
         Args:
             fingerprint: Fingerprint of the certificate to get the issuer of.
-        
+
         Returns:
             The fingerprint of the issuing certificate or None if not present in the digraph.
 
@@ -178,7 +197,9 @@ class certgraph:
             ValueError: If certificate with the supplied fingerprint isn't in the digraph.
         """
         if fingerprint not in self._graph.nodes:
-            raise ValueError(f"Fingerprint supplied doesn't match any imported certificate.")
+            raise ValueError(
+                f"Fingerprint supplied doesn't match any imported certificate."
+            )
 
         return next(self._graph.predecessors(fingerprint), None)
 
@@ -188,7 +209,7 @@ class certgraph:
 
         Args:
             fingerprint: Fingerprint of the certificate to get the child certificates of.
-        
+
         Returns:
             The list of fingerprints belonging to child certificates.
 
@@ -196,7 +217,9 @@ class certgraph:
             ValueError: If certificate with the supplied fingerprint isn't in the digraph.
         """
         if fingerprint not in self._graph.nodes:
-            raise ValueError(f"Fingerprint supplied doesn't match any imported certificate.")
+            raise ValueError(
+                f"Fingerprint supplied doesn't match any imported certificate."
+            )
 
         return list(self._graph.successors(fingerprint))
 
@@ -215,3 +238,26 @@ class certgraph:
             if cert in self._certlist:
                 self._certlist.remove(cert)
 
+    def certificate_invalid_at(
+        self, fingerprint: str, at_time: datetime = datetime.now(timezone.utc)
+    ) -> bool:
+        """
+        Check if an imported certificate is outside its validity period - either not yet valid or expired.
+
+        Args:
+            fingerprint: Fingerprint of the certificate to check.
+            at_time: When the certificate validity will be checked against. Defaults to now (UTC).
+
+        Returns:
+            True if the certificate is not yet valid or expired at the given time, otherwise false.
+
+        Raises:
+            ValueError: If certificate with the supplied fingerprint isn't in the digraph.
+        """
+        if fingerprint not in self._graph.nodes:
+            raise ValueError(
+                f"Fingerprint supplied doesn't match any imported certificate."
+            )
+
+        cert = self.get_certificate(fingerprint)
+        return at_time < cert.not_valid_before_utc or at_time > cert.not_valid_after_utc

certgraph-0.4.0/src/certgraph.egg-info/PKG-INFO

@@ -0,0 +1,169 @@
+Metadata-Version: 2.4
+Name: certgraph
+Version: 0.4.0
+Summary: Utility for exploring and mapping X509 certificate chains.
+Author: Chris Adshead
+License: MIT License
+        
+        Copyright (c) 2026 Chris Adshead
+        
+        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.
+        
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography
+Requires-Dist: networkx
+Requires-Dist: pydot
+Requires-Dist: rapidfuzz
+Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Dynamic: license-file
+
+# certgraph
+
+[![PyPI version](https://img.shields.io/pypi/v/certgraph)](https://pypi.org/project/certgraph/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Python package for creating, exploring and displaying directed graphs of X.509 certificates.
+
+Build a directed graph by importing PEM/DER/`x509.Certificate` objects using subject/issuer relationships. Explore the
+generated digraph with the built in functions and then export the graph rendered in the DOT language.
+
+Basic example graph generated to DOT source with `certgraph.export_dot()` and then rendered to SVG with `dot` command line tool:
+
+![Basic example certificate graph](readme_basic_example.svg)
+
+## Features
+
+* Import certificates from:
+  * PEM strings (individually or whole PKIs)
+  * DER bytes
+  * `cryptography.x509.Certificate` objects
+* Dynamically built directed graphs from imported certificates
+* Imported certificates fuzzy-searchable based on distinguised name
+* Issuer and child certificates walkable to follow chains
+* Identify certificates not valid at a given time
+* Export DOT language graphs, with:
+  * RFC4514 distinguised names
+  * Valid time range
+  * Node highlighting for invalid certificates
+
+**Note on _fingerprints_**: This code relies extensively on certificate _fingerprints_. This is a SHA256 hash of the public bytes in the certificate. Nodes in the graph are stored with the fingerprint as their key and are indexed using the fingerprint value. While this initially seems awkward, it prevents malformed (or maliciously designed) distinguished names or serial numbers from clashing with other imported certificates. You can use `certgraph.fingerprint_from_distinguished_name()` to map from distinguised names to fingerprints for ease of use.
+
+## Installation
+
+### PyPI
+
+Install the latest version of the package from PyPI via `pip` with:
+
+```bash
+pip install certgraph
+```
+
+For development dependencies, install with:
+
+```bash
+pip install certgraph[dev]
+```
+
+### Optional
+
+* `dot` command line tool
+  * Used to render generated DOT language graphs into PNG/SVG/etc.
+  * E.g. `dot -Tsvg <generated_file>.dot -o graph.svg`
+  * Alternatively can use online tools.
+
+## Basic Examples
+
+Import the `certgraph` class from the module:
+
+```python
+>>> from certgraph import certgraph as cg
+```
+
+Load some varied data for later examples:
+
+```python
+>>> with open("path/to/cert.pem") as f:
+>>>   pem_data = f.read() # 1 cert
+>>> with open("path/to/pki.pem") as f:
+>>>   pki_data = f.read() # 3 certs in 1 PEM file
+>>> with open("path/to/cert.der", "rb") as f:
+>>>   der_data = f.read() # 1 cert
+```
+
+Import a PEM file with 1 certificate in it:
+
+```python
+>>> graph = cg().import_certificates(pem_data)
+>>> len(graph)
+1
+```
+
+Import mixed PEM/DER dataset, including PEMs with PKIs, using function chaining:
+
+```python
+>>> graph = (
+>>>   cg()
+>>>     .import_certificates(pem_data)
+>>>     .import_certificates(pki_data)
+>>>     .import_certificates(der_data)
+>>> )
+>>> len(graph)
+5
+```
+
+Get an imported certificate (as `cryptography.x509.Certificate`) by using a fingerprint. The fingerprint of the desired certificate can be retrieved using a fuzzy-searching function based on the distinguised name:
+
+```python
+>>> dn = "CN=f3ec133b-4"
+>>> fingerprint = cg.fingerprint_from_distinguished_name(dn) # Fuzzy-search the distinguised name in the list of imported certificates for the best match
+>>> print(fingerprint)
+"77c4b5b12b79887b8c709df826cff89a7268071593de5cc84053b8c00302b2fb"
+>>> cert = cg.get_certificate(fingerprint) # Get the certificate associated with the fingerprint
+>>> print(cert.subject.rfc4514_string())
+"CN=f3ec133b-4"
+```
+
+Get predecessor (issuer) and successor (child) fingerprints from a certificate fingerprint:
+
+```python
+>>> fingerprint = "77c4b5b12b79887b8c709df826cff89a7268071593de5cc84053b8c00302b2fb"
+>>> cg.get_issuer_fingerprint(fingerprint)
+"965e8d87f96ccf564726ff5e97ea4d6b18731d9b762ef9510479f628bc85837e"
+>>> cg.get_child_certificates(fingerprint)
+["3cf372288714b52298222bb1f8cf51dce3f1e60147ec53f9ee3dc28e8766c734", "2caf1b256bcbb327aea8d1442ba12e0fc6582b3c2980ee9f31d4ae3a62f62673"]
+```
+
+Export graph to DOT language and write to a file, where it can be rendered with the `dot` command line tool.
+
+```python
+>>> with open("path/to/output.dot", "w") as f:
+>>>   dot_str = cg.export_dot()
+>>>   f.write(dot_str)
+```
+
+See more complex examples in the `examples` directory of the repository (**WIP**).
+
+## Documentation
+
+**WIP**

{certgraph-0.2.0 → certgraph-0.4.0}/src/certgraph.egg-info/SOURCES.txt

@@ -8,6 +8,7 @@ src/certgraph.egg-info/SOURCES.txt
 src/certgraph.egg-info/dependency_links.txt
 src/certgraph.egg-info/requires.txt
 src/certgraph.egg-info/top_level.txt
+tests/test_certificate_invalid_at.py
 tests/test_clear.py
 tests/test_export_dot.py
 tests/test_fingerprint_search.py

certgraph-0.4.0/tests/test_certificate_invalid_at.py

@@ -0,0 +1,39 @@
+from datetime import timedelta
+
+import pytest
+from cryptography.hazmat.primitives import hashes
+
+
+def test_raises_for_unknown_fingerprint(graph):
+    with pytest.raises(ValueError):
+        graph.certificate_invalid_at("does-not-exist")
+
+
+def test_certificate_within_validity_period_is_valid(graph, self_signed_cert):
+    graph.import_certificates(self_signed_cert)
+    fingerprint = self_signed_cert.fingerprint(hashes.SHA256()).hex()
+
+    assert graph.certificate_invalid_at(fingerprint) is False
+
+
+def test_expired_certificate_is_invalid(graph, expired_cert):
+    graph.import_certificates(expired_cert)
+    fingerprint = expired_cert.fingerprint(hashes.SHA256()).hex()
+
+    assert graph.certificate_invalid_at(fingerprint) is True
+
+
+def test_not_yet_valid_certificate_is_invalid(graph, self_signed_cert):
+    graph.import_certificates(self_signed_cert)
+    fingerprint = self_signed_cert.fingerprint(hashes.SHA256()).hex()
+    before_validity = self_signed_cert.not_valid_before_utc - timedelta(days=1)
+
+    assert graph.certificate_invalid_at(fingerprint, at_time=before_validity) is True
+
+
+def test_at_time_controls_validity_check(graph, self_signed_cert):
+    graph.import_certificates(self_signed_cert)
+    fingerprint = self_signed_cert.fingerprint(hashes.SHA256()).hex()
+    after_validity = self_signed_cert.not_valid_after_utc + timedelta(days=1)
+
+    assert graph.certificate_invalid_at(fingerprint, at_time=after_validity) is True

certgraph-0.4.0/tests/test_export_dot.py

@@ -0,0 +1,71 @@
+def test_export_dot_returns_string(graph):
+    assert isinstance(graph.export_dot(), str)
+
+
+def test_export_dot_empty_graph_has_no_edges(graph):
+    dot = graph.export_dot()
+    assert "digraph" in dot
+    assert "->" not in dot
+
+
+def test_export_dot_includes_node_labels(graph, self_signed_cert):
+    graph.import_certificates(self_signed_cert)
+    dn = self_signed_cert.subject.rfc4514_string()
+
+    dot = graph.export_dot()
+
+    assert f"DN: {dn}" in dot
+
+
+def test_export_dot_includes_validity_period(graph, self_signed_cert):
+    graph.import_certificates(self_signed_cert)
+    not_before = self_signed_cert.not_valid_before_utc.isoformat()
+    not_after = self_signed_cert.not_valid_after_utc.isoformat()
+
+    dot = graph.export_dot()
+
+    # joined with an arrow character rather than '->', to avoid being confused with edge syntax
+    assert f"Valid: {not_before} → {not_after}" in dot
+
+
+def test_export_dot_node_shape_is_box(graph, self_signed_cert):
+    graph.import_certificates(self_signed_cert)
+
+    dot = graph.export_dot()
+
+    assert "shape=box" in dot
+
+
+def test_export_dot_highlights_expired_certificate(graph, expired_cert):
+    graph.import_certificates(expired_cert)
+
+    dot = graph.export_dot()
+
+    assert "fillcolor=tomato" in dot
+
+
+def test_export_dot_does_not_highlight_valid_certificate(graph, self_signed_cert):
+    graph.import_certificates(self_signed_cert)
+
+    dot = graph.export_dot()
+
+    assert "fillcolor=white" in dot
+    assert "tomato" not in dot
+
+
+def test_export_dot_includes_edges(graph, chain_certs):
+    graph.import_certificates(chain_certs)
+
+    dot = graph.export_dot()
+
+    # one self-loop for the root, plus one edge per subsequent certificate
+    assert dot.count("->") == len(chain_certs)
+
+
+def test_export_dot_does_not_write_file(graph, self_signed_cert, tmp_path, monkeypatch):
+    monkeypatch.chdir(tmp_path)
+    graph.import_certificates(self_signed_cert)
+
+    graph.export_dot()
+
+    assert not (tmp_path / "test_out.dot").exists()

certgraph-0.2.0/PKG-INFO

@@ -1,42 +0,0 @@
-Metadata-Version: 2.4
-Name: certgraph
-Version: 0.2.0
-Summary: Utility for exploring and mapping X509 certificate chains.
-Author: Chris Adshead
-License: MIT License
-        
-        Copyright (c) 2026 Chris Adshead
-        
-        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.
-        
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: cryptography
-Requires-Dist: networkx
-Requires-Dist: pydot
-Requires-Dist: rapidfuzz
-Provides-Extra: dev
-Requires-Dist: black; extra == "dev"
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: pytest-cov; extra == "dev"
-Dynamic: license-file
-
-# certgraph
-Python package for displaying X509 certificate chains.

certgraph-0.2.0/README.md

@@ -1,2 +0,0 @@
-# certgraph
-Python package for displaying X509 certificate chains.

certgraph-0.2.0/src/certgraph.egg-info/PKG-INFO

@@ -1,42 +0,0 @@
-Metadata-Version: 2.4
-Name: certgraph
-Version: 0.2.0
-Summary: Utility for exploring and mapping X509 certificate chains.
-Author: Chris Adshead
-License: MIT License
-        
-        Copyright (c) 2026 Chris Adshead
-        
-        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.
-        
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: cryptography
-Requires-Dist: networkx
-Requires-Dist: pydot
-Requires-Dist: rapidfuzz
-Provides-Extra: dev
-Requires-Dist: black; extra == "dev"
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: pytest-cov; extra == "dev"
-Dynamic: license-file
-
-# certgraph
-Python package for displaying X509 certificate chains.

certgraph-0.2.0/tests/test_export_dot.py

@@ -1,9 +0,0 @@
-import pytest
-
-# export_dot()'s actual output generation is still rough and not covered here.
-# Only the argument validation, which happens before anything is written, is tested.
-
-
-def test_export_dot_rejects_invalid_format(graph):
-    with pytest.raises(ValueError):
-        graph.export_dot(format="jpeg")