cyfer 0.1.1__tar.gz

cyfer-0.1.1/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026, Dylan Garrett
+
+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.
+

cyfer-0.1.1/PKG-INFO

@@ -0,0 +1,42 @@
+Metadata-Version: 2.4
+Name: cyfer
+Version: 0.1.1
+Summary: A package for doing great things!
+License: MIT
+License-File: LICENSE
+Author: Dylan Garrett
+Requires-Python: >=3.13,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: cryptography (>=49.0.0,<50.0.0)
+Requires-Dist: python-gnupg (>=0.5.6,<0.6.0)
+Description-Content-Type: text/markdown
+
+# cyfer
+
+A package for doing great things!
+
+## Installation
+
+```bash
+$ pip install cyfer
+```
+
+## Usage
+
+- TODO
+
+## Contributing
+
+Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.
+
+## License
+
+`cyfer` was created by Dylan Garrett. It is licensed under the terms of the MIT license.
+
+## Credits
+
+`cyfer` was created with [`cookiecutter`](https://cookiecutter.readthedocs.io/en/latest/) and the `py-pkgs-cookiecutter` [template](https://github.com/py-pkgs/py-pkgs-cookiecutter).
+

cyfer-0.1.1/README.md

@@ -0,0 +1,25 @@
+# cyfer
+
+A package for doing great things!
+
+## Installation
+
+```bash
+$ pip install cyfer
+```
+
+## Usage
+
+- TODO
+
+## Contributing
+
+Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.
+
+## License
+
+`cyfer` was created by Dylan Garrett. It is licensed under the terms of the MIT license.
+
+## Credits
+
+`cyfer` was created with [`cookiecutter`](https://cookiecutter.readthedocs.io/en/latest/) and the `py-pkgs-cookiecutter` [template](https://github.com/py-pkgs/py-pkgs-cookiecutter).

cyfer-0.1.1/cyfer/__init__.py

@@ -0,0 +1,3 @@
+# read version from installed package
+from importlib.metadata import version
+__version__ = version("cyfer")

cyfer-0.1.1/cyfer/core/gpg_context.py

@@ -0,0 +1,132 @@
+"""
+cyfer/core/gpg_context.py
+=========================
+GPG context setup and configuration.
+
+This is the foundation every other module imports from. It handles:
+    - Locating (or creating) a keyring directory
+    - Instantiating a python-gnupg GPG object with some defaults
+    - Verifying the gpg binary is reachable
+    - Exposing a ready-to-use GPG instance + a lightweight result inspector
+    
+"""
+from __future__ import annotations
+
+import os
+import sys
+from pathlib import Path
+
+import gnupg
+
+
+DEFAULT_GNUPGHOME = Path(__file__).parent / "test_keyring"
+
+GPG_BINARY = "gpg"
+
+
+def build_gpg(
+    gnupghome: Path | str | None = None,
+    binary: str = GPG_BINARY,
+    *,
+    verbose: bool = False,
+    use_agent: bool = False,
+    options: list[str] | None = None
+) -> gnupg.GPG:
+    """
+    Construct and return a configured gnupg.GPG instance.
+    
+    Parameters
+    ----------
+    gnupghome : path-like or None
+        Directory that will be used as GNUPGHOME. Created automatically if
+        it does not exist. Defaults to DEFAULT_GNUPGHOME.
+    binary : str
+        Name or full-path of the GPG binary.
+    verbose : bool
+        If True, python-gnupg will emit extra debug output.
+    use_agent : bool
+        Pass --use-agent to GPG. Usually False for scripted/non-interactive 
+        workflows; True when you want the GPG agent to cache passphrases.
+    options : list[str] or None
+        Extra command-line options forwarded verbatim to GPG.
+        
+    Returns
+    -------
+    gnupg.GPG
+        A ready-to-use GPG instance.
+        
+    Raises
+    ------
+    RuntimeError
+        If the GPG binary cannot be found or the keyring dir cannot be
+        created.
+        
+    """
+    home = Path(gnupghome) if gnupghome else DEFAULT_GNUPGHOME
+
+    try:
+        home.mkdir(mode=0o700, parents=True, exist_ok=True)
+    except OSError as exc:
+        raise RuntimeError(f"Cannot create GNUPGHOME at {home}: {exc}") from exc
+
+    try:
+        gpg = gnupg.GPG(
+            gnupghome=str(home),
+            gpgbinary=binary,
+            verbose=verbose,
+            use_agent=use_agent,
+            options=options or []
+        )
+    except ValueError as exc:
+        raise RuntimeError(
+            f"Failed to initialize GPG (binary='{binary}'): {exc}\n"
+            "Is GPG installed and on your PATH?"
+        ) from exc
+    return gpg
+
+
+def check_result(result, *, label: str = "operation") -> bool:
+    """
+    Inspect a python-gnupg result object and print a human-readable summary.
+    
+    python-gnupg result objects are not uniform - some expose '.ok', some
+    expose '.status', some expose '.returncode'. This helper normalizes the
+    differences so calling code doesn't have to.
+    
+    Returns True when the operation succeeded, False otherwise.
+    
+    """
+    ok_attr = getattr(result, "ok", None)
+    status = getattr(result, "status", "")
+    stderr = getattr(result, "stderr", "")
+    fingerprint = getattr(result, "fingerprint", None)
+    fingerprints = getattr(result, "fingerprints", None)
+
+    success = bool(ok_attr) if ok_attr is not None else (status not in ("", None))
+
+    if success:
+        print(f"[OK]  {label}")
+    else:
+        print(f"[ERR] {label}")
+
+    if fingerprint:
+        print(f"    fingerprint  : {fingerprint}")
+    if fingerprints:
+        print(f"    fingerprints : {fingerprints}")
+    if status:
+        print(f"    status       : {status}")
+    if stderr:
+        lines = [ln for ln in stderr.strip().splitlines() if ln]
+        tail = lines[-5:] if len(lines) > 5 else lines
+        for ln in tail:
+            print(f"    stderr:       : {ln}")
+
+    return success
+
+
+def inspect_gpg_version(gpg: gnupg.GPG) -> None:
+    """Print the GPG binary version string."""
+    version = gpg.version
+    print(f"gpg binary version : {version}")
+    print(f"GNUPGHOME          : {gpg.gnupghome}")
+    

cyfer-0.1.1/pyproject.toml

@@ -0,0 +1,22 @@
+[tool.poetry]
+name = "cyfer"
+version = "0.1.1"
+description = "A package for doing great things!"
+authors = ["Dylan Garrett"]
+license = "MIT"
+readme = "README.md"
+
+[tool.poetry.dependencies]
+python = "^3.13"
+python-gnupg = "^0.5.6"
+cryptography = "^49.0.0"
+
+
+[build-system]
+requires = ["poetry-core>=1.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[dependency-groups]
+dev = [
+    "ipython (>=9.15.0,<10.0.0)"
+]