Title: Fix up checks in Makefile and make them portable by EliahKagan · Pull Request #1661 · gitpython-developers/GitPython · GitHub
Open Graph Title: Fix up checks in Makefile and make them portable by EliahKagan · Pull Request #1661 · gitpython-developers/GitPython
X Title: Fix up checks in Makefile and make them portable by EliahKagan · Pull Request #1661 · gitpython-developers/GitPython
Description: Fixes #1660 In .gitattributes: Fix checking out init-tests-after-clone.sh with LF line endings on all systems (this was broken). Add Makefile to so it is also checked out with LF line endings on all systems. (Windows ports of make will usually tolerate CRLF line endings, but \r or other representations of CR may, and often do, appear in output, giving an appearance of a problem that is hard to dismiss. So it's worth keeping it LF.) For the force_release target: Don't try to upload if building failed (#1660). Only suggest using a virtual environment to solve a failure that occurred outside of one. In a virtual environment, use python, not python3, for compatibility with Windows. (Windows may have a python3 command installed outside the virtual environment, which is the most confusing case, since it gets used even from inside, so it feels like installing packages in the venv had no effect. In contrast, some Debian and derived systems, and some macOS systems, have no python command outside a venv, or it's Python 2. So keep using python3 when no venv is detected.) For the release target: Reference the current commit as HEAD rather than head. HEAD is more portable, because git does not treat names case-insensitively by default on all systems. head works on Windows and I think macOS, but not GNU/Linux or most other Unix-like systems. Use git tag --sort=-v:refname with an appropriate versionsort.suffix to order the version tags in the specific SemVer-inspired way this project uses, and a glob to omit the non-version tags. This avoids the correctness problem with the | sort -nr approach, is portable, and is more precise for this project's versions than even nonportable sort -V tweaked for SemVer, because this project has SemVer suffixes like -pre where N-pre sorts before N, but also non-SemVer -patched where N-patched sorts after N. (Thanks to @hugovk for investigating what sort -nr was doing on macOS!) Decrease duplication of complex git commands and pipelines. Write the checks to fail if a command in $( ) fails (by extracting them to assignments), so that if a git command whose output is needed fails, this doesn't cause a check to wrongly succeed. Check for VERSION and changes.rst, against each other and also the latest tag name. Check for uncommitted changes. Do the version/tag/reference agreement check after printing out a table showing all the relevant values, so the specific problems can always be efficiently identified. The above includes checks for indications that each of the actions listed in the README.md release instructions was done, and is intended to make it so make release is correct, fully usable, and preferable to make force_release in most situations. I have tested this on Ubuntu and Windows. When testing, I pressed Ctrl+C when twine prompted for credentials. I tested both the release and force_release targets. Some of the manual tests of the release target on Ubuntu can be seen in this original gist from before that review, and this newer gist testing build-release.sh. Although not shown in those gists, I have also tested that the Makefile targets use the scripts correctly since extracting commands to them. Here's an example of output from make release showing various checks and the new version/tag/ref table and failing with an error due to an inconsistency that should block the release: (.venv) ek@Glub:~/repos-wsl/GitPython (portable-makefile=)$ make release rm -rf build/ dist/ .eggs/ .tox/ ./check-version.sh Checking current directory. Checking that VERSION and doc/source/changes.rst exist and have no uncommitted changes. Checking that ALL changes are committed. Gathering current version, latest tag, and current HEAD commit info. VERSION file = 3.1.36 changes.rst = 3.1.36 Latest tag = 3.1.36 HEAD SHA = 4b7d7028193d3a03cc20867fa534e21528886f51 Latest tag SHA = 5297f6210f185c9df9c97392ffef4da8562b58ff ./check-version.sh: Check failed. Stopping. make: *** [Makefile:10: release] Error 1 Here's an example of a failure where it doesn't get anywhere near that far: (.venv) ek@Glub:~/repos-wsl/GitPython (portable-makefile +=)$ make release rm -rf build/ dist/ .eggs/ .tox/ ./check-version.sh Checking current directory. Checking that VERSION and doc/source/changes.rst exist and have no uncommitted changes. M VERSION ./check-version.sh: Check failed. Stopping. make: *** [Makefile:10: release] Error 1
Open Graph Description: Fixes #1660 In .gitattributes: Fix checking out init-tests-after-clone.sh with LF line endings on all systems (this was broken). Add Makefile to so it is also checked out with LF line endings on a...
X Description: Fixes #1660 In .gitattributes: Fix checking out init-tests-after-clone.sh with LF line endings on all systems (this was broken). Add Makefile to so it is also checked out with LF line endings on a...
Opengraph URL: https://github.com/gitpython-developers/GitPython/pull/1661
X: @github
Domain: github.com
| route-pattern | /:user_id/:repository/pull/:id/checks(.:format) |
| route-controller | pull_requests |
| route-action | checks |
| fetch-nonce | v2:44ad193c-7c95-6186-11f0-fdeaaa438cc7 |
| current-catalog-service-hash | 87dc3bc62d9b466312751bfd5f889726f4f1337bdff4e8be7da7c93d6c00a25a |
| request-id | A9CA:E339F:939E9D:CDD212:6968A405 |
| html-safe-nonce | 89ffe2004bceac4e0ef19c97bddaa826396345e7aff8cc3ec3bc6daa70a6aa11 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJBOUNBOkUzMzlGOjkzOUU5RDpDREQyMTI6Njk2OEE0MDUiLCJ2aXNpdG9yX2lkIjoiMjU1MjE2OTk1OTYxNzI0MjExNyIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | 1a29e83f118b4926bcdeb97035353a96ab3664903573e9d7375af134fabe1252 |
| hovercard-subject-tag | pull_request:1513956097 |
| github-keyboard-shortcuts | repository,pull-request-list,pull-request-conversation,pull-request-files-changed,checks,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/gitpython-developers/GitPython/pull/1661/checks |
| twitter:image | https://avatars.githubusercontent.com/u/1771172?s=400&v=4 |
| twitter:card | summary_large_image |
| og:image | https://avatars.githubusercontent.com/u/1771172?s=400&v=4 |
| og:image:alt | Fixes #1660 In .gitattributes: Fix checking out init-tests-after-clone.sh with LF line endings on all systems (this was broken). Add Makefile to so it is also checked out with LF line endings on a... |
| og:site_name | GitHub |
| og:type | object |
| hostname | github.com |
| expected-hostname | github.com |
| None | fdc7c66bd36a6c12eb8e771e806db863266e573fc299e77f27505a768d4f8a98 |
| turbo-cache-control | no-preview |
| go-import | github.com/gitpython-developers/GitPython git https://github.com/gitpython-developers/GitPython.git |
| octolytics-dimension-user_id | 503709 |
| octolytics-dimension-user_login | gitpython-developers |
| octolytics-dimension-repository_id | 1126087 |
| octolytics-dimension-repository_nwo | gitpython-developers/GitPython |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 1126087 |
| octolytics-dimension-repository_network_root_nwo | gitpython-developers/GitPython |
| turbo-body-classes | logged-out env-production page-responsive full-width full-width-p-0 |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 3223a6503d318917691422cdadfbe16cd8fb21e5 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width