Merge branch 'main' into 503-feature-request-add-formulas-617-622-from-nen_en_1993_1_1

# Conflicts:
#	docs/objects_overview/eurocode/ec3_1993_1_1_2016/formulas.md

Author: egarciamendez

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -14,7 +14,7 @@ body:
           required: true
         - label: >
             I have confirmed this bug exists on the
-            [latest version](https://pypi.org/project/blueprints/) of Blueprints.
+            [latest version](https://pypi.org/project/blue-prints/) of Blueprints.
           required: true
 
   - type: textarea

.github/ISSUE_TEMPLATE/formula_request.yml

@@ -13,7 +13,7 @@ body:
     attributes:
       label: "Formula Description"
       description: "Describe the formula you're suggesting to add."
-      placeholder: "Add equation XXX to YYY from Eurocode ZZZ to the project."
+      value: "Add equation XXX to YYY from Eurocode ZZZ to the project."
     validations:
       required: true
 
@@ -22,7 +22,7 @@ body:
     attributes:
       label: "Acceptance Criteria"
       description: "List the conditions that the formula must fulfill to be considered complete."
-      placeholder: "- [ ] Add the formula to the code\n- [ ] Add latex expression to the formula\n- [ ] Add unittests\n- [ ] Add docstrings\n- [ ] Update table in docs with classname(s)"
+      value: "- [ ] Add the formula to the code\n- [ ] Add latex expression to the formula\n- [ ] Add unittests\n- [ ] Add docstrings\n- [ ] Update table in docs with classname(s)"
     validations:
       required: true
 

.github/prompts/casus_formula.prompt.md

@@ -10,6 +10,7 @@
 - LaTeX variables should be rounded to 3 decimals.  
 - The LaTex _numeric_equation_with_units should include units, except when its dimensionless
 - Import the necessary typehinting with type alias units found in type_alias.py and remove the unused imported type aliases. Forces in N, (Bending) moments in Nmm, distances in mm, areas in mm^2, Stress in MPa, angles in DEG, no unit is DIMENSIONLESS. When dealing with angles, use np.deg2rad.
+- Test the value of denominators with raise_if_less_or_equal_to_zero. For all others, test with raise_if_negative.
 
 ## Template for service
 

.github/prompts/comparison_formula.prompt.md

@@ -10,6 +10,7 @@
 - LaTeX variables should be rounded to 3 decimals.  
 - The LaTex _numeric_equation_with_units should include units, except when its dimensionless
 - Import the necessary typehinting with type alias units found in type_alias.py and remove the unused imported type aliases. Forces in N, (Bending) moments in Nmm, distances in mm, areas in mm^2, Stress in MPa, angles in DEG, no unit is DIMENSIONLESS. When dealing with angles, use np.deg2rad.
+- Test the value of denominators with raise_if_less_or_equal_to_zero. For all others, test with raise_if_negative.
 
 ## Template for service
 

.github/prompts/equation_formula.prompt.md

@@ -9,6 +9,7 @@
 - LaTeX variables should be rounded to 3 decimals.  
 - The LaTex _numeric_equation_with_units should include units, except when its dimensionless
 - Import the necessary typehinting with type alias units found in type_alias.py and remove the unused imported type aliases. Forces in N, (Bending) moments in Nmm, distances in mm, areas in mm^2, Stress in MPa, angles in DEG, no unit is DIMENSIONLESS. When dealing with angles, use np.deg2rad.
+- Test the value of denominators with raise_if_less_or_equal_to_zero. For all others, test with raise_if_negative.
 
 ## Template for service
 

.github/workflows/build_deploy.yaml

@@ -24,7 +24,7 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v6
 
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5

.github/workflows/code_coverage.yaml

@@ -16,7 +16,7 @@ jobs:
     - uses: actions/checkout@v4
 
     - name: install uv
-      uses: astral-sh/setup-uv@v5
+      uses: astral-sh/setup-uv@v6
 
     - name: Setup python ${{ matrix.python-version }}
       uses: actions/setup-python@v5

.github/workflows/minimum_code_coverage.yaml

@@ -19,7 +19,7 @@ jobs:
     - uses: actions/checkout@v4
 
     - name: install uv
-      uses: astral-sh/setup-uv@v5
+      uses: astral-sh/setup-uv@v6
 
     - name: Setup python ${{ matrix.python-version }}
       uses: actions/setup-python@v5

.github/workflows/test.yaml

@@ -17,7 +17,7 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@v6
 
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5

.pre-commit-config.yaml

@@ -17,7 +17,7 @@
 
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.11.2
+    rev: v0.11.8
     hooks:
       # Run the linter.
       - id: ruff

.readthedocs.yaml

@@ -25,4 +25,6 @@ formats:
 # See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
 python:
   install:
-  - requirements: docs/requirements_docs.txt
+  - requirements: docs/requirements_docs.txt
+  - method: pip
+    path: .

.ruff.toml

@@ -75,6 +75,8 @@ ignore = [
     "RUF002", # ambiguous-unicode-character-docstring
     "RUF003", # ambiguous-unicode-character-comment
 ]
+[lint.per-file-ignores] 
+"docs/*" = ["T201"]
 
 [format]
 quote-style = "double"

README.md

@@ -1,3 +1,4 @@
+[![LinkedIn](https://img.shields.io/badge/LinkedIn-0077B5?style=flat&logo=linkedin&logoColor=white)](https://www.linkedin.com/company/blueprints-org)
 [![Run Tests](https://github.com/Blueprints-org/blueprints/actions/workflows/test.yaml/badge.svg)](https://github.com/Blueprints-org/blueprints/actions/workflows/test.yaml)
 [![Read the Docs](https://img.shields.io/readthedocs/blueprints?logo=readthedocs&label=Read%20the%20docs&link=https%3A%2F%2Fblueprints.readthedocs.io%2Fen%2Flatest%2F)](https://blueprints.readthedocs.io/en/latest/)
 [![codecov](https://codecov.io/gh/Blueprints-org/blueprints/branch/main/graph/badge.svg?token=vwYQBShr9q)](https://codecov.io/gh/Blueprints-org/blueprints)
@@ -6,7 +7,6 @@
 [![Python versions](https://img.shields.io/badge/python-3.12%20%7C%203.13-blue?style=flat&logo=python)](https://badge.fury.io/py/blueprints)
 
 
-
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="docs/_overrides/assets/images/blueprints_banner.png">
   <source media="(prefers-color-scheme: light)" srcset="docs/_overrides/assets/images/blueprints_banner.png">

blueprints/__init__.py

@@ -1,3 +1,3 @@
 """Blueprints."""
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"

blueprints/codes/eurocode/nen_en_1992_1_1_c2_2011/chapter_4_durability_and_cover/formula_4_4n.py

@@ -0,0 +1,59 @@
+"""Formula 4.4N from NEN-EN 1992-1-1+C2:2011: Chapter 4 - Durability and cover to reinforcement."""
+
+from blueprints.codes.eurocode.nen_en_1992_1_1_c2_2011 import NEN_EN_1992_1_1_C2_2011
+from blueprints.codes.formula import Formula
+from blueprints.codes.latex_formula import LatexFormula, latex_replace_symbols
+from blueprints.type_alias import MM
+from blueprints.validations import raise_if_less_or_equal_to_zero
+
+
+class Form4Dot4NCheckExecutionTolerances(Formula):
+    r"""Class representing formula 4.4N for calculating the allowance in design for execution tolerances
+    [$\Delta c_{dev}$] [$mm$]. Used, where it can be assured that a very accurate measurement device is used
+    for monitoring and non conforming members are rejected (e.g. precast elements).
+
+    NEN-EN 1992-1-1+C2:2011 art.4.4.1.3 (3) - formula (4.4N)
+
+    Parameters
+    ----------
+    delta_cdev : MM
+        [$\Delta c_{dev}$] Concrete cover including execution tolerances [$mm$].
+    """
+
+    label = "4.4N"
+    source_document = NEN_EN_1992_1_1_C2_2011
+
+    def __init__(
+        self,
+        delta_cdev: MM,
+    ) -> None:
+        super().__init__()
+        self.delta_cdev = delta_cdev
+
+    @staticmethod
+    def _evaluate(
+        delta_cdev: MM,
+    ) -> bool:
+        """Evaluates the formula, for more information see the __init__ method."""
+        raise_if_less_or_equal_to_zero(delta_cdev=delta_cdev)
+
+        return 0 <= delta_cdev <= 10
+
+    def latex(self) -> LatexFormula:
+        """Returns LatexFormula object for formula 4.3N."""
+        _equation: str = r"0 \leq \Delta c_{dev} \leq 10"
+        _numeric_equation: str = latex_replace_symbols(
+            _equation,
+            {
+                r"\Delta c_{dev}": f"{self.delta_cdev:.3f}",
+            },
+            False,
+        )
+        return LatexFormula(
+            return_symbol=r"CHECK",
+            result="OK" if self.__bool__() else "\\text{Not OK}",
+            equation=_equation,
+            numeric_equation=_numeric_equation,
+            comparison_operator_label="\\to",
+            unit="",
+        )