fix: Return structured errors from GFAL2 storage operations

[chrisburr]

Summary

• Return error dictionaries with errno codes from exists() and getFileMetadata() in GFAL2_StorageBase
• Captures gfal2.GError separately to extract the e.code (errno)
• Allows consumers to distinguish between different error types (e.g., ENOENT vs EACCES)

See: https://gitlab.cern.ch/lhcb-dirac/LHCbDIRAC/-/merge_requests/1870

Motivation

When a storage element returns HTTP 401 (Permission Denied / Authentication Error), dirac-dms-check-fc2se incorrectly reports files as "missing at SEs". This is because all files in metadata["Failed"] are treated as "not existing" regardless of the actual error type.

By returning structured error information with errno codes, downstream code can properly handle permission denied errors separately from file-not-found errors, avoiding false positives.

Changes

The error format changes from:

failed[url] = repr(e)  # string

to:

failed[url] = {"error": repr(e), "errno": e.code}  # dict with errno

Backward Compatibility

Downstream code should handle both the old string format and new dict format during the transition period:

if isinstance(err_info, dict):
    err_code = err_info.get("errno")
else:
    err_code = None  # Legacy string format

[chaen]

Ouuuuh dangerous !

[chaen]

We tried such things in the past and it was a disaster because upper in the chain we do string comparisons which of course break against the dictionary

[chaen]

that was merged too quickly, it needs to be carefully checked

[chaen]

just to add, I am happy with the idea, but we never converged on a way to do it. Maybe time to rethink it globally.

[chaen]

Btw that's why DErrno.cmpError also can take a string as input. It was to provide a migration path. It should work for he LHCbDIRAC MR I think