pybiwenger 1.3.0

A python package to interact with the Soccer Fantasy Game Biwenger

pybiwenger

pybiwenger is a Python library for interacting with the Biwenger Soccer Fantasy Game API. It provides convenient access to your account, league, market, and player data, enabling automation and analysis for Biwenger users.

---

Features

• Authentication: Secure login using your Biwenger credentials.
• Account Management: Access your user, team, and league information.
• Players API: Retrieve player data, rosters, and historical stats.
• Market API: Get current market data for players.
• League API: Fetch league users and standings.

---

Installation

Clone the repository:

git clone https://github.com/pablominue/pybiwenger.git
cd pybiwenger
pip install .

Or install via pip:

pip install pybiwenger

---

Authentication

Before using any API, authenticate with your Biwenger credentials:

import pybiwenger

pybiwenger.authenticate(
    username="your_biwenger_email",
    password="your_biwenger_password"
)

Your credentials are stored securely in your local environment variables.

---

Quickstart Example

from pybiwenger.src.client import BiwengerBaseClient
from pybiwenger.src.biwenger.players import PlayersAPI
from pybiwenger.src.biwenger.market import MarketAPI
from pybiwenger.src.biwenger.league import LeagueAPI

# Authenticate first (see above)

# Access account info
client = BiwengerBaseClient()
print("Your team:", client.user_team)

# Get all players in the league
players_api = PlayersAPI()
all_players = players_api.get_all_players()
print("Total players:", len(all_players))

# Get your roster
my_team = players_api.get_user_roster(client.user.id)
print("My roster:", my_team.players)

# Get market data
market_api = MarketAPI()
market = market_api.get_market_data()
print("Market players:", market)

# Get league users and standings
league_api = LeagueAPI()
users = league_api.get_users()
standings = league_api.get_classification()
print("League standings:")
for standing in standings:
    print(f"{standing.position}. {standing.name} - {standing.points} pts")

---

API Reference

pybiwenger.src.client.BiwengerBaseClient

• Handles authentication, session management, and basic API requests.
• Properties:
  • user_league: Your league info.
  • user: Your user info.
  • user_team: Your team (owner + players).
• Methods:
  • fetch(url: str): Fetch data from Biwenger API.

pybiwenger.src.biwenger.players.PlayersAPI

• Inherits from BiwengerBaseClient.
• Methods:
  • get_all_players(): Returns all players in the competition.
  • get_league_users(): Returns all users in your league.
  • get_user_roster(owner_id: int): Returns a user's team.
  • get_rosters_by_owner(): Returns all teams in the league.
  • get_player_history(player, ...): Returns historical points and price for a player.

pybiwenger.src.biwenger.market.MarketAPI

• Inherits from BiwengerBaseClient.
• Methods:
  • get_market_data(): Returns current market data for players.

pybiwenger.src.biwenger.league.LeagueAPI

• Inherits from BiwengerBaseClient.
• Methods:
  • get_users(): Returns all users in the league.
  • get_classification(): Returns current league standings.

---

Contributing

Pull requests and issues are welcome! Please open an issue for bugs or feature requests.

---

License

MIT License. See LICENSE for details.

---

Disclaimer

This library is not affiliated with Biwenger or its parent companies. Use at your own risk and respect Biwenger's terms of