Skip to main content

OGS Python Library

pipeline status Latest Release PyPI version License Keep a Changelog v1.1.0 badge

github-sponsors

Summary

An API wrapper written in python for the Online-Go Server's (OGS) REST API and Realtime (SocketIO) API

NOTE While the project is mostly functional, this is still a work in progress, and is not yet ready for production use.

Documentation

The documentation is built automatically using mkdocs and mkdocstrings.

Read the documentation here for more info: https://ogs-python.dakotamarshall.net/

Install

Pip Package

python3 -m pip install ogsapi

Manual

Installing the specific versions in requirements.txt is REQUIRED, the OGS API does not support newer versions, and these versions of socketio and engineio are tested to be compatible with each other.

pip3 install -r requirements.txt

If you install the wrong version by accident, you must uninstall and re-install.

pip3 uninstall python-engineio python-socketio
pip3 install -r requirements.txt

Usage

from ogsapi.client import OGSClient

ogs = OGSClient('your_client_id', 'your_client_secret', 'your_username', 'your_password')

This will authenticate you to OGS using your API credentials, and connect you to the Realtime API Socket. You can now call the usable functions.

Implemented API Functions

NOTE All usernames are case sensitive

Look at the documentation to see what methods are available under OGSClient and OGSSocket / OGSGame

See the checklist for a rough list of what is left to be implemented

Metadata

Release files for ogsapi 1.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ogsapi 1.3.0
File Size Uploaded
ogsapi-1.3.0.tar.gz 52.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ogsapi 1.3.0
File Interpreter ABI Platform
ogsapi-1.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 97.9 kB

Release files / ogsapi-1.3.0.tar.gz

Download URL ogsapi-1.3.0.tar.gz
Size 52.4 kB
Tags Source
SHA-256 checksum
How to use checksums
eb2b6861183fbbb517d8ee236f34fd46e8d364060563bf25914c1484128b5246
BLAKE2b-256 checksum
How to use checksums
f3d38821a2c6adc29ff92cea48fd3d527c1cd099f156c1a76b0966e5b433809c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.5

Release files / ogsapi-1.3.0-py3-none-any.whl

Download URL ogsapi-1.3.0-py3-none-any.whl
Size 45.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b248082f2e1ace075934ecb3bf93ebe68018d03290877e60e76f6adf97b08449
BLAKE2b-256 checksum
How to use checksums
772a55bdc5cd476d39bca8aadcabe6a34054ae63b6e1e9e2e2c56843856439cd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.5

Release history Release notifications | RSS feed

This release

1.3.0 This release

2 release files

1.2.0

2 release files

1.1.3

2 release files

1.1.2

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.0

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.0

2 release files

0.7.3

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.1

2 release files

0.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page