@architect/hydrate

@architect/hydrate

@architect/hydrate ensures that all functions managed by architect have their dependencies installed. Functions containing all its required dependencies are considered to be 'hydrated' - thus the name!

@architect/hydrate supports dependencies managed in the following languages using the following package managers:

• node.js via npm using package.json and package-lock.json files
• python (3.7+) via pip3 using a requirements.txt file
• ruby via bundle using Gemfile and Gemfile.lock files

Installation

npm install @architect/hydrate

API

Note: the process running hydrate must be the same as the root of the project it's hydrating. So if the project you're trying to hydrate is located locally at /projects/myapp and you're running hydrate from /scripts/hydrate, you'll need to ensure you process.chdir('/projects/myapp') prior to execution

hydrate(options)

options object can include the following properties:

• basepath: What path hydrate should consider as the root for searching for functions to hydrate. Useful if you want to hydrate a subset of functions. Defaults to src in the current working directory.
• install: If truthy, will invoke hydrate.install().
• update: If truthy, will invoke hydrate.update().

By default, invokes hydrate.shared().

hydrate.install(options, callback)

Installs dependencies for all Functions found in the specified basepath. Invokes hydrate.shared().

Note that for the default value of basepath='src', this means install will also hydrate shared folders like src/shared and src/views.

To ensure local development behavior is as close to staging and production as possible, hydrate.install() (and other hydrate functions) uses:

• node.js: npm ci if package-lock.json is present and npm i if not
• python: pip3 install
• ruby: bundle install

hydrate.update(options, callback)

Updates dependencies in all Functions found in the specified basepath. Invokes hydrate.shared(). Note that this will only functionally differ from hydrate.install() if you use a lockfile like package-lock.json or Gemfile.lock.

Note that for the default value of basepath='src', this means update will also update dependencies in shared folders like src/shared and src/views.

update is functionally almost identical to install, except it will update dependencies to newer versions if they exist. This is done via:

• node.js: npm update
• python: pip3 install -U --upgrade-strategy eager
• ruby: bundle update

hydrate.shared(options, callback)

Copies shared code (from src/shared and src/views) into all Functions.

Changelog

[1.4.2 - 1.4.3] 2019-09-17

Added

• In hydrate.install and hydrate.update shared copying is still enabled by default on all operations, but now you can opt out by passing a copyShared param

Changed

• Internal change: moved tests into specific unit + integration dirs

Fixed

• Fixed issue where shared file copy destination paths may leak across Lambda executions
• Fixed undefined message in init
• Improved printer error bubbling
• Formatting and line breaks in printer return should now more closely (or exactly) match console output
• Cleaned up printer API and implementation

---