mirror of
https://github.com/gmbrax/Pilgrim.git
synced 2026-11-09 16:10:17 +00:00
Gustavo Henrique Santos Souza de Miranda
090bbeda1a
- Added `DirectoryManager` utility for consistent directory operations. - Introduced directory name sanitization and uniqueness enforcement for `TravelDiary`. - Updated `TravelDiaryService` with enhanced creation, update, and deletion workflows, including filesystem management. - Improved `PhotoService` to hash files, copy photos to specific diary directories, and manage updates safely. - Refined error handling and cascaded changes across related entities (e.g., `Entry` relationships).
Python_Pilgrim
Overview
Python_Pilgrim is a Python-based travel diary application designed to help users document and manage their travel experiences. The project provides tools for recording trips, organizing travel notes, and storing memories in a structured and accessible format.
Features
- Create and manage travel diaries
- Add, edit, and delete travel entries
- Organize trips by date, location, or theme
- Store photos, notes, and other media
- Export and share travel logs
Requirements
- Python 3.8 or higher
- Linux operating system (tested on Ubuntu 20.04+)
- Visual Studio Code (VSCode) for development (optional but strongly recommended)
- pip (Python package installer)
- Optional: virtualenv for isolated environments
Installation
- Clone the repository:
git clone https://github.com/gmbrax/Pilgrim.git - Navigate to the project directory:
cd Pilgrim - Create a virtual environment and, then, activate it:
python -m venv .venv source .venv/bin/activate - Install the required dependencies:
pip install -r requirements.txt
Usage
To run the main application, execute:
python <???>.py
This will start the Python_Pilgrim application. Follow the on-screen instructions to create and manage your travel diaries.