This project offers an interface to interact with the Calendarific API, enabling users to access a wide range of holiday data from countries around the world. It is designed for simplicity and flexibility, perfect for those interested in integrating global holiday information into their applications or analyses.
Before you begin, ensure you have met the following requirements:
- You have a Calendarific account. If not, you can create one at Calendarific.
To use this project, you need to obtain credentials from Calendarific:
- Sign up or log in at the Calendarific API page.
- Navigate to the API section to generate your API key.
- Copy your API key for use in this project.
Create a .env
file in your project's root directory and add your Calendarific API key:
Replace your_api_key
with your actual API key.
- Clone the repository:
git clone https://github.com/yourusername/autonomousAJ_calendarificAPI.git
- Navigate to the project directory:
cd autonomousAJ_calendarificAPI
- Install dependencies:
pip install -r requirements.txt
Run the main script from the command line to interact with the Calendarific API:
python main.py
Follow the prompts to access holiday data for different countries and years.
- Access comprehensive holiday data for numerous countries
- Retrieve holiday information for specific years
- Explore various cultural and public holidays globally
- Modular and extendable codebase
Contributions are welcome! Please read our Contributing Guidelines for more information on how to contribute.
This project is licensed under the MIT License - see the LICENSE file for details.
Thanks to Calendarific for providing the API and documentation that made this project possible. Special thanks as well to the Python community for their support and resources in developing this project.