{"id":21884281,"url":"https://github.com/harrelchris/evesso","last_synced_at":"2025-04-15T07:18:58.072Z","repository":{"id":43209914,"uuid":"456406804","full_name":"harrelchris/evesso","owner":"harrelchris","description":"Python SSO Authorization for Eve Online API applications","archived":false,"fork":false,"pushed_at":"2024-06-17T09:17:00.000Z","size":43,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-15T07:18:51.035Z","etag":null,"topics":["api","esi","eve-online","eveonline","sso"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/harrelchris.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2022-02-07T07:49:44.000Z","updated_at":"2025-01-28T09:49:21.000Z","dependencies_parsed_at":"2023-09-24T18:12:11.625Z","dependency_job_id":null,"html_url":"https://github.com/harrelchris/evesso","commit_stats":{"total_commits":84,"total_committers":2,"mean_commits":42.0,"dds":0.09523809523809523,"last_synced_commit":"ad46441452d93eb00769b77813809a674c76bcd9"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harrelchris%2Fevesso","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harrelchris%2Fevesso/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harrelchris%2Fevesso/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harrelchris%2Fevesso/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/harrelchris","download_url":"https://codeload.github.com/harrelchris/evesso/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249023745,"owners_count":21199961,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","esi","eve-online","eveonline","sso"],"created_at":"2024-11-28T10:13:12.748Z","updated_at":"2025-04-15T07:18:58.050Z","avatar_url":"https://github.com/harrelchris.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EveSSO\n\nSSO Authorization for Eve Online.\n\n## About\n\nThis library implements the native SSO authorization flow as described [here](https://docs.esi.evetech.net/docs/sso/native_sso_flow.html). EveSSO will perform the authorization process as needed, store your access and refresh tokens, and refresh your access token as needed. It will then provide the required header for your requests.\n\n## Installation\n\n```shell\npip install evesso\n```\n\n## Quickstart\n\n```python\nfrom evesso import SSO\nimport requests\n\nsso = SSO(\n    client_id='1234567890asdfghjklqwertyuiop',\n    callback_url='http://localhost/',\n    scope='esi-characters.some_scope.v1 esi-characters.some_scope.v1'\n)\nresponse = requests.get(\n    'https://esi.evetech.net/latest/markets/structures/SOME_STRUCTURE_ID/?datasource=tranquility',\n    headers=sso.get_header()\n)\nresponse.raise_for_status()\nprint(response.json())\n```\n\n### Using .env file\n\n```dotenv\nCLIENT_ID=1234567890asdfghjklqwertyuiop\nCALLBACK_URL=http://localhost/\nSCOPE=\"esi-characters.some_scope.v1 esi-characters.some_scope.v1\"\n```\n\nEsi will check environment variables for credentials if not parameterized.\n\n```python\nfrom evesso import SSO\nfrom dotenv import load_dotenv\nimport requests\n\nload_dotenv()\n\nsso = SSO()\nresponse = requests.get(\n    'https://esi.evetech.net/latest/markets/structures/SOME_STRUCTURE_ID/?datasource=tranquility',\n    headers=sso.get_header()\n)\nresponse.raise_for_status()\nprint(response.json())\n```\n\n## Authorizing on a remote machine\n\n1. Set the `cli` parameter to `True`.\n2. The auth url will be printed to the command line.\n3. Open the auth url in a browser and complete the auth process\n4. The SSO server will make a get request to the machine where you opened the auth url\n5. Copy the callback url and paste it into the command line so evesso can parse it\n\n```python\nfrom evesso import SSO\n\nsso = SSO(cli=True)\n...\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharrelchris%2Fevesso","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fharrelchris%2Fevesso","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharrelchris%2Fevesso/lists"}