dirac-lang 0.1.24 → 0.1.26

package/tests/README.md

@@ -1,69 +0,0 @@
-# Dirac Test Suite
-
-Comprehensive unit tests for all Dirac tags and features.
-
-## Running Tests
-
-```bash
-npm test
-```
-
-## Test Coverage
-
-### Core Tags
-- ✅ `<output>` - Basic output, multiple outputs
-- ✅ `<defvar>` - Variable definition, multiple variables
-- ✅ `<variable>` - Variable interpolation
-- ✅ `<assign>` - Basic assignment, assignment from eval
-- ✅ `<eval>` - Basic eval, eval with variables
-- ✅ `<expr>` - Basic expressions, string concatenation
-
-### Control Flow
-- ✅ `<if>` - Basic conditionals, with variables, else logic
-- ✅ `<loop>` - Basic loops, nested loops, loops with eval
-
-### Functions
-- ✅ `<subroutine>` - Basic subroutines, multiple params, recursive
-- ✅ `<call>` - Basic calls, calls with output
-- ✅ `<import>` - Import external libraries
-- ✅ `<parameters>` - Parameter definitions with defaults
-
-### System Integration
-- ✅ `<system>` - Basic system commands, output capture, trim
-- ✅ `<require_module>` - Node.js module imports
-
-### Error Handling
-- ✅ `<try>` - Try blocks
-- ✅ `<catch>` - Catch blocks, error variable
-- ✅ `<throw>` - Throw custom errors
-- ✅ `<exception>` - Exception handling
-
-### Advanced (Need manual testing with LLM)
-- ⚠️ `<llm>` - Requires LLM configuration
-- ⚠️ `<execute>` - Requires LLM configuration
-- ⚠️ `<mongodb>` - Requires MongoDB connection
-
-## Test Format
-
-Each test file follows this format:
-
-```xml
-<!-- TEST: test_name -->
-<!-- EXPECT: expected output -->
-<dirac>
-  <!-- Test code here -->
-</dirac>
-```
-
-## Adding New Tests
-
-1. Create a new `.test.di` file in `/tests`
-2. Add TEST and EXPECT comments
-3. Write your test
-4. Run `npm test`
-
-## Test Statistics
-
-- **Total Tests**: 32
-- **Tag Coverage**: 19/24 tags (79%)
-- **Missing Coverage**: llm, execute, mongodb (require external services)

package/tests/assign-basic.test.di

@@ -1,7 +0,0 @@
-<!-- TEST: assign_basic -->
-<!-- EXPECT: New value: updated -->
-<dirac>
-  <defvar name="myvar" value="initial" />
-  <assign name="myvar" value="updated" />
-  <output>New value: <variable name="myvar" /></output>
-</dirac>

package/tests/assign-from-eval.test.di

@@ -1,7 +0,0 @@
-<!-- TEST: assign_from_eval -->
-<!-- EXPECT: Result: 15 -->
-<dirac>
-  <defvar name="result" value="0" />
-  <eval name="result">return 10 + 5;</eval>
-  <output>Result: <variable name="result" /></output>
-</dirac>

package/tests/available-subroutines-foreach.test.di

@@ -1,32 +0,0 @@
-<!-- TEST: available-subroutines with foreach and attr -->
-<!-- EXPECT: - show-subroutines: 
-- greet: Greets someone
-- gender: Returns gender identity
-- age: Returns the person age -->
-<dirac>
-<subroutine name="TestSuite">
-  <subroutine name="age" description="Returns the person age">
-    <output>42</output>
-  </subroutine>
-  
-  <subroutine name="gender" description="Returns gender identity">
-    <output>Male</output>
-  </subroutine>
-  
-  <subroutine name="greet" description="Greets someone">
-    <output>Hello!</output>
-  </subroutine>
-
-  <subroutine name="show-subroutines">
-    <defvar name="subs"><available-subroutines /></defvar>
-    <foreach from="$subs" as="sub" xpath="//subroutine">
-      <output>- <attr name="name" from="$sub" />: <attr name="description" from="$sub" />
-</output>
-    </foreach>
-  </subroutine>
-
-  <show-subroutines />
-</subroutine>
-
-<TestSuite />
-</dirac>

package/tests/basic-output.test.di

@@ -1,5 +0,0 @@
-<!-- TEST: basic_output -->
-<!-- EXPECT: Hello, World! -->
-<dirac>
-  <output>Hello, World!</output>
-</dirac>

package/tests/call-basic.test.di

@@ -1,11 +0,0 @@
-<!-- TEST: call_basic -->
-<!-- EXPECT: Square of 5 is: 25 -->
-<dirac>
-  <subroutine name="square" param-x="number">
-    <eval name="result">return parseInt(x) * parseInt(x);</eval>
-    <output><variable name="result" /></output>
-  </subroutine>
-  
-  <output>Square of 5 is: </output>
-  <call name="square" x="5" />
-</dirac>

package/tests/call-with-output.test.di

@@ -1,10 +0,0 @@
-<!-- TEST: call_with_output -->
-<!-- EXPECT: 100 -->
-<dirac>
-  <subroutine name="square" param-x="number">
-    <eval name="result">return parseInt(x) * parseInt(x);</eval>
-    <output><variable name="result" /></output>
-  </subroutine>
-  
-  <call name="square" x="10" />
-</dirac>

package/tests/comments-before-content.test.di

@@ -1,6 +0,0 @@
-<!-- TEST: comments_before_content -->
-<!-- EXPECT: Success -->
-<!-- First comment -->
-<!-- Second comment -->
-<!-- Multiple comments before any element should work -->
-<output>Success</output>

package/tests/defvar-multiple.test.di

@@ -1,8 +0,0 @@
-<!-- TEST: defvar_multiple -->
-<!-- EXPECT: a=1, b=2, c=3 -->
-<dirac>
-  <defvar name="a" value="1" />
-  <defvar name="b" value="2" />
-  <defvar name="c" value="3" />
-  <output>a=<variable name="a" />, b=<variable name="b" />, c=<variable name="c" /></output>
-</dirac>

package/tests/environment-basic.test.di

@@ -1,22 +0,0 @@
-<!-- TEST: environment_basic -->
-<!-- EXPECT: HOME exists: true USER exists: true -->
-<dirac>
-  <defvar name="home"><environment name="HOME" /></defvar>
-  <defvar name="user"><environment name="USER" /></defvar>
-  
-  <output>HOME exists: </output>
-  <test-if test="$home != ''">
-    <output>true</output>
-  </test-if>
-  <test-if test="$home == ''">
-    <output>false</output>
-  </test-if>
-  
-  <output> USER exists: </output>
-  <test-if test="$user != ''">
-    <output>true</output>
-  </test-if>
-  <test-if test="$user == ''">
-    <output>false</output>
-  </test-if>
-</dirac>

package/tests/environment-nonexistent.test.di

@@ -1,5 +0,0 @@
-<!-- TEST: environment_nonexistent -->
-<!-- EXPECT: Empty: [] -->
-<dirac>
-  <output>Empty: [<environment name="NONEXISTENT_VAR_12345_TEST" />]</output>
-</dirac>

package/tests/environment-with-defvar.test.di

@@ -1,15 +0,0 @@
-<!-- TEST: environment_with_defvar -->
-<!-- EXPECT: Path exists: true -->
-<dirac>
-  <defvar name="mypath">
-    <environment name="PATH" />
-  </defvar>
-  
-  <output>Path exists: </output>
-  <test-if test="$mypath != ''">
-    <output>true</output>
-  </test-if>
-  <test-if test="$mypath == ''">
-    <output>false</output>
-  </test-if>
-</dirac>

package/tests/eval-basic.test.di

@@ -1,6 +0,0 @@
-<!-- TEST: eval_basic -->
-<!-- EXPECT: Calculated: 42 -->
-<dirac>
-  <eval name="result">return 6 * 7;</eval>
-  <output>Calculated: <variable name="result" /></output>
-</dirac>

package/tests/eval-with-variables.test.di

@@ -1,8 +0,0 @@
-<!-- TEST: eval_with_variables -->
-<!-- EXPECT: Sum: 30 -->
-<dirac>
-  <defvar name="a" value="10" />
-  <defvar name="b" value="20" />
-  <eval name="sum">return parseInt(a) + parseInt(b);</eval>
-  <output>Sum: <variable name="sum" /></output>
-</dirac>

package/tests/exception-basic.test.di

@@ -1,10 +0,0 @@
-<!-- TEST: exception_handling -->
-<!-- EXPECT: Caught: test error -->
-<dirac>
-  <try>
-    <throw name="test_exception">test error</throw>
-  </try>
-  <catch name="test_exception">
-    <output>Caught: <exception /></output>
-  </catch>
-</dirac>

package/tests/expr-basic.test.di

@@ -1,11 +0,0 @@
-<!-- TEST: expr_basic -->
-<!-- EXPECT: Result: 15 -->
-<dirac>
-  <defvar name="a" value="10" />
-  <defvar name="b" value="5" />
-  <output>Result: </output>
-  <expr eval="plus">
-    <arg><variable name="a" /></arg>
-    <arg><variable name="b" /></arg>
-  </expr>
-</dirac>

package/tests/extend-basic.test.di

@@ -1,19 +0,0 @@
-<!-- TEST: extend_basic -->
-<!-- EXPECT: In parent, calling: Child nested -->
-<dirac>
-  <subroutine name="parent">
-    <subroutine name="nested">
-      <output>Parent nested</output>
-    </subroutine>
-    <output>In parent, calling: </output>
-    <call name="nested" />
-  </subroutine>
-  
-  <subroutine name="child" extends="parent">
-    <subroutine name="nested">
-      <output>Child nested</output>
-    </subroutine>
-  </subroutine>
-  
-  <call name="child" />
-</dirac>

package/tests/extend-inheritance-chain.test.di

@@ -1,26 +0,0 @@
-<!-- TEST: extend_inheritance_chain -->
-<!-- EXPECT: A X C -->
-<dirac>
-  <subroutine name="data">
-    <subroutine name="field1">
-      <output>A</output>
-    </subroutine>
-    <subroutine name="field2">
-      <output>B</output>
-    </subroutine>
-    <subroutine name="field3">
-      <output>C</output>
-    </subroutine>
-    <call name="field1" />
-    <call name="field2" />
-    <call name="field3" />
-  </subroutine>
-  
-  <subroutine name="data" extends="data">
-    <subroutine name="field2">
-      <output>X</output>
-    </subroutine>
-  </subroutine>
-  
-  <call name="data" />
-</dirac>

package/tests/extend-multiple-nested.test.di

@@ -1,24 +0,0 @@
-<!-- TEST: extend_multiple_nested -->
-<!-- EXPECT: 63 , M -->
-<dirac>
-  <subroutine name="base">
-    <subroutine name="age">
-      <output>60</output>
-    </subroutine>
-    <subroutine name="gender">
-      <output>M</output>
-    </subroutine>
-    <parameters select="*" />
-  </subroutine>
-  
-  <subroutine name="base" extends="base">
-    <subroutine name="age">
-      <output>63</output>
-    </subroutine>
-    <parameters select="*" />
-  </subroutine>
-  
-  <base><age /></base>
-  <output>,</output>
-  <base><gender /></base>
-</dirac>

package/tests/extend-self.test.di

@@ -1,19 +0,0 @@
-<!-- TEST: extend_self -->
-<!-- EXPECT: Age: 63 -->
-<dirac>
-  <subroutine name="person">
-    <subroutine name="age">
-      <output>60</output>
-    </subroutine>
-    <output>Age: </output>
-    <call name="age" />
-  </subroutine>
-  
-  <subroutine name="person" extends="person">
-    <subroutine name="age">
-      <output>63</output>
-    </subroutine>
-  </subroutine>
-  
-  <call name="person" />
-</dirac>

package/tests/extend-with-parameters.test.di

@@ -1,14 +0,0 @@
-<!-- TEST: extend_with_parameters -->
-<!-- EXPECT: Hello, World -->  
-<dirac>
-  <subroutine name="greet" param-name="string:required">
-    <output>Hello, </output>
-    <output><variable name="name" /></output>
-  </subroutine>
-  
-  <subroutine name="greet" extends="greet" param-name="string:required">
-    <!-- Child body is not executed with extends, only nested subroutines override -->
-  </subroutine>
-  
-  <greet name="World" />
-</dirac>

package/tests/generate-dirac.test.di

@@ -1,22 +0,0 @@
-<!-- TEST: generate_and_execute_dirac -->
-<!-- EXPECT: Generated file executed
-Result: 42 -->
-<dirac>
-  <!-- Define a DIRAC script as literal -->
-  <defvar name="generated_script" literal="true" trim="false">
-<dirac>
-  <defvar name="value">42</defvar>
-  <output>Result: <variable name="value" /></output>
-</dirac>
-  </defvar>
-  
-  <!-- Write to file -->
-  <output file="temp-generated.di"><variable name="generated_script" /></output>
-  
-  <!-- Execute the generated script -->
-  <output>Generated file executed</output>
-  <system shell="bash">
-    node dist/cli.js temp-generated.di
-    rm temp-generated.di
-  </system>
-</dirac>

package/tests/if-conditional.test.di

@@ -1,17 +0,0 @@
-<!-- TEST: if_conditional_true -->
-<!-- EXPECT: Match! -->
-<dirac>
-  <defvar name="x" value="5" />
-  <if>
-    <cond eval="eq">
-      <arg><variable name="x" /></arg>
-      <arg>5</arg>
-    </cond>
-    <then>
-      <output>Match!</output>
-    </then>
-    <else>
-      <output>No match!</output>
-    </else>
-  </if>
-</dirac>

package/tests/if-else.test.di

@@ -1,11 +0,0 @@
-<!-- TEST: if_else -->
-<!-- EXPECT: Value is small -->
-<dirac>
-  <defvar name="num" value="5" />
-  <test-if test="$num > 10">
-    <output>Value is large</output>
-  </test-if>
-  <test-if test="$num <= 10">
-    <output>Value is small</output>
-  </test-if>
-</dirac>

package/tests/if-with-variables.test.di

@@ -1,8 +0,0 @@
-<!-- TEST: if_with_variables -->
-<!-- EXPECT: Match found -->
-<dirac>
-  <defvar name="status" value="active" />
-  <test-if test="$status == active">
-    <output>Match found</output>
-  </test-if>
-</dirac>

package/tests/import-basic.test.di

@@ -1,6 +0,0 @@
-<!-- TEST: import_basic -->
-<!-- EXPECT: 25 -->
-<dirac>
-  <import src="./examples/lib/math.di" />
-  <call name="SQUARE" x="5" />
-</dirac>

package/tests/input-file-all.test.di

@@ -1,5 +0,0 @@
-<!-- TEST: input_file_all -->
-<!-- EXPECT: line one line two line three -->
-<dirac>
-  <input source="file" path="tests/test-input.txt" mode="all" />
-</dirac>

package/tests/input-file-line.test.di

@@ -1,15 +0,0 @@
-<!-- TEST: input_file_line -->
-<!-- EXPECT: First: line one Second: line two Third: line three EOF: -->
-<dirac>
-  <output>First: </output>
-  <input source="file" path="tests/test-input.txt" mode="line" />
-  
-  <output> Second: </output>
-  <input source="file" path="tests/test-input.txt" mode="line" />
-  
-  <output> Third: </output>
-  <input source="file" path="tests/test-input.txt" mode="line" />
-  
-  <output> EOF: </output>
-  <input source="file" path="tests/test-input.txt" mode="line" />
-</dirac>

package/tests/input-file-loop.test.di

@@ -1,12 +0,0 @@
-<!-- TEST: input_file_with_loop -->
-<!-- EXPECT: line one | line two | line three | -->
-<dirac>
-  <loop count="3">
-    <defvar name="line">
-      <input source="file" path="tests/test-input.txt" mode="line" />
-    </defvar>
-    
-    <variable name="line" />
-    <output> | </output>
-  </loop>
-</dirac>

package/tests/input-stdin-all.test.di

@@ -1,8 +0,0 @@
-<!-- TEST: input_stdin_all -->
-<!-- EXPECT: hello from stdin -->
-<dirac>
-  <defvar name="data">
-    <input source="stdin" mode="all"/>
-  </defvar>
-  <output><variable name="data"/></output>
-</dirac>

package/tests/input-stdin-all.txt

@@ -1 +0,0 @@
-hello from stdin

package/tests/llm-validate.test.di

@@ -1,17 +0,0 @@
-<!-- TEST: llm_execute_with_validation -->
-<!-- EXPECT: Background color is: blue -->
-
-<dirac>
-  <subroutine name="set-color" 
-              description="Set a background color"
-              param-color="string:required:Color name">
-    <parameters select="@color"/>
-    <output>Background color is: <variable name="color" /></output>
-  </subroutine>
-
-  <!-- Test: LLM with execute=true and validate=true should work -->
-  <!-- This tests that DIRAC-ROOT wrapper tag is properly skipped during validation -->
-  <llm execute="true" validate="true" maxTokens="100">
-    Set the background color to blue
-  </llm>
-</dirac>

package/tests/loop-basic.test.di

@@ -1,9 +0,0 @@
-<!-- TEST: loop_basic -->
-<!-- EXPECT: 0 1 2 -->
-<dirac>
-  <defvar name="i" value="0" />
-  <loop count="3">
-    <output><variable name="i" /></output>
-    <assign name="i"><eval><variable name="i" /> + 1</eval></assign>
-  </loop>
-</dirac>

package/tests/loop-nested.test.di

@@ -1,10 +0,0 @@
-<!-- TEST: loop_nested -->
-<!-- EXPECT: 0-A 0-B 1-A 1-B -->
-<dirac>
-  <loop count="2" var="i">
-    <loop count="2" var="j">
-      <eval name="letter">return j === 0 ? 'A' : 'B';</eval>
-      <output><variable name="i" />-<variable name="letter" /> </output>
-    </loop>
-  </loop>
-</dirac>

package/tests/loop-with-eval.test.di

@@ -1,8 +0,0 @@
-<!-- TEST: loop_with_eval -->
-<!-- EXPECT: 0 2 4 -->
-<dirac>
-  <loop count="3" var="i">
-    <eval name="doubled">return parseInt(i) * 2;</eval>
-    <output><variable name="doubled" /></output>
-  </loop>
-</dirac>

package/tests/no-root-element.test.di

@@ -1,6 +0,0 @@
-<!-- TEST: no_root_element -->
-<!-- EXPECT: Hello World -->
-<!-- Test case without explicit <dirac> root - should work with DIRAC-ROOT wrapper -->
-<output>Hello</output>
-<output> </output>
-<output>World</output>

package/tests/output-file.test.di

@@ -1,19 +0,0 @@
-<!-- TEST: output_file_basic -->
-<!-- EXPECT: stdout output
-File written -->
-<dirac>
-  <!-- Write to file -->
-  <output file="output-test-temp.txt">File line 1</output>
-  <output file="output-test-temp.txt">File line 2</output>
-  
-  <!-- Output to stdout to verify test runs -->
-  <output>stdout output</output>
-  
-  <!-- Use system to verify file and clean up -->
-  <system shell="bash">
-    if [ -f output-test-temp.txt ]; then
-      echo "File written"
-      rm output-test-temp.txt
-    fi
-  </system>
-</dirac>

package/tests/output-multiple.test.di

@@ -1,9 +0,0 @@
-<!-- TEST: output_multiple -->
-<!-- EXPECT: Line 1
-Line 2
-Line 3 -->
-<dirac>
-  <output>Line 1</output>
-  <output>Line 2</output>
-  <output>Line 3</output>
-</dirac>

package/tests/parameters-basic.test.di

@@ -1,6 +0,0 @@
-<!-- TEST: parameters_basic -->
-<!-- EXPECT: Skipped -->
-<dirac>
-  <!-- This test requires HTTP request context, skipped for now -->
-  <output>Skipped</output>
-</dirac>

package/tests/require-module-basic.test.di

@@ -1,7 +0,0 @@
-<!-- TEST: require_module_basic -->
-<!-- EXPECT: Platform: darwin -->
-<dirac>
-  <require_module name="os" var="os" />
-  <eval name="platform">return os.platform();</eval>
-  <output>Platform: <variable name="platform" /></output>
-</dirac>

package/tests/subroutine-basic.test.di

@@ -1,9 +0,0 @@
-<!-- TEST: subroutine_call -->
-<!-- EXPECT: Hello, Alice! -->
-<dirac>
-  <subroutine name="greet" param-name="string">
-    <output>Hello, <variable name="name" />!</output>
-  </subroutine>
-  
-  <greet name="Alice" />
-</dirac>

package/tests/subroutine-multiple-params.test.di

@@ -1,10 +0,0 @@
-<!-- TEST: subroutine_multiple_params -->
-<!-- EXPECT: John Doe -->
-<dirac>
-  <subroutine name="fullname" param-first="string" param-last="string">
-    <eval name="result">return first + ' ' + last;</eval>
-    <output><variable name="result" /></output>
-  </subroutine>
-  
-  <call name="fullname" first="John" last="Doe" />
-</dirac>