https://github.com/kayprogrammer/bidout-auction-v6
A simple bidding API built with FastAPI
https://github.com/kayprogrammer/bidout-auction-v6
docker fastapi pgadmin4 postgresql pydantic pytest python3
Last synced: 7 months ago
JSON representation
A simple bidding API built with FastAPI
- Host: GitHub
- URL: https://github.com/kayprogrammer/bidout-auction-v6
- Owner: kayprogrammer
- Created: 2023-07-06T15:26:17.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-06-18T00:47:38.000Z (over 1 year ago)
- Last Synced: 2024-06-18T01:56:01.442Z (over 1 year ago)
- Topics: docker, fastapi, pgadmin4, postgresql, pydantic, pytest, python3
- Language: Python
- Homepage: https://bidout-fastapi.vercel.app
- Size: 845 KB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# BIDOUT AUCTION V6
#### FASTAPI DOCS: [Documentation](https://fastapi.tiangolo.com/)
#### PG ADMIN: [Documentation](https://pgadmin.org)
#### Swagger: [Documentation](https://swagger.io/docs/)
## How to run locally
* Download this repo or run:
```bash
$ git clone git@github.com:kayprogrammer/bidout-auction-v6.git
```
#### In the root directory:
- Install all dependencies
```bash
$ pip install -r requirements.txt
```
- Create an `.env` file and copy the contents from the `.env.example` to the file and set the respective values. A postgres database can be created with PG ADMIN or psql
- Run Locally
```bash
$ alembic upgrade heads
```
```bash
$ uvicorn app.main:app --debug --reload
```
- Run With Docker
```bash
$ docker-compose up --build -d --remove-orphans
```
OR
```bash
$ make build
```
- Test Coverage
```bash
$ pytest --disable-warnings -vv
```
OR
```bash
$ make test
```
## Docs
#### SWAGGER API Url: [BidOut Docs](https://bidout-fastapi.vercel.app/)
#### POSTMAN API Url: [BidOut Docs](https://bit.ly/bidout-api)
