Hopiu/linkchecker
1
0
Fork 0
mirror of https://github.com/Hopiu/linkchecker.git synced 2026-03-17 06:20:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
linkchecker/doc/development.md
Chris Mayo fdc4a2eeca Bring development.md up to date
2022-09-05 19:30:38 +01:00

2.4 KiB
Raw Blame History

Developing LinkChecker

The following steps describe how to work with the LinkChecker source which can be found on GitHub 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.

Requirements

These requirements are in addition to the dependencies covered in the installation instructions.

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*)