Express-Sweater-Weather

Sweater Weather written in JavaScript/Express instead of Ruby on Rails. This is a weather app using JavaScript, built on NodeJS with the Express framework. Sequelize is used for an ORM. This project is a Mod 4 assignment from the Turing School of Software and Design. Assignment details are available in the @turingschool curriculum repository.

Stars
0
View Code on GitHub
Ecosystems: JavaScript

Express Sweater Weather

By Deonte Cooper

Deployed on Heroku at: https://express-sweater-weather0312.herokuapp.com/

This solo project is a remake of a Ruby on Rails project called Sweater Weather: https://github.com/djc00p/sweater-weather

EndpointsExample Endpoints

GET /api/v1/forecast?location=denver,co
POST /api/v1/[email protected]&password=PASSWORD&password_confirmation=PASSWORD
POST /api/v1/sessions?user[email][email protected]&user[password]=PASSWORD
POST /api/v1/favorites?api_key=USER_API_KEY&location=Denver,%20CO
GET /api/v1/favorites?api_key=USER_API_KEY
DELETE /api/v1/favorites?api_key=USER_API_KEY&location=Denver,%20CO

A weather app using JavaScript, built on NodeJS with the Express framework. Sequelize is used for an ORM.

This project is a Mod 4 assignment from the Turing School of Software and Design. Assignment details are available in the @turingschool curriculum repository.

Setup

From the project root, run:

  • npm install
  • npx sequelize db:create
  • npx sequelize db:migrate
  • npx sequelize db:seed

To start the API server, run npm start, then access endpoints as described below. Default port on localhost is 3000.

Learning Goals

  • Create an Express API given specified endpoints and response formats.
  • Create RESTful API Routes in JavaScript.

Endpoints

Express Sweater Weather
Account Creation
Login
Forecast
Favoriting Location
Favorites List
Favorite Removed

Account Creation

Provide a valid email, password, and password confirmation. The user will then be provided an api_key for use of the app.

Request
POST /api/v1/users
Body
{
  "email": "[email protected]",
  "password": "password",
  "password_confirmation": "password"
}
Successful Response
HTTP/1.1 201 Created
Body
{
  "api_key": "jgn983hy48thw9begh98h4539h4"
}
Other
HTTP/1.1 500 Internal Server Error
Body
{"error": "Internal Server Error"}

Login

Given the email and password of an existing user should return that users api_key.

Request
POST /api/v1/sessions
Body
{
  "email": "[email protected]",
  "password": "password"
}
Successful Response
HTTP/1.1 200 OK
Body
{
  "api_key": "jgn983hy48thw9begh98h4539h4"
}
Other

There are no other anticipated failure states. A failure for any other reason is unexpected and will follow the below format.

HTTP/1.1 500 Internal Server Error
Body
{"error": "Internal Server Error"}

Forecast

API key must be sent If no API key or an incorrect key is provided returns 401 (Unauthorized)

Request
GET /api/v1/forecast?location=denver,co
Body
{
  "api_key": "jgn983hy48thw9begh98h4539h4"
}
Successful Response
HTTP/1.1 200 OK
Body

The Body should include 7 or more hourly and daily objects.

{
  "location": "Denver, C0",
  "currently": {
      "summary": "Overcast",
      "icon": "cloudy",
      "precipIntensity": 0,
      "precipProbability": 0,
      "temperature": 54.91,
      "humidity": 0.65,
      "pressure": 1020.51,
      "windSpeed": 11.91,
      "windGust": 23.39,
      "windBearing": 294,
      "cloudCover": 1,
      "visibility": 9.12,
    },
  "hourly": {
    "summary": "Partly cloudy throughout the day and breezy this evening.",
    "icon": "wind",
    "data": [
      {
      "time": 1555016400,
      "summary": "Overcast",
      "icon": "cloudy",
      "precipIntensity": 0,
      "precipProbability": 0,
      "temperature": 54.9,
      "humidity": 0.65,
      "pressure": 1020.8,
      "windSpeed": 11.3,
      "windGust": 22.64,
      "windBearing": 293,
      "cloudCover": 1,
      "visibility": 9.02,
      },
    ]
  },
  "daily": {
    "summary": "No precipitation throughout the week, with high temperatures bottoming out at 58°F on Monday.",
    "icon": "clear-day",
    "data": [
      {
        "time": 1554966000,
        "summary": "Partly cloudy throughout the day and breezy in the evening.",
        "icon": "wind",
        "sunriseTime": 1554990063,
        "sunsetTime": 1555036947,
        "precipIntensity": 0.0001,
        "precipIntensityMax": 0.0011,
        "precipIntensityMaxTime": 1555045200,
        "precipProbability": 0.11,
        "precipType": "rain",
        "temperatureHigh": 57.07,
        "temperatureLow": 51.47,
        "humidity": 0.66,
        "pressure": 1020.5,
        "windSpeed": 10.94,
        "windGust": 33.93,
        "cloudCover": 0.38,
        "visibility": 9.51,
        "temperatureMin": 53.49,
        "temperatureMax": 58.44,
      },
    ]
  }
}
Unable to find forecast without api_key
HTTP/1.1 401 Unauthorized
Body
{"message": "Unauthorized User"}
Other

There are no other anticipated failure states. A failure for any other reason is unexpected and will follow the below format.

HTTP/1.1 500 Internal Server Error
Body
{"error": "Internal Server Error"}

Favoriting Location

API key must be sent If no API key or an incorrect key is provided returns 401 (Unauthorized)

Request
POST /api/v1/favorites
Body
{
  "location": "Denver, CO",
  "api_key": "jgn983hy48thw9begh98h4539h4"
}
Successful Response
HTTP/1.1 200 OK
Body
{
  "message": "Denver, CO has been added to your favorites"
}
Unable to find forecast without api_key
HTTP/1.1 401 Unauthorized
Body
{"message": "Unauthorized User"}
Other

There are no other anticipated failure states. A failure for any other reason is unexpected and will follow the below format.

HTTP/1.1 500 Internal Server Error
Body
{"error": "Internal Server Error"}

Favorites List

API key must be sent If no API key or an incorrect key is provided returns 401 (Unauthorized) Returns each favorite city plus Current weather of that city.

Request
GET /api/v1/favorites
Body
{
  "api_key": "jgn983hy48thw9begh98h4539h4"
}
Successful Response
HTTP/1.1 200 OK
Body
[
  {
    "location": "Denver, CO",
    "current_weather": {
      "summary": "Overcast",
      "icon": "cloudy",
      "precipIntensity": 0,
      "precipProbability": 0,
      "temperature": 54.91,
      "humidity": 0.65,
      "pressure": 1020.51,
      "windSpeed": 11.91,
      "windGust": 23.39,
      "windBearing": 294,
      "cloudCover": 1,
      "visibility": 9.12,
    },
    "location": "Golden, CO",
    "current_weather": {
      "summary": "Sunny",
      "icon": "sunny",
      "precipIntensity": 0,
      "precipProbability": 0,
      "temperature": 71.00,
      "humidity": 0.50,
      "pressure": 1015.10,
      "windSpeed": 10.16,
      "windGust": 13.40,
      "windBearing": 200,
      "cloudCover": 0,
      "visibility": 8.11,
    }
  }
]
Unable to find forecast without api_key
HTTP/1.1 401 Unauthorized
Body
{"message": "Unauthorized User"}
Other

There are no other anticipated failure states. A failure for any other reason is unexpected and will follow the below format.

HTTP/1.1 500 Internal Server Error
Body
{"error": "Internal Server Error"}

Favorite Removed

API key must be sent If no API key or an incorrect key is provided returns 401 (Unauthorized)

Request
DELETE /api/v1/favorites
Body
{
  "location": "Denver, CO",
  "api_key": "jgn983hy48thw9begh98h4539h4"
}
Successful Response
HTTP/1.1 204 No Content
Unable to find forecast without api_key
HTTP/1.1 401 Unauthorized
Body
{"message": "Unauthorized User"}
Other

There are no other anticipated failure states. A failure for any other reason is unexpected and will follow the below format.

HTTP/1.1 500 Internal Server Error
Body
{"error": "Internal Server Error"}
Related Projects
weyder-package

A basic weather package that utilizes darksky and mapbox api ...

02 Aug 2019 10
fuzzy-weather

A Node module for retrieving a "fuzzy" weather forecast (words, not data) using Forecast.io

03 Sep 2016 8
unifonic-next-gen-lib

## Introduction Send SMS messages using Unifonic Messaging API. Get your dedicated Universal num...

18 Jul 2021 0
noaa-forecasts

A Promised-based library for fetching forecast data from NOAA

25 Jun 2015 6
kaiseki

A Parse.com REST API Client for Node.js

26 Apr 2012 223