Skip to main content

An asynchronous client library for EVE ONLINE ESI API

Project description

ESIHub

PyPI version Python Versions License: MIT codecov Code style: black

A high-performance, feature-rich Python client for the EVE Online ESI API

InstallationQuick StartFeaturesDocumentationContributingLicense

Installation

ESIHub requires Python 3.11 or later. Install it with pip:

pip install esihub

Quick Start

Here's a simple example to get you started:

import asyncio
from esihub import ESIHubClient

async def main():
    client = ESIHubClient(
        client_id="your_client_id",
        client_secret="your_client_secret",
        callback_url="your_callback_url"
    )

    async with client:
        # Get character information
        character_id = 12345
        character_info = await client.get_characters_character_id(character_id=character_id)
        print(f"Character Info: {character_info}")

asyncio.run(main())

Features

  • Asynchronous Operations: Built on aiohttp for high performance
  • 🔄 Automatic Rate Limiting: Stay within EVE Online's API guidelines
  • 💾 Efficient Caching: Reduce unnecessary API calls with Redis integration
  • 🔑 Token Management: Automatic token refresh and secure storage
  • 🛡️ Robust Error Handling: Custom exceptions for different error scenarios
  • 📝 Comprehensive Logging: Detailed logs for easy debugging
  • 🎣 Event Hooks: Lifecycle events for request customization
  • 📦 Batch Processing: Make multiple requests concurrently
  • ⚙️ Easy Configuration: Simple setup with environment variables

Documentation

For full documentation, please visit our GitHub Pages.

Contributing

We welcome contributions! Please see our Contributing Guide for more details.

License

ESIHub is released under the MIT License. See the LICENSE file for more details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

esihub-0.0.2.tar.gz (88.8 kB view hashes)

Uploaded Source

Built Distribution

esihub-0.0.2-py3-none-any.whl (92.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page