omlish 0.0.0.dev153__py3-none-any.whl → 0.0.0.dev155__py3-none-any.whl
Sign up to get free protection for your applications and to get access to all the features.
- omlish/__about__.py +2 -2
- omlish/io/fdio/__init__.py +1 -0
- omlish/lite/asyncio/subprocesses.py +17 -5
- omlish/lite/check.py +0 -2
- omlish/lite/contextmanagers.py +14 -0
- omlish/lite/marshal.py +11 -5
- omlish/os/linux.py +484 -0
- omlish/term.py +29 -14
- {omlish-0.0.0.dev153.dist-info → omlish-0.0.0.dev155.dist-info}/METADATA +1 -1
- {omlish-0.0.0.dev153.dist-info → omlish-0.0.0.dev155.dist-info}/RECORD +14 -13
- {omlish-0.0.0.dev153.dist-info → omlish-0.0.0.dev155.dist-info}/LICENSE +0 -0
- {omlish-0.0.0.dev153.dist-info → omlish-0.0.0.dev155.dist-info}/WHEEL +0 -0
- {omlish-0.0.0.dev153.dist-info → omlish-0.0.0.dev155.dist-info}/entry_points.txt +0 -0
- {omlish-0.0.0.dev153.dist-info → omlish-0.0.0.dev155.dist-info}/top_level.txt +0 -0
omlish/__about__.py
CHANGED
omlish/io/fdio/__init__.py
CHANGED
@@ -0,0 +1 @@
|
|
1
|
+
# @omlish-lite
|
@@ -2,6 +2,7 @@
|
|
2
2
|
import asyncio.base_subprocess
|
3
3
|
import asyncio.subprocess
|
4
4
|
import contextlib
|
5
|
+
import dataclasses as dc
|
5
6
|
import functools
|
6
7
|
import logging
|
7
8
|
import subprocess
|
@@ -177,6 +178,13 @@ async def asyncio_subprocess_communicate(
|
|
177
178
|
return await AsyncioProcessCommunicator(proc).communicate(input, timeout) # noqa
|
178
179
|
|
179
180
|
|
181
|
+
@dc.dataclass(frozen=True)
|
182
|
+
class AsyncioSubprocessOutput:
|
183
|
+
proc: asyncio.subprocess.Process
|
184
|
+
stdout: ta.Optional[bytes]
|
185
|
+
stderr: ta.Optional[bytes]
|
186
|
+
|
187
|
+
|
180
188
|
async def asyncio_subprocess_run(
|
181
189
|
*args: str,
|
182
190
|
input: ta.Any = None, # noqa
|
@@ -184,7 +192,7 @@ async def asyncio_subprocess_run(
|
|
184
192
|
check: bool = False, # noqa
|
185
193
|
capture_output: ta.Optional[bool] = None,
|
186
194
|
**kwargs: ta.Any,
|
187
|
-
) ->
|
195
|
+
) -> AsyncioSubprocessOutput:
|
188
196
|
if capture_output:
|
189
197
|
kwargs.setdefault('stdout', subprocess.PIPE)
|
190
198
|
kwargs.setdefault('stderr', subprocess.PIPE)
|
@@ -203,7 +211,11 @@ async def asyncio_subprocess_run(
|
|
203
211
|
stderr=stderr,
|
204
212
|
)
|
205
213
|
|
206
|
-
return
|
214
|
+
return AsyncioSubprocessOutput(
|
215
|
+
proc,
|
216
|
+
stdout,
|
217
|
+
stderr,
|
218
|
+
)
|
207
219
|
|
208
220
|
|
209
221
|
##
|
@@ -216,7 +228,7 @@ async def asyncio_subprocess_check_call(
|
|
216
228
|
timeout: ta.Optional[float] = None,
|
217
229
|
**kwargs: ta.Any,
|
218
230
|
) -> None:
|
219
|
-
|
231
|
+
await asyncio_subprocess_run(
|
220
232
|
*args,
|
221
233
|
stdout=stdout,
|
222
234
|
input=input,
|
@@ -232,7 +244,7 @@ async def asyncio_subprocess_check_output(
|
|
232
244
|
timeout: ta.Optional[float] = None,
|
233
245
|
**kwargs: ta.Any,
|
234
246
|
) -> bytes:
|
235
|
-
|
247
|
+
out = await asyncio_subprocess_run(
|
236
248
|
*args,
|
237
249
|
stdout=asyncio.subprocess.PIPE,
|
238
250
|
input=input,
|
@@ -241,7 +253,7 @@ async def asyncio_subprocess_check_output(
|
|
241
253
|
**kwargs,
|
242
254
|
)
|
243
255
|
|
244
|
-
return check.not_none(stdout)
|
256
|
+
return check.not_none(out.stdout)
|
245
257
|
|
246
258
|
|
247
259
|
async def asyncio_subprocess_check_output_str(*args: str, **kwargs: ta.Any) -> str:
|
omlish/lite/check.py
CHANGED
omlish/lite/contextmanagers.py
CHANGED
@@ -61,3 +61,17 @@ def attr_setting(obj, attr, val, *, default=None): # noqa
|
|
61
61
|
delattr(obj, attr)
|
62
62
|
else:
|
63
63
|
setattr(obj, attr, orig)
|
64
|
+
|
65
|
+
|
66
|
+
##
|
67
|
+
|
68
|
+
|
69
|
+
class aclosing(contextlib.AbstractAsyncContextManager): # noqa
|
70
|
+
def __init__(self, thing):
|
71
|
+
self.thing = thing
|
72
|
+
|
73
|
+
async def __aenter__(self):
|
74
|
+
return self.thing
|
75
|
+
|
76
|
+
async def __aexit__(self, *exc_info):
|
77
|
+
await self.thing.aclose()
|
omlish/lite/marshal.py
CHANGED
@@ -1,7 +1,8 @@
|
|
1
1
|
"""
|
2
2
|
TODO:
|
3
3
|
- pickle stdlib objs? have to pin to 3.8 pickle protocol, will be cross-version
|
4
|
-
-
|
4
|
+
- namedtuple
|
5
|
+
- literals
|
5
6
|
"""
|
6
7
|
# ruff: noqa: UP006 UP007
|
7
8
|
import abc
|
@@ -23,6 +24,7 @@ from .reflect import deep_subclasses
|
|
23
24
|
from .reflect import get_optional_alias_arg
|
24
25
|
from .reflect import is_generic_alias
|
25
26
|
from .reflect import is_union_alias
|
27
|
+
from .strings import snake_case
|
26
28
|
|
27
29
|
|
28
30
|
T = ta.TypeVar('T')
|
@@ -314,14 +316,18 @@ class ObjMarshalerManager:
|
|
314
316
|
) -> ObjMarshaler:
|
315
317
|
if isinstance(ty, type):
|
316
318
|
if abc.ABC in ty.__bases__:
|
317
|
-
|
319
|
+
impls = [ity for ity in deep_subclasses(ty) if abc.ABC not in ity.__bases__] # type: ignore
|
320
|
+
if all(ity.__qualname__.endswith(ty.__name__) for ity in impls):
|
321
|
+
ins = {ity: snake_case(ity.__qualname__[:-len(ty.__name__)]) for ity in impls}
|
322
|
+
else:
|
323
|
+
ins = {ity: ity.__qualname__ for ity in impls}
|
324
|
+
return PolymorphicObjMarshaler.of([
|
318
325
|
PolymorphicObjMarshaler.Impl(
|
319
326
|
ity,
|
320
|
-
|
327
|
+
itn,
|
321
328
|
rec(ity),
|
322
329
|
)
|
323
|
-
for ity in
|
324
|
-
if abc.ABC not in ity.__bases__
|
330
|
+
for ity, itn in ins.items()
|
325
331
|
])
|
326
332
|
|
327
333
|
if issubclass(ty, enum.Enum):
|
omlish/os/linux.py
ADDED
@@ -0,0 +1,484 @@
|
|
1
|
+
# ruff: noqa: UP006 UP007
|
2
|
+
# @omlish-lite
|
3
|
+
"""
|
4
|
+
➜ ~ cat /etc/os-release
|
5
|
+
NAME="Amazon Linux"
|
6
|
+
VERSION="2"
|
7
|
+
ID="amzn"
|
8
|
+
ID_LIKE="centos rhel fedora"
|
9
|
+
VERSION_ID="2"
|
10
|
+
PRETTY_NAME="Amazon Linux 2"
|
11
|
+
|
12
|
+
➜ ~ cat /etc/os-release
|
13
|
+
PRETTY_NAME="Ubuntu 22.04.5 LTS"
|
14
|
+
NAME="Ubuntu"
|
15
|
+
VERSION_ID="22.04"
|
16
|
+
VERSION="22.04.5 LTS (Jammy Jellyfish)"
|
17
|
+
VERSION_CODENAME=jammy
|
18
|
+
ID=ubuntu
|
19
|
+
ID_LIKE=debian
|
20
|
+
UBUNTU_CODENAME=jammy
|
21
|
+
|
22
|
+
➜ omlish git:(master) docker run -i python:3.12 cat /etc/os-release
|
23
|
+
PRETTY_NAME="Debian GNU/Linux 12 (bookworm)"
|
24
|
+
NAME="Debian GNU/Linux"
|
25
|
+
VERSION_ID="12"
|
26
|
+
VERSION="12 (bookworm)"
|
27
|
+
VERSION_CODENAME=bookworm
|
28
|
+
ID=debian
|
29
|
+
"""
|
30
|
+
import dataclasses as dc
|
31
|
+
import os.path
|
32
|
+
import typing as ta
|
33
|
+
|
34
|
+
|
35
|
+
@dc.dataclass(frozen=True)
|
36
|
+
class LinuxOsRelease:
|
37
|
+
"""
|
38
|
+
https://man7.org/linux/man-pages/man5/os-release.5.html
|
39
|
+
"""
|
40
|
+
|
41
|
+
raw: ta.Mapping[str, str]
|
42
|
+
|
43
|
+
# General information identifying the operating system
|
44
|
+
|
45
|
+
@property
|
46
|
+
def name(self) -> str:
|
47
|
+
"""
|
48
|
+
A string identifying the operating system, without a version component, and suitable for presentation to the
|
49
|
+
user. If not set, a default of "NAME=Linux" may be used.
|
50
|
+
|
51
|
+
Examples: "NAME=Fedora", "NAME="Debian GNU/Linux"".
|
52
|
+
"""
|
53
|
+
|
54
|
+
return self.raw['NAME']
|
55
|
+
|
56
|
+
@property
|
57
|
+
def id(self) -> str:
|
58
|
+
"""
|
59
|
+
A lower-case string (no spaces or other characters outside of 0-9, a-z, ".", "_" and "-") identifying the
|
60
|
+
operating system, excluding any version information and suitable for processing by scripts or usage in generated
|
61
|
+
filenames. If not set, a default of "ID=linux" may be used. Note that even though this string may not include
|
62
|
+
characters that require shell quoting, quoting may nevertheless be used.
|
63
|
+
|
64
|
+
Examples: "ID=fedora", "ID=debian".
|
65
|
+
"""
|
66
|
+
|
67
|
+
return self.raw['ID']
|
68
|
+
|
69
|
+
@property
|
70
|
+
def id_like(self) -> str:
|
71
|
+
"""
|
72
|
+
A space-separated list of operating system identifiers in the same syntax as the ID= setting. It should list
|
73
|
+
identifiers of operating systems that are closely related to the local operating system in regards to packaging
|
74
|
+
and programming interfaces, for example listing one or more OS identifiers the local OS is a derivative from. An
|
75
|
+
OS should generally only list other OS identifiers it itself is a derivative of, and not any OSes that are
|
76
|
+
derived from it, though symmetric relationships are possible. Build scripts and similar should check this
|
77
|
+
variable if they need to identify the local operating system and the value of ID= is not recognized. Operating
|
78
|
+
systems should be listed in order of how closely the local operating system relates to the listed ones, starting
|
79
|
+
with the closest. This field is optional.
|
80
|
+
|
81
|
+
Examples: for an operating system with "ID=centos", an assignment of "ID_LIKE="rhel fedora"" would be
|
82
|
+
appropriate. For an operating system with "ID=ubuntu", an assignment of "ID_LIKE=debian" is appropriate.
|
83
|
+
"""
|
84
|
+
|
85
|
+
return self.raw['ID_LIKE']
|
86
|
+
|
87
|
+
@property
|
88
|
+
def pretty_name(self) -> str:
|
89
|
+
"""
|
90
|
+
A pretty operating system name in a format suitable for presentation to the user. May or may not contain a
|
91
|
+
release code name or OS version of some kind, as suitable. If not set, a default of "PRETTY_NAME="Linux"" may be
|
92
|
+
used
|
93
|
+
|
94
|
+
Example: "PRETTY_NAME="Fedora 17 (Beefy Miracle)"".
|
95
|
+
"""
|
96
|
+
|
97
|
+
return self.raw['PRETTY_NAME']
|
98
|
+
|
99
|
+
@property
|
100
|
+
def cpe_name(self) -> str:
|
101
|
+
"""
|
102
|
+
A CPE name for the operating system, in URI binding syntax, following the Common Platform Enumeration
|
103
|
+
Specification[4] as proposed by the NIST. This field is optional.
|
104
|
+
|
105
|
+
Example: "CPE_NAME="cpe:/o:fedoraproject:fedora:17""
|
106
|
+
"""
|
107
|
+
|
108
|
+
return self.raw['CPE_NAME']
|
109
|
+
|
110
|
+
@property
|
111
|
+
def variant(self) -> str:
|
112
|
+
"""
|
113
|
+
A string identifying a specific variant or edition of the operating system suitable for presentation to the
|
114
|
+
user. This field may be used to inform the user that the configuration of this system is subject to a specific
|
115
|
+
divergent set of rules or default configuration settings. This field is optional and may not be implemented on
|
116
|
+
all systems.
|
117
|
+
|
118
|
+
Examples: "VARIANT="Server Edition"", "VARIANT="Smart Refrigerator Edition"".
|
119
|
+
|
120
|
+
Note: this field is for display purposes only. The VARIANT_ID field should be used for making programmatic
|
121
|
+
decisions.
|
122
|
+
|
123
|
+
Added in version 220.
|
124
|
+
"""
|
125
|
+
|
126
|
+
return self.raw['VARIANT']
|
127
|
+
|
128
|
+
@property
|
129
|
+
def variant_id(self) -> str:
|
130
|
+
"""
|
131
|
+
A lower-case string (no spaces or other characters outside of 0-9, a-z, ".", "_" and "-"), identifying a
|
132
|
+
specific variant or edition of the operating system. This may be interpreted by other packages in order to
|
133
|
+
determine a divergent default configuration. This field is optional and may not be implemented on all systems.
|
134
|
+
|
135
|
+
Examples: "VARIANT_ID=server", "VARIANT_ID=embedded".
|
136
|
+
|
137
|
+
Added in version 220.
|
138
|
+
"""
|
139
|
+
|
140
|
+
return self.raw['variant_id']
|
141
|
+
|
142
|
+
# Information about the version of the operating system
|
143
|
+
|
144
|
+
@property
|
145
|
+
def version(self) -> str:
|
146
|
+
"""
|
147
|
+
A string identifying the operating system version, excluding any OS name information, possibly including a
|
148
|
+
release code name, and suitable for presentation to the user. This field is optional.
|
149
|
+
|
150
|
+
Examples: "VERSION=17", "VERSION="17 (Beefy Miracle)"".
|
151
|
+
"""
|
152
|
+
|
153
|
+
return self.raw['VERSION']
|
154
|
+
|
155
|
+
@property
|
156
|
+
def version_id(self) -> str:
|
157
|
+
"""
|
158
|
+
A lower-case string (mostly numeric, no spaces or other characters outside of 0-9, a-z, ".", "_" and "-")
|
159
|
+
identifying the operating system version, excluding any OS name information or release code name, and suitable
|
160
|
+
for processing by scripts or usage in generated filenames. This field is optional.
|
161
|
+
|
162
|
+
Examples: "VERSION_ID=17", "VERSION_ID=11.04".
|
163
|
+
"""
|
164
|
+
|
165
|
+
return self.raw['VERSION_ID']
|
166
|
+
|
167
|
+
@property
|
168
|
+
def version_codename(self) -> str:
|
169
|
+
"""
|
170
|
+
A lower-case string (no spaces or other characters outside of 0-9, a-z, ".", "_" and "-") identifying the
|
171
|
+
operating system release code name, excluding any OS name information or release version, and suitable for
|
172
|
+
processing by scripts or usage in generated filenames. This field is optional and may not be implemented on all
|
173
|
+
systems.
|
174
|
+
|
175
|
+
Examples: "VERSION_CODENAME=buster", "VERSION_CODENAME=xenial".
|
176
|
+
|
177
|
+
Added in version 231.
|
178
|
+
"""
|
179
|
+
|
180
|
+
return self.raw['VERSION_CODENAME']
|
181
|
+
|
182
|
+
@property
|
183
|
+
def build_id(self) -> str:
|
184
|
+
"""
|
185
|
+
A string uniquely identifying the system image originally used as the installation base. In most cases,
|
186
|
+
VERSION_ID or IMAGE_ID+IMAGE_VERSION are updated when the entire system image is replaced during an update.
|
187
|
+
BUILD_ID may be used in distributions where the original installation image version is important: VERSION_ID
|
188
|
+
would change during incremental system updates, but BUILD_ID would not. This field is optional.
|
189
|
+
|
190
|
+
Examples: "BUILD_ID="2013-03-20.3"", "BUILD_ID=201303203".
|
191
|
+
|
192
|
+
Added in version 200.
|
193
|
+
"""
|
194
|
+
|
195
|
+
return self.raw['BUILD_ID']
|
196
|
+
|
197
|
+
@property
|
198
|
+
def image_id(self) -> str:
|
199
|
+
"""
|
200
|
+
A lower-case string (no spaces or other characters outside of 0-9, a-z, ".", "_" and "-"), identifying a
|
201
|
+
specific image of the operating system. This is supposed to be used for environments where OS images are
|
202
|
+
prepared, built, shipped and updated as comprehensive, consistent OS images. This field is optional and may not
|
203
|
+
be implemented on all systems, in particularly not on those that are not managed via images but put together and
|
204
|
+
updated from individual packages and on the local system.
|
205
|
+
|
206
|
+
Examples: "IMAGE_ID=vendorx-cashier-system", "IMAGE_ID=netbook-image".
|
207
|
+
|
208
|
+
Added in version 249.
|
209
|
+
"""
|
210
|
+
|
211
|
+
return self.raw['IMAGE_ID']
|
212
|
+
|
213
|
+
@property
|
214
|
+
def image_version(self) -> str:
|
215
|
+
"""
|
216
|
+
A lower-case string (mostly numeric, no spaces or other characters outside of 0-9, a-z, ".", "_" and "-")
|
217
|
+
identifying the OS image version. This is supposed to be used together with IMAGE_ID described above, to discern
|
218
|
+
different versions of the same image.
|
219
|
+
|
220
|
+
Examples: "IMAGE_VERSION=33", "IMAGE_VERSION=47.1rc1".
|
221
|
+
|
222
|
+
Added in version 249.
|
223
|
+
"""
|
224
|
+
|
225
|
+
return self.raw['IMAGE_VERSION']
|
226
|
+
|
227
|
+
# To summarize: if the image updates are built and shipped as comprehensive units, IMAGE_ID+IMAGE_VERSION is the
|
228
|
+
# best fit. Otherwise, if updates eventually completely replace previously installed contents, as in a typical
|
229
|
+
# binary distribution, VERSION_ID should be used to identify major releases of the operating system. BUILD_ID may
|
230
|
+
# be used instead or in addition to VERSION_ID when the original system image version is important.
|
231
|
+
|
232
|
+
#
|
233
|
+
|
234
|
+
# Presentation information and links
|
235
|
+
|
236
|
+
# Links to resources on the Internet related to the operating system. HOME_URL= should refer to the homepage of the
|
237
|
+
# operating system, or alternatively some homepage of the specific version of the operating system.
|
238
|
+
# DOCUMENTATION_URL= should refer to the main documentation page for this operating system. SUPPORT_URL= should
|
239
|
+
# refer to the main support page for the operating system, if there is any. This is primarily intended for operating
|
240
|
+
# systems which vendors provide support for. BUG_REPORT_URL= should refer to the main bug reporting page for the
|
241
|
+
# operating system, if there is any. This is primarily intended for operating systems that rely on community QA.
|
242
|
+
# PRIVACY_POLICY_URL= should refer to the main privacy policy page for the operating system, if there is any. These
|
243
|
+
# settings are optional, and providing only some of these settings is common. These URLs are intended to be exposed
|
244
|
+
# in "About this system" UIs behind links with captions such as "About this Operating System", "Obtain Support",
|
245
|
+
# "Report a Bug", or "Privacy Policy". The values should be in RFC3986 format[5], and should be "http:" or "https:"
|
246
|
+
# URLs, and possibly "mailto:" or "tel:". Only one URL shall be listed in each setting. If multiple resources need
|
247
|
+
# to be referenced, it is recommended to provide an online landing page linking all available resources.
|
248
|
+
|
249
|
+
# Examples: "HOME_URL="https://fedoraproject.org/"", "BUG_REPORT_URL="https://bugzilla.redhat.com/"".
|
250
|
+
|
251
|
+
@property
|
252
|
+
def home_url(self) -> str:
|
253
|
+
return self.raw['HOME_URL']
|
254
|
+
|
255
|
+
@property
|
256
|
+
def documentation_url(self) -> str:
|
257
|
+
return self.raw['DOCUMENTATION_URL']
|
258
|
+
|
259
|
+
@property
|
260
|
+
def support_url(self) -> str:
|
261
|
+
return self.raw['SUPPORT_URL']
|
262
|
+
|
263
|
+
@property
|
264
|
+
def bug_report_url(self) -> str:
|
265
|
+
return self.raw['BUG_REPORT_URL']
|
266
|
+
|
267
|
+
@property
|
268
|
+
def privacy_policy_url(self) -> str:
|
269
|
+
return self.raw['PRIVACY_POLICY_URL']
|
270
|
+
|
271
|
+
@property
|
272
|
+
def support_end(self) -> str:
|
273
|
+
"""
|
274
|
+
The date at which support for this version of the OS ends. (What exactly "lack of support" means varies between
|
275
|
+
vendors, but generally users should assume that updates, including security fixes, will not be provided.) The
|
276
|
+
value is a date in the ISO 8601 format "YYYY-MM-DD", and specifies the first day on which support is not
|
277
|
+
provided.
|
278
|
+
|
279
|
+
For example, "SUPPORT_END=2001-01-01" means that the system was supported until the end of the last day of the
|
280
|
+
previous millennium.
|
281
|
+
|
282
|
+
Added in version 252.
|
283
|
+
"""
|
284
|
+
|
285
|
+
return self.raw['SUPPORT_END']
|
286
|
+
|
287
|
+
@property
|
288
|
+
def logo(self) -> str:
|
289
|
+
"""
|
290
|
+
A string, specifying the name of an icon as defined by freedesktop.org Icon Theme Specification[6]. This can be
|
291
|
+
used by graphical applications to display an operating system's or distributor's logo. This field is optional
|
292
|
+
and may not necessarily be implemented on all systems.
|
293
|
+
|
294
|
+
Examples: "LOGO=fedora-logo", "LOGO=distributor-logo-opensuse"
|
295
|
+
|
296
|
+
Added in version 240.
|
297
|
+
"""
|
298
|
+
|
299
|
+
return self.raw['LOGO']
|
300
|
+
|
301
|
+
@property
|
302
|
+
def ansi_color(self) -> str:
|
303
|
+
"""
|
304
|
+
A suggested presentation color when showing the OS name on the console. This should be specified as string
|
305
|
+
suitable for inclusion in the ESC [ m ANSI/ECMA-48 escape code for setting graphical rendition. This field is
|
306
|
+
optional.
|
307
|
+
|
308
|
+
Examples: "ANSI_COLOR="0;31"" for red, "ANSI_COLOR="1;34"" for light blue, or "ANSI_COLOR="0;38;2;60;110;180""
|
309
|
+
for Fedora blue.
|
310
|
+
"""
|
311
|
+
|
312
|
+
return self.raw['ANSI_COLOR']
|
313
|
+
|
314
|
+
@property
|
315
|
+
def vendor_name(self) -> str:
|
316
|
+
"""
|
317
|
+
The name of the OS vendor. This is the name of the organization or company which produces the OS. This field is
|
318
|
+
optional.
|
319
|
+
|
320
|
+
This name is intended to be exposed in "About this system" UIs or software update UIs when needed to distinguish
|
321
|
+
the OS vendor from the OS itself. It is intended to be human readable.
|
322
|
+
|
323
|
+
Examples: "VENDOR_NAME="Fedora Project"" for Fedora Linux, "VENDOR_NAME="Canonical"" for Ubuntu.
|
324
|
+
|
325
|
+
Added in version 254.
|
326
|
+
"""
|
327
|
+
|
328
|
+
return self.raw['VENDOR_NAME']
|
329
|
+
|
330
|
+
@property
|
331
|
+
def vendor_url(self) -> str:
|
332
|
+
"""
|
333
|
+
The homepage of the OS vendor. This field is optional. The VENDOR_NAME= field should be set if this one is,
|
334
|
+
although clients must be robust against either field not being set.
|
335
|
+
|
336
|
+
The value should be in RFC3986 format[5], and should be "http:" or "https:" URLs. Only one URL shall be listed
|
337
|
+
in the setting.
|
338
|
+
|
339
|
+
Examples: "VENDOR_URL="https://fedoraproject.org/"", "VENDOR_URL="https://canonical.com/"".
|
340
|
+
|
341
|
+
Added in version 254.
|
342
|
+
"""
|
343
|
+
|
344
|
+
return self.raw['VENDOR_URL']
|
345
|
+
|
346
|
+
# Distribution-level defaults and metadata
|
347
|
+
|
348
|
+
@property
|
349
|
+
def default_hostname(self) -> str:
|
350
|
+
"""
|
351
|
+
A string specifying the hostname if hostname(5) is not present and no other configuration source specifies the
|
352
|
+
hostname. Must be either a single DNS label (a string composed of 7-bit ASCII lower-case characters and no
|
353
|
+
spaces or dots, limited to the format allowed for DNS domain name labels), or a sequence of such labels
|
354
|
+
separated by single dots that forms a valid DNS FQDN. The hostname must be at most 64 characters, which is a
|
355
|
+
Linux limitation (DNS allows longer names).
|
356
|
+
|
357
|
+
See org.freedesktop.hostname1(5) for a description of how systemd-hostnamed.service(8) determines the fallback
|
358
|
+
hostname.
|
359
|
+
|
360
|
+
Added in version 248.
|
361
|
+
"""
|
362
|
+
|
363
|
+
return self.raw['DEFAULT_HOSTNAME']
|
364
|
+
|
365
|
+
@property
|
366
|
+
def architecture(self) -> str:
|
367
|
+
"""
|
368
|
+
A string that specifies which CPU architecture the userspace binaries require. The architecture identifiers are
|
369
|
+
the same as for ConditionArchitecture= described in systemd.unit(5). The field is optional and should only be
|
370
|
+
used when just single architecture is supported. It may provide redundant information when used in a GPT
|
371
|
+
partition with a GUID type that already encodes the architecture. If this is not the case, the architecture
|
372
|
+
should be specified in e.g., an extension image, to prevent an incompatible host from loading it.
|
373
|
+
|
374
|
+
Added in version 252.
|
375
|
+
"""
|
376
|
+
|
377
|
+
return self.raw['ARCHITECTURE']
|
378
|
+
|
379
|
+
@property
|
380
|
+
def sysext_level(self) -> str:
|
381
|
+
"""
|
382
|
+
A lower-case string (mostly numeric, no spaces or other characters outside of 0-9, a-z, ".", "_" and "-")
|
383
|
+
identifying the operating system extensions support level, to indicate which extension images are supported. See
|
384
|
+
/usr/lib/extension-release.d/extension-release.IMAGE, initrd[2] and systemd-sysext(8)) for more information.
|
385
|
+
|
386
|
+
Examples: "SYSEXT_LEVEL=2", "SYSEXT_LEVEL=15.14".
|
387
|
+
|
388
|
+
Added in version 248.
|
389
|
+
"""
|
390
|
+
|
391
|
+
return self.raw['SYSEXT_LEVEL']
|
392
|
+
|
393
|
+
@property
|
394
|
+
def confext_level(self) -> str:
|
395
|
+
"""
|
396
|
+
Semantically the same as SYSEXT_LEVEL= but for confext images. See
|
397
|
+
/etc/extension-release.d/extension-release.IMAGE for more information.
|
398
|
+
|
399
|
+
Examples: "CONFEXT_LEVEL=2", "CONFEXT_LEVEL=15.14".
|
400
|
+
|
401
|
+
Added in version 254.
|
402
|
+
"""
|
403
|
+
|
404
|
+
return self.raw['CONFEXT_LEVEL']
|
405
|
+
|
406
|
+
@property
|
407
|
+
def sysext_scope(self) -> str:
|
408
|
+
"""
|
409
|
+
Takes a space-separated list of one or more of the strings "system", "initrd" and "portable". This field is only
|
410
|
+
supported in extension-release.d/ files and indicates what environments the system extension is applicable to:
|
411
|
+
i.e. to regular systems, to initrds, or to portable service images. If unspecified, "SYSEXT_SCOPE=system
|
412
|
+
portable" is implied, i.e. any system extension without this field is applicable to regular systems and to
|
413
|
+
portable service environments, but not to initrd environments.
|
414
|
+
|
415
|
+
Added in version 250.
|
416
|
+
"""
|
417
|
+
|
418
|
+
return self.raw['SYSEXT_SCOPE']
|
419
|
+
|
420
|
+
@property
|
421
|
+
def confext_scope(self) -> str:
|
422
|
+
"""
|
423
|
+
Semantically the same as SYSEXT_SCOPE= but for confext images.
|
424
|
+
|
425
|
+
Added in version 254.
|
426
|
+
"""
|
427
|
+
|
428
|
+
return self.raw['CONFEXT_SCOPE']
|
429
|
+
|
430
|
+
@property
|
431
|
+
def portable_prefixes(self) -> str:
|
432
|
+
"""
|
433
|
+
Takes a space-separated list of one or more valid prefix match strings for the Portable Services[3] logic. This
|
434
|
+
field serves two purposes: it is informational, identifying portable service images as such (and thus allowing
|
435
|
+
them to be distinguished from other OS images, such as bootable system images). It is also used when a portable
|
436
|
+
service image is attached: the specified or implied portable service prefix is checked against the list
|
437
|
+
specified here, to enforce restrictions how images may be attached to a system.
|
438
|
+
|
439
|
+
Added in version 250.
|
440
|
+
"""
|
441
|
+
|
442
|
+
return self.raw['PORTABLE_PREFIXES']
|
443
|
+
|
444
|
+
#
|
445
|
+
|
446
|
+
DEFAULT_PATHS: ta.ClassVar[ta.Sequence[str]] = [
|
447
|
+
'/etc/os-release',
|
448
|
+
'/usr/lib/os-release',
|
449
|
+
]
|
450
|
+
|
451
|
+
@classmethod
|
452
|
+
def read(cls, *paths: str) -> ta.Optional['LinuxOsRelease']:
|
453
|
+
for fp in (paths or cls.DEFAULT_PATHS):
|
454
|
+
if not os.path.isfile(fp):
|
455
|
+
continue
|
456
|
+
with open(fp) as f:
|
457
|
+
src = f.read()
|
458
|
+
break
|
459
|
+
else:
|
460
|
+
return None
|
461
|
+
|
462
|
+
raw = cls._parse_os_release(src)
|
463
|
+
|
464
|
+
return cls(raw)
|
465
|
+
|
466
|
+
@classmethod
|
467
|
+
def _parse_os_release(cls, src: str) -> ta.Mapping[str, str]:
|
468
|
+
dct: ta.Dict[str, str] = {}
|
469
|
+
|
470
|
+
for l in src.splitlines():
|
471
|
+
if not (l := l.strip()):
|
472
|
+
continue
|
473
|
+
if l.startswith('#') or '=' not in l:
|
474
|
+
continue
|
475
|
+
|
476
|
+
k, _, v = l.partition('=')
|
477
|
+
if k.startswith('"'):
|
478
|
+
k = k[1:-1]
|
479
|
+
if v.startswith('"'):
|
480
|
+
v = v[1:-1]
|
481
|
+
|
482
|
+
dct[k] = v
|
483
|
+
|
484
|
+
return dct
|
omlish/term.py
CHANGED
@@ -172,48 +172,63 @@ def _clamp_ofs(v: int, hi: int, ofs: int) -> str:
|
|
172
172
|
|
173
173
|
FG8 = ControlSequence(
|
174
174
|
lambda n: CSI + '38;5;' + str(n) + 'm',
|
175
|
-
'8-Bit Foreground Color'
|
175
|
+
'8-Bit Foreground Color',
|
176
|
+
)
|
176
177
|
FG8_STANDARD = ControlSequence(
|
177
178
|
lambda n: CSI + '38;5;' + _clamp_ofs(n, 8, 0) + 'm',
|
178
|
-
'8-Bit Foreground Color (Standard)'
|
179
|
+
'8-Bit Foreground Color (Standard)',
|
180
|
+
)
|
179
181
|
FG8_HIGH_INTENSITY = ControlSequence(
|
180
182
|
lambda n: CSI + '38;5;' + _clamp_ofs(n, 8, 8) + 'm',
|
181
|
-
'8-Bit Foreground Color (High Intensity)'
|
183
|
+
'8-Bit Foreground Color (High Intensity)',
|
184
|
+
)
|
182
185
|
FG8_216 = ControlSequence(
|
183
186
|
lambda n: CSI + '38;5;' + _clamp_ofs(n, 216, 16) + 'm',
|
184
|
-
'8-Bit Foreground Color (High Intensity)'
|
187
|
+
'8-Bit Foreground Color (High Intensity)',
|
188
|
+
)
|
185
189
|
FG8_GRAYSCALE = ControlSequence(
|
186
190
|
lambda n: CSI + '38;5;' + _clamp_ofs(n, 24, 232) + 'm',
|
187
|
-
'8-Bit Foreground Color (Grayscale)'
|
191
|
+
'8-Bit Foreground Color (Grayscale)',
|
192
|
+
)
|
188
193
|
FG8_RGB = ControlSequence(
|
189
194
|
lambda r, g, b: CSI + '38;5;' + str(36 * r + 6 * g + b) + 'm',
|
190
|
-
'8-Bit Foreground Color (RGB)'
|
195
|
+
'8-Bit Foreground Color (RGB)',
|
196
|
+
)
|
191
197
|
|
192
198
|
BG8 = ControlSequence(
|
193
199
|
lambda n: CSI + '48;5;' + str(n) + 'm',
|
194
|
-
'8-Bit Background Color'
|
200
|
+
'8-Bit Background Color',
|
201
|
+
)
|
195
202
|
BG8_STANDARD = ControlSequence(
|
196
203
|
lambda n: CSI + '48;5;' + _clamp_ofs(n, 8, 0) + 'm',
|
197
|
-
'8-Bit Background Color (Standard)'
|
204
|
+
'8-Bit Background Color (Standard)',
|
205
|
+
)
|
198
206
|
BG8_HIGH_INTENSITY = ControlSequence(
|
199
207
|
lambda n: CSI + '48;5;' + _clamp_ofs(n, 8, 8) + 'm',
|
200
|
-
'8-Bit Background Color (High Intensity)'
|
208
|
+
'8-Bit Background Color (High Intensity)',
|
209
|
+
)
|
201
210
|
BG8_216 = ControlSequence(
|
202
211
|
lambda n: CSI + '48;5;' + _clamp_ofs(n, 216, 16) + 'm',
|
203
|
-
'8-Bit Background Color (High Intensity)'
|
212
|
+
'8-Bit Background Color (High Intensity)',
|
213
|
+
)
|
204
214
|
BG8_GRAYSCALE = ControlSequence(
|
205
215
|
lambda n: CSI + '48;5;' + _clamp_ofs(n, 24, 232) + 'm',
|
206
|
-
'8-Bit Background Color (Grayscale)'
|
216
|
+
'8-Bit Background Color (Grayscale)',
|
217
|
+
)
|
207
218
|
BG8_RGB = ControlSequence(
|
208
219
|
lambda r, g, b: CSI + '48;5;' + str(36 * r + 6 * g + b) + 'm',
|
209
|
-
'8-Bit Background Color (RGB)'
|
220
|
+
'8-Bit Background Color (RGB)',
|
221
|
+
)
|
210
222
|
|
211
223
|
FG24_RGB = ControlSequence(
|
212
224
|
lambda r, g, b: CSI + '38;2;' + str(r) + ';' + str(g) + ';' + str(b) + 'm',
|
213
|
-
'24-Bit Foreground Color (RGB)'
|
225
|
+
'24-Bit Foreground Color (RGB)',
|
226
|
+
)
|
214
227
|
BG24_RGB = ControlSequence(
|
215
228
|
lambda r, g, b: CSI + '48;2;' + str(r) + ';' + str(g) + ';' + str(b) + 'm',
|
216
|
-
'24-Bit Background Color (RGB)'
|
229
|
+
'24-Bit Background Color (RGB)',
|
230
|
+
)
|
231
|
+
|
217
232
|
|
218
233
|
##
|
219
234
|
|
@@ -1,5 +1,5 @@
|
|
1
1
|
omlish/.manifests.json,sha256=RX24SRc6DCEg77PUVnaXOKCWa5TF_c9RQJdGIf7gl9c,1135
|
2
|
-
omlish/__about__.py,sha256=
|
2
|
+
omlish/__about__.py,sha256=TTGSgQiaw8RlS3TEaNm9PX3osMhDFRCTCzGdQmtU5dQ,3409
|
3
3
|
omlish/__init__.py,sha256=SsyiITTuK0v74XpKV8dqNaCmjOlan1JZKrHQv5rWKPA,253
|
4
4
|
omlish/c3.py,sha256=ubu7lHwss5V4UznbejAI0qXhXahrU01MysuHOZI9C4U,8116
|
5
5
|
omlish/cached.py,sha256=UI-XTFBwA6YXWJJJeBn-WkwBkfzDjLBBaZf4nIJA9y0,510
|
@@ -12,7 +12,7 @@ omlish/libc.py,sha256=8r7Ejyhttk9ruCfBkxNTrlzir5WPbDE2vmY7VPlceMA,15362
|
|
12
12
|
omlish/multiprocessing.py,sha256=QZT4C7I-uThCAjaEY3xgUYb-5GagUlnE4etN01LDyU4,5186
|
13
13
|
omlish/runmodule.py,sha256=PWvuAaJ9wQQn6bx9ftEL3_d04DyotNn8dR_twm2pgw0,700
|
14
14
|
omlish/sync.py,sha256=QJ79kxmIqDP9SeHDoZAf--DpFIhDQe1jACy8H4N0yZI,2928
|
15
|
-
omlish/term.py,sha256=
|
15
|
+
omlish/term.py,sha256=EVHm3lEEIc9hT4f8BPmzbNUwlqZ8nrRpCwyQMN7LBm0,9313
|
16
16
|
omlish/antlr/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
17
17
|
omlish/antlr/_runtime/BufferedTokenStream.py,sha256=1Rnhm62MZCWSuQeRs7lRUbdtdyo7Gyg8r4gAETjv-cE,10793
|
18
18
|
omlish/antlr/_runtime/CommonTokenFactory.py,sha256=QrSSTH0gYhOpPeOHqrs6-2g1PGcgYvjhR6J6pynKLOc,2147
|
@@ -288,7 +288,7 @@ omlish/io/compress/lzma.py,sha256=8qxi7TniLN00LyJIJLyp6W7UUU50JBaPxxoXYg2j2XQ,22
|
|
288
288
|
omlish/io/compress/snappy.py,sha256=kCPgZ7PTBAxAnmYzpQCq4HKUIJ4APeAEXsU3Vg2CaDU,411
|
289
289
|
omlish/io/compress/zlib.py,sha256=MtnVGfzDlRU1LPl2J8Sa3wwgqnTVBx2uclZygWpH9xI,2115
|
290
290
|
omlish/io/compress/zstd.py,sha256=LrYWVHzk-TqWJA_Bnci2i8QOtrqnFFpppLQhLqanDWM,668
|
291
|
-
omlish/io/fdio/__init__.py,sha256=
|
291
|
+
omlish/io/fdio/__init__.py,sha256=Y3l4WY4JRi2uLG6kgbGp93fuGfkxkKwZDvhsa0Rwgtk,15
|
292
292
|
omlish/io/fdio/corohttp.py,sha256=AdsGyaTT4c0V4eUyhxob8Zm4Ixj936DfpwyyJO2-R8k,3995
|
293
293
|
omlish/io/fdio/handlers.py,sha256=OOQhiazbhNMwxLwyzf8KUQrBQSuHIm-UqAMpXmmHGFQ,1344
|
294
294
|
omlish/io/fdio/kqueue.py,sha256=YgGBQibkAUYODYDiGl7Enjtx1oQsJXuDsBLBXgqlLQw,3832
|
@@ -334,12 +334,12 @@ omlish/lifecycles/states.py,sha256=zqMOU2ZU-MDNnWuwauM3_anIAiXM8LoBDElDEraptFg,1
|
|
334
334
|
omlish/lifecycles/transitions.py,sha256=qQtFby-h4VzbvgaUqT2NnbNumlcOx9FVVADP9t83xj4,1939
|
335
335
|
omlish/lite/__init__.py,sha256=Y3l4WY4JRi2uLG6kgbGp93fuGfkxkKwZDvhsa0Rwgtk,15
|
336
336
|
omlish/lite/cached.py,sha256=hBW77-F7ZLtFqbLwVrlqaJ4-iFHMQleMWZXaZN1IubA,1308
|
337
|
-
omlish/lite/check.py,sha256=
|
338
|
-
omlish/lite/contextmanagers.py,sha256=
|
337
|
+
omlish/lite/check.py,sha256=KvcO86LqWlh2j4ORaZXRR4FM8fFb7kUkNqq3lTs0Ta0,12821
|
338
|
+
omlish/lite/contextmanagers.py,sha256=m9JO--p7L7mSl4cycXysH-1AO27weDKjP3DZG61cwwM,1683
|
339
339
|
omlish/lite/inject.py,sha256=729Qi0TLbQgBtkvx97q1EUMe73VFYA1hu4woXkOTcwM,23572
|
340
340
|
omlish/lite/json.py,sha256=7-02Ny4fq-6YAu5ynvqoijhuYXWpLmfCI19GUeZnb1c,740
|
341
341
|
omlish/lite/logs.py,sha256=1pcGu0ekhVCcLUckLSP16VccnAoprjtl5Vkdfm7y1Wg,6184
|
342
|
-
omlish/lite/marshal.py,sha256=
|
342
|
+
omlish/lite/marshal.py,sha256=jbdKjTeumReSKUNNEn-oAyd5Bdy6NK_9_LsPSHpvqRU,13817
|
343
343
|
omlish/lite/maybes.py,sha256=7OlHJ8Q2r4wQ-aRbZSlJY7x0e8gDvufFdlohGEIJ3P4,833
|
344
344
|
omlish/lite/pycharm.py,sha256=pUOJevrPClSqTCEOkQBO11LKX2003tfDcp18a03QFrc,1163
|
345
345
|
omlish/lite/reflect.py,sha256=ad_ya_zZJOQB8HoNjs9yc66R54zgflwJVPJqiBXMzqA,1681
|
@@ -352,7 +352,7 @@ omlish/lite/strings.py,sha256=QURcE4-1pKVW8eT_5VCJpXaHDWR2dW2pYOChTJnZDiQ,1504
|
|
352
352
|
omlish/lite/subprocesses.py,sha256=iN-HX44g9uxkZ7HII2Upvkfjp7YK6qQuhPrBqM4Hnp0,4934
|
353
353
|
omlish/lite/typing.py,sha256=U3-JaEnkDSYxK4tsu_MzUn3RP6qALBe5FXQXpD-licE,1090
|
354
354
|
omlish/lite/asyncio/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
355
|
-
omlish/lite/asyncio/subprocesses.py,sha256=
|
355
|
+
omlish/lite/asyncio/subprocesses.py,sha256=luHARTCKB5qoxwUln1LH_v-z8k7YTkf32b2rgV_qkMg,8634
|
356
356
|
omlish/logs/__init__.py,sha256=FbOyAW-lGH8gyBlSVArwljdYAU6RnwZLI5LwAfuNnrk,438
|
357
357
|
omlish/logs/abc.py,sha256=ho4ABKYMKX-V7g4sp1BByuOLzslYzLlQ0MESmjEpT-o,8005
|
358
358
|
omlish/logs/configs.py,sha256=EE0jlNaXJbGnM7V-y4xS5VwyTBSTzFzc0BYaVjg0JmA,1283
|
@@ -401,6 +401,7 @@ omlish/os/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
401
401
|
omlish/os/deathsig.py,sha256=hk9Yq2kyDdI-cI7OQH7mOfpRbOKzY_TfPKEqgrjVYbA,641
|
402
402
|
omlish/os/files.py,sha256=1tNy1z5I_CgYKA5c6lOfsXc-hknP4tQDbSShdz8HArw,1308
|
403
403
|
omlish/os/journald.py,sha256=2nI8Res1poXkbLc31--MPUlzYMESnCcPUkIxDOCjZW0,3903
|
404
|
+
omlish/os/linux.py,sha256=whJ6scwMKSFBdXiVhJW0BCpJV4jOGMr-a_a3Bhwz6Ls,18938
|
404
405
|
omlish/os/pidfile.py,sha256=S4Nbe00oSxckY0qCC9AeTEZe7NSw4eJudnQX7wCXzks,1738
|
405
406
|
omlish/os/sizes.py,sha256=ohkALLvqSqBX4iR-7DMKJ4pfOCRdZXV8htH4QywUNM0,152
|
406
407
|
omlish/reflect/__init__.py,sha256=4-EuCSX1qpEWfScCFzAJv_XghHFu4cXxpxKeBKrosQ4,720
|
@@ -519,9 +520,9 @@ omlish/text/glyphsplit.py,sha256=Ug-dPRO7x-OrNNr8g1y6DotSZ2KH0S-VcOmUobwa4B0,329
|
|
519
520
|
omlish/text/indent.py,sha256=6Jj6TFY9unaPa4xPzrnZemJ-fHsV53IamP93XGjSUHs,1274
|
520
521
|
omlish/text/parts.py,sha256=7vPF1aTZdvLVYJ4EwBZVzRSy8XB3YqPd7JwEnNGGAOo,6495
|
521
522
|
omlish/text/random.py,sha256=jNWpqiaKjKyTdMXC-pWAsSC10AAP-cmRRPVhm59ZWLk,194
|
522
|
-
omlish-0.0.0.
|
523
|
-
omlish-0.0.0.
|
524
|
-
omlish-0.0.0.
|
525
|
-
omlish-0.0.0.
|
526
|
-
omlish-0.0.0.
|
527
|
-
omlish-0.0.0.
|
523
|
+
omlish-0.0.0.dev155.dist-info/LICENSE,sha256=B_hVtavaA8zCYDW99DYdcpDLKz1n3BBRjZrcbv8uG8c,1451
|
524
|
+
omlish-0.0.0.dev155.dist-info/METADATA,sha256=EZnz0auK1L6Br8TpcHXEE4T5zN79d2pJpORfJEZeFss,4264
|
525
|
+
omlish-0.0.0.dev155.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
|
526
|
+
omlish-0.0.0.dev155.dist-info/entry_points.txt,sha256=Lt84WvRZJskWCAS7xnQGZIeVWksprtUHj0llrvVmod8,35
|
527
|
+
omlish-0.0.0.dev155.dist-info/top_level.txt,sha256=pePsKdLu7DvtUiecdYXJ78iO80uDNmBlqe-8hOzOmfs,7
|
528
|
+
omlish-0.0.0.dev155.dist-info/RECORD,,
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|