reclaimed 0.1.2__tar.gz

reclaimed-0.1.2/.gitignore

@@ -0,0 +1,82 @@
+.aider*
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Editor directories and files
+.idea/
+.vscode/
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# Textual specific
+*.log
+*.sqlite
+
+# macOS
+.DS_Store
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Black
+.blackd
+
+# Hatch
+.hatch/

reclaimed-0.1.2/CONTRIBUTING.md

@@ -0,0 +1,112 @@
+# Contributing to Reclaim
+
+Thank you for your interest in contributing to Reclaim! This document provides guidelines and instructions for contributing.
+
+## Development Setup
+
+1. Fork and clone the repository:
+   ```bash
+   git clone https://github.com/yourusername/reclaim.git
+   cd reclaim
+   ```
+
+2. Install dependencies:
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+3. Create a development environment:
+   ```bash
+   hatch shell
+   ```
+
+## Development Workflow
+
+1. Create a new branch for your feature:
+   ```bash
+   git checkout -b feature-name
+   ```
+
+2. Make your changes and ensure all tests pass:
+   ```bash
+   hatch run test
+   ```
+
+3. Run the full test suite with coverage:
+   ```bash
+   hatch run test-cov
+   ```
+
+4. Run linting checks:
+   ```bash
+   hatch run lint
+   ```
+
+5. Commit your changes:
+   ```bash
+   git add .
+   git commit -m "Description of changes"
+   ```
+
+6. Push to your fork:
+   ```bash
+   git push origin feature-name
+   ```
+
+7. Open a Pull Request
+
+## Code Style
+
+- We use Black for code formatting
+- Ruff for linting
+- MyPy for type checking
+- All code must be type-annotated
+- Maximum line length is 100 characters
+- Follow PEP 8 guidelines
+
+## Testing
+
+- Write tests for all new features
+- Maintain or improve code coverage
+- Tests should be clear and meaningful
+- Use pytest fixtures when appropriate
+
+## Commit Messages
+
+- Use clear, descriptive commit messages
+- Start with a verb in the present tense
+- Keep the first line under 50 characters
+- Add details in the commit body if needed
+
+## Pull Requests
+
+- Reference any related issues
+- Include a clear description of changes
+- Update documentation if needed
+- Ensure all checks pass
+- Keep changes focused and atomic
+
+## Release Process
+
+Releases are automated through GitHub Actions when tags are pushed:
+
+1. Ensure all tests pass on main
+2. Tag the release:
+   ```bash
+   git tag -a v0.1.0 -m "Release v0.1.0"
+   ```
+3. Push tags:
+   ```bash
+   git push --tags
+   ```
+
+The GitHub Action will automatically:
+- Run all tests
+- Build the package
+- Publish to PyPI
+
+## Questions?
+
+Feel free to open an issue for any questions or concerns.
+
+Thank you for contributing to Reclaim! 🌟

reclaimed-0.1.2/LICENSE

@@ -0,0 +1,29 @@
+MIT License
+
+<<<<<<< HEAD
+Copyright (c) 2024 Your Name
+=======
+Copyright (c) 2025 Taylor Wilsdon
+>>>>>>> 949812349e7e407e382e45959969bb3abdba5af4
+
+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:
+
+<<<<<<< HEAD
+The above copyright notice and permission notice shall be included in all
+=======
+The above copyright notice and this permission notice shall be included in all
+>>>>>>> 949812349e7e407e382e45959969bb3abdba5af4
+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.

reclaimed-0.1.2/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: reclaimed
+Version: 0.1.2
+Summary: A powerful disk usage analyzer with iCloud support
+Project-URL: Homepage, https://github.com/taylorwilsdon/reclaimed
+Project-URL: Repository, https://github.com/taylorwilsdon/reclaimed.git
+Project-URL: Issues, https://github.com/taylorwilsdon/reclaimed/issues
+Author-email: Taylor Wilsdon <taylor@taylorwilsdon.com>
+License: MIT License
+        
+        <<<<<<< HEAD
+        Copyright (c) 2024 Your Name
+        =======
+        Copyright (c) 2025 Taylor Wilsdon
+        >>>>>>> 949812349e7e407e382e45959969bb3abdba5af4
+        
+        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:
+        
+        <<<<<<< HEAD
+        The above copyright notice and permission notice shall be included in all
+        =======
+        The above copyright notice and this permission notice shall be included in all
+        >>>>>>> 949812349e7e407e382e45959969bb3abdba5af4
+        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.
+License-File: LICENSE
+Keywords: analyzer,cli,disk,icloud,storage
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX :: Linux
+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: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Requires-Dist: click>=8.0.0
+Requires-Dist: rich>=10.0.0
+Requires-Dist: textual>=0.10.0
+Description-Content-Type: text/markdown
+
+# reclaimed 🌟
+
+A powerful and user-friendly command-line tool for analyzing disk usage, with special handling for iCloud storage on macOS. Quickly find your largest files and directories with a beautiful, color-coded interface. I let aider write the README.md boilerplate and it's all accurate but I'm still not sure how we feel about the emojis... it seems Claude is a colorful gentleman when writing markdown.
+
+![Disk Scanner Demo](demo.gif)
+
+<img width="898" alt="image" src="https://github.com/user-attachments/assets/b8c87581-978b-46e4-bf8b-d9e9b2cd5f9b" />
+
+## Features
+
+- 🚀 Fast recursive directory scanning, legitimately performant and batches progress updates efficently 
+- ☁️ Smart detection of iCloud vs local storage which is nice on the macbook
+- 📊 She pretty (it utilizes the [Textualize/rich](https://github.com/Textualize/rich) library for fancy CLI stylings)
+- 💾 Export results to JSON for further analysis or batch operations
+- ⚡️ Real-time progress indication actually great
+- 🛡️ Graceful handling of permission issues, doesn't freeze like the old diskinventoryx
+
+## Installation
+
+### Prerequisites
+
+- Python 3.8 or higher
+- pip (Python package installer)
+- Technically not a venv but if you aren't using a venv you're generally doing python wrong
+
+### Using pip
+
+```bash
+pip install reclaimed
+```
+
+### From Source
+
+```bash
+git clone https://github.com/taylorwilsdon/reclaimed.git
+cd reclaimed
+pip install -r requirements.txt
+hatch shell
+```
+
+## Usage
+
+Basic usage:
+```bash
+reclaimed ~/Documents
+```
+
+Advanced options:
+```bash
+# Show more results
+reclaimed ~/Documents --files 20 --dirs 15
+
+# Save results to JSON
+reclaimed ~/Documents --output results.json
+```
+
+### Options
+
+- `PATH`: Directory to scan (default: current directory)
+- `-f, --files N`: Number of largest files to show (default: 10)
+- `-d, --dirs N`: Number of largest directories to show (default: 10)
+- `-o, --output FILE`: Save results to JSON file
+
+## Output
+
+The tool provides:
+- A real-time progress indicator showing files scanned and total size
+- Two tables showing the largest files and directories
+- Clear indication of iCloud vs local storage
+- Summary of any access issues encountered
+
+## Development
+
+This project uses [Hatch](https://hatch.pypa.io/) for development workflow management.
+
+### Setup Development Environment
+
+```bash
+pip install -r requirements.txt
+hatch shell
+```
+
+### Common Commands
+
+```bash
+# Run tests
+hatch run test
+
+# Run tests with coverage
+hatch run test-cov
+
+# Run linting (black, ruff, mypy)
+hatch run lint
+
+# Build distribution packages
+hatch build
+```
+
+## Contributing
+
+Contributions are welcome! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

reclaimed-0.1.2/README.md

@@ -0,0 +1,105 @@
+# reclaimed 🌟
+
+A powerful and user-friendly command-line tool for analyzing disk usage, with special handling for iCloud storage on macOS. Quickly find your largest files and directories with a beautiful, color-coded interface. I let aider write the README.md boilerplate and it's all accurate but I'm still not sure how we feel about the emojis... it seems Claude is a colorful gentleman when writing markdown.
+
+![Disk Scanner Demo](demo.gif)
+
+<img width="898" alt="image" src="https://github.com/user-attachments/assets/b8c87581-978b-46e4-bf8b-d9e9b2cd5f9b" />
+
+## Features
+
+- 🚀 Fast recursive directory scanning, legitimately performant and batches progress updates efficently 
+- ☁️ Smart detection of iCloud vs local storage which is nice on the macbook
+- 📊 She pretty (it utilizes the [Textualize/rich](https://github.com/Textualize/rich) library for fancy CLI stylings)
+- 💾 Export results to JSON for further analysis or batch operations
+- ⚡️ Real-time progress indication actually great
+- 🛡️ Graceful handling of permission issues, doesn't freeze like the old diskinventoryx
+
+## Installation
+
+### Prerequisites
+
+- Python 3.8 or higher
+- pip (Python package installer)
+- Technically not a venv but if you aren't using a venv you're generally doing python wrong
+
+### Using pip
+
+```bash
+pip install reclaimed
+```
+
+### From Source
+
+```bash
+git clone https://github.com/taylorwilsdon/reclaimed.git
+cd reclaimed
+pip install -r requirements.txt
+hatch shell
+```
+
+## Usage
+
+Basic usage:
+```bash
+reclaimed ~/Documents
+```
+
+Advanced options:
+```bash
+# Show more results
+reclaimed ~/Documents --files 20 --dirs 15
+
+# Save results to JSON
+reclaimed ~/Documents --output results.json
+```
+
+### Options
+
+- `PATH`: Directory to scan (default: current directory)
+- `-f, --files N`: Number of largest files to show (default: 10)
+- `-d, --dirs N`: Number of largest directories to show (default: 10)
+- `-o, --output FILE`: Save results to JSON file
+
+## Output
+
+The tool provides:
+- A real-time progress indicator showing files scanned and total size
+- Two tables showing the largest files and directories
+- Clear indication of iCloud vs local storage
+- Summary of any access issues encountered
+
+## Development
+
+This project uses [Hatch](https://hatch.pypa.io/) for development workflow management.
+
+### Setup Development Environment
+
+```bash
+pip install -r requirements.txt
+hatch shell
+```
+
+### Common Commands
+
+```bash
+# Run tests
+hatch run test
+
+# Run tests with coverage
+hatch run test-cov
+
+# Run linting (black, ruff, mypy)
+hatch run lint
+
+# Build distribution packages
+hatch build
+```
+
+## Contributing
+
+Contributions are welcome! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.