python-gitea: A Python Package for Interacting with the Gitea API

0.1.0 - 2026-01-12 🚀 Features Add AsyncUser for asynchronous Gitea User resource - (cece23a) Add get-workflow-runs to CLI - (d721cd8) Add get_workflow_runs to User - (7018f4b) Add delete-user-level-runner to the CLI - (72b6e4b) Add delete_user_level_runner to User - (41bfde4) Support the --timeout option in CLI to control the timeout - (879ef7e) Add the option --runner-id to get-user-level-runners - (65687f9) Add get_user_level_runner to User - (8486f02) Add the command get-registration-token to the CLI - (f59d182) Add get_registration_token to User - (9d49dde) Add a helper function to execute the api commands - (18a667e) Add get-user-level-runners to the CLI - (0b6c757) Add BaseUser for building parameters - (567e054) Add get_user_level_runners to User - (ec17896) Add get-workflow-jobs to the CLI for getting workflow jobs - (8667d2b) Add a method get_workflow_jobs to User - (7608e94) Add get-user to gitea-cli - (b140101) Allow not providing a token to the client - (9343cb1) Add get_user to User to get user information - (831db09) Add Gitea User resource - (22fa51f) Add AsyncResource for for asynchronous Gitea API resources - (711cbfd) Add base class for Gitea API resources - (a1c42b4) 🐛 Bug Fixes Handle the case when there is no content returned from api_call in execute_api_command - (5c72718) Update the import method such that it can be patched - (e7a8708) Fix the _request methods in Gitea and AsyncGitea to handle 204 no content response - (8d30a0b) Fix the import path from utility to utils - (7392445) Convert output to Path in execute_api_command - (be16df3) Fix the end point of get_user_level_runners in User - (62a61eb) Fix the type hint of **kwargs - (ca2f511) Remove the unused output variable in get_user_level_runners.py - (af1dea8) Add TYPE_CHECKING to defer the import to avoid runtime circularity - (6ada30e) 🚜 Refactor Merge the methods get_user_level_runners and get_user_level_runner in User - (e296194) Use execute_api_command to handle the API calls - (1446bae) Use the base class method to construct the parameters for User - (b70eb51) 📚 Documentation Update the badge of zenodo DOI - (29fe7e4) Fix the docstring of api_call in get_workflow_runs.py - (b41f5ac) Update the module docstring of get_workflow_runs.py - (b826589) Update the module docstring of get_user_level_runners.py - (8b13714) Fix the docstring of api_call in get_registration_token_command - (2376ffb) Update the URL of the badge for python versions - (68c9e33) Remove CLI modules from mkdocs.yml - (5a7d88e) Skip CLI modules for the API page - (a6a9aec) Add the module gitea.user to the API page - (ceb98c0) Add the module gitea.resource to the API page - (2d2e0b5) 🎨 Styling Rename test_cli_utility.py to test_cli_utils.py - (28f9ad3) Rename utility.py to utils.py for consistency - (14cc794) Move the noqa to each line explicitly instead of the top of the file - (43f56ed) Move the imports in gitea.cli.utility to the top-level - (bd39e85) Rename the variable payload to params for consistency - (8995d21) 🧪 Testing Add unit tests for __main__.py - (89c8b36) Update the unit tests for get_workflow_runs - (fed960d) Update the unit tests for get_user - (b046f28) Update the unit tests for get_user_level_runners - (89bfa6f) Update the unit tests for get_registration_token - (4ba7eff) Update the unit tests for delete_user_level_runner - (9c46477) Update the unit tests for get_workflow_jobs.py - (f206c26) Add unit tests for gitea.version - (c243f38) Add unit tests for gitea.utils.log - (c9ea07e) Add unit tests for gitea.user.base - (31b74dd) Add unit tests for gitea.user.user - (8becf8f) Add unit tests for gitea.user.async_user - (7c5980b) Add unit tests for gitea.cli.user.main - (8700231) Add unit tests for gitea.cli.user.get_workflow_runs - (d4ab6b9) Add unit tests for gitea.cli.user.get_workflow_jobs - (c87552c) Add unit tests for gitea.cli.user.get_user - (4af3a39) Add unit tests for gitea.cli.user.get_user_level_runners - (8ab6500) Add unit tests for gitea.cli.user.get_registration_token - (379d499) Add unit tests for gitea.cli.user.delete_user_level_runner - (2580670) Add unit tests for gitea.cli.main - (81289a3) Add unit tests for execute_api_command - (0588e2e) Add unit tests for Resource - (9b0ef69) Add unit tests for AsyncResource - (79520b1) ⚙️ Miscellaneous Tasks Update the import method of execute_api_command so that it can be patched - (f2bd80b) Update the return type of the api_call functions - (784d309) Update the import method of the Gitea client so that it can be patched - (b81cece) Update the import method of the Gitea client so that it can be patched - (3647e73) Update the import method of the Gitea client so that it can be patched - (40e73d4) Update the import method of the Gitea client so that it can be patched - (ce2f17c) Update the return type of the API calls of User and AsyncUser to dict[str, Any] | None - (cbaa9d2) Update the return type of the HTTP request methods to dict[str, Any] | None - (5218047) Add the type hints for **kwargs - (a52a18d) Add the type hinting to **kwargs in User methods - (2e51ee2) Update the return type of the callable to dict[str, Any] - (40683b9) Update the endpoint of get_workflow_jobs from user/actions/jobs to /user/actions/jobs - (3ac6c5c) Add the user app to the main app - (de9b99a) Add a placeholder command to manage Gitea users - (f07da7b) Add the User instance to Gitea client - (9820048) Add a conditional in gitea._request to ensure the session is not None - (5e45abf) Contributing: We welcome contributions! Please see our Contributing Guide for details. Questions? Open an issue on GitHub or join our discussions.