Open Weather SDK in Node.js

Introduction

Open Weather SDK is used to work with famous weather forecaster Open Weather features using Node.js, TypeScript. The package provides method(s) to get weather condition by city name.

This page presents the installation, basic usage and examples with different type of modes.

Used technologies:

Contents

• Installation
• Configuration
• Modes
• Redis Store
• Testing purposes

Installation

• npm - npm install @shodlik_shomuratov/openweather-sdk
• yarn - yarn add @shodlik_shomuratov/openweather-sdk
• pnpm - pnpm add @shodlik_shomuratov/openweather-sdk

Configuration

1. Obtain your API_KEY from OpenWeather to use package properly!
2. Instantiate SDK client and pass it to KameleoonProvider

1import SDK from "@shodlik_shomuratov/openweather-sdk";
2
3const sdk = new SDK("your_api_key");
4
5async function outputWeather() {
6	const weatherData = await sdk.getCurrentWeather("Tashkent");
7	console.log(weatherData);
8}
9
10outputWeather();

Modes

1. Default mode. In this mode you every time call the getCurrentWeather() method SDK makes a new request.

1import SDK from "@shodlik_shomuratov/openweather-sdk";
2
3cosnt sdk = new SDK("your_api_key", {
4    mode: "default"
5});
6
7async function outputWeather () {
8    const weatherData = await sdk.getCurrentWeather("Tashkent");
9    console.log(weatherData);
10}
11
12outputWeather();

2. Polling mode. In polling mode in order to maintenance zero latency response, you get data from stored weather data and SDK makes a new request for you every 10 minutes.

1import SDK from "@shodlik_shomuratov/openweather-sdk";
2
3cosnt sdk = new SDK("your_api_key", {
4    mode: "polling"
5});
6
7async function outputWeather () {
8    const weatherData = await sdk.getCurrentWeather("Tashkent");
9    console.log(weatherData);
10}
11
12outputWeather();

Redis Store

If you want you can save updated weather data in your redis store. Only thing you have to do is give SDK redis options in the redis field.

1import SDK from "@shodlik_shomuratov/openweather-sdk";
2
3cosnt sdk = new SDK("your_api_key", {
4    mode: "polling",
5    redis: {
6        host: "127.0.0.1", // your redis host
7        port: 6379, // your redis port
8        username: "my_redis_username", // optional, if you have one
9        password: "my_redis_password", // optional, if you have one
10    }
11});
12
13async function outputWeather () {
14    const weatherData = await sdk.getCurrentWeather("Tashkent");
15    console.log(weatherData);
16}
17
18outputWeather();

Testing purposes

1. You have to clone this repository into your local machine and install dependencies

    npm install

2. Change .env.sample into .env and write your credentials in it.

    OPEN_WEATHER_API_KEY=my_api_key

3. Run test command

    npm run test

Created by Shodlik Shomuratov