f1c9ebf6f2
This PR contains the following updates: | Package | Change | Age | Adoption | Passing | Confidence | |---|---|---|---|---|---| | [drf-spectacular](https://redirect.github.com/tfranzel/drf-spectacular) | `>=0.22.1,<0.28` -> `>=0.22.1,<0.29` | [](https://docs.renovatebot.com/merge-confidence/) | [](https://docs.renovatebot.com/merge-confidence/) | [](https://docs.renovatebot.com/merge-confidence/) | [](https://docs.renovatebot.com/merge-confidence/) | --- ### Release Notes <details> <summary>tfranzel/drf-spectacular (drf-spectacular)</summary> ### [`v0.28.0`](https://redirect.github.com/tfranzel/drf-spectacular/blob/HEAD/CHANGELOG.rst#0280-2024-11-30) [Compare Source](https://redirect.github.com/tfranzel/drf-spectacular/compare/0.27.2...0.28.0) - Fix lazy_reverse bug in views (`#​1339 <https://github.com/tfranzel/drf-spectacular/issues/1339>`\_) - Extend query params explosion of non-DRF serializer `#​1315 <https://github.com/tfranzel/drf-spectacular/issues/1315>`\_ - consider pk_field on PrimaryKeyRelatedField when set `#​1335 <https://github.com/tfranzel/drf-spectacular/issues/1335>`\_ - fix unused OAuth2 scopes override `#​1319 <https://github.com/tfranzel/drf-spectacular/issues/1319>`\_ - bugfix @​extend_schema_field raw schema already in OAS3.1 - some minors (resolves `#​1147 <https://github.com/tfranzel/drf-spectacular/issues/1147>`\_) - fix OAS3.1 validator omission `#​1302 <https://github.com/tfranzel/drf-spectacular/issues/1302>`\_ - guard against broken **dir** impl `#​1296 <https://github.com/tfranzel/drf-spectacular/issues/1296>`\_ - Add Django 5.1 as classifier \[jelmert] - No extra items in the oneOf list \[Vladimir] - parametrize component registry identity `#​1288 <https://github.com/tfranzel/drf-spectacular/issues/1288>`\_ - make operation_id action position configurable `#​1264 <https://github.com/tfranzel/drf-spectacular/issues/1264>`\_ - Fix for incorrect `issubclass()` check. \[Mike Moore] - Correct the documentation of how to import extension snippets \[Alan Crosswell] - Update OpenAPI docs links \[Nils Van Zuijlen] - mitigate false positive in Django Debug Toolbar `#​1159 <https://github.com/tfranzel/drf-spectacular/issues/1159>`\_ - Additional testcase \[Marti Raudsepp] - Fix ChoiceField schema type with empty `choices=[]` \[Marti Raudsepp] - handle examples with nested properties pagination \[François Rejeté] - add choice field display method handling `#​1228 <https://github.com/tfranzel/drf-spectacular/issues/1228>`\_ - Add support for stateless user authentication in SimpleJWT (`#​1221 <https://github.com/tfranzel/drf-spectacular/issues/1221>`\_) \[Willem Meints] - fix: set pydantic json mode to serialization \[Eric Butler] - fix: extend_schema_field with dict param and oas 3.1 \[Eric Butler] Breaking changes / important additions: - Y-stream release due to the amount of small but important changes. - Pydantic users might see a slightly different schema due to the change in serialization method. </details> --- ### Configuration 📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined). 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this PR and you won't be reminded about these updates again. --- - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box --- This PR was generated by [Mend Renovate](https://mend.io/renovate/). View the [repository job log](https://developer.mend.io/github/libretime/libretime). <!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzOS4xOS4wIiwidXBkYXRlZEluVmVyIjoiMzkuNDIuNCIsInRhcmdldEJyYW5jaCI6Im1haW4iLCJsYWJlbHMiOlsiZGVwZW5kZW5jaWVzIiwicHl0aG9uIl19--> Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> |
||
|---|---|---|
| .. | ||
| install/systemd | ||
| libretime_api | ||
| Makefile | ||
| README.md | ||
| packages.ini | ||
| pyproject.toml | ||
| requirements.txt | ||
| schema.yml | ||
| setup.py | ||
README.md
LibreTime API
This API provides access to LibreTime's database via a Django application.
Deploying
Deploying in a production environment is done in the install
script which installs LibreTime. This is how the API is installed in the Vagrant
development images too. This method does not automatically reflect changes to
this API. After any changes, the libretime-api systemd service needs
restarting:
sudo systemctl restart libretime-api
Connections to the API are proxied through the Apache web server by default.
Endpoint exploration and documentation is available from
http://example.com/api/v2/schema/swagger-ui/, where example.com is the URL
for the LibreTime instance.
Development
For development, you can install all required dependencies and loading the environment using the following command:
make install
source .venv/bin/activate
You should be able to lint or format the code or run api commands:
make format
make lint
libretime-api help
In order to work with the database and message queue, you need to start the docker based development stack present at the project root:
pushd ..
docker-compose up -d
popd
You can now run the api tests:
make test
Inside Vagrant
You can develop the api using a live reloading version within Vagrant:
vagrant up bullseye
vagrant ssh bullseye
cd /vagrant/api
sudo pip3 install -e .
sudo systemctl stop libretime-api
sudo -u libretime LIBRETIME_DEBUG=True libretime-api runserver 0.0.0.0:8081
3rd Party Licences
libretime_api/tests/resources/song.mp3: Steps - Tears On The Dancefloor (Album
Teaser) by mceyedol. Downloaded from
https://soundcloud.com/mceyedol/steps-tears-on-the-dancefloor-album-teaser
released under a Creative Commons Licence
(cc-by-sa-nc-sa)