Welcome to the TIM EVENTS API project! This API provides endpoints for managing events and related entities such as speakers.
To get started with the TIM EVENTS API, follow the instructions below to set up the project locally.
-
Clone the repository:
git clone https://github.com/ezeisraeljohn/tim-events-api.git cd tim-events-api -
Set up a virtual environment:
python -m venv .venv source .venv/bin/activate # On Windows use `.venv\Scripts\activate`
-
Install the dependencies:
pip install -r requirements.txt
-
Configure the database:
Ensure you have a PostgreSQL or MySQL database set up. Update the database settings in the
database.pyfile.DATABASE_URL = "postgresql://username:password@localhost/dbname"
-
Apply the migrations:
alembic upgrade head
-
Run the server:
uvicorn main:app --reload
Once the server is running, you can interact with the API using tools like Postman or curl.
You can test the API endpoints using Postman. Import the collection directly using the following link:
For detailed API documentation, visit the Swagger UI or the ReDoc endpoints provided by FastAPI.
We welcome contributions! Please follow these steps:
- Fork the repository.
- Create a new branch:
git checkout -b my-feature-branch. - Make your changes.
- Commit your changes:
git commit -m 'Add some feature'. - Push to the branch:
git push origin my-feature-branch. - Create a pull request.
This project is licensed under the MIT License. See the LICENSE file for details.