Tafara EdgeBook

Log your edge, sharpen your game

A trading journal and analytics platform for tracking and improving trading performance. This tool helps traders analyze their MT4 trading statements and upload the data to a Google Sheets webapp for further analysis.

Features

• Parse MT4 HTML statement files
• Extract trade details including entry/exit points, profit/loss, and trade metadata
• Automatic upload to Google Sheets for analysis
• Comprehensive error handling and logging
• Production-grade code structure with tests

Setup

1. Create a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

2. Install dependencies:

pip install -r requirements.txt

3. Set up environment variables:

• WEBAPP_URL: URL of your Google Sheets webapp
• MT4_STATEMENT: Path to your MT4 HTML statement file (default: Statement.htm)

Usage

python src/app.py

Development

• Run tests: pytest tests/
• Check code style: flake8 src/ tests/
• Generate coverage report: pytest tests/ --cov=src/

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

License

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