Dswell

A daemon-based file deletion utility that allows you to schedule files or directories for deletion after a specified time period.

Why did I create this?

• I often end up writing temporary scripts and then forgetting to delete them, so they clutter my workspace.

What does it do?

• It automatically removes files after a specified age—you just pass the duration in hours, minutes, and seconds (for example, 1h30m3s), and it deletes the file after the specified time period.

dswell
Usage: dswell [OPTIONS] COMMAND [ARGS]...

  dswell - Delayed file deletion utility

Options:
  --help  Show this message and exit.

Commands:
  create  Create a file or directory and schedule it for deletion.
  list    List all pending file/directory deletions.

Installation

# Install from source
git clone https://github.com/Agent-Hellboy/dswell.git
cd dswell
pip install -e .

# Or install directly from PyPI (current source is not updated)
pip install dswell

Usage

Create a file or directory that will be automatically deleted after a specified time:

# Create a file that will be deleted after 1 hour
dswell create --file test.txt --time 1h

# Create a directory that will be deleted after 30 minutes
dswell create --dir test_dir --time 30m

Time format supports:

• Hours (h)
• Minutes (m)
• Seconds (s)

Development

Setup Development Environment

# Clone the repository
git clone https://github.com/Agent-Hellboy/dswell.git
cd dswell

# Install development dependencies
pip install -e ".[dev]"

# Install pre-commit hooks
pre-commit install

Running Tests

# Run all tests
python -m pytest tests/

# Run tests with coverage
python -m pytest tests/ --cov=src/dswell

Code Quality

The project uses several tools to maintain code quality:

• black: Code formatting
• ruff: Linting
• isort: Import sorting
• pytest: Testing

Run all checks:

tox

Or run individual checks:

tox -e black  # Run black
tox -e ruff   # Run ruff
tox -e isort  # Run isort

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Author

Prince Roshan - princekrroshan01@gmail.com