clams-python 1.7.3__tar.gz → 1.7.4__tar.gz

{clams_python-1.7.3 → clams_python-1.7.4}/CHANGELOG.md

@@ -1,4 +1,13 @@
 
+## releasing 1.7.3 (2026-07-09)
+### Overview
+This patch includes critical bugfixes. See changes below. 
+
+### Changes
+* fixes handling of error during `annotate()` (and `_annotate()`) when running an app via cli.py  (#297)
+* added the `useReasoning` common parameter for promptable apps (#299) Note that release 1.7.2 was supposed to include this parameter (and the release note says so), but it was omitted by mistake.
+
+
 ## releasing 1.7.2 (2026-07-07)
 ### Overview
 This patch adds experimental handling of "reasoning traces" of propmtable apps

{clams_python-1.7.3/clams_python.egg-info → clams_python-1.7.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clams-python
-Version: 1.7.3
+Version: 1.7.4
 Summary: A collection of APIs to develop CLAMS app for python
 License-Expression: Apache-2.0
 Project-URL: homepage, https://clams.ai

{clams_python-1.7.3 → clams_python-1.7.4}/clams/app/__init__.py

@@ -49,6 +49,10 @@ falsy_values = [
 ]
 
 
+class EmptyOutputWarning(UserWarning):
+    """Raised when an app's ``_annotate()`` produces no non-empty views."""
+
+
 class ClamsApp(ABC):
     """
     An abstract class to define API's for ClamsApps. A CLAMS app should inherit
@@ -191,6 +195,15 @@ class ClamsApp(ABC):
         t = datetime.now()
         with warnings.catch_warnings(record=True) as ws:
             annotated, cuda_profiler = self._profile_cuda_memory(self._annotate)(mmif, **refined)
+            new_views = [v for v in annotated.views if v.id not in existing_view_ids]
+            is_empty = lambda v: len(v.annotations) == 0 and not v.has_error() and not v.has_warnings()
+            for v in new_views:
+                if is_empty(v):
+                    del annotated.views._items[v.id]  # no public API to remove a view (mmif-python)
+            if all(is_empty(v) for v in new_views):
+                warnings.warn(f'App "{self.metadata.identifier}" produced no annotations for this '
+                              f'input; the input may lack expected content, or there may genuinely '
+                              f'be nothing to annotate.', EmptyOutputWarning)
             if ws:
                 issued_warnings.extend(ws)
         if issued_warnings:
@@ -301,35 +314,81 @@ class ClamsApp(ABC):
         """
         A method to "sign" a new view that this app creates at the beginning of annotation.
         Signing will populate the view metadata with information and configuration of this app.
-        The parameters passed to the :meth:`~clams.app.ClamsApp._annotate` must be
-        passed to this method. This means all parameters for "common" configuration that
-        are consumed in :meth:`~clams.app.ClamsApp.annotate` should not be recorded in the
-        view metadata.
+
+        The ``runtime_conf`` argument can be either "refined" or "raw" parameters,
+        and what ends up recorded in the view metadata differs accordingly:
+
+        * "refined" params: the output of :meth:`~clams.app.ClamsApp._refine_params`,
+          identifiable by the presence of the internal ``_RAW_PARAMS_KEY`` marker.
+          These carry both the user's raw input and the fully resolved configuration
+          (declared parameters with their defaults filled in). Signing then populates
+          **two** metadata fields: ``parameters`` with the raw user input (before
+          defaults), and ``appConfiguration`` with the resolved configuration,
+          including the universal parameters (e.g. ``pretty``, ``runningTime``,
+          ``hwFetch``, ``tfSamplingMode``).
+        * "raw" params: an unrefined ``Dict[str, List[str]]``. Only the
+          ``parameters`` field is populated; there is no resolved configuration
+          to record. See :meth:`~clams.app.ClamsApp.add_parameters_to_metadata`
+          for the input channels these values come from and how each is recorded.
+
+        These two cases exist because of two distinct execution paths. On the normal
+        annotation path, :meth:`~clams.app.ClamsApp.annotate` refines the parameters
+        before invoking :meth:`~clams.app.ClamsApp._annotate`, so a well-behaved app
+        forwards those already-refined params here and gets the full two-field record.
+        On the error path (:meth:`~clams.app.ClamsApp.set_error_view`), refinement may
+        be exactly what failed (:meth:`~clams.app.ClamsApp._refine_params` raises on a
+        missing required parameter or an invalid choice) so the error view is signed
+        with the raw params to guarantee the error is still recorded.
+
         :param view: a view to sign
-        :param runtime_conf: runtime configuration of the app as k-v pairs
+        :param runtime_conf: runtime configuration of the app, either refined
+            (output of :meth:`~clams.app.ClamsApp._refine_params`) or raw k-v pairs
         """
         view.metadata.app = str(self.metadata.identifier)
         if self.metadata.app_tags:
             view.metadata.set_additional_property('appTags', list(self.metadata.app_tags))
-        params_map = {p.name: p for p in self.metadata.parameters}
         if self._RAW_PARAMS_KEY in runtime_conf:
             for k, v in runtime_conf.items():
                 if k == self._RAW_PARAMS_KEY:
-                    for orik, oriv in v.items():
-                        if orik in params_map and params_map[orik].multivalued:
-                            view.metadata.add_parameter(orik, str(oriv))
-                        else:
-                            view.metadata.add_parameter(orik, oriv[0])
+                    self.add_parameters_to_metadata(view, v)
                 else:
                     view.metadata.add_app_configuration(k, v)
         else:
-            # meaning the parameters directly from flask or argparser and values are in lists
-            for k, v in runtime_conf.items():
-                if k in params_map and params_map[k].multivalued:
-                    view.metadata.add_parameter(k, str(v))
-                else:
-                    view.metadata.add_parameter(k, v[0])
-        
+            # unrefined params passed directly (no _RAW_PARAMS_KEY marker), e.g.
+            # the error path; values are lists
+            self.add_parameters_to_metadata(view, runtime_conf)
+
+    def add_parameters_to_metadata(self, view: View, parameters: dict):
+        """
+        Record raw runtime parameters into the view's ``parameters`` metadata.
+
+        The ``parameters`` argument reaches an app through one of three channels:
+
+        #. a query string, when the app runs as an HTTP server (``app.py``, via
+           :class:`~clams.restify.Restifier`);
+        #. shell arguments, when the app runs as a CLI program (``cli.py``);
+        #. a JSON envelope built with the ``clams envelop`` command (see
+           :mod:`clams.envelop`), whose values are flattened by
+           :func:`~clams.envelop.normalize_params`.
+
+        In every case the values arrive as ``List[str]`` (the shape
+        :meth:`~clams.app.ClamsApp._refine_params` consumes). A single value is
+        recorded bare with the ``List`` wrapper stripped, multiple values as the
+        serialized list, and an empty list skipped as unset (only an envelope
+        such as ``{"x": []}`` produces one, guarding against an ``IndexError``
+        on ``v[0]``).
+
+        :param view: the view being signed
+        :param parameters: raw runtime parameters as ``Dict[str, List[str]]``
+        """
+        for k, v in parameters.items():
+            if len(v) == 0:
+                continue
+            elif len(v) == 1:
+                view.metadata.add_parameter(k, v[0])
+            else:
+                view.metadata.add_parameter(k, str(v))
+
     def set_error_view(self, mmif: Union[str, dict, Mmif], **runtime_conf: List[str]) -> Mmif:
         """
         A method to record an error instead of annotation results in the view

{clams_python-1.7.3 → clams_python-1.7.4}/clams/develop/templates/app/Containerfile.template

@@ -3,7 +3,7 @@ FROM ghcr.io/clamsproject/clams-python:$CLAMS_VERSION
 # See https://github.com/orgs/clamsproject/packages?tab=packages&q=clams-python for more base images
 # IF you want to automatically publish this image to the clamsproject organization,
 # 1. you should have generated this template without --no-github-actions flag
-# 1. to add arm64 support, change relevant line in .github/workflows/container.yml
+# 1. to add arm64 support, set `arm64: true` in .github/workflows/publish.yml
 #     * NOTE that a lots of software doesn't install/compile or run on arm64 architecture out of the box
 #     * make sure you locally test the compatibility of all software dependencies before using arm64 support
 # 1. use a git tag to trigger the github action. You need to use git tag to properly set app version anyway

{clams_python-1.7.3 → clams_python-1.7.4/clams_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clams-python
-Version: 1.7.3
+Version: 1.7.4
 Summary: A collection of APIs to develop CLAMS app for python
 License-Expression: Apache-2.0
 Project-URL: homepage, https://clams.ai

{clams_python-1.7.3 → clams_python-1.7.4}/clams_python.egg-info/scm_file_list.json

@@ -1,96 +1,96 @@
 {
   "files": [
-    "README.md",
-    "LICENSE",
-    "pyproject.toml",
+    ".github/workflows/codecov.yml",
+    ".github/workflows/container.yml",
+    ".github/workflows/containers.yml",
+    ".github/workflows/issue-assign.yml",
+    ".github/workflows/issue-close.yml",
+    ".github/workflows/issue-infra-project.yml",
+    ".github/workflows/publish.yml",
+    ".github/workflows/release-check.yml",
+    ".gitignore",
     ".pytype.cfg",
     "CHANGELOG.md",
     "CONTRIBUTING.md",
-    ".gitignore",
-    "build-tools/publish.py",
-    "build-tools/prep_release.py",
+    "LICENSE",
+    "README.md",
     "build-tools/build.py",
-    "build-tools/docs.py",
     "build-tools/clean.py",
+    "build-tools/docs.py",
+    "build-tools/prep_release.py",
+    "build-tools/publish.py",
     "build-tools/test.py",
     "clams/__init__.py",
+    "clams/app/__init__.py",
+    "clams/appmetadata/__init__.py",
+    "clams/backends/__init__.py",
+    "clams/backends/hf.py",
     "clams/develop/__init__.py",
+    "clams/develop/templates/app/.dockerignore.template",
+    "clams/develop/templates/app/.gitignore.template",
+    "clams/develop/templates/app/Containerfile.template",
+    "clams/develop/templates/app/LICENSE.template",
+    "clams/develop/templates/app/README.md.template",
+    "clams/develop/templates/app/app.py.template",
+    "clams/develop/templates/app/cli.py.template",
+    "clams/develop/templates/app/metadata.py.template",
+    "clams/develop/templates/app/requirements.txt.template",
     "clams/develop/templates/gha/for-clams-team.md.template",
-    "clams/develop/templates/gha/workflows/issue-assign.yml.template",
-    "clams/develop/templates/gha/workflows/publish.yml.template",
     "clams/develop/templates/gha/workflows/issue-apps-project.yml.template",
+    "clams/develop/templates/gha/workflows/issue-assign.yml.template",
     "clams/develop/templates/gha/workflows/issue-close.yml.template",
+    "clams/develop/templates/gha/workflows/publish.yml.template",
     "clams/develop/templates/utl-tf/__init__.py.template",
     "clams/develop/templates/utl-tf/timeframe.py.template",
-    "clams/develop/templates/app/Containerfile.template",
-    "clams/develop/templates/app/metadata.py.template",
-    "clams/develop/templates/app/README.md.template",
-    "clams/develop/templates/app/.dockerignore.template",
-    "clams/develop/templates/app/requirements.txt.template",
-    "clams/develop/templates/app/LICENSE.template",
-    "clams/develop/templates/app/.gitignore.template",
-    "clams/develop/templates/app/app.py.template",
-    "clams/develop/templates/app/cli.py.template",
-    "clams/restify/__init__.py",
     "clams/envelop/__init__.py",
-    "clams/appmetadata/__init__.py",
-    "clams/app/__init__.py",
+    "clams/restify/__init__.py",
     "clams/serve/__init__.py",
     "clams/ver/__init__.py",
-    "clams/backends/__init__.py",
-    "clams/backends/hf.py",
-    "documentation/modules.rst",
-    "documentation/target-versions.csv",
+    "container/Containerfile",
+    "container/ffmpeg-hf.containerfile",
+    "container/ffmpeg-hf4.containerfile",
+    "container/ffmpeg-hf5.containerfile",
+    "container/ffmpeg-tf2.containerfile",
+    "container/ffmpeg-torch2.containerfile",
+    "container/ffmpeg.containerfile",
+    "container/generate_containers_yml.py",
+    "container/hf.containerfile",
+    "container/hf4.containerfile",
+    "container/hf5.containerfile",
+    "container/jdk8.containerfile",
+    "container/opencv4-hf.containerfile",
+    "container/opencv4-hf4.containerfile",
+    "container/opencv4-hf5.containerfile",
+    "container/opencv4-tf2.containerfile",
+    "container/opencv4-torch2.containerfile",
+    "container/opencv4.containerfile",
+    "container/tf2.containerfile",
+    "container/torch2.containerfile",
     "documentation/app-baseclasses.rst",
-    "documentation/gpu-apps.rst",
-    "documentation/clamsapp.rst",
     "documentation/appdirectory.rst",
-    "documentation/index.rst",
-    "documentation/tutorial.md",
-    "documentation/introduction.rst",
     "documentation/appmetadata.rst",
-    "documentation/cli.rst",
-    "documentation/runtime-params.rst",
-    "documentation/input-output.rst",
-    "documentation/conf.py",
-    "documentation/autodoc/clams.restify.rst",
     "documentation/autodoc/clams.app.rst",
+    "documentation/autodoc/clams.appmetadata.rst",
     "documentation/autodoc/clams.backends.rst",
     "documentation/autodoc/clams.mmif_utils.rst",
-    "documentation/autodoc/clams.appmetadata.rst",
-    "tests/test_promptable.py",
+    "documentation/autodoc/clams.restify.rst",
+    "documentation/clamsapp.rst",
+    "documentation/cli.rst",
+    "documentation/conf.py",
+    "documentation/gpu-apps.rst",
+    "documentation/index.rst",
+    "documentation/input-output.rst",
+    "documentation/introduction.rst",
+    "documentation/modules.rst",
+    "documentation/runtime-params.rst",
+    "documentation/target-versions.csv",
+    "documentation/tutorial.md",
+    "pyproject.toml",
+    "tests/metadata.py",
     "tests/pillow-logo.png",
     "tests/test_backends_hf.py",
-    "tests/test_envelope.py",
-    "tests/metadata.py",
     "tests/test_clamsapp.py",
-    "container/tf2.containerfile",
-    "container/opencv4-hf.containerfile",
-    "container/torch2.containerfile",
-    "container/opencv4-hf4.containerfile",
-    "container/Containerfile",
-    "container/hf4.containerfile",
-    "container/ffmpeg-hf.containerfile",
-    "container/ffmpeg-tf2.containerfile",
-    "container/generate_containers_yml.py",
-    "container/opencv4-tf2.containerfile",
-    "container/opencv4-torch2.containerfile",
-    "container/hf.containerfile",
-    "container/jdk8.containerfile",
-    "container/hf5.containerfile",
-    "container/ffmpeg.containerfile",
-    "container/ffmpeg-hf5.containerfile",
-    "container/ffmpeg-hf4.containerfile",
-    "container/opencv4-hf5.containerfile",
-    "container/ffmpeg-torch2.containerfile",
-    "container/opencv4.containerfile",
-    ".github/workflows/container.yml",
-    ".github/workflows/containers.yml",
-    ".github/workflows/issue-close.yml",
-    ".github/workflows/codecov.yml",
-    ".github/workflows/release-check.yml",
-    ".github/workflows/issue-infra-project.yml",
-    ".github/workflows/issue-assign.yml",
-    ".github/workflows/publish.yml"
+    "tests/test_envelope.py",
+    "tests/test_promptable.py"
   ]
 }

clams_python-1.7.4/clams_python.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "1.7.4",
+  "distance": 0,
+  "node": "g4a9316fc63b59287b43542fd15047a9a28028510",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-09-01"
+}

clams_python-1.7.4/container/ffmpeg-torch2.containerfile

@@ -0,0 +1,13 @@
+ARG clams_version
+FROM ghcr.io/clamsproject/clams-python-ffmpeg:$clams_version
+LABEL org.opencontainers.image.description="clams-python-ffmpeg-torch2 image is shipped with clams-python, ffmpeg, and PyTorch2"
+
+RUN pip install --no-cache-dir torch==2.*
+
+# PyTorch ships Triton, which JIT-compiles a small host-side CUDA driver shim
+# at runtime -- that needs a C compiler + libc headers. Keep it minimal
+# (gcc + libc6-dev); build-essential is not required.
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends gcc libc6-dev \
+    && rm -rf /var/lib/apt/lists/*
+

clams_python-1.7.4/container/opencv4-torch2.containerfile

@@ -0,0 +1,13 @@
+ARG clams_version
+FROM ghcr.io/clamsproject/clams-python-opencv4:$clams_version
+LABEL org.opencontainers.image.description="clams-python-opencv4-torch2 image is shipped with clams-python, opencv4 (ffmpeg backend), and PyTorch2"
+
+RUN pip install --no-cache-dir torch==2.*
+
+# PyTorch ships Triton, which JIT-compiles a small host-side CUDA driver shim
+# at runtime -- that needs a C compiler + libc headers. Keep it minimal
+# (gcc + libc6-dev); build-essential is not required.
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends gcc libc6-dev \
+    && rm -rf /var/lib/apt/lists/*
+

clams_python-1.7.4/container/torch2.containerfile

@@ -0,0 +1,13 @@
+ARG clams_version
+FROM ghcr.io/clamsproject/clams-python:$clams_version
+LABEL org.opencontainers.image.description="clams-python-torch2 image is shipped with clams-python and PyTorch2"
+
+RUN pip install --no-cache-dir torch==2.*
+
+# PyTorch ships Triton, which JIT-compiles a small host-side CUDA driver shim
+# at runtime -- that needs a C compiler + libc headers. Keep it minimal
+# (gcc + libc6-dev); build-essential is not required.
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends gcc libc6-dev \
+    && rm -rf /var/lib/apt/lists/*
+

{clams_python-1.7.3 → clams_python-1.7.4}/documentation/app-baseclasses.rst

@@ -550,6 +550,11 @@ A consumer of the output MMIF can read the resolved revision directly
 from the view metadata, with no cross-reference to the app metadata
 required.
 
+This ``model`` handling is a specific instance of the general MMIF convention
+for recording runtime configuration; see the view-metadata section of the
+`MMIF specification <https://mmif.clams.ai/1.2.0/>`_ for the definitions of the
+``parameters`` and ``appConfiguration`` fields.
+
 What the base class provides
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 

{clams_python-1.7.3 → clams_python-1.7.4}/documentation/clamsapp.rst

@@ -299,6 +299,18 @@ The envelope looks like this:
 The output is always raw MMIF, regardless of input format, so downstream
 pipeline steps are unaffected.
 
+.. note::
+
+   The values in the envelope's ``parameters`` block (not to be confused with
+   ``view.metadata.parameters``, the recorded output field) are interpreted as
+   native JSON. Use real numbers, booleans, arrays, and objects (e.g. ``0.7``, ``true``,
+   ``["a", "b"]``, ``{"B": "bars"}``), not the URL-encoded string form. To
+   reproduce a past run from an existing MMIF, copy the target view's
+   ``appConfiguration`` into the envelope's ``parameters``; it holds the fully
+   resolved, native-JSON configuration. Copying from ``view.metadata.parameters``
+   is not reliable, since that field is the raw "as typed" transcript and is not
+   guaranteed to round-trip.
+
 You can still combine the envelope with query string parameters.
 When the same parameter appears in both, the **query string takes priority**,
 which allows quick overrides without editing the parameter file:

{clams_python-1.7.3 → clams_python-1.7.4}/documentation/introduction.rst

@@ -69,7 +69,7 @@ When you inherit :class:`~clams.app.ClamsApp`, you need to implement
 As a developer you can expose different behaviors of the ``annotate()`` method by providing configurable parameters as keyword arguments of the method. For example, you can have the user specify a re-sample rate of an audio file to be analyzed by providing a ``resample_rate`` parameter. 
 
 .. note::
-  These runtime configurations are not part of the MMIF input, but for reproducible analysis, you should record these configurations in the output MMIF. 
+  These runtime configurations are not part of the MMIF input. The SDK records them automatically in the output view metadata for reproducibility: the raw user input in ``view.metadata.parameters`` and the fully resolved configuration in ``view.metadata.appConfiguration``. Both fields are defined in the view-metadata section of the `MMIF specification <https://mmif.clams.ai/1.2.0/>`_.
 
 .. note::
   Some runtime parameters are managed by the SDK itself rather than declared per-app. The *universal* parameters in :const:`clams.app.ClamsApp.universal_parameters` are one such set; they are auto-added to every CLAMS app. Specialized base classes (see below) add their own SDK-managed parameter sets on top.

{clams_python-1.7.3 → clams_python-1.7.4}/documentation/runtime-params.rst

@@ -32,9 +32,17 @@ annotations. See an example below.
           
       ...
 
-When you use a configuration parameter in your app, you should also expose it 
+When you use a configuration parameter in your app, you should also expose it
 to the user via the app metadata. See :ref:`appmetadata` section for more details.
 
+.. note::
+  Whichever channel supplies them, the SDK records the runtime parameters in the
+  output view metadata: the raw user input (as strings) in
+  ``view.metadata.parameters``, and the fully refined configuration (defaults filled
+  and values cast) in ``view.metadata.appConfiguration``. See the view-metadata
+  section of the `MMIF specification <https://mmif.clams.ai/1.2.0/>`_ for the
+  authoritative definitions of these two fields.
+
 As HTTP Server
 --------------
 

{clams_python-1.7.3 → clams_python-1.7.4}/documentation/target-versions.csv

@@ -1,4 +1,5 @@
 "``clams-python`` version","``mmif-python`` version","Target MMIF Specification"
+`1.7.4 <https://pypi.org/project/clams-python/1.7.4/>`__,`1.5.3 <https://pypi.org/project/mmif-python/1.5.3/>`__,`1.2.0 <https://mmif.clams.ai/1.2.0/>`__
 `1.7.3 <https://pypi.org/project/clams-python/1.7.3/>`__,`1.5.1 <https://pypi.org/project/mmif-python/1.5.1/>`__,`1.2.0 <https://mmif.clams.ai/1.2.0/>`__
 `1.7.2 <https://pypi.org/project/clams-python/1.7.2/>`__,`1.5.1 <https://pypi.org/project/mmif-python/1.5.1/>`__,`1.2.0 <https://mmif.clams.ai/1.2.0/>`__
 `1.7.1 <https://pypi.org/project/clams-python/1.7.1/>`__,`1.5.1 <https://pypi.org/project/mmif-python/1.5.1/>`__,`1.2.0 <https://mmif.clams.ai/1.2.0/>`__

{clams_python-1.7.3 → clams_python-1.7.4}/tests/test_clamsapp.py

@@ -262,6 +262,34 @@ class TestClamsApp(unittest.TestCase):
         self.assertEqual(len(v4.metadata.appConfiguration), 6)
         self.assertEqual(len(v4.metadata.parameters['multivalued_param']), len(str(multiple_values)))
 
+    def test_add_parameters_to_metadata_len_branch(self):
+        # recording branches purely on the number of values, uniformly for
+        # declared and undeclared params (issue #296)
+        m = Mmif(self.in_mmif)
+
+        # single value -> bare value, no list brackets
+        v = m.new_view()
+        self.app.add_parameters_to_metadata(v, {'undeclared': ['solo']})
+        self.assertEqual(v.metadata.parameters['undeclared'], 'solo')
+
+        # multiple values -> serialized list, no data loss
+        v = m.new_view()
+        self.app.add_parameters_to_metadata(v, {'undeclared_multi': ['a', 'b']})
+        self.assertEqual(v.metadata.parameters['undeclared_multi'], str(['a', 'b']))
+
+        # empty list (only an envelope like {"x": []}/{"x": {}} can produce it)
+        # -> treated as unset, skipped, and must not raise IndexError
+        v = m.new_view()
+        self.app.add_parameters_to_metadata(v, {'empty': []})
+        self.assertNotIn('empty', v.metadata.parameters)
+
+        # a declared multivalued param given a single value is also recorded clean
+        self.app.metadata.add_parameter(
+            'mv', 'multivalued', type='string', multivalued=True, default=[])
+        v = m.new_view()
+        self.app.add_parameters_to_metadata(v, {'mv': ['only']})
+        self.assertEqual(v.metadata.parameters['mv'], 'only')
+
     def test_app_tags_default_empty(self):
         # apps that don't declare tags should not write an appTags field to view metadata
         self.assertEqual(self.app.metadata.app_tags, [])
@@ -417,6 +445,55 @@ class TestClamsApp(unittest.TestCase):
         self.assertEqual(len(last_view.metadata.contains), 0)
         self.assertEqual(len(last_view.metadata.error), 2)
 
+    def test_empty_view_becomes_warning_view(self):
+        class EmptyClamsApp(clams.app.ClamsApp):
+            def _appmetadata(self):
+                pass
+            def _annotate(self, mmif, **kwargs):
+                new_view = mmif.new_view()
+                self.sign_view(new_view, kwargs)
+                new_view.new_contain(AnnotationTypes.TimeFrame)
+                return mmif
+        out_mmif = Mmif(EmptyClamsApp().annotate(self.in_mmif))
+        self.assertEqual(len(out_mmif.views), 1)
+        view = next(iter(out_mmif.views))
+        self.assertEqual(len(view.annotations), 0)
+        self.assertTrue(any('EmptyOutputWarning' in w for w in view.metadata.warnings))
+
+    def test_partial_empty_views_are_pruned_without_warning(self):
+        class MixedClamsApp(clams.app.ClamsApp):
+            def _appmetadata(self):
+                pass
+            def _annotate(self, mmif, **kwargs):
+                populated = mmif.new_view()
+                self.sign_view(populated, kwargs)
+                populated.new_contain(AnnotationTypes.TimeFrame)
+                populated.new_annotation(AnnotationTypes.TimeFrame, start=0, end=1)
+                empty = mmif.new_view()
+                self.sign_view(empty, kwargs)
+                empty.new_contain(AnnotationTypes.TimeFrame)
+                return mmif
+        out_mmif = Mmif(MixedClamsApp().annotate(self.in_mmif))
+        self.assertEqual(len(out_mmif.views), 1)
+        view = next(iter(out_mmif.views))
+        self.assertEqual(len(view.annotations), 1)
+        self.assertFalse(view.has_warnings())
+
+    def test_self_reported_error_view_is_not_pruned(self):
+        class ErroringClamsApp(clams.app.ClamsApp):
+            def _appmetadata(self):
+                pass
+            def _annotate(self, mmif, **kwargs):
+                new_view = mmif.new_view()
+                self.sign_view(new_view, kwargs)
+                new_view.set_error('simulated failure', 'trace')
+                return mmif
+        out_mmif = Mmif(ErroringClamsApp().annotate(self.in_mmif))
+        self.assertEqual(len(out_mmif.views), 1)
+        view = next(iter(out_mmif.views))
+        self.assertTrue(view.has_error())
+        self.assertFalse(view.has_warnings())
+
     def test_gpu_mem_fields_default_zero(self):
         """GPU memory fields default to 0."""
         metadata = AppMetadata(

{clams_python-1.7.3 → clams_python-1.7.4}/tests/test_envelope.py

@@ -236,6 +236,19 @@ class TestRestifierEnvelope(unittest.TestCase):
         self.assertEqual(res.status_code, 200)
         Mmif(res.get_data(as_text=True))
 
+    def test_empty_collection_param_does_not_crash(self):
+        # {"x": []} / {"x": {}} normalize to an empty list; recording must skip
+        # the param instead of raising IndexError on v[0] (issue #296)
+        for empty in ([], {}):
+            envelope_str = create_envelope(
+                self.mmif_str, {'emptyparam': empty}
+            )
+            res = self.client.post('/', data=envelope_str)
+            self.assertEqual(res.status_code, 200)
+            out = Mmif(res.get_data(as_text=True))
+            for view in out.views:
+                self.assertNotIn('emptyparam', view.metadata.parameters)
+
     PREFIX = "Invalid input data. See below for validation error."
 
     def test_envelope_missing_mmif(self):

clams_python-1.7.3/clams_python.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "1.7.3",
-  "distance": 0,
-  "node": "gea1bca511e70720b1f46476fbb5f41ff2d9329cd",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-07-09"
-}

clams_python-1.7.3/container/ffmpeg-torch2.containerfile

@@ -1,6 +0,0 @@
-ARG clams_version
-FROM ghcr.io/clamsproject/clams-python-ffmpeg:$clams_version
-LABEL org.opencontainers.image.description="clams-python-ffmpeg-torch2 image is shipped with clams-python, ffmpeg, and PyTorch2"
-
-RUN pip install --no-cache-dir torch==2.*
-

clams_python-1.7.3/container/opencv4-torch2.containerfile

@@ -1,6 +0,0 @@
-ARG clams_version
-FROM ghcr.io/clamsproject/clams-python-opencv4:$clams_version
-LABEL org.opencontainers.image.description="clams-python-opencv4-torch2 image is shipped with clams-python, opencv4 (ffmpeg backend), and PyTorch2"
-
-RUN pip install --no-cache-dir torch==2.*
-

clams_python-1.7.3/container/torch2.containerfile

@@ -1,6 +0,0 @@
-ARG clams_version
-FROM ghcr.io/clamsproject/clams-python:$clams_version
-LABEL org.opencontainers.image.description="clams-python-torch2 image is shipped with clams-python and PyTorch2"
-
-RUN pip install --no-cache-dir torch==2.*
-