iotedgedev 3.3.4__zip → 3.3.6__zip

s/iotedgedev.egg-info/SOURCES.txt

@@ -59,6 +59,8 @@ tests/test_iotedgedev_iothub_deploy.py
 tests/test_iotedgedev_simulator.py
 tests/test_iotedgedev_solution.py
 tests/test_iotedgedev_solution_build.py
+tests/test_iotedgedev_solution_deploy.py
+tests/test_iotedgedev_solution_init.py
 tests/test_iotedgedev_solution_tag.py
 tests/test_utility.py
 tests/utility.py
@@ -79,7 +81,6 @@ tests/assets/test_solution_shared_lib/deployment.debug.template.json
 tests/assets/test_solution_shared_lib/deployment.escapedpath.template.json
 tests/assets/test_solution_shared_lib/deployment.template.json
 tests/assets/test_solution_shared_lib/layered_deployment.flattened_props.template.json
-tests/assets/test_solution_shared_lib/layered_deployment.no_modules.template.json
 tests/assets/test_solution_shared_lib/.vscode/launch.json
 tests/assets/test_solution_shared_lib/libs/sharedlib/Class1.cs
 tests/assets/test_solution_shared_lib/libs/sharedlib/sharedlib.csproj

s/iotedgedev.egg-info/requires.txt

@@ -4,8 +4,8 @@ docker>=3.7.0
 python-dotenv
 requests<=2.25.1,>=2.20.0
 fstrings
-azure-cli-core>=2.25.0
-iotedgehubdev==0.14.14
+azure-cli-core<2.35.0,>=2.34.1
+iotedgehubdev==0.14.16
 applicationinsights==0.11.9
 commentjson==0.9.0
 pyyaml>=5.4

s/requirements.txt

@@ -3,10 +3,10 @@ docker==5.0.3
 python-dotenv==0.19.0
 requests==2.25.1
 fstrings==0.1.0
-msrestazure==0.4.34
-iotedgehubdev==0.14.14
+msrestazure==0.6.4
+iotedgehubdev==0.14.16
 applicationinsights==0.11.9
 commentjson==0.9.0
-azure-cli-core==2.25.0
+azure-cli-core==2.34.1
 pypiwin32==219; sys_platform == 'win32' and python_version < '3.6'
 pypiwin32==223; sys_platform == 'win32' and python_version >= '3.6'

s/setup.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 3.3.4
+current_version = 3.3.6
 commit = True
 tag = True
 

s/setup.py

@@ -12,8 +12,10 @@ requirements = [
     'python-dotenv',
     'requests >= 2.20.0, <= 2.25.1',
     'fstrings',
-    'azure-cli-core >= 2.25.0',
-    'iotedgehubdev == 0.14.14',
+    # Note >=2.35.0 cannot be used as is not compatible with the docker dependency;
+    # docker requires websocket-client==0.56.0 and azure-cli-core>=2.35.0 requires websocket-client==1.31.1.
+    'azure-cli-core >= 2.34.1, < 2.35.0',
+    'iotedgehubdev == 0.14.16',
     'applicationinsights == 0.11.9',
     'commentjson == 0.9.0',
     'pyyaml>=5.4',
@@ -31,7 +33,7 @@ test_requirements = [
 
 setup(
     name='iotedgedev',
-    version='3.3.4',
+    version='3.3.6',
     description='The Azure IoT Edge Dev Tool greatly simplifies the IoT Edge development process by automating many routine manual tasks, such as building, deploying, pushing modules and configuring the IoT Edge Runtime.',
     long_description='See https://github.com/azure/iotedgedev for usage instructions.',
     author='Microsoft Corporation',

s/tests/__init__.py

@@ -2,4 +2,4 @@
 
 __author__ = 'Microsoft Corporation'
 __email__ = 'opencode@microsoft.com'
-__version__ = '3.3.4'
+__version__ = '3.3.6'

s/tests/assets/test_solution_shared_lib/deployment.template.json

@@ -13,7 +13,7 @@
               "testacr": {
                 "username": "$USERNAME",
                 "password": "$PASSWORD",
-                "address": "$CONTAINER_REGISTRY_PASSWORD"
+                "address": "$CONTAINER_REGISTRY_SERVER"
               }
             }
           }

s/tests/assets/test_solution_shared_lib/layered_deployment.flattened_props.template.json

@@ -2,19 +2,53 @@
     "content": {
         "modulesContent": {
             "$edgeAgent": {
-                "properties.desired.modules.sample_module": {
-                    "version": "1.0",
-                    "type": "docker",
-                    "status": "running",
-                    "restartPolicy": "always",
-                    "settings": {
-                        "image": "${MODULES.sample_module}",
-                        "createOptions": {}
+                "properties.desired": {
+                    "schemaVersion": "${EDGEAGENT_SCHEMA_VERSION}",
+                    "runtime": {
+                      "type": "docker",
+                      "settings": {
+                        "minDockerVersion": "v1.25",
+                        "loggingOptions": "",
+                        "registryCredentials": {}
+                      }
+                    },
+                    "modules": {
+                        "sample_module": {
+                            "version": "1.0",
+                            "type": "docker",
+                            "status": "running",
+                            "restartPolicy": "always",
+                            "settings": {
+                                "image": "${MODULES.sample_module}",
+                                "createOptions": {}
+                            }
+                        }
+                    },
+                    "systemModules": {
+                        "edgeAgent": {
+                            "type": "docker",
+                            "settings": {
+                                "image": "mcr.microsoft.com/azureiotedge-agent:${EDGE_RUNTIME_VERSION}"
+                            }
+                        },
+                        "edgeHub": {
+                            "type": "docker",
+                            "status": "running",
+                            "settings": {
+                                "image": "mcr.microsoft.com/azureiotedge-hub:${EDGE_RUNTIME_VERSION}"
+                            },
+                            "restartPolicy": "always"
+                        }
                     }
                 }
             },
             "$edgeHub": {
-                "properties.desired.routes.upstream": "FROM /messages/* INTO $upstream"
+                "properties.desired": {
+                    "schemaVersion": "${EDGEHUB_SCHEMA_VERSION}",
+                    "routes": {
+                        "route": "FROM /messages/* INTO $upstream"
+                    }
+                }
             }
         }
     }

s/tests/test_iotedgedev_iothub_deploy.py

@@ -21,7 +21,6 @@ test_solution_shared_lib_dir = os.path.join(os.getcwd(), "tests", "assets", "tes
     "config, manifest",
     [
         ("layered_deployment.flattened_props.template.json", "layered_deployment.flattened_props.json"),
-        ("layered_deployment.no_modules.template.json", "layered_deployment.no_modules.json"),
         ("deployment.template.json", f"deployment.{get_platform_type()}.json")
     ]
 )

s/tests/test_iotedgedev_solution.py

@@ -201,7 +201,7 @@ def test_module_add_invalid_name(prepare_solution_with_env):
     assert "already exists under" in result.output
 
 
-@pytest.fixture
+@ pytest.fixture
 def test_push_modules():
     result = runner_invoke(['push', '-P', get_platform_type()])
 
@@ -210,7 +210,7 @@ def test_push_modules():
     assert 'ERROR' not in result.output
 
 
-@pytest.fixture
+@ pytest.fixture
 def test_deploy_modules():
     if get_docker_os_type() == "windows":
         result = runner_invoke(['deploy', '-f', os.path.join('config', 'deployment.' + get_platform_type() + '.json')])
@@ -221,7 +221,7 @@ def test_deploy_modules():
     assert 'ERROR' not in result.output.replace('ERROR: Error while checking for extension', '')
 
 
-@pytest.fixture
+@ pytest.fixture
 def test_monitor(capfd):
     runner_invoke(['monitor', '--timeout', '5'])
 
@@ -371,7 +371,6 @@ def test_validate_deployment_template_and_manifest_success():
             result = runner_invoke(['genconfig', '-f', deployment_file_name])
 
         assert "ERROR" not in result.output
-        assert "Deployment manifest schema validation passed" in result.output
         assert "Warning: Deployment manifest schema validation failed" not in result.output
         assert "Validation for all createOptions passed" in result.output
         assert "Warning: Errors found during createOptions validation" not in result.output

s/tests/test_iotedgedev_solution_build.py

@@ -69,25 +69,6 @@ def test_solution_build_and_push_with_layered_deployment():
     assert 'ERROR' not in result.output
 
 
-def test_solution_build_and_push_with_layered_deployment_no_modules():
-    # Arrange
-    os.chdir(test_solution_shared_lib_dir)
-    new_config_deployment_path = os.path.join(test_solution_shared_lib_dir, 'config', 'layered_deployment.no_modules.json')
-
-    # Act
-    result = runner_invoke(['build', '--push', '-f', "layered_deployment.no_modules.template.json", '-P', get_platform_type()])
-
-    # Assert
-
-    with open(new_config_deployment_path, "r") as f:
-        content = json.load(f)
-
-    set_property = content["content"]["modulesContent"]["exampleModule"]["properties.desired"]["foo"]
-
-    assert 'ERROR' not in result.output
-    assert 'bar-1.2' == set_property
-
-
 def test_solution_build_and_push_with_platform():
     os.chdir(test_solution_shared_lib_dir)
 

s/tests/test_iotedgedev_solution_deploy.py

@@ -0,0 +1,197 @@
+import json
+import os
+import shutil
+import time
+from unittest import mock
+
+import pytest
+from iotedgedev.envvars import EnvVars
+from iotedgedev.output import Output
+from iotedgedev.version import PY35
+
+from .utility import (get_docker_os_type,
+                      get_platform_type, runner_invoke)
+
+pytestmark = pytest.mark.e2e
+
+output = Output()
+envvars = EnvVars(output)
+
+root_dir = os.getcwd()
+tests_dir = os.path.join(root_dir, "tests")
+tests_assets_dir = os.path.join(tests_dir, "assets")
+
+env_file_name = envvars.get_dotenv_file()
+env_file_path = envvars.get_dotenv_path(env_file_name)
+
+launch_json_file = os.path.join(tests_dir, "assets", "launch.json")
+launch_json_file_without_nodejs = os.path.join(tests_dir, "assets", "launch_without_nodejs.json")
+
+test_solution = "test_solution"
+test_solution_dir = os.path.join(tests_dir, test_solution)
+
+test_solution_shared_lib = "test_solution_shared_lib"
+test_solution_shared_lib_dir = os.path.join(tests_dir, "assets", test_solution_shared_lib)
+
+templates = ["c", "csharp", "java", "nodejs", "python", "csharpfunction"]
+
+
+def create_solution(template, custom_module_name=None):
+    if custom_module_name is None:
+        module_name = template + "module"
+    else:
+        module_name = custom_module_name
+    result = runner_invoke(['new', test_solution, '-m', module_name, '-t', template])
+
+    return result
+
+
+def clean_folder(folder_path):
+    os.chdir(tests_dir)
+    time.sleep(5)
+    shutil.rmtree(folder_path, ignore_errors=True)
+
+
+@pytest.fixture
+def prepare_solution_with_env():
+    os.chdir(tests_dir)
+
+    template = "csharp"
+    module_name = "filtermodule"
+    result = create_solution(template, module_name)
+    if 'AZURE IOT EDGE SOLUTION CREATED' not in result.output:
+        raise Exception(result.stdout)
+
+    shutil.copyfile(env_file_path, os.path.join(test_solution_dir, env_file_name))
+
+    os.chdir(test_solution_dir)
+
+    yield prepare_solution_with_env
+    clean_folder(test_solution_dir)
+
+    return
+
+
+def assert_solution_folder_structure(template):
+    module_name = template + "module"
+
+    expected_files = [".env", "deployment.template.json", "deployment.debug.template.json",
+                      os.path.join(".vscode", "launch.json"),
+                      os.path.join("modules", module_name, "Dockerfile.amd64"),
+                      os.path.join("modules", module_name, "Dockerfile.amd64.debug"),
+                      os.path.join("modules", module_name, "Dockerfile.arm32v7"),
+                      os.path.join("modules", module_name, "module.json")]
+    for expected_file in expected_files:
+        assert os.path.exists(os.path.join(test_solution_dir, expected_file))
+
+    expected_template_files = [os.environ["DEPLOYMENT_CONFIG_TEMPLATE_FILE"], os.environ["DEPLOYMENT_CONFIG_DEBUG_TEMPLATE_FILE"]]
+
+    for expected_template_file in expected_template_files:
+        with open(os.path.join(test_solution_dir, expected_template_file)) as f:
+            content = json.load(f)
+
+        assert module_name in content["modulesContent"]["$edgeAgent"]["properties.desired"]["modules"]
+        assert module_name in content["modulesContent"]["$edgeAgent"]["properties.desired"]["modules"][module_name]["settings"]["image"]
+        assert module_name in content["modulesContent"]["$edgeHub"]["properties.desired"]["routes"]["sensorTo" + module_name]
+        assert module_name in content["modulesContent"]["$edgeHub"]["properties.desired"]["routes"][module_name + "ToIoTHub"]
+
+
+def assert_module_folder_structure(template):
+    module_name = template + "module"
+    expected_template_files = [os.environ["DEPLOYMENT_CONFIG_TEMPLATE_FILE"], os.environ["DEPLOYMENT_CONFIG_DEBUG_TEMPLATE_FILE"]]
+
+    for expected_template_file in expected_template_files:
+        with open(expected_template_file) as f:
+            content = json.load(f)
+
+        assert module_name in content["modulesContent"]["$edgeAgent"]["properties.desired"]["modules"]
+        assert module_name in content["modulesContent"]["$edgeAgent"]["properties.desired"]["modules"][module_name]["settings"]["image"]
+        assert module_name in content["modulesContent"]["$edgeHub"]["properties.desired"]["routes"][module_name + "ToIoTHub"]
+
+        if expected_template_file == os.environ["DEPLOYMENT_CONFIG_DEBUG_TEMPLATE_FILE"]:
+            if module_name in ["cmodule", "pythonmodule", "nodejsmodule", "javamodule"]:
+                assert "HostConfig" in content["modulesContent"]["$edgeAgent"]["properties.desired"]["modules"][module_name]["settings"]["createOptions"]
+
+
+@pytest.fixture
+def test_push_modules():
+    result = runner_invoke(['push', '-P', get_platform_type()])
+
+    assert 'BUILD COMPLETE' in result.output
+    assert 'PUSH COMPLETE' in result.output
+    assert 'ERROR' not in result.output
+
+
+@pytest.fixture
+def test_deploy_modules():
+    if get_docker_os_type() == "windows":
+        result = runner_invoke(['deploy', '-f', os.path.join('config', 'deployment.' + get_platform_type() + '.json')])
+    else:
+        result = runner_invoke(['deploy'])
+
+    assert 'DEPLOYMENT COMPLETE' in result.output
+    assert 'ERROR' not in result.output.replace('ERROR: Error while checking for extension', '')
+
+
+@pytest.fixture
+def test_monitor(capfd):
+    runner_invoke(['monitor', '--timeout', '5'])
+
+    out, err = capfd.readouterr()
+    if not PY35:
+        assert 'Monitoring events from device' in out
+    else:
+        assert not err
+
+
+def get_connection_string_value(key: str) -> str:
+
+    connection_string_values = os.environ["DEVICE_CONNECTION_STRING"].split(';')
+    device_id = None
+
+    for item in connection_string_values:
+        if key in item:
+            device_id = item.split('=')[1]
+
+    return device_id
+
+
+@ mock.patch.dict(os.environ, {"DEVICE_CONNECTION_STRING": f"HostName={get_connection_string_value('HostName')};DeviceId={get_connection_string_value('DeviceId')};=testaccesskey"})
+def test_solution_deploy_with_sas_connection_string():
+    # Arrange
+    os.chdir(test_solution_shared_lib_dir)
+
+    # Act
+    result = runner_invoke(['solution', 'deploy'])
+
+    # Assert
+    assert 'DEPLOYMENT COMPLETE' in result.output
+    assert 'ERROR' not in result.output
+
+
+@ mock.patch.dict(os.environ, {"DEVICE_CONNECTION_STRING": f"HostName={get_connection_string_value('HostName')};DeviceId={get_connection_string_value('DeviceId')};x509=true;"})
+def test_solution_deploy_with_x509_connection_string():
+    # Arrange
+    os.chdir(test_solution_shared_lib_dir)
+
+    # Act
+    runner_invoke(['build', '-f', "deployment.template.json", '-P', get_platform_type()])
+    result = runner_invoke(['solution', 'deploy'])
+
+    # Assert
+    assert 'DEPLOYMENT COMPLETE' in result.output
+    assert 'ERROR' not in result.output
+
+
+@ mock.patch.dict(os.environ, {"DEVICE_CONNECTION_STRING": "HostName=test-iothub.azure-devices.net;SharedAccessKey=testaccesskey"})
+def test_connection_string_no_device_id_throws_env_error():
+    # Arrange
+    os.chdir(test_solution_shared_lib_dir)
+
+    # Act
+    runner_invoke(['build', '-f', "deployment.template.json", '-P', get_platform_type()])
+    with pytest.raises(Exception) as context:
+        runner_invoke(['solution', 'deploy'])
+
+    # Assert
+    assert "ERROR: Environment Variable EDGE_DEVICE_ID not set." in str(context.value)

s/tests/test_iotedgedev_solution_init.py

@@ -0,0 +1,34 @@
+import os
+import shutil
+import uuid
+from unittest import mock
+from .utility import (runner_invoke)
+
+
+def test_solution_init_without_name():
+    result = runner_invoke(['solution', 'init'], True)
+
+    assert "Directory is not empty" in result.output
+
+
+def test_solution_init_with_invalid_name_non_empty_dir():
+    dirname = f'test-{uuid.uuid4()}'
+    os.makedirs(f'{dirname}/empty_dir')
+
+    result = runner_invoke(['solution', 'init', dirname], True)
+
+    assert "Directory is not empty" in result.output
+    shutil.rmtree(dirname, ignore_errors=True)
+
+
+def test_solution_init_with_valid_name():
+    dirname = f'test-{uuid.uuid4()}'
+
+    # Mock calls to additional commands, to avoid triggering user prompts
+    with mock.patch('iotedgedev.utility.Utility.call_proc') as mock_call_proc:
+        result = runner_invoke(['solution', 'init', dirname], True)
+
+    assert 'AZURE IOT EDGE SOLUTION CREATED' in result.output
+    mock_call_proc.assert_called_with(["iotedgedev", "iothub", "setup", "--update-dotenv"])
+    assert mock_call_proc.call_count == 2
+    shutil.rmtree(dirname, ignore_errors=True)

s/.git/logs/refs/remotes/origin/eliises/add-device-tagging-docs

@@ -1 +0,0 @@
-0000000000000000000000000000000000000000 89935ca2b03964ef69cbccb1b8e5815ca25ec62d Ubuntu <cloudtest@fd6fd2d8c000000.p5rt4sl1n0gu1ozd445c4dptsd.bx.internal.cloudapp.net> 1648752750 +0000	fetch --force --tags --prune --prune-tags --progress --no-recurse-submodules origin: storing head

s/.git/refs/remotes/origin/eliises/add-device-tagging-docs

@@ -1 +0,0 @@
-89935ca2b03964ef69cbccb1b8e5815ca25ec62d

s/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,16 +0,0 @@
----
-name: Bug report
-about: Create a issue to help us improve
----
-
-<!-- Fill in the information needed -->
-- iotedgedev Version:
-- Python Version:
-- Pip Version:
-- Development machine OS Version:
-- IoT Edge device OS Version:
-
-Steps to Reproduce:
-
-1.
-2.

s/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,7 +0,0 @@
----
-name: Feature request
-about: Suggest an idea for IoT Edge and IoT Edge development tools
-
----
-
-<!-- Describe the feature you'd like. -->

s/docs/Home.md

@@ -1,10 +0,0 @@
-Welcome to the IoT Edge Dev Tool wiki!
-
-The **IoT Edge Dev Tool** greatly simplifies [Azure IoT Edge](https:/azure.microsoft.com/en-us/services/iot-edge/) development down to simple commands driven by environment variables.
-
- - It gets you started with IoT Edge development with the [IoT Edge Dev Container](quickstart-with-iot-edge-dev-container) and IoT Edge solution scaffolding that contains a default module and all the required configuration files.
- - It speeds up your inner-loop dev (dev, debug, test) by reducing multi-step build & deploy processes into one-line CLI commands as well as drives your outer-loop CI/CD pipeline. _You can use all the same commands in both stages of your development life-cycle._
-
-## Issues
-
-Please use the [GitHub issues page](https://github.com/azure/iotedgedev/issues) to report any issues.

s/docs/Manual-Dev-Machine-Setup.md

@@ -1,77 +0,0 @@
-Here is what you need to do to get Azure IoT Edge Dev Tool (aka `iotedgedev`) running on your dev machine manually instead of using the IoT Edge Dev Container.
-
-If you are using a separate Edge device, like a Raspberry Pi, you do not need to run all of these steps on your IoT Edge device, you can install and setup Edge runtime directly on the device. See the [Edge Device Setup](edge-device-setup) wiki page for more information on setting up your Edge device.
-
-> Note: See the ["Test Coverage"](test-coverage) wiki page to see what the IoT Edge Dev Tool has been tested with.
-
-1. Install **[Docker](https://docs.docker.com/engine/installation/)**
-    - Windows    
-        - Be sure to check whether you are running in Linux container mode or Windows container mode.
-    - Linux
-        - We've seen some issues with docker.io. If Edge doesn't run for you, then try installing Docker CE directly instead of via docker.io. Use the [CE install steps](https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/#install-docker-ce), or use the [convenience script](https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/#install-using-the-convenience-script).
-        - By default, you need `sudo` to run `docker` commands. If you want to avoid this, please follow the [post-installation steps for Linux](https://docs.docker.com/install/linux/linux-postinstall/#manage-docker-as-a-non-root-user).
-        
-1. Install **Python 2.7+ or Python 3.6+** and **pip** (Python 3.6 is recommended)
-    - Windows: [Install from Python's website](https://www.python.org/downloads/)
-    - Linux: `sudo apt install python-pip` or `sudo apt install python3-pip`
-    - macOS: The OpenSSL used by the system built-in Python is old and vulnerable. Please use Python installed with [Homebrew](https://docs.brew.sh/Homebrew-and-Python)
-    
-1. Install **[Azure CLI 2.0](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest)**
-
-1. Install **[Azure CLI IoT extension](https://github.com/Azure/azure-iot-cli-extension/)**
-
-    - New Install: `az extension add --name azure-iot`
-    - Update Install: `az extension update --name azure-iot`
-
-1. (Python < 3.5 only) Install **[Node.js](https://nodejs.org/en/download/)** and the **`iothub-explorer`** package
-
-    - uamqp, which is needed by Azure CLI IoT extension for monitoring messages, is not supported in Python < 3.5. For Python < 3.5 users, please install [Node.js](https://nodejs.org/en/download/) and the `iothub-explorer` Node.js package: `npm i -g iothub-explorer`
-
-1. (Raspberry Pi only) Install extra system dependencies
-
-    ```
-    sudo apt-get install python2.7-dev libffi-dev libssl-dev -y
-    ```
-
-1. (Linux only) Install [Docker Compose](https://docs.docker.com/compose/)
-
-    ```
-    pip install -U docker-compose
-    ```
-
-1. Install **`iotedgedev`**
-
-    > You do not need to run this on the Edge device. See the [Edge Device Setup](edge-device-setup) page for more information on setting up your Edge device.
-
-    > You can also run under a Python Virtual Environment.  See the [Python Virtual Environment Setup](python-virtual-environment-setup) instructions page for details on how to set that up.
-
-    > There is a known dependency conflict between `iotedgedev` and now-deprecated `azure-iot-edge-runtime-ctl`. Please make sure you have uninstalled `azure-iot-edge-runtime-ctl` before installing `iotedgedev`: `pip uninstall azure-iot-edge-runtime-ctl `, or use a clean virtual environment.
-
-    ```
-    pip install -U iotedgedev
-    ```
-
-1. Install module dependencies
-    ##### C# module and C# Azure Functions module
-    Install **[.NET Core SDK](https://www.microsoft.com/net/download)**.
-    > You need .NET Core SDK 2.1 or later to run it on ARM. There is no official document on installing .NET Core SDK on ARM yet, but you can follow the [ARM32v7 Dockerfile](https://github.com/dotnet/dotnet-docker/blob/master/src/sdk/3.1/buster/arm32v7/Dockerfile).
-    
-    ##### Python module
-    1. Install **[Git](https://git-scm.com/)**
-    2. Install **[Cookiecutter](https://github.com/audreyr/cookiecutter)**
-    ```
-    pip install -U cookiecutter
-    ```
-
-    ##### Node.js module
-    1. Install **[Node.js](https://nodejs.org/en/download/)**
-    2. Install **[Yeoman](http://yeoman.io/)** and **[Azure IoT Edge Node.js module generator](https://github.com/Azure/generator-azure-iot-edge-module)** packages
-    ```
-    npm i -g yo generator-azure-iot-edge-module
-    ```
-
-    ##### Java module
-    1. Install **[JDK](https://www.oracle.com/technetwork/java/javase/downloads/index.html)**
-    1. Install **[Maven](https://maven.apache.org/)**
-
-1. Follow the [Usage Wiki](usage) to learn the usage of IoT Edge Dev Tool