smart-dynamic-path 1.0.1__py3-none-any.whl

smart_dynamic_path/__init__.py

@@ -0,0 +1,9 @@
+# Copyright (©) 2026, Alexander Suvorov. All rights reserved.
+__version__ = '1.0.1'
+__all__ = [
+    'generate_secret_key',
+    'generate_path',
+    'secret_to_path',
+]
+
+from smart_dynamic_path.core import generate_secret_key, generate_path, secret_to_path

smart_dynamic_path/cli.py

@@ -0,0 +1,50 @@
+# Copyright (©) 2026, Alexander Suvorov. All rights reserved.
+"""
+Smart Dynamic Path CLI — Local key and path generation from a secret phrase
+
+Installation: pip install smart-dynamic-path
+Usage:
+smart-dynamic-path --secret "my secret phrase"
+smart-dynamic-path --secret "my secret phrase" --period month --full
+"""
+
+import argparse
+from smart_dynamic_path.core import secret_to_path, get_full_path
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog='smart-dynamic-path',
+        description='Generate deterministic time-based paths from a secret phrase'
+    )
+    parser.add_argument('--secret', '-s', required=True, help='Secret phrase')
+    parser.add_argument('--period', '-P', default='day',
+                        choices=['day', 'month', 'hour', 'static'],
+                        help='Path change period (default: day)')
+    parser.add_argument('--prefix', '-p', default='',
+                        help='Optional path prefix')
+    parser.add_argument('--full', '-f', action='store_true',
+                        help='Show full URL path')
+    parser.add_argument('--key-only', '-k', action='store_true',
+                        help='Show only SECRET_KEY')
+    parser.add_argument('--path-only', '-a', action='store_true',
+                        help='Show only path')
+
+    args = parser.parse_args()
+
+    secret_key, path = secret_to_path(args.secret, args.period, args.prefix)
+
+    if args.key_only:
+        print(secret_key)
+    elif args.path_only:
+        print(path)
+    elif args.full:
+        print(get_full_path(secret_key, args.period, args.prefix))
+    else:
+        print(f"SECRET_KEY: {secret_key}")
+        print(f"Path: {path}")
+        print(f"Full URL: {get_full_path(secret_key, args.period, args.prefix)}")
+
+
+if __name__ == '__main__':
+    main()

smart_dynamic_path/core.py

@@ -0,0 +1,75 @@
+# Copyright (©) 2026, Alexander Suvorov. All rights reserved.
+import hashlib
+from datetime import datetime
+
+
+def generate_secret_key(secret: str) -> str:
+    """
+    Generate SECRET_KEY from secret phrase.
+
+    Args:
+        secret: Secret phrase
+
+    Returns:
+        64 hex chars (256 bits)
+    """
+    return hashlib.sha256(secret.encode()).hexdigest()
+
+
+def generate_path(secret_key: str, period: str = 'day', prefix: str = '') -> str:
+    """
+    Generate deterministic time-based path.
+
+    Args:
+        secret_key: 64 hex chars (256 bits) from generate_secret_key()
+        period: 'day', 'month', 'hour', 'static'
+        prefix: Optional path prefix (e.g., 'admin')
+
+    Returns:
+        32 hex chars path or "prefix/path"
+    """
+    now = datetime.now()
+
+    if period == 'day':
+        key = now.strftime("%Y-%m-%d")
+    elif period == 'month':
+        key = now.strftime("%Y-%m")
+    elif period == 'hour':
+        key = now.strftime("%Y-%m-%d-%H")
+    else:
+        key = 'static'
+
+    h = hashlib.sha256(f"{secret_key}_{key}".encode()).digest()
+    path_hash = h[:16].hex()
+
+    if prefix:
+        return f"{prefix}/{path_hash}"
+    return path_hash
+
+
+def secret_to_path(secret: str, period: str = 'day', prefix: str = '') -> tuple:
+    """
+    Convert secret phrase to (secret_key, path).
+
+    Args:
+        secret: Secret phrase
+        period: 'day', 'month', 'hour', 'static'
+        prefix: Optional path prefix
+
+    Returns:
+        (secret_key, path) tuple
+    """
+    key = generate_secret_key(secret)
+    path = generate_path(key, period, prefix)
+    return key, path
+
+
+def get_full_path(secret_key: str, period: str = 'day', prefix: str = '') -> str:
+    """
+    Get full path with leading slash.
+
+    Returns:
+        Full path like "/admin/a1b2c3d4e5f6g7h8/"
+    """
+    path = generate_path(secret_key, period, prefix)
+    return f"/{path}/"

smart_dynamic_path-1.0.1.dist-info/METADATA

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: smart-dynamic-path
+Version: 1.0.1
+Summary: Dynamic, deterministic, time-dependent path generation. No storage. No database. No dependencies. One secret phrase → one deterministic path per time period. Same phrase + same day = same path. No storage. No database. Just pure math.
+Author-email: Alexander Suvorov <smartlegionlab@gmail.com>
+License: BSD-3-Clause
+Project-URL: Homepage, https://github.com/smartlegionlab/smart-dynamic-path
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Security
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Smart Dynamic Path <sup>v1.0.1</sup>
+
+**Dynamic, deterministic, time-dependent path generation. No storage. No database. No dependencies.**
+
+Generate cryptographically secure paths that change automatically based on time (day, month, hour) from a secret phrase. 
+Perfect for hiding admin panels, creating temporary access links, or building time-based API keys.
+
+---
+
+[![GitHub release (latest by date)](https://img.shields.io/github/v/release/smartlegionlab/smart-dynamic-path)](https://github.com/smartlegionlab/smart-dynamic-path/)
+![GitHub top language](https://img.shields.io/github/languages/top/smartlegionlab/smart-dynamic-path)
+[![GitHub](https://img.shields.io/github/license/smartlegionlab/smart-dynamic-path)](https://github.com/smartlegionlab/smart-dynamic-path/blob/master/LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/smartlegionlab/smart-dynamic-path?style=social)](https://github.com/smartlegionlab/smart-dynamic-path/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/smartlegionlab/smart-dynamic-path?style=social)](https://github.com/smartlegionlab/smart-dynamic-path/network/members)
+
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/smart-dynamic-path?label=pypi%20downloads)](https://pypi.org/project/smart-dynamic-path/)
+[![PyPI](https://img.shields.io/pypi/v/smart-dynamic-path)](https://pypi.org/project/smart-dynamic-path)
+[![PyPI - Format](https://img.shields.io/pypi/format/smart-dynamic-path)](https://pypi.org/project/smart-dynamic-path)
+[![PyPI Downloads](https://static.pepy.tech/badge/smart-dynamic-path)](https://pepy.tech/projects/smart-dynamic-path)
+[![PyPI Downloads](https://static.pepy.tech/badge/smart-dynamic-path/month)](https://pepy.tech/projects/smart-dynamic-path)
+[![PyPI Downloads](https://static.pepy.tech/badge/smart-dynamic-path/week)](https://pepy.tech/projects/smart-dynamic-path)
+
+---
+
+## Core idea
+
+One secret phrase → one deterministic path per time period. Same phrase + same day = same path. No storage. No database. Just pure math.
+
+---
+
+## Disclaimer
+
+**By using this software, you agree to the full disclaimer terms.**
+
+**Summary:** Software provided "AS IS" without warranty. You assume all risks.
+
+**Full legal disclaimer:** See [DISCLAIMER.md](https://github.com/smartlegionlab/smart-dynamic-path/blob/master/DISCLAIMER.md)
+
+---
+
+## Use cases
+
+- Hide Django admin: `/admin/a1b2c3d4e5f6g7h8/`
+- Temporary download links that expire after a day
+- Time-rotating API endpoints
+- "Secret room" pattern for any web framework
+
+and others...
+
+## Local usage without installation
+
+```bash
+git clone https://github.com/smartlegionlab/smart-dynamic-path
+cd smart-dynamic-path
+
+python -m smart_dynamic_path.cli --secret "my secret phrase"
+python -m smart_dynamic_path.cli --secret "my secret phrase" --period month --full
+python -m smart_dynamic_path.cli --secret "my secret phrase" --key-only
+```
+
+## Installation
+
+```bash
+pip install smart-dynamic-path
+```
+
+## Quick start
+
+```python
+from smart_dynamic_path import generate_path, secret_to_path
+
+# Generate path from secret key
+path = generate_path(secret_key='your_64_hex_secret_key', period='day')
+# Output: "4e30939634dfc6617f10a2f8fe259f44"
+
+# With prefix
+path = generate_path(secret_key='...', period='day', prefix='admin')
+# Output: "admin/4ab3b83e39bbb1d7e31e0978ea8cea05"
+
+# From secret phrase (local use only)
+key, path = secret_to_path('my secret phrase', period='day')
+```
+
+## CLI commands
+
+| Command                                                      | Output                       |
+|--------------------------------------------------------------|------------------------------|
+| `smart-dynamic-path --secret "secret"`                       | Full info (key + path + URL) |
+| `smart-dynamic-path --secret "secret" --key-only`            | Only SECRET_KEY (64 hex)     |
+| `smart-dynamic-path --secret "secret" --path-only`           | Only path (32 hex)           |
+| `smart-dynamic-path --secret "secret" --full`                | Only full URL `/xxxx/`       |
+| `smart-dynamic-path --secret "secret" --period month --full` | Monthly rotation             |
+| `smart-dynamic-path --secret "secret" --prefix admin --full` | With prefix                  |
+
+## Python API
+
+```python
+from smart_dynamic_path import generate_secret_key, generate_path, secret_to_path
+
+# From secret phrase
+key = generate_secret_key("my secret phrase")
+path = generate_path(key, period='day')
+key, path = secret_to_path("my secret phrase", period='day')
+```
+
+## How it works
+
+```
+SECRET_KEY = SHA256(secret_phrase)                 # 64 hex chars (256 bits)
+PATH = SHA256(SECRET_KEY + date)[:16].hex()        # 32 hex chars (128 bits)
+```
+
+- Secret phrase → SECRET_KEY (256 bits)
+- SECRET_KEY + current date/time → path (128 bits)
+- Path changes automatically based on period (day/month/hour/static)
+
+## Implemented paradigms
+
+### 1. Pointer‑Based Security
+The path is not stored anywhere. It is regenerated on demand from a secret phrase and current time. There is no stored "pointer" — only the ability to compute it.
+
+**DOI:** [10.5281/zenodo.17204738](https://doi.org/10.5281/zenodo.17204738)
+
+### 2. Local Data Regeneration
+The exact path is computed locally on the developer's machine using only the secret phrase and date, without accessing any server.
+
+**DOI:** [10.5281/zenodo.17264327](https://doi.org/10.5281/zenodo.17264327)
+
+### 3. Position‑Candidate‑Hypothesis (PCH)
+Among all possible paths (2¹²⁸ candidates), only one specific path generated by the secret phrase is valid at any given time.
+
+**DOI:** [10.5281/zenodo.17614888](https://doi.org/10.5281/zenodo.17614888)
+
+## Security
+
+- No storage — paths are regenerated, not stored
+- Deterministic — same input always produces same output
+- 32 hex chars = 2¹²⁸ possible paths (no brute force)
+- Time-based rotation limits exposure window
+
+## License
+
+BSD-3-Clause
+
+## Author
+
+Alexander Suvorov [@smartlegionlab](https://github.com/smartlegionlab)

smart_dynamic_path-1.0.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+smart_dynamic_path/__init__.py,sha256=VBc_CcUV8IVzcirOPLprLHui8O99mC8Oc-LnBylYsf0,256
+smart_dynamic_path/cli.py,sha256=hJAm5CGDk6RbcvyicoIAasIpYt-3l4SygHGnnibJ-ZI,1793
+smart_dynamic_path/core.py,sha256=VYNTSlNQbEnPcCT4G6udztybUaZvyFxk-o6vYiG_Mcg,1872
+smart_dynamic_path-1.0.1.dist-info/licenses/LICENSE,sha256=bXnWlOMydXEp3EEgmsJuPpErliZndYEC9RReI1H-Jek,1504
+smart_dynamic_path-1.0.1.dist-info/METADATA,sha256=a0G6HTf_TUAQycFX_bZxmSOPlsgnj7TWlHupo6fLsmk,6970
+smart_dynamic_path-1.0.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+smart_dynamic_path-1.0.1.dist-info/entry_points.txt,sha256=HUOHeHXnqE_XeNskicxRZ1LIbLt48XWlvIgEHHiZ4SA,67
+smart_dynamic_path-1.0.1.dist-info/top_level.txt,sha256=1SOWFhZ_ysV6m33PJwXBl5FW70gVeawRSCUYCweMfiU,19
+smart_dynamic_path-1.0.1.dist-info/RECORD,,

smart_dynamic_path-1.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

smart_dynamic_path-1.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+smart-dynamic-path = smart_dynamic_path.cli:main

smart_dynamic_path-1.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Alexander Suvorov
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

smart_dynamic_path-1.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+smart_dynamic_path