pyTooling/Actions
1
0
Fork 0
mirror of https://github.com/pyTooling/Actions.git synced 2026-02-12 02:56:56 +08:00
Code Issues Packages Projects Releases Wiki Activity

releaser: add DEVELOPMENT.md

Browse Source
This commit is contained in:
umarcor
2021-12-02 16:36:20 +01:00
parent 1f3d12ef95
commit 615aafc0b4
1 changed files with 24 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
releaser/DEVELOPMENT.md Normal file
View File

@@ -0,0 +1,24 @@
# Releaser Development
- The connection issues explained in "Troubleshooting" might be related to some problem deep inside the Python libraries.
Some users tried [cli/cli](https://github.com/cli/cli), which is written in golang, as an alternative to **Releaser**
(see [msys2/msys2-installer#36](https://github.com/msys2/msys2-installer/pull/36)).
In fact, when the Python version of **Releaser** was written, `cli` was evaluated as an alternative to PyGitHub.
`gh release` was (and still is) not flexible enough to update the reference of a release, without deleting and
recreating it (see [cli.github.com: manual/gh_release_create](https://cli.github.com/manual/gh_release_create)).
Deletion and recreation is unfortunate, because it notifies all the watchers of a repository
(see [eine/tip#111](https://github.com/eine/tip/issues/111)).
Nevertheless, it might be desirable to evaluate using `gh release upload` (see [cli.github.com: manual/gh_release_upload](https://cli.github.com/manual/gh_release_upload)) in **Releaser**.
- Login through SSH is not supported by `cli` (see [cli/cli#3715](https://github.com/cli/cli/issues/3715)); however,
on GitHub Actions a token is available `${{ github.token }}` and `cli` is installed by default.
- In order to avoid **Releaser** and the dependencies being installed at runtime, we should add a workflow to build a
container image and push it to the GitHub Container Registry (say `ghcr.io/pyTooling/Releaser`).
Then, update `action.yml` to use that image instead of the `Dockerfile`.
That would remove the performance penalty of having additional dependencies (such as
[pyTooling/pyAttributes](https://github.com/pyTooling/pyAttributes) or
[willmcgugan/rich](https://github.com/willmcgugan/rich)).
- It might be desirable to have pyTooling.Version.SemVersion handle the regular expression from
[semver.org](https://semver.org/#is-there-a-suggested-regular-expression-regex-to-check-a-semver-string), and use
proper Python classes in **Releaser**.