@taqueria/plugin-ligo 0.8.2 → 0.10.0

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 (4) hide show
  1. package/README.md +33 -15
  2. package/_readme.eta +33 -15
  3. package/package.json +2 -2
  4. package/.vscode/settings.json +0 -3
package/README.md CHANGED
@@ -4,7 +4,7 @@ The LIGO plugin provides a task to compile LIGO smart contracts to Michelson `.t
4
4
 
5
5
  ## Requirements
6
6
 
7
- - Taqueria v0.0.6 or later
7
+ - Taqueria v0.8.0 or later
8
8
  - Node.js v16.3 or later
9
9
  - Docker v0.8.4 or later
10
10
 
@@ -18,20 +18,29 @@ taq install @taqueria/plugin-ligo
18
18
  ## Configuration
19
19
 
20
20
  No additional configuration is available
21
+
21
22
  ## Usage
22
23
 
23
24
  The LIGO plugin exposes a `compile` task in Taqueria which can target one, or all the LIGO contracts in the `contracts` folder and compile them to Michelson `.tz` files output to the `artifacts` folder
24
25
 
25
- ### Running the Compile Task
26
+ The LIGO plugin also exposes a contract template via the `taq create contract <contractName>` task. This task will create a new LIGO contract in the `contracts` directory, insert some boilerplate LIGO contract code and will register the contract with Taqueria
27
+
28
+ ## Tasks
29
+
30
+ ### The `taq compile` Task
31
+
32
+ The LIGO plugin's `taq compile` task can be run with or without arguments. The structure for the task is:
26
33
 
27
- The LIGO plugin's `taq compile` task can be run with or without arguments. The basic syntax for the task is `taq compile <file-name>`
34
+ ```shell
35
+ taq compile <file-name>
36
+ ```
28
37
 
29
- Running the `compile` task with no options will result in any source LIGO smart contracts in the `contracts` folder being compiled to Michelson files in the `artifacts` folder. If you speficy an optional filename, only LIGO contracts matching the specified filename in the `contracts` folder will be compiled
38
+ Running the `compile` task with no options will result in any registered LIGO smart contracts in the `contracts` folder being compiled to Michelson files in the `artifacts` folder. If you speficy an optional filename, only LIGO contracts matching the specified filename in the `contracts` folder will be registered and compiled
30
39
 
31
40
  > ### :warning: CAUTION
32
- > The `compile` task can be implemented by more than one compiler plugin installed on a project (LIGO, SmartPY). If this is the case, you must use the `--plugin ligo` flag to specify a particular compiler
41
+ > The `compile` task can be implemented by more than one compiler plugin installed on a project (LIGO, Archetype, SmartPY). If this is the case, you must use the `--plugin ligo` flag to specify a particular compiler
33
42
 
34
- ### Options
43
+ #### Options
35
44
 
36
45
  The LIGO `compile` task will accept the following optional parameters:
37
46
 
@@ -41,17 +50,26 @@ The LIGO `compile` task will accept the following optional parameters:
41
50
  | -s | syntax | The syntax used in the contract |
42
51
  | -i | infer | Enable type inference |
43
52
 
53
+ #### Task Properties
44
54
 
45
- ## Plugin Architecture
55
+ | attribute | value |
56
+ |------------|:-----------------------------:|
57
+ | task | 'compile' |
58
+ | command | 'compile [sourceFile] |
59
+ | aliases | ['c', 'compile-ligo'] |
46
60
 
47
- This is a plugin developed for Taqueria built on NodeJS using the Taqueria Node SDK
61
+ ### The `create contract` Template
48
62
 
49
- Docker is used under the hood to provide a self contained environment for LIGO to prevent the need for it to be installed on the user's local machine
63
+ The `create contract` task is used to create a new LIGO contract from a template. Running this task will create a new LIGO smart contract in the `contracts` directory, insert boilerplate contract code and will register that contract with Taqueria
64
+
65
+ ```shell
66
+ taq create contract <contractName>
67
+ ```
50
68
 
51
- The plugin provides a single task `compile`, used for compiling LIGO smart contracts to Michelson:
69
+ The `create contract` task takes a filename a required positional argument. The filename must end with a LIGO extension (`.jsligo`, `.mligo`, etc)
52
70
 
53
- | attribute | value |
54
- |------------|:------------------------:|
55
- | task | 'compile' |
56
- | command | 'compile [sourceFile] |
57
- | aliases | ['c', 'compile-ligo'] |
71
+ ## Plugin Architecture
72
+
73
+ This is a plugin developed for Taqueria built on NodeJS using the Taqueria Node SDK
74
+
75
+ Docker is used under the hood to provide a self contained environment for Archetype to prevent the need for it to be installed on the user's local machine
package/_readme.eta CHANGED
@@ -6,7 +6,7 @@ The LIGO plugin provides a task to compile LIGO smart contracts to Michelson `.t
6
6
 
7
7
  ## Requirements
8
8
 
9
- - Taqueria v0.0.6 or later
9
+ - Taqueria v0.8.0 or later
10
10
  - Node.js v16.3 or later
11
11
  - Docker v0.8.4 or later
12
12
 
@@ -20,21 +20,30 @@ taq install @taqueria/plugin-ligo
20
20
  ## Configuration
21
21
 
22
22
  No additional configuration is available
23
+
23
24
  ## Usage
24
25
 
25
26
  The LIGO plugin exposes a `compile` task in Taqueria which can target one, or all the LIGO contracts in the `contracts` folder and compile them to Michelson `.tz` files output to the `artifacts` folder
26
27
 
27
- ### Running the Compile Task
28
+ The LIGO plugin also exposes a contract template via the `taq create contract <contractName>` task. This task will create a new LIGO contract in the `contracts` directory, insert some boilerplate LIGO contract code and will register the contract with Taqueria
29
+
30
+ ## Tasks
31
+
32
+ ### The `taq compile` Task
33
+
34
+ The LIGO plugin's `taq compile` task can be run with or without arguments. The structure for the task is:
28
35
 
29
- The LIGO plugin's `taq compile` task can be run with or without arguments. The basic syntax for the task is `taq compile <file-name>`
36
+ ```shell
37
+ taq compile <file-name>
38
+ ```
30
39
 
31
- Running the `compile` task with no options will result in any source LIGO smart contracts in the `contracts` folder being compiled to Michelson files in the `artifacts` folder. If you speficy an optional filename, only LIGO contracts matching the specified filename in the `contracts` folder will be compiled
40
+ Running the `compile` task with no options will result in any registered LIGO smart contracts in the `contracts` folder being compiled to Michelson files in the `artifacts` folder. If you speficy an optional filename, only LIGO contracts matching the specified filename in the `contracts` folder will be registered and compiled
32
41
 
33
42
  <%~ it.cautionOpenAdmonition %>
34
- The `compile` task can be implemented by more than one compiler plugin installed on a project (LIGO, SmartPY). If this is the case, you must use the `--plugin ligo` flag to specify a particular compiler
43
+ The `compile` task can be implemented by more than one compiler plugin installed on a project (LIGO, Archetype, SmartPY). If this is the case, you must use the `--plugin ligo` flag to specify a particular compiler
35
44
  <%= it.closeAdmonition %>
36
45
 
37
- ### Options
46
+ #### Options
38
47
 
39
48
  The LIGO `compile` task will accept the following optional parameters:
40
49
 
@@ -44,17 +53,26 @@ The LIGO `compile` task will accept the following optional parameters:
44
53
  | -s | syntax | The syntax used in the contract |
45
54
  | -i | infer | Enable type inference |
46
55
 
56
+ #### Task Properties
47
57
 
48
- ## Plugin Architecture
58
+ | attribute | value |
59
+ |------------|:-----------------------------:|
60
+ | task | 'compile' |
61
+ | command | 'compile [sourceFile] |
62
+ | aliases | ['c', 'compile-ligo'] |
49
63
 
50
- This is a plugin developed for Taqueria built on NodeJS using the Taqueria Node SDK
64
+ ### The `create contract` Template
51
65
 
52
- Docker is used under the hood to provide a self contained environment for LIGO to prevent the need for it to be installed on the user's local machine
66
+ The `create contract` task is used to create a new LIGO contract from a template. Running this task will create a new LIGO smart contract in the `contracts` directory, insert boilerplate contract code and will register that contract with Taqueria
67
+
68
+ ```shell
69
+ taq create contract <contractName>
70
+ ```
53
71
 
54
- The plugin provides a single task `compile`, used for compiling LIGO smart contracts to Michelson:
72
+ The `create contract` task takes a filename a required positional argument. The filename must end with a LIGO extension (`.jsligo`, `.mligo`, etc)
55
73
 
56
- | attribute | value |
57
- |------------|:------------------------:|
58
- | task | 'compile' |
59
- | command | 'compile [sourceFile] |
60
- | aliases | ['c', 'compile-ligo'] |
74
+ ## Plugin Architecture
75
+
76
+ This is a plugin developed for Taqueria built on NodeJS using the Taqueria Node SDK
77
+
78
+ Docker is used under the hood to provide a self contained environment for Archetype to prevent the need for it to be installed on the user's local machine
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@taqueria/plugin-ligo",
3
- "version": "0.8.2",
3
+ "version": "0.10.0",
4
4
  "description": "A taqueria plugin for compiling LIGO smart contracts",
5
5
  "targets": {
6
6
  "default": {
@@ -41,7 +41,7 @@
41
41
  },
42
42
  "homepage": "https://github.com/ecadlabs/taqueria#readme",
43
43
  "dependencies": {
44
- "@taqueria/node-sdk": "^0.8.2",
44
+ "@taqueria/node-sdk": "^0.10.0",
45
45
  "fast-glob": "^3.2.11"
46
46
  },
47
47
  "devDependencies": {
package/.vscode/settings.json DELETED
@@ -1,3 +0,0 @@
1
- {
2
- "deno.codeLens.test": false
3
- }