Table of Contents
Bring a Jacket is a road trip planning application that will allow users to see the current weather as well as the forecasted weather at the destination. This project was made as part of the Module 3 curriculum for the Turing School of Software and Design. This version is currently only the backend of the project.
The learning goals of this project are as follows:
- Expose an API that aggregates data from multiple external APIs
- Expose an API that requires an authentication token
- Expose an API for CRUD functionality
- Determine completion criteria based on the needs of other developers
- Test both API consumption and exposure, making use of at least one mocking tool (VCR, Webmock, etc).
This project uses the following technology stack:
- Ruby 3.1.1
- Rails 7.0.4
- PostgreSQL as the database for Active Record
- Puma web server
- bcrypt for password security
- Faraday for making HTTP requests
- Bootsnap for caching to reduce boot times
- Figaro for managing application configuration
- JSON API Serializer for generating JSON responses
Additionally, the project uses several gems for development and testing, such as Capybara, RSpec, Faker, and Shoulda Matchers.
To get a local copy up and running follow these simple example steps.
This is an example of how to list things you need to use the software and how to install them. You must have the following software installed on your system:
- Clone the repo
git clone [email protected]:brad-dunlap/bring_a_jacket.git
- Install dependencies
bundle install
- Configure the database by running rails db:setup:
rails db:setup
- Start the server by running rails server:
rails server
- Visit http://localhost:3000 in your web browser to confirm that the app is running or use an application such as Postman to make your API calls to check the appropriate responses.
Users:
See the open issues for a full list of proposed features (and known issues).
Weather Requests
Registration Requests
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
Bradley Dunlap
Github: brad-dunlap
- Mike Dao and Abdul Redd (instructor team)