/calender-stats

Analyze calendar (.ics file) data

Primary LanguagePython

Calendar Stats

This project analyzes calendar data to compute statistics such as total time spent on specific events, and export event details to CSV files.

Installation

  1. Clone the repository: 
    git clone <repository-url>
cd calendar_stats
  2. Install dependencies using Poetry: 
    poetry install
  3. Create a .env file in the root directory with the following content: 
    CALENDAR_URL=<your-calendar-url>

Usage

Run the main script to download the calendar data, process events, and generate statistics:

poetry run calendar_stats

Output:

  • Console Logging: Logs are generated in the console with event details and total time spent.
  • Data Files: CSV files are generated in directory data with detailed event information.

Project Structure

.
├── README.md               # This file
├── calendar_stats
│   ├── __init__.py
│   ├── constants.py        # Defines constants like TARGET_EVENT_GROUP_NAME
│   ├── main.py             # Main script to process calendar events
│   └── utils.py            # Utility functions for file handling, logging, and datetime operations
├── data
│   ├── (gitignored) Work_till_2024-07-05 03:06.csv   # Exported CSV file with work event details
│   ├── (gitignored) Work_till_2024-07-05 03:06.txt   # Logging file for work event group
│   ├── (gitignored) calendar.ics        # Downloaded calendar file
│   └── (gitignored) debug_2024-07-05 03:06.log      # Debug logging file
├── .env                    # Calendar URL should be stored here
├── poetry.lock
└── pyproject.toml          # Poetry configuration file