xrdcore

The small, dependency-free core shared by xrdclient, xgfalclient and xrdarc. Nothing protocol-specific lives here, and nothing that needs a third-party package to import.

import xrdcore imports no submodule; each loads when first named.

from xrdcore import checksum, safexml

digest = checksum.new("adler32")
digest.update(b"hello world\n")
digest.hexdigest()            # '1e720467'

safexml.fromstring(b"<!DOCTYPE x><x/>")   # raises UnsafeXML

Development

In the workspace every package is installed editable into the shared interpreter, so the tests import the source tree. On a fresh checkout:

cd xrdcore
python -m pip install -e '.[dev,fast]'
python -m pytest -q -n 6 --cov=xrdcore      # 100 % line + branch, enforced (fail_under)
ruff check src tests && ruff format --check src tests
mypy                                        # strict, over src and tests
complexipy                                  # no function above 15, no snapshot
python -m build && twine check dist/*       # the wheel ships py.typed

Without the fast extra the CRC-32C tests still pass: they cover the pure-Python path, and the accelerated one through a stand-in module.

Licence

LGPL-3.0-or-later; see LICENSE and COPYING.