feat: Support building Node.js functions (#845)

Author: gojko

.travis.yml

@@ -16,6 +16,11 @@ matrix:
       dist: xenial
       sudo: true
 
+before_install:
+  - nvm install 8.10
+  - npm --version
+  - node --version
+
 install:
   # Install the code requirements
   - make init

requirements/base.txt

@@ -12,4 +12,4 @@ dateparser~=0.7
 python-dateutil~=2.6
 pathlib2~=2.3.2; python_version<"3.4"
 requests~=2.20.0
-aws_lambda_builders==0.0.3
+aws_lambda_builders==0.0.4

samcli/lib/build/app_builder.py

@@ -51,6 +51,12 @@ def _get_workflow_config(runtime):
             dependency_manager="pip",
             application_framework=None,
             manifest_name="requirements.txt")
+    elif runtime.startswith("nodejs"):
+        return config(
+            language="nodejs",
+            dependency_manager="npm",
+            application_framework=None,
+            manifest_name="package.json")
     else:
         raise UnsupportedRuntimeException("'{}' runtime is not supported".format(runtime))
 

samcli/local/init/templates/cookiecutter-aws-sam-hello-nodejs/{{cookiecutter.project_name}}/README.md

@@ -5,7 +5,7 @@ This is a sample template for {{ cookiecutter.project_name }} - Below is a brief
 ```bash
 .
 ├── README.md                   <-- This instructions file
-├── hello_world                 <-- Source code for a lambda function
+├── hello-world                 <-- Source code for a lambda function
 │   ├── app.js                  <-- Lambda function code
 │   ├── package.json            <-- NodeJS dependencies
 │   └── tests                   <-- Unit tests
@@ -28,15 +28,21 @@ This is a sample template for {{ cookiecutter.project_name }} - Below is a brief
 
 ## Setup process
 
-### Installing dependencies
+### Building the project
 
-In this example we use `npm` but you can use `yarn` if you prefer to manage NodeJS dependencies:
+[AWS Lambda requires a flat folder](https://docs.aws.amazon.com/lambda/latest/dg/nodejs-create-deployment-pkg.html) with the application as well as its dependencies in a node_modules folder. When you make changes to your source code or dependency manifest,
+run the following command to build your project local testing and deployment:
+ 
+```bash
+sam build
+```
 
+If your dependencies contain native modules that need to be compiled specifically for the operating system running on AWS Lambda, use this command to build inside a Lambda-like Docker container instead:
 ```bash
-cd hello_world
-npm install
-cd ../
+sam build --use-container
 ```
+ 
+By default, this command writes built artifacts to `.aws-sam/build` folder.
 
 ### Local development
 
@@ -69,7 +75,7 @@ AWS Lambda NodeJS runtime requires a flat folder with all dependencies including
     FirstFunction:
         Type: AWS::Serverless::Function
         Properties:
-            CodeUri: hello_world/
+            CodeUri: hello-world/
             ...
 ```
 
@@ -112,7 +118,8 @@ aws cloudformation describe-stacks \
 We use `mocha` for testing our code and it is already added in `package.json` under `scripts`, so that we can simply run the following command to run our tests:
 
 ```bash
-cd hello_world
+cd hello-world
+npm install
 npm run test
 ```
 

samcli/local/init/templates/cookiecutter-aws-sam-hello-nodejs/{{cookiecutter.project_name}}/hello-world/.npmignore

@@ -0,0 +1 @@
+tests/*

samcli/local/init/templates/cookiecutter-aws-sam-hello-nodejs/{{cookiecutter.project_name}}/hello_world/app.js renamed to samcli/local/init/templates/cookiecutter-aws-sam-hello-nodejs/{{cookiecutter.project_name}}/hello-world/app.js

@@ -16,7 +16,7 @@ Resources:
     HelloWorldFunction:
         Type: AWS::Serverless::Function # More info about Function Resource: https://github.com/awslabs/serverless-application-model/blob/master/versions/2016-10-31.md#awsserverlessfunction
         Properties:
-            CodeUri: hello_world/
+            CodeUri: hello-world/
             Handler: app.lambdaHandler
             {%- if cookiecutter.runtime == 'nodejs6.10' %}
             Runtime: nodejs6.10

samcli/local/init/templates/cookiecutter-aws-sam-hello-nodejs/{{cookiecutter.project_name}}/hello_world/package.json renamed to samcli/local/init/templates/cookiecutter-aws-sam-hello-nodejs/{{cookiecutter.project_name}}/hello-world/package.json

@@ -21,7 +21,7 @@ class TestBuildCommand_PythonFunctions(BuildIntegBase):
                                        "jinja2",
                                        'requirements.txt'}
 
-    FUNCTION_LOGICAL_ID = "PythonFunction"
+    FUNCTION_LOGICAL_ID = "Function"
 
     @parameterized.expand([
         ("python2.7", False),
@@ -37,7 +37,7 @@ def test_with_default_requirements(self, runtime, use_container):
             self.skipTest("Current Python version '{}' does not match Lambda runtime version '{}'".format(py_version,
                                                                                                           runtime))
 
-        overrides = {"PythonRuntime": runtime}
+        overrides = {"Runtime": runtime, "CodeUri": "Python"}
         cmdlist = self.get_command_list(use_container=use_container,
                                         parameter_overrides=overrides)
 
@@ -113,7 +113,7 @@ def _get_python_version(self):
 class TestBuildCommand_ErrorCases(BuildIntegBase):
 
     def test_unsupported_runtime(self):
-        overrides = {"PythonRuntime": "unsupportedpython"}
+        overrides = {"Runtime": "unsupportedpython", "CodeUri": "NoThere"}
         cmdlist = self.get_command_list(parameter_overrides=overrides)
 
         LOG.info("Running Command: {}", cmdlist)
@@ -124,3 +124,71 @@ def test_unsupported_runtime(self):
         self.assertEquals(1, process.returncode)
 
         self.assertIn("Build Failed", process_stdout)
+
+
+class TestBuildCommand_NodeFunctions(BuildIntegBase):
+
+    EXPECTED_FILES_GLOBAL_MANIFEST = set()
+    EXPECTED_FILES_PROJECT_MANIFEST = {'node_modules', 'main.js'}
+    EXPECTED_NODE_MODULES = {'minimal-request-promise'}
+
+    FUNCTION_LOGICAL_ID = "Function"
+
+    @parameterized.expand([
+        ("nodejs4.3", False),
+        ("nodejs6.10", False),
+        ("nodejs8.10", False),
+        ("nodejs4.3", "use_container"),
+        ("nodejs6.10", "use_container"),
+        ("nodejs8.10", "use_container")
+    ])
+    def test_with_default_package_json(self, runtime, use_container):
+        overrides = {"Runtime": runtime, "CodeUri": "Node"}
+        cmdlist = self.get_command_list(use_container=use_container,
+                                        parameter_overrides=overrides)
+
+        LOG.info("Running Command: {}", cmdlist)
+        process = subprocess.Popen(cmdlist, cwd=self.working_dir)
+        process.wait()
+
+        self._verify_built_artifact(self.default_build_dir, self.FUNCTION_LOGICAL_ID,
+                                    self.EXPECTED_FILES_PROJECT_MANIFEST, self.EXPECTED_NODE_MODULES)
+
+        self._verify_resource_property(str(self.built_template),
+                                       "OtherRelativePathResource",
+                                       "BodyS3Location",
+                                       os.path.relpath(
+                                           os.path.normpath(os.path.join(str(self.test_data_path), "SomeRelativePath")),
+                                           str(self.default_build_dir))
+                                       )
+
+    def _verify_built_artifact(self, build_dir, function_logical_id, expected_files, expected_modules):
+
+        self.assertTrue(build_dir.exists(), "Build directory should be created")
+
+        build_dir_files = os.listdir(str(build_dir))
+        self.assertIn("template.yaml", build_dir_files)
+        self.assertIn(function_logical_id, build_dir_files)
+
+        template_path = build_dir.joinpath("template.yaml")
+        resource_artifact_dir = build_dir.joinpath(function_logical_id)
+
+        # Make sure the template has correct CodeUri for resource
+        self._verify_resource_property(str(template_path),
+                                       function_logical_id,
+                                       "CodeUri",
+                                       function_logical_id)
+
+        all_artifacts = set(os.listdir(str(resource_artifact_dir)))
+        actual_files = all_artifacts.intersection(expected_files)
+        self.assertEquals(actual_files, expected_files)
+
+        all_modules = set(os.listdir(str(resource_artifact_dir.joinpath('node_modules'))))
+        actual_files = all_modules.intersection(expected_modules)
+        self.assertEquals(actual_files, expected_modules)
+
+    def _verify_resource_property(self, template_path, logical_id, property, expected_value):
+
+        with open(template_path, 'r') as fp:
+            template_dict = yaml_parse(fp.read())
+            self.assertEquals(expected_value, template_dict["Resources"][logical_id]["Properties"][property])