Add docs and last patch

Author: piraces

LEARN.md

@@ -0,0 +1,48 @@
+# Learning Bicep and how the tasks works
+
+Bicep is a Domain Specific Language (DSL) for deploying Azure resources declaratively. The official documentation and sources to learn Bicep can be found in [the oficial repository](https://github.com/Azure/bicep).
+
+In order to compile `.bicep` files, the Bicep CLI is used.
+The aim of this extension is to manage the installation and use of the Bicep CLI in Azure DevOps pipelines and ease the process of `.bicep` files compilation.
+
+# How the tasks works
+
+The extension has two tasks, one to install and make available the CLI for subsequent tasks and other to execute the `bicep build` command with a series of files (with globbing support).
+
+The first task (`BicepInstall`) should be executed always before the second task (`BicepBuild`). For example:
+
+```yaml
+- task: BicepInstall@0
+    displayName: 'Install Bicep CLI'
+
+- task: BicepBuild@0
+    displayName: 'Compile .bicep files'
+    inputs:
+      sourceDirectory: 'bicep_files/**.bicep'
+```
+
+The `BicepInstall` has a optional argument to specify the version of Bicep to be used (in the format `major.minor.patch`). For example:
+
+```yaml
+- task: BicepInstall@0
+    displayName: 'Install Bicep CLI'
+    inputs:
+      version: '0.2.328'
+```
+
+Also, the `BicepBuild` task, accepts glob patterns and single files. The example above, shows how to use glob patterns, and if you want specify only a single file, just specify its relative or full path:
+
+```yaml
+- task: BicepBuild@0
+    displayName: 'Compile .bicep files'
+    inputs:
+      sourceDirectory: 'bicep_files/sample1.bicep'
+```
+
+A full example of pipeline can be found in this repository, in the `azure-pipelines.yml` file in the repository root directory.
+
+# See it in action
+
+A complete pipeline using different environments is run in every commit push and its available to review if you would like to see it.
+
+[See the pipeline](https://raulejea.visualstudio.com/Bicep%20Tasks/_build?definitionId=19&_a=summary)

src/install/task.json

@@ -16,7 +16,7 @@
     "version": {
       "Major": 0,
       "Minor": 1,
-      "Patch": 0
+      "Patch": 1
     },
     "instanceNameFormat": "Install Bicep CLI",
     "inputs": [

src/run/index.ts

@@ -26,15 +26,18 @@ async function run() {
         try {
             if (bicepToolName && bicepToolVersion) {
                 bicepTool = toolLib.findLocalTool(bicepToolName, bicepToolVersion);
+                if (bicepTool) {
+                    bicepTool = path.join(bicepTool, bicepToolName);
+                }
             }
 
             if (!bicepTool) {
-                const defaultToolName = platform() === 'win32' ? 'bicep.exe' : 'bicep';
-                bicepTool = taskLib.which(defaultToolName);
+                bicepTool = taskLib.getVariable('BICEP_PATH');
             }
 
             if (!bicepTool) {
-                bicepTool = taskLib.getVariable('BICEP_PATH');
+                const defaultToolName = platform() === 'win32' ? 'bicep.exe' : 'bicep';
+                bicepTool = taskLib.which(defaultToolName);
             }
         } catch (error) {
             throw new Error(

src/run/task.json

@@ -16,7 +16,7 @@
     "version": {
       "Major": 0,
       "Minor": 1,
-      "Patch": 0
+      "Patch": 1
     },
     "instanceNameFormat": "Run Bicep CLI build command",
     "inputs": [

vss-extension.json

@@ -1,7 +1,7 @@
 {
     "manifestVersion": 1,
     "id": "bicep-tasks",
-    "version": "0.1.0",
+    "version": "0.1.1",
     "name": "Bicep Tasks",
     "publisher": "piraces",
     "description": "Provides Azure DevOps tasks to install and run Microsoft Bicep CLI commands (cross-platform)",