gd.py
An API wrapper for Geometry Dash written in Python.
Installing
Python 3.7 or above is required.
pip
Installing the library with pip is quite simple:
$ pip install gd.py
Alternatively, the library can be installed from source:
$ git clone https://github.com/nekitdev/gd.py.git
$ cd gd.py
$ python -m pip install .
poetry
You can add gd.py as a dependency with the following command:
$ poetry add gd.py
Or by directly specifying it in the configuration like so:
[tool.poetry.dependencies]
"gd.py" = "^1.0.1"
Alternatively, you can add it directly from the source:
[tool.poetry.dependencies."gd.py"]
git = "https://github.com/nekitdev/gd.py.git"
Examples
Fetching
# file.py
import asyncio
import gd
SONG_ID = 1081309
SONG = "{} by {} (ID: {}, size: {} MB)"
async def main() -> None:
client = gd.Client()
song = await client.get_song(SONG_ID)
print(SONG.format(song.name, song.artist.name, song.id, song.size))
asyncio.run(main())
$ python file.py
PANDA EYES - BROKEN by PandaEyesOfficial (ID: 1081309, size: 9.71 MB)
Listening
import gd
client = gd.Client()
DAILY = "new daily! {daily.name} by {daily.creator.name} (ID: {daily.id})"
@client.event
async def on_daily(daily: gd.Level) -> None:
print(DAILY.format(daily=daily))
client.listen_for_daily()
client.create_controller().run()
Documentation
You can find the documentation here.
Support
If you need support with the library, you can send an email or refer to the official Discord server.
Changelog
You can find the changelog here.
Security Policy
You can find the Security Policy of gd.py here.
Contributing
If you are interested in contributing to gd.py, make sure to take a look at the
Contributing Guide, as well as the Code of Conduct.
License
gd.py is licensed under the MIT License terms. See License for details.
1 maintainer
Metadata
1 maintainer
Release files for gd.py 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gd_py-1.0.1.tar.gz | 5.4 MB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| gd_py-1.0.1-cp311-cp311-win_amd64.whl | CPython 3.11 | CPython 3.11 | Windows x86-64 | Details |
| gd_py-1.0.1-cp311-cp311-manylinux_2_35_x86_64.whl | CPython 3.11 | CPython 3.11 | Linux glibc 2.35+ x86-64 | Details |
| gd_py-1.0.1-cp311-cp311-macosx_12_0_x86_64.whl | CPython 3.11 | CPython 3.11 | macOS 12.0+ x86-64 | Details |
| gd_py-1.0.1-cp310-cp310-win_amd64.whl | CPython 3.10 | CPython 3.10 | Windows x86-64 | Details |
| gd_py-1.0.1-cp310-cp310-manylinux_2_35_x86_64.whl | CPython 3.10 | CPython 3.10 | Linux glibc 2.35+ x86-64 | Details |
| gd_py-1.0.1-cp310-cp310-macosx_12_0_x86_64.whl | CPython 3.10 | CPython 3.10 | macOS 12.0+ x86-64 | Details |
| gd_py-1.0.1-cp39-cp39-win_amd64.whl | CPython 3.9 | CPython 3.9 | Windows x86-64 | Details |
| gd_py-1.0.1-cp39-cp39-manylinux_2_35_x86_64.whl | CPython 3.9 | CPython 3.9 | Linux glibc 2.35+ x86-64 | Details |
| gd_py-1.0.1-cp39-cp39-macosx_12_0_x86_64.whl | CPython 3.9 | CPython 3.9 | macOS 12.0+ x86-64 | Details |
| gd_py-1.0.1-cp38-cp38-win_amd64.whl | CPython 3.8 | CPython 3.8 | Windows x86-64 | Details |
| gd_py-1.0.1-cp38-cp38-manylinux_2_35_x86_64.whl | CPython 3.8 | CPython 3.8 | Linux glibc 2.35+ x86-64 | Details |
| gd_py-1.0.1-cp38-cp38-macosx_12_0_x86_64.whl | CPython 3.8 | CPython 3.8 | macOS 12.0+ x86-64 | Details |
Total release size: 76.6 MB
Release files / gd_py-1.0.1.tar.gz
| Download URL | gd_py-1.0.1.tar.gz |
|---|---|
| Size | 5.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a317b06e945458770afe470b8a1f9ff6c636aebbbbb5755b9c4f9d4ec22ef2e2
|
|
BLAKE2b-256 checksum How to use checksums |
fa34c2050a8517973670b080e7fee10880c01d670c81cc4e3be16c0d817a2118
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.6.1 CPython/3.8.17 Linux/5.15.0-1041-azure
|
Release files / gd_py-1.0.1-cp311-cp311-win_amd64.whl
| Download URL | gd_py-1.0.1-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 5.6 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
df7791679efa02c242fc3814ab844bcf309a7cee82db5eef2e00b1a2e296f8d3
|
|
BLAKE2b-256 checksum How to use checksums |
e014db8080ef5cc1d07c0e245762a464ba67220a6a971d6ce4f1677978363753
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.6.1 CPython/3.11.4 Windows/10
|
Release files / gd_py-1.0.1-cp311-cp311-manylinux_2_35_x86_64.whl
| Download URL | gd_py-1.0.1-cp311-cp311-manylinux_2_35_x86_64.whl |
|---|---|
| Size | 6.5 MB |
| Tags | CPython 3.11 Linux glibc 2.35+ x86-64 |
|
SHA-256 checksum How to use checksums |
73614cb6a841398d80f73821ea0cf666ea33668e2233b3dbe8afe0c8bd161a2d
|
|
BLAKE2b-256 checksum How to use checksums |
7e78b5aa836d214e20fbea74c5c155e349a8d4d47d5e29c506a8c68ed0273195
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.6.1 CPython/3.11.4 Linux/5.15.0-1041-azure
|
Release files / gd_py-1.0.1-cp311-cp311-macosx_12_0_x86_64.whl
| Download URL | gd_py-1.0.1-cp311-cp311-macosx_12_0_x86_64.whl |
|---|---|
| Size | 5.7 MB |
| Tags | CPython 3.11 macOS 12.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
93def586de2ad0d637265a7e868c72e1efb07626d7d328e25638c6449cec4d3e
|
|
BLAKE2b-256 checksum How to use checksums |
733f8142b0090cc03aed3cb73b1a8e84cf99664c2aec2fc875ce73a31a2cb825
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.6.1 CPython/3.11.4 Darwin/21.6.0
|
Release files / gd_py-1.0.1-cp310-cp310-win_amd64.whl
| Download URL | gd_py-1.0.1-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 5.6 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
a707c0c62ba9f95a0205ad01c3763110bc2170f46813e2bb6ea1579860d2e871
|
|
BLAKE2b-256 checksum How to use checksums |
7b478a1015297fd9a4d2368a25d4987742faab4e41fedc8d2f9df3d2a421ea7e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.6.1 CPython/3.10.11 Windows/10
|
Release files / gd_py-1.0.1-cp310-cp310-manylinux_2_35_x86_64.whl
| Download URL | gd_py-1.0.1-cp310-cp310-manylinux_2_35_x86_64.whl |
|---|---|
| Size | 6.5 MB |
| Tags | CPython 3.10 Linux glibc 2.35+ x86-64 |
|
SHA-256 checksum How to use checksums |
7483bc7b9104f46e0c72c2ee6d3bf8a6a13a870364809c053d359f01c0b4eabf
|
|
BLAKE2b-256 checksum How to use checksums |
b4777efeed476135befbce804d1066ebba45936de22080e98172effe7f998af5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.6.1 CPython/3.10.12 Linux/5.15.0-1041-azure
|
Release files / gd_py-1.0.1-cp310-cp310-macosx_12_0_x86_64.whl
| Download URL | gd_py-1.0.1-cp310-cp310-macosx_12_0_x86_64.whl |
|---|---|
| Size | 5.7 MB |
| Tags | CPython 3.10 macOS 12.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
f59503006c1c4381847d0da94a87eebd82fa2447680d00fe79d537bae2a32da8
|
|
BLAKE2b-256 checksum How to use checksums |
54ba078fd65b94dd4333294625a4381c56c99b66ade34cc4f59496149ac43474
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.6.1 CPython/3.10.12 Darwin/21.6.0
|
Release files / gd_py-1.0.1-cp39-cp39-win_amd64.whl
| Download URL | gd_py-1.0.1-cp39-cp39-win_amd64.whl |
|---|---|
| Size | 5.6 MB |
| Tags | CPython 3.9 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
1b723c99dc28d64171f0023b288f249868bfadc455af797f910174ec46c42ca7
|
|
BLAKE2b-256 checksum How to use checksums |
2813e7f84c9fee07b390f393d7c077fb2e425dc0d22f83a028503e8d80ec542e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.6.1 CPython/3.9.13 Windows/10
|
Release files / gd_py-1.0.1-cp39-cp39-manylinux_2_35_x86_64.whl
| Download URL | gd_py-1.0.1-cp39-cp39-manylinux_2_35_x86_64.whl |
|---|---|
| Size | 6.5 MB |
| Tags | CPython 3.9 Linux glibc 2.35+ x86-64 |
|
SHA-256 checksum How to use checksums |
89fd54962fe3e05927ca74fa7bc80d5fca3b5bc3f3b38506fa2155e7135ffca8
|
|
BLAKE2b-256 checksum How to use checksums |
38ff1af4fece86c17bc7d5051791222864845645e3f5fa1abc840ac461b275a6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.6.1 CPython/3.9.17 Linux/5.15.0-1041-azure
|
Release files / gd_py-1.0.1-cp39-cp39-macosx_12_0_x86_64.whl
| Download URL | gd_py-1.0.1-cp39-cp39-macosx_12_0_x86_64.whl |
|---|---|
| Size | 5.7 MB |
| Tags | CPython 3.9 macOS 12.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
4f4a39716816bb3c58cf57dfb76950d3367a08f483cecaeb9c6c5c3f581b9b89
|
|
BLAKE2b-256 checksum How to use checksums |
6b786b3fb8b6d938105ac9c9e45cbbe0967b73fc2fd769f0b65d8f7f247e1b1a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.6.1 CPython/3.9.17 Darwin/21.6.0
|
Release files / gd_py-1.0.1-cp38-cp38-win_amd64.whl
| Download URL | gd_py-1.0.1-cp38-cp38-win_amd64.whl |
|---|---|
| Size | 5.6 MB |
| Tags | CPython 3.8 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
500e4747f1262eb61d4545728bddd857b1561fcb83f668de8c2318a4cde38bcc
|
|
BLAKE2b-256 checksum How to use checksums |
038a1081c8d5820315c1fba1de9fedc42e9a2b3e5d26da237c2520f941903b1f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.6.1 CPython/3.8.10 Windows/10
|
Release files / gd_py-1.0.1-cp38-cp38-manylinux_2_35_x86_64.whl
| Download URL | gd_py-1.0.1-cp38-cp38-manylinux_2_35_x86_64.whl |
|---|---|
| Size | 6.5 MB |
| Tags | CPython 3.8 Linux glibc 2.35+ x86-64 |
|
SHA-256 checksum How to use checksums |
e782dd4596434f185c6b97043d85d2c2f1de4f28790de78a39ffc68fc80cdb1a
|
|
BLAKE2b-256 checksum How to use checksums |
d476138c7a831d532746bbf9a52fd4762a6a7e4c45437b72cde033c78b212ba7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.6.1 CPython/3.8.17 Linux/5.15.0-1041-azure
|
Release files / gd_py-1.0.1-cp38-cp38-macosx_12_0_x86_64.whl
| Download URL | gd_py-1.0.1-cp38-cp38-macosx_12_0_x86_64.whl |
|---|---|
| Size | 5.7 MB |
| Tags | CPython 3.8 macOS 12.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
4b882cbb1aa5b428bdf0309c19f9247bf77a3bee9ca4bd58f4b6c966c2f1fdf0
|
|
BLAKE2b-256 checksum How to use checksums |
ee6380ba2934be27044bd101d7dcc4030a31dc56e7d5c438e0ff801f13f9fb99
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.6.1 CPython/3.8.17 Darwin/21.6.0
|
