Metadata-Version: 2.4
Name: novabrawlstars
Version: 0.1.5
Summary: Unofficial Python wrapper for the Brawl Stars API.
Home-page: https://github.com/NovaFenice/NovaBrawlStarsAPI
Author: NovaFenice
License: MIT
Keywords: brawl stars,api,python,wrapper
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# NovaBrawlStarsApi

A Python library to easily interact with the Brawl Stars API and fetch player information.

## Features

- Retrieve detailed player information
- Supports multiple player tags
- Easy Python integration
- Secure API key management with .env

## Installation

You can install NovaBrawlStarsApi via pip:

```bash
pip install novabrawlstars
```

Or clone the repo and installation dependencies manually:

```bash
git clone https://github.com/NovaFenice/NovaBrawlStarsApi.git
cd NovaBrawlStarsApi

```

## Usage

### How to get players info

```py
from novabrawlstars.client import NovaBrawlStars
import os
from dotenv import load_dotenv

load_dotenv()

api_bs = os.getenv("api_bs") # Your Brawl Stars API token
tag_p1 = os.getenv("tag_p1") # Brawl Stars Player tag (es. #12345678 or 12345678)

nb = NovaBrawlStars(api_bs) # Initialize the Brawl Stars API client

player_1 = nb.get_player(tag_p1) # Get a Player object from the API
```

### How to get battlelog info

```py
from novabrawlstars.client import NovaBrawlStars
import os
from dotenv import load_dotenv

load_dotenv()

api_bs = os.getenv("api_bs") # Your Brawl Stars API token
tag_p1 = os.getenv("tag_p1") # Brawl Stars Player tag (es. #12345678 or 12345678)

nb = NovaBrawlStars(api_bs) # Initialize the Brawl Stars API client

player_1 = nb.get_battlelog(tag_p1) # Get a BattleLogListType object from the API
```

### How to get club info

```py
from novabrawlstars.client import NovaBrawlStars
import os
from dotenv import load_dotenv

load_dotenv()

api_bs = os.getenv("api_bs") # Your Brawl Stars API token

nb = NovaBrawlStars(api_bs) # Initialize the Brawl Stars API client
player = nb.get_player(os.getenv("tag_p1")) # Get a Player object from the API
club = nb.get_player_club(player.club.tag) # Get a Club object passing the player tag from the API 

# or

club = nb.get_player_club(os.getenv("tag_c1")) # Get a Club object from the API
```

## Notes

- Make sure to replace the player tags and API token.
- Supports both numeric and #-prefixed tags.

## Donate Me 💖

If you like this project and want to support its development, you can donate:

- **PayPal:** [WORKING IN PROGRESS](https://www.paypal.com/)

Every contribution helps me maintain and improve the library! Thank you for your support! 🙏
