foamlib 0.3.2__tar.gz → 0.3.4__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: foamlib
3
- Version: 0.3.2
3
+ Version: 0.3.4
4
4
  Summary: A Python interface for interacting with OpenFOAM
5
5
  Author-email: "Gabriel S. Gerlero" <ggerlero@cimec.unl.edu.ar>
6
6
  Project-URL: Homepage, https://github.com/gerlero/foamlib
@@ -1,6 +1,6 @@
1
1
  """A Python interface for interacting with OpenFOAM."""
2
2
 
3
- __version__ = "0.3.2"
3
+ __version__ = "0.3.4"
4
4
 
5
5
  from ._cases import AsyncFoamCase, FoamCase, FoamCaseBase
6
6
  from ._files import FoamDict, FoamFieldFile, FoamFile
@@ -32,7 +32,7 @@ from ._util import is_sequence, run_process, run_process_async
32
32
 
33
33
 
34
34
  class FoamCaseBase(Sequence["FoamCaseBase.TimeDirectory"]):
35
- def __init__(self, path: Union[Path, str]):
35
+ def __init__(self, path: Union[Path, str] = Path()):
36
36
  self.path = Path(path).absolute()
37
37
  if not self.path.is_dir():
38
38
  raise NotADirectoryError(f"{self.path} is not a directory")
@@ -87,7 +87,7 @@ class FoamCaseBase(Sequence["FoamCaseBase.TimeDirectory"]):
87
87
  return str(self.path)
88
88
 
89
89
  def __repr__(self) -> str:
90
- return f"{type(self).__name__}({self.path})"
90
+ return f"{type(self).__name__}('{self.path}')"
91
91
 
92
92
  def __str__(self) -> str:
93
93
  return str(self.path)
@@ -298,7 +298,7 @@ class FoamCaseBase(Sequence["FoamCaseBase.TimeDirectory"]):
298
298
  return str(self.path)
299
299
 
300
300
  def __repr__(self) -> str:
301
- return f"{type(self).__name__}({self.path})"
301
+ return f"{type(self).__name__}('{self.path}')"
302
302
 
303
303
  def __str__(self) -> str:
304
304
  return str(self.path)
@@ -65,7 +65,12 @@ class FoamFieldFile(FoamFile):
65
65
  ret = self["value"]
66
66
  if not isinstance(ret, (int, float, Sequence)):
67
67
  raise TypeError("value is not a field")
68
- return cast(Union[int, float, Sequence[Union[int, float]]], ret)
68
+ return cast(
69
+ Union[
70
+ int, float, Sequence[Union[int, float, Sequence[Union[int, float]]]]
71
+ ],
72
+ ret,
73
+ )
69
74
 
70
75
  @value.setter
71
76
  def value(
@@ -111,7 +116,7 @@ class FoamFieldFile(FoamFile):
111
116
  self._setitem(keywords, value)
112
117
 
113
118
  @property
114
- def dimensions(self) -> FoamFile.DimensionSet:
119
+ def dimensions(self) -> Union[FoamFile.DimensionSet, Sequence[Union[int, float]]]:
115
120
  """Alias of `self["dimensions"]`."""
116
121
  ret = self["dimensions"]
117
122
  if not isinstance(ret, FoamFile.DimensionSet):
@@ -12,7 +12,7 @@ else:
12
12
 
13
13
  from ._base import FoamDict
14
14
  from ._io import FoamFileIO
15
- from ._serialization import dumps
15
+ from ._serialization import dumpb
16
16
 
17
17
 
18
18
  class FoamFile(
@@ -84,7 +84,7 @@ class FoamFile(
84
84
  super().clear()
85
85
 
86
86
  def __repr__(self) -> str:
87
- return f"{type(self).__qualname__}({self._file}, {self._keywords})"
87
+ return f"{type(self).__qualname__}('{self._file}', {self._keywords})"
88
88
 
89
89
  def as_dict(self) -> FoamDict._Dict:
90
90
  """Return a nested dict representation of the dictionary."""
@@ -113,6 +113,10 @@ class FoamFile(
113
113
  else:
114
114
  return value # type: ignore [return-value]
115
115
 
116
+ @property
117
+ def _binary(self) -> bool:
118
+ return self.get(("FoamFile", "format"), None) == "binary"
119
+
116
120
  def _setitem(
117
121
  self,
118
122
  keywords: Union[str, Tuple[str, ...]],
@@ -134,7 +138,11 @@ class FoamFile(
134
138
  start, end = parsed.entry_location(keywords, missing_ok=True)
135
139
 
136
140
  self._write(
137
- f"{contents[:start]}\n{dumps({keywords[-1]: {}})}\n{contents[end:]}"
141
+ contents[:start]
142
+ + b"\n"
143
+ + dumpb({keywords[-1]: {}})
144
+ + b"\n"
145
+ + contents[end:]
138
146
  )
139
147
 
140
148
  for k, v in data.items():
@@ -143,7 +151,16 @@ class FoamFile(
143
151
  start, end = parsed.entry_location(keywords, missing_ok=True)
144
152
 
145
153
  self._write(
146
- f"{contents[:start]}\n{dumps({keywords[-1]: data}, assume_field=assume_field, assume_dimensions=assume_dimensions)}\n{contents[end:]}"
154
+ contents[:start]
155
+ + b"\n"
156
+ + dumpb(
157
+ {keywords[-1]: data},
158
+ assume_field=assume_field,
159
+ assume_dimensions=assume_dimensions,
160
+ binary_fields=self._binary,
161
+ )
162
+ + b"\n"
163
+ + contents[end:]
147
164
  )
148
165
 
149
166
  def __setitem__(
@@ -194,9 +211,6 @@ class FoamFile(
194
211
  def __fspath__(self) -> str:
195
212
  return str(self.path)
196
213
 
197
- def __repr__(self) -> str:
198
- return f"{type(self).__name__}({self.path})"
199
-
200
214
  def as_dict(self) -> FoamDict._Dict:
201
215
  """Return a nested dict representation of the file."""
202
216
  _, parsed = self._read()
@@ -25,7 +25,7 @@ class FoamFileIO:
25
25
  elif not self.path.is_file():
26
26
  raise FileNotFoundError(self.path)
27
27
 
28
- self.__contents: Optional[str] = None
28
+ self.__contents: Optional[bytes] = None
29
29
  self.__parsed: Optional[Parsed] = None
30
30
  self.__defer_io = 0
31
31
  self.__dirty = False
@@ -48,9 +48,9 @@ class FoamFileIO:
48
48
  self._write(self.__contents)
49
49
  assert not self.__dirty
50
50
 
51
- def _read(self) -> Tuple[str, Parsed]:
51
+ def _read(self) -> Tuple[bytes, Parsed]:
52
52
  if not self.__defer_io:
53
- contents = self.path.read_text()
53
+ contents = self.path.read_bytes()
54
54
  if contents != self.__contents:
55
55
  self.__contents = contents
56
56
  self.__parsed = None
@@ -63,11 +63,14 @@ class FoamFileIO:
63
63
 
64
64
  return self.__contents, deepcopy(self.__parsed)
65
65
 
66
- def _write(self, contents: str) -> None:
66
+ def _write(self, contents: bytes) -> None:
67
67
  self.__contents = contents
68
68
  self.__parsed = None
69
69
  if not self.__defer_io:
70
- self.path.write_text(contents)
70
+ self.path.write_bytes(contents)
71
71
  self.__dirty = False
72
72
  else:
73
73
  self.__dirty = True
74
+
75
+ def __repr__(self) -> str:
76
+ return f"{type(self).__name__}('{self.path}')"
@@ -1,3 +1,4 @@
1
+ import array
1
2
  import sys
2
3
  from typing import Tuple, Union
3
4
 
@@ -12,6 +13,7 @@ else:
12
13
  from typing import Any as EllipsisType
13
14
 
14
15
  from pyparsing import (
16
+ CharsNotIn,
15
17
  Dict,
16
18
  Forward,
17
19
  Group,
@@ -27,7 +29,7 @@ from pyparsing import (
27
29
  c_style_comment,
28
30
  common,
29
31
  cpp_style_comment,
30
- identbodychars,
32
+ identchars,
31
33
  printables,
32
34
  )
33
35
 
@@ -74,6 +76,56 @@ def _dictionary_of(
74
76
  return Dict(Group(keyword_entry)[len], asdict=not located)
75
77
 
76
78
 
79
+ _binary_contents = Forward()
80
+
81
+
82
+ def _binary_field_parse_action(tks: ParseResults) -> None:
83
+ global _binary_contents
84
+
85
+ kind, count = tks
86
+ if kind == "scalar":
87
+ elsize = 1
88
+ elif kind == "vector":
89
+ elsize = 3
90
+ elif kind == "symmTensor":
91
+ elsize = 6
92
+ elif kind == "tensor":
93
+ elsize = 9
94
+
95
+ def unpack(
96
+ tks: ParseResults,
97
+ ) -> Sequence[Union[Sequence[float], Sequence[Sequence[float]]]]:
98
+ bytes_ = tks[0].encode("latin-1")
99
+
100
+ arr = array.array("d", bytes_)
101
+
102
+ if elsize != 1:
103
+ all = [arr[i : i + elsize].tolist() for i in range(0, len(arr), elsize)]
104
+ else:
105
+ all = arr.tolist()
106
+
107
+ return [all]
108
+
109
+ _binary_contents <<= CharsNotIn(exact=count * elsize * 8).set_parse_action(unpack)
110
+
111
+ tks.clear() # type: ignore [no-untyped-call]
112
+
113
+
114
+ _BINARY_FIELD = (
115
+ (
116
+ Keyword("nonuniform").suppress()
117
+ + Literal("List").suppress()
118
+ + Literal("<").suppress()
119
+ + common.identifier
120
+ + Literal(">").suppress()
121
+ + common.integer
122
+ + Literal("(").suppress()
123
+ ).set_parse_action(_binary_field_parse_action, call_during_try=True)
124
+ + _binary_contents
125
+ + Literal(")").suppress()
126
+ )
127
+
128
+
77
129
  _SWITCH = (
78
130
  Keyword("yes") | Keyword("true") | Keyword("on") | Keyword("y") | Keyword("t")
79
131
  ).set_parse_action(lambda: True) | (
@@ -83,12 +135,14 @@ _DIMENSIONS = (
83
135
  Literal("[").suppress() + common.number * 7 + Literal("]").suppress()
84
136
  ).set_parse_action(lambda tks: FoamDict.DimensionSet(*tks))
85
137
  _TENSOR = _list_of(common.number) | common.number
86
- _IDENTIFIER = Word(identbodychars + "$", printables.replace(";", ""))
138
+ _IDENTIFIER = Word(identchars + "$", printables, exclude_chars=";")
87
139
  _DIMENSIONED = (Opt(_IDENTIFIER) + _DIMENSIONS + _TENSOR).set_parse_action(
88
140
  lambda tks: FoamDict.Dimensioned(*reversed(tks.as_list()))
89
141
  )
90
- _FIELD = (Keyword("uniform").suppress() + _TENSOR) | (
91
- Keyword("nonuniform").suppress() + _list_of(_TENSOR)
142
+ _FIELD = (
143
+ (Keyword("uniform").suppress() + _TENSOR)
144
+ | (Keyword("nonuniform").suppress() + _list_of(_TENSOR))
145
+ | _BINARY_FIELD
92
146
  )
93
147
  _TOKEN = QuotedString('"', unquote_results=False) | _IDENTIFIER
94
148
  _DATA = Forward()
@@ -109,16 +163,19 @@ _FILE = (
109
163
  .ignore(c_style_comment)
110
164
  .ignore(cpp_style_comment)
111
165
  .ignore(Literal("#include") + ... + LineEnd()) # type: ignore [no-untyped-call]
166
+ .parse_with_tabs()
112
167
  )
113
168
 
114
169
 
115
170
  class Parsed(Mapping[Tuple[str, ...], Union[FoamDict.Data, EllipsisType]]):
116
- def __init__(self, contents: str) -> None:
171
+ def __init__(self, contents: bytes) -> None:
117
172
  self._parsed: MutableMapping[
118
173
  Tuple[str, ...],
119
174
  Tuple[int, Union[FoamDict.Data, EllipsisType], int],
120
175
  ] = {}
121
- for parse_result in _FILE.parse_string(contents, parse_all=True):
176
+ for parse_result in _FILE.parse_string(
177
+ contents.decode("latin-1"), parse_all=True
178
+ ):
122
179
  self._parsed.update(self._flatten_result(parse_result))
123
180
 
124
181
  @staticmethod
@@ -0,0 +1,138 @@
1
+ import array
2
+ import itertools
3
+ import sys
4
+
5
+ if sys.version_info >= (3, 9):
6
+ from collections.abc import Mapping
7
+ else:
8
+ from typing import Mapping
9
+
10
+ from .._util import is_sequence
11
+ from ._base import FoamDict
12
+
13
+ try:
14
+ import numpy as np
15
+
16
+ numpy = True
17
+ except ModuleNotFoundError:
18
+ numpy = False
19
+
20
+
21
+ def dumpb(
22
+ data: FoamDict._SetData,
23
+ *,
24
+ assume_field: bool = False,
25
+ assume_dimensions: bool = False,
26
+ assume_data_entries: bool = False,
27
+ binary_fields: bool = False,
28
+ ) -> bytes:
29
+ if numpy and isinstance(data, np.ndarray):
30
+ return dumpb(
31
+ data.tolist(),
32
+ assume_field=assume_field,
33
+ assume_dimensions=assume_dimensions,
34
+ assume_data_entries=assume_data_entries,
35
+ binary_fields=binary_fields,
36
+ )
37
+
38
+ elif isinstance(data, Mapping):
39
+ entries = []
40
+ for k, v in data.items():
41
+ b = dumpb(
42
+ v,
43
+ assume_field=assume_field,
44
+ assume_dimensions=assume_dimensions,
45
+ assume_data_entries=True,
46
+ binary_fields=binary_fields,
47
+ )
48
+ if isinstance(v, Mapping):
49
+ entries.append(dumpb(k) + b"\n" + b"{\n" + b + b"\n}")
50
+ elif b:
51
+ entries.append(dumpb(k) + b" " + b + b";")
52
+ else:
53
+ entries.append(dumpb(k) + b";")
54
+
55
+ return b"\n".join(entries)
56
+
57
+ elif isinstance(data, FoamDict.DimensionSet) or (
58
+ assume_dimensions and is_sequence(data) and len(data) == 7
59
+ ):
60
+ return b"[" + b" ".join(dumpb(v) for v in data) + b"]"
61
+
62
+ elif assume_field and (
63
+ isinstance(data, (int, float))
64
+ or is_sequence(data)
65
+ and data
66
+ and isinstance(data[0], (int, float))
67
+ and len(data) in (3, 6, 9)
68
+ ):
69
+ return b"uniform " + dumpb(data)
70
+
71
+ elif assume_field and is_sequence(data):
72
+ if isinstance(data[0], (int, float)):
73
+ kind = b"scalar"
74
+ elif len(data[0]) == 3:
75
+ kind = b"vector"
76
+ elif len(data[0]) == 6:
77
+ kind = b"symmTensor"
78
+ elif len(data[0]) == 9:
79
+ kind = b"tensor"
80
+ else:
81
+ return dumpb(
82
+ data,
83
+ assume_dimensions=assume_dimensions,
84
+ assume_data_entries=assume_data_entries,
85
+ binary_fields=binary_fields,
86
+ )
87
+
88
+ if binary_fields:
89
+ if kind == b"scalar":
90
+ contents = b"(" + array.array("d", data).tobytes() + b")"
91
+ else:
92
+ contents = (
93
+ b"("
94
+ + array.array("d", itertools.chain.from_iterable(data)).tobytes()
95
+ + b")"
96
+ )
97
+ else:
98
+ contents = dumpb(data)
99
+
100
+ return b"nonuniform List<" + kind + b"> " + dumpb(len(data)) + contents
101
+
102
+ elif assume_data_entries and isinstance(data, tuple):
103
+ return b" ".join(
104
+ dumpb(
105
+ v,
106
+ assume_field=assume_field,
107
+ assume_dimensions=assume_dimensions,
108
+ binary_fields=binary_fields,
109
+ )
110
+ for v in data
111
+ )
112
+
113
+ elif isinstance(data, FoamDict.Dimensioned):
114
+ if data.name is not None:
115
+ return (
116
+ dumpb(data.name)
117
+ + b" "
118
+ + dumpb(data.dimensions, assume_dimensions=True)
119
+ + b" "
120
+ + dumpb(data.value)
121
+ )
122
+ else:
123
+ return (
124
+ dumpb(data.dimensions, assume_dimensions=True)
125
+ + b" "
126
+ + dumpb(data.value)
127
+ )
128
+
129
+ elif is_sequence(data):
130
+ return b"(" + b" ".join(dumpb(v) for v in data) + b")"
131
+
132
+ elif data is True:
133
+ return b"yes"
134
+ elif data is False:
135
+ return b"no"
136
+
137
+ else:
138
+ return str(data).encode("latin-1")
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: foamlib
3
- Version: 0.3.2
3
+ Version: 0.3.4
4
4
  Summary: A Python interface for interacting with OpenFOAM
5
5
  Author-email: "Gabriel S. Gerlero" <ggerlero@cimec.unl.edu.ar>
6
6
  Project-URL: Homepage, https://github.com/gerlero/foamlib
@@ -1,99 +0,0 @@
1
- import sys
2
-
3
- if sys.version_info >= (3, 9):
4
- from collections.abc import Mapping
5
- else:
6
- from typing import Mapping
7
-
8
- from .._util import is_sequence
9
- from ._base import FoamDict
10
-
11
- try:
12
- import numpy as np
13
-
14
- numpy = True
15
- except ModuleNotFoundError:
16
- numpy = False
17
-
18
-
19
- def dumps(
20
- data: FoamDict._SetData,
21
- *,
22
- assume_field: bool = False,
23
- assume_dimensions: bool = False,
24
- assume_data_entries: bool = False,
25
- ) -> str:
26
- if numpy and isinstance(data, np.ndarray):
27
- return dumps(
28
- data.tolist(),
29
- assume_field=assume_field,
30
- assume_dimensions=assume_dimensions,
31
- )
32
-
33
- elif isinstance(data, Mapping):
34
- entries = []
35
- for k, v in data.items():
36
- s = dumps(
37
- v,
38
- assume_field=assume_field,
39
- assume_dimensions=assume_dimensions,
40
- assume_data_entries=True,
41
- )
42
- if isinstance(v, Mapping):
43
- entries.append(f"{k}\n{{\n{s}\n}}")
44
- elif s:
45
- entries.append(f"{k} {s};")
46
- else:
47
- entries.append(f"{k};")
48
- return "\n".join(entries)
49
-
50
- elif isinstance(data, FoamDict.DimensionSet) or (
51
- assume_dimensions and is_sequence(data) and len(data) == 7
52
- ):
53
- return f"[{' '.join(str(v) for v in data)}]"
54
-
55
- elif assume_field and isinstance(data, (int, float)):
56
- return f"uniform {data}"
57
-
58
- elif assume_field and is_sequence(data):
59
- if isinstance(data[0], (int, float)) and len(data) in (3, 6, 9):
60
- return f"uniform {dumps(data)}"
61
- elif isinstance(data[0], (int, float)):
62
- return f"nonuniform List<scalar> {len(data)}{dumps(data)}"
63
- elif len(data[0]) == 3:
64
- return f"nonuniform List<vector> {len(data)}{dumps(data)}"
65
- elif len(data[0]) == 6:
66
- return f"nonuniform List<symmTensor> {len(data)}{dumps(data)}"
67
- elif len(data[0]) == 9:
68
- return f"nonuniform List<tensor> {len(data)}{dumps(data)}"
69
- else:
70
- return dumps(
71
- data,
72
- assume_dimensions=assume_dimensions,
73
- assume_data_entries=assume_data_entries,
74
- )
75
-
76
- elif assume_data_entries and isinstance(data, tuple):
77
- return " ".join(
78
- dumps(v, assume_field=assume_field, assume_dimensions=assume_dimensions)
79
- for v in data
80
- )
81
-
82
- elif isinstance(data, FoamDict.Dimensioned):
83
- if data.name is not None:
84
- return f"{data.name} {dumps(data.dimensions, assume_dimensions=True)} {dumps(data.value)}"
85
- else:
86
- return (
87
- f"{dumps(data.dimensions, assume_dimensions=True)} {dumps(data.value)}"
88
- )
89
-
90
- elif is_sequence(data):
91
- return f"({' '.join(dumps(v) for v in data)})"
92
-
93
- elif data is True:
94
- return "yes"
95
- elif data is False:
96
- return "no"
97
-
98
- else:
99
- return str(data)
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes