Metadata-Version: 2.4
Name: surfreport
Version: 0.1.0
Summary: Get the surf report in your terminal
Author: jtabke
License: MIT
Project-URL: homepage, https://github.com/jtabke/surfreport
Project-URL: repository, https://github.com/jtabke/surfreport
Keywords: surf,surf report,weather,ocean
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Provides-Extra: dev
Requires-Dist: ruff; extra == "dev"
Requires-Dist: pyright; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Provides-Extra: build
Requires-Dist: build; extra == "build"
Requires-Dist: twine; extra == "build"
Requires-Dist: commitizen; extra == "build"
Dynamic: license-file

                  #+:::::++           ++:::::++           ++:::::++
                +-:=++++++++        +::+++++++++        +-:-++++++++
              :+::++++*     +     #=:+++++=     +     *+::++++      #
             +::++++++           +:-++++++           +::++++++
            +:++++++++*        ++:++++++++*        *+:=+++++++
          ++++++++++++++*    ++:++++++++++++:    ++-++++++++++++     .
        +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
       :+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
         ++++++           #++++++++++*       ++++++++#        #+++*

---

# surfreport

[![Tests](https://github.com/jtabke/surfreport/actions/workflows/tests.yml/badge.svg)](https://github.com/jtabke/surfreport/actions/workflows/tests.yml)

`surfreport` is a Python package that allows you to retrieve surf reports directly from the terminal. It fetches data from surf report APIs, providing a command-line interface (CLI) for easy access to current and forecasted surf conditions.

## Installation

### Using pip

```sh
pip install surfreport
```

### Using uv

```sh
uv pip install surfreport
```

### From source

1. Clone this repository:

```sh
git clone https://github.com/jtabke/surfreport.git
cd surfreport
```

2. Install dependencies with `uv`:

```sh
uv sync
```

or with `pip`:

```sh
pip install .
```

## [Contributing](./CONTRIBUTING.md)

## Usage

### Quick run with uvx

Run `surfreport` without installing by using `uvx`:

```sh
uvx surfreport
```

Or with search option:

```sh
uvx surfreport -s <spot query>
```

### Standard usage

Run `surfreport` to access a menu of all regions. Selecting a subregion or spot will display an overview and surf report if available.

### Search for a spot

```sh
surfreport -s <spot query>
```

Replace `<spot query>` with the surf spot you with to get the forecast for. If there are multiple matches it will ask you to choose appropriate match.

## Roadmap

- **CLI Enhancements**: Currently, the focus is on building out the CLI usage and adding more data sources to ensure comprehensive surf report retrieval.
- **TUI Development**: Future developments may include a Text User Interface (TUI) for visual representation of surf conditions.
