Opsi indexes

AGENTS.md

@@ -0,0 +1,48 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+The Python package lives in `src/blosc2/`, including the C/Cython extension sources
+(`blosc2_ext.*`) and core modules such as `core.py`, `ndarray.py`, and `schunk.py`.
+Tests are under `tests/`, with additional doctests enabled for select modules per
+`pytest.ini`. Documentation sources are in `doc/` and build output lands in `html/`.
+Examples are in `examples/`, and performance/benchmark scripts live in `bench/`.
+
+## Build, Test, and Development Commands
+- `pip install .` builds the bundled C-Blosc2 and installs the package.
+- `pip install -e .` installs in editable mode for local development.
+- `CMAKE_PREFIX_PATH=/usr/local USE_SYSTEM_BLOSC2=1 pip install -e .` builds
+  against a separately installed C-Blosc2.
+- `pytest` runs the default test suite (excludes `heavy` and `network` markers).
+- `pytest -m "heavy"` runs long-running tests.
+- `pytest -m "network"` runs tests requiring network access.
+- `cd doc && rm -rf ../html _build && python -m sphinx . ../html` builds docs.
+
+## Coding Style & Naming Conventions
+Use Ruff for formatting and linting (line length 109). Enable pre-commit hooks:
+`python -m pip install pre-commit` then `pre-commit install`. Follow Python
+conventions: 4-space indentation, `snake_case` for functions/variables, and
+`PascalCase` for classes. Pytest discovery expects `tests/test_*.py` and
+`test_*` functions. Do not use leading underscores in module-level helper
+function names when those helpers are imported from other modules; reserve
+leading underscores for file-local implementation details. Avoid leading
+underscores in core module filenames under `src/blosc2/`; prefer non-underscored
+module names unless there is a strong reason to keep a module private.
+
+For documentation and tutorial query examples, prefer the shortest idiom that
+matches the intended result type. Use `expr[:]` or `arr[mask][:]` when showing
+values, use `expr.compute()` when materializing an `NDArray`, and use
+`expr.compute(_use_index=False)` when demonstrating scan-vs-index behavior.
+Avoid `expr.compute()[:]` unless a NumPy array is specifically required.
+
+## Testing Guidelines
+Pytest is required; warnings are treated as errors. The default configuration
+adds `--doctest-modules`, so keep doctest examples in `blosc2/core.py`,
+`blosc2/ndarray.py`, and `blosc2/schunk.py` accurate. Use markers `heavy` and
+`network` for slow or network-dependent tests.
+
+## Commit & Pull Request Guidelines
+Recent commit messages are short, imperative sentences (e.g., “Add …”, “Fix …”)
+without ticket prefixes. For pull requests: branch from `main`, add tests for
+behavior changes, update docs for API changes, ensure the test suite passes,
+and avoid introducing new compiler warnings. Link issues when applicable and
+include clear reproduction steps for bug fixes.

CMakeLists.txt

@@ -41,11 +41,20 @@ add_custom_command(
   DEPENDS "${CMAKE_CURRENT_SOURCE_DIR}/src/blosc2/blosc2_ext.pyx"
   VERBATIM)
 
+add_custom_command(
+  OUTPUT indexing_ext.c
+  COMMAND Python::Interpreter -m cython
+          "${CMAKE_CURRENT_SOURCE_DIR}/src/blosc2/indexing_ext.pyx" --output-file indexing_ext.c
+  DEPENDS "${CMAKE_CURRENT_SOURCE_DIR}/src/blosc2/indexing_ext.pyx"
+  VERBATIM)
+
 # ...and add it to the target
 Python_add_library(blosc2_ext MODULE blosc2_ext.c WITH_SOABI)
+Python_add_library(indexing_ext MODULE indexing_ext.c WITH_SOABI)
 
 # We need to link against NumPy
 target_link_libraries(blosc2_ext PRIVATE Python::NumPy)
+target_link_libraries(indexing_ext PRIVATE Python::NumPy)
 
 # Fetch and build miniexpr library
 include(FetchContent)
@@ -63,7 +72,7 @@ endif()
 
 FetchContent_Declare(miniexpr
     GIT_REPOSITORY https://github.com/Blosc/miniexpr.git
-    GIT_TAG feadbc633a887bafd84b2fbc370ef2962d01b7ee
+    GIT_TAG f2faef741c4c507bf6a03167c72ce7f92c6f0ae8
     # SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/../miniexpr
 )
 FetchContent_MakeAvailable(miniexpr)
@@ -72,6 +81,7 @@ FetchContent_MakeAvailable(miniexpr)
 target_link_libraries(blosc2_ext PRIVATE miniexpr_static)
 
 target_compile_features(blosc2_ext PRIVATE c_std_11)
+target_compile_features(indexing_ext PRIVATE c_std_11)
 if(WIN32 AND CMAKE_C_COMPILER_ID STREQUAL "Clang")
     execute_process(
         COMMAND "${CMAKE_C_COMPILER}" -print-resource-dir
@@ -119,7 +129,7 @@ else()
     include(FetchContent)
     FetchContent_Declare(blosc2
         GIT_REPOSITORY https://github.com/Blosc/c-blosc2
-        GIT_TAG b32256fc1287b6e24c22f09ac202265c7054e2bc
+        GIT_TAG 0568990388e6201240b170947d4c2199572f795d
         # SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/../c-blosc2
     )
     FetchContent_MakeAvailable(blosc2)
@@ -148,7 +158,7 @@ endif()
 
 # Python extension -> site-packages/blosc2
 install(
-  TARGETS blosc2_ext
+  TARGETS blosc2_ext indexing_ext
   LIBRARY DESTINATION ${SKBUILD_PLATLIB_DIR}/blosc2
 )