Implement DAG and reordering of the VTL statements

Author: NicoLaval

coverage/pom.xml

@@ -6,13 +6,13 @@
     <parent>
         <groupId>fr.insee.trevas</groupId>
         <artifactId>trevas-parent</artifactId>
-        <version>1.12.0</version>
+        <version>2.0.0</version>
     </parent>
 
     <artifactId>coverage</artifactId>
     <description>Aggregate Coverage Report</description>
     <name>VTL coverage</name>
-    <version>1.12.0</version>
+    <version>2.0.0</version>
 
     <properties>
         <sonar.coverage.jacoco.xmlReportPaths>
@@ -24,37 +24,37 @@
         <dependency>
             <groupId>fr.insee.trevas</groupId>
             <artifactId>vtl-engine</artifactId>
-            <version>1.12.0</version>
+            <version>2.0.0</version>
         </dependency>
         <dependency>
             <groupId>fr.insee.trevas</groupId>
             <artifactId>vtl-jackson</artifactId>
-            <version>1.12.0</version>
+            <version>2.0.0</version>
         </dependency>
         <dependency>
             <groupId>fr.insee.trevas</groupId>
             <artifactId>vtl-jdbc</artifactId>
-            <version>1.12.0</version>
+            <version>2.0.0</version>
         </dependency>
         <dependency>
             <groupId>fr.insee.trevas</groupId>
             <artifactId>vtl-model</artifactId>
-            <version>1.12.0</version>
+            <version>2.0.0</version>
         </dependency>
         <dependency>
             <groupId>fr.insee.trevas</groupId>
             <artifactId>vtl-parser</artifactId>
-            <version>1.12.0</version>
+            <version>2.0.0</version>
         </dependency>
         <dependency>
             <groupId>fr.insee.trevas</groupId>
             <artifactId>vtl-spark</artifactId>
-            <version>1.12.0</version>
+            <version>2.0.0</version>
         </dependency>
         <dependency>
             <groupId>fr.insee.trevas</groupId>
             <artifactId>vtl-csv</artifactId>
-            <version>1.12.0</version>
+            <version>2.0.0</version>
         </dependency>
         <dependency>
             <groupId>com.fasterxml.jackson.core</groupId>

docs/blog/2025-09-28-trevas-2.mdx

@@ -0,0 +1,15 @@
+---
+slug: /trevas-2
+title: Trevas - Version 2.0.0
+authors: [nicolas]
+tags: [Trevas]
+---
+
+import useBaseUrl from '@docusaurus/useBaseUrl';
+import Link from '@theme/Link';
+
+Trevas 2.0.0 is released!
+
+Following the implementation of DAGs and the reordering of VTL instructions before execution, evaluating a VTL script will integrate this new functionality by default.
+
+A <Link label={'technical documentation'} href={useBaseUrl('/developer-guide/dag')}/> is available to describe this feature and how to disable it.

docs/docs/developer-guide/basic-mode/data-sources/jdbc.mdx

@@ -12,7 +12,7 @@ custom_edit_url: null
 <dependency>
     <groupId>fr.insee.trevas</groupId>
     <artifactId>vtl-jdbc</artifactId>
-    <version>1.12.0</version>
+    <version>2.0.0</version>
 </dependency>
 ```
 

docs/docs/developer-guide/basic-mode/data-sources/json.mdx

@@ -12,7 +12,7 @@ custom_edit_url: null
 <dependency>
     <groupId>fr.insee.trevas</groupId>
     <artifactId>vtl-jackson</artifactId>
-    <version>1.12.0</version>
+    <version>2.0.0</version>
 </dependency>
 ```
 

docs/docs/developer-guide/dag.mdx

@@ -0,0 +1,44 @@
+---
+id: dag
+title: DAG (Directed acyclic graph) - Statement reordering
+sidebar_label: DAG - Statement reordering
+slug: /developer-guide/dag
+custom_edit_url: null
+---
+
+### Statement reordering
+
+Suppose we have two Transformations:
+
+1. Create an intermediate dataset `DS_np`
+2. Use `DS_np` to calculate another dataset `DS_p`
+
+Even if we write them in "reverse" order, the VTL standard requires executing them in the correct dependency order.
+
+```
+-- Transformation Scheme Example
+
+-- (i) This depends on DS_np
+DS_p <- if DS_np >= 0 then DS_np else DS_1;
+
+-- (ii) This produces DS_np
+DS_np := (DS_1 - DS_2) * 2;
+```
+
+Execution Order (resolved by the engine)
+
+1. (ii) must run first because DS_np is required before evaluating (i).
+
+2. (i) runs afterwards, since it consumes DS_np.
+
+So even though we wrote (i) before (ii), the engine reorders them automatically, **when reordering is activated**.
+
+### Activate reordering
+
+The current behavior of Trevas is that statement reordering is **activated per default**, as this is the behavior required by the VTL standard.
+Statement reordering can be **deactivated** via the following config flag ("$vtl.engine.use_dag")
+
+```java
+ScriptEngine engine = new ScriptEngineManager().getEngineByName("vtl");
+engine.put("$vtl.engine.use_dag", "false");
+```

docs/docs/developer-guide/index-developer-guide.mdx

@@ -15,7 +15,7 @@ import Card from '@theme/Card';
 <dependency>
     <groupId>fr.insee.trevas</groupId>
     <artifactId>vtl-engine</artifactId>
-    <version>1.12.0</version>
+    <version>2.0.0</version>
 </dependency>
 ```
 

docs/docs/developer-guide/provenance.mdx

@@ -12,7 +12,7 @@ custom_edit_url: null
 <dependency>
     <groupId>fr.insee.trevas</groupId>
     <artifactId>vtl-spark</artifactId>
-    <version>1.12.0</version>
+    <version>2.0.0</version>
 </dependency>
 ```
 

docs/docs/developer-guide/spark-mode/index-spark-mode.mdx

@@ -16,7 +16,7 @@ The `SparkDataset` data sets can represent statistical tables in a Java applicat
 <dependency>
     <groupId>fr.insee.trevas</groupId>
     <artifactId>vtl-spark</artifactId>
-    <version>1.12.0</version>
+    <version>2.0.0</version>
 </dependency>
 ```
 

docs/docs/introduction/releases/2.x.x.mdx

@@ -0,0 +1,16 @@
+---
+id: 2.x.x
+title: Release 2.x.x
+sidebar_label: v2.x.x
+slug: /releases/2.x.x
+custom_edit_url: null
+---
+
+## Version 2.0.0 - 09/28/25
+
+(See technical release on [Github](https://github.com/InseeFr/Trevas/releases/tag/v2.0.0))
+
+- Implementation of a DAG and reordering the VTL statements before execution
+- Fix `vtl-prov` and `vtl-sdmx` issues
+- Fix comparison issue
+- Fix bindings initialization to avoid variable reuse

docs/docs/introduction/releases/index-releases.mdx

@@ -19,5 +19,12 @@ import Card from '@theme/Card';
 				page={useBaseUrl('/releases/1.x.x')}
 			/>
 		</div>
+		<div className="col">
+			<Card
+				title="v2.x.x"
+				description=""
+				page={useBaseUrl('/releases/2.x.x')}
+			/>
+		</div>
 	</div>
 </div>