0x02. AirBnB clone - MySQL

Description

Web application that simulates some of the features of Airbnb for academic purposes.

In this moment we are the third part "MySQL storage"

Components diagram

Database UML

https://github.com/kael1706/AirBnB_clone/blob/master/assets/uml.jpg

Prerequisites 📋

64-bit system , Ubuntu Install MySQLdb module version 1.3.x

$ sudo apt-get install python3-dev
$ sudo apt-get install libmysqlclient-dev
$ sudo apt-get install zlib1g-dev
$ sudo pip3 install mysqlclient==1.3.10
...
$ python3
>>> import MySQLdb
>>> MySQLdb.__version__ 
'1.3.10'

Install SQLAlchemy module version 1.2.x

$ pip3 install SQLAlchemy==1.2.5
...
$ python3
>>> import sqlalchemy
>>> sqlalchemy.__version__ 
'1.2.5'

Objectives

Console

Create your data model
Manage (create, update, destroy, etc) objects via a console / command interpreter
Store and persist objects to a file (JSON file)

Web Static

learn HTML/CSS
create the HTML of your application
create template of each objec

MySQL storage

replace the file storage by a Database storage
map your models to a table in database by using an O.R.M.

Web framework - templating

create your first web server in Python
make your static HTML file dynamic by using objects stored in a file or database

RESTful API

expose all your objects stored via a JSON web interface
manipulate your objects via a RESTful API

Web dynamic

learn JQuery
load objects from the client side by using your own RESTful API

Console

The first piece is to manipulate a powerful storage system. This storage engine will give us an abstraction between “My object” and “How they are stored and persisted”. This means: from your console code (the command interpreter itself) and from the front-end and RestAPI you will build later, you won’t have to pay attention (take care) of how your objects are stored.

We can also use DBStorage to handle the information using a relational database like mysql. In this case we map our models into tables for the database using an ORM.

How to start the console?

./console.py

How to use the console with FileStorage?

Start the console
Write the desired command with its respective syntax

Available classes: BaseModel, User, Place, State, City, Amenity and Review

Command	Syntax	Description
help	`help`	print commands
create	`create <class>`	create a object
show	`show <class> <id>`	show an specific object
destroy	`destroy <class> <id>`	destroy an specific object
all	`all <class>`	show all objects by class
all	`all`	show all objects
update	`update <class> <id> <attr_name> <new_value>`	update an object with the new values
create	`create <class> <key name>=<value>`	create a object with arguments
other way...

Command	Syntax	Description
all	`<class name>.all()`	show all objects by class
count	`<class name>.count()`	a counter of specific class
show	`<class name>.show(<id>)`	show an specific object
destroy	`<class name>.destroy(<id>)`	destroy an specific object
update	`<class name>.update(<id>, <attribute name>, <attribute value>)`	update an object with the new values

Press the enter button

Examples:

(hbnb) create User
(hbnb) show User fce12f8a
(hbnb) destroy User fce12f8a
(hbnb) all User
(hbnb) all
(hbnb) update User name holberton
(hbnb) User.all()
(hbnb) User.count()
(hbnb) User.show(246c227a)
(hbnb) User.destroy(246c227a)
(hbnb) User.update(38f22813-2753-4d42-b37c-57a17f1e4f88, "first_name", "John")
(hbnb) create User name="Hugo"
(hbnb) create User edad=20

How to use the console with DBStorage?

Set up sufficient permissions to the respective database. You could try running the files: setup_mysql_dev.sql and setup_mysql_test.sql. You can also adapt it to your own database.
Dont start the console only write the command in the prompt
Write the desired command with its respective

echo 'create State name="California"' | HBNB_MYSQL_USER=hbnb_dev HBNB_MYSQL_PWD=hbnb_dev_pwd HBNB_MYSQL_HOST=localhost HBNB_MYSQL_DB=hbnb_dev_db HBNB_TYPE_STORAGE=db ./console.py

Available classes: BaseModel, User, Place, State, City, Amenity and Review

echo '<filestorage command>' | HBNB_MYSQL_USER=<username> HBNB_MYSQL_PWD=<database_password> HBNB_MYSQL_HOST=<iphost> HBNB_MYSQL_DB=<name_database> HBNB_TYPE_STORAGE=db ./console.py

Examples:

echo 'create State name="California"' | HBNB_MYSQL_USER=hbnb_dev HBNB_MYSQL_PWD=hbnb_dev_pwd HBNB_MYSQL_HOST=localhost HBNB_MYSQL_DB=hbnb_dev_db HBNB_TYPE_STORAGE=db ./console.py