vicken-ghoubiguian/go_weather_go

A simple golang client to use the OpenWeatherMap API

Go_weather_go

Contents

1. Presentation

2. Prerequisites to run the utility on machine host

3. Prerequisites to run the utility with Docker

4. How run the utility on machine host

5. How run the utility with Docker

Presentation

This is a project to develop a golang utility to get weather datas using the OpenWeatherMap API.

Here is the datas returned:

• name of the whished city and its country code,

• coordinates (longitude and latitude),

• main weather,

• weather description,

• current temperature,

• feeling temperature,

• maximum expected temperature,

• minimum expected temperature,

• sunrise time,

• sunset time,

• atmospheric pressure,

• UV index (value and risk),

• humidity,

• wind (speed and direction).

To use it, you must have an Openweathermap's API key.

To get it, all are explained here.

Prerequisites to run the utility on machine host

You must install Go language on your machine.

To do this, you can consult the official documentation here.

Or you can install it by executing this command if you're on Debian or Ubuntu distribution:

sudo apt install golang-go

Well done. It's your turn to play now...

Prerequisites to run the utility with Docker

First, you must install Docker on your machine.

To do this, you can consult the official documentation here.

Or Or you can install it by executing this command if you're on Debian or Ubuntu distribution:

sudo apt install docker.io

Well done. It's your turn to play now...

How run the utility on machine host ?

To run this utility, you can execute this commands:

go build go_weather_go.go

./go_weather_go -city=<wished_city_name> -apiKey=<OpenWeatherMap_API_key> -tempScale=<wished_temperature_scale>

or this single one:

go run go_weather_go.go -city=<wished_city_name> -apiKey=<OpenWeatherMap_API_key> -tempScale=<wished_temperature_scale>

How run the utility with Docker

To run this utility with Docker, you can build the Docker image from Dockerfile or you can pull the official Docker image on Docker Hub.

If you choose the last option, you can get the offical Docker image is here.

Now if you choose to build the Docker image from Dockerfile, follow these instructions in the order:

git clone https://gitlab.imerir.com/eric.ghoubiguian/go_weather_go # Clone the project from gitlab

cd go_weather_go # Change current folder for the project's one

docker image build -t go_weather_go . # Build the Docker image using Dockerfile

Now you are ready...

You can run the utility in Docker executing this command:

docker container run -it go_weather_go -city=<wished_city> -apiKey=<wished_api_key> -tempScale=<wished_temperature_scale>

Now let's go...