Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/skp3214/holidayscheduler


https://github.com/skp3214/holidayscheduler

calendarific-api country-code-api gson-library holiday-scheduler holiday-tracker holidays-api java javaswing maven mysql-database

Last synced: about 1 month ago
JSON representation

Awesome Lists containing this project

README

        

# Holiday Scheduler

Holiday Scheduler is a Java-based application that allows users to view holidays for different countries and years. Users can also filter holidays by month and day of the week. Additionally, the application provides a wishlist feature where users can save and manage their desired holidays.

## Features

- View holidays for different countries and years
- Filter holidays by month and day of the week
- Save desired holidays to a wishlist
- Remove holidays from the wishlist
- User-friendly graphical user interface (GUI)

## Getting Started

To run the Holiday Scheduler application, you will need to have Java Development Kit (JDK) installed on your machine.

1. Clone the repository or download the source code.
2. Open the project in your preferred Integrated Development Environment (IDE).
3. Locate the `Main.java` file in the `org.example` package.
4. Compile and run the `Main.java` file.

## Usage

1. Upon launching the application, you will be presented with the Holiday Scheduler GUI.
2. Select a country from the dropdown menu.
3. Enter the desired year in the "Year" text field.
4. (Optional) Select a month from the dropdown menu to filter holidays by month.
5. (Optional) Select a day of the week from the dropdown menu to filter holidays by day.
6. Click the "Show Holidays" button to fetch and display the holidays based on your selections.
7. To add a holiday to the wishlist, click on the desired holiday in the "ALL HOLIDAYS" list.
8. To remove a holiday from the wishlist, click on the desired holiday in the "WISHED HOLIDAYS" list.

## Dependencies

The Holiday Scheduler application uses the following external libraries:

- MySQL Connector/J: For connecting to a MySQL database to store and retrieve wishlisted holidays.
- Calendarific API: For fetching holiday data based on the user's selections.

Make sure to include these dependencies in your project's classpath or manage them using a build tool like Maven or Gradle.

## Contributing

Contributions to the Holiday Scheduler project are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request.

## Acknowledgments

- The developers of the Calendarific API for providing access to holiday data.
- The MySQL community for the MySQL Connector/J library.
- The Java community for the various libraries and resources used in this project.

## Project Snapshots
![Screenshot (749)](https://github.com/skp3214/HolidayScheduler/assets/95349420/ca721a40-4bad-4c5e-82cd-f9195d6ec942)

![Screenshot (750)](https://github.com/skp3214/HolidayScheduler/assets/95349420/f14bd5d8-4e8f-4412-9401-d844f64614f9)

![Screenshot (751)](https://github.com/skp3214/HolidayScheduler/assets/95349420/c1a8f1cc-6550-4750-b7d4-1c344ed04e2f)

![Screenshot (752)](https://github.com/skp3214/HolidayScheduler/assets/95349420/60a071db-053d-4d68-a100-87e015e8e623)

![Screenshot (753)](https://github.com/skp3214/HolidayScheduler/assets/95349420/2c2bd40a-6d0e-4b1e-b126-99130d4e7775)

![Screenshot (754)](https://github.com/skp3214/HolidayScheduler/assets/95349420/dae568ca-dbfb-40c4-9efe-b894a6286dfc)