0.0.12

cf-lib/changelog.txt

@@ -1,6 +1,32 @@
 ---------------------------------------------------------------------------------------------------
+Version: 0.0.12
+Date: 06.04.2025
+  Changes:
+    Add table.count
+---------------------------------------------------------------------------------------------------
+Version: 0.0.11
+Date: 28.03.2025
+  Changes:
+    - Add Technology:setIngredients
+---------------------------------------------------------------------------------------------------
+Version: 0.0.10
+Date: 16.03.2025
+  Changes:
+    - Recipe: addIngredient amount defaults to 1
+    - Functions are chainable
+---------------------------------------------------------------------------------------------------
+Version: 0.0.9
+Date: 28.02.2025
+  Bug Fixes:
+    - Rename `table.concat` to `table.concatTables` to resolve conflict
+---------------------------------------------------------------------------------------------------
+Version: 0.0.8
+Date: 28.02.2025
+  Changes:
+    - Add table.trim
+---------------------------------------------------------------------------------------------------
 Version: 0.0.7
-Date: 15.02.2025
+Date: 26.02.2025
   Changes:
     - Add table.concat
   Bug Fixes:

cf-lib/data/Recipe.lua

@@ -39,12 +39,14 @@ end
 ---- @param data table The data to assign
 function Recipe:assign(data)
     table.assign(self.prototype, data)
+    return self
 end
 
 --- Adds an ingredient to the recipe
 --- @param ingredientName string The name of the ingredient
---- @param amount number The amount of the ingredient
+--- @param amount number The amount of the ingredient (default: 1)
 function Recipe:addIngredient(ingredientName, amount)
+    amount = amount or 1
     local ingredientType = data.raw.item[ingredientName] and "item"
         or data.raw.module[ingredientName] and "item"
         or data.raw.fluid[ingredientName] and "fluid"
@@ -64,6 +66,7 @@ function Recipe:addIngredient(ingredientName, amount)
         end
     end
     table.insert(self.prototype.ingredients, { name = ingredientName, amount = amount, type = ingredientType })
+    return self
 end
 
 --- Replaces an existing ingredient by name with a new ingredient or adjusts the amount
@@ -80,10 +83,11 @@ function Recipe:replaceIngredient(old, new, amount)
             if result.name == old then
                 result.name = new
                 result.amount = amount or result.amount
-                return
+                return self
             end
         end
     end
+    return self
 end
 
 --- Removes an existing ingredient by name
@@ -93,10 +97,11 @@ function Recipe:removeIngredient(ingredientName)
         for i, result in pairs(self.prototype.ingredients) do
             if result.name == ingredientName then
                 self.prototype.ingredients[i] = nil
-                return
+                return self
             end
         end
     end
+    return self
 end
 
 --- Replaces an existing result by name with a new result
@@ -121,6 +126,7 @@ function Recipe:replaceResult(old, new, amount, expensiveAmount)
             table.main_product = new
         end
     end
+    return self
 end
 
 --- Adds the recipe to a technology
@@ -135,10 +141,11 @@ function Recipe:unlockedByTechnology(technology)
     end
     for _, effect in pairs(technology.effects) do
         if effect.type == "unlock-recipe" and effect.recipe == self.prototype.name then
-            return
+           return self
         end
     end
     table.insert(technology.effects, { type = "unlock-recipe", recipe = self.prototype.name })
+    return self
 end
 
 ---- Clones the recipe

cf-lib/data/Technology.lua

@@ -47,12 +47,14 @@ end
 --- @param data table The data to assign
 function Technology:assign(data)
     table.assign(self.prototype, data)
+    return self
 end
 
 --- Sets the prerequisite for the technology
 --- @param prerequisites table The names of the prerequisites
 function Technology:setPrerequisites(prerequisites)
     self.prototype.prerequisites = prerequisites
+    return self
 end
 
 --- Adds a prerequisite to the technology
@@ -63,6 +65,7 @@ function Technology:addPrerequisite(prerequisite)
     if (not table.contains(self.prototype.prerequisites, _prerequisite)) then
         table.insert(self.prototype.prerequisites, _prerequisite)
     end
+    return self
 end
 
 --- Adds multiple prerequisites to the technology
@@ -75,6 +78,7 @@ function Technology:addPrerequisites(prerequisites)
             table.insert(self.prototype.prerequisites, _prerequisite)
         end
     end
+    return self
 end
 
 --- Replaces a prerequisite in a technology
@@ -88,6 +92,7 @@ function Technology:replacePrerequisite(old, new)
             self.prototype.prerequisites[i] = _new
         end
     end
+    return self
 end
 
 --- Removes a prerequisite from the technology
@@ -97,9 +102,10 @@ function Technology:removePrerequisite(prerequisite)
     for i, techPrerequisite in pairs(self.prototype.prerequisites) do
         if techPrerequisite == _prerequisite then
             table.remove(self.prototype.prerequisites, i)
-            return
+            return self
         end
     end
+    return self
 end
 
 --- Adds an ingredient to the technology
@@ -109,6 +115,7 @@ function Technology:addIngredient(ingredientName, amount)
     self.prototype.unit = self.prototype.unit or { ingredients = {} }
     self.prototype.unit.ingredients = self.prototype.unit.ingredients or {}
     table.insert(self.prototype.unit.ingredients, { ingredientName, amount or 1 })
+    return self
 end
 
 --- Adds a list of ingredients to the technology with the default amount of 1
@@ -117,6 +124,7 @@ function Technology:addIngredients(ingredientNames)
     for _, ingredientName in pairs(ingredientNames) do
         self:addIngredient(ingredientName)
     end
+    return self
 end
 
 --- Removes an existing ingredient by name
@@ -129,6 +137,16 @@ function Technology:removeIngredient(ingredientName)
             end
         end
     end
+    return self
+end
+
+--- Sets the ingredients for the technology
+--- @param ingredientNames table The names of the ingredients
+function Technology:setIngredients(ingredients)
+    self.prototype.unit = self.prototype.unit or {}
+    self.prototype.unit.ingredients = {}
+    self:addIngredients(ingredients)
+    return self
 end
 
 --- Adds a recipe unlock to the technology
@@ -136,16 +154,18 @@ end
 function Technology:addRecipe(recipeName)
     for _, effect in pairs(self.prototype.effects) do
         if effect.type == "unlock-recipe" and effect.recipe == recipeName then
-            return
+            return self
         end
     end
     table.insert(self.prototype.effects, { type = "unlock-recipe", recipe = recipeName })
+    return self
 end
 
 --- Adds an effect to the technology
 --- @param effect table The effect to add
 function Technology:addEffect(effect)
     table.insert(self.prototype.effects, effect)
+    return self
 end
 
 --- Removes a recipe unlock from the technology
@@ -154,9 +174,10 @@ function Technology:removeRecipe(recipeName)
     for i, effect in pairs(self.prototype.effects) do
         if effect.type == "unlock-recipe" and effect.recipe == recipeName then
             table.remove(self.prototype.effects, i)
-            return
+            return self
         end
     end
+    return self
 end
 
 --- Clones the technology

cf-lib/info.json

@@ -1,6 +1,6 @@
 {
    "name": "cf-lib",
-   "version": "0.0.7",
+   "version": "0.0.12",
    "title": "cackling fiends library",
    "description": "Because I'd like to have my own library :-)",
    "author": "cackling fiend",

cf-lib/util/table.lua

@@ -74,7 +74,7 @@ end
 --- @param table1 table The first table
 --- @param table2 table The second table
 --- @return table The concatenated table
-function table.concat(table1, table2)
+function table.concatTables(table1, table2)
     local result = {}
     for _, v in pairs(table1) do
         table.insert(result, v)
@@ -84,3 +84,23 @@ function table.concat(table1, table2)
     end
     return result
 end
+
+--- Trims nil values from a table.
+--- @param target table The table to trim
+--- @return table The trimmed table
+function table.trim(target)
+    return table.filter(target, function(v)
+        return v ~= nil
+    end)
+end
+
+--- Counts the entries of given table.
+--- @param target table Table to count
+--- @return number Amount of entries
+function table.count(target)
+    local count = 0
+    for _ in pairs(target) do
+        count = count + 1
+    end
+    return count
+end