<div align="center" markdown="1">
<h1>Knuckles</h1>
An unopinionated [OpenSubsonic](https://opensubsonic.netlify.app/) API wrapper for Python.
</div>
## Compatiblity
Knuckles **only** works with servers compatible with the REST API version 1.4.0 onwards (Subsonic 4.2+).
It follows strictly the [OpenSubsonic API Spec](https://opensubsonic.netlify.app/docs/opensubsonic-api/), being fully retro-compatible with the original [Subsonic API](https://subsonic.org/pages/api.jsp).
## Getting Started
### Make It Available
First install the package:
```sh title="Command line"
python3 -m pip install knuckles
```
Or add it to your project:
```toml title="pyproject.toml"
project = [
"knuckles>=1.0.0"
]
```
### Using It
```python3 title="__main__.py"
import knuckles
server = knuckles.subsonic(
# Adding https:// is done automatically,
# /rest should never be added to the URL
url = "example.com",
user = "kutu",
password = "caisopea",
client = "knuckles client"
)
ping = server.ping()
# Print the supported version of the OpenSubsonic REST API
print(ping.version)
```
### Learning More
To start making more complex interactions with the API make use of [the API reference](https://kutu-dev.github.io/knuckles/reference/Api/). Enjoy coding and good luck!
## Acknowledgements
Created with :heart: by [Jorge "Kutu" Dobón Blanco](https://dobon.dev).
Raw data
{
"_id": null,
"home_page": null,
"name": "knuckles",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11.0",
"maintainer_email": null,
"keywords": "api-wrapper, api, wrapper, library, subsonic, opensubsonic",
"author": null,
"author_email": "\"Jorge \\\"Kutu\\\" Dob\u00f3n Blanco\" <code@dobon.dev>",
"download_url": "https://files.pythonhosted.org/packages/e7/ee/810bea8bc980094976cab01af66fd42a41ca3052312b62014fee57d7e7ca/knuckles-1.1.0.tar.gz",
"platform": null,
"description": "<div align=\"center\" markdown=\"1\">\n<h1>Knuckles</h1>\n\n\n\n\n\n\nAn unopinionated [OpenSubsonic](https://opensubsonic.netlify.app/) API wrapper for Python.\n</div>\n\n## Compatiblity\nKnuckles **only** works with servers compatible with the REST API version 1.4.0 onwards (Subsonic 4.2+).\nIt follows strictly the [OpenSubsonic API Spec](https://opensubsonic.netlify.app/docs/opensubsonic-api/), being fully retro-compatible with the original [Subsonic API](https://subsonic.org/pages/api.jsp).\n\n## Getting Started\n\n### Make It Available\nFirst install the package:\n\n```sh title=\"Command line\"\npython3 -m pip install knuckles\n```\n\nOr add it to your project:\n\n```toml title=\"pyproject.toml\"\nproject = [\n \"knuckles>=1.0.0\"\n]\n```\n\n### Using It\n\n```python3 title=\"__main__.py\"\nimport knuckles\n\nserver = knuckles.subsonic(\n # Adding https:// is done automatically,\n # /rest should never be added to the URL\n url = \"example.com\",\n user = \"kutu\",\n password = \"caisopea\",\n client = \"knuckles client\"\n)\n\nping = server.ping()\n\n# Print the supported version of the OpenSubsonic REST API\nprint(ping.version)\n```\n\n### Learning More\nTo start making more complex interactions with the API make use of [the API reference](https://kutu-dev.github.io/knuckles/reference/Api/). Enjoy coding and good luck!\n\n## Acknowledgements\nCreated with :heart: by [Jorge \"Kutu\" Dob\u00f3n Blanco](https://dobon.dev).\n",
"bugtrack_url": null,
"license": null,
"summary": "A Subsonic/OpenSubsonic API wrapper for Python.",
"version": "1.1.0",
"project_urls": {
"Changelog": "https://github.com/kutu-dev/knuckles/blob/master/CHANGELOG.md",
"Documentation": "https://kutu-dev.github.io/knuckles/",
"Issues": "https://github.com/kutu-dev/knuckles/issues",
"Repository": "https://github.com/kutu-dev/knuckles"
},
"split_keywords": [
"api-wrapper",
" api",
" wrapper",
" library",
" subsonic",
" opensubsonic"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "da79bf31331d451597ce24aa7672693eb41f926f29a5ca6d906de1f0c0ce1b36",
"md5": "67e8eac39c28e53d627b6e018df76785",
"sha256": "996ec2f23ed8fa041904c18308ce159d80c3fd7518dfc4d5c4aba77f41106758"
},
"downloads": -1,
"filename": "knuckles-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "67e8eac39c28e53d627b6e018df76785",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11.0",
"size": 64713,
"upload_time": "2024-06-02T22:01:07",
"upload_time_iso_8601": "2024-06-02T22:01:07.846151Z",
"url": "https://files.pythonhosted.org/packages/da/79/bf31331d451597ce24aa7672693eb41f926f29a5ca6d906de1f0c0ce1b36/knuckles-1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e7ee810bea8bc980094976cab01af66fd42a41ca3052312b62014fee57d7e7ca",
"md5": "0b77bb2f1fa631f9ca8e8815dac616e8",
"sha256": "484e31bfb44773e74e3a4c816037b6545a3ca54a2fa39a058b46ba8914e0b2a0"
},
"downloads": -1,
"filename": "knuckles-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "0b77bb2f1fa631f9ca8e8815dac616e8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11.0",
"size": 41430,
"upload_time": "2024-06-02T22:01:09",
"upload_time_iso_8601": "2024-06-02T22:01:09.894835Z",
"url": "https://files.pythonhosted.org/packages/e7/ee/810bea8bc980094976cab01af66fd42a41ca3052312b62014fee57d7e7ca/knuckles-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-02 22:01:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kutu-dev",
"github_project": "knuckles",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "knuckles"
}
JSON
