Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/ericmbouwe/musclecars-api

An API that provides muscle cars appointment trials. It provides an admin namespace to manage the API internal endpoints. Built with Rails 6, a Postgresql database and Rspec
https://github.com/ericmbouwe/musclecars-api

Last synced: about 19 hours ago
JSON representation

An API that provides muscle cars appointment trials. It provides an admin namespace to manage the API internal endpoints. Built with Rails 6, a Postgresql database and Rspec

Awesome Lists containing this project

README

        

# Muscle Cars API

This API is the Backend of [Muscle Cars app](https://github.com/ericmbouwe/musclecars-app).

![screenshot](./public/musclecarsERD.png)

## Live Demo

Please connect your app by using [this URL](https://musclecars-api.herokuapp.com/)

## Documentation
Please check [the detailed documentation.]() `In progress...`

## Built With

- Ruby on Rails
- RSpec
- Postgresql

## Getting Started

To get a local copy up and running follow these simple example steps.

### Prerequisites

Make sure Node.js is running on your local machine.

## Setup

- Clone this repository
- Open terminal
- Change directory by using `cd musclecars-api`
- Run `bundle install`
- [Setup Postgresql](https://www.howtoforge.com/tutorial/ruby-on-rails-ror-with-postgresql-on-ubuntu-16-04/#step-setting-up-the-postgresql-database-for-rails-development). If you have any problem, please check [this answer](https://serverfault.com/a/248162)

### Usage

- Run `rails server` or` rails s -p port_number` to run it in another port
- Open a browser and go to http://localhost:3000

## Test app

- Clone this repository
- Open terminal
- Change directory by using `cd musclecars-api`
- Run `bundle install`
- [Setup Postgresql](https://www.howtoforge.com/tutorial/ruby-on-rails-ror-with-postgresql-on-ubuntu-16-04/#step-setting-up-the-postgresql-database-for-rails-development). If you have any problem, please check [this answer](https://serverfault.com/a/248162)

### Default: Run all spec files (i.e., those matching spec/**/*_spec.rb)
`$ bundle exec rspec`

### Run all spec files in a single directory (recursively)
`$ bundle exec rspec spec/models`

### Run a single spec file
`$ bundle exec rspec spec/controllers/names_controller_spec.rb`

## Generate model serializers
` rails g serializer model_name `

## Get routes in the browser
` http://localhost:3000/rails/info/routes `

## Clear the server PID file
` kill -9 $(lsof -i tcp:3000 -t) `

## Generate fake password
` BCrypt::Password.create('azerty') `

## Seed the database
` heroku run rails db:seed `

It will create 2 users you can log in with
### email | password
- Admin: [email protected] | azerty
- User: [email protected] | azerty

# Authors

Contact me at one of the following addresses!

👤 **Eric Mbouwe**

- Website: [ericmbouwe.com](https://ericmbouwe.netlify.app/)
- LinkedIn: [Eric Mbouwe](https://www.linkedin.com/in/ericmbouwe/)
- Github: [@ericmbouwe](https://github.com/ericmbouwe)
- Twitter: [@ericmbouwe](https://twitter.com/ericmbouwe)
- Mail: [[email protected]](mailto:[email protected])

## 🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](https://github.com/ericmbouwe/musclecars-api/issues).

## Show your support

Give a ⭐️ if you like this project!

## Acknowledgments

- [Microverse Inc](https://www.microverse.org/)