b2-cleanup 0.1.0__py3-none-any.whl → 0.1.3__py3-none-any.whl

b2_cleanup-0.1.3.dist-info/METADATA

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: b2-cleanup
+Version: 0.1.3
+Summary: CLI tool to clean up unfinished Backblaze B2 large uploads
+Author-email: Jeroen Verhoeven <jeroen@joentje.org>
+License: MIT
+Project-URL: Homepage, https://github.com/your-username/b2-cleanup
+Project-URL: Issues, https://github.com/your-username/b2-cleanup/issues
+Keywords: backblaze,b2,cli,cloud-storage,cleanup
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: b2sdk>=1.20.0
+
+# b2-cleanup
+
+🧹 A Python CLI tool to clean up **unfinished large file uploads** in a [Backblaze B2](https://www.backblaze.com/b2/cloud-storage.html) bucket.
+
+Built using [`b2sdk`](https://github.com/Backblaze/b2-sdk-python), [`click`](https://click.palletsprojects.com/), and [`uv`](https://github.com/astral-sh/uv) for performance and reproducibility.
+
+---
+
+## 🔧 Features
+
+- Lists all unfinished large file uploads in a given B2 bucket
+- Optionally cancels them (dry-run support included)
+- Uses the official `b2sdk` for native Backblaze API access
+- Supports authentication via env vars, CLI override, or the `b2` CLI
+- Clean CLI with logging support
+- Class-based and easily extensible
+
+---
+
+## 🚀 Installation
+
+### 1. Clone and create an isolated environment
+
+```bash
+git clone https://github.com/<your-username>/b2-cleanup.git
+cd b2-cleanup
+
+uv venv
+source .venv/bin/activate
+uv pip install -e .
+```
+
+> Requires [uv](https://github.com/astral-sh/uv) and Python 3.8+
+
+---
+
+## 🧪 Usage
+
+```bash
+b2-cleanup BUCKET_NAME [OPTIONS]
+```
+
+### Example (dry run):
+
+```bash
+b2-cleanup my-bucket --dry-run
+```
+
+### Example (delete for real, with logging):
+
+```bash
+b2-cleanup my-bucket --log-file cleanup_$(date +%F).log
+```
+
+### Example (override credentials):
+
+```bash
+b2-cleanup my-bucket --key-id my-key-id --key my-app-key
+```
+
+---
+
+## 🔐 Authentication
+
+This tool supports three ways to authenticate with B2, in priority order:
+
+1. **Explicit CLI arguments**:
+   ```bash
+   b2-cleanup my-bucket --key-id abc123 --key supersecretkey
+   ```
+
+2. **Environment variables**:
+   ```bash
+   export B2_APPLICATION_KEY_ID=abc123
+   export B2_APPLICATION_KEY=supersecretkey
+   ```
+
+3. **The `b2` CLI** (must be previously authorized):
+   ```bash
+   b2 account authorize
+   # Then the tool will read credentials via:
+   b2 account info
+   ```
+
+---
+
+## 📁 Project Structure
+
+```
+b2-cleanup/
+├── cleanup_unfinished_b2_uploads.py   # Core CLI logic (class-based)
+├── pyproject.toml                     # Project metadata + dependencies
+├── .gitignore
+└── README.md
+```
+
+---
+
+## 📦 Packaging Notes
+
+- The CLI entry point is `b2-cleanup` via `pyproject.toml`
+- Install in editable mode (`uv pip install -e .`) for fast development
+- Dependencies are managed via [`uv`](https://github.com/astral-sh/uv)
+
+---
+
+## 🛠️ Roadmap
+
+- [ ] Filter uploads by file age
+- [ ] Support multiple buckets
+- [ ] Output metrics (count, size, cost saved)
+- [ ] Optional integration with S3-compatible B2 APIs
+
+---
+
+## 📝 License
+
+MIT License © 2025 Jeroen Verhoeven
+

b2_cleanup-0.1.3.dist-info/RECORD

@@ -0,0 +1,6 @@
+cleanup_unfinished_b2_uploads.py,sha256=_wShubS02qNxiRdJmuNSoLzcjd7epcB3Q_fU1CDpH_Q,3877
+b2_cleanup-0.1.3.dist-info/METADATA,sha256=Q4FYPDetwgRQE8GEXZw4H0H0gdX6oKnZakGieaFtWOw,3490
+b2_cleanup-0.1.3.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
+b2_cleanup-0.1.3.dist-info/entry_points.txt,sha256=hRMR8HC39r-P1TrTPYbH3hDQkBVvDb508tOUS8a0CcI,65
+b2_cleanup-0.1.3.dist-info/top_level.txt,sha256=GmKi68dORi-iv2h2sT5Uf7Q3udlX1mElQQg50cqqF6o,30
+b2_cleanup-0.1.3.dist-info/RECORD,,

{b2_cleanup-0.1.0.dist-info → b2_cleanup-0.1.3.dist-info}/WHEEL

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

b2_cleanup-0.1.0.dist-info/METADATA

@@ -1,7 +0,0 @@
-Metadata-Version: 2.4
-Name: b2-cleanup
-Version: 0.1.0
-Summary: Cleanup unfinished Backblaze B2 large uploads
-Author-email: Jeroen Verhoeven <jeroen@joentje.org>
-Requires-Dist: click>=8.0
-Requires-Dist: b2sdk>=2.8.1

b2_cleanup-0.1.0.dist-info/RECORD

@@ -1,6 +0,0 @@
-cleanup_unfinished_b2_uploads.py,sha256=_wShubS02qNxiRdJmuNSoLzcjd7epcB3Q_fU1CDpH_Q,3877
-b2_cleanup-0.1.0.dist-info/METADATA,sha256=kHW0eHyzVtwFoYT9WNbG5g2HKJ6bESQ7YnXD4wLN1XY,215
-b2_cleanup-0.1.0.dist-info/WHEEL,sha256=ooBFpIzZCPdw3uqIQsOo4qqbA4ZRPxHnOH7peeONza0,91
-b2_cleanup-0.1.0.dist-info/entry_points.txt,sha256=hRMR8HC39r-P1TrTPYbH3hDQkBVvDb508tOUS8a0CcI,65
-b2_cleanup-0.1.0.dist-info/top_level.txt,sha256=GmKi68dORi-iv2h2sT5Uf7Q3udlX1mElQQg50cqqF6o,30
-b2_cleanup-0.1.0.dist-info/RECORD,,