determinist 0.2.0__py3-none-any.whl

determinist/__init__.py

@@ -0,0 +1 @@
+from .generator import generate_password, app

determinist/algorithms/__init__.py

@@ -0,0 +1,2 @@
+from .v1 import generate
+from .v2 import generate

determinist/algorithms/v1.py

@@ -0,0 +1,30 @@
+from argon2.low_level import Type, hash_secret
+from typing import Literal
+
+def generate(master_pass: str, site_name: str, pass_length: int, spec_mode: Literal["replace", "insert"], char_map: dict[str, str], spec_chars: list, spec_freq: int) -> str:
+    hashed_str = hash_secret(secret=master_pass.encode('utf-8'),
+                                salt=site_name.encode('utf-8'),
+                                time_cost=2,
+                                memory_cost=65536,
+                                parallelism=4,
+                                hash_len=32,
+                                type=Type.ID
+                            ).decode('utf-8')
+    stripped = hashed_str.split('$')[-1]
+
+    chars_added = ""
+    if spec_mode == "insert":
+        for i, char in enumerate(stripped):
+            chars_added += char
+            if (i + 1) % spec_freq == 0:
+                chars_added += spec_chars[i % len(spec_chars)]
+    elif spec_mode == "replace":
+        for _, char in enumerate(stripped):
+            if char.lower() in char_map:
+                chars_added += char_map[char.lower()]
+            else:
+                chars_added += char
+
+    final_password = chars_added[-pass_length:]
+
+    return final_password

determinist/algorithms/v2.py

@@ -0,0 +1,48 @@
+from argon2.low_level import Type, hash_secret
+from string import punctuation, ascii_lowercase, ascii_uppercase, digits
+from random import Random
+from io import BytesIO
+
+def generate(master_pass: str, site_name: str, pass_length: int, char_map: dict[str,str], char_types: list) -> str:
+    types_set = set(char_types)
+    charset = ""
+
+    if "special" in types_set:
+        charset += punctuation
+    if "lowercase" in types_set:
+        charset += ascii_lowercase
+    if "uppercase" in types_set:
+        charset += ascii_uppercase
+    if "digits" in types_set:
+        charset += digits
+
+    charset_list = list(charset)
+    salt = master_pass + site_name + str(pass_length) + str(char_map) + charset
+
+    random = Random(salt)
+    random.shuffle(charset_list)
+
+    hashed_bytes = hash_secret(secret=master_pass.encode('utf-8'),
+                                salt=salt.encode('utf-8'),
+                                time_cost=2,
+                                memory_cost=65536,
+                                parallelism=4,
+                                hash_len=32*pass_length,
+                                type=Type.ID
+                            )
+    stream = BytesIO(hashed_bytes)
+    password = ""
+
+    limit = 256 - (256 % len(charset_list))
+    for i, _ in enumerate(hashed_bytes):
+        byte = stream.getvalue()[i]
+        if i == pass_length:
+            break
+        elif byte < limit:
+            password += charset_list[byte % len(charset_list)]
+
+    password_to_shuffle = list(password)
+    random.shuffle(password_to_shuffle)
+    final = "".join(password_to_shuffle)
+
+    return final

determinist/generator.py

@@ -0,0 +1,75 @@
+import typer
+import json
+from typing import Literal, Annotated
+from string import punctuation
+from .algorithms import v1, v2
+from rich import print, box
+from rich.table import Table
+
+app = typer.Typer()
+
+def generate_password(master_pass: str, 
+                      site_name: str, 
+                      char_map: dict[str, str] = {}, 
+                      spec_chars: list = list(punctuation), 
+                      version: int = 2, 
+                      pass_length: int = 8, 
+                      spec_mode: Literal["replace", "insert"] = "insert",
+                      spec_freq: int = 4, 
+                      char_types: list = ["special","lowercase","uppercase","digits"]
+                     ) -> str:
+    
+    if version == 1:
+        return v1.generate(master_pass=master_pass, site_name=site_name, pass_length=pass_length, spec_mode=spec_mode, spec_chars=spec_chars, char_map=char_map, spec_freq=spec_freq)
+    elif version == 2:
+        return v2.generate(master_pass=master_pass, site_name=site_name, pass_length=pass_length, char_map=char_map, char_types=char_types)
+    else:
+        raise ValueError(f"Unsupported algorithm version: {version}")
+
+@app.command(name="generate")
+def generate_password_cli(master_pass: Annotated[str, typer.Argument()], 
+                      site_name: Annotated[str, typer.Argument()], 
+                      char_map: Annotated[str, typer.Option("--map", "-M")] = "{}", 
+                      spec_chars: Annotated[str, typer.Option("--special", "-s")] = punctuation, 
+                      version: Annotated[int, typer.Option("--version", "-v", min=1, max=2)] = 2, 
+                      pass_length: Annotated[int, typer.Option("--length", "-l", min=6, max=32)] = 8, 
+                      spec_mode: Annotated[Literal["replace", "insert"], typer.Option("--mode", "-m")] = "insert",
+                      spec_freq: Annotated[int, typer.Option("--frequency", "-f")] = 4, 
+                      char_types: Annotated[str, typer.Option("--chars", "-c")] = "special,lowercase,uppercase,digits"
+                     ):
+
+    char_map_dict = json.loads(char_map)
+    spec_chars_list = list(spec_chars)
+    char_types_list = char_types.split(',')
+
+    password = generate_password(master_pass=master_pass, site_name=site_name, char_map=char_map_dict, char_types=char_types_list, pass_length=pass_length, version=version, spec_mode=spec_mode, spec_chars=spec_chars_list, spec_freq=spec_freq)
+
+    success_table = Table(box=box.SIMPLE_HEAD, show_edge=False)
+    success_table.add_column("Password Generation Successful!", justify="center")
+    success_table.add_row(f"Password: [bold cyan]{password}[/]")
+
+    print(success_table)
+
+@app.command(name="prompt")
+def generate_password_prompt(master_pass: Annotated[str, typer.Argument()], 
+                      site_name: Annotated[str, typer.Argument()], 
+                      char_map: Annotated[str, typer.Option("--map", "-M", prompt="Character map (dict, v1)")] = "{}", 
+                      spec_chars: Annotated[str, typer.Option("--special", "-s", prompt="Special characters (v1)")] = punctuation, 
+                      version: Annotated[int, typer.Option("--version", "-v", min=1, max=2, prompt="version (1/2)")] = 2, 
+                      pass_length: Annotated[int, typer.Option("--length", "-l", min=6, max=32, prompt="Password length (6-32)")] = 8, 
+                      spec_mode: Annotated[Literal["replace", "insert"], typer.Option("--mode", "-m", prompt="Special character mode (v1)")] = "insert",
+                      spec_freq: Annotated[int, typer.Option("--frequency", "-f", prompt="Special character frequency (v1)")] = 4, 
+                      char_types: Annotated[str, typer.Option("--chars", "-c", prompt="Character types (v2)")] = "special,lowercase,uppercase,digits"
+                     ):
+
+    char_map_dict = json.loads(char_map)
+    spec_chars_list = list(spec_chars)
+    char_types_list = char_types.split(',')
+
+    password = generate_password(master_pass=master_pass, site_name=site_name, char_map=char_map_dict, char_types=char_types_list, pass_length=pass_length, version=version, spec_mode=spec_mode, spec_chars=spec_chars_list, spec_freq=spec_freq)
+
+    success_table = Table(box=box.SIMPLE_HEAD, show_edge=False)
+    success_table.add_column("\nPassword Generation Successful!", justify="center")
+    success_table.add_row(f"Password: [bold cyan]{password}[/]")
+
+    print(success_table)

determinist-0.2.0.dist-info/METADATA

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: determinist
+Version: 0.2.0
+Summary: A deterministic password generator
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+Requires-Dist: argon2-cffi>=25.1.0
+Requires-Dist: typer>=0.27.0

determinist-0.2.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+determinist/__init__.py,sha256=_RYWWAWxioTk1c-kUASQ070fz-hrWrcum1LVbO7zWxA,45
+determinist/generator.py,sha256=1316YCnU2SzaFspqwoP6DFV6_p-EPdEE_wuCbv4hmq0,4435
+determinist/algorithms/__init__.py,sha256=YsBa9mdNz5daW3B5SprrZdaE1MvZYKUW3xwGErMR424,49
+determinist/algorithms/v1.py,sha256=rSyMxp5cy2W0oY5DFxeNFsTt8WOfgRwZvL-aLjCYnEA,1231
+determinist/algorithms/v2.py,sha256=EJR7wzYAyxZWVKDrDLj-Fp-izEzN5x1hGoNHEnrfaM4,1618
+determinist-0.2.0.dist-info/METADATA,sha256=FUoMamjUoULbfRPNs7ZM_6UZfJVhx2sl7UToN-Lq2o8,227
+determinist-0.2.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+determinist-0.2.0.dist-info/entry_points.txt,sha256=0tFEiJkoD3cLrgW5zirmiUmJJJNXDBPWcMHuFCCWYcw,58
+determinist-0.2.0.dist-info/top_level.txt,sha256=P7rE4nKDnaxjgilcph1GvZJtdxg8Q3YdO18NpMwIBVk,12
+determinist-0.2.0.dist-info/RECORD,,

determinist-0.2.0.dist-info/WHEEL

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

determinist-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+determinist = determinist.generator:app

determinist-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+determinist