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

https://github.com/kayprogrammer/bidout-auction-v4

A simple bidding API built with Django rest framework
https://github.com/kayprogrammer/bidout-auction-v4

bidding django django-rest-framework pgadmin4 postgresql

Last synced: 2 months ago
JSON representation

A simple bidding API built with Django rest framework

Awesome Lists containing this project

README

          

# BidOut Auction V4

![alt text](https://github.com/kayprogrammer/bidout-auction-v4/blob/main/display/django.png?raw=true)

#### DJANGO DOCS: [Documentation](https://docs.djangoproject.com/en/4.2/)
#### DJANGO REST FRAMEWORK DOCS: [Documentation](https://www.django-rest-framework.org/)

#### 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-v4.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
$ python manage.py migrate
```
```bash
$ uvicorn bidout_auction_v4.asgi:application --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-drf-api.vercel.app/)
#### POSTMAN API Url: [BidOut Docs](https://bit.ly/bidout-api)
![alt text](https://github.com/kayprogrammer/bidout-auction-v4/blob/main/display/display1.png?raw=true)

![alt text](https://github.com/kayprogrammer/bidout-auction-v4/blob/main/display/display2.png?raw=true)

![alt text](https://github.com/kayprogrammer/bidout-auction-v4/blob/main/display/display3.png?raw=true)

![alt text](https://github.com/kayprogrammer/bidout-auction-v4/blob/main/display/display4.png?raw=true)

![alt text](https://github.com/kayprogrammer/bidout-auction-v4/blob/main/display/display5.png?raw=true)

## ADMIN PAGE
![alt text](https://github.com/kayprogrammer/bidout-auction-v4/blob/main/display/admin.png?raw=true)