ialdev-core 0.1.0__tar.gz → 0.2.0__tar.gz

ialdev_core-0.2.0/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: ialdev-core
+Version: 0.2.0
+Summary: iad.core — algorithmic utilities: data tools, parameters, paths, caching, and more
+Author: ipcoder
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pandas>=2.1.0
+Requires-Dist: numpy>=2.0
+Requires-Dist: pyyaml>=5.4.0
+Requires-Dist: ruamel.yaml>=0.15.0
+Requires-Dist: regex>=2021.0.0
+Requires-Dist: rapidfuzz>=3.0
+Requires-Dist: tqdm>=4.60.0
+Requires-Dist: frozendict>=2.0.0
+Requires-Dist: python-box>=6.0.0
+Requires-Dist: joblib>=1.0.0
+Requires-Dist: configargparse>=1.0.0
+Requires-Dist: deprecated>=1.2.0
+Requires-Dist: semver>=2.13.0
+Requires-Dist: uncertainties>=3.1.0
+Requires-Dist: pint>=0.20.0
+Requires-Dist: zfpy
+Requires-Dist: xxhash>=3.0.0
+Requires-Dist: toolz>=0.11.0
+Requires-Dist: numba>=0.55.0
+Requires-Dist: scikit-learn>=1.0.0
+Requires-Dist: python-dotenv>=0.19.0
+Project-URL: Homepage, https://github.com/ipcoder/ialdev/tree/master/algutils
+Project-URL: Issues, https://github.com/ipcoder/ialdev/issues
+Project-URL: Repository, https://github.com/ipcoder/ialdev
+
+# ialdev-core
+
+Core utilities for the `iad` toolbox, published as `ialdev-core` and imported as `iad.core`.
+
+Use this package when you need the shared building blocks used by the other `ialdev-*` libraries: collection helpers, typed dictionaries, path transformations, file discovery, caching, logging, event timing, decorators, and NumPy/Pandas utility functions.
+
+## Install
+
+```bash
+pip install ialdev-core
+```
+
+Requires Python `>=3.10`, NumPy `>=2.0`, and pandas `>=2.1.0`.
+
+## Highlights
+
+- `iad.core.short`: scalar/list normalization and keyword filtering (`as_list`, `as_iter`, `drop_undef`).
+- `iad.core.tbox`: `TBox`, a convenience wrapper around `python-box`.
+- `iad.core.fs`: path normalization, file discovery, locators, and transformable path templates.
+- `iad.core.cache`: pickle-based caches and cached processing pipes.
+- `iad.core.data`: NumPy/Pandas helpers, labels, units, binary packing, and table utilities.
+- `iad.core.events`: timers, progress helpers, and joblib/tqdm integration.
+
+## Examples
+
+```python
+from iad.core import as_list, drop_undef
+from iad.core.tbox import TBox
+
+names = as_list("sample")
+config = TBox(drop_undef(root="/data", cache=None, batch=8))
+```
+
+```python
+from iad.core.fs.filesproc import Locator
+from iad.core.fs.paths import TransPath
+
+locator = Locator("/data/project")
+path_template = TransPath("{scene}/{frame}.png")
+```
+
+## Development
+
+```bash
+pip install -e .
+pixi run test
+pixi run lint
+```
+

ialdev_core-0.2.0/README.md

@@ -0,0 +1,48 @@
+# ialdev-core
+
+Core utilities for the `iad` toolbox, published as `ialdev-core` and imported as `iad.core`.
+
+Use this package when you need the shared building blocks used by the other `ialdev-*` libraries: collection helpers, typed dictionaries, path transformations, file discovery, caching, logging, event timing, decorators, and NumPy/Pandas utility functions.
+
+## Install
+
+```bash
+pip install ialdev-core
+```
+
+Requires Python `>=3.10`, NumPy `>=2.0`, and pandas `>=2.1.0`.
+
+## Highlights
+
+- `iad.core.short`: scalar/list normalization and keyword filtering (`as_list`, `as_iter`, `drop_undef`).
+- `iad.core.tbox`: `TBox`, a convenience wrapper around `python-box`.
+- `iad.core.fs`: path normalization, file discovery, locators, and transformable path templates.
+- `iad.core.cache`: pickle-based caches and cached processing pipes.
+- `iad.core.data`: NumPy/Pandas helpers, labels, units, binary packing, and table utilities.
+- `iad.core.events`: timers, progress helpers, and joblib/tqdm integration.
+
+## Examples
+
+```python
+from iad.core import as_list, drop_undef
+from iad.core.tbox import TBox
+
+names = as_list("sample")
+config = TBox(drop_undef(root="/data", cache=None, batch=8))
+```
+
+```python
+from iad.core.fs.filesproc import Locator
+from iad.core.fs.paths import TransPath
+
+locator = Locator("/data/project")
+path_template = TransPath("{scene}/{frame}.png")
+```
+
+## Development
+
+```bash
+pip install -e .
+pixi run test
+pixi run lint
+```

{ialdev_core-0.1.0 → ialdev_core-0.2.0}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "ialdev-core"
-version = "0.1.0"
+version = "0.2.0"
 description = "iad.core — algorithmic utilities: data tools, parameters, paths, caching, and more"
 readme = "README.md"
 requires-python = ">=3.10"
 license = {text = "MIT"}
 authors = [
-    {name = "Your Name", email = "your.email@example.com"}
+    {name = "ipcoder"}
 ]
 classifiers = [
     "Development Status :: 4 - Beta",
@@ -25,10 +25,9 @@ classifiers = [
 ]
 
 dependencies = [
-    "ialdev-io",
     "pydantic>=2.0",
-    "pandas>=1.3.0",
-    "numpy>=1.20.0",
+    "pandas>=2.1.0",
+    "numpy>=2.0",
     "pyyaml>=5.4.0",
     "ruamel.yaml>=0.15.0",
     "regex>=2021.0.0",
@@ -51,9 +50,9 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/yourusername/toolbox"
-Repository = "https://github.com/yourusername/toolbox"
-Issues = "https://github.com/yourusername/toolbox/issues"
+Homepage = "https://github.com/ipcoder/ialdev/tree/master/algutils"
+Repository = "https://github.com/ipcoder/ialdev"
+Issues = "https://github.com/ipcoder/ialdev/issues"
 
 # Distribution name (ialdev-core) ≠ import name (iad.core)
 [tool.flit.module]

{ialdev_core-0.1.0 → ialdev_core-0.2.0}/src/iad/core/cache.py

@@ -12,7 +12,7 @@ from tqdm import tqdm
 from . import logs
 from . import logger
 from .events import Timer
-from .filesproc import Locator
+from .fs import Locator
 from .strings import hash_str
 
 _log = logger('caching')

ialdev_core-0.2.0/src/iad/core/data/__init__.py

@@ -0,0 +1 @@
+"""Numeric, pandas, labeled-data, units, and binary helpers."""

{ialdev_core-0.1.0/src/iad/core → ialdev_core-0.2.0/src/iad/core/data}/array.py

@@ -11,10 +11,10 @@ import numpy as np
 import numba
 from numbers import Number
 
-from .codetools import NamedObj
-from . import as_list
+from ..codetools import NamedObj
+from .. import as_list
 from . import nptools as npt
-from .datatools import rm_keys
+from ..datatools import rm_keys
 
 __all__ = ['DForm', 'Array', 'FormArray', 'form_array', 'Color', '_wC2G']
 

{ialdev_core-0.1.0/src/iad/core → ialdev_core-0.2.0/src/iad/core/data}/label.py

@@ -7,9 +7,9 @@ from typing import Dict, Sequence, Any, Collection, NamedTuple, Iterable
 
 import pandas as pd
 
-from . import as_list
+from .. import as_list
 from .nptools import Array
-from .strings import compact_repr
+from ..strings import compact_repr
 
 
 class Keys(pd.core.indexes.frozen.FrozenList):  # TODO: Merge Keys into Labeled?

{ialdev_core-0.1.0/src/iad/core → ialdev_core-0.2.0/src/iad/core/data}/pdtools.py

@@ -19,10 +19,10 @@ import pandas as pd
 from IPython import display as ipy_disp
 from pandas.core.dtypes.common import is_list_like
 
-from . import strings as stt, codetools as cdt, nptools as npt
-from . import wrap
-from .datatools import select_from, issubset_report
-from .short import as_list, unless_subset
+from .. import strings as stt, codetools as cdt, wrap
+from . import nptools as npt
+from ..datatools import select_from, issubset_report
+from ..short import as_list, unless_subset
 
 # https://pandas.pydata.org/pandas-docs/stable/user_guide/indexing.html#returning-a-view-versus-a-copy
 # Copy-on-Write will become the new default in pandas 3.0. This means than chained indexing will never work.
@@ -185,7 +185,7 @@ class Parallel:
         :return: resulted table (same class as df)
         """
         import joblib as jb
-        from .events import tqdm_joblib
+        from ..events import tqdm_joblib
 
         par = self.jobs if isinstance(self.jobs, dict) else dict(
             backend='loky',
@@ -2004,7 +2004,7 @@ def path_fixer(root, fixer_name, cols='path') -> Callable[[pd.DataFrame], pd.Dat
 
     cols = set(as_list(cols))
 
-    from . import filesproc as proc
+    from ..fs import filesproc as proc
     fixer = {
         'add': proc.root_adder,
         'crop': proc.root_cropper

{ialdev_core-0.1.0 → ialdev_core-0.2.0}/src/iad/core/events.py

@@ -605,7 +605,7 @@ class Dump(dict):
             self.configure()
 
     def configure(self, new_config=None):
-        from .paths import TransPath
+        from .fs.paths import TransPath
         # TODO add
         #  1) support to selective config along the tree
         #  2) clearer way to configure
@@ -620,7 +620,6 @@ class Dump(dict):
 
     def __call__(self, data=None, labels: dict = None, **kwargs):
         import os
-        from iad.io import imsave
 
         if not self.active or data is None:
             return self.labels
@@ -640,8 +639,10 @@ class Dump(dict):
         if os.path.isfile(path) and not self.config.exist_ok:
             raise FileExistsError(f"File {path} already exists")
         path.parent.mkdir(mode=0o777, parents=True, exist_ok=True)
-        # TODO add support for other file types
-        imsave(path, data)
+        writer = getattr(self.config, 'writer', None)
+        if writer is None:
+            raise RuntimeError("Dump requires config.writer callable to save data")
+        writer(path, data)
 
     def fork(self, other: dict):
         return Dump(config=self.config, root=self.root, labels=other | self.labels, scheme=self.scheme)

ialdev_core-0.2.0/src/iad/core/fs/__init__.py

@@ -0,0 +1,3 @@
+"""Filesystem paths, path templates, and environment/locator helpers."""
+
+from .filesproc import Locator 

{ialdev_core-0.1.0/src/iad/core → ialdev_core-0.2.0/src/iad/core/fs}/env.py

@@ -3,7 +3,7 @@ import os
 from pathlib import Path
 import dotenv
 
-from iad.core.filesproc import Locator
+from .filesproc import Locator
 
 env_log = logging.getLogger('env')
 
@@ -172,7 +172,7 @@ class EnvLoc:
 
     @classmethod
     def _process_dotenv(cls, env_file, override=None):
-        from iad.core.filesproc import represents_path, normalize
+        from .filesproc import represents_path, normalize
 
         def same_value(v1, v2):
             """Return true if two values are the same.
@@ -234,10 +234,10 @@ class EnvLoc:
             if not Path(env_path).is_file():
                 if not fail: return None        
                 raise FileNotFoundError(f'Not found dotenv defined in {ENV_FILE_VAR}="{env_path}"')
-            env_log.debug(f'dotenv set by the environmnet variable {ENV_FILE_VAR}={env_path}')
+            env_log.debug(f'dotenv set by the environment variable {ENV_FILE_VAR}={env_path}')
         elif not (env_path := dotenv.find_dotenv(usecwd=True)):  # try first search from the current dir
             msg = f'Getting default .env after not found at CDW: {os.getcwd()}'
-            env_log.error(msg)
+            env_log.debug(msg)
             if not fail: return None
             raise FileNotFoundError(msg)
         return env_path

{ialdev_core-0.1.0/src/iad/core → ialdev_core-0.2.0/src/iad/core/fs}/filesproc.py

@@ -2,16 +2,16 @@
 """
 from __future__ import annotations
 
+import logging
 import os
 import re
 import sys
 from pathlib import Path
 from typing import List, Tuple, Union, Iterable, Callable, Literal, Type, Any, Generator
 
-from .datatools import unique as unique_filter
-from .short import as_iter
-from .events import timed, Timer
-import logging
+from ..datatools import unique as unique_filter
+from ..events import Timer
+from ..short import as_iter
 
 PathT = Union[Path, str]
 UNDEF = object()
@@ -129,9 +129,14 @@ def compress_numpy_file(file, clean=True):
     :param clean: remove the sources
     """
     import numpy as np
-    from iad.io.imread import imread
     file = Path(file)
-    np.savez_compressed(file.with_suffix('.npz'), **imread(file, out=dict))
+    loaded = np.load(file, allow_pickle=True)
+    if isinstance(loaded, np.lib.npyio.NpzFile):
+        with loaded:
+            payload = {key: loaded[key] for key in loaded.files}
+    else:
+        payload = {file.stem: loaded}
+    np.savez_compressed(file.with_suffix('.npz'), **payload)
     if clean:
         os.remove(file)
 
@@ -810,7 +815,7 @@ def glob_folders(folders, file_pattern) -> Iterable[str]:
     :param file_pattern: glob pattern for path under the folder
     :return: Iterator over the files found
     """
-    from . import as_list
+    from .. import as_list
     from more_itertools import collapse
 
     return list(collapse(

{ialdev_core-0.1.0/src/iad/core → ialdev_core-0.2.0/src/iad/core/fs}/paths.py

@@ -5,7 +5,7 @@ from typing import Any, Callable, Literal, Sequence
 
 import regex as re
 
-from .regexp import format_to_regex, regex_to_format, is_regex, partition
+from ..regexp import format_to_regex, regex_to_format, is_regex, partition
 
 
 def ng(name=None, exp=None, /, **kw):
@@ -329,7 +329,7 @@ class Form:
 
     def _repr_parts_tree(self, indent=' ' * 4, head='Form:\n'):
         """String representing parsed tree of parts"""
-        from .strings import indent_lines
+        from ..strings import indent_lines
 
         return head + '\n'.join(indent_lines(
             p._repr_parts_tree(indent=indent, head=head) if isinstance(p, Form) else p
@@ -516,7 +516,7 @@ class TransPath:
         if no_tag and not self.has_unnamed:
             raise ValueError("Unnamed tag is not defined but requested!")
         if no_tag is True:
-            from .datatools import split_dict
+            from ..datatools import split_dict
             labels, no_tag = split_dict(labels, lambda k, v: k in self.expected_tags)
             no_tag = no_tag or None
         if no_tag:

{ialdev_core-0.1.0 → ialdev_core-0.2.0}/src/iad/core/logs.py

@@ -40,7 +40,7 @@ def _add_levels_attrs(obj: T) -> T:
 
 def module_log_file(file: str | Path):
     """Constructs default log file name from module file"""
-    from .filesproc import Locator
+    from .fs import Locator
     out_folder = Locator('/tmp/ramdisk', '/tmp', envar='TEMP').first_existing()
     if not out_folder:
         from tempfile import mkdtemp

ialdev_core-0.2.0/src/iad/core/param/__init__.py

@@ -0,0 +1 @@
+"""Parameter definitions, CLI/YAML config parsing, and related helpers."""

{ialdev_core-0.1.0 → ialdev_core-0.2.0}/src/iad/core/param/confargparse.py

@@ -35,7 +35,7 @@ class ArgumentParserYAML(cap.ArgumentParser):
 
         :return: dict {grp_name: hash_str}
         """
-        from .tbox import TBox
+        from ..tbox import TBox
         groups = self.hash_groups or {'cfg': [*vars(ns)]}
         ns = vars(ns)
 

{ialdev_core-0.1.0 → ialdev_core-0.2.0}/src/iad/core/param/paramaze.py

@@ -4,7 +4,7 @@ from enum import IntEnum, unique
 from typing import Union, Callable, Optional, Dict, Sequence
 
 from .. import as_list, fnctools as fnt, wrap
-from .tbox import TBox
+from ..tbox import TBox
 
 Rule = Union[Callable, str, None]
 

{ialdev_core-0.1.0 → ialdev_core-0.2.0}/src/iad/core/strings.py

@@ -201,8 +201,8 @@ def compact_repr(v, max_len=60) -> str:
     :param max_len: maximal length of the resulting string
     :return: str
     """
-    from .units import Quantity
-    from .nptools import array_info_str, np
+    from .data.units import Quantity
+    from .data.nptools import array_info_str, np
     import pandas as pd
 
     def crop(s, mx):

{ialdev_core-0.1.0/src/iad/core/param → ialdev_core-0.2.0/src/iad/core}/tbox.py

@@ -6,9 +6,9 @@ import pandas as pd
 import pydantic.v1 as pydantic
 from box import Box
 
-from ..datatools import complete_missing, UndefCond, UndefTypes
-from ..strings import compact_repr, hash_str
-from ..wrap import name_tuple
+from .datatools import complete_missing, UndefCond, UndefTypes
+from .strings import compact_repr, hash_str
+from .wrap import name_tuple
 
 __all__ = ['TBox', 'UndefCond']
 
@@ -151,7 +151,7 @@ class TBox(Box):
 
     def to_yaml(self, filename=None, *, default_flow_style=False,
                 encoding="utf-8", errors="strict", **yaml_kwargs):
-        from ..filesproc import prepare_parent_folder, Path
+        from .fs import prepare_parent_folder, Path
 
         par = self.copy()  # type: TBox
         for k, v in par.items(True):

{ialdev_core-0.1.0 → ialdev_core-0.2.0}/src/iad/core/wrap.py

@@ -150,7 +150,7 @@ class NamedTupleI:
     ::
             isinstance(type(obj), NamedTupleMeta)
     """
-    from .nptools import array_info_str
+    from .data.nptools import array_info_str
 
     _fields: list[str]
     __iter__: Callable

{ialdev_core-0.1.0 → ialdev_core-0.2.0}/tests/conftest.py

@@ -15,8 +15,8 @@ def multi_label_data_table():
 
     """
     import numpy as np
-    from iad.core.pdtools import DataTable, pd
-    from iad.core.label import Keys
+    from iad.core.data.pdtools import DataTable, pd
+    from iad.core.data.label import Keys
 
     shape = (10, 10)
     imL, imR = (np.ones(shape) * 1, np.ones(shape) * 2)

{ialdev_core-0.1.0 → ialdev_core-0.2.0}/tests/test_array.py

@@ -1,5 +1,5 @@
-from iad.core.array import *
-from iad.core.array import _wC2G
+from iad.core.data.array import *
+from iad.core.data.array import _wC2G
 import pytest
 import numpy as np
 

{ialdev_core-0.1.0 → ialdev_core-0.2.0}/tests/test_binar.py

@@ -1,4 +1,4 @@
-from iad.core.binary import *
+from iad.core.data.binary import *
 
 
 def test_set_bits():

{ialdev_core-0.1.0 → ialdev_core-0.2.0}/tests/test_filesproc.py

@@ -1,6 +1,6 @@
 import pytest
 
-from iad.core.filesproc import Locator, Path
+from iad.core.fs.filesproc import Locator, Path
 
 
 def test_locator(tmp_path):

{ialdev_core-0.1.0 → ialdev_core-0.2.0}/tests/test_nptools.py

@@ -1,6 +1,6 @@
 import numpy as np
 
-from iad.core.nptools import *
+from iad.core.data.nptools import *
 
 
 def test_xy2idx():

{ialdev_core-0.1.0 → ialdev_core-0.2.0}/tests/test_paths.py

@@ -22,7 +22,7 @@ pat = r"""
 
 @pytest.fixture(scope='module')
 def trans_path():
-    from iad.core.paths import TransPath
+    from iad.core.fs.paths import TransPath
     tp = TransPath(pat)
     print(tp.regex.regex.pattern)
     return tp

{ialdev_core-0.1.0 → ialdev_core-0.2.0}/tests/test_pdtools.py

@@ -4,9 +4,9 @@ import numpy as np
 import pandas as pd
 import pytest
 
-from iad.core import pdtools as pdt
-from iad.core.label import Keys
-from iad.core.pdtools import add_row
+from iad.core.data import pdtools as pdt
+from iad.core.data.label import Keys
+from iad.core.data.pdtools import add_row
 from iad.core.wrap import name_tuple
 
 

{ialdev_core-0.1.0/tests/param → ialdev_core-0.2.0/tests}/test_tbox.py

@@ -3,7 +3,7 @@ from copy import copy
 import box
 import pytest
 
-from iad.core.param import TBox
+from iad.core.tbox import TBox
 
 
 def test_construct():

ialdev_core-0.1.0/PKG-INFO

@@ -1,73 +0,0 @@
-Metadata-Version: 2.4
-Name: ialdev-core
-Version: 0.1.0
-Summary: iad.core — algorithmic utilities: data tools, parameters, paths, caching, and more
-Author-email: Your Name <your.email@example.com>
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Science/Research
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Dist: ialdev-io
-Requires-Dist: pydantic>=2.0
-Requires-Dist: pandas>=1.3.0
-Requires-Dist: numpy>=1.20.0
-Requires-Dist: pyyaml>=5.4.0
-Requires-Dist: ruamel.yaml>=0.15.0
-Requires-Dist: regex>=2021.0.0
-Requires-Dist: rapidfuzz>=3.0
-Requires-Dist: tqdm>=4.60.0
-Requires-Dist: frozendict>=2.0.0
-Requires-Dist: python-box>=6.0.0
-Requires-Dist: joblib>=1.0.0
-Requires-Dist: configargparse>=1.0.0
-Requires-Dist: deprecated>=1.2.0
-Requires-Dist: semver>=2.13.0
-Requires-Dist: uncertainties>=3.1.0
-Requires-Dist: pint>=0.20.0
-Requires-Dist: zfpy
-Requires-Dist: xxhash>=3.0.0
-Requires-Dist: toolz>=0.11.0
-Requires-Dist: numba>=0.55.0
-Requires-Dist: scikit-learn>=1.0.0
-Requires-Dist: python-dotenv>=0.19.0
-Project-URL: Homepage, https://github.com/yourusername/toolbox
-Project-URL: Issues, https://github.com/yourusername/toolbox/issues
-Project-URL: Repository, https://github.com/yourusername/toolbox
-
-# algutils
-
-Algorithmic utilities: data tools, I/O, parameters, paths, caching, image transforms, and math (hist, geom, regress).
-
-Extracted from the toolbox project as a standalone, installable package.
-
-## Installation
-
-```bash
-# From this directory (editable)
-pip install -e .
-
-# With optional extras
-pip install -e ".[io,units,dev]"
-```
-
-## Usage
-
-```python
-from algutils import logger, as_list
-from algutils.param import TBox, YamlModel
-from algutils.io.format import FileFormat
-from algutils.io.imread import imread
-```
-
-## Development
-
-- **pixi**: `pixi install` then `pixi run test` or `pixi run lint`
-- **pip**: `pip install -e ".[dev]"` then `pytest src/algutils -v`
-

ialdev_core-0.1.0/README.md

@@ -1,29 +0,0 @@
-# algutils
-
-Algorithmic utilities: data tools, I/O, parameters, paths, caching, image transforms, and math (hist, geom, regress).
-
-Extracted from the toolbox project as a standalone, installable package.
-
-## Installation
-
-```bash
-# From this directory (editable)
-pip install -e .
-
-# With optional extras
-pip install -e ".[io,units,dev]"
-```
-
-## Usage
-
-```python
-from algutils import logger, as_list
-from algutils.param import TBox, YamlModel
-from algutils.io.format import FileFormat
-from algutils.io.imread import imread
-```
-
-## Development
-
-- **pixi**: `pixi install` then `pixi run test` or `pixi run lint`
-- **pip**: `pip install -e ".[dev]"` then `pytest src/algutils -v`