Check whether our mirror packages are up to date.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Raymond Li 250f358f4e Merge pull request 'parallize mirror checking and remove special case matching' (#5) from multithread into master 10 months ago
projects parallize mirror checking and remove special case matching 10 months ago
.gitignore Rename distro to project 1 year ago
README.md adjusted requirements.txt 1 year ago
data.json fix GentooDistfiles, opensuse, tdf 10 months ago
example.in Add Artix 11 months ago
main.py parallize mirror checking and remove special case matching 10 months ago
project.py error on 404 and fix artix checker 10 months ago
requirements.txt adjusted requirements.txt 1 year ago
shared.py Changed GNOME to automatically check for latest version and refactored code into classes 1 year ago
test.py changed linuxmint, ubuntu_ports_releases, xubuntu_releases 1 year ago

README.md

Mirror Checker

This mirror status checker determines whether CSC mirror is up-to-date with upstream.

How To Run

A configuration file may be provided through standard input. Without a configuration file, execute python main.py. By default, all the available distributions will be checked. With a configuration file, execute python main.py < name_of_config_file.in, for example, python main.py < example.in. In this case, only the distributions listed in the configuration file will be checked.

Dev Notes

How the program works: We first have a general mirror check class called project.py which checks whether the timestamp in the directory of the mirror is in-sync with the upstream. Then, for each CSC mirror, a class is built which inherits from the general project.py class but often overrides the original check function with a check function specific to the mirror. A few big themes are: some check a mirror status tracker provided by the project mirrored; some check all the Release files for each version in a distro etc. website information which all the mirror checker classes need is stored in the data.json file.

Future notes: Because many of the mirror checkers are built very specific to each mirror. A slight change in the way the project manages their mirror-related websites, public repos etc. can drastically influence whether the mirror checker works correctly or not. These problems are also unfortunately very hard to detect, so it's important that CSC actively maintain the mirror checker so that it works as intended in the long term.

Extra notes: A test client for individual mirror checker classes is provided as test.py. To use it, simply change all occurrences of the imported project class

Resources

if we can just view their repo online, we only have to remember the link for their repo and then check the latest timestamp in their repo the same way we check ours

even if the date relies on a specific file in their repo, we can still find the right link for it

to find repos of the mirrored projects to check, just search "projectName mirrors"

Checker Information