Metadata-Version: 2.1
Name: parrygg
Version: 0.1.0
Summary: Python gRPC client for parry.gg API
Author-email: "parry.gg" <contact@parry.gg>
License: MIT License
        
        Copyright (c) 2025 PARRY.GG LLC
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://github.com/parrygg/parrygg-python
Project-URL: Repository, https://github.com/parrygg/parrygg-python
Project-URL: Issues, https://github.com/parrygg/parrygg-python/issues
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
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.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: grpcio>=1.50.0
Requires-Dist: grpcio-tools>=1.50.0
Requires-Dist: protobuf>=4.21.0
Provides-Extra: dev
Requires-Dist: build>=0.10.0; extra == "dev"
Requires-Dist: twine>=4.0.0; extra == "dev"

# parrygg-python

The official Python client library for the parry.gg tournament platform API. This library provides easy access to all parry.gg services using gRPC, allowing you to build applications that interact with tournaments, events, brackets, users, and more.

## Installation

```bash
pip install parrygg
```

## Requirements

- Python 3.7+
- grpcio
- grpcio-tools
- protobuf

## Usage

### Example

For authenticated requests, include your API key in the `X-API-KEY` header:

```python
import grpc
from parrygg.services.tournament_service_pb2_grpc import TournamentServiceStub
from parrygg.services.tournament_service_pb2 import GetTournamentsRequest

# Your API key from parry.gg
API_KEY = "your-api-key-here"

channel = grpc.secure_channel("api.parry.gg:443", grpc.ssl_channel_credentials())

tournament_service = TournamentServiceStub(channel)

metadata = [("x-api-key", API_KEY)]

request = GetTournamentsRequest()
response = tournament_service.GetTournaments(request, metadata=metadata)

print(f"Successfully retrieved {len(response.tournaments)} tournaments")
for tournament in response.tournaments:
    print(f"- {tournament.name} (ID: {tournament.id})")

channel.close()
```

## Available Services

The library provides access to all parry.gg API services:

- **TournamentService** - Tournament management and retrieval
- **EventService** - Event operations within tournaments
- **BracketService** - Bracket and match management
- **UserService** - User account operations
- **EntrantService** - Tournament participant management
- **PhaseService** - Tournament phase operations
- **GameService** - Game information and metadata
- **HierarchyService** - Organizational hierarchy management
- **NotificationService** - Notification operations
- **MatchService** - Individual match operations
- **PageContentService** - Content management

## Documentation

For comprehensive API documentation, authentication details, and developer resources, visit:

**[developer.parry.gg](https://developer.parry.gg)**

The developer portal includes:
- Complete API reference
- Authentication guide
- Code examples
- Rate limiting information
- Webhook documentation

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Support

For API support and questions, please visit [developer.parry.gg](https://developer.parry.gg) or contact the parry.gg development team.
