passmaker 0.1.0__py3-none-any.whl

passmaker/__main__.py

@@ -0,0 +1,209 @@
+from __future__ import annotations
+
+import contextlib
+import functools
+import secrets
+import string
+from typing import Callable, Sequence
+
+import click
+from click_option_group import optgroup
+
+# Rule is a filter to an alphabet
+type Rule = Callable[[str, set[str]], set[str]]
+
+QWERTY: str = "qwertyuiopasdfghjklzxcvbnmQWERTYUIOPASDFGHJKLZXCVBNM"
+
+
+def no_duplicates(password: str, alphabet: set[str]) -> set[str]:
+    """Don't use the same character more than once in a password.
+
+    This rule removes from alphabet every char from password."""
+    if not password:
+        return alphabet
+
+    return alphabet - set(password)
+
+
+def no_sequence_characters(password: str, alphabet: set[str]) -> set[str]:
+    """Don't use characters in password in a sequence, e.g. abc, 123, etc.
+
+    This rule enforces that the next symbol in password cannot be from
+    sequence, thus it's removed from alphabet."""
+
+    def _get_char(string: str, idx: int) -> str:
+        try:
+            return string[idx]
+        except IndexError:
+            return ""
+
+    if not password:
+        return alphabet
+
+    with contextlib.suppress(ValueError):
+        index = QWERTY.index(password[-1])
+
+        alphabet -= {
+            _get_char(QWERTY, index - 1),
+            _get_char(QWERTY, index + 1),
+        }
+
+    return alphabet - {chr(ord(password[-1]) - 1), chr(ord(password[-1]) + 1)}
+
+
+def no_similar_characters(password: str, alphabet: set[str]) -> set[str]:
+    """Don't use similar characters in password, e.g. i, I, L, l, 1, etc.
+
+    This rule removes from alphabet these characters: i1Il|, oO0, `.:"""
+    return alphabet - set("i1Il|oO0`.:")
+
+
+all_rules = [no_duplicates, no_sequence_characters, no_similar_characters]
+
+
+def build_alphabet(
+    *,
+    digits: bool = True,
+    lowercase: bool = True,
+    uppercase: bool = True,
+    symbols: bool | str = True,
+) -> str:
+    alphabet = ""
+
+    if digits:
+        alphabet += string.digits
+    if lowercase:
+        alphabet += string.ascii_lowercase
+    if uppercase:
+        alphabet += string.ascii_uppercase
+    if symbols:
+        alphabet += (
+            symbols if isinstance(symbols, str) else string.punctuation
+        )
+
+    return alphabet
+
+
+def generate_password(
+    length: int,
+    alphabet: str | None = None,
+    rules: Sequence[Rule] = all_rules,
+) -> str:
+    if alphabet is None:
+        alphabet = build_alphabet()
+
+    password = ""
+
+    for _ in range(length):
+        allowed_symbols = functools.reduce(
+            lambda alpha, rule: rule(password, alpha),
+            rules,
+            set(alphabet),
+        )
+
+        password += secrets.choice(list(allowed_symbols))
+
+    return password
+
+
+@click.command()
+@click.option(
+    "-l", "--length", default=22, type=int, help="Length of each password."
+)
+@click.option(
+    "-c",
+    "--count",
+    default=1,
+    type=int,
+    help="Count of passwords to generate in one take.",
+)
+@optgroup.group(
+    "Password alphabet",
+    help="Options controlling what set of symbols can be used in a password.",
+)
+@optgroup.option(
+    "-d/-D",
+    "--digits/--no-digits",
+    "use_digits",
+    default=True,
+    help="Where to use digits in password or no (default: yes)",
+)
+@optgroup.option(
+    "-a/-A",
+    "--alpha/--no-alpha",
+    "use_alpha",
+    default=True,
+    help="Where to use ASCII alphabet symbols in password or no "
+    "(default: yes)",
+)
+@optgroup.option(
+    "-S",
+    "--no-symbols",
+    default=False,
+    help="Don't use punctuation symbols for password generation "
+    "(overrides 'symbols' option).",
+)
+@optgroup.option(
+    "-s",
+    "--symbols",
+    type=str,
+    help="Use these exact symbols for password generation.",
+)
+@optgroup.group(
+    "Generation rules", help="Set of rules to control password generation."
+)
+@optgroup.option(
+    "--no-duplicates/--duplicates",
+    "use_duplicates",
+    default=True,
+    help="Allow or disallow duplicate characters.",
+)
+@optgroup.option(
+    "--no-sequence/--sequence",
+    "use_sequence",
+    default=True,
+    help="Allow or disallow sequential characters.",
+)
+@optgroup.option(
+    "--no-similar/--similar",
+    "use_similar",
+    default=True,
+    help="Allow or disallow similar looking characters.",
+)
+def main(  # noqa: PLR0913
+    length: int,
+    count: int,
+    *,
+    use_digits: bool,
+    use_alpha: bool,
+    symbols: str,
+    no_symbols: bool,
+    use_duplicates: bool,
+    use_sequence: bool,
+    use_similar: bool,
+) -> None:
+    """Simple password generator. Safe to use, generates quite strong
+    passwords.
+    """
+    alphabet = build_alphabet(
+        digits=use_digits,
+        lowercase=use_alpha,
+        uppercase=use_alpha,
+        symbols=False if no_symbols else symbols or True,
+    )
+
+    rules = []
+
+    if use_duplicates:
+        rules.append(no_duplicates)
+    if use_sequence:
+        rules.append(no_sequence_characters)
+    if use_similar:
+        rules.append(no_similar_characters)
+
+    for _ in range(count):
+        print(generate_password(length, alphabet=alphabet, rules=rules))  # noqa: T201
+
+
+if __name__ == "__main__":
+    main()

passmaker-0.1.0.dist-info/METADATA

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: passmaker
+Version: 0.1.0
+Summary: Generate strong passwords with ease and peace.
+Author-email: Soucelover <mr.ktotov@gmail.com>
+Requires-Python: >=3.14
+Requires-Dist: click-option-group>=0.5.9
+Requires-Dist: click>=8.3.1

passmaker-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+passmaker/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+passmaker/__main__.py,sha256=Xf46YaxRbSkPAPJTKhKQIw830JDAhUYHIxgJmmU-pbQ,5274
+passmaker-0.1.0.dist-info/METADATA,sha256=mvcxsGmjidwK9TMjDqBsLz8Yi1WZSswZ6Fw9jTddtDE,249
+passmaker-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+passmaker-0.1.0.dist-info/entry_points.txt,sha256=yP7kgl6dQ8HOszYiyx1BfDw4Ax_zT7wMvyYIFDnsOEk,54
+passmaker-0.1.0.dist-info/RECORD,,

passmaker-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

passmaker-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+passmaker = passmaker.__main__:main