mirror of
https://github.com/Hopiu/linkchecker.git
synced 2026-04-16 04:11:01 +00:00
76 lines
2.4 KiB
Markdown
76 lines
2.4 KiB
Markdown
Developing LinkChecker
|
|
======================
|
|
|
|
The following steps describe how to work with the LinkChecker source which can
|
|
be found on [GitHub](https://github.com/linkchecker/linkchecker/) where
|
|
development is managed.
|
|
|
|
This is a technical document, if you are looking for ways to
|
|
participate in the community, you should rather look into
|
|
[contributing](../CONTRIBUTING.rst).
|
|
|
|
Requirements
|
|
------------
|
|
|
|
These requirements are in addition to the dependencies covered in the
|
|
[installation instructions](install.txt).
|
|
|
|
Developers will likely want to install hatch.
|
|
|
|
To run the copy of linkchecker in the local repository:
|
|
|
|
hatch env remove
|
|
hatch run linkchecker
|
|
|
|
If LinkChecker is already installed, `python -m linkcheck` will work, but the
|
|
metadata of the installed version will be used to e.g. provide the version number.
|
|
|
|
Workflows using GitHub Actions are used to check every PR, each commit and
|
|
regularly the repository HEAD. Developers are able to perform these checks
|
|
locally, using `flake8` for code style, and run the test suite with `tox` or
|
|
`hatch -e test run tests` that are both configured to use pytest.
|
|
|
|
`hatchling build` creates distributions packages.
|
|
|
|
Source layout
|
|
-------------
|
|
|
|
Important files and directories for developers to be aware of:
|
|
|
|
.flake8
|
|
.gitignore
|
|
.yamllint
|
|
Dockerfile
|
|
pyproject.toml
|
|
pytest.ini
|
|
robots.txt - test file
|
|
tox.ini
|
|
.github/ - GitHub automation
|
|
cgi-bin/ - WSGI frontend
|
|
doc/ - documentation including source for web site and man pages
|
|
linkcheck/ - core code and CLI frontend
|
|
po/ - application translations
|
|
scripts/ - automated IANA schemes updater, analysis tools
|
|
tests/
|
|
tools/ - build scripts
|
|
|
|
Release process
|
|
---------------
|
|
|
|
1. check whether updated man pages and translations need committing
|
|
(`make locale; make -C doc locale; make -C doc man`)
|
|
if so create a pull request using the GitHub workflow:
|
|
"Create a branch with updated man pages and application translations"
|
|
|
|
2. edit `changelog.txt` and `upgrading.txt`, and if applicable the
|
|
copyright dates in `linkcheck/configuration/__init__.py`
|
|
|
|
3. confirm tests have passed
|
|
|
|
4. submit a pull request
|
|
|
|
5. create release (vX.Y.Z) on GitHub
|
|
|
|
6. download Python distribution files from the GitHub release
|
|
|
|
7. check distribution files (`twine check LinkChecker*`) and upload to PyPI (`twine upload LinkChecker*`)
|