foamlib 0.6.14__py3-none-any.whl → 0.6.15__py3-none-any.whl

foamlib/__init__.py

@@ -1,6 +1,6 @@
 """A Python interface for interacting with OpenFOAM."""
 
-__version__ = "0.6.14"
+__version__ = "0.6.15"
 
 from ._cases import (
     AsyncFoamCase,

foamlib/_files/_files.py

@@ -189,6 +189,10 @@ class FoamFile(
         elif not isinstance(keywords, tuple):
             keywords = (keywords,)
 
+        if keywords and not isinstance(normalize(keywords[-1], kind=Kind.KEYWORD), str):
+            msg = f"Invalid keyword: {keywords[-1]}"
+            raise ValueError(msg)
+
         with self:
             try:
                 write_header = (
@@ -293,7 +297,7 @@ class FoamFile(
                     ...,
                     before
                     + indentation
-                    + dumps(keywords[-1])
+                    + dumps(keywords[-1], kind=Kind.KEYWORD)
                     + b"\n"
                     + indentation
                     + b"{\n"
@@ -311,7 +315,7 @@ class FoamFile(
                     normalize(data, kind=kind),
                     before
                     + indentation
-                    + dumps(keywords[-1])
+                    + dumps(keywords[-1], kind=Kind.KEYWORD)
                     + b" "
                     + dumps(data, kind=kind)
                     + b";"

foamlib/_files/_serialization.py

@@ -26,6 +26,7 @@ except ModuleNotFoundError:
 
 class Kind(Enum):
     DEFAULT = auto()
+    KEYWORD = auto()
     SINGLE_ENTRY = auto()
     ASCII_FIELD = auto()
     DOUBLE_PRECISION_BINARY_FIELD = auto()
@@ -56,11 +57,6 @@ def normalize(
         assert isinstance(ret, list)
         return ret
 
-    if kind == Kind.SINGLE_ENTRY and isinstance(data, tuple):
-        ret = normalize(list(data))
-        assert isinstance(ret, list)
-        return ret
-
     if isinstance(data, Mapping):
         return {k: normalize(v, kind=kind) for k, v in data.items()}
 
@@ -73,22 +69,43 @@ def normalize(
         data = cast(Sequence[float], data)
         return FoamFileBase.DimensionSet(*data)
 
-    if is_sequence(data) and not isinstance(data, tuple):
+    if is_sequence(data) and (kind == Kind.SINGLE_ENTRY or not isinstance(data, tuple)):
         return [normalize(d, kind=Kind.SINGLE_ENTRY) for d in data]
 
     if isinstance(data, str):
+        data = data.strip()
+
+        if data.startswith("(") and data.endswith(")"):
+            data = data[1:-1].split()
+            if kind == Kind.KEYWORD:
+                return "(" + " ".join(data) + ")"
+            return [normalize(d, kind=Kind.SINGLE_ENTRY) for d in data]
+
+        if data.startswith("[") and data.endswith("]"):
+            data = data[1:-1].split()
+            return normalize(data, kind=Kind.DIMENSIONS)
+
         with contextlib.suppress(ValueError):
             return int(data)
 
         with contextlib.suppress(ValueError):
             return float(data)
 
+        if kind != Kind.KEYWORD:
+            if data in ("yes", "true", "on", "y", "t"):
+                return True
+            if data in ("no", "false", "off", "n", "f"):
+                return False
+
         tokens: list[str] = re.findall(_TOKENS, data)
 
         if len(tokens) == 1:
             return tokens[0]
 
-        return tuple(tokens) if kind != Kind.SINGLE_ENTRY else " ".join(tokens)
+        if kind == Kind.KEYWORD:
+            return " ".join(tokens)
+
+        return tuple(tokens)
 
     if isinstance(data, FoamFileBase.Dimensioned):
         value = normalize(data.value, kind=Kind.SINGLE_ENTRY)
@@ -115,12 +132,15 @@ def dumps(
     if isinstance(data, Mapping):
         entries = []
         for k, v in data.items():
-            if isinstance(v, Mapping):
-                entries.append(dumps(k) + b" {" + dumps(v) + b"}")
-            elif not v:
-                entries.append(dumps(k) + b";")
+            value = normalize(v)
+            if isinstance(value, Mapping):
+                entries.append(
+                    dumps(k, kind=Kind.KEYWORD) + b" {" + dumps(value) + b"}"
+                )
+            elif not value:
+                entries.append(dumps(k, kind=Kind.KEYWORD) + b";")
             else:
-                entries.append(dumps(k) + b" " + dumps(v) + b";")
+                entries.append(dumps(k, kind=Kind.KEYWORD) + b" " + dumps(value) + b";")
 
         return b" ".join(entries)
 

{foamlib-0.6.14.dist-info → foamlib-0.6.15.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: foamlib
-Version: 0.6.14
+Version: 0.6.15
 Summary: A Python interface for interacting with OpenFOAM
 Author-email: "Gabriel S. Gerlero" <ggerlero@cimec.unl.edu.ar>
 Project-URL: Homepage, https://github.com/gerlero/foamlib
@@ -169,21 +169,20 @@ U = FoamFieldFile(Path(my_pitz) / "0/U")
 print(U.internal_field)
 ```
 
-### 🔁 Run an optimization loop in parallel
+### 🔁 Run an optimization loop on a Slurm-based cluster
 
 ```python
 import os
 from pathlib import Path
-from foamlib import AsyncFoamCase
+from foamlib import AsyncSlurmFoamCase
 from scipy.optimize import differential_evolution
 
-base = AsyncFoamCase(Path(os.environ["FOAM_TUTORIALS"]) / "incompressible/simpleFoam/pitzDaily")
-# Replace with `AsyncSlurmFoamCase` if on a cluster and you want cases to be run as Slurm jobs
+base = AsyncSlurmFoamCase(Path(os.environ["FOAM_TUTORIALS"]) / "incompressible/simpleFoam/pitzDaily")
 
 async def cost(x):
     async with base.clone() as clone:
         clone[0]["U"].boundary_field["inlet"].value = [x[0], 0, 0]
-        await clone.run()
+        await clone.run(fallback=True) # Run locally if Slurm is not available
         return abs(clone[-1]["U"].internal_field[0][0])
 
 result = differential_evolution(cost, bounds=[(-1, 1)], workers=AsyncFoamCase.map, polish=False)

{foamlib-0.6.14.dist-info → foamlib-0.6.15.dist-info}/RECORD

@@ -1,4 +1,4 @@
-foamlib/__init__.py,sha256=2TB7NPVimWOf7GSEz5g_Gbguf3RJvD-eOWA0ykCCwLM,487
+foamlib/__init__.py,sha256=xxPlBXMsaxIeBwjjYk7kczK-LfoxBgDNnCG96cQcYss,487
 foamlib/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 foamlib/_cases/__init__.py,sha256=wTUHcUgU1CBgpu0cUMtksQ5VKG6B8CFu9xc3dWwsQuo,358
 foamlib/_cases/_async.py,sha256=i6g4EBHqvI-1PkdrxsRto2ynW7sxsOga2bSYk1XVG1U,7795
@@ -10,13 +10,13 @@ foamlib/_cases/_sync.py,sha256=2BJXB7Nzldb4OgPukqupgYqdceUGkI2mYhhtGPWEBrc,5901
 foamlib/_cases/_util.py,sha256=lhVca3ERY0zwYjDam6W2QMROt0yX5vAF-9_DS5RuMbM,1547
 foamlib/_files/__init__.py,sha256=-UqB9YTH6mrJfXCX00kPTAAY20XG64u1MGPw_1ewLVs,148
 foamlib/_files/_base.py,sha256=ZY_6Zxr3LZHVzJEex6SUTi9Pgo7Oi7i3Jo-wre9G3yE,1968
-foamlib/_files/_files.py,sha256=oYRlMfCUH9oNeu-yf2HAPmLxLHteIe7gHhsWXdn7wU0,15767
+foamlib/_files/_files.py,sha256=5BUOHGDPaa4naNVQtpnDyhDzjY6s4Pg726DQOFNuHjs,15982
 foamlib/_files/_io.py,sha256=IQLqoqnA1TpHf21NbUho2wsYWevyqC6MKo-wfpaObUU,2226
 foamlib/_files/_parsing.py,sha256=sJ7XadWFqmJTaL9TEYyaYEu3r-CQweruwPUNWIZt4i0,14165
-foamlib/_files/_serialization.py,sha256=p2yRpyyOAOKP7P6T7BLEgRVvORuzQEcv_P6dEsOZ9_8,5981
+foamlib/_files/_serialization.py,sha256=vfvSZqg0QTaoTJlZ9NacQ2HqmjaMGdtoUPZvsgMt14o,6680
 foamlib/_files/_util.py,sha256=VXUTD0B3NbnlaE_KCqWzrFcWvBz_2JfnIWpNp3snX3Y,526
-foamlib-0.6.14.dist-info/LICENSE.txt,sha256=5Dte9TUnLZzPRs4NQzl-Jc2-Ljd-t_v0ZR5Ng5r0UsY,35131
-foamlib-0.6.14.dist-info/METADATA,sha256=Um-3D8v1EnQPeX-pAySWkM-SWVBgTPIiLgKd4Ewq3RY,7742
-foamlib-0.6.14.dist-info/WHEEL,sha256=P9jw-gEje8ByB7_hXoICnHtVCrEwMQh-630tKvQWehc,91
-foamlib-0.6.14.dist-info/top_level.txt,sha256=ZdVYtetXGwPwyfL-WhlhbTFQGAwKX5P_gXxtH9JYFPI,8
-foamlib-0.6.14.dist-info/RECORD,,
+foamlib-0.6.15.dist-info/LICENSE.txt,sha256=5Dte9TUnLZzPRs4NQzl-Jc2-Ljd-t_v0ZR5Ng5r0UsY,35131
+foamlib-0.6.15.dist-info/METADATA,sha256=eKZCMgAleMnArxpnqxN1eoepxqjBvA9yBhl1SBM8vE4,7723
+foamlib-0.6.15.dist-info/WHEEL,sha256=a7TGlA-5DaHMRrarXjVbQagU3Man_dCnGIWMJr5kRWo,91
+foamlib-0.6.15.dist-info/top_level.txt,sha256=ZdVYtetXGwPwyfL-WhlhbTFQGAwKX5P_gXxtH9JYFPI,8
+foamlib-0.6.15.dist-info/RECORD,,

{foamlib-0.6.14.dist-info → foamlib-0.6.15.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.3.0)
+Generator: setuptools (75.4.0)
 Root-Is-Purelib: true
 Tag: py3-none-any