# TheChart Scripts Directory

This directory contains testing and utility scripts for TheChart application.

## Scripts Overview

### Testing Scripts

#### `run_tests.py`
Main test runner for the application.
```bash
cd /home/will/Code/thechart
.venv/bin/python scripts/run_tests.py
```

#### `integration_test.py`
Comprehensive integration test for the export system.
- Tests all export formats (JSON, XML, PDF)
- Validates data integrity and file creation
- No GUI dependencies - safe for automated testing

```bash
cd /home/will/Code/thechart
.venv/bin/python scripts/integration_test.py
```

### Feature Testing Scripts

#### `test_note_saving.py`
Tests note saving and retrieval functionality.
- Validates note persistence in CSV files
- Tests special characters and formatting

#### `test_update_entry.py`
Tests entry update functionality.
- Validates data modification operations
- Tests date validation and duplicate handling

## Usage

All scripts should be run from the project root directory:

```bash
cd /home/will/Code/thechart
.venv/bin/python scripts/<script_name>.py
```

## Test Data

- Integration tests create temporary export files in `integration_test_exports/` (auto-cleaned)
- Test scripts use the main `thechart_data.csv` file unless specified otherwise
- No test data is committed to the repository

## Development

When adding new scripts:
1. Place them in this directory
2. Use the standard shebang: `#!/usr/bin/env python3`
3. Add proper docstrings and error handling
4. Update this README with script documentation
5. Follow the project's linting and formatting standards