stealth-message-cli 0.1.0__py3-none-any.whl

stealth_cli/ui/setup.py

@@ -0,0 +1,212 @@
+"""First-use setup wizard (alias + passphrase → RSA-4096 keypair).
+
+Collects alias and passphrase interactively via prompt_toolkit, generates
+an RSA-4096 keypair, saves it to disk, and returns the credentials needed
+to start the chat session.
+
+Usage (called by __main__.py)::
+
+    alias, armored_private, passphrase = await run_setup()
+"""
+
+from __future__ import annotations
+
+import asyncio
+from typing import Optional
+
+from prompt_toolkit import PromptSession
+from prompt_toolkit.formatted_text import HTML
+from prompt_toolkit.styles import Style
+from prompt_toolkit.validation import ValidationError, Validator
+from rich.console import Console
+from rich.panel import Panel
+from rich.progress import Progress, SpinnerColumn, TextColumn
+from rich.rule import Rule
+from rich.text import Text
+
+from stealth_cli import config
+from stealth_cli.crypto.keys import generate_keypair, get_fingerprint
+
+console = Console()
+
+_STYLE = Style.from_dict(
+    {
+        "prompt": "bold cyan",
+        "label": "ansicyan",
+    }
+)
+
+# --------------------------------------------------------------------------- #
+# Validators                                                                    #
+# --------------------------------------------------------------------------- #
+
+
+class _NonEmptyValidator(Validator):
+    def __init__(self, field: str, min_len: int = 1) -> None:
+        self._field = field
+        self._min_len = min_len
+
+    def validate(self, document):  # type: ignore[override]
+        if len(document.text.strip()) < self._min_len:
+            raise ValidationError(
+                message=f"{self._field} must be at least {self._min_len} character(s)",
+                cursor_position=len(document.text),
+            )
+
+
+class _AliasValidator(_NonEmptyValidator):
+    def __init__(self) -> None:
+        super().__init__("Alias", min_len=1)
+
+    def validate(self, document):  # type: ignore[override]
+        super().validate(document)
+        if len(document.text.strip()) > 64:
+            raise ValidationError(
+                message="Alias must be 64 characters or fewer",
+                cursor_position=len(document.text),
+            )
+
+
+class _PassphraseValidator(Validator):
+    MIN_LEN = 8
+
+    def validate(self, document):  # type: ignore[override]
+        if len(document.text) < self.MIN_LEN:
+            raise ValidationError(
+                message=f"Passphrase must be at least {self.MIN_LEN} characters",
+                cursor_position=len(document.text),
+            )
+
+
+# --------------------------------------------------------------------------- #
+# Public entry point                                                            #
+# --------------------------------------------------------------------------- #
+
+
+async def run_setup() -> tuple[str, str, str]:
+    """Interactive first-use wizard.
+
+    Prompts for alias and passphrase, generates an RSA-4096 keypair,
+    persists it to disk, and returns ``(alias, armored_private, passphrase)``.
+    """
+    _print_welcome()
+
+    session: PromptSession[str] = PromptSession(style=_STYLE)
+
+    alias = await _prompt_alias(session)
+    passphrase = await _prompt_passphrase(session)
+
+    armored_private, armored_public = await _generate_with_spinner(alias, passphrase)
+
+    config.save_keypair(armored_private, armored_public, alias)
+
+    _print_success(alias, armored_public)
+
+    return alias, armored_private, passphrase
+
+
+# --------------------------------------------------------------------------- #
+# UI helpers                                                                    #
+# --------------------------------------------------------------------------- #
+
+
+def _print_welcome() -> None:
+    console.print()
+    console.print(
+        Panel(
+            Text.assemble(
+                ("stealth-message", "bold white"),
+                "\n",
+                ("End-to-end encrypted PGP chat — no server, no accounts", "dim"),
+            ),
+            border_style="cyan",
+            padding=(1, 4),
+        )
+    )
+    console.print(
+        Rule("[cyan]First-time setup[/cyan]", style="dim"),
+    )
+    console.print()
+
+
+async def _prompt_alias(session: PromptSession[str]) -> str:
+    """Prompt for a display alias (1–64 chars)."""
+    console.print("[cyan]Choose a display name[/cyan] (visible to peers, max 64 chars)")
+    alias: str = await session.prompt_async(
+        HTML("<prompt>Alias: </prompt>"),
+        validator=_AliasValidator(),
+        validate_while_typing=False,
+    )
+    return alias.strip()
+
+
+async def _prompt_passphrase(session: PromptSession[str]) -> str:
+    """Prompt for passphrase with confirmation."""
+    console.print()
+    console.print(
+        "[cyan]Choose a passphrase[/cyan] — protects your private key on disk"
+    )
+    console.print("[dim]Minimum 8 characters. You will be asked for it on every start.[/dim]")
+
+    while True:
+        passphrase: str = await session.prompt_async(
+            HTML("<prompt>Passphrase: </prompt>"),
+            is_password=True,
+            validator=_PassphraseValidator(),
+            validate_while_typing=False,
+        )
+        confirm: str = await session.prompt_async(
+            HTML("<prompt>Confirm passphrase: </prompt>"),
+            is_password=True,
+        )
+        if passphrase == confirm:
+            break
+        console.print("[red]Passphrases do not match. Try again.[/red]")
+
+    return passphrase
+
+
+async def _generate_with_spinner(alias: str, passphrase: str) -> tuple[str, str]:
+    """Generate RSA-4096 keypair in a thread pool with a spinner."""
+    console.print()
+
+    with Progress(
+        SpinnerColumn(),
+        TextColumn("[cyan]{task.description}"),
+        transient=True,
+        console=console,
+    ) as progress:
+        task = progress.add_task("Generating RSA-4096 keypair…", total=None)
+
+        loop = asyncio.get_event_loop()
+        armored_private, armored_public = await loop.run_in_executor(
+            None, generate_keypair, alias, passphrase
+        )
+        progress.remove_task(task)
+
+    return armored_private, armored_public
+
+
+def _print_success(alias: str, armored_public: str) -> None:
+    fp = get_fingerprint(armored_public)
+
+    console.print("[green]✓[/green] Keypair generated and saved.")
+    console.print()
+    console.print(
+        Panel(
+            Text.assemble(
+                ("Alias:       ", "bold"),
+                (alias, "cyan"),
+                "\n",
+                ("Fingerprint: ", "bold"),
+                (fp, "yellow"),
+            ),
+            title="[bold]Your identity[/bold]",
+            border_style="green",
+            padding=(1, 3),
+        )
+    )
+    console.print(
+        "[dim]Share your fingerprint out-of-band so peers can verify your identity.[/dim]"
+    )
+    console.print()

stealth_message_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: stealth-message-cli
+Version: 0.1.0
+Summary: Terminal client for stealth-message — end-to-end encrypted PGP chat
+License: GPL-3.0-only
+Project-URL: Homepage, https://syberiancode.com/stealth-message
+Project-URL: Repository, https://github.com/syberiancode/stealth-message
+Project-URL: Issues, https://github.com/syberiancode/stealth-message/issues
+Keywords: chat,encryption,pgp,privacy,end-to-end
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: <3.13,>=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pgpy>=0.6.0
+Requires-Dist: websockets>=12.0
+Requires-Dist: rich>=13.0
+Requires-Dist: prompt_toolkit>=3.0
+Requires-Dist: platformdirs>=4.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: black>=24.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+
+# stealth-message CLI
+
+End-to-end encrypted PGP chat. No central server. No accounts. No content metadata.
+
+## Installation
+
+```bash
+curl -fsSL https://syberiancode.com/stealth-message/install.sh | bash
+```
+
+**Windows (PowerShell):**
+```powershell
+powershell -c "irm https://syberiancode.com/stealth-message/install.ps1 | iex"
+```
+
+**Or install directly with pip:**
+```bash
+pip install stealth-message-cli
+```
+
+## Requirements
+
+- Python 3.10, 3.11, or 3.12
+
+## Usage
+
+```bash
+stealth-cli
+```
+
+## Security
+
+- RSA-4096 keypair per user
+- Sign-then-encrypt on send, decrypt-then-verify on receive
+- Private key is passphrase-protected on disk
+- Wire encoding: ASCII-armored PGP → Base64 URL-safe
+
+## License
+
+GPL-3.0. See [LICENSE](https://github.com/syberiancode/stealth-message/blob/main/LICENSE).

stealth_message_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+stealth_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+stealth_cli/__main__.py,sha256=V1-olLs3_5aOYIdLb0q5jbZH1IMyrPlxXQ-BAkgG0qw,22331
+stealth_cli/config.py,sha256=Us73UNRL6qPLlhhIn_M8tbxorCnUUtDssoFUCu6vbwU,4119
+stealth_cli/exceptions.py,sha256=yblXvvVrFzkQIza7kwoM01N2S8BFa-HDFsS1XoJcVoU,870
+stealth_cli/crypto/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+stealth_cli/crypto/keys.py,sha256=M6C1wECQLEKgp96wJ7xnim5Ke9Kej0TohiflW1Ltqnw,3932
+stealth_cli/crypto/messages.py,sha256=HKTL-vYxvfflV4fe88SWlL_jTdULbi9mlgZMimjta7s,4911
+stealth_cli/network/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+stealth_cli/network/client.py,sha256=7zAEn5oc_AqfDNb73vyUVP5bCgA5XgFw4knu0N0CxZc,20738
+stealth_cli/network/server.py,sha256=qtU6jkBR2lWcUpYHGmx7L4uLIPsa96qYw04RPhDar1o,27169
+stealth_cli/ui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+stealth_cli/ui/chat.py,sha256=FpTbB6ejgbimW1SFVxE4pJtdpnTOYfy2qmUPRCAqfmw,40954
+stealth_cli/ui/setup.py,sha256=uUhyXzF_5EGCrJVMSkXdCMi4pahvJXDBJaYRFYYgVBw,6775
+stealth_message_cli-0.1.0.dist-info/METADATA,sha256=TD1i1u0z-tow6Vqnskw91P0SYbZnvf2TN4e81tE2ogQ,2137
+stealth_message_cli-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+stealth_message_cli-0.1.0.dist-info/entry_points.txt,sha256=tdlk9LpnPBPOp_OzWOuAtUprcQxTUspvYmP2YBrWU6o,58
+stealth_message_cli-0.1.0.dist-info/top_level.txt,sha256=AgMse2uy3u79YKPdSSjvZcNtUJCftRHWJGd8b7ZXuvM,12
+stealth_message_cli-0.1.0.dist-info/RECORD,,

stealth_message_cli-0.1.0.dist-info/WHEEL

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

stealth_message_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+stealth-cli = stealth_cli.__main__:main

stealth_message_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+stealth_cli