update build instructions by rabernat · Pull Request #1020 · earth-mover/icechunk

rabernat · 2025-06-30T14:41:07Z

This update reflects my attempt to get the docs building locally.

Despite this, I am still unable to get the docs building. I am getting many WARNING - markdown_exec: Execution of python code block exited with errors which indicate some problem with my environment.

@ianhi - do you have any guidance for getting a local doc build environment working beyond what I have documented in this PR?

Error Log

I had to shorten the full stack trace to get GH to allow me to paste.

...
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [dask](/icechunk-python/dask)
WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             import dask.array as da
             shape = (100, 100)
             dask_chunks = (20, 20)
             dask_array = da.random.random(shape, chunks=dask_chunks)

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session dask; n2>", line 1, in <module>
                 import dask.array as da
             ModuleNotFoundError: No module named 'dask'

WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             import zarr

             zarr_chunks = (10, 10)
             group = zarr.group(store=icechunk_session.store, overwrite=True)

             zarray = group.create_array(
                 "array",
                 shape=shape,
                 chunks=zarr_chunks,
                 dtype="f8",
                 fill_value=float("nan"),
             )

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session dask; n3>", line 8, in <module>
                 shape=shape,
                       ^^^^^
             NameError: name 'shape' is not defined

WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             import icechunk.dask

             icechunk.dask.store_dask(
                 icechunk_session,
                 sources=[dask_array],
                 targets=[zarray]
             )

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session dask; n4>", line 1, in <module>
                 import icechunk.dask
               File "/Users/rabernat/gh/earth-mover/icechunk/icechunk-python/python/icechunk/dask.py", line 8, in <module>
                 import dask
             ModuleNotFoundError: No module named 'dask'

WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:


             from distributed import Client
             client = Client()

             import icechunk.dask

             # start a new session. Old session is readonly after committing

             icechunk_session = icechunk_repo.writable_session("main")
             zarr_chunks = (10, 10)
             with icechunk_session.allow_pickling():
                 group = zarr.group(
                     store=icechunk_session.store,
                     overwrite=True
                 )

                 zarray = group.create_array(
                     "array",
                     shape=shape,
                     chunks=zarr_chunks,
                     dtype="f8",
                     fill_value=float("nan"),
                 )

                 icechunk.dask.store_dask(
                     icechunk_session,
                     sources=[dask_array],
                     targets=[zarray]
                 )
             print(icechunk_session.commit("wrote a dask array!"))

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session dask; n6>", line 2, in <module>
                 from distributed import Client
             ModuleNotFoundError: No module named 'distributed'

WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             import icechunk.xarray
             import xarray as xr

             icechunk_session = icechunk_repo.writable_session("main")
             dataset = xr.tutorial.open_dataset(
                 "rasm",
                 chunks={"time": 1}).isel(time=slice(24)
                 )

             # `to_icechunk` takes care of "allow_pickling" for you
             icechunk.xarray.to_icechunk(dataset, icechunk_session, mode="w")

             with icechunk_session.allow_pickling():
                 roundtripped = xr.open_zarr(icechunk_session.store, consolidated=False)
                 print(dataset.identical(roundtripped))

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session dask; n7>", line 1, in <module>
                 import icechunk.xarray
               File "/Users/rabernat/gh/earth-mover/icechunk/icechunk-python/python/icechunk/xarray.py", line 9, in <module>
                 import xarray as xr
             ModuleNotFoundError: No module named 'xarray'

WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             print(icechunk_session.commit("wrote an Xarray dataset!"))

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session dask; n8>", line 1, in <module>
                 print(icechunk_session.commit("wrote an Xarray dataset!"))
                       ~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/gh/earth-mover/icechunk/icechunk-python/python/icechunk/session.py", line 213, in commit
                 return self._session.commit(
                        ~~~~~~~~~~~~~~~~~~~~^
                     message, metadata, rebase_with=rebase_with, rebase_tries=rebase_tries
                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                 )
                 ^
             icechunk.IcechunkError:   × session error: Read only sessions cannot modify the repository
               │
               │ context:
               │    0: icechunk::session::_commit
               │            with wrote an Xarray dataset! rewrite_manifests=false
               │              at icechunk/src/session.rs:979
               │    1: icechunk::session::commit
               │            with wrote an Xarray dataset!
               │              at icechunk/src/session.rs:942
               │


WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             # handy when running mkdocs serve locally
             client.shutdown();

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session dask; n9>", line 2, in <module>
                 client.shutdown();
                 ^^^^^^
             NameError: name 'client' is not defined

INFO    -  Doc file 'icechunk-python/dask.md' contains an absolute link '/', it was left as is. Did you mean '../index.md'?
INFO    -  Doc file 'icechunk-python/dask.md' contains an absolute link '/icechunk-python', it was left as is. Did you mean 'index.md'?
INFO    -  Doc file 'icechunk-python/dask.md' contains an absolute link '/icechunk-python/dask', it was left as is. Did you mean 'dask.md'?
2025-06-30 10:37:59,823 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [expiration](/icechunk-python/expiration)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [expiration](/icechunk-python/expiration)
INFO    -  Doc file 'icechunk-python/expiration.md' contains an absolute link '/', it was left as is. Did you mean '../index.md'?
INFO    -  Doc file 'icechunk-python/expiration.md' contains an absolute link '/icechunk-python', it was left as is. Did you mean 'index.md'?
INFO    -  Doc file 'icechunk-python/expiration.md' contains an absolute link '/icechunk-python/expiration', it was left as is. Did you mean
           'expiration.md'?
2025-06-30 10:38:01,053 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [faq](/icechunk-python/faq)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [faq](/icechunk-python/faq)
INFO    -  Doc file 'icechunk-python/faq.md' contains an absolute link '/', it was left as is. Did you mean '../index.md'?
INFO    -  Doc file 'icechunk-python/faq.md' contains an absolute link '/icechunk-python', it was left as is. Did you mean 'index.md'?
INFO    -  Doc file 'icechunk-python/faq.md' contains an absolute link '/icechunk-python/faq', it was left as is. Did you mean 'faq.md'?
2025-06-30 10:38:01,099 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [parallel](/icechunk-python/parallel)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [parallel](/icechunk-python/parallel)
WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             import xarray as xr
             import tempfile
             from icechunk import Repository, local_filesystem_storage

             ds = xr.tutorial.open_dataset("rasm").isel(time=slice(24))
             repo = Repository.create(local_filesystem_storage(tempfile.TemporaryDirectory().name))
             session = repo.writable_session("main")

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session parallel; n1>", line 1, in <module>
                 import xarray as xr
             ModuleNotFoundError: No module named 'xarray'

WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             chunks = {1 if dim == "time" else ds.sizes[dim] for dim in ds.Tair.dims}

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session parallel; n2>", line 1, in <module>
                 chunks = {1 if dim == "time" else ds.sizes[dim] for dim in ds.Tair.dims}
                                                                            ^^
             NameError: name 'ds' is not defined

WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             ds.to_zarr(session.store, compute=False, encoding={"Tair": {"chunks": chunks}}, mode="w")
             # this commit is optional, but may be useful in your workflow
             print(session.commit("initialize store"))

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session parallel; n3>", line 1, in <module>
                 ds.to_zarr(session.store, compute=False, encoding={"Tair": {"chunks": chunks}}, mode="w")
                 ^^
             NameError: name 'ds' is not defined

WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             ondisk = xr.open_zarr(repo.readonly_session("main").store, consolidated=False)
             xr.testing.assert_identical(ds, ondisk)

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session parallel; n5>", line 1, in <module>
                 ondisk = xr.open_zarr(repo.readonly_session("main").store, consolidated=False)
                          ^^
             NameError: name 'xr' is not defined

INFO    -  Doc file 'icechunk-python/parallel.md' contains an absolute link '/', it was left as is. Did you mean '../index.md'?
INFO    -  Doc file 'icechunk-python/parallel.md' contains an absolute link '/icechunk-python', it was left as is. Did you mean 'index.md'?
INFO    -  Doc file 'icechunk-python/parallel.md' contains an absolute link '/icechunk-python/parallel', it was left as is. Did you mean 'parallel.md'?
2025-06-30 10:38:01,162 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [performance](/icechunk-python/performance)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [performance](/icechunk-python/performance)
INFO    -  Doc file 'icechunk-python/performance.md' contains an absolute link '/', it was left as is. Did you mean '../index.md'?
INFO    -  Doc file 'icechunk-python/performance.md' contains an absolute link '/icechunk-python', it was left as is. Did you mean 'index.md'?
INFO    -  Doc file 'icechunk-python/performance.md' contains an absolute link '/icechunk-python/performance', it was left as is. Did you mean
           'performance.md'?
2025-06-30 10:38:01,264 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [quickstart](/icechunk-python/quickstart)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [quickstart](/icechunk-python/quickstart)
INFO    -  Doc file 'icechunk-python/quickstart.md' contains an absolute link '/', it was left as is. Did you mean '../index.md'?
INFO    -  Doc file 'icechunk-python/quickstart.md' contains an absolute link '/icechunk-python', it was left as is. Did you mean 'index.md'?
INFO    -  Doc file 'icechunk-python/quickstart.md' contains an absolute link '/icechunk-python/quickstart', it was left as is. Did you mean
           'quickstart.md'?
2025-06-30 10:38:01,344 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [reference](/icechunk-python/reference)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [reference](/icechunk-python/reference)
INFO    -  mkdocstrings_handlers: Formatting signatures requires either Black or Ruff to be installed.
INFO    -  Doc file 'icechunk-python/reference.md' contains an absolute link '/icechunk-python/parallel#uncooperative-distributed-writes', it was left as
           is. Did you mean 'parallel.md#uncooperative-distributed-writes'?
INFO    -  Doc file 'icechunk-python/reference.md' contains an absolute link '/icechunk-python/parallel#uncooperative-distributed-writes', it was left as
           is. Did you mean 'parallel.md#uncooperative-distributed-writes'?
INFO    -  Doc file 'icechunk-python/reference.md' contains an absolute link '/', it was left as is. Did you mean '../index.md'?
INFO    -  Doc file 'icechunk-python/reference.md' contains an absolute link '/icechunk-python', it was left as is. Did you mean 'index.md'?
INFO    -  Doc file 'icechunk-python/reference.md' contains an absolute link '/icechunk-python/reference', it was left as is. Did you mean
           'reference.md'?
2025-06-30 10:38:01,837 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [storage](/icechunk-python/storage)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [storage](/icechunk-python/storage)
INFO    -  Doc file 'icechunk-python/storage.md' contains an absolute link '/', it was left as is. Did you mean '../index.md'?
INFO    -  Doc file 'icechunk-python/storage.md' contains an absolute link '/icechunk-python', it was left as is. Did you mean 'index.md'?
INFO    -  Doc file 'icechunk-python/storage.md' contains an absolute link '/icechunk-python/storage', it was left as is. Did you mean 'storage.md'?
2025-06-30 10:38:01,898 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [version-control](/icechunk-python/version-control)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [version-control](/icechunk-python/version-control)
INFO    -  DeprecationWarning: Use Group.create_array instead.
             File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/warnings.py", line 636, in wrapper
               warn(msg, category=category, stacklevel=stacklevel + 1)
             File "<code block: session version; n30>", line 9, in
INFO    -  DeprecationWarning: Use AsyncGroup.create_array instead.
             File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/zarr/core/group.py", line 2529, in create_dataset
               return Array(self._sync(self._async_group.create_dataset(name, **kwargs)))
             File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/warnings.py", line 636, in wrapper
               warn(msg, category=category, stacklevel=stacklevel + 1)
INFO    -  Doc file 'icechunk-python/version-control.md' contains an absolute link '/', it was left as is. Did you mean '../index.md'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an absolute link '/icechunk-python', it was left as is. Did you mean 'index.md'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an absolute link '/icechunk-python/version-control', it was left as is. Did you mean
           'version-control.md'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link '../reference/#icechunk.Repository', it was left as is.
           Did you mean 'reference.md#icechunk.Repository'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link './reference/#icechunk.Repository.ancestry', it was left
           as is. Did you mean 'reference.md#icechunk.Repository.ancestry'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link '../reference/#icechunk.SnapshotInfo', it was left as is.
           Did you mean 'reference.md#icechunk.SnapshotInfo'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link '../reference/#icechunk.Repository.create_branch', it was
           left as is. Did you mean 'reference.md#icechunk.Repository.create_branch'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link '../reference/#icechunk.Repository.list_branches', it was
           left as is. Did you mean 'reference.md#icechunk.Repository.list_branches'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link '../reference/#icechunk.Repository.lookup_branch', it was
           left as is. Did you mean 'reference.md#icechunk.Repository.lookup_branch'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link '../reference/#icechunk.Repository.delete_branch', it was
           left as is. Did you mean 'reference.md#icechunk.Repository.delete_branch'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link '../reference/#icechunk.Repository.delete_branch', it was
           left as is. Did you mean 'reference.md#icechunk.Repository.delete_branch'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link '../reference/#icechunk.Repository.reset_branch', it was
           left as is. Did you mean 'reference.md#icechunk.Repository.reset_branch'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link '../reference/#icechunk.Repository.reset_branch', it was
           left as is. Did you mean 'reference.md#icechunk.Repository.reset_branch'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link '../reference/#icechunk.Repository.create_tag', it was
           left as is. Did you mean 'reference.md#icechunk.Repository.create_tag'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link '../reference/#icechunk.Repository.list_tags', it was
           left as is. Did you mean 'reference.md#icechunk.Repository.list_tags'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link '../reference/#icechunk.Repository.lookup_tag', it was
           left as is. Did you mean 'reference.md#icechunk.Repository.lookup_tag'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link '../reference/#icechunk.Repository.delete_tag', it was
           left as is. Did you mean 'reference.md#icechunk.Repository.delete_tag'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link '../reference/#icechunk.ConflictError', it was left as
           is. Did you mean 'reference.md#icechunk.ConflictError'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link '../reference/#icechunk.Session.rebase', it was left as
           is. Did you mean 'reference.md#icechunk.Session.rebase'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link '../reference/#icechunk.Session.rebase', it was left as
           is. Did you mean 'reference.md#icechunk.Session.rebase'?
INFO    -  Doc file 'icechunk-python/version-control.md' contains an unrecognized relative link '../reference/#icechunk.BasicConflictSolver', it was left
           as is. Did you mean 'reference.md#icechunk.BasicConflictSolver'?
2025-06-30 10:38:02,056 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [virtual](/icechunk-python/virtual)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [virtual](/icechunk-python/virtual)
INFO    -  Doc file 'icechunk-python/virtual.md' contains an absolute link '/', it was left as is. Did you mean '../index.md'?
INFO    -  Doc file 'icechunk-python/virtual.md' contains an absolute link '/icechunk-python', it was left as is. Did you mean 'index.md'?
INFO    -  Doc file 'icechunk-python/virtual.md' contains an absolute link '/icechunk-python/virtual', it was left as is. Did you mean 'virtual.md'?
2025-06-30 10:38:02,104 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [xarray](/icechunk-python/xarray)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [xarray](/icechunk-python/xarray)
WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             import xarray as xr
             import icechunk

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session xarray; n1>", line 1, in <module>
                 import xarray as xr
             ModuleNotFoundError: No module named 'xarray'

WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             import tempfile
             storage_config = icechunk.local_filesystem_storage(tempfile.TemporaryDirectory().name)
             repo = icechunk.Repository.create(storage_config)

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session xarray; n2>", line 2, in <module>
                 storage_config = icechunk.local_filesystem_storage(tempfile.TemporaryDirectory().name)
                                  ^^^^^^^^
             NameError: name 'icechunk' is not defined

WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             ds = xr.tutorial.open_dataset('rasm')

             ds1 = ds.isel(time=slice(None, 18))  # part 1
             ds2 = ds.isel(time=slice(18, None))  # part 2

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session xarray; n3>", line 1, in <module>
                 ds = xr.tutorial.open_dataset('rasm')
                      ^^
             NameError: name 'xr' is not defined

WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             session = repo.writable_session("main")

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session xarray; n4>", line 1, in <module>
                 session = repo.writable_session("main")
                           ^^^^
             NameError: name 'repo' is not defined. Did you mean: 'repr'?

WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             from icechunk.xarray import to_icechunk

             to_icechunk(ds, session)

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session xarray; n5>", line 1, in <module>
                 from icechunk.xarray import to_icechunk
               File "/Users/rabernat/gh/earth-mover/icechunk/icechunk-python/python/icechunk/xarray.py", line 9, in <module>
                 import xarray as xr
             ModuleNotFoundError: No module named 'xarray'

WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             first_snapshot = session.commit("add RASM data to store")
             print(first_snapshot)

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session xarray; n6>", line 1, in <module>
                 first_snapshot = session.commit("add RASM data to store")
                                  ^^^^^^^
             NameError: name 'session' is not defined

WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             # we have to get a new session after committing
             session = repo.writable_session("main")
             to_icechunk(ds2, session, append_dim='time')

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session xarray; n7>", line 2, in <module>
                 session = repo.writable_session("main")
                           ^^^^
             NameError: name 'repo' is not defined. Did you mean: 'repr'?

WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             print(session.commit("append more data"))

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session xarray; n8>", line 1, in <module>
                 print(session.commit("append more data"))
                       ^^^^^^^
             NameError: name 'session' is not defined

WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             xr.set_options(display_style="text")
             print(xr.open_zarr(session.store, consolidated=False))

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session xarray; n9>", line 1, in <module>
                 xr.set_options(display_style="text")
                 ^^
             NameError: name 'xr' is not defined

WARNING -  markdown_exec: Execution of python code block exited with errors

           Code block is:

             session = repo.readonly_session(snapshot_id=first_snapshot)

             print(xr.open_zarr(session.store, consolidated=False))

           Output is:

             Traceback (most recent call last):
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/python.py", line 71,
           in _run_python
                 exec_python(code, code_block_id, exec_globals)
                 ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
               File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/markdown_exec/_internal/formatters/_exec_python.py", line
           8, in exec_python
                 exec(compiled, exec_globals)  # noqa: S102
                 ~~~~^^^^^^^^^^^^^^^^^^^^^^^^
               File "<code block: session xarray; n10>", line 1, in <module>
                 session = repo.readonly_session(snapshot_id=first_snapshot)
                           ^^^^
             NameError: name 'repo' is not defined. Did you mean: 'repr'?

INFO    -  Doc file 'icechunk-python/xarray.md' contains an absolute link '/', it was left as is. Did you mean '../index.md'?
INFO    -  Doc file 'icechunk-python/xarray.md' contains an absolute link '/icechunk-python', it was left as is. Did you mean 'index.md'?
INFO    -  Doc file 'icechunk-python/xarray.md' contains an absolute link '/icechunk-python/xarray', it was left as is. Did you mean 'xarray.md'?
INFO    -  Doc file 'icechunk-python/xarray.md' contains an absolute link '/icechunk-python/quickstart/', it was left as is. Did you mean
           'quickstart.md'?
2025-06-30 10:38:02,160 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [cheatsheets](/icechunk-python/cheatsheets)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [cheatsheets](/icechunk-python/cheatsheets)
INFO    -  Doc file 'icechunk-python/cheatsheets/index.md' contains an absolute link '/', it was left as is. Did you mean '../../index.md'?
INFO    -  Doc file 'icechunk-python/cheatsheets/index.md' contains an absolute link '/icechunk-python', it was left as is. Did you mean '../index.md'?
INFO    -  Doc file 'icechunk-python/cheatsheets/index.md' contains an absolute link '/icechunk-python/cheatsheets', it was left as is. Did you mean
           'index.md'?
INFO    -  Doc file 'icechunk-python/cheatsheets/index.md' contains an absolute link '/icechunk-python/cheatsheets/git-users/', it was left as is. Did
           you mean 'git-users.md'?
2025-06-30 10:38:02,201 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [cheatsheets](/icechunk-python/cheatsheets) / [git-users](/icechunk-python/cheatsheets/git-users)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [cheatsheets](/icechunk-python/cheatsheets) /
           [git-users](/icechunk-python/cheatsheets/git-users)
INFO    -  Doc file 'icechunk-python/cheatsheets/git-users.md' contains an absolute link '/', it was left as is. Did you mean '../../index.md'?
INFO    -  Doc file 'icechunk-python/cheatsheets/git-users.md' contains an absolute link '/icechunk-python', it was left as is. Did you mean
           '../index.md'?
INFO    -  Doc file 'icechunk-python/cheatsheets/git-users.md' contains an absolute link '/icechunk-python/cheatsheets', it was left as is. Did you mean
           'index.md'?
INFO    -  Doc file 'icechunk-python/cheatsheets/git-users.md' contains an absolute link '/icechunk-python/cheatsheets/git-users', it was left as is. Did
           you mean 'git-users.md'?
2025-06-30 10:38:02,241 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [examples](/icechunk-python/examples) / [bank_accounts](/icechunk-python/examples/bank_accounts)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [examples](/icechunk-python/examples) /
           [bank_accounts](/icechunk-python/examples/bank_accounts)
INFO    -  Converting notebook (execute=False): /Users/rabernat/gh/earth-mover/icechunk/docs/docs/icechunk-python/examples/bank_accounts.py
2025-06-30 10:38:02,761 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [examples](/icechunk-python/examples) / [dask_write](/icechunk-python/examples/dask_write)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [examples](/icechunk-python/examples) /
           [dask_write](/icechunk-python/examples/dask_write)
INFO    -  Converting notebook (execute=False): /Users/rabernat/gh/earth-mover/icechunk/docs/docs/icechunk-python/examples/dask_write.py
2025-06-30 10:38:03,285 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [examples](/icechunk-python/examples) / [high_concurrency](/icechunk-python/examples/high_concurrency)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [examples](/icechunk-python/examples) /
           [high_concurrency](/icechunk-python/examples/high_concurrency)
INFO    -  Converting notebook (execute=False): /Users/rabernat/gh/earth-mover/icechunk/docs/docs/icechunk-python/examples/high_concurrency.py
2025-06-30 10:38:03,880 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [examples](/icechunk-python/examples) / [mpwrite](/icechunk-python/examples/mpwrite)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [examples](/icechunk-python/examples) /
           [mpwrite](/icechunk-python/examples/mpwrite)
INFO    -  Converting notebook (execute=False): /Users/rabernat/gh/earth-mover/icechunk/docs/docs/icechunk-python/examples/mpwrite.py
2025-06-30 10:38:06,701 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [ingestion](/icechunk-python/ingestion) / [glad-ingest](/icechunk-python/ingestion/glad-ingest)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [ingestion](/icechunk-python/ingestion) /
           [glad-ingest](/icechunk-python/ingestion/glad-ingest)
INFO    -  Converting notebook (execute=False): /Users/rabernat/gh/earth-mover/icechunk/docs/docs/icechunk-python/ingestion/glad-ingest.ipynb
2025-06-30 10:38:07,504 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) / [conflict](/icechunk-python/notebooks/conflict)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) /
           [conflict](/icechunk-python/notebooks/conflict)
INFO    -  Converting notebook (execute=False): /Users/rabernat/gh/earth-mover/icechunk/docs/docs/icechunk-python/notebooks/conflict.ipynb
2025-06-30 10:38:08,016 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) / [demo-azure-blob](/icechunk-python/notebooks/demo-azure-blob)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) /
           [demo-azure-blob](/icechunk-python/notebooks/demo-azure-blob)
INFO    -  Converting notebook (execute=False): /Users/rabernat/gh/earth-mover/icechunk/docs/docs/icechunk-python/notebooks/demo-azure-blob.ipynb
2025-06-30 10:38:08,493 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) / [demo-dummy-data](/icechunk-python/notebooks/demo-dummy-data)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) /
           [demo-dummy-data](/icechunk-python/notebooks/demo-dummy-data)
INFO    -  Converting notebook (execute=False): /Users/rabernat/gh/earth-mover/icechunk/docs/docs/icechunk-python/notebooks/demo-dummy-data.ipynb
2025-06-30 10:38:09,149 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) / [demo-gcs](/icechunk-python/notebooks/demo-gcs)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) /
           [demo-gcs](/icechunk-python/notebooks/demo-gcs)
INFO    -  Converting notebook (execute=False): /Users/rabernat/gh/earth-mover/icechunk/docs/docs/icechunk-python/notebooks/demo-gcs.ipynb
2025-06-30 10:38:09,682 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) / [demo-s3](/icechunk-python/notebooks/demo-s3)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) /
           [demo-s3](/icechunk-python/notebooks/demo-s3)
INFO    -  Converting notebook (execute=False): /Users/rabernat/gh/earth-mover/icechunk/docs/docs/icechunk-python/notebooks/demo-s3.ipynb
2025-06-30 10:38:10,247 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) / [expiration](/icechunk-python/notebooks/expiration)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) /
           [expiration](/icechunk-python/notebooks/expiration)
INFO    -  Converting notebook (execute=False): /Users/rabernat/gh/earth-mover/icechunk/docs/docs/icechunk-python/notebooks/expiration.ipynb
2025-06-30 10:38:10,781 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) / [memorystore](/icechunk-python/notebooks/memorystore)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) /
           [memorystore](/icechunk-python/notebooks/memorystore)
INFO    -  Converting notebook (execute=False): /Users/rabernat/gh/earth-mover/icechunk/docs/docs/icechunk-python/notebooks/memorystore.ipynb
2025-06-30 10:38:11,298 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) / [version-control](/icechunk-python/notebooks/version-control)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) /
           [version-control](/icechunk-python/notebooks/version-control)
INFO    -  Converting notebook (execute=False): /Users/rabernat/gh/earth-mover/icechunk/docs/docs/icechunk-python/notebooks/version-control.ipynb
2025-06-30 10:38:11,950 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) / [performance](/icechunk-python/notebooks/performance) / [era5_xarray-Icechunk](/icechunk-python/notebooks/performance/era5_xarray-Icechunk)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) /
           [performance](/icechunk-python/notebooks/performance) / [era5_xarray-Icechunk](/icechunk-python/notebooks/performance/era5_xarray-Icechunk)
INFO    -  Converting notebook (execute=False):
           /Users/rabernat/gh/earth-mover/icechunk/docs/docs/icechunk-python/notebooks/performance/era5_xarray-Icechunk.ipynb
2025-06-30 10:38:12,615 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) / [performance](/icechunk-python/notebooks/performance) / [era5_xarray-zarr2](/icechunk-python/notebooks/performance/era5_xarray-zarr2)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) /
           [performance](/icechunk-python/notebooks/performance) / [era5_xarray-zarr2](/icechunk-python/notebooks/performance/era5_xarray-zarr2)
INFO    -  Converting notebook (execute=False):
           /Users/rabernat/gh/earth-mover/icechunk/docs/docs/icechunk-python/notebooks/performance/era5_xarray-zarr2.ipynb
2025-06-30 10:38:13,197 - mkdocs.plugins.breadcrumbs - INFO - Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) / [performance](/icechunk-python/notebooks/performance) / [era5_xarray-zarr3](/icechunk-python/notebooks/performance/era5_xarray-zarr3)
INFO    -  Generated breadcrumb string: [Home](/) / [icechunk-python](/icechunk-python) / [notebooks](/icechunk-python/notebooks) /
           [performance](/icechunk-python/notebooks/performance) / [era5_xarray-zarr3](/icechunk-python/notebooks/performance/era5_xarray-zarr3)
INFO    -  Converting notebook (execute=False):
           /Users/rabernat/gh/earth-mover/icechunk/docs/docs/icechunk-python/notebooks/performance/era5_xarray-zarr3.ipynb
Traceback (most recent call last):
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/mkdocs_autorefs/_internal/plugin.py", line 484, in _get_urls
    return self._primary_url_map[identifier], "primary"
           ~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^
KeyError: 'icechunk._icechunk_python.ConflictError'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/mkdocs_autorefs/_internal/plugin.py", line 496, in _get_item_url
    urls, qualifier = self._get_urls(identifier)
                      ~~~~~~~~~~~~~~^^^^^^^^^^^^
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/mkdocs_autorefs/_internal/plugin.py", line 486, in _get_urls
    return self._secondary_url_map[identifier], "secondary"
           ~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^
KeyError: 'icechunk._icechunk_python.ConflictError'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/_griffe/models.py", line 1753, in _resolve_target
    resolved.resolve_target()
    ~~~~~~~~~~~~~~~~~~~~~~~^^
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/_griffe/models.py", line 1737, in resolve_target
    raise CyclicAliasError([self.target_path])
_griffe.exceptions.CyclicAliasError: Cyclic aliases detected:
  icechunk.ConflictError

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/_griffe/models.py", line 1753, in _resolve_target
    resolved.resolve_target()
    ~~~~~~~~~~~~~~~~~~~~~~~^^
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/_griffe/models.py", line 1740, in resolve_target
    self._resolve_target()
    ~~~~~~~~~~~~~~~~~~~~^^
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/_griffe/models.py", line 1755, in _resolve_target
    raise CyclicAliasError([self.target_path, *error.chain]) from error
_griffe.exceptions.CyclicAliasError: Cyclic aliases detected:
  icechunk._icechunk_python.ConflictError
  icechunk.ConflictError

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/bin/mkdocs", line 8, in <module>
    sys.exit(cli())
             ~~~^^
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/click/core.py", line 1442, in __call__
    return self.main(*args, **kwargs)
           ~~~~~~~~~^^^^^^^^^^^^^^^^^
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/click/core.py", line 1363, in main
    rv = self.invoke(ctx)
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/click/core.py", line 1830, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
                           ~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/click/core.py", line 1226, in invoke
    return ctx.invoke(self.callback, **ctx.params)
           ~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/click/core.py", line 794, in invoke
    return callback(*args, **kwargs)
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/mkdocs/__main__.py", line 288, in build_command
    build.build(cfg, dirty=not clean)
    ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/mkdocs/commands/build.py", line 319, in build
    env = config.plugins.on_env(env, config=config, files=files)
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/mkdocs/plugins.py", line 599, in on_env
    return self.run_event('env', env, config=config, files=files)
           ~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/mkdocs/plugins.py", line 566, in run_event
    result = method(item, **kwargs)
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/mkdocs_autorefs/_internal/plugin.py", line 281, in on_env
    file.page.content, unmapped = fix_refs(
                                  ~~~~~~~~^
        file.page.content,
        ^^^^^^^^^^^^^^^^^^
    ...<4 lines>...
        _legacy_refs=self.legacy_refs,
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    )
    ^
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/mkdocs_autorefs/_internal/references.py", line 564, in fix_refs
    html = AUTOREF_RE.sub(
        fix_ref(url_mapper, unmapped, record_backlink, link_titles=link_titles, strip_title_tags=strip_title_tags),
        html,
    )
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/mkdocs_autorefs/_internal/references.py", line 499, in inner
    url, original_title = _find_url(identifiers, url_mapper)
                          ~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/mkdocs_autorefs/_internal/references.py", line 586, in _find_url
    return url_mapper(identifier)
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/mkdocs_autorefs/_internal/plugin.py", line 539, in get_item_url
    url = self._get_item_url(identifier, from_url, fallback)
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/mkdocs_autorefs/_internal/plugin.py", line 502, in _get_item_url
    new_identifiers = fallback(identifier)
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/mkdocstrings/_internal/handlers/base.py", line 632, in get_anchors
    aliases = handler.get_aliases(identifier)
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/mkdocstrings_handlers/python/_internal/handler.py", line 354, in get_aliases
    for alias in [data.canonical_path, *data.aliases]:
                  ^^^^^^^^^^^^^^^^^^^
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/_griffe/models.py", line 1469, in canonical_path
    return self.final_target.canonical_path
           ^^^^^^^^^^^^^^^^^
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/_griffe/models.py", line 1708, in final_target
    target = target.target  # type: ignore[assignment]
             ^^^^^^^^^^^^^
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/_griffe/models.py", line 1673, in target
    self.resolve_target()
    ~~~~~~~~~~~~~~~~~~~^^
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/_griffe/models.py", line 1740, in resolve_target
    self._resolve_target()
    ~~~~~~~~~~~~~~~~~~~~^^
  File "/Users/rabernat/mambaforge/envs/icechunk-docs/lib/python3.13/site-packages/_griffe/models.py", line 1755, in _resolve_target
    raise CyclicAliasError([self.target_path, *error.chain]) from error
_griffe.exceptions.CyclicAliasError: Cyclic aliases detected:
  icechunk.ConflictError
  icechunk._icechunk_python.ConflictError
  icechunk.ConflictError

mpiannucci · 2025-07-01T10:33:53Z

I can update this today, I remember what is needed now I think

ianhi · 2025-07-02T20:06:50Z

docs/README.md

+pip install \
+mkdocs "mkdocs-material[imaging]" \
+mkdocs-include-markdown-plugin mkdocs-open-in-new-tab mkdocs-breadcrumbs-plugin \
+mkdocs-mermaid2-plugin mkdocs-minify-plugin mkdocs-awesome-pages-plugin \
+mkdocs-macros-plugin mkdocs-git-revision-date-localized-plugin mkdocstrings \
+mkdocstrings-python mkdocs-jupyter markdown-exec 
+```


I followed the instructions here and didn't seem to need this step.

did you possibly have multiple wheels built? I don't thnk the lss command we were using was sorting by date by default.

docs/README.md

ianhi · 2025-07-02T20:10:53Z

_griffe.exceptions.CyclicAliasError: Cyclic aliases detected:
icechunk.ConflictError
icechunk._icechunk_python.ConflictError
icechunk.ConflictError

I think this a real error. This is from the API generation, unrelated to the cell execution.

mpiannucci · 2025-07-02T20:12:50Z

Yeah I had this a long time ago and never figured out how to fix it.

ianhi · 2025-07-02T20:14:00Z

Yeah I had this a long time ago and never figured out how to fix it.

it's intermittent?

mpiannucci · 2025-07-02T20:19:01Z

It was permanent for me locally

Co-authored-by: Ian Hunt-Isaak <ianhuntisaak@gmail.com>

update build instructions

31210f6

ianhi reviewed Jul 2, 2025

View reviewed changes

docs/README.md Outdated Show resolved Hide resolved

mpiannucci and others added 2 commits July 3, 2025 10:30

Update docs/README.md

4006b25

Co-authored-by: Ian Hunt-Isaak <ianhuntisaak@gmail.com>

Merge branch 'main' into ryan/docs/update-doc-build-instructions

4295314

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

update build instructions#1020

update build instructions#1020
rabernat wants to merge 3 commits intomainfrom
ryan/docs/update-doc-build-instructions

rabernat commented Jun 30, 2025

Uh oh!

mpiannucci commented Jul 1, 2025

Uh oh!

ianhi Jul 2, 2025

Uh oh!

Uh oh!

ianhi commented Jul 2, 2025

Uh oh!

mpiannucci commented Jul 2, 2025

Uh oh!

ianhi commented Jul 2, 2025

Uh oh!

mpiannucci commented Jul 2, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

rabernat commented Jun 30, 2025

Uh oh!

mpiannucci commented Jul 1, 2025

Uh oh!

ianhi Jul 2, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

ianhi commented Jul 2, 2025

Uh oh!

mpiannucci commented Jul 2, 2025

Uh oh!

ianhi commented Jul 2, 2025

Uh oh!

mpiannucci commented Jul 2, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants