ossnap 0.1.0__tar.gz

ossnap-0.1.0/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: ossnap
+Version: 0.1.0
+Summary: Snapshot and restore your macOS dev environment
+License: MIT
+Project-URL: Homepage, https://github.com/nvt1904/ossnap
+Project-URL: Issues, https://github.com/nvt1904/ossnap/issues
+Keywords: macos,backup,snapshot,developer,ssh,dotenv
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.1
+Requires-Dist: cryptography>=42.0
+Requires-Dist: keyring>=25.0
+Requires-Dist: rich>=13.0
+Requires-Dist: questionary>=2.0
+
+# ossnap
+
+> Snapshot and restore your macOS dev environment in minutes.
+
+ossnap backs up your SSH keys, `.env` files, and git repo list to a **private GitHub repository** — encrypted — and restores everything on a new machine with a single command.
+
+---
+
+## What it does
+
+- **SSH keys** — encrypted and stored securely
+- **.env files** — discovered recursively across all your repos (including monorepos)
+- **Repo list** — re-clones all your git repos on restore
+- **Versioned snapshots** — full history, restore any point in time
+
+Everything sensitive is encrypted with AES before leaving your machine. The password lives in your macOS Keychain.
+
+---
+
+## Requirements
+
+- macOS
+- Python 3.11+
+- [GitHub CLI](https://cli.github.com) (`gh`) — installed automatically if missing
+
+---
+
+## Install
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/nvt1904/ossnap/main/install.sh | bash
+```
+
+Or manually with pipx:
+
+```bash
+pipx install ossnap
+```
+
+---
+
+## Quick start
+
+```bash
+ossnap init        # one-time setup wizard
+ossnap snapshot    # save current state
+ossnap list        # view snapshot history
+ossnap pull        # restore to this or a new machine
+```
+
+Aliases: `i`, `s`, `l`, `p`
+
+```bash
+ossnap s -n "before reinstall"   # named snapshot
+ossnap p --repos-dir ~/code      # restore repos to custom dir
+```
+
+---
+
+## Commands
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `init` | `i` | Interactive setup wizard |
+| `snapshot` | `s` | Save a snapshot to GitHub |
+| `list` | `l` | List all snapshots |
+| `pull` | `p` | Restore from a snapshot |
+
+### `ossnap snapshot`
+
+```
+-n, --name TEXT    Custom snapshot name (default: timestamp)
+-h, --help
+```
+
+### `ossnap pull`
+
+```
+--ssh-dir DIR      Restore SSH keys to a custom directory
+--repos-dir DIR    Clone repos into a custom base directory
+-h, --help
+```
+
+---
+
+## How it works
+
+```
+ossnap snapshot
+└── Clones your private GitHub repo
+    ├── ssh/
+    │   ├── config          (encrypted)
+    │   ├── authorized_keys (encrypted)
+    │   └── keys/
+    │       └── id_ed25519  (encrypted)
+    └── repos/
+        ├── repos.json      (list of all your git repos)
+        └── envs/
+            └── Documents/my-project/
+                └── .env    (encrypted)
+```
+
+Each snapshot is a git commit. History is preserved — roll back to any point.
+
+**Encryption**: AES-256 via [Fernet](https://cryptography.io/en/latest/fernet/), key derived from your password using PBKDF2-HMAC-SHA256 (600,000 iterations). Password stored in macOS Keychain.
+
+---
+
+## Configuration
+
+Config file: `~/.ossnap/config.json`
+
+```json
+{
+  "github_repo_url": "https://github.com/you/your-private-repo",
+  "ssh_dir": "~/.ssh",
+  "scan_dirs": ["~/Documents", "~/Projects"],
+  "env_patterns": [".env", ".env.local", ".env.development", ".env.production"],
+  "exclude_dirs": ["node_modules", ".git", "venv", "__pycache__", ".venv"]
+}
+```
+
+Edit directly or re-run `ossnap init` to reconfigure (existing values are pre-filled).
+
+---
+
+## Uninstall
+
+```bash
+pipx uninstall ossnap
+rm -rf ~/.ossnap
+```
+
+Your snapshot repo on GitHub is unaffected — delete it manually if you want.
+
+---
+
+## License
+
+MIT

ossnap-0.1.0/README.md

@@ -0,0 +1,140 @@
+# ossnap
+
+> Snapshot and restore your macOS dev environment in minutes.
+
+ossnap backs up your SSH keys, `.env` files, and git repo list to a **private GitHub repository** — encrypted — and restores everything on a new machine with a single command.
+
+---
+
+## What it does
+
+- **SSH keys** — encrypted and stored securely
+- **.env files** — discovered recursively across all your repos (including monorepos)
+- **Repo list** — re-clones all your git repos on restore
+- **Versioned snapshots** — full history, restore any point in time
+
+Everything sensitive is encrypted with AES before leaving your machine. The password lives in your macOS Keychain.
+
+---
+
+## Requirements
+
+- macOS
+- Python 3.11+
+- [GitHub CLI](https://cli.github.com) (`gh`) — installed automatically if missing
+
+---
+
+## Install
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/nvt1904/ossnap/main/install.sh | bash
+```
+
+Or manually with pipx:
+
+```bash
+pipx install ossnap
+```
+
+---
+
+## Quick start
+
+```bash
+ossnap init        # one-time setup wizard
+ossnap snapshot    # save current state
+ossnap list        # view snapshot history
+ossnap pull        # restore to this or a new machine
+```
+
+Aliases: `i`, `s`, `l`, `p`
+
+```bash
+ossnap s -n "before reinstall"   # named snapshot
+ossnap p --repos-dir ~/code      # restore repos to custom dir
+```
+
+---
+
+## Commands
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `init` | `i` | Interactive setup wizard |
+| `snapshot` | `s` | Save a snapshot to GitHub |
+| `list` | `l` | List all snapshots |
+| `pull` | `p` | Restore from a snapshot |
+
+### `ossnap snapshot`
+
+```
+-n, --name TEXT    Custom snapshot name (default: timestamp)
+-h, --help
+```
+
+### `ossnap pull`
+
+```
+--ssh-dir DIR      Restore SSH keys to a custom directory
+--repos-dir DIR    Clone repos into a custom base directory
+-h, --help
+```
+
+---
+
+## How it works
+
+```
+ossnap snapshot
+└── Clones your private GitHub repo
+    ├── ssh/
+    │   ├── config          (encrypted)
+    │   ├── authorized_keys (encrypted)
+    │   └── keys/
+    │       └── id_ed25519  (encrypted)
+    └── repos/
+        ├── repos.json      (list of all your git repos)
+        └── envs/
+            └── Documents/my-project/
+                └── .env    (encrypted)
+```
+
+Each snapshot is a git commit. History is preserved — roll back to any point.
+
+**Encryption**: AES-256 via [Fernet](https://cryptography.io/en/latest/fernet/), key derived from your password using PBKDF2-HMAC-SHA256 (600,000 iterations). Password stored in macOS Keychain.
+
+---
+
+## Configuration
+
+Config file: `~/.ossnap/config.json`
+
+```json
+{
+  "github_repo_url": "https://github.com/you/your-private-repo",
+  "ssh_dir": "~/.ssh",
+  "scan_dirs": ["~/Documents", "~/Projects"],
+  "env_patterns": [".env", ".env.local", ".env.development", ".env.production"],
+  "exclude_dirs": ["node_modules", ".git", "venv", "__pycache__", ".venv"]
+}
+```
+
+Edit directly or re-run `ossnap init` to reconfigure (existing values are pre-filled).
+
+---
+
+## Uninstall
+
+```bash
+pipx uninstall ossnap
+rm -rf ~/.ossnap
+```
+
+Your snapshot repo on GitHub is unaffected — delete it manually if you want.
+
+---
+
+## License
+
+MIT

ossnap-0.1.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ossnap"
+version = "0.1.0"
+description = "Snapshot and restore your macOS dev environment"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+keywords = ["macos", "backup", "snapshot", "developer", "ssh", "dotenv"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "click>=8.1",
+    "cryptography>=42.0",
+    "keyring>=25.0",
+    "rich>=13.0",
+    "questionary>=2.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/nvt1904/ossnap"
+Issues = "https://github.com/nvt1904/ossnap/issues"
+
+[project.scripts]
+ossnap = "ossnap.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-dir]
+ossnap = "src/ossnap"

ossnap-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ossnap-0.1.0/src/ossnap/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"