Weathora

A simple Python CLI tool to fetch live weather data from any city using the OpenWeather API.

Table of Contents

• Installation
  • Create and activate a virtual environment:
• Setup API Key 🔑
  • Step 1: Create an Account
  • Step 2: Get Your API Key
  • Step 3: Store the API Key
    • 🔹 PowerShell
    • 🔹Bash
• Usage
  • Command Line Usage

Installation

• From pip

  pip install weathora
  

• Clone the repository:

  git clone https://github.com/bhatishan2003/weathora
  cd weathora
  

Create and activate a virtual environment:

1. Create a Virtual Environment [Optional, but recommended]

   Run the following command to create a virtual environment:

   python3 -m venv .venv
   

• Activate:

  • Windows (PowerShell):

    .venv\Scripts\activate
    

  • Linux/Mac (Bash):

    source .venv/bin/activate
    

• Deactivate:

  deactivate
  

• Install the package:

  pip install .
  

• For development (editable mode):

  pip install -e .
  

Setup API Key 🔑

To use this project, you’ll need an API key from OpenWeather.

Step 1: Create an Account

1. Go to OpenWeather API.
2. Sign up (or log in if you already have an account).

Step 2: Get Your API Key

1. Navigate to your API Keys section in the OpenWeather dashboard.
2. Copy your API Key.

Step 3: Store the API Key

Depending on your shell, use one of the following commands:

🔹 PowerShell

$Env:OPENWEATHER_API_KEY = "YOUR_SECRET_KEY"

🔹Bash

export OPENWEATHER_API_KEY="YOUR_SECRET_KEY"

Usage

Command Line Usage

• Following commands should be entered to get weather information.

  weathora --city "Delhi"
  weathora --city "London"
  weathora --city "Jammu"