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

https://github.com/devvspaces/hng-calendar-app

Calendar app for team Gear. Will contain ORM and API Documentation.
https://github.com/devvspaces/hng-calendar-app

Last synced: 11 months ago
JSON representation

Calendar app for team Gear. Will contain ORM and API Documentation.

Awesome Lists containing this project

README

          



Project logo

Team Gear Calendar App

[![Status](https://img.shields.io/badge/status-active-success.svg)]()
[![GitHub Issues](https://img.shields.io/github/issues/kylelobo/The-Documentation-Compendium.svg)](https://github.com/kylelobo/The-Documentation-Compendium/issues)
[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/kylelobo/The-Documentation-Compendium.svg)](https://github.com/kylelobo/The-Documentation-Compendium/pulls)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](/LICENSE)

---

Few lines describing your project.


## 📝 Table of Contents

- [About](#about)
- [Getting Started](#getting_started)
- [Deployment](#deployment)
- [Usage](#usage)
- [Built Using](#built_using)
- [TODO](../TODO.md)
- [Contributing](../CONTRIBUTING.md)
- [Team](#authors)
- [Acknowledgments](#acknowledgement)

## 🧐 About

Calendar app for team Gear

## 🏁 Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See [deployment](#deployment) for notes on how to deploy the project on a live system.

### Prerequisites

What things you need to install the software and how to install them.

1. Install [Python](https://www.python.org/downloads/)

### Installing

A step by step series of examples that tell you how to get a development env running.

Setup virtual Enviroment

```
python -m venv venv
```

Activate virtual enviroment

Windows

```
venv\Scripts\activate
```

Linux

```
source venv/bin/activate
```

Install dependencies

```bash
pip install -r requirements.txt
```

## 🔧 Running the tests

Explain how to run the automated tests for this system.

### Break down into end to end tests

Explain what these tests test and why

```
Give an example
```

### And coding style tests

This is using flake8 to check for coding style

```bash
flake8
```

## 🎈 Usage

Running fastapi server

```bash
uvicorn main:app --reload
```

Check the swagger docs at `http://localhost:8000/docs`

## 🚀 Deployment

Add additional notes about how to deploy this on a live system.

## ⛏️ Built Using

- [FastAPI](https://fastapi.tiangolo.com/) - FastAPI framework, high performance, easy to learn, fast to code, ready for production
- [SQLAlchemy](https://www.sqlalchemy.org/) - ORM (Object Relational Mapper)

## ✍️ Team

- [@devvspaces](https://github.com/devvspaces) - Team Member

## 🎉 Acknowledgements

- HNG Internship