Add array filter types, modernize build

CHANGE.txt

@@ -2,6 +2,14 @@
 LabKey Python Client API News
 +++++++++++
 
+What's New in the LabKey 4.1.0 package
+==============================
+
+*Release date: 02/24/2026*
+- Add array filter types
+- Use importlib to determine client version
+- Update build to use Hatch
+
 What's New in the LabKey 4.0.1 package
 ==============================
 

README.md

@@ -121,10 +121,13 @@ This package is maintained by [LabKey](http://www.labkey.com/). If you have any
 [LabKey Server developer support forum](https://www.labkey.org/home/developer/forum/project-start.view).
 
 ### Setup
+We use the Just command runner to simplify setup and development with this package. You'll want to install just to work
+on this package. Installation instructions can be found here: https://just.systems/man/en/packages.html
+
 To install the necessary dependencies for local development you can run the following command:
 
 ```bash
-pip install -e '.[dev]'
+just install
 ```
 
 
@@ -135,20 +138,27 @@ When contributing changes please use `Black` to format your code. To run Black y
 black .
 ```
 
-After black has run it may have formatted some files, commit the changed files before opening a PR.
+After black has run, it may have formatted some files, commit the changed files before opening a PR.
 
 ### Testing
-If you are looking to contribute please run the tests before issuing a PR. The tests can be run with:
+If you are looking to contribute please run the tests before issuing a PR.
+
+To run only the unit tests, run the following command:
+
+```bash
+just test-unit
+```
+
+To run the integration tests, make sure you have a live server running, a netrc file, and run the following command:
 
 ```bash
-$ pytest .
+just test-integration
 ```
 
-The integration tests do not run by default. If you want to run the integration tests make sure you have a live server
-running, a netrc file, and run the following command:
+To run all tests, run the following command:
 
 ```bash
-$ pytest . -m "integration"
+just test
 ```
 
 ### Maintainers
@@ -158,13 +168,13 @@ releases.
 To build the package before releasing you will need to install the build dependencies. This can be done by running:
 
 ```bash
-pip install -e '.[build]'
+just install-build
 ```
 
 To build the package you can run:
 
 ```bash
-python -m build
+just build
 ```
 
 You should now have a `dist/` folder with two files:

justfile

@@ -0,0 +1,33 @@
+build:
+	python -m build
+
+release-test:
+	hatch publish --repo test
+
+release:
+	hatch publish
+
+install:
+	pip install -e '.[dev,test]'
+
+install-build:
+    pip install -e '.[build]'
+
+uninstall:
+	pip uninstall -y labkey
+
+clean:
+	rm -rf ./dist/
+	rm -rf ./labkey.egg-info
+
+test-unit:
+    pytest .
+
+test-integration:
+    pytest . -m "integration"
+
+test: test-unit test-integration
+
+brt: clean build release-test
+
+br: clean build release

labkey/__init__.py

@@ -13,7 +13,3 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__title__ = "labkey"
-__version__ = "4.0.1"
-__author__ = "LabKey"
-__license__ = "Apache License 2.0"

labkey/query.py

@@ -60,7 +60,6 @@ class Pagination:
     ALL = "all"
     NONE = "none"
 
-
 # TODO: Provide filter generators.
 #
 # There are some inconsistencies between the different filter types with multiple values,
@@ -114,6 +113,12 @@ class Types:
         CONTAINS_ONE_OF = "containsoneof"
         CONTAINS_NONE_OF = "containsnoneof"
 
+        ARRAY_CONTAINS_ALL = "arraycontainsall"
+        ARRAY_CONTAINS_ANY = "arraycontainsany"
+        ARRAY_CONTAINS_NONE = "arraycontainsnone"
+        ARRAY_CONTAINS_EXACT = "arraymatches"
+        ARRAY_CONTAINS_NOT_EXACT = "arraynotmatches"
+
         IN = "in"
 
         EQUALS_ONE_OF = "in"
@@ -135,6 +140,10 @@ class Types:
         HAS_MISSING_VALUE = "hasmvvalue"
         DOES_NOT_HAVE_MISSING_VALUE = "nomvvalue"
 
+        ARRAY_ISEMPTY = "arrayisempty"
+        ARRAY_ISNOTEMPTY = "arrayisnotempty"
+
+
         # Table/Query-wise operators
         Q = "q"
 

labkey/server_context.py

@@ -1,7 +1,7 @@
 from typing import Dict, TextIO
 from labkey.utils import json_dumps
-from . import __version__
 import requests
+import importlib.metadata
 from requests.exceptions import RequestException
 from labkey.exceptions import (
     RequestError,
@@ -14,6 +14,7 @@
 
 API_KEY_TOKEN = "apikey"
 CSRF_TOKEN = "X-LABKEY-CSRF"
+client_version = importlib.metadata.version("labkey")
 
 
 def handle_response(response, non_json_response=False):
@@ -76,7 +77,9 @@ def __init__(
         self._disable_csrf = disable_csrf
         self.allow_redirects = allow_redirects
         self._session = requests.Session()
-        self._session.headers.update({"User-Agent": f"LabKey Python API/{__version__}"})
+        self._session.headers.update({"User-Agent": f"LabKey Python API/{client_version}"})
+
+        print(f"User Agent header: LabKey Python API/{client_version}")
 
         if self._use_ssl:
             self._scheme = "https://"

pyproject.toml

@@ -1,2 +1,42 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name="labkey"
+version = "4.1.0"
+description = "Python client API for LabKey Server"
+dependencies = ["requests>=2.32.5"]
+readme = "README.md"
+requires-python = ">=3.11"
+license = "Apache-2.0"
+license-files = ["LICENSE.txt"]
+keywords = ["labkey"]
+maintainers = [{ name = "Alan Vezina", email="alanv@labkey.com" }]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: System Administrators",
+    "Operating System :: MacOS",
+    "Operating System :: Microsoft",
+    "Operating System :: POSIX",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering",
+]
+
+[tool.hatch.build.targets.sdist]
+only-include = ["labkey"]
+
+[project.optional-dependencies]
+test = ["pytest>=9.0.2", "mock>=5.2.0", "pytest-cov>=7.0.0"]
+dev = ["black>=26.1.0", "pytest>=9.0.2", "mock>=5.2.0", "pytest-cov>=7.0.0", "hatch>=1.16.4"]
+
+[project.urls]
+Homepage = "https://github.com/LabKey/labkey-api-python"
+
 [tool.black]
 line-length = 100