RUNNING.md

Running the Email Deleter

After the refactoring, the application requires dependencies to be installed. You have several options:

Option 1: Using the convenience script (Easiest)

./run.sh

This automatically activates the virtual environment and runs the application.

Option 2: Activate virtual environment manually

# Activate the virtual environment
source venv/bin/activate

# Run the application
python email_deleter.py

# When done, deactivate
deactivate

Option 3: Run directly with venv Python

./venv/bin/python email_deleter.py

First-Time Setup

If the venv directory doesn't exist, set it up first:

# Create virtual environment
python3 -m venv venv

# Activate it
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Now run the application
python email_deleter.py

Troubleshooting

"ModuleNotFoundError: No module named 'rich'"

This means you're running with system Python instead of the virtual environment.

Solution: Use one of the options above that activate the virtual environment.

"venv directory not found"

Run the first-time setup instructions above.

Dependencies out of date

source venv/bin/activate
pip install --upgrade -r requirements.txt

Why Virtual Environment?

The virtual environment keeps project dependencies isolated from your system Python. This prevents version conflicts and makes the project portable.

For Production/System-wide Installation

If you want to install system-wide (not recommended):

pip install --user -r requirements.txt
python email_deleter.py

Note: This may conflict with other Python projects on your system.