python-snacks 0.1.2__tar.gz

python_snacks-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kicka5h
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

python_snacks-0.1.2/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.4
+Name: python-snacks
+Version: 0.1.2
+Summary: A CLI tool for managing a personal stash of reusable Python code snippets.
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer[all]>=0.9
+Provides-Extra: test
+Requires-Dist: pytest>=8; extra == "test"
+Dynamic: license-file
+
+# Snack Stash
+
+A personal CLI tool for managing a local stash of reusable Python code snippets. Browse, copy, and curate snippets across projects with a single command.
+
+```bash
+pipx install snack-stash
+snack stash create default ~/snack-stash
+snack unpack auth/google_oauth.py
+```
+
+---
+
+## Installation
+
+**Recommended (pipx):**
+```bash
+pipx install snack-stash
+```
+
+**Alternative (pip):**
+```bash
+pip install snack-stash
+```
+
+Requires Python 3.10+.
+
+---
+
+## Configuration
+
+### First-time setup
+
+Create a stash directory and register it:
+
+```bash
+snack stash create default ~/snack-stash
+```
+
+This creates `~/snack-stash`, writes `~/.snackstashrc`, and sets `default` as the active stash.
+
+### Environment variable (overrides config file)
+
+```bash
+export SNACK_STASH=~/snack-stash
+```
+
+Add to `~/.zshrc` or `~/.bashrc` to make it permanent. Takes priority over everything else.
+
+### Config file (`~/.snackstashrc`)
+
+Created automatically by `snack stash create`. You can also edit it by hand:
+
+```ini
+[config]
+active = default
+
+[stash.default]
+path = ~/snack-stash
+
+[stash.work]
+path = ~/work-stash
+```
+
+**Priority order:** `SNACK_STASH` env var → `~/.snackstashrc` active stash → error.
+
+---
+
+## Stash structure
+
+A stash is a plain directory of `.py` files, organized into subdirectories by category:
+
+```
+~/snack-stash/
+├── auth/
+│   ├── google_oauth_fastapi.py
+│   ├── google_oauth_flask.py
+│   └── jwt_helpers.py
+├── forms/
+│   ├── contact_form.py
+│   └── newsletter_signup.py
+└── email/
+    └── smtp_sender.py
+```
+
+You can manage the directory with Git, Dropbox, or any sync tool independently of this CLI.
+
+---
+
+## Commands
+
+### `snack list [category]`
+
+List all snippets in the active stash.
+
+```bash
+snack list           # all snippets
+snack list auth      # filtered by category (subdirectory)
+```
+
+### `snack search <keyword>`
+
+Search snippet filenames for a keyword (case-insensitive).
+
+```bash
+snack search oauth
+# auth/google_oauth_fastapi.py
+# auth/google_oauth_flask.py
+```
+
+### `snack unpack <snippet>`
+
+Copy a snippet **from the stash** into the current working directory.
+
+```bash
+snack unpack auth/google_oauth_fastapi.py
+# → ./auth/google_oauth_fastapi.py
+
+snack unpack auth/google_oauth_fastapi.py --flat
+# → ./google_oauth_fastapi.py  (no subdirectory)
+
+snack unpack auth/google_oauth_fastapi.py --force
+# Overwrites without prompting
+```
+
+### `snack pack <snippet>`
+
+Copy a file **from the current directory** back into the stash. Use this when you've improved a snippet on a project and want to update the canonical version.
+
+```bash
+snack pack auth/google_oauth_fastapi.py
+snack pack auth/google_oauth_fastapi.py --force
+```
+
+---
+
+## Stash management
+
+### `snack stash create <name> <path>`
+
+Register a new named stash. Creates the directory if it doesn't exist.
+
+```bash
+snack stash create default ~/snack-stash
+snack stash create work ~/work-stash --no-activate
+```
+
+The first stash created is automatically set as active. Use `--no-activate` to add a stash without switching to it.
+
+### `snack stash list`
+
+Show all configured stashes and which one is active.
+
+```bash
+snack stash list
+#   default  /Users/you/snack-stash  ← active
+#   work     /Users/you/work-stash
+```
+
+### `snack stash move <name> <new-path>`
+
+Move a stash to a new location. Moves the directory on disk and updates the config.
+
+```bash
+snack stash move default ~/new-location/snack-stash
+```
+
+### `snack stash add-remote <repo>`
+
+Copy Python snippets from a public GitHub repository into the active stash. Downloads the repo as a tarball and copies all `.py` files, preserving directory structure.
+
+```bash
+snack stash add-remote owner/repo
+snack stash add-remote https://github.com/owner/repo
+snack stash add-remote owner/repo --subdir auth   # only copy files under auth/
+snack stash add-remote owner/repo --force         # overwrite without prompting
+```
+
+---
+
+## Error handling
+
+| Situation | Behaviour |
+|---|---|
+| No stash configured | Error with setup instructions |
+| Stash path doesn't exist | Error with the attempted path |
+| Snippet not found in stash | Error — use `snack list` or `snack search` |
+| Source file not found | Error |
+| Destination file already exists | Prompt to confirm, or skip with `--force` |
+| Named stash already exists | Error |
+| Move target already exists | Error |
+| GitHub repo not found (HTTP 404) | Error with status code |
+
+---
+
+## Project structure
+
+```
+python-snacks/
+├── pyproject.toml
+├── snacks/
+│   ├── main.py      # Typer app, all command definitions
+│   ├── config.py    # SnackConfig class, stash path resolution
+│   └── ops.py       # File copy logic (pack, unpack, add_remote)
+└── tests/
+    ├── test_commands.py        # snippet commands
+    └── test_stash_commands.py  # stash management commands
+```
+
+---
+
+## CI / CD
+
+- **CI:** Tests run on every push and PR to `main` across Python 3.10, 3.11, and 3.12.
+- **Publish:** Push a `v*` tag to trigger a build, PyPI publish, and GitHub Release.
+
+```bash
+git tag v0.2.0 && git push origin v0.2.0
+```

python_snacks-0.1.2/README.md

@@ -0,0 +1,218 @@
+# Snack Stash
+
+A personal CLI tool for managing a local stash of reusable Python code snippets. Browse, copy, and curate snippets across projects with a single command.
+
+```bash
+pipx install snack-stash
+snack stash create default ~/snack-stash
+snack unpack auth/google_oauth.py
+```
+
+---
+
+## Installation
+
+**Recommended (pipx):**
+```bash
+pipx install snack-stash
+```
+
+**Alternative (pip):**
+```bash
+pip install snack-stash
+```
+
+Requires Python 3.10+.
+
+---
+
+## Configuration
+
+### First-time setup
+
+Create a stash directory and register it:
+
+```bash
+snack stash create default ~/snack-stash
+```
+
+This creates `~/snack-stash`, writes `~/.snackstashrc`, and sets `default` as the active stash.
+
+### Environment variable (overrides config file)
+
+```bash
+export SNACK_STASH=~/snack-stash
+```
+
+Add to `~/.zshrc` or `~/.bashrc` to make it permanent. Takes priority over everything else.
+
+### Config file (`~/.snackstashrc`)
+
+Created automatically by `snack stash create`. You can also edit it by hand:
+
+```ini
+[config]
+active = default
+
+[stash.default]
+path = ~/snack-stash
+
+[stash.work]
+path = ~/work-stash
+```
+
+**Priority order:** `SNACK_STASH` env var → `~/.snackstashrc` active stash → error.
+
+---
+
+## Stash structure
+
+A stash is a plain directory of `.py` files, organized into subdirectories by category:
+
+```
+~/snack-stash/
+├── auth/
+│   ├── google_oauth_fastapi.py
+│   ├── google_oauth_flask.py
+│   └── jwt_helpers.py
+├── forms/
+│   ├── contact_form.py
+│   └── newsletter_signup.py
+└── email/
+    └── smtp_sender.py
+```
+
+You can manage the directory with Git, Dropbox, or any sync tool independently of this CLI.
+
+---
+
+## Commands
+
+### `snack list [category]`
+
+List all snippets in the active stash.
+
+```bash
+snack list           # all snippets
+snack list auth      # filtered by category (subdirectory)
+```
+
+### `snack search <keyword>`
+
+Search snippet filenames for a keyword (case-insensitive).
+
+```bash
+snack search oauth
+# auth/google_oauth_fastapi.py
+# auth/google_oauth_flask.py
+```
+
+### `snack unpack <snippet>`
+
+Copy a snippet **from the stash** into the current working directory.
+
+```bash
+snack unpack auth/google_oauth_fastapi.py
+# → ./auth/google_oauth_fastapi.py
+
+snack unpack auth/google_oauth_fastapi.py --flat
+# → ./google_oauth_fastapi.py  (no subdirectory)
+
+snack unpack auth/google_oauth_fastapi.py --force
+# Overwrites without prompting
+```
+
+### `snack pack <snippet>`
+
+Copy a file **from the current directory** back into the stash. Use this when you've improved a snippet on a project and want to update the canonical version.
+
+```bash
+snack pack auth/google_oauth_fastapi.py
+snack pack auth/google_oauth_fastapi.py --force
+```
+
+---
+
+## Stash management
+
+### `snack stash create <name> <path>`
+
+Register a new named stash. Creates the directory if it doesn't exist.
+
+```bash
+snack stash create default ~/snack-stash
+snack stash create work ~/work-stash --no-activate
+```
+
+The first stash created is automatically set as active. Use `--no-activate` to add a stash without switching to it.
+
+### `snack stash list`
+
+Show all configured stashes and which one is active.
+
+```bash
+snack stash list
+#   default  /Users/you/snack-stash  ← active
+#   work     /Users/you/work-stash
+```
+
+### `snack stash move <name> <new-path>`
+
+Move a stash to a new location. Moves the directory on disk and updates the config.
+
+```bash
+snack stash move default ~/new-location/snack-stash
+```
+
+### `snack stash add-remote <repo>`
+
+Copy Python snippets from a public GitHub repository into the active stash. Downloads the repo as a tarball and copies all `.py` files, preserving directory structure.
+
+```bash
+snack stash add-remote owner/repo
+snack stash add-remote https://github.com/owner/repo
+snack stash add-remote owner/repo --subdir auth   # only copy files under auth/
+snack stash add-remote owner/repo --force         # overwrite without prompting
+```
+
+---
+
+## Error handling
+
+| Situation | Behaviour |
+|---|---|
+| No stash configured | Error with setup instructions |
+| Stash path doesn't exist | Error with the attempted path |
+| Snippet not found in stash | Error — use `snack list` or `snack search` |
+| Source file not found | Error |
+| Destination file already exists | Prompt to confirm, or skip with `--force` |
+| Named stash already exists | Error |
+| Move target already exists | Error |
+| GitHub repo not found (HTTP 404) | Error with status code |
+
+---
+
+## Project structure
+
+```
+python-snacks/
+├── pyproject.toml
+├── snacks/
+│   ├── main.py      # Typer app, all command definitions
+│   ├── config.py    # SnackConfig class, stash path resolution
+│   └── ops.py       # File copy logic (pack, unpack, add_remote)
+└── tests/
+    ├── test_commands.py        # snippet commands
+    └── test_stash_commands.py  # stash management commands
+```
+
+---
+
+## CI / CD
+
+- **CI:** Tests run on every push and PR to `main` across Python 3.10, 3.11, and 3.12.
+- **Publish:** Push a `v*` tag to trigger a build, PyPI publish, and GitHub Release.
+
+```bash
+git tag v0.2.0 && git push origin v0.2.0
+```

python_snacks-0.1.2/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "python-snacks"
+version = "0.1.2"
+description = "A CLI tool for managing a personal stash of reusable Python code snippets."
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "typer[all]>=0.9",
+]
+
+[project.scripts]
+snack = "snacks.main:app"
+
+[project.optional-dependencies]
+test = ["pytest>=8"]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["snacks*"]

python_snacks-0.1.2/python_snacks.egg-info/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.4
+Name: python-snacks
+Version: 0.1.2
+Summary: A CLI tool for managing a personal stash of reusable Python code snippets.
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer[all]>=0.9
+Provides-Extra: test
+Requires-Dist: pytest>=8; extra == "test"
+Dynamic: license-file
+
+# Snack Stash
+
+A personal CLI tool for managing a local stash of reusable Python code snippets. Browse, copy, and curate snippets across projects with a single command.
+
+```bash
+pipx install snack-stash
+snack stash create default ~/snack-stash
+snack unpack auth/google_oauth.py
+```
+
+---
+
+## Installation
+
+**Recommended (pipx):**
+```bash
+pipx install snack-stash
+```
+
+**Alternative (pip):**
+```bash
+pip install snack-stash
+```
+
+Requires Python 3.10+.
+
+---
+
+## Configuration
+
+### First-time setup
+
+Create a stash directory and register it:
+
+```bash
+snack stash create default ~/snack-stash
+```
+
+This creates `~/snack-stash`, writes `~/.snackstashrc`, and sets `default` as the active stash.
+
+### Environment variable (overrides config file)
+
+```bash
+export SNACK_STASH=~/snack-stash
+```
+
+Add to `~/.zshrc` or `~/.bashrc` to make it permanent. Takes priority over everything else.
+
+### Config file (`~/.snackstashrc`)
+
+Created automatically by `snack stash create`. You can also edit it by hand:
+
+```ini
+[config]
+active = default
+
+[stash.default]
+path = ~/snack-stash
+
+[stash.work]
+path = ~/work-stash
+```
+
+**Priority order:** `SNACK_STASH` env var → `~/.snackstashrc` active stash → error.
+
+---
+
+## Stash structure
+
+A stash is a plain directory of `.py` files, organized into subdirectories by category:
+
+```
+~/snack-stash/
+├── auth/
+│   ├── google_oauth_fastapi.py
+│   ├── google_oauth_flask.py
+│   └── jwt_helpers.py
+├── forms/
+│   ├── contact_form.py
+│   └── newsletter_signup.py
+└── email/
+    └── smtp_sender.py
+```
+
+You can manage the directory with Git, Dropbox, or any sync tool independently of this CLI.
+
+---
+
+## Commands
+
+### `snack list [category]`
+
+List all snippets in the active stash.
+
+```bash
+snack list           # all snippets
+snack list auth      # filtered by category (subdirectory)
+```
+
+### `snack search <keyword>`
+
+Search snippet filenames for a keyword (case-insensitive).
+
+```bash
+snack search oauth
+# auth/google_oauth_fastapi.py
+# auth/google_oauth_flask.py
+```
+
+### `snack unpack <snippet>`
+
+Copy a snippet **from the stash** into the current working directory.
+
+```bash
+snack unpack auth/google_oauth_fastapi.py
+# → ./auth/google_oauth_fastapi.py
+
+snack unpack auth/google_oauth_fastapi.py --flat
+# → ./google_oauth_fastapi.py  (no subdirectory)
+
+snack unpack auth/google_oauth_fastapi.py --force
+# Overwrites without prompting
+```
+
+### `snack pack <snippet>`
+
+Copy a file **from the current directory** back into the stash. Use this when you've improved a snippet on a project and want to update the canonical version.
+
+```bash
+snack pack auth/google_oauth_fastapi.py
+snack pack auth/google_oauth_fastapi.py --force
+```
+
+---
+
+## Stash management
+
+### `snack stash create <name> <path>`
+
+Register a new named stash. Creates the directory if it doesn't exist.
+
+```bash
+snack stash create default ~/snack-stash
+snack stash create work ~/work-stash --no-activate
+```
+
+The first stash created is automatically set as active. Use `--no-activate` to add a stash without switching to it.
+
+### `snack stash list`
+
+Show all configured stashes and which one is active.
+
+```bash
+snack stash list
+#   default  /Users/you/snack-stash  ← active
+#   work     /Users/you/work-stash
+```
+
+### `snack stash move <name> <new-path>`
+
+Move a stash to a new location. Moves the directory on disk and updates the config.
+
+```bash
+snack stash move default ~/new-location/snack-stash
+```
+
+### `snack stash add-remote <repo>`
+
+Copy Python snippets from a public GitHub repository into the active stash. Downloads the repo as a tarball and copies all `.py` files, preserving directory structure.
+
+```bash
+snack stash add-remote owner/repo
+snack stash add-remote https://github.com/owner/repo
+snack stash add-remote owner/repo --subdir auth   # only copy files under auth/
+snack stash add-remote owner/repo --force         # overwrite without prompting
+```
+
+---
+
+## Error handling
+
+| Situation | Behaviour |
+|---|---|
+| No stash configured | Error with setup instructions |
+| Stash path doesn't exist | Error with the attempted path |
+| Snippet not found in stash | Error — use `snack list` or `snack search` |
+| Source file not found | Error |
+| Destination file already exists | Prompt to confirm, or skip with `--force` |
+| Named stash already exists | Error |
+| Move target already exists | Error |
+| GitHub repo not found (HTTP 404) | Error with status code |
+
+---
+
+## Project structure
+
+```
+python-snacks/
+├── pyproject.toml
+├── snacks/
+│   ├── main.py      # Typer app, all command definitions
+│   ├── config.py    # SnackConfig class, stash path resolution
+│   └── ops.py       # File copy logic (pack, unpack, add_remote)
+└── tests/
+    ├── test_commands.py        # snippet commands
+    └── test_stash_commands.py  # stash management commands
+```
+
+---
+
+## CI / CD
+
+- **CI:** Tests run on every push and PR to `main` across Python 3.10, 3.11, and 3.12.
+- **Publish:** Push a `v*` tag to trigger a build, PyPI publish, and GitHub Release.
+
+```bash
+git tag v0.2.0 && git push origin v0.2.0
+```