File access: locations in, bytes out — over local files, S3, GCS, Azure or plain HTTP.
Iceberg metadata stores absolute locations — a manifest list names its
manifests by full URI, a manifest names its data files by full URI. That is
fine in place and awkward everywhere else: a table copied to another path, a
warehouse mounted somewhere new, or a test fixture checked into a repo all need
those locations redirected without touching the metadata. FileIO therefore
resolves every location through an ordered list of prefix rewrites before
opening it. FileIO.local() does none; rebase(old, new) adds one.
The backends come from objectstore.mojo:
FileIOResolver picks one by URI scheme, configures it from Iceberg property
names (s3.endpoint, s3.access-key-id, gcs.oauth2.token,
adls.sas-token.<account>, …) and from the storage-credentials a REST
catalog vends, and falls back to the AWS_* environment. Everything above this
line only ever sees a location and a byte range.
InputFile is objectstore's trait, a superset of the one this module used to
declare: location, exists, read_all as before, plus length and
read_range, which is what a Parquet reader needs in order to fetch a footer
without downloading the whole file.