aws-lambda-builders 1.67.0__tar.gz → 1.69.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (118) hide show
  1. {aws_lambda_builders-1.67.0/aws_lambda_builders.egg-info → aws_lambda_builders-1.69.0}/PKG-INFO +2 -1
  2. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/__init__.py +1 -1
  3. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/actions.py +50 -1
  4. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/builder.py +25 -0
  5. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/exceptions.py +21 -0
  6. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/supported_runtimes.py +2 -0
  7. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/utils.py +80 -5
  8. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflow.py +15 -0
  9. aws_lambda_builders-1.69.0/aws_lambda_builders/workflows/nodejs_npm/actions.py +602 -0
  10. aws_lambda_builders-1.69.0/aws_lambda_builders/workflows/nodejs_npm/lockfile_closure.py +199 -0
  11. aws_lambda_builders-1.69.0/aws_lambda_builders/workflows/nodejs_npm/npm.py +135 -0
  12. aws_lambda_builders-1.69.0/aws_lambda_builders/workflows/nodejs_npm/utils.py +74 -0
  13. aws_lambda_builders-1.69.0/aws_lambda_builders/workflows/nodejs_npm/workflow.py +517 -0
  14. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/nodejs_npm_esbuild/workflow.py +8 -2
  15. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/python_pip/DESIGN.md +1 -1
  16. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/python_pip/packager.py +3 -1
  17. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/python_pip/workflow.py +10 -2
  18. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0/aws_lambda_builders.egg-info}/PKG-INFO +2 -1
  19. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders.egg-info/SOURCES.txt +1 -0
  20. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/pyproject.toml +1 -1
  21. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/setup.py +1 -0
  22. aws_lambda_builders-1.67.0/aws_lambda_builders/workflows/nodejs_npm/actions.py +0 -352
  23. aws_lambda_builders-1.67.0/aws_lambda_builders/workflows/nodejs_npm/npm.py +0 -74
  24. aws_lambda_builders-1.67.0/aws_lambda_builders/workflows/nodejs_npm/utils.py +0 -52
  25. aws_lambda_builders-1.67.0/aws_lambda_builders/workflows/nodejs_npm/workflow.py +0 -304
  26. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/LICENSE +0 -0
  27. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/MANIFEST.in +0 -0
  28. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/NOTICE +0 -0
  29. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/README.md +0 -0
  30. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/__main__.py +0 -0
  31. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/architecture.py +0 -0
  32. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/binary_path.py +0 -0
  33. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/path_resolver.py +0 -0
  34. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/registry.py +0 -0
  35. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/validator.py +0 -0
  36. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/__init__.py +0 -0
  37. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/custom_make/DESIGN.md +0 -0
  38. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/custom_make/__init__.py +0 -0
  39. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/custom_make/actions.py +0 -0
  40. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/custom_make/exceptions.py +0 -0
  41. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/custom_make/make.py +0 -0
  42. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/custom_make/utils.py +0 -0
  43. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/custom_make/validator.py +0 -0
  44. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/custom_make/workflow.py +0 -0
  45. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/dotnet_clipackage/DESIGN.md +0 -0
  46. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/dotnet_clipackage/__init__.py +0 -0
  47. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/dotnet_clipackage/actions.py +0 -0
  48. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/dotnet_clipackage/dotnetcli.py +0 -0
  49. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/dotnet_clipackage/dotnetcli_resolver.py +0 -0
  50. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/dotnet_clipackage/utils.py +0 -0
  51. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/dotnet_clipackage/workflow.py +0 -0
  52. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/go_modules/DESIGN.md +0 -0
  53. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/go_modules/__init__.py +0 -0
  54. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/go_modules/actions.py +0 -0
  55. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/go_modules/builder.py +0 -0
  56. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/go_modules/utils.py +0 -0
  57. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/go_modules/validator.py +0 -0
  58. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/go_modules/workflow.py +0 -0
  59. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java/__init__.py +0 -0
  60. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java/actions.py +0 -0
  61. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java/utils.py +0 -0
  62. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java_gradle/DESIGN.md +0 -0
  63. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java_gradle/__init__.py +0 -0
  64. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java_gradle/actions.py +0 -0
  65. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java_gradle/gradle.py +0 -0
  66. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java_gradle/gradle_resolver.py +0 -0
  67. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java_gradle/gradle_validator.py +0 -0
  68. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java_gradle/resources/lambda-build-init.gradle +0 -0
  69. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java_gradle/workflow.py +0 -0
  70. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java_maven/DESIGN.md +0 -0
  71. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java_maven/__init__.py +0 -0
  72. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java_maven/actions.py +0 -0
  73. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java_maven/maven.py +0 -0
  74. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java_maven/maven_resolver.py +0 -0
  75. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java_maven/maven_validator.py +0 -0
  76. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/java_maven/workflow.py +0 -0
  77. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/nodejs_npm/DESIGN.md +0 -0
  78. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/nodejs_npm/__init__.py +0 -0
  79. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/nodejs_npm/exceptions.py +0 -0
  80. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/nodejs_npm_esbuild/DESIGN.md +0 -0
  81. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/nodejs_npm_esbuild/__init__.py +0 -0
  82. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/nodejs_npm_esbuild/actions.py +0 -0
  83. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/nodejs_npm_esbuild/esbuild.py +0 -0
  84. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/nodejs_npm_esbuild/exceptions.py +0 -0
  85. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/python_pip/__init__.py +0 -0
  86. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/python_pip/actions.py +0 -0
  87. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/python_pip/compat.py +0 -0
  88. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/python_pip/exceptions.py +0 -0
  89. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/python_pip/utils.py +0 -0
  90. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/python_pip/validator.py +0 -0
  91. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/python_uv/DESIGN.md +0 -0
  92. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/python_uv/__init__.py +0 -0
  93. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/python_uv/actions.py +0 -0
  94. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/python_uv/exceptions.py +0 -0
  95. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/python_uv/packager.py +0 -0
  96. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/python_uv/utils.py +0 -0
  97. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/python_uv/workflow.py +0 -0
  98. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/ruby_bundler/DESIGN.md +0 -0
  99. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/ruby_bundler/__init__.py +0 -0
  100. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/ruby_bundler/actions.py +0 -0
  101. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/ruby_bundler/bundler.py +0 -0
  102. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/ruby_bundler/utils.py +0 -0
  103. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/ruby_bundler/workflow.py +0 -0
  104. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/rust_cargo/DESIGN.md +0 -0
  105. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/rust_cargo/__init__.py +0 -0
  106. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/rust_cargo/actions.py +0 -0
  107. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/rust_cargo/cargo_lambda.py +0 -0
  108. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/rust_cargo/exceptions.py +0 -0
  109. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/rust_cargo/utils.py +0 -0
  110. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders/workflows/rust_cargo/workflow.py +0 -0
  111. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders.egg-info/dependency_links.txt +0 -0
  112. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders.egg-info/entry_points.txt +0 -0
  113. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders.egg-info/requires.txt +0 -0
  114. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/aws_lambda_builders.egg-info/top_level.txt +0 -0
  115. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/requirements/base.txt +0 -0
  116. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/requirements/dev.txt +0 -0
  117. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/requirements/python_pip.txt +0 -0
  118. {aws_lambda_builders-1.67.0 → aws_lambda_builders-1.69.0}/setup.cfg +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: aws_lambda_builders
3
- Version: 1.67.0
3
+ Version: 1.69.0
4
4
  Summary: Python library to compile, build & package AWS Lambda functions for several runtimes & frameworks.
5
5
  Home-page: https://github.com/awslabs/aws-lambda-builders
6
6
  Author: Amazon Web Services
@@ -20,6 +20,7 @@ Classifier: Programming Language :: Python :: 3.11
20
20
  Classifier: Programming Language :: Python :: 3.12
21
21
  Classifier: Programming Language :: Python :: 3.13
22
22
  Classifier: Programming Language :: Python :: 3.14
23
+ Classifier: Programming Language :: Python :: 3.15
23
24
  Classifier: Topic :: Internet
24
25
  Classifier: Topic :: Software Development :: Build Tools
25
26
  Classifier: Topic :: Utilities
@@ -5,5 +5,5 @@ AWS Lambda Builder Library
5
5
  # Changing version will trigger a new release!
6
6
  # Please make the version change as the last step of your development.
7
7
 
8
- __version__ = "1.67.0"
8
+ __version__ = "1.69.0"
9
9
  RPC_PROTOCOL_VERSION = "0.3"
@@ -132,17 +132,66 @@ class LinkSourceAction(BaseAction):
132
132
  self._dest_dir = dest_dir
133
133
 
134
134
  def execute(self):
135
+ # Match CopySourceAction: a missing source is skipped, not fatal.
136
+ if not os.path.isdir(self._source_dir):
137
+ LOG.warning("Skipping link operation since source %s does not exist", self._source_dir)
138
+ return
139
+
135
140
  source_files = set(os.listdir(self._source_dir))
136
141
 
137
142
  for source_file in source_files:
138
143
  source_path = Path(self._source_dir, source_file)
139
144
  destination_path = Path(self._dest_dir, source_file)
140
- if destination_path.exists():
145
+ # is_symlink() first: a dangling link is not exists().
146
+ if destination_path.is_symlink() or destination_path.is_file():
141
147
  os.remove(destination_path)
148
+ elif destination_path.is_dir():
149
+ # Left by an earlier copying build.
150
+ shutil.rmtree(destination_path)
142
151
  else:
143
152
  os.makedirs(destination_path.parent, exist_ok=True)
144
153
  utils.create_symlink_or_copy(str(source_path), str(destination_path))
145
154
 
155
+ self._prune_dangling_links(source_files)
156
+
157
+ def _prune_dangling_links(self, source_files):
158
+ """
159
+ Remove broken links into the source directory whose source no longer exists.
160
+
161
+ :type source_files: set
162
+ :param source_files: names currently in the source directory
163
+ """
164
+ if not os.path.isdir(self._dest_dir):
165
+ return
166
+
167
+ for name in set(os.listdir(self._dest_dir)) - source_files:
168
+ stale_path = Path(self._dest_dir, name)
169
+ if not stale_path.is_symlink() or stale_path.exists():
170
+ continue
171
+ if not self._points_into_source(stale_path):
172
+ continue
173
+ LOG.debug("Removing %s: a link to a source that no longer exists", stale_path)
174
+ os.remove(stale_path)
175
+
176
+ def _points_into_source(self, link_path):
177
+ """
178
+ Return True if the link targets a direct child of the source directory.
179
+
180
+ Uses os.readlink, not os.path.realpath, which does not follow a broken link on Windows.
181
+
182
+ :type link_path: pathlib.Path
183
+ :param link_path: the symlink to check
184
+ :rtype: bool
185
+ """
186
+ target = os.readlink(link_path)
187
+ if not os.path.isabs(target):
188
+ target = os.path.join(os.path.dirname(link_path), target)
189
+
190
+ target_parent = os.path.dirname(os.path.normpath(target))
191
+ if not os.path.isdir(target_parent):
192
+ return False
193
+ return os.path.samefile(target_parent, self._source_dir)
194
+
146
195
 
147
196
  class LinkSinglePathAction(BaseAction):
148
197
  NAME = "LinkSource"
@@ -171,5 +171,30 @@ class LambdaBuilder(object):
171
171
 
172
172
  return workflow.run()
173
173
 
174
+ def prepare_shared_project(self, project_root, experimental_flags=None):
175
+ """
176
+ Do once, at the given project root, the work every function under it shares - for the nodejs
177
+ workflows, installing the dependency tree npm hoists there. Run it once, then call build()
178
+ per function with download_dependencies=False.
179
+
180
+ :type project_root: str
181
+ :param project_root:
182
+ Path to the project root shared by the functions about to be built
183
+
184
+ :type experimental_flags: list
185
+ :param experimental_flags:
186
+ The same flags the per-function build() calls get; a workflow may gate this on one
187
+
188
+ :raises aws_lambda_builders.exceptions.SharedProjectNotSupportedError:
189
+ when the selected workflow has no shared-project concept
190
+ :raises aws_lambda_builders.exceptions.SharedProjectPreparationError:
191
+ when the preparation fails; both are LambdaBuilderError, so a caller can catch that and
192
+ fall back to building each function on its own
193
+ """
194
+ LOG.debug(
195
+ "Preparing shared project root '%s' with workflow '%s'", project_root, self.selected_workflow_cls.NAME
196
+ )
197
+ self.selected_workflow_cls.prepare_shared_project(project_root, experimental_flags=experimental_flags)
198
+
174
199
  def _clear_workflows(self):
175
200
  DEFAULT_REGISTRY.clear()
@@ -72,3 +72,24 @@ class WorkflowUnknownError(LambdaBuilderError):
72
72
  """
73
73
 
74
74
  MESSAGE = "{workflow_name}:{action_name} - {reason}"
75
+
76
+
77
+ class SharedProjectNotSupportedError(LambdaBuilderError):
78
+ """
79
+ Raised when the selected workflow has no notion of work shared by every
80
+ package under one project root
81
+ """
82
+
83
+ MESSAGE = (
84
+ "Workflow for capability '{capabilities}' does not support preparing a project root "
85
+ "shared by several functions"
86
+ )
87
+
88
+
89
+ class SharedProjectPreparationError(LambdaBuilderError):
90
+ """
91
+ Raised when preparing the shared project root itself failed; the caller can
92
+ fall back to building each function on its own
93
+ """
94
+
95
+ MESSAGE = "Preparing the shared project root {project_root} failed: {reason}"
@@ -14,6 +14,7 @@ NODEJS_RUNTIMES = [
14
14
  "nodejs20.x",
15
15
  "nodejs22.x",
16
16
  "nodejs24.x",
17
+ "nodejs26.x",
17
18
  ]
18
19
 
19
20
  # Python runtimes
@@ -25,6 +26,7 @@ PYTHON_RUNTIMES = [
25
26
  "python3.12",
26
27
  "python3.13",
27
28
  "python3.14",
29
+ "python3.15",
28
30
  ]
29
31
 
30
32
  # Ruby runtimes
@@ -2,6 +2,7 @@
2
2
  Common utilities for the library
3
3
  """
4
4
 
5
+ import codecs
5
6
  import locale
6
7
  import logging
7
8
  import os
@@ -15,6 +16,28 @@ from aws_lambda_builders.architecture import ARM64
15
16
  LOG = logging.getLogger(__name__)
16
17
 
17
18
 
19
+ def _materialize_symlinked_destination(destination: str) -> None:
20
+ """
21
+ Replace a symlinked destination with a real copy of its target, so copying into it
22
+ does not write into the shared dependencies directory.
23
+
24
+ :type destination: str
25
+ :param destination: path that may be a symlink
26
+ """
27
+ if not os.path.islink(destination):
28
+ return
29
+
30
+ LOG.debug("Replacing symlinked destination %s with a real copy before copying into it", destination)
31
+ link_target = os.path.realpath(destination)
32
+ os.unlink(destination)
33
+
34
+ if os.path.isdir(link_target):
35
+ copytree(link_target, destination)
36
+ elif os.path.isfile(link_target):
37
+ os.makedirs(os.path.dirname(destination), exist_ok=True)
38
+ shutil.copy2(link_target, destination)
39
+
40
+
18
41
  def copytree(
19
42
  source: str,
20
43
  destination: str,
@@ -48,6 +71,8 @@ def copytree(
48
71
  LOG.warning("Skipping copy operation since source %s does not exist", source)
49
72
  return
50
73
 
74
+ _materialize_symlinked_destination(destination)
75
+
51
76
  if not os.path.exists(destination):
52
77
  LOG.debug("Creating target folders at %s", destination)
53
78
  os.makedirs(destination)
@@ -86,6 +111,9 @@ def copytree(
86
111
  elif os.path.isdir(new_source):
87
112
  copytree(new_source, new_destination, ignore=ignore, include=include, maintain_symlinks=maintain_symlinks)
88
113
  else:
114
+ # copy2 would write through a symlinked destination.
115
+ if os.path.islink(new_destination):
116
+ os.unlink(new_destination)
89
117
  LOG.debug("Copying source file (%s) to destination (%s)", new_source, new_destination)
90
118
  shutil.copy2(new_source, new_destination)
91
119
 
@@ -210,7 +238,19 @@ def create_symlink_or_copy(source: str, destination: str) -> None:
210
238
  "consider enabling the necessary settings or privileges on your system to support symbolic links.",
211
239
  exc_info=ex if LOG.isEnabledFor(logging.DEBUG) else None,
212
240
  )
213
- copytree(source, destination)
241
+ # A broken link at the destination is one reason os.symlink fails. Remove it so the copy
242
+ # below doesn't write through it.
243
+ if os.path.islink(destination):
244
+ LOG.debug("Removing existing symlink at destination %s before copying", destination)
245
+ os.unlink(destination)
246
+ # copytree only handles directories; a dependency can also be a single file (six.py).
247
+ if os.path.isdir(source):
248
+ copytree(source, destination)
249
+ elif os.path.isfile(source):
250
+ os.makedirs(os.path.dirname(destination), exist_ok=True)
251
+ shutil.copy2(source, destination)
252
+ else:
253
+ LOG.warning("Skipping copy operation since source %s does not exist", source)
214
254
 
215
255
 
216
256
  def _is_within_directory(directory: Union[str, os.PathLike], target: Union[str, os.PathLike]) -> bool:
@@ -218,9 +258,13 @@ def _is_within_directory(directory: Union[str, os.PathLike], target: Union[str,
218
258
  abs_directory = os.path.abspath(directory)
219
259
  abs_target = os.path.abspath(target)
220
260
 
221
- prefix = os.path.commonprefix([abs_directory, abs_target])
222
-
223
- return prefix == abs_directory
261
+ try:
262
+ # commonpath compares whole path components; commonprefix compares characters,
263
+ # which would wrongly treat "/tmp/ab/x" as being inside "/tmp/a".
264
+ return os.path.commonpath([abs_directory, abs_target]) == abs_directory
265
+ except ValueError:
266
+ # Raised for paths on different drives (Windows): they cannot be nested
267
+ return False
224
268
 
225
269
 
226
270
  def extract_tarfile(tarfile_path: Union[str, os.PathLike], unpack_dir: Union[str, os.PathLike]) -> None:
@@ -238,6 +282,37 @@ def extract_tarfile(tarfile_path: Union[str, os.PathLike], unpack_dir: Union[str
238
282
  tar.extractall(unpack_dir)
239
283
 
240
284
 
285
+ def _locale_encoding() -> str:
286
+ """
287
+ Returns the encoding to decode the output of external tools (pip, npm, maven, ...) with.
288
+
289
+ Before Python 3.15, ``locale.getpreferredencoding()`` returned the locale encoding, or "utf-8" when
290
+ UTF-8 mode was enabled (explicitly, or automatically for the C/POSIX locale, PEP 540). Python 3.15
291
+ enables UTF-8 mode by default (PEP 686), so ``getpreferredencoding()`` now returns "utf-8" even for
292
+ non-UTF-8 locales such as a Windows ANSI code page, while external tools still write in that encoding.
293
+ This keeps the pre-3.15 behaviour:
294
+
295
+ - UTF-8 mode explicitly requested (PYTHONUTF8=1 or -X utf8): utf-8
296
+ - otherwise the locale encoding (``locale.getencoding()``, Python 3.11+), except that an ASCII locale
297
+ (C/POSIX) is decoded as utf-8, a superset of ASCII
298
+ """
299
+ getencoding = getattr(locale, "getencoding", None)
300
+ if getencoding is None:
301
+ # Python < 3.11: UTF-8 mode is never on by default, so this is the historical behaviour
302
+ return locale.getpreferredencoding()
303
+
304
+ if os.environ.get("PYTHONUTF8") == "1" or sys._xoptions.get("utf8") in (True, "1"):
305
+ return "utf-8"
306
+
307
+ encoding = getencoding()
308
+ try:
309
+ if codecs.lookup(encoding).name == "ascii":
310
+ return "utf-8"
311
+ except LookupError:
312
+ return "utf-8"
313
+ return encoding
314
+
315
+
241
316
  def decode(to_decode: bytes, encoding: Optional[str] = None) -> str:
242
317
  """
243
318
  Perform a "safe" decoding of a series of bytes. Attempts to find the localized encoding
@@ -258,5 +333,5 @@ def decode(to_decode: bytes, encoding: Optional[str] = None) -> str:
258
333
  str
259
334
  Decoded string with unrecognized characters replaced with a replacement character
260
335
  """
261
- encoding = encoding or locale.getpreferredencoding()
336
+ encoding = encoding or _locale_encoding()
262
337
  return to_decode.decode(encoding, errors="replace").strip()
@@ -15,6 +15,7 @@ from aws_lambda_builders.binary_path import BinaryPath
15
15
  from aws_lambda_builders.exceptions import (
16
16
  MisMatchRuntimeError,
17
17
  RuntimeValidatorError,
18
+ SharedProjectNotSupportedError,
18
19
  WorkflowFailedError,
19
20
  WorkflowUnknownError,
20
21
  )
@@ -183,6 +184,20 @@ class BaseWorkflow(object, metaclass=_WorkflowMetaClass):
183
184
  # The directory where the workflow builds/installs by default, each workflow should define this.
184
185
  DEFAULT_BUILD_DIR = None
185
186
 
187
+ @classmethod
188
+ def prepare_shared_project(cls, project_root, experimental_flags=None):
189
+ """
190
+ Do once, at the given project root, the work every function under it shares.
191
+
192
+ Part of the workflow contract so that LambdaBuilder can delegate to it unconditionally; a
193
+ workflow with no shared-project concept inherits this refusal. Override it where several
194
+ functions built from one project root can share a step - for the nodejs workflows, the
195
+ dependency tree npm hoists to a workspace root.
196
+
197
+ :raises aws_lambda_builders.exceptions.SharedProjectNotSupportedError: always, by default
198
+ """
199
+ raise SharedProjectNotSupportedError(capabilities=cls.CAPABILITY)
200
+
186
201
  def __init__(
187
202
  self,
188
203
  source_dir,