Database Packaging

.github/workflows/main.yml

@@ -41,7 +41,7 @@ jobs:
           echo number=${VERSION} >> $GITHUB_OUTPUT
 
   build:
-    timeout-minutes: 45
+    timeout-minutes: 60
     needs:
       - prepare
     strategy:
@@ -77,7 +77,7 @@ jobs:
           tags: zpm
           build-args: BASE=${{ steps.image.outputs.name }}
       - name: Run temporary registry
-        timeout-minutes: 15
+        timeout-minutes: 5
         run: |
           docker network create zpm
           docker build -f tests/registry/Dockerfile -t registry-image .

CHANGELOG.md

@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - #1117: Add `sync` command for incremental loading of changed files in dev-mode modules. Detects modified files since last sync using SHA-1 hash and recompiles only what is stale. Supports `-delete` for processing removed files and `-test` for running changed test-phase unit tests.
+- #986: Database packaging: new `package-database` and `publish-database` commands create an IRIS.DAT-based package that installs via swapping of the routines database rather than compilation of source files. Pass `-dev` to include test resources (`Scope="test"` or `Scope="verify"`) in the package, which are excluded by default.
 
 ## [0.10.9] - 2026-08-05
 

src/cls/IPM/DataType/PhaseName.cls

@@ -9,7 +9,18 @@ Parameter MAXLEN As INTEGER = 50;
 /// separated list (where the delimiter is the first character) of logical values.
 /// If a non-null value is present, then the attribute is restricted to values
 /// in the list, and the validation code simply checks to see if the value is in the list.
-/// Should be kept in sync with %IPM.Lifecycle.Base.Phases
-Parameter VALUELIST = ",Clean,Initialize,Reload,*,Validate,ExportData,Compile,Activate,Document,MakeDeployed,Test,Package,Verify,Publish,Configure,Unconfigure,ApplyUpdateSteps,Sync";
+///
+/// Canonical lifecycle phase ordering. Phases execute in this order during a complete
+/// lifecycle run (e.g., load with isComplete=1). Each phase name corresponds to a
+/// %<PhaseName> method on %IPM.Lifecycle.Base and its subclasses.
+///
+/// The "*" entry is not a real phase — it is a module-object refresh checkpoint.
+/// When ExecutePhases (in %IPM.Storage.Module) encounters "*", it kills and reopens
+/// the module and lifecycle objects from storage, picking up any changes made by
+/// earlier phases (e.g., module.xml modifications during Reload). No lifecycle method
+/// is called for "*", and no resource processor hooks or <Invoke> elements target it.
+///
+/// Should be kept in sync with %IPM.Lifecycle.Base.PHASES.
+Parameter VALUELIST = ",Clean,Initialize,Reload,*,Validate,ExportData,Compile,Activate,Document,MakeDeployed,Test,Package,Verify,Publish,Configure,Unconfigure,ApplyUpdateSteps";
 
 }

src/cls/IPM/Lifecycle/Base.cls

@@ -1404,9 +1404,11 @@ Method ExportPythonDependencies(
     $$$ThrowOnError(..InstallOrDownloadPythonRequirements(root, .pParams, 1))
     set wheelsDir = ##class(%File).NormalizeDirectory("wheels", module.Root)
     if '##class(%File).DirectoryExists(wheelsDir) {
-        // ExportPythonDependencies called on base module + dependencies so don't want to error if one of
-        // the modules doesn't have a wheels directory since that might actually be the case for the module
-        write !, "WARNING: No wheels directory for this module: "_wheelsDir_" not found"
+        // A module without Python requirements legitimately has no wheels directory, so this is only worth warning about
+        // when requirements.txt exists but the download produced nothing.
+        if ##class(%File).Exists(##class(%File).NormalizeFilename("requirements.txt", root)) {
+            write !, "WARNING: No wheels directory for this module: "_wheelsDir_" not found"
+        }
         quit
     }
     set stmt = ##class(%SQL.Statement).%New()
@@ -1620,7 +1622,13 @@ Method %Publish(ByRef pParams) As %Status
             quit
         }
         set tModule.VersionString = ..Module.VersionString
-        if (..Module.Deployed) {
+        // Publish type comes from the running lifecycle, not the module's Packaging property.
+        // ..Module.Packaging records how the module was loaded (may be stale); the PACKAGING
+        // parameter is fixed per lifecycle class and reflects how it's being published now.
+        if ($parameter($this, "PACKAGING") = "database") {
+            set tModule.IPMPackaging = "database"
+            set tModule.PlatformVersion = $system.Version.GetMajor() _ "." _ $system.Version.GetMinor()
+        } elseif (..Module.Deployed) {
             set tModule.Deployed = 1
             if $isobject(..Module.SystemRequirements) {
                 set tModule.PlatformVersion = ..Module.SystemRequirements.VersionString
@@ -2127,6 +2135,9 @@ Method ExportSingleModule(
     }
 }
 
+/// Returns the lifecycle class whose Final PACKAGING parameter equals pPackaging.
+/// pBaseClass is "" when no class claims that value. This is a valid outcome, since packaging values are
+/// not constrained to those with a dedicated lifecycle class. Callers decide the fallback.
 ClassMethod GetBaseClassForPackaging(
 	pPackaging As %String,
 	Output pBaseClass As %Dictionary.Classname) As %Status [ Final ]
@@ -2145,8 +2156,6 @@ ClassMethod GetBaseClassForPackaging(
             set pBaseClass = tRes.%Get("BaseClass")
         }
         $$$ThrowOnError(tSC)
-
-        // TODO: Error if no results?
     } catch e {
         set pBaseClass = ""
         set tSC = e.AsStatus()