django-hotel

The Task

Installation

This app runs in a Docker environment. Docker Compose is used to manage two containers: Django/Web and PostgreSQL instances.

If necessary, install Docker and Docker Compose.

Clone the code from this github repository.

git clone https://github.com/hillscottc/django-hotel

From inside the django-hotel dir,
```
docker-compose up
```
(Some docker daemons run other than localhost...like '127.0.0.1' or '0.0.0.0'...depends on the system.)
docker-compose run web python manage.py migrate to init the db.
Create an admin account.
```
docker-compose run web python manage.py createsuperuser
```
- The db is managed with Django's admin interface at http://localhost:8000/admin

Functionality

Basic functionality is provided by the Django REST framework
The system utility httpie is used for these examples.

We can control the format of the response by adding a format suffix:

http http://localhost:8000/api/hotels.json  # JSON suffix
http http://localhost:8000/api/hotels.api   # Browsable API suffix

Browse the API in a web browser, by visiting http://localhost:8000/hotels/

Testing

Run the automated unit tests with python manage.py test
Additional endpoint testing with httpie:

http http://localhost:8000/api/hotels/
http http://localhost:8000/api/hotels/1/
http http://localhost:8000/api/hotels/1.json

# Create a Hotel
http --json POST http://localhost:8000/api/hotels/ name='Hotel 1' num_rooms=10 res_buffer=2

# Update a hotel
http --json PUT http://localhost:8000/api/hotels/0/ name='Hotel 1' num_rooms=5 res_buffer=1

# Create a Reservation. 
http --json POST http://localhost:8000/api/reservations/ hotel=0 client_name='Jackson' start_date='2020-02-05' end_date='2020-02-06'