@platforma-sdk/package-builder-lib 1.1.0

package/dist/core/docker-conda.js

@@ -0,0 +1,71 @@
+import { CONDA_DATA_LOCATION, CONDA_DOCKER_BASE_IMAGE, CONDA_FROZEN_ENV_SPEC_FILE, CONDA_MICROMAMBA_VERSION, DOCKER_PLACEHOLDER_PKG } from "../defaults.js";
+import { CLIError } from "./util.js";
+import { dockerfileAutogenPath } from "./docker.js";
+import { assets } from "./paths.js";
+import { micromambaDownloadUrl } from "./conda/builder.js";
+import { validateCondaSpec } from "./conda/validate-spec.js";
+import * as fs$1 from "node:fs";
+import * as path$1 from "node:path";
+//#region src/core/docker-conda.ts
+const tmpSpecFile = "tmp-env-spec-88344b62d74b9307.yaml";
+function generateCondaDockerfileContent(options, arch) {
+	const templatePath = assets("conda-dockerfile.template");
+	return fs$1.readFileSync(templatePath, "utf-8").replaceAll("${BASE_IMAGE_TAG}", options.baseImageTag).replaceAll("${MAMBA_ROOT_PREFIX}", path$1.posix.join(options.pkg, CONDA_DATA_LOCATION)).replaceAll("${CONDA_PKGS_DIRS}", path$1.posix.join(options.pkg, CONDA_DATA_LOCATION, "pkgs")).replaceAll("${MICROMAMBA_DOWNLOAD_URL}", micromambaDownloadUrl(options.micromambaVersion, `linux-${arch}`)).replaceAll("${PKG}", options.pkg).replaceAll("${TMP_SPEC_FILE}", tmpSpecFile).replaceAll("${FROZEN_SPEC_FILE}", options.frozenSpecFile);
+}
+function prepareDockerOptions(logger, currentPackageRoot, artifactID, buildParams, arch) {
+	logger.debug(`Preparing Docker options for Conda package: ${buildParams.name} (id: ${artifactID})`);
+	const options = getDefaultCondaOptions();
+	options.micromambaVersion = buildParams["micromamba-version"];
+	if (buildParams.pkg) options.pkg = buildParams.pkg;
+	const platform = `linux-${arch}`;
+	if (!buildParams.roots) throw CLIError("Cannot prepare Docker options: package root directory is not specified. Please ensure the \"root\" property is set in the build parameters.");
+	if (!buildParams.roots[platform]) throw CLIError(`Cannot prepare Docker options: ${platform} root directory is not specified. Please ensure the 'roots' property is set for artifact.`);
+	const contextDir = path$1.resolve(currentPackageRoot, buildParams.roots[platform]);
+	if (!fs$1.existsSync(contextDir)) fs$1.mkdirSync(contextDir, { recursive: true });
+	const srcSpecPath = path$1.join(currentPackageRoot, buildParams.spec);
+	logger.debug(`Validating conda spec file for forbidden channels...`);
+	try {
+		validateCondaSpec(logger, srcSpecPath);
+	} catch (error) {
+		const errorMessage = error instanceof Error ? error.message : String(error);
+		logger.error(errorMessage);
+		throw CLIError(`Cannot prepare Docker options for conda package '${artifactID}': ${errorMessage}`);
+	}
+	const dockerfilePath = dockerfileAutogenPath(currentPackageRoot, artifactID);
+	const dockerfileDir = path$1.dirname(dockerfilePath);
+	fs$1.mkdirSync(dockerfileDir, { recursive: true });
+	logger.debug(`Created directory for autogenerated dockerfiles: ${dockerfileDir}`);
+	fs$1.copyFileSync(srcSpecPath, path$1.join(contextDir, tmpSpecFile));
+	logger.debug(`Copied spec file to context directory`);
+	const dockerfile = {
+		content: generateCondaDockerfileContent(options, arch),
+		path: dockerfilePath
+	};
+	fs$1.writeFileSync(dockerfile.path, dockerfile.content);
+	logger.debug(`Written Dockerfile to: ${dockerfile.path}`);
+	const result = {
+		dockerfile: dockerfile.path,
+		context: contextDir,
+		entrypoint: [],
+		pkg: options.pkg
+	};
+	logger.debug(`Prepared Docker options: ${JSON.stringify(result)}`);
+	verifyDockerOptions(result);
+	return result;
+}
+function getDefaultCondaOptions() {
+	return {
+		baseImageTag: CONDA_DOCKER_BASE_IMAGE,
+		micromambaVersion: CONDA_MICROMAMBA_VERSION,
+		frozenSpecFile: CONDA_FROZEN_ENV_SPEC_FILE,
+		pkg: DOCKER_PLACEHOLDER_PKG
+	};
+}
+function verifyDockerOptions(options) {
+	if (!fs$1.existsSync(options.dockerfile)) throw CLIError(`Dockerfile '${options.dockerfile}' not found`);
+	if (!fs$1.existsSync(options.context)) throw CLIError(`Context '${options.context}' not found`);
+}
+//#endregion
+export { prepareDockerOptions, tmpSpecFile };
+
+//# sourceMappingURL=docker-conda.js.map

package/dist/core/docker-conda.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-conda.js","names":["paths.assets","fs","path","defaults.CONDA_DATA_LOCATION","util.CLIError","defaults.CONDA_DOCKER_BASE_IMAGE","defaults.CONDA_MICROMAMBA_VERSION","defaults.CONDA_FROZEN_ENV_SPEC_FILE","defaults.DOCKER_PLACEHOLDER_PKG"],"sources":["../../src/core/docker-conda.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type winston from \"winston\";\n\nimport * as defaults from \"../defaults\";\nimport * as paths from \"./paths\";\nimport * as util from \"./util\";\n\nimport type * as artifacts from \"./schemas/artifacts\";\nimport { micromambaDownloadUrl } from \"./conda/builder\";\nimport { validateCondaSpec } from \"./conda/validate-spec\";\nimport { dockerfileAutogenPath } from \"./docker\";\n\nexport const tmpSpecFile = \"tmp-env-spec-88344b62d74b9307.yaml\";\n\nexport interface CondaOptions {\n  baseImageTag: string;\n  micromambaVersion: string;\n  frozenSpecFile: string;\n  pkg: string;\n}\n\nexport interface DockerOptions {\n  context: string;\n  dockerfile: string;\n  entrypoint: string[];\n  pkg: string;\n}\n\nexport interface CondaDockerOptions extends CondaOptions, DockerOptions {}\n\nfunction generateCondaDockerfileContent(options: CondaOptions, arch: util.ArchType): string {\n  // Read template from assets\n  const templatePath = paths.assets(\"conda-dockerfile.template\");\n  const templateContent = fs.readFileSync(templatePath, \"utf-8\");\n\n  // Generate Dockerfile with dependencies\n  return templateContent\n    .replaceAll(\"${BASE_IMAGE_TAG}\", options.baseImageTag)\n    .replaceAll(\"${MAMBA_ROOT_PREFIX}\", path.posix.join(options.pkg, defaults.CONDA_DATA_LOCATION))\n    .replaceAll(\n      \"${CONDA_PKGS_DIRS}\",\n      path.posix.join(options.pkg, defaults.CONDA_DATA_LOCATION, \"pkgs\"),\n    )\n    .replaceAll(\n      \"${MICROMAMBA_DOWNLOAD_URL}\",\n      micromambaDownloadUrl(options.micromambaVersion, `linux-${arch}`),\n    )\n    .replaceAll(\"${PKG}\", options.pkg)\n    .replaceAll(\"${TMP_SPEC_FILE}\", tmpSpecFile)\n    .replaceAll(\"${FROZEN_SPEC_FILE}\", options.frozenSpecFile);\n}\n\nexport function prepareDockerOptions(\n  logger: winston.Logger,\n  currentPackageRoot: string,\n  artifactID: string,\n  buildParams: artifacts.condaType,\n  arch: util.ArchType,\n): DockerOptions {\n  logger.debug(\n    `Preparing Docker options for Conda package: ${buildParams.name} (id: ${artifactID})`,\n  );\n\n  const options = getDefaultCondaOptions();\n  options.micromambaVersion = buildParams[\"micromamba-version\"];\n\n  if (buildParams.pkg) {\n    options.pkg = buildParams.pkg;\n  }\n\n  const platform: util.PlatformType = `linux-${arch}`;\n\n  if (!buildParams.roots) {\n    throw util.CLIError(\n      'Cannot prepare Docker options: package root directory is not specified. Please ensure the \"root\" property is set in the build parameters.',\n    );\n  }\n  if (!buildParams.roots[platform]) {\n    throw util.CLIError(\n      `Cannot prepare Docker options: ${platform} root directory is not specified. Please ensure the 'roots' property is set for artifact.`,\n    );\n  }\n\n  const contextDir = path.resolve(currentPackageRoot, buildParams.roots[platform]);\n  if (!fs.existsSync(contextDir)) {\n    fs.mkdirSync(contextDir, { recursive: true });\n  }\n\n  // Validate conda spec file before building\n  const srcSpecPath = path.join(currentPackageRoot, buildParams.spec);\n  logger.debug(`Validating conda spec file for forbidden channels...`);\n  try {\n    validateCondaSpec(logger, srcSpecPath);\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    logger.error(errorMessage);\n    throw util.CLIError(\n      `Cannot prepare Docker options for conda package '${artifactID}': ${errorMessage}`,\n    );\n  }\n\n  // Generate a temporary directory for the Dockerfile\n  const dockerfilePath = dockerfileAutogenPath(currentPackageRoot, artifactID);\n  const dockerfileDir = path.dirname(dockerfilePath);\n  fs.mkdirSync(dockerfileDir, { recursive: true });\n  logger.debug(`Created directory for autogenerated dockerfiles: ${dockerfileDir}`);\n\n  fs.copyFileSync(srcSpecPath, path.join(contextDir, tmpSpecFile));\n  logger.debug(`Copied spec file to context directory`);\n\n  const dockerfile = {\n    content: generateCondaDockerfileContent(options, arch),\n    path: dockerfilePath,\n  };\n\n  fs.writeFileSync(dockerfile.path, dockerfile.content);\n  logger.debug(`Written Dockerfile to: ${dockerfile.path}`);\n\n  const result: DockerOptions = {\n    dockerfile: dockerfile.path,\n    context: contextDir,\n    entrypoint: [],\n    pkg: options.pkg,\n  };\n\n  logger.debug(`Prepared Docker options: ${JSON.stringify(result)}`);\n  verifyDockerOptions(result);\n  return result;\n}\n\nfunction getDefaultCondaOptions(): CondaOptions {\n  return {\n    baseImageTag: defaults.CONDA_DOCKER_BASE_IMAGE,\n    micromambaVersion: defaults.CONDA_MICROMAMBA_VERSION,\n    frozenSpecFile: defaults.CONDA_FROZEN_ENV_SPEC_FILE,\n    pkg: defaults.DOCKER_PLACEHOLDER_PKG,\n  };\n}\n\nfunction verifyDockerOptions(options: DockerOptions) {\n  if (!fs.existsSync(options.dockerfile)) {\n    throw util.CLIError(`Dockerfile '${options.dockerfile}' not found`);\n  }\n\n  if (!fs.existsSync(options.context)) {\n    throw util.CLIError(`Context '${options.context}' not found`);\n  }\n}\n"],"mappings":";;;;;;;;;AAaA,MAAa,cAAc;AAkB3B,SAAS,+BAA+B,SAAuB,MAA6B;CAE1F,MAAM,eAAeA,OAAa,4BAA4B;AAI9D,QAHwBC,KAAG,aAAa,cAAc,QAAQ,CAI3D,WAAW,qBAAqB,QAAQ,aAAa,CACrD,WAAW,wBAAwBC,OAAK,MAAM,KAAK,QAAQ,KAAKC,oBAA6B,CAAC,CAC9F,WACC,sBACAD,OAAK,MAAM,KAAK,QAAQ,KAAKC,qBAA8B,OAAO,CACnE,CACA,WACC,8BACA,sBAAsB,QAAQ,mBAAmB,SAAS,OAAO,CAClE,CACA,WAAW,UAAU,QAAQ,IAAI,CACjC,WAAW,oBAAoB,YAAY,CAC3C,WAAW,uBAAuB,QAAQ,eAAe;;AAG9D,SAAgB,qBACd,QACA,oBACA,YACA,aACA,MACe;AACf,QAAO,MACL,+CAA+C,YAAY,KAAK,QAAQ,WAAW,GACpF;CAED,MAAM,UAAU,wBAAwB;AACxC,SAAQ,oBAAoB,YAAY;AAExC,KAAI,YAAY,IACd,SAAQ,MAAM,YAAY;CAG5B,MAAM,WAA8B,SAAS;AAE7C,KAAI,CAAC,YAAY,MACf,OAAMC,SACJ,8IACD;AAEH,KAAI,CAAC,YAAY,MAAM,UACrB,OAAMA,SACJ,kCAAkC,SAAS,2FAC5C;CAGH,MAAM,aAAaF,OAAK,QAAQ,oBAAoB,YAAY,MAAM,UAAU;AAChF,KAAI,CAACD,KAAG,WAAW,WAAW,CAC5B,MAAG,UAAU,YAAY,EAAE,WAAW,MAAM,CAAC;CAI/C,MAAM,cAAcC,OAAK,KAAK,oBAAoB,YAAY,KAAK;AACnE,QAAO,MAAM,uDAAuD;AACpE,KAAI;AACF,oBAAkB,QAAQ,YAAY;UAC/B,OAAO;EACd,MAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AAC3E,SAAO,MAAM,aAAa;AAC1B,QAAME,SACJ,oDAAoD,WAAW,KAAK,eACrE;;CAIH,MAAM,iBAAiB,sBAAsB,oBAAoB,WAAW;CAC5E,MAAM,gBAAgBF,OAAK,QAAQ,eAAe;AAClD,MAAG,UAAU,eAAe,EAAE,WAAW,MAAM,CAAC;AAChD,QAAO,MAAM,oDAAoD,gBAAgB;AAEjF,MAAG,aAAa,aAAaA,OAAK,KAAK,YAAY,YAAY,CAAC;AAChE,QAAO,MAAM,wCAAwC;CAErD,MAAM,aAAa;EACjB,SAAS,+BAA+B,SAAS,KAAK;EACtD,MAAM;EACP;AAED,MAAG,cAAc,WAAW,MAAM,WAAW,QAAQ;AACrD,QAAO,MAAM,0BAA0B,WAAW,OAAO;CAEzD,MAAM,SAAwB;EAC5B,YAAY,WAAW;EACvB,SAAS;EACT,YAAY,EAAE;EACd,KAAK,QAAQ;EACd;AAED,QAAO,MAAM,4BAA4B,KAAK,UAAU,OAAO,GAAG;AAClE,qBAAoB,OAAO;AAC3B,QAAO;;AAGT,SAAS,yBAAuC;AAC9C,QAAO;EACL,cAAcG;EACd,mBAAmBC;EACnB,gBAAgBC;EAChB,KAAKC;EACN;;AAGH,SAAS,oBAAoB,SAAwB;AACnD,KAAI,CAACP,KAAG,WAAW,QAAQ,WAAW,CACpC,OAAMG,SAAc,eAAe,QAAQ,WAAW,aAAa;AAGrE,KAAI,CAACH,KAAG,WAAW,QAAQ,QAAQ,CACjC,OAAMG,SAAc,YAAY,QAAQ,QAAQ,aAAa"}

package/dist/core/docker-python.cjs

@@ -0,0 +1,147 @@
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_defaults = require("../defaults.cjs");
+const require_util = require("./util.cjs");
+const require_docker = require("./docker.cjs");
+const require_paths = require("./paths.cjs");
+const require_resolver = require("./resolver.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path);
+//#region src/core/docker-python.ts
+const PYTHON_VERSION_PATTERNS = {
+	PY3_PREFIX: /^3\./,
+	VERSION_FORMAT: /^3\.\d+(?:\.\d+)?(?:[-+_][a-zA-Z0-9]+|(?:a|b|rc)\d+|[a-zA-Z]+\d+(?:\.[a-zA-Z0-9]+)*)*$/,
+	DOCKER_SEPARATOR: /@.*$/,
+	DOCKER_UNSAFE_CHARS: /[^A-Za-z0-9_.-]+/g,
+	MULTIPLE_SEPARATORS: /[-.]{2,}/g,
+	EDGE_SEPARATORS: /^[-.]+|[-.]+$/g,
+	DOCKER_TAG_FORMAT: /^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$/
+};
+function generatePythonDockerfileContent(options) {
+	const templatePath = require_paths.assets("python-dockerfile.template");
+	const templateContent = node_fs.readFileSync(templatePath, "utf-8");
+	const envVars = options.envVars.map((envVar) => `ENV ${envVar}`).join("\n");
+	return templateContent.replace(/\$\{RUNENV_ENVS\}/g, envVars).replace(/\$\{BASE_IMAGE_TAG\}/g, options.baseImageTag).replace(/\$\{REQUIREMENTS_PATH\}/g, options.requirements).replace(/\$\{REQUIREMENTS_FILENAME\}/g, node_path.basename(options.requirements)).replace(/\$\{TOOLSET\}/g, options.toolset).replace(/\$\{PKG\}/g, options.pkg);
+}
+function prepareDockerOptions(logger, currentPackageRoot, currentPackageName, artifactID, buildParams) {
+	logger.debug(`Preparing Docker options for Python package: ${buildParams.name} (id: ${artifactID})`);
+	const options = getDefaultPythonOptions();
+	const pythonInfo = getRunEnvironmentPythonInfo(logger, currentPackageRoot, currentPackageName, buildParams.environment);
+	if (pythonInfo.pythonVersion) {
+		logger.debug(`Extracted Python version from environment: ${pythonInfo.pythonVersion}`);
+		options.baseImageTag = pythonVersionToDockerTag(pythonInfo.pythonVersion);
+	} else logger.debug(`No Python version found in environment, using default: ${options.baseImageTag}`);
+	options.envVars = pythonInfo.envVars;
+	if (buildParams.dependencies) {
+		options.toolset = buildParams.dependencies.toolset;
+		options.requirements = buildParams.dependencies.requirements;
+	}
+	if (buildParams.pkg) options.pkg = buildParams.pkg;
+	if (!buildParams.root) throw require_util.CLIError("Cannot prepare Docker options: package root directory is not specified. Please ensure the \"root\" property is set in the build parameters.");
+	const contextDir = node_path.resolve(buildParams.root ?? currentPackageRoot);
+	options.requirements = node_path.join(contextDir, options.requirements);
+	if (!node_fs.existsSync(options.requirements)) {
+		node_fs.writeFileSync(options.requirements, "# No dependencies specified\n");
+		logger.warn(`Created empty requirements.txt at: ${options.requirements}`);
+	}
+	options.requirements = node_path.relative(contextDir, options.requirements);
+	const dockerfilePath = require_docker.dockerfileAutogenPath(currentPackageRoot, artifactID);
+	const dockerfileDir = node_path.dirname(dockerfilePath);
+	node_fs.mkdirSync(dockerfileDir, { recursive: true });
+	logger.debug(`Created temporary Docker directory: ${dockerfileDir}`);
+	const dockerfile = {
+		content: generatePythonDockerfileContent(options),
+		path: dockerfilePath
+	};
+	node_fs.writeFileSync(dockerfile.path, dockerfile.content);
+	logger.debug(`Written Dockerfile to: ${dockerfile.path}`);
+	const result = {
+		dockerfile: dockerfile.path,
+		context: contextDir,
+		entrypoint: [],
+		pkg: options.pkg
+	};
+	logger.debug(`Prepared Docker options: ${JSON.stringify(result)}`);
+	verifyDockerOptions(result);
+	return result;
+}
+function normalizeDockerTag(candidate) {
+	if (!candidate || typeof candidate !== "string") return;
+	let normalized = candidate.replace(PYTHON_VERSION_PATTERNS.DOCKER_SEPARATOR, "");
+	if (normalized.includes(":")) normalized = normalized.split(":")[0];
+	normalized = normalized.replace(PYTHON_VERSION_PATTERNS.DOCKER_UNSAFE_CHARS, "-").replace(PYTHON_VERSION_PATTERNS.MULTIPLE_SEPARATORS, "-").replace(PYTHON_VERSION_PATTERNS.EDGE_SEPARATORS, "");
+	return normalized || void 0;
+}
+function isValidPythonVersion(version) {
+	return PYTHON_VERSION_PATTERNS.PY3_PREFIX.test(version) && PYTHON_VERSION_PATTERNS.VERSION_FORMAT.test(version);
+}
+function isValidDockerTag(tag) {
+	return PYTHON_VERSION_PATTERNS.DOCKER_TAG_FORMAT.test(tag);
+}
+function getRunEnvironmentPythonInfo(logger, currentPackageRoot, currentPackageName, runEnvironmentID, { normalizeForDocker = true } = {}) {
+	if (!runEnvironmentID) return {
+		pythonVersion: void 0,
+		envVars: []
+	};
+	const environmentDescriptor = require_resolver.resolveRunEnvironment(logger, currentPackageRoot, currentPackageName, runEnvironmentID, "python");
+	let pythonVersion = environmentDescriptor["python-version"];
+	const envVars = environmentDescriptor.envVars ?? [];
+	if (!pythonVersion) {
+		pythonVersion = void 0;
+		const trimmedInput = runEnvironmentID.trim();
+		if (!trimmedInput) return {
+			pythonVersion: void 0,
+			envVars
+		};
+		const colonIndex = trimmedInput.indexOf(":");
+		if (colonIndex === -1 || colonIndex === trimmedInput.length - 1) return {
+			pythonVersion: void 0,
+			envVars
+		};
+		pythonVersion = trimmedInput.slice(colonIndex + 1);
+		if (pythonVersion.startsWith("python")) return {
+			pythonVersion: void 0,
+			envVars
+		};
+	}
+	if (!normalizeForDocker) return {
+		pythonVersion,
+		envVars
+	};
+	const normalizedTag = normalizeDockerTag(pythonVersion);
+	if (!normalizedTag) return {
+		pythonVersion: void 0,
+		envVars
+	};
+	if (!isValidPythonVersion(normalizedTag) || !isValidDockerTag(normalizedTag)) return {
+		pythonVersion: void 0,
+		envVars
+	};
+	return {
+		pythonVersion: normalizedTag,
+		envVars
+	};
+}
+function getDefaultPythonOptions() {
+	return {
+		baseImageTag: require_defaults.PYTHON_DOCKER_BASE_IMAGE,
+		toolset: "pip",
+		requirements: require_defaults.PYTHON_REQUIREMENTS_FILE,
+		pkg: require_defaults.DOCKER_PLACEHOLDER_PKG,
+		envVars: []
+	};
+}
+function verifyDockerOptions(options) {
+	if (!node_fs.existsSync(options.dockerfile)) throw require_util.CLIError(`Dockerfile '${options.dockerfile}' not found`);
+	if (!node_fs.existsSync(options.context)) throw require_util.CLIError(`Context '${options.context}' not found`);
+}
+function pythonVersionToDockerTag(pythonVersion) {
+	const parts = pythonVersion.split(".");
+	if (parts.length > 2) return `python:${parts[0]}.${parts[1]}-slim`;
+	return `python:${pythonVersion}-slim`;
+}
+//#endregion
+exports.prepareDockerOptions = prepareDockerOptions;
+
+//# sourceMappingURL=docker-python.cjs.map

package/dist/core/docker-python.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-python.cjs","names":["fs","path","dockerfileAutogenPath","resolveRunEnvironment"],"sources":["../../src/core/docker-python.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type winston from \"winston\";\n\nimport * as defaults from \"../defaults\";\nimport * as paths from \"./paths\";\nimport * as util from \"./util\";\n\nimport type * as artifacts from \"./schemas/artifacts\";\nimport { resolveRunEnvironment } from \"./resolver\";\nimport { dockerfileAutogenPath } from \"./docker\";\n\nconst PYTHON_VERSION_PATTERNS = {\n  PY3_PREFIX: /^3\\./,\n  VERSION_FORMAT:\n    /^3\\.\\d+(?:\\.\\d+)?(?:[-+_][a-zA-Z0-9]+|(?:a|b|rc)\\d+|[a-zA-Z]+\\d+(?:\\.[a-zA-Z0-9]+)*)*$/,\n  DOCKER_SEPARATOR: /@.*$/,\n  DOCKER_UNSAFE_CHARS: /[^A-Za-z0-9_.-]+/g,\n  MULTIPLE_SEPARATORS: /[-.]{2,}/g,\n  EDGE_SEPARATORS: /^[-.]+|[-.]+$/g,\n  DOCKER_TAG_FORMAT: /^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$/,\n};\n\nexport interface PythonOptions {\n  baseImageTag: string;\n  toolset: string;\n  requirements: string;\n  pkg: string;\n  envVars: string[]; // custom environment variables set for run environment\n}\n\nexport interface DockerOptions {\n  context: string;\n  dockerfile: string;\n  entrypoint: string[];\n  pkg: string;\n}\n\nexport interface PythonDockerOptions extends PythonOptions, DockerOptions {}\n\nfunction generatePythonDockerfileContent(options: PythonOptions): string {\n  // Read template from assets\n  const templatePath = paths.assets(\"python-dockerfile.template\");\n  const templateContent = fs.readFileSync(templatePath, \"utf-8\");\n\n  const envVars = options.envVars.map((envVar) => `ENV ${envVar}`).join(\"\\n\");\n\n  // Generate Dockerfile with dependencies\n  return templateContent\n    .replace(/\\$\\{RUNENV_ENVS\\}/g, envVars)\n    .replace(/\\$\\{BASE_IMAGE_TAG\\}/g, options.baseImageTag)\n    .replace(/\\$\\{REQUIREMENTS_PATH\\}/g, options.requirements)\n    .replace(/\\$\\{REQUIREMENTS_FILENAME\\}/g, path.basename(options.requirements))\n    .replace(/\\$\\{TOOLSET\\}/g, options.toolset)\n    .replace(/\\$\\{PKG\\}/g, options.pkg);\n}\n\nexport function prepareDockerOptions(\n  logger: winston.Logger,\n  currentPackageRoot: string,\n  currentPackageName: string,\n  artifactID: string,\n  buildParams: artifacts.pythonType,\n): DockerOptions {\n  logger.debug(\n    `Preparing Docker options for Python package: ${buildParams.name} (id: ${artifactID})`,\n  );\n\n  const options = getDefaultPythonOptions();\n\n  const pythonInfo = getRunEnvironmentPythonInfo(\n    logger,\n    currentPackageRoot,\n    currentPackageName,\n    buildParams.environment,\n  );\n  if (pythonInfo.pythonVersion) {\n    logger.debug(`Extracted Python version from environment: ${pythonInfo.pythonVersion}`);\n    options.baseImageTag = pythonVersionToDockerTag(pythonInfo.pythonVersion);\n  } else {\n    logger.debug(`No Python version found in environment, using default: ${options.baseImageTag}`);\n  }\n  options.envVars = pythonInfo.envVars;\n\n  if (buildParams.dependencies) {\n    options.toolset = buildParams.dependencies.toolset;\n    options.requirements = buildParams.dependencies.requirements;\n  }\n\n  if (buildParams.pkg) {\n    options.pkg = buildParams.pkg;\n  }\n\n  if (!buildParams.root) {\n    throw util.CLIError(\n      'Cannot prepare Docker options: package root directory is not specified. Please ensure the \"root\" property is set in the build parameters.',\n    );\n  }\n  const contextDir = path.resolve(buildParams.root ?? currentPackageRoot);\n\n  options.requirements = path.join(contextDir, options.requirements);\n  const hasRequirements = fs.existsSync(options.requirements);\n\n  if (!hasRequirements) {\n    // If requirements.txt doesn't exist, create an empty one\n    fs.writeFileSync(options.requirements, \"# No dependencies specified\\n\");\n    logger.warn(`Created empty requirements.txt at: ${options.requirements}`);\n  }\n  // If requirements.txt exists, use relative path for Docker COPY command\n  options.requirements = path.relative(contextDir, options.requirements);\n\n  // Generate a temporary directory for the Dockerfile\n  const dockerfilePath = dockerfileAutogenPath(currentPackageRoot, artifactID);\n\n  const dockerfileDir = path.dirname(dockerfilePath);\n  fs.mkdirSync(dockerfileDir, { recursive: true });\n  logger.debug(`Created temporary Docker directory: ${dockerfileDir}`);\n\n  const dockerfile = {\n    content: generatePythonDockerfileContent(options),\n    path: dockerfilePath,\n  };\n\n  fs.writeFileSync(dockerfile.path, dockerfile.content);\n  logger.debug(`Written Dockerfile to: ${dockerfile.path}`);\n\n  const result: DockerOptions = {\n    dockerfile: dockerfile.path,\n    context: contextDir,\n    entrypoint: [],\n    pkg: options.pkg,\n  };\n\n  logger.debug(`Prepared Docker options: ${JSON.stringify(result)}`);\n  verifyDockerOptions(result);\n  return result;\n}\n\nfunction normalizeDockerTag(candidate: string): string | undefined {\n  if (!candidate || typeof candidate !== \"string\") {\n    return undefined;\n  }\n\n  // First remove Docker-specific parts like @sha256:...\n  let normalized = candidate.replace(PYTHON_VERSION_PATTERNS.DOCKER_SEPARATOR, \"\");\n\n  // For cases like \"3.12.6:latest\", extract only the version part\n  if (normalized.includes(\":\")) {\n    normalized = normalized.split(\":\")[0];\n  }\n\n  // Clean up any remaining unsafe characters\n  normalized = normalized\n    .replace(PYTHON_VERSION_PATTERNS.DOCKER_UNSAFE_CHARS, \"-\")\n    .replace(PYTHON_VERSION_PATTERNS.MULTIPLE_SEPARATORS, \"-\")\n    .replace(PYTHON_VERSION_PATTERNS.EDGE_SEPARATORS, \"\");\n\n  return normalized || undefined;\n}\n\nfunction isValidPythonVersion(version: string): boolean {\n  return (\n    PYTHON_VERSION_PATTERNS.PY3_PREFIX.test(version) &&\n    PYTHON_VERSION_PATTERNS.VERSION_FORMAT.test(version)\n  );\n}\n\nfunction isValidDockerTag(tag: string): boolean {\n  return PYTHON_VERSION_PATTERNS.DOCKER_TAG_FORMAT.test(tag);\n}\n\nexport function getRunEnvironmentPythonInfo(\n  logger: winston.Logger,\n  currentPackageRoot: string,\n  currentPackageName: string,\n  runEnvironmentID: artifacts.artifactIDString,\n  { normalizeForDocker = true }: { normalizeForDocker?: boolean } = {},\n): {\n  pythonVersion: string | undefined;\n  envVars: string[];\n} {\n  if (!runEnvironmentID) {\n    return {\n      pythonVersion: undefined,\n      envVars: [],\n    };\n  }\n\n  const environmentDescriptor = resolveRunEnvironment(\n    logger,\n    currentPackageRoot,\n    currentPackageName,\n    runEnvironmentID,\n    \"python\",\n  );\n\n  let pythonVersion: string | undefined = environmentDescriptor[\"python-version\"];\n  const envVars = environmentDescriptor.envVars ?? [];\n  if (!pythonVersion) {\n    pythonVersion = undefined;\n    const trimmedInput = runEnvironmentID.trim();\n    if (!trimmedInput) {\n      return {\n        pythonVersion: undefined,\n        envVars,\n      };\n    }\n\n    const colonIndex = trimmedInput.indexOf(\":\");\n    if (colonIndex === -1 || colonIndex === trimmedInput.length - 1) {\n      return {\n        pythonVersion: undefined,\n        envVars,\n      };\n    }\n\n    pythonVersion = trimmedInput.slice(colonIndex + 1);\n    if (pythonVersion.startsWith(\"python\")) {\n      return {\n        pythonVersion: undefined,\n        envVars,\n      };\n    }\n  }\n\n  if (!normalizeForDocker) {\n    return {\n      pythonVersion,\n      envVars,\n    };\n  }\n\n  const normalizedTag = normalizeDockerTag(pythonVersion);\n  if (!normalizedTag) {\n    return {\n      pythonVersion: undefined,\n      envVars,\n    };\n  }\n\n  if (!isValidPythonVersion(normalizedTag) || !isValidDockerTag(normalizedTag)) {\n    return {\n      pythonVersion: undefined,\n      envVars,\n    };\n  }\n\n  return {\n    pythonVersion: normalizedTag,\n    envVars,\n  };\n}\n\nfunction getDefaultPythonOptions(): PythonOptions {\n  return {\n    baseImageTag: defaults.PYTHON_DOCKER_BASE_IMAGE,\n    toolset: defaults.PYTHON_TOOLSET,\n    requirements: defaults.PYTHON_REQUIREMENTS_FILE,\n    pkg: defaults.DOCKER_PLACEHOLDER_PKG,\n    envVars: [],\n  };\n}\n\nfunction verifyDockerOptions(options: DockerOptions) {\n  if (!fs.existsSync(options.dockerfile)) {\n    throw util.CLIError(`Dockerfile '${options.dockerfile}' not found`);\n  }\n\n  if (!fs.existsSync(options.context)) {\n    throw util.CLIError(`Context '${options.context}' not found`);\n  }\n}\n\nfunction pythonVersionToDockerTag(pythonVersion: string): string {\n  const parts = pythonVersion.split(\".\");\n  if (parts.length > 2) {\n    const major = parts[0];\n    const minor = parts[1];\n    return `python:${major}.${minor}-slim`;\n  }\n\n  return `python:${pythonVersion}-slim`;\n}\n"],"mappings":"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"}

package/dist/core/docker-python.js

@@ -0,0 +1,144 @@
+import { DOCKER_PLACEHOLDER_PKG, PYTHON_DOCKER_BASE_IMAGE, PYTHON_REQUIREMENTS_FILE } from "../defaults.js";
+import { CLIError } from "./util.js";
+import { dockerfileAutogenPath } from "./docker.js";
+import { assets } from "./paths.js";
+import { resolveRunEnvironment } from "./resolver.js";
+import * as fs$1 from "node:fs";
+import * as path$1 from "node:path";
+//#region src/core/docker-python.ts
+const PYTHON_VERSION_PATTERNS = {
+	PY3_PREFIX: /^3\./,
+	VERSION_FORMAT: /^3\.\d+(?:\.\d+)?(?:[-+_][a-zA-Z0-9]+|(?:a|b|rc)\d+|[a-zA-Z]+\d+(?:\.[a-zA-Z0-9]+)*)*$/,
+	DOCKER_SEPARATOR: /@.*$/,
+	DOCKER_UNSAFE_CHARS: /[^A-Za-z0-9_.-]+/g,
+	MULTIPLE_SEPARATORS: /[-.]{2,}/g,
+	EDGE_SEPARATORS: /^[-.]+|[-.]+$/g,
+	DOCKER_TAG_FORMAT: /^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$/
+};
+function generatePythonDockerfileContent(options) {
+	const templatePath = assets("python-dockerfile.template");
+	const templateContent = fs$1.readFileSync(templatePath, "utf-8");
+	const envVars = options.envVars.map((envVar) => `ENV ${envVar}`).join("\n");
+	return templateContent.replace(/\$\{RUNENV_ENVS\}/g, envVars).replace(/\$\{BASE_IMAGE_TAG\}/g, options.baseImageTag).replace(/\$\{REQUIREMENTS_PATH\}/g, options.requirements).replace(/\$\{REQUIREMENTS_FILENAME\}/g, path$1.basename(options.requirements)).replace(/\$\{TOOLSET\}/g, options.toolset).replace(/\$\{PKG\}/g, options.pkg);
+}
+function prepareDockerOptions(logger, currentPackageRoot, currentPackageName, artifactID, buildParams) {
+	logger.debug(`Preparing Docker options for Python package: ${buildParams.name} (id: ${artifactID})`);
+	const options = getDefaultPythonOptions();
+	const pythonInfo = getRunEnvironmentPythonInfo(logger, currentPackageRoot, currentPackageName, buildParams.environment);
+	if (pythonInfo.pythonVersion) {
+		logger.debug(`Extracted Python version from environment: ${pythonInfo.pythonVersion}`);
+		options.baseImageTag = pythonVersionToDockerTag(pythonInfo.pythonVersion);
+	} else logger.debug(`No Python version found in environment, using default: ${options.baseImageTag}`);
+	options.envVars = pythonInfo.envVars;
+	if (buildParams.dependencies) {
+		options.toolset = buildParams.dependencies.toolset;
+		options.requirements = buildParams.dependencies.requirements;
+	}
+	if (buildParams.pkg) options.pkg = buildParams.pkg;
+	if (!buildParams.root) throw CLIError("Cannot prepare Docker options: package root directory is not specified. Please ensure the \"root\" property is set in the build parameters.");
+	const contextDir = path$1.resolve(buildParams.root ?? currentPackageRoot);
+	options.requirements = path$1.join(contextDir, options.requirements);
+	if (!fs$1.existsSync(options.requirements)) {
+		fs$1.writeFileSync(options.requirements, "# No dependencies specified\n");
+		logger.warn(`Created empty requirements.txt at: ${options.requirements}`);
+	}
+	options.requirements = path$1.relative(contextDir, options.requirements);
+	const dockerfilePath = dockerfileAutogenPath(currentPackageRoot, artifactID);
+	const dockerfileDir = path$1.dirname(dockerfilePath);
+	fs$1.mkdirSync(dockerfileDir, { recursive: true });
+	logger.debug(`Created temporary Docker directory: ${dockerfileDir}`);
+	const dockerfile = {
+		content: generatePythonDockerfileContent(options),
+		path: dockerfilePath
+	};
+	fs$1.writeFileSync(dockerfile.path, dockerfile.content);
+	logger.debug(`Written Dockerfile to: ${dockerfile.path}`);
+	const result = {
+		dockerfile: dockerfile.path,
+		context: contextDir,
+		entrypoint: [],
+		pkg: options.pkg
+	};
+	logger.debug(`Prepared Docker options: ${JSON.stringify(result)}`);
+	verifyDockerOptions(result);
+	return result;
+}
+function normalizeDockerTag(candidate) {
+	if (!candidate || typeof candidate !== "string") return;
+	let normalized = candidate.replace(PYTHON_VERSION_PATTERNS.DOCKER_SEPARATOR, "");
+	if (normalized.includes(":")) normalized = normalized.split(":")[0];
+	normalized = normalized.replace(PYTHON_VERSION_PATTERNS.DOCKER_UNSAFE_CHARS, "-").replace(PYTHON_VERSION_PATTERNS.MULTIPLE_SEPARATORS, "-").replace(PYTHON_VERSION_PATTERNS.EDGE_SEPARATORS, "");
+	return normalized || void 0;
+}
+function isValidPythonVersion(version) {
+	return PYTHON_VERSION_PATTERNS.PY3_PREFIX.test(version) && PYTHON_VERSION_PATTERNS.VERSION_FORMAT.test(version);
+}
+function isValidDockerTag(tag) {
+	return PYTHON_VERSION_PATTERNS.DOCKER_TAG_FORMAT.test(tag);
+}
+function getRunEnvironmentPythonInfo(logger, currentPackageRoot, currentPackageName, runEnvironmentID, { normalizeForDocker = true } = {}) {
+	if (!runEnvironmentID) return {
+		pythonVersion: void 0,
+		envVars: []
+	};
+	const environmentDescriptor = resolveRunEnvironment(logger, currentPackageRoot, currentPackageName, runEnvironmentID, "python");
+	let pythonVersion = environmentDescriptor["python-version"];
+	const envVars = environmentDescriptor.envVars ?? [];
+	if (!pythonVersion) {
+		pythonVersion = void 0;
+		const trimmedInput = runEnvironmentID.trim();
+		if (!trimmedInput) return {
+			pythonVersion: void 0,
+			envVars
+		};
+		const colonIndex = trimmedInput.indexOf(":");
+		if (colonIndex === -1 || colonIndex === trimmedInput.length - 1) return {
+			pythonVersion: void 0,
+			envVars
+		};
+		pythonVersion = trimmedInput.slice(colonIndex + 1);
+		if (pythonVersion.startsWith("python")) return {
+			pythonVersion: void 0,
+			envVars
+		};
+	}
+	if (!normalizeForDocker) return {
+		pythonVersion,
+		envVars
+	};
+	const normalizedTag = normalizeDockerTag(pythonVersion);
+	if (!normalizedTag) return {
+		pythonVersion: void 0,
+		envVars
+	};
+	if (!isValidPythonVersion(normalizedTag) || !isValidDockerTag(normalizedTag)) return {
+		pythonVersion: void 0,
+		envVars
+	};
+	return {
+		pythonVersion: normalizedTag,
+		envVars
+	};
+}
+function getDefaultPythonOptions() {
+	return {
+		baseImageTag: PYTHON_DOCKER_BASE_IMAGE,
+		toolset: "pip",
+		requirements: PYTHON_REQUIREMENTS_FILE,
+		pkg: DOCKER_PLACEHOLDER_PKG,
+		envVars: []
+	};
+}
+function verifyDockerOptions(options) {
+	if (!fs$1.existsSync(options.dockerfile)) throw CLIError(`Dockerfile '${options.dockerfile}' not found`);
+	if (!fs$1.existsSync(options.context)) throw CLIError(`Context '${options.context}' not found`);
+}
+function pythonVersionToDockerTag(pythonVersion) {
+	const parts = pythonVersion.split(".");
+	if (parts.length > 2) return `python:${parts[0]}.${parts[1]}-slim`;
+	return `python:${pythonVersion}-slim`;
+}
+//#endregion
+export { prepareDockerOptions };
+
+//# sourceMappingURL=docker-python.js.map

package/dist/core/docker-python.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-python.js","names":["paths.assets","fs","path","util.CLIError","defaults.PYTHON_DOCKER_BASE_IMAGE","defaults.PYTHON_REQUIREMENTS_FILE","defaults.DOCKER_PLACEHOLDER_PKG"],"sources":["../../src/core/docker-python.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type winston from \"winston\";\n\nimport * as defaults from \"../defaults\";\nimport * as paths from \"./paths\";\nimport * as util from \"./util\";\n\nimport type * as artifacts from \"./schemas/artifacts\";\nimport { resolveRunEnvironment } from \"./resolver\";\nimport { dockerfileAutogenPath } from \"./docker\";\n\nconst PYTHON_VERSION_PATTERNS = {\n  PY3_PREFIX: /^3\\./,\n  VERSION_FORMAT:\n    /^3\\.\\d+(?:\\.\\d+)?(?:[-+_][a-zA-Z0-9]+|(?:a|b|rc)\\d+|[a-zA-Z]+\\d+(?:\\.[a-zA-Z0-9]+)*)*$/,\n  DOCKER_SEPARATOR: /@.*$/,\n  DOCKER_UNSAFE_CHARS: /[^A-Za-z0-9_.-]+/g,\n  MULTIPLE_SEPARATORS: /[-.]{2,}/g,\n  EDGE_SEPARATORS: /^[-.]+|[-.]+$/g,\n  DOCKER_TAG_FORMAT: /^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$/,\n};\n\nexport interface PythonOptions {\n  baseImageTag: string;\n  toolset: string;\n  requirements: string;\n  pkg: string;\n  envVars: string[]; // custom environment variables set for run environment\n}\n\nexport interface DockerOptions {\n  context: string;\n  dockerfile: string;\n  entrypoint: string[];\n  pkg: string;\n}\n\nexport interface PythonDockerOptions extends PythonOptions, DockerOptions {}\n\nfunction generatePythonDockerfileContent(options: PythonOptions): string {\n  // Read template from assets\n  const templatePath = paths.assets(\"python-dockerfile.template\");\n  const templateContent = fs.readFileSync(templatePath, \"utf-8\");\n\n  const envVars = options.envVars.map((envVar) => `ENV ${envVar}`).join(\"\\n\");\n\n  // Generate Dockerfile with dependencies\n  return templateContent\n    .replace(/\\$\\{RUNENV_ENVS\\}/g, envVars)\n    .replace(/\\$\\{BASE_IMAGE_TAG\\}/g, options.baseImageTag)\n    .replace(/\\$\\{REQUIREMENTS_PATH\\}/g, options.requirements)\n    .replace(/\\$\\{REQUIREMENTS_FILENAME\\}/g, path.basename(options.requirements))\n    .replace(/\\$\\{TOOLSET\\}/g, options.toolset)\n    .replace(/\\$\\{PKG\\}/g, options.pkg);\n}\n\nexport function prepareDockerOptions(\n  logger: winston.Logger,\n  currentPackageRoot: string,\n  currentPackageName: string,\n  artifactID: string,\n  buildParams: artifacts.pythonType,\n): DockerOptions {\n  logger.debug(\n    `Preparing Docker options for Python package: ${buildParams.name} (id: ${artifactID})`,\n  );\n\n  const options = getDefaultPythonOptions();\n\n  const pythonInfo = getRunEnvironmentPythonInfo(\n    logger,\n    currentPackageRoot,\n    currentPackageName,\n    buildParams.environment,\n  );\n  if (pythonInfo.pythonVersion) {\n    logger.debug(`Extracted Python version from environment: ${pythonInfo.pythonVersion}`);\n    options.baseImageTag = pythonVersionToDockerTag(pythonInfo.pythonVersion);\n  } else {\n    logger.debug(`No Python version found in environment, using default: ${options.baseImageTag}`);\n  }\n  options.envVars = pythonInfo.envVars;\n\n  if (buildParams.dependencies) {\n    options.toolset = buildParams.dependencies.toolset;\n    options.requirements = buildParams.dependencies.requirements;\n  }\n\n  if (buildParams.pkg) {\n    options.pkg = buildParams.pkg;\n  }\n\n  if (!buildParams.root) {\n    throw util.CLIError(\n      'Cannot prepare Docker options: package root directory is not specified. Please ensure the \"root\" property is set in the build parameters.',\n    );\n  }\n  const contextDir = path.resolve(buildParams.root ?? currentPackageRoot);\n\n  options.requirements = path.join(contextDir, options.requirements);\n  const hasRequirements = fs.existsSync(options.requirements);\n\n  if (!hasRequirements) {\n    // If requirements.txt doesn't exist, create an empty one\n    fs.writeFileSync(options.requirements, \"# No dependencies specified\\n\");\n    logger.warn(`Created empty requirements.txt at: ${options.requirements}`);\n  }\n  // If requirements.txt exists, use relative path for Docker COPY command\n  options.requirements = path.relative(contextDir, options.requirements);\n\n  // Generate a temporary directory for the Dockerfile\n  const dockerfilePath = dockerfileAutogenPath(currentPackageRoot, artifactID);\n\n  const dockerfileDir = path.dirname(dockerfilePath);\n  fs.mkdirSync(dockerfileDir, { recursive: true });\n  logger.debug(`Created temporary Docker directory: ${dockerfileDir}`);\n\n  const dockerfile = {\n    content: generatePythonDockerfileContent(options),\n    path: dockerfilePath,\n  };\n\n  fs.writeFileSync(dockerfile.path, dockerfile.content);\n  logger.debug(`Written Dockerfile to: ${dockerfile.path}`);\n\n  const result: DockerOptions = {\n    dockerfile: dockerfile.path,\n    context: contextDir,\n    entrypoint: [],\n    pkg: options.pkg,\n  };\n\n  logger.debug(`Prepared Docker options: ${JSON.stringify(result)}`);\n  verifyDockerOptions(result);\n  return result;\n}\n\nfunction normalizeDockerTag(candidate: string): string | undefined {\n  if (!candidate || typeof candidate !== \"string\") {\n    return undefined;\n  }\n\n  // First remove Docker-specific parts like @sha256:...\n  let normalized = candidate.replace(PYTHON_VERSION_PATTERNS.DOCKER_SEPARATOR, \"\");\n\n  // For cases like \"3.12.6:latest\", extract only the version part\n  if (normalized.includes(\":\")) {\n    normalized = normalized.split(\":\")[0];\n  }\n\n  // Clean up any remaining unsafe characters\n  normalized = normalized\n    .replace(PYTHON_VERSION_PATTERNS.DOCKER_UNSAFE_CHARS, \"-\")\n    .replace(PYTHON_VERSION_PATTERNS.MULTIPLE_SEPARATORS, \"-\")\n    .replace(PYTHON_VERSION_PATTERNS.EDGE_SEPARATORS, \"\");\n\n  return normalized || undefined;\n}\n\nfunction isValidPythonVersion(version: string): boolean {\n  return (\n    PYTHON_VERSION_PATTERNS.PY3_PREFIX.test(version) &&\n    PYTHON_VERSION_PATTERNS.VERSION_FORMAT.test(version)\n  );\n}\n\nfunction isValidDockerTag(tag: string): boolean {\n  return PYTHON_VERSION_PATTERNS.DOCKER_TAG_FORMAT.test(tag);\n}\n\nexport function getRunEnvironmentPythonInfo(\n  logger: winston.Logger,\n  currentPackageRoot: string,\n  currentPackageName: string,\n  runEnvironmentID: artifacts.artifactIDString,\n  { normalizeForDocker = true }: { normalizeForDocker?: boolean } = {},\n): {\n  pythonVersion: string | undefined;\n  envVars: string[];\n} {\n  if (!runEnvironmentID) {\n    return {\n      pythonVersion: undefined,\n      envVars: [],\n    };\n  }\n\n  const environmentDescriptor = resolveRunEnvironment(\n    logger,\n    currentPackageRoot,\n    currentPackageName,\n    runEnvironmentID,\n    \"python\",\n  );\n\n  let pythonVersion: string | undefined = environmentDescriptor[\"python-version\"];\n  const envVars = environmentDescriptor.envVars ?? [];\n  if (!pythonVersion) {\n    pythonVersion = undefined;\n    const trimmedInput = runEnvironmentID.trim();\n    if (!trimmedInput) {\n      return {\n        pythonVersion: undefined,\n        envVars,\n      };\n    }\n\n    const colonIndex = trimmedInput.indexOf(\":\");\n    if (colonIndex === -1 || colonIndex === trimmedInput.length - 1) {\n      return {\n        pythonVersion: undefined,\n        envVars,\n      };\n    }\n\n    pythonVersion = trimmedInput.slice(colonIndex + 1);\n    if (pythonVersion.startsWith(\"python\")) {\n      return {\n        pythonVersion: undefined,\n        envVars,\n      };\n    }\n  }\n\n  if (!normalizeForDocker) {\n    return {\n      pythonVersion,\n      envVars,\n    };\n  }\n\n  const normalizedTag = normalizeDockerTag(pythonVersion);\n  if (!normalizedTag) {\n    return {\n      pythonVersion: undefined,\n      envVars,\n    };\n  }\n\n  if (!isValidPythonVersion(normalizedTag) || !isValidDockerTag(normalizedTag)) {\n    return {\n      pythonVersion: undefined,\n      envVars,\n    };\n  }\n\n  return {\n    pythonVersion: normalizedTag,\n    envVars,\n  };\n}\n\nfunction getDefaultPythonOptions(): PythonOptions {\n  return {\n    baseImageTag: defaults.PYTHON_DOCKER_BASE_IMAGE,\n    toolset: defaults.PYTHON_TOOLSET,\n    requirements: defaults.PYTHON_REQUIREMENTS_FILE,\n    pkg: defaults.DOCKER_PLACEHOLDER_PKG,\n    envVars: [],\n  };\n}\n\nfunction verifyDockerOptions(options: DockerOptions) {\n  if (!fs.existsSync(options.dockerfile)) {\n    throw util.CLIError(`Dockerfile '${options.dockerfile}' not found`);\n  }\n\n  if (!fs.existsSync(options.context)) {\n    throw util.CLIError(`Context '${options.context}' not found`);\n  }\n}\n\nfunction pythonVersionToDockerTag(pythonVersion: string): string {\n  const parts = pythonVersion.split(\".\");\n  if (parts.length > 2) {\n    const major = parts[0];\n    const minor = parts[1];\n    return `python:${major}.${minor}-slim`;\n  }\n\n  return `python:${pythonVersion}-slim`;\n}\n"],"mappings":"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"}

package/dist/core/docker.cjs

@@ -0,0 +1,223 @@
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_defaults = require("../defaults.cjs");
+const require_util = require("./util.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path);
+let node_os = require("node:os");
+node_os = require_runtime.__toESM(node_os);
+let node_child_process = require("node:child_process");
+//#region src/core/docker.ts
+/**
+* To allow entrypoint keep both docker and binary package at the same time, we create virtual entrypoint with ':docker' suffix,
+* as entrypoints could not keep two different artifacts at the same time.
+*/
+function entrypointName(name) {
+	return name + ":docker";
+}
+function isVirtualDockerEntrypointName(name) {
+	return name.endsWith(":docker");
+}
+function entrypointNameToOrigin(name) {
+	if (!isVirtualDockerEntrypointName(name)) return name;
+	return name.substring(0, name.length - 7);
+}
+function getImageHash(tag) {
+	const result = (0, node_child_process.spawnSync)("docker", [
+		"image",
+		"ls",
+		"--filter=reference=" + tag,
+		"--format={{.ID}}"
+	], {
+		stdio: "pipe",
+		env: {
+			...process.env,
+			HOME: process.env.HOME || node_os.homedir()
+		}
+	});
+	if (result.error) throw result.error;
+	if (result.status !== 0) throw require_util.CLIError(`local docker image check failed with status ${result.status}`);
+	const output = result.stdout.toString().trim();
+	if (output.split("\n").length > 1) throw require_util.CLIError(`package-builder internal logic error: more than one image found by exact tag match: ${output}`);
+	return output;
+}
+function getImageEntrypoint(tag) {
+	const result = (0, node_child_process.spawnSync)("docker", [
+		"image",
+		"inspect",
+		tag,
+		"--format",
+		"{{ .Config.Entrypoint | json }}"
+	], {
+		stdio: "pipe",
+		env: {
+			...process.env,
+			HOME: process.env.HOME || node_os.homedir()
+		}
+	});
+	if (result.error) throw result.error;
+	if (result.status !== 0) throw require_util.CLIError(`'docker image inspect' failed with status ${result.status}`);
+	const output = result.stdout.toString().trim();
+	return JSON.parse(output) ?? [];
+}
+function localImageExists(tag) {
+	return getImageHash(tag) !== "";
+}
+function remoteImageExists(tag) {
+	const result = (0, node_child_process.spawnSync)("docker", [
+		"manifest",
+		"inspect",
+		tag
+	], {
+		stdio: "pipe",
+		env: {
+			...process.env,
+			HOME: process.env.HOME || node_os.homedir()
+		}
+	});
+	if (result.error || result.status !== 0) return false;
+	return true;
+}
+function build(context, dockerfile, tag, softwarePackage, softwareVersion) {
+	const result = (0, node_child_process.spawnSync)("docker", [
+		"build",
+		"--platform",
+		require_defaults.DOCKER_BUILD_PLATFORM,
+		"--provenance=false",
+		"--sbom=false",
+		"-t",
+		tag,
+		context,
+		"-f",
+		dockerfile,
+		"--label",
+		"com.milaboratories.package-builder.software=true",
+		"--label",
+		"com.milaboratories.package-builder.software.package=" + softwarePackage,
+		"--label",
+		"com.milaboratories.package-builder.software.version=" + softwareVersion
+	], {
+		stdio: "inherit",
+		env: {
+			...process.env,
+			HOME: process.env.HOME || node_os.homedir()
+		}
+	});
+	if (result.error) throw result.error;
+	if (result.status !== 0) throw require_util.CLIError(`'docker build' failed with status ${result.status}`);
+}
+function push(tag) {
+	const result = (0, node_child_process.spawnSync)("docker", ["push", tag], {
+		stdio: "inherit",
+		env: {
+			...process.env,
+			HOME: process.env.HOME || node_os.homedir()
+		}
+	});
+	if (result.error) throw result.error;
+	if (result.status !== 0) {
+		const registry = tag.split("/")[0];
+		throw require_util.CLIError(`'docker push ${tag}' failed with status ${result.status}.\nIf the error above mentions authentication or denied access, log in first:\n  aws sso login --profile research-poweruser <YOUR_PROFILE:research-poweruser?> \nThen login in docker:  aws ecr-public get-login-password --region us-east-1 | docker login --username AWS --password-stdin ${registry}\n(for a private ECR use 'aws ecr' and your region instead of 'ecr-public'/us-east-1).`);
+	}
+}
+function addTag(imageIdOrTag, newTag) {
+	const result = (0, node_child_process.spawnSync)("docker", [
+		"image",
+		"tag",
+		imageIdOrTag,
+		newTag
+	], {
+		stdio: "inherit",
+		env: {
+			...process.env,
+			HOME: process.env.HOME || node_os.homedir()
+		}
+	});
+	if (result.error) throw result.error;
+	if (result.status !== 0) throw require_util.CLIError(`'docker tag' failed with status ${result.status}`);
+}
+/**
+* Generate unique content-addressable image tag
+* @param artifactName: artifact name generated from package name and artifact ID (or explicitly set for artifact in .name field)
+* @param imageID: unique image content hash (docker image ID in docker ls)
+* @param registry: custom registry and repository to use for this image
+* @returns full image tag in format: <registry>/repository:<artifactName>.<imageID>
+*/
+function generateRemoteTagName(artifactName, imageID, registry) {
+	return dockerTag(artifactName, imageID, registry);
+}
+/**
+* Generate unique content-addressable image tag out of directories and Dockerfile.
+* @param packageRoot: package root path from where to resolve artifact's paths (context, Dockerfile, ...)
+* @param artifact: docker artifact configuration
+* @returns full image tag in format: <registry>/repository:<artifactName>.<contentHash>
+*/
+function generateLocalTagName(packageRoot, artifact) {
+	const dockerfile = dockerfileAbsPath(packageRoot, artifact);
+	return dockerTag("local-image", contentHash(contextAbsPath(packageRoot, artifact), dockerfile));
+}
+/**
+* Absolute path to autogenerated Dockerfile for given artifact.
+* @param packageRoot: package root path from where to resolve artifact's paths (context, Dockerfile, ...)
+* @param artifactID: artifact ID
+* @returns absolute path to autogenerated Dockerfile
+*/
+function dockerfileAutogenPath(packageRoot, artifactID) {
+	return node_path.resolve(packageRoot, "dist", "docker", `Dockerfile-${artifactID}`);
+}
+/**
+* Resolve path to Dockerfile.
+* @param packageRoot: package root path from where to resolve artifact's paths (context, Dockerfile, ...)
+* @param artifact: docker artifact configuration
+* @returns absolute path to Dockerfile
+*/
+function dockerfileAbsPath(packageRoot, artifact) {
+	return node_path.resolve(packageRoot, artifact.dockerfile ?? "Dockerfile");
+}
+/**
+* Resolve path to docker build context directory.
+* @param packageRoot: package root path from where to resolve artifact's paths (context, Dockerfile, ...)
+* @param artifact: docker artifact configuration
+* @returns absolute path to docker build context directory
+*/
+function contextAbsPath(packageRoot, artifact) {
+	if (artifact.context === "./" || artifact.context === ".") throw require_util.CLIError(`Invalid Docker context: "${artifact.context}". Context cannot be "./" or "." - use absolute path or relative path without "./" prefix`);
+	return node_path.resolve(packageRoot, artifact.context ?? ".");
+}
+/**
+* Calculate cummulative hash of docker build context directory context and Dockerfile.
+* To speedup hash calculation, we do not read contents of each item in context dir but
+* use metadata (size, mtime, ...).
+*
+* @param contextFullPath: abs path to docker build context
+* @param dockerfileFullPath: abs path to Dockerfile
+* @returns hash of what the keep
+*/
+function contentHash(contextFullPath, dockerfileFullPath) {
+	if (!node_fs.existsSync(dockerfileFullPath)) throw require_util.CLIError(`Dockerfile '${dockerfileFullPath}' not found`);
+	if (!node_fs.existsSync(contextFullPath)) throw require_util.CLIError(`Context '${contextFullPath}' not found`);
+	const contextHash = require_util.hashDirMetaSync(contextFullPath);
+	const dockerfileContent = node_fs.readFileSync(dockerfileFullPath, "utf8");
+	contextHash.update(dockerfileContent);
+	return contextHash.digest("hex").slice(0, 12);
+}
+function dockerTag(packageName, contentHash, registry) {
+	return `${registry ?? "containers.pl-open.science/milaboratories/pl-containers"}:${packageName.replaceAll("/", ".")}.${contentHash}`;
+}
+//#endregion
+exports.addTag = addTag;
+exports.build = build;
+exports.dockerfileAutogenPath = dockerfileAutogenPath;
+exports.entrypointName = entrypointName;
+exports.entrypointNameToOrigin = entrypointNameToOrigin;
+exports.generateLocalTagName = generateLocalTagName;
+exports.generateRemoteTagName = generateRemoteTagName;
+exports.getImageEntrypoint = getImageEntrypoint;
+exports.getImageHash = getImageHash;
+exports.isVirtualDockerEntrypointName = isVirtualDockerEntrypointName;
+exports.localImageExists = localImageExists;
+exports.push = push;
+exports.remoteImageExists = remoteImageExists;
+
+//# sourceMappingURL=docker.cjs.map