Metadata-Version: 2.4
Name: weathora
Version: 0.0.1
Summary: A Python CLI tool to fetch live weather data using OpenWeather API
Author: Ishan Bhat
Author-email: ishan2003bhat@gmail.com
Keywords: weather cli python-cli
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: requests
Requires-Dist: rich
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Provides-Extra: dev
Requires-Dist: build; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: twine; extra == "dev"
Provides-Extra: all
Requires-Dist: pytest; extra == "all"
Requires-Dist: pytest-cov; extra == "all"
Requires-Dist: build; extra == "all"
Requires-Dist: pre-commit; extra == "all"
Requires-Dist: ruff; extra == "all"
Requires-Dist: twine; extra == "all"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: keywords
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Weathora <!-- omit in toc -->

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

## Table of Contents <!-- omit in toc -->

- [Installation](#installation)
  - [Create and activate a virtual environment:](#create-and-activate-a-virtual-environment)
- [Setup API Key 🔑](#setup-api-key-)
  - [Step 1: Create an Account](#step-1-create-an-account)
  - [Step 2: Get Your API Key](#step-2-get-your-api-key)
  - [Step 3: Store the API Key](#step-3-store-the-api-key)
    - [🔹 PowerShell](#-powershell)
    - [🔹Bash](#bash)
- [Usage](#usage)
  - [Command Line Usage](#command-line-usage)

---

## Installation

-   Clone the repository:

    ```bash
    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](https://docs.python.org/3/library/venv.html):

    ```bash
    python3 -m venv .venv
    ```

-   **Activate:**

    -   **Windows (PowerShell):**

        ```bash
        .venv\Scripts\activate
        ```

    -   **Linux/Mac (Bash):**

        ```bash
        source .venv/bin/activate
        ```

-   **Deactivate:**

    ```bash
    deactivate
    ```

-   **Install the package:**

    ```bash
    pip install .
    ```

-   **For development (editable mode):**

    ```bash
    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](https://home.openweathermap.org/).
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

```powershell
$Env:OPENWEATHER_API_KEY = "YOUR_SECRET_KEY"
```

#### 🔹Bash

```bash
export OPENWEATHER_API_KEY="YOUR_SECRET_KEY"
```

## Usage

### Command Line Usage

-   Following commands should be entered to get weather information.

    ```powershell
    weathora --city "Delhi"
    weathora --city "London"
    weathora --city "Jammu"
    ```
