Registry / data / fsspec-xrootd

fsspec-xrootd

library0.5.5pypypi✓ verified 85d ago

Provides an fsspec-compatible interface for the XRootD protocol, enabling access to remote storage systems (e.g., EOS, storage elements) via a unified filesystem-like API. Current version 0.5.4, supports Python >=3.9. Releases follow a relatively stable cadence.

data http-networking

pip install fsspec-xrootd

github ↗package ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · FSSPEC-XROOTD

fsspec-xrootd

datapythonv0.5.5

Install

2.4s avg

Import

306ms

Disk

43MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.5.5 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.4s · import 0.306s · 45MB

43MB installed

● package 43MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

XRootDFileSystem

✓ from fsspec_xrootd import XRootDFileSystem

The correct import as of 0.5.x.

XRootDFileSystem

✓ from fsspec.implementations.xrootd import XRootDFileSystem

Also works via fsspec's implementation registry.

xrootd

✓

✗ import xrootd

This imports the low-level xrootd bindings, not the fsspec implementation.

XRootDFilesystem

✓

✗ from fsspec_xrootd import XRootDFilesystem

Letter case typo: 'Filesystem' vs 'FileSystem' (capital S).

Minimal example to create an XRootDFileSystem and list files. The XRootD client must be installed and configured (if using authentication, set XROOTD_VOMS environment variable).

import os from fsspec_xrootd import XRootDFileSystem # Example: list files at a root (adjust URL as needed) fs = XRootDFileSystem() files = fs.ls('/user/test') print(files)

Debug

Known issues

breakingIn version 0.5.0, the import path changed from `fsspec_xrootd.XRootDFileSystem` to the current one. Old code using `fsspec.implementations.xrootd` still works but may break if internal refactoring occurs.

fix

Update imports to `from fsspec_xrootd import XRootDFileSystem`.

affects: <0.5.0

gotchaThe XRootD Python bindings (PyPI: xrootd) are not automatically installed. Users must install them separately (e.g., via conda or system package manager). Failure to do so results in `ModuleNotFoundError: No module named 'XRootD'`.

fix

Install XRootD Python bindings: `conda install xrootd` or `apt install python3-xrootd` (system).

affects: all

gotchaAuthentication requires environment variables like `XROOTD_VOMS` or `XRDX509USERPROXY`. Without them, many operations silently fail or return empty results.

fix

Ensure credentials are set (e.g., `export XROOTD_VOMS=...`) before using the filesystem.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'XRootD'

XRootD Python bindings are missing

fix

Install XRootD: `conda install xrootd` or via system package manager (e.g., `apt install python3-xrootd`).

FileNotFoundError: [Errno 2] No such file or directory: '/some/path'

Path might not exist or authentication failure causes empty listing

fix

Check credentials (XROOTD_VOMS, proxy) and verify path exists. Use `fs.ls('/')` first to list root.

ImportError: cannot import name 'XRootDFileSystem' from 'fsspec_xrootd'

Typo in class name (capitalization) or outdated version (<0.5.0).

fix

Use correct capitalization: `XRootDFileSystem` (capital S). For older versions, check fsspec.implementations.xrootd.

Upgrade

Version history

0.5.5latest on PyPI · released Jun 1, 2026

Audit

Dependencies

fsspecrequiredCore library that this package extends

XRootDrequiredPython bindings for the XRootD client; must be installed separately (e.g., via conda or system package)

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/scikit-hep/fsspec-xrootd ↗

packagehttps://pypi.org/project/fsspec-xrootd/ ↗

docshttps://fsspec_xrootd.readthedocs.io/ ↗

changeloghttps://github.com/scikit-hep/fsspec-xrootd/releases ↗