parent
0a33c069b0
commit
26a355aa19
82
README.md
82
README.md
|
@ -1,56 +1,74 @@
|
||||||
# Personal agenda web app
|
# Personal agenda web app
|
||||||
|
|
||||||
This is a Python script that serves as a personal agenda web app. It provides
|
## Overview
|
||||||
various information and reminders, including financial dates, holidays, market
|
|
||||||
openings, and more. You can run this script to get an overview of important
|
|
||||||
events and data relevant to your schedule and interests.
|
|
||||||
|
|
||||||
## Requirements
|
The Agenda project is a comprehensive tool designed to keep track of various events and important dates, from holiday schedules to waste collection dates. It's an all-in-one solution for staying on top of your personal agenda.
|
||||||
|
|
||||||
|
### Features
|
||||||
|
|
||||||
|
- **Event Management:** Handles various types of events like birthdays, holidays, travel itineraries, conferences, and waste collection schedules.
|
||||||
|
- **Timezone Handling:** Supports conversion and management of events across different time zones.
|
||||||
|
- **Data Sources Integration:** Integrates with various sources like the UK and US holiday calendars, waste collection schedules, and space launch information.
|
||||||
|
- **Custom Event Scheduling:** Allows defining custom recurring events using RRULE strings.
|
||||||
|
- **Dashboard View:** Provides a web interface to display all upcoming events in an organized manner.
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
### Prerequisites
|
||||||
|
|
||||||
- Python 3
|
- Python 3
|
||||||
- Required Python modules (install them using pip):
|
- Flask
|
||||||
- dateutil
|
- Other dependencies listed in `requirements.txt`
|
||||||
- exchange_calendars
|
|
||||||
- holidays
|
|
||||||
- pandas
|
|
||||||
- pytz
|
|
||||||
- requests
|
|
||||||
|
|
||||||
## Features
|
### Setup
|
||||||
|
|
||||||
The agenda web app provides the following features and information:
|
1. Clone the repository:
|
||||||
|
```
|
||||||
|
git clone https://git.4angle.com/edward/agenda
|
||||||
|
```
|
||||||
|
2. Navigate to the project directory:
|
||||||
|
```
|
||||||
|
cd agenda
|
||||||
|
```
|
||||||
|
3. Install required Python packages:
|
||||||
|
```
|
||||||
|
pip install -r requirements.txt
|
||||||
|
```
|
||||||
|
|
||||||
- **GBP to USD Exchange Rate**: It fetches the current GBP to USD exchange rate
|
## Configuration
|
||||||
with caching to minimize API calls.
|
|
||||||
|
|
||||||
- **Next Economist Issue**: Shows the date of the next Economist newspaper
|
- Configure the `config` file with the necessary API keys and data directories.
|
||||||
publication.
|
- Personal data such as birthdays, accommodation details, and travel plans should be placed in the specified data directory.
|
||||||
|
|
||||||
- **Next UK Bank Holiday**: Provides the date and title of the next UK bank
|
## Usage
|
||||||
holiday.
|
|
||||||
|
|
||||||
- **Next US Holiday**: Displays the date and title of the next US holiday.
|
To run the web server:
|
||||||
|
|
||||||
- **Next UK General Election and US Presidential Election**: Shows the dates of
|
```bash
|
||||||
the next UK general election and US presidential election.
|
python web_view.py
|
||||||
|
```
|
||||||
|
|
||||||
- **SpaceX Launch Schedule**: Lists upcoming SpaceX launches with details.
|
Access the web interface through a browser at `http://localhost:5000/`.
|
||||||
|
|
||||||
- **Stock Markets Opening/Closing Times**: Provides information about stock
|
### Modules Overview
|
||||||
market opening and closing times for London and the US.
|
|
||||||
|
|
||||||
- **Next Clock Change**: Shows the next time the clocks change for both the UK
|
The project is structured into several modules, each handling a specific aspect of the agenda:
|
||||||
and the US.
|
|
||||||
|
- **Accommodation, Birthday, Calendar, Conference**: Manage specific event types.
|
||||||
|
- **FX, GWR, Economist**: Integrate with external data sources for financial information, railway schedules, and publication dates.
|
||||||
|
- **Sun, TheSpaceDevs, Travel**: Calculate sunrise/sunset times, track space launches, and manage travel plans.
|
||||||
|
- **Waste Schedule, UK Holiday**: Handle waste collection schedules and UK holidays.
|
||||||
|
|
||||||
|
### Data Management
|
||||||
|
The `data.py` script is central to the functioning of the Agenda project. It compiles events from various sources and presents them in a unified format. Edit this file to modify or add new event sources.
|
||||||
|
|
||||||
## Customization
|
## Customization
|
||||||
|
|
||||||
You can customize the script to add or remove features and modify data sources
|
You can customize the script to add or remove features and modify data sources as needed.
|
||||||
as needed.
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
This project is licensed under the MIT License. Feel free to use, modify, and
|
This project is licensed under the MIT License. Feel free to use, modify, and distribute it as per the license terms. See the [LICENSE](LICENSE) file for details.
|
||||||
distribute it as per the license terms. See the [LICENSE](LICENSE) file for details.
|
|
||||||
|
|
||||||
## Contact
|
## Contact
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue