python-eveauth

A Python library for authorizing desktop apps with the EVE online SSO.

Description

python-eveauth is a library for authorizing Python scripts on desktops with the EVE online SSO. It enables a Python script (e.g. CLI tools, GUI apps or Jupiter notebooks) to obtain SSO tokens that grant authenticated access to the EVE Online API (ESI).

Installation

pip install python-eveauth

Quick Start

First you need to create an EVE SSO app for your script on Eve Online's developers site:

• Name: Any name
• Callback URL: The default callback for your SSO app is: http://127.0.0.1:8080/callback
• Enabled Scopes: Select all scopes needed for your app (you can change this later if you want). Select at least one scope, e.g. publicData

This will create a SSO app and give you a SSO client ID.

Then you can start authorizing your script with eveauth.

Below is an basic example that show how you can use eveauth. It first authorizes the script and obtains a token. Then fetches the wallet balance for the authorized character with the token. The token can later be refreshed as needed.

import requests
from eveauth import Client

# Create an auth client
c = Client(client_id="YOUR-SSO-CLIENT-ID")

# Authorize the current script with the character wallet scope
token = c.authorize("esi-wallet.read_character_wallet.v1")

# Request the wallet balance for the authorized character
r = requests.get(
    url=f"https://esi.evetech.net/characters/{token.character_id}/wallet",
    headers={"Authorization": f"Bearer {token.access_token}"},
)
r.raise_for_status()

# Print the balance
print(r.text)


# Refresh the token
# c.refresh_token(token)

You can find more examples in the directory /examples.

Documentation

The full documentation can be found here: Documentation.