omlish 0.0.0.dev234__py3-none-any.whl → 0.0.0.dev235__py3-none-any.whl

omlish/__about__.py

@@ -1,5 +1,5 @@
-__version__ = '0.0.0.dev234'
-__revision__ = '174a570495a04d3166159c95ab0d35c050a32fcb'
+__version__ = '0.0.0.dev235'
+__revision__ = '4afeb0f0acadfd7890e6e6309be41fe7e65c3185'
 
 
 #

omlish/os/filemodes.py

@@ -0,0 +1,127 @@
+# ruff: noqa: UP006 UP007
+# @omlish-lite
+import dataclasses as dc
+import os
+import typing as ta
+
+from ..lite.check import check
+
+
+@dc.dataclass(frozen=True)
+class FileMode:
+    """
+    https://docs.python.org/3/library/functions.html#open
+
+    'r' open for reading (default)
+    'w' open for writing, truncating the file first
+    'x' open for exclusive creation, failing if the file already exists
+    'a' open for writing, appending to the end of file if it exists
+    'b' binary mode
+    't' text mode (default)
+    '+' open for updating (reading and writing)
+
+    ==
+
+    https://en.cppreference.com/w/cpp/io/c/fopen
+
+    "r"   read             Open a file for reading        read from start   return NULL and set error
+    "w"   write            Create a file for writing     destroy contents  create new
+    "a"   append           Append to a file              write to end      create new
+    "r+"  read extended    Open a file for read/write    read from start   return NULL and set error
+    "w+"  write extended   Create a file for read/write  destroy contents  create new
+    "a+"  append extended  Open a file for read/write    write to end      create new
+
+    ==
+
+    a (prs): w a
+    a (new): w
+    a+ (prs): r w a
+    a+ (new): r w
+
+    x (new): w
+    x+ (new): r w
+
+    w (prs): w
+    w (new): w
+    w+ (prs): r w
+    w+ (new): r w
+
+    r (prs): r
+    r+ (prs): r w
+    """
+
+    read: bool
+    write: bool
+
+    create: bool
+    exists: ta.Literal['beginning', 'truncate', 'fail', 'append']
+
+    binary: bool
+
+    #
+
+    def flags(self) -> int:
+        return (
+            (
+                os.O_RDWR if self.read and self.write else
+                os.O_WRONLY if self.write else
+                os.O_RDONLY if self.read else
+                0
+            ) |
+            (os.O_CREAT if self.create else 0) |
+            (
+                os.O_APPEND if self.exists == 'append' else
+                os.O_EXCL if self.exists == 'fail' else
+                os.O_TRUNC if self.exists == 'truncate' else
+                0
+            )
+        )
+
+    #
+
+    def render(self) -> str:
+        return ''.join([
+            (
+                'a' if self.exists == 'append' else
+                'x' if self.exists == 'fail' else
+                'w' if self.exists == 'truncate' else
+                'r'
+            ),
+            '+' if self.read and self.write else '',
+            'b' if self.binary else '',
+        ])
+
+    @classmethod
+    def parse(cls, s: str) -> 'FileMode':
+        rwxa: ta.Literal['r', 'w', 'x', 'a', None] = None
+        tb: ta.Literal['t', 'b', None] = None
+        p: bool | None = None
+
+        for c in s:
+            if c in 'rwxa':
+                rwxa = check.replacing_none(rwxa, c)  # type: ignore[arg-type]
+            elif c in 'tb':
+                tb = check.replacing_none(tb, c)  # type: ignore[arg-type]
+            elif c == '+':
+                p = check.replacing_none(p, True)
+            else:
+                raise ValueError(c)
+
+        if rwxa is None:
+            rwxa = 'r'
+        if tb is None:
+            tb = 't'
+        p = bool(p)
+
+        return FileMode(
+            read=rwxa == 'r' or p,
+            write=rwxa != 'r' or p,
+            create=rwxa != 'r',
+            exists=(  # noqa
+                'append' if rwxa == 'a' else
+                'fail' if rwxa == 'x' else
+                'truncate' if rwxa == 'w' else
+                'beginning'
+            ),
+            binary=tb == 'b',
+        )

{omlish-0.0.0.dev234.dist-info → omlish-0.0.0.dev235.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: omlish
-Version: 0.0.0.dev234
+Version: 0.0.0.dev235
 Summary: omlish
 Author: wrmsr
 License: BSD-3-Clause

{omlish-0.0.0.dev234.dist-info → omlish-0.0.0.dev235.dist-info}/RECORD

@@ -1,5 +1,5 @@
 omlish/.manifests.json,sha256=vQTAIvR8OblSq-uP2GUfnbei0RnmAnM5j0T1-OToh9E,8253
-omlish/__about__.py,sha256=25WunqgfyyX8tx5v7hb5oDxmHeKqi70lgB5g0g-9A6o,3380
+omlish/__about__.py,sha256=mOMhMeHgYWv96pndE14EVx-D5bReVhtSMXcqy2QLvnE,3380
 omlish/__init__.py,sha256=SsyiITTuK0v74XpKV8dqNaCmjOlan1JZKrHQv5rWKPA,253
 omlish/c3.py,sha256=ubu7lHwss5V4UznbejAI0qXhXahrU01MysuHOZI9C4U,8116
 omlish/cached.py,sha256=UI-XTFBwA6YXWJJJeBn-WkwBkfzDjLBBaZf4nIJA9y0,510
@@ -514,6 +514,7 @@ omlish/os/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 omlish/os/atomics.py,sha256=KhWNeh4mzU3M-TF0v8uR6hUqMfZJW42MeyIK9Jl6R0k,5246
 omlish/os/deathsig.py,sha256=hk9Yq2kyDdI-cI7OQH7mOfpRbOKzY_TfPKEqgrjVYbA,641
 omlish/os/fcntl.py,sha256=riQf9iEEEIC28lJp8ud06MU56w2XJHJ9nBFtck_hdhc,1501
+omlish/os/filemodes.py,sha256=njxd9cQChKSi_5-oiAG9OJOzj8CvnyedWWheOWM0uHA,3476
 omlish/os/files.py,sha256=WJ_42vsZIZukQURN3TTccp-n74ZNhbux_ps3TLbHj18,1106
 omlish/os/forkhooks.py,sha256=yjodOvs90ClXskv5oBIJbHn0Y7dzajLmZmOpRMKbyxM,5656
 omlish/os/journald.py,sha256=2nI8Res1poXkbLc31--MPUlzYMESnCcPUkIxDOCjZW0,3903
@@ -705,9 +706,9 @@ omlish/text/indent.py,sha256=YjtJEBYWuk8--b9JU_T6q4yxV85_TR7VEVr5ViRCFwk,1336
 omlish/text/minja.py,sha256=jZC-fp3Xuhx48ppqsf2Sf1pHbC0t8XBB7UpUUoOk2Qw,5751
 omlish/text/parts.py,sha256=JkNZpyR2tv2CNcTaWJJhpQ9E4F0yPR8P_YfDbZfMtwQ,6182
 omlish/text/random.py,sha256=jNWpqiaKjKyTdMXC-pWAsSC10AAP-cmRRPVhm59ZWLk,194
-omlish-0.0.0.dev234.dist-info/LICENSE,sha256=B_hVtavaA8zCYDW99DYdcpDLKz1n3BBRjZrcbv8uG8c,1451
-omlish-0.0.0.dev234.dist-info/METADATA,sha256=Wi5DB__bQ4RwJcyGfKAYa2KjklQ83NtMlyvt20u9VxQ,4176
-omlish-0.0.0.dev234.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-omlish-0.0.0.dev234.dist-info/entry_points.txt,sha256=Lt84WvRZJskWCAS7xnQGZIeVWksprtUHj0llrvVmod8,35
-omlish-0.0.0.dev234.dist-info/top_level.txt,sha256=pePsKdLu7DvtUiecdYXJ78iO80uDNmBlqe-8hOzOmfs,7
-omlish-0.0.0.dev234.dist-info/RECORD,,
+omlish-0.0.0.dev235.dist-info/LICENSE,sha256=B_hVtavaA8zCYDW99DYdcpDLKz1n3BBRjZrcbv8uG8c,1451
+omlish-0.0.0.dev235.dist-info/METADATA,sha256=kGZm_s1Kmw1dsPChxxw0LPa1lbSL07NPMdgVyf8AnUs,4176
+omlish-0.0.0.dev235.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+omlish-0.0.0.dev235.dist-info/entry_points.txt,sha256=Lt84WvRZJskWCAS7xnQGZIeVWksprtUHj0llrvVmod8,35
+omlish-0.0.0.dev235.dist-info/top_level.txt,sha256=pePsKdLu7DvtUiecdYXJ78iO80uDNmBlqe-8hOzOmfs,7
+omlish-0.0.0.dev235.dist-info/RECORD,,