shhh 0.0.0.dev0__tar.gz

shhh-0.0.0.dev0/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: shhh
+Version: 0.0.0.dev0
+Summary: Simple environment secret accessor for Python.
+Author: Anatoly Frolov (anafro)
+Author-email: anatolyfroloff@gmail.com
+Requires-Python: >=3.13
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Description-Content-Type: text/markdown
+
+# Shhh...
+
+**Shhh** is a dead simple secret accessor, that retrieves environment
+secrets, and secrets from files.
+
+## Installation
+
+To install Shhh, use:
+
+```bash
+pip install shhh
+```
+
+With Poetry, do:
+
+```bash
+poetry add shhh
+```
+
+## Usage
+
+The only function is **Shhh** is `get_secret`.
+It returns an environment variable, unless a file exists on path provided in `XXX_FILE` variable.
+For example:
+```py
+username: str = get_secret("APP_USERNAME")
+```
+
+***Shhh** searches for a file on path provided in `APP_USERNAME_FILE` variable and, if it exists,
+returns its content. Otherwise, returns the value of `APP_USERNAME` variable.
+
+## License
+
+**Shhh** is licensed under MIT.
+
+------------------
+Copyright (c) 2026 Anatoly Frolov (anafro). All Rights Reserved.\
+`contact@anafro.ru`
+

shhh-0.0.0.dev0/README.md

@@ -0,0 +1,38 @@
+# Shhh...
+
+**Shhh** is a dead simple secret accessor, that retrieves environment
+secrets, and secrets from files.
+
+## Installation
+
+To install Shhh, use:
+
+```bash
+pip install shhh
+```
+
+With Poetry, do:
+
+```bash
+poetry add shhh
+```
+
+## Usage
+
+The only function is **Shhh** is `get_secret`.
+It returns an environment variable, unless a file exists on path provided in `XXX_FILE` variable.
+For example:
+```py
+username: str = get_secret("APP_USERNAME")
+```
+
+***Shhh** searches for a file on path provided in `APP_USERNAME_FILE` variable and, if it exists,
+returns its content. Otherwise, returns the value of `APP_USERNAME` variable.
+
+## License
+
+**Shhh** is licensed under MIT.
+
+------------------
+Copyright (c) 2026 Anatoly Frolov (anafro). All Rights Reserved.\
+`contact@anafro.ru`

shhh-0.0.0.dev0/pyproject.toml

@@ -0,0 +1,16 @@
+[project]
+name = "shhh"
+version = "0.0.0-dev"
+description = "Simple environment secret accessor for Python."
+authors = [
+    {name = "Anatoly Frolov (anafro)",email = "anatolyfroloff@gmail.com"}
+]
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+]
+
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"

shhh-0.0.0.dev0/src/shhh/__init__.py

@@ -0,0 +1,18 @@
+from os import environ as env
+from pathlib import Path
+
+
+def get_secret(name: str) -> str:
+    if name in env:
+        return env[name]
+
+    filename_env_key: str = f"{name}_FILE"
+
+    if filename_env_key in env:
+        environment_secret_filepath: Path = Path(env[filename_env_key])
+        with open(environment_secret_filepath, "r") as secret_file:
+            return secret_file.read()
+
+    raise ValueError(
+        f"Neither {name}, nor {filename_env_key} is present in environment variables."
+    )