reykit 1.1.56__py3-none-any.whl → 1.1.58__py3-none-any.whl

reykit/rlog.py

@@ -10,7 +10,7 @@
 
 
 from typing import Any, Literal, Final, overload
-from collections.abc import Callable
+from collections.abc import Hashable, Callable
 from queue import Queue
 from os.path import abspath as os_abspath
 from logging import (
@@ -29,8 +29,7 @@ from logging import (
 from logging.handlers import QueueHandler
 from concurrent_log_handler import ConcurrentRotatingFileHandler, ConcurrentTimedRotatingFileHandler
 
-from .rbase import Base, ConfigMeta, throw, catch_exc, get_first_notnone, get_stack_param
-from .ros import File
+from .rbase import Base, ConfigMeta, null, throw, catch_exc, get_first_notnone, get_stack_param
 from .rre import search, sub
 from .rstdout import ConfigStdout, modify_print, reset_print
 from .rtext import to_text
@@ -41,7 +40,7 @@ from .rwrap import wrap_thread
 __all__ = (
     'ConfigLog',
     'Log',
-    'Record'
+    'Mark'
 )
 
 
@@ -939,100 +938,110 @@ class Log(Base):
     __call__ = log
 
 
-class Record(Base):
+class Mark(Base):
     """
-    Record type.
+    Mark object type.
+    Based on memory ID.
     """
 
 
-    def __init__(
-        self,
-        path: str | None = '_rrecord'
-    ) -> None:
+    def __init__(self) -> None:
         """
         Build instance attributes.
+        """
+
+        # Build.
+        self.default_set: set[int] = set()
+        self.data: dict[Hashable, set[int]] = {null: self.default_set}
+
+
+    def mark(self, obj: Any, group: Hashable = null) -> int:
+        """
+        Mark object.
 
         Parameters
         ----------
-        path : File path.
-            - `None`: Record to variable.
-            - `path`: Record to file.
+        obj : Object.
+        group : Group index.
+
+        Returns
+        -------
+        Object memory ID.
         """
 
-        # Set attribute.
-        self.path = path
-        if path is None:
-            self.records = []
+        # Handle parameter.
+        obj_id = id(obj)
+        group_set = self.data.setdefault(group, set())
 
+        # Mark.
+        group_set.add(obj_id)
 
-    def record(
-        self,
-        value: Any
-    ) -> None:
+        return obj_id
+
+
+    def remove(self, obj: Any, group: Hashable = null) -> None:
         """
-        Record value.
+        Whether marked.
 
         Parameters
         ----------
-        value : Value.
-        """
+        obj : Object.
+        group : Group index.
 
-        # To variable.
-        if self.path is None:
-            self.records.append(value)
-
-        # To file.
-        else:
-            file = File(self.path)
+        Returns
+        -------
+        Judgment result.
+        """
 
-            ## Convert.
-            if type(value) != str:
-                value = str(value)
-            if file:
-                value += ':'
-            else:
-                value = ':%s:' % value
+        # Handle parameter.
+        obj_id = id(obj)
+        group_set = self.data.setdefault(group, set())
 
-            ## Record.
-            file(value, True)
+        # Remove.
+        group_set.remove(obj_id)
 
 
-    def is_recorded(
-        self,
-        value: Any
-    ) -> bool:
+    def remove_group(self, group: Hashable) -> None:
         """
-        Judge if has been recorded.
+        Whether marked.
 
         Parameters
         ----------
-        value : Record value.
+        group : Group index.
 
         Returns
         -------
-        Judge result.
+        Judgment result.
         """
 
-        # To variable.
-        if self.path is None:
-            judge = value in self.records
+        # Remove.
+        del self.data[group]
 
-        # To file.
-        else:
-            file = File(self.path)
 
-            ## Convert.
-            if type(value) != str:
-                value = str(value)
-            value = ':%s:' % value
+    def is_marked(self, obj: Any, group: Hashable = null) -> bool:
+        """
+        Whether marked.
 
-            ## Judge.
-            judge = value in file
+        Parameters
+        ----------
+        obj : Object.
+        group : Group index.
+
+        Returns
+        -------
+        Judgment result.
+        """
+
+        # Handle parameter.
+        obj_id = id(obj)
+        group_set = self.data.setdefault(group, set())
 
-        return judge
+        # Judge.
+        result = obj_id in group_set
 
+        return result
 
-    __call__ = record
 
+    __call__ = mark
 
-    __contains__ = is_recorded
+    __contains__ = is_marked

reykit/ros.py

@@ -1270,7 +1270,6 @@ class Folder(Base):
 
     __call__ = paths
 
-
     __add__ = __radd__ = join
 
 
@@ -1926,7 +1925,6 @@ class TempFolder(Base):
 
     __call__ = paths
 
-
     __add__ = __radd__ = join
 
 

reykit/rtask.py

@@ -300,7 +300,6 @@ class ThreadPool(Base):
 
     __call__ = one
 
-
     __mul__ = repeat
 
 
@@ -875,5 +874,4 @@ class AsyncPool(Base):
 
     __call__ = one
 
-
     __mul__ = repeat

reykit/rtext.py

@@ -26,7 +26,8 @@ __all__ = (
     'frame_text',
     'frame_data',
     'join_data_text',
-    'join_filter_text'
+    'join_filter_text',
+    'is_zh'
 )
 
 
@@ -516,3 +517,27 @@ def join_filter_text(data: Iterable, char: str = ',', filter_: tuple = (None, ''
     text = char.join(data)
 
     return text
+
+
+def is_zh(char: str) -> bool:
+    """
+    whther is Chinese character.
+    Only includes basic Chinese character.
+
+    Parameters
+    ----------
+    char : One character.
+
+    Returns
+    -------
+    Judged result.
+    """
+
+    # Check.
+    if len(char) != 1:
+        throw(ValueError, char)
+
+    # Judge.
+    judge = '\u4e00' <= char <= '\u9fa5'
+
+    return judge

reykit/rtime.py

@@ -516,7 +516,7 @@ class TimeMark(Base):
         """
 
         # Record table.
-        self.record: dict[int, RecordData] = {}
+        self.records: dict[int, RecordData] = {}
 
 
     def mark(self, note: str | None = None) -> int:
@@ -535,7 +535,7 @@ class TimeMark(Base):
         # Get parametes.
 
         # Mark.
-        index = len(self.record)
+        index = len(self.records)
         now_timestamp = now('timestamp')
         now_datetime = now('datetime')
         record = {
@@ -548,11 +548,11 @@ class TimeMark(Base):
         ## Not first.
         if index != 0:
             last_index = index - 1
-            last_datetime = self.record[last_index]['datetime']
+            last_datetime = self.records[last_index]['datetime']
             record['timedelta'] = now_datetime - last_datetime
 
         ## Record.
-        self.record[index] = record
+        self.records[index] = record
 
         return index
 
@@ -576,14 +576,14 @@ class TimeMark(Base):
         from pandas import DataFrame
 
         # Handle parameter.
-        record_len = len(self.record)
+        record_len = len(self.records)
         data = [
             info.copy()
-            for info in self.record.values()
+            for info in self.records.values()
         ]
         indexes = [
             index
-            for index in self.record
+            for index in self.records
         ]
 
         # Generate report.
@@ -598,7 +598,7 @@ class TimeMark(Base):
         if record_len > 2:
             row: RecordData = dict.fromkeys(('timestamp', 'datetime', 'timedelta', 'note'))
             max_index = record_len - 1
-            total_timedelta = self.record[max_index]['datetime'] - self.record[0]['datetime']
+            total_timedelta = self.records[max_index]['datetime'] - self.records[0]['datetime']
             row['timedelta'] = total_timedelta
             data.append(row)
             indexes.append('total')
@@ -640,13 +640,13 @@ class TimeMark(Base):
         """
 
         # Break.
-        if len(self.record) <= 1:
+        if len(self.records) <= 1:
             return 0.0
 
         # Handle parameter.
-        first_timestamp = self.record[0]['timestamp']
-        max_index = max(self.record)
-        last_timestamp = self.record[max_index]['timestamp']
+        first_timestamp = self.records[0]['timestamp']
+        max_index = max(self.records)
+        last_timestamp = self.records[max_index]['timestamp']
 
         # Calculate.
         seconds = round((last_timestamp - first_timestamp) / 1000, 3)
@@ -654,6 +654,15 @@ class TimeMark(Base):
         return seconds
 
 
+    def clear(self) -> None:
+        """
+        Clear records.
+        """
+
+        # Clear.
+        self.records.clear()
+
+
     def __str__(self) -> str:
         """
         Convert to string.
@@ -672,6 +681,34 @@ class TimeMark(Base):
         return string
 
 
-    __call__ = __getitem__ = mark
+    def __int__(self) -> int:
+        """
+        Get total spend seconds, truncate the decimal part.
+
+        Returns
+        -------
+        Total spend seconds.
+        """
+
+        # Get
+        total_speend = int(self.total_spend)
+
+        return total_speend
 
-    __float__ = total_spend
+
+    def __float__(self) -> float:
+        """
+        Get total spend seconds.
+
+        Returns
+        -------
+        Total spend seconds.
+        """
+
+        # Get
+        total_speend = self.total_spend
+
+        return total_speend
+
+
+    __call__ = __getitem__ = mark

reykit/rwrap.py

@@ -197,9 +197,9 @@ def wrap_runtime(
     tm()
 
     # Generate report.
-    start_time = tm.record[0]['datetime']
-    spend_time: Timedelta = tm.record[1]['timedelta']
-    end_time = tm.record[1]['datetime']
+    start_time = tm.records[0]['datetime']
+    spend_time: Timedelta = tm.records[1]['timedelta']
+    end_time = tm.records[1]['datetime']
     start_str = time_to(start_time, True)[:-3]
     spend_str = time_to(spend_time, True)[:-3]
     end_str = time_to(end_time, True)[:-3]

{reykit-1.1.56.dist-info → reykit-1.1.58.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reykit
-Version: 1.1.56
+Version: 1.1.58
 Summary: Kit method set.
 Project-URL: homepage, https://github.com/reyxbo/reykit/
 Author-email: Rey <reyxbo@163.com>

{reykit-1.1.56.dist-info → reykit-1.1.58.dist-info}/RECORD

@@ -4,25 +4,25 @@ reykit/rbase.py,sha256=EfTMt6cRTfHlVXLX9D87lI8x6NEMfyX9IJP0WxBRkQg,22098
 reykit/rdata.py,sha256=NmOY_h4w2PY5xBbYNmOnb55w7PGsvvCzOBnxPjQ08qw,10293
 reykit/remail.py,sha256=l4HGKXdfHNBxyBT3YxeZyQhfecbElqTqSAGInwWhap8,6723
 reykit/rimage.py,sha256=lNN2iMpvSMqh-nPTpxrA9yHy43EA5WoYdxKYhqPwMgk,6154
-reykit/rlog.py,sha256=oXv0wGjR94seAUXz8kIhq53qSFaYPckJTjoXhd3e_c8,25599
+reykit/rlog.py,sha256=ggQz8f4RcLOjw8p1VGRb-uqPqpMiOUAWzo48alk9sAg,25817
 reykit/rmonkey.py,sha256=Dj2GBzBDFXbo0Z-5f8Zep4dfbaIw1bo1FUmC31xvDuk,7929
 reykit/rnet.py,sha256=6uULgoPk8DTKWg9yNQco7gdw4A59F9ygcZR6rgO4eoY,16897
 reykit/rnum.py,sha256=PhG4V_BkVfCJUsbpMDN1umGZly1Hsus80TW8bpyBtyY,3653
-reykit/ros.py,sha256=J7Jo8rucGhk8UWjxPzm-OLipVPaTLjFjws9athg8H1A,47010
+reykit/ros.py,sha256=8bLvjt0WkUPF6bkwQnm4xeoZTeKqcwM3a0EFt51WNaU,47006
 reykit/rrand.py,sha256=bYYmuKNqn4un1i-SdA9jb9l1iYaeLfS-tWJRzD3gLDs,8941
 reykit/rre.py,sha256=1qva7xatKVE9qC2j7IujjXSM59qxHWwTYpiizFFQ8Xo,6024
 reykit/rschedule.py,sha256=E2gRLrCwrAo2CV1sOHrWoaVP99Wq7QjAqeYv04hWsYo,5767
 reykit/rstdout.py,sha256=yesWo7wIGablpyAu-2J2Gw11Qp3GdQjGICTyIcvLyt4,8200
 reykit/rsys.py,sha256=cafnGGerxR0kg5GHNJojmvsMDNsjgsJ3CtIGH5mAJa8,24953
 reykit/rtable.py,sha256=YuDH2GL9Lwr5LljRDm5hzHrsvaXOs4-X89XVwFD-b0g,12221
-reykit/rtask.py,sha256=d3Fs-_ZB-uHtzz7zyI2aAmiQv3NcIvWrco6x10jFuzc,22842
-reykit/rtext.py,sha256=gkmA849MBHjchvY4apUTQpkFs13vcmyK_hIwucH2A84,12849
-reykit/rtime.py,sha256=Y3XX6zeiTxFdj5yMsVOK7mWT2TTfQOdZc6q4rkIN-fY,16983
-reykit/rwrap.py,sha256=HZ3hTmwvwA33H4G-laF_5p1GsBKZrkeeVCQccKuqPcw,15323
+reykit/rtask.py,sha256=NUTngUUDUZy3TqEHiuiKy17FcE0F1zS118KnKTsBjng,22838
+reykit/rtext.py,sha256=cWHy19lDcJvpX7LU95kmRVsDimpAUaz5TbKC1h83gB4,13254
+reykit/rtime.py,sha256=8QJ6YNiC0JUDiW1xc1tkzQUMPYOFT7d7dKCYRuYt9co,17635
+reykit/rwrap.py,sha256=UaMkBx3tTtFlqCGe7no6VmOIFnnuxNKcmIsAAThZUVs,15326
 reykit/rzip.py,sha256=BGEONswuBZxQ-zcgd_xp2fcvYesC9AmKaaXWvnT3bTI,3456
 reykit/rdll/__init__.py,sha256=nLSb8onBm2ilyoxzpDzUeGfSCKwkLEesIhzK3LiJ8mk,701
 reykit/rdll/rdll_core.py,sha256=o6-rKcTQgxZQe0kD3GnwyNb3KL9IogzgCQNOmYLMm7A,5086
-reykit-1.1.56.dist-info/METADATA,sha256=JAd_A_VoT4erFslNxIZSZudwmQgVHu_2BDtiKK6sN-E,1872
-reykit-1.1.56.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-reykit-1.1.56.dist-info/licenses/LICENSE,sha256=UYLPqp7BvPiH8yEZduJqmmyEl6hlM3lKrFIefiD4rvk,1059
-reykit-1.1.56.dist-info/RECORD,,
+reykit-1.1.58.dist-info/METADATA,sha256=v9QtYZ6KbmyXXve74_nUf7ErqiXLaO-Unsgg0f_5yf0,1872
+reykit-1.1.58.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+reykit-1.1.58.dist-info/licenses/LICENSE,sha256=UYLPqp7BvPiH8yEZduJqmmyEl6hlM3lKrFIefiD4rvk,1059
+reykit-1.1.58.dist-info/RECORD,,