Using ruby '2.7.0' and 'rails', '~> 5.2.8'

This project is a company's test for ruby middle level developer job, the project uses rails 5.2.x and postgres 16. The project uses IBGE api for populate the database, and shows cities based on 2 search filters fields (state acronym and city name).

Clone the project and run the command below (if your machine has docker and docker compose installed):

sudo docker-compose build
sudo docker-compose up

If your machine doesn't have Docker installed you can follow the steps below (you will need to install postgres and set it up):

sudo -u postgres psql
CREATE ROLE filipe WITH LOGIN SUPERUSER PASSWORD '1234';
rails db:create db:migrate db:seed

In your browser's url field write the url below and type enter:

http://localhost:3000/

Success!!

You can also run the test suite inside the project directory running on terminal:

to test the search method...

rspec spec/controllers/cities_controller_spec.rb

to test the routing...

rspec spec/routing/cities_routing_spec.rb