add tests and documentation for max_decommission_year

Author: Aurashk

schemas/input/assets.yaml

@@ -22,3 +22,10 @@ fields:
       This value can be any integer >=0. If it is before the start of the simulation, it will
       already be commissioned in the first year and if it after the end of the simulation then it
       will never be commissioned.
+  - name: max_decommission_year
+    type: integer
+    description: The latest year in which this asset can be decommissioned
+    notes: |
+      This value can be any integer that satisfies max_decommission_year >= commission_year >=0.
+      If it is set before the simulation starting year, the asset will not be commissioned during the
+      simulation.

src/asset.rs

@@ -1538,7 +1538,7 @@ mod tests {
     #[rstest]
     #[case::early_decommission_within_lifetime(2024, 2024)]
     #[case::decommission_at_maximum_year(2026, 2025)]
-    fn test_asset_decommission(
+    fn test_asset_decommission_with_process_lifetime(
         #[case] requested_decommission_year: u32,
         #[case] expected_decommission_year: u32,
         process: Process,
@@ -1563,6 +1563,35 @@ mod tests {
         assert_eq!(asset.decommission_year(), Some(expected_decommission_year));
     }
 
+    #[rstest]
+    #[case::early_decommission_within_lifetime(2024, 2024)]
+    #[case::decommission_at_maximum_year(2026, 2025)]
+    fn test_asset_decommission_with_predefined_decommission_year(
+        #[case] requested_decommission_year: u32,
+        #[case] expected_decommission_year: u32,
+        process: Process,
+    ) {
+        // Test successful commissioning of Future asset
+        let process_rc = Rc::new(process);
+        let mut asset = Asset::new_future_with_max_decommission(
+            "agent1".into(),
+            Rc::clone(&process_rc),
+            "GBR".into(),
+            Capacity(1.0),
+            2020,
+            Some(2025),
+        )
+        .unwrap();
+        asset.commission(AssetID(1), "");
+        assert!(asset.is_commissioned());
+        assert_eq!(asset.id(), Some(AssetID(1)));
+
+        // Test successful decommissioning
+        asset.decommission(requested_decommission_year, "");
+        assert!(!asset.is_commissioned());
+        assert_eq!(asset.decommission_year(), Some(expected_decommission_year));
+    }
+
     #[rstest]
     #[should_panic(expected = "Assets with state Candidate cannot be commissioned")]
     fn test_commission_wrong_states(process: Process) {

src/input/asset.rs

@@ -140,15 +140,15 @@ mod tests {
             region_id: "GBR".into(),
             capacity: Capacity(1.0),
             commission_year: 2010,
-            ..Default::default()
+            max_decommission_year: None,
         })]
     #[case(AssetRaw { // Bad agent ID
             agent_id: "agent2".into(),
             process_id: "process1".into(),
             region_id: "GBR".into(),
             capacity: Capacity(1.0),
             commission_year: 2010,
-            ..Default::default()
+            max_decommission_year: None,
         })]
     #[case(AssetRaw { // Bad region ID: not in region_ids
             agent_id: "agent1".into(),
@@ -158,6 +158,14 @@ mod tests {
             commission_year: 2010,
             max_decommission_year: None,
         })]
+    #[case(AssetRaw { // Bad max_decommission_year: before commission_year
+            agent_id: "agent1".into(),
+            process_id: "process1".into(),
+            region_id: "GBR".into(),
+            capacity: Capacity(1.0),
+            commission_year: 2010,
+            max_decommission_year: Some(2005),
+        })]
     fn test_read_assets_from_iter_invalid(
         #[case] asset: AssetRaw,
         agent_ids: IndexSet<AgentID>,