absfuyu 3.0.0__py3-none-any.whl → 3.1.0__py3-none-any.whl

absfuyu/general/generator.py

@@ -3,14 +3,15 @@ Absfuyu: Generator
 ------------------
 This generate stuff (Not python's ``generator``)
 
-Version: 1.0.4
-Date updated: 24/11/2023 (dd/mm/yyyy)
+Version: 1.1.0
+Date updated: 06/03/2024 (dd/mm/yyyy)
 
 Features:
 ---------
 - Generate random string
 - Generate key
 - Generate check digit
+- Generate combinations of list in range
 """
 
 
@@ -24,10 +25,21 @@ __all__ = [
 
 # Library
 ###########################################################################
+from itertools import chain, combinations
 from random import choice
 import string
+# from string import (
+#     ascii_letters as _ascii_letters,
+#     ascii_uppercase as _ascii_uppercase,
+#     ascii_lowercase as _ascii_lowercase,
+#     digits as _digits,
+#     printable as _printable,
+#     punctuation as _punctuation,
+# )
+from typing import List
 
 from absfuyu.logger import logger
+from absfuyu.util import set_max, set_min_max
 
 
 # Class
@@ -45,10 +57,19 @@ class Charset:
     SPECIAL = string.punctuation
     ALL = string.printable
     PRODUCT_KEY = "BCDFGHJKMNPQRTVWXY2346789" # Charset that various key makers use
+    # DEFAULT = _ascii_letters + _digits
+    # ALPHABET = _ascii_letters
+    # FULL = _ascii_letters + _digits + _punctuation
+    # UPPERCASE = _ascii_uppercase
+    # LOWERCASE = _ascii_lowercase
+    # DIGIT = _digits
+    # SPECIAL = _punctuation
+    # ALL = _printable
 
     def __str__(self) -> str:
         charset = [x for x in __class__.__dict__.keys() if not x.startswith("__")]
-        return f"List of Charset: {charset}"
+        return f"List of Character set: {charset}"
+
     def __repr__(self) -> str:
         return self.__str__()
 
@@ -258,8 +279,48 @@ class Generator:
         logger.debug(f"Output: {out}")
         return out
 
+    @staticmethod
+    def combinations_range(sequence: list, *, min_len: int = 1, max_len: int = 0) -> List[tuple]:
+        """
+        Generate all combinations of a ``sequence`` from ``min_len`` to ``max_len``
+
+        Parameters
+        ----------
+        sequence : list
+            A sequence that need to generate combination
+
+        min_len : int
+            Minimum ``r`` of ``combinations``
+            (Default: ``1``)
+
+        max_len : int
+            Maximum ``r`` of ``combinations``
+            (Default: ``0`` - len of ``sequence``)
+
+        Returns
+        -------
+        list[tuple]
+            A list of all combinations from range(``min_len``, ``max_len``) of ``sequence``
+        """
+        # Restrain
+        if max_len < 1:
+            max_len = len(sequence)
+        max_len = set_max(max_len, max_value=len(sequence))
+        min_len = set_min_max(min_len, min_value=1, max_value=max_len)
+        logger.debug(f"Combination range: [{min_len}, {max_len}]")
+
+        # Return
+        return list(
+            chain.from_iterable(
+                [
+                    list(combinations(sequence, i))
+                    for i in range(min_len, max_len + 1)
+                ]
+            )
+        )
+
 
 # Run
 ###########################################################################
 if __name__ == "__main__":
-    logger.setLevel(10) # DEBUG
+    logger.setLevel(10) # DEBUG

absfuyu/general/human.py

@@ -3,8 +3,8 @@ Absfuyu: Human
 --------------
 Human related stuff
 
-Version: 1.2.4
-Date updated: 26/11/2023 (dd/mm/yyyy)
+Version: 1.3.0
+Date updated: 08/12/2023 (dd/mm/yyyy)
 """
 
 
@@ -28,6 +28,31 @@ from absfuyu.fun import zodiac_sign
 from absfuyu.version import Version
 
 
+# Sub-Class
+###########################################################################
+class _FloatBase:
+    """To show some unit"""
+
+    def __init__(self, value: float) -> None:
+        self.value = value
+
+    def __str__(self) -> str:
+        return self.value.__str__()
+
+    def to_float(self) -> float:
+        return float(self.value)
+
+
+class _Height(_FloatBase):
+    def __repr__(self) -> str:
+        return f"{self.value:.2f} cm"
+
+
+class _Weight(_FloatBase):
+    def __repr__(self) -> str:
+        return f"{self.value:.2f} kg"
+
+
 # Class
 ###########################################################################
 class BloodType:

absfuyu/util/performance.py

@@ -1,11 +1,10 @@
-# -*- coding: utf-8 -*-
 """
 Absfuyu: Performance
 --------------------
 Performance Check
 
-Version: 1.0.1
-Date updated: 24/11/2023 (dd/mm/yyyy)
+Version: 1.1.0
+Date updated: 11/12/2023 (dd/mm/yyyy)
 
 Feature:
 --------
@@ -21,16 +20,20 @@ __all__ = [
     # Wrapper
     "measure_performance",
     # Functions
-    "var_check", "source_this"
+    "var_check",
+    "source_this",
 ]
 
 
 # Library
 ###########################################################################
 from functools import wraps as __wraps
-from inspect import getsource as __source
+from inspect import getsource
 from time import perf_counter as __perf_counter
 import tracemalloc as __tracemalloc
+from typing import Any, Callable, List, Optional, Tuple, Union
+
+from absfuyu.general.data_extension import ListNoDunder
 
 
 # Function
@@ -47,7 +50,7 @@ def measure_performance(func):
     --------
     >>> @measure_performance
     >>> def test():
-    >>>     return 1 + 1
+    ...     return 1 + 1
     >>> test()
         ----------------------------------------
         Function: test
@@ -104,10 +107,20 @@ def measure_performance(func):
     return wrapper
 
 
-def var_check(variable):
+def var_check(variable: Any, full: bool = False):
     """
     Check a variable
-    
+
+    Parameters
+    ----------
+    variable : Any
+        Variable that needed to check
+
+    full : bool
+        | ``True``: Shows full detail
+        | ``False``: Hides ``dir`` and ``docstring``
+
+
     Example:
     --------
     >>> test = "test"
@@ -140,14 +153,22 @@ def var_check(variable):
             dict,
             set, frozenset,
             bool,
-            bytes,bytearray, memoryview,
-            type(None)
+            bytes, bytearray, memoryview,
+            type(None),
         ]
         if type(variable) in lc:
             pass
         else:
             docs = variable.__doc__
-            output["docstring"] = docs
+            if full:
+                output["docstring"] = docs
+    except:
+        pass
+
+    # Dir
+    try:
+        if full:
+            output["dir"] = ListNoDunder(variable.__dir__())
     except:
         pass
 
@@ -155,7 +176,7 @@ def var_check(variable):
     return output
 
 
-def source_this(function) -> str:
+def source_this(function: Callable) -> str:
     """
     Show the source code of a function
 
@@ -169,10 +190,76 @@ def source_this(function) -> str:
     str
         Source code
     """
-    return __source(function)
+    return getsource(function)
+
+
+# Class
+###########################################################################
+class Checker:
+    """Check a variable"""
+    def __init__(self, checker: Any) -> None:
+        self.item_to_check = checker
+    def __str__(self) -> str:
+        return self.item_to_check.__str__()
+    def __repr__(self) -> str:
+        return f"{self.__class__.__name__}({self.item_to_check})"
+
+    @property
+    def name(self) -> Union[Any, None]:
+        try:
+            return self.item_to_check.__name__
+        except:
+            return None
+
+    @property
+    def value(self) -> Any:
+        return self.item_to_check
+
+    @property
+    def docstring(self) -> Union[str, None]:
+        """:returns: ``self.item_to_check.__doc__``"""
+        return self.item_to_check.__doc__
+
+    @property
+    def class_(self) -> Any:
+        return type(self.item_to_check)
+
+    @property
+    def id_(self) -> int:
+        return id(self.item_to_check)
+
+    @property
+    def dir_(self) -> List[str]:
+        """:returns: ``dir(self.item_to_check)``"""
+        # return self.item_to_check.__dir__()
+        return ListNoDunder(self.item_to_check.__dir__())
+    
+    @property
+    def source(self) -> Union[str, None]:
+        """:returns: Source code"""
+        try:
+            return getsource(self.item_to_check)
+        except:
+            return None
+
+    def check(self, full: bool = False):
+        """
+        Check
+        """
+        out = {
+            "name": self.name,
+            "value": self.value,
+            "class": self.class_,
+            "id": self.id_,
+        }
+        if full:
+            out["dir"] = self.dir_
+            out["docs"] = self.docstring
+            out["source"] = self.source
+        return out
 
 
 # Run
 ###########################################################################
 if __name__ == "__main__":
-    pass
+    pass

{absfuyu-3.0.0.dist-info → absfuyu-3.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: absfuyu
-Version: 3.0.0
+Version: 3.1.0
 Summary: A small collection of code
 Author: somewhatcold (AbsoluteWinter)
 License: MIT License
@@ -59,19 +59,19 @@ Requires-Dist: typing-extensions >=4.0.1 ; python_version < "3.11"
 Provides-Extra: absfuyu-res
 Requires-Dist: absfuyu-res ; extra == 'absfuyu-res'
 Provides-Extra: all
-Requires-Dist: twine >=3.7.1 ; extra == 'all'
-Requires-Dist: sphinx >=7.0.0 ; extra == 'all'
-Requires-Dist: absfuyu-res ; extra == 'all'
-Requires-Dist: pandas ; extra == 'all'
-Requires-Dist: sphinx-rtd-theme ; extra == 'all'
+Requires-Dist: click >=8.0.0 ; extra == 'all'
 Requires-Dist: coverage ; extra == 'all'
-Requires-Dist: pytest >=6.2.5 ; extra == 'all'
-Requires-Dist: rich ; extra == 'all'
-Requires-Dist: colorama >=0.4 ; extra == 'all'
 Requires-Dist: black ; extra == 'all'
-Requires-Dist: click >=8.0.0 ; extra == 'all'
-Requires-Dist: numpy ; extra == 'all'
 Requires-Dist: build ; extra == 'all'
+Requires-Dist: sphinx-rtd-theme ; extra == 'all'
+Requires-Dist: colorama >=0.4 ; extra == 'all'
+Requires-Dist: pytest >=6.2.5 ; extra == 'all'
+Requires-Dist: twine >=3.7.1 ; extra == 'all'
+Requires-Dist: numpy ; extra == 'all'
+Requires-Dist: pandas ; extra == 'all'
+Requires-Dist: rich ; extra == 'all'
+Requires-Dist: sphinx >=7.0.0 ; extra == 'all'
+Requires-Dist: absfuyu-res ; extra == 'all'
 Provides-Extra: beautiful
 Requires-Dist: rich ; extra == 'beautiful'
 Provides-Extra: black
@@ -88,28 +88,28 @@ Requires-Dist: colorama >=0.4 ; extra == 'colorama'
 Provides-Extra: coverage
 Requires-Dist: coverage ; extra == 'coverage'
 Provides-Extra: dev
-Requires-Dist: twine >=3.7.1 ; extra == 'dev'
-Requires-Dist: sphinx >=7.0.0 ; extra == 'dev'
-Requires-Dist: sphinx-rtd-theme ; extra == 'dev'
+Requires-Dist: click >=8.0.0 ; extra == 'dev'
 Requires-Dist: coverage ; extra == 'dev'
-Requires-Dist: pytest >=6.2.5 ; extra == 'dev'
-Requires-Dist: rich ; extra == 'dev'
-Requires-Dist: colorama >=0.4 ; extra == 'dev'
 Requires-Dist: black ; extra == 'dev'
-Requires-Dist: click >=8.0.0 ; extra == 'dev'
 Requires-Dist: build ; extra == 'dev'
+Requires-Dist: sphinx-rtd-theme ; extra == 'dev'
+Requires-Dist: colorama >=0.4 ; extra == 'dev'
+Requires-Dist: pytest >=6.2.5 ; extra == 'dev'
+Requires-Dist: twine >=3.7.1 ; extra == 'dev'
+Requires-Dist: rich ; extra == 'dev'
+Requires-Dist: sphinx >=7.0.0 ; extra == 'dev'
 Provides-Extra: extra
 Requires-Dist: click >=8.0.0 ; extra == 'extra'
-Requires-Dist: numpy ; extra == 'extra'
 Requires-Dist: colorama >=0.4 ; extra == 'extra'
+Requires-Dist: numpy ; extra == 'extra'
 Requires-Dist: pandas ; extra == 'extra'
 Provides-Extra: full
-Requires-Dist: absfuyu-res ; extra == 'full'
-Requires-Dist: pandas ; extra == 'full'
-Requires-Dist: rich ; extra == 'full'
-Requires-Dist: colorama >=0.4 ; extra == 'full'
 Requires-Dist: click >=8.0.0 ; extra == 'full'
+Requires-Dist: colorama >=0.4 ; extra == 'full'
 Requires-Dist: numpy ; extra == 'full'
+Requires-Dist: pandas ; extra == 'full'
+Requires-Dist: rich ; extra == 'full'
+Requires-Dist: absfuyu-res ; extra == 'full'
 Provides-Extra: numpy
 Requires-Dist: numpy ; extra == 'numpy'
 Provides-Extra: pandas

{absfuyu-3.0.0.dist-info → absfuyu-3.1.0.dist-info}/RECORD

@@ -6,30 +6,30 @@ absfuyu/logger.py,sha256=EjAGnz_PReigh5kowvo1h89KzpIdyeacQG2JKipKZ5I,12883
 absfuyu/sort.py,sha256=f31514lwPnp2wipSG5E6rIoLXmCHLJlujr2_o65tJcQ,6498
 absfuyu/version.py,sha256=pF4rUiN_XTUfsKF6oYzhMWkOl3NsXfrN6bFAJA8bPPc,13962
 absfuyu/config/__init__.py,sha256=tQL7ZuiY1m4fqnKRVNKX7v85srdzE5KS18BcNWWRGgg,7956
-absfuyu/config/config.json,sha256=sCxwSzQt8T406iKZZD4DqTTVOz7ZyNLmhqi08dMqJys,791
+absfuyu/config/config.json,sha256=zO_uHCqtlBw0kOmMYX0khFhTKc6oNiPIrOH62-O8DME,791
 absfuyu/extensions/__init__.py,sha256=hxeZm3w00K4GC78cDTIo5ROWiWAZw4zEmlevfOqbNvo,146
 absfuyu/extensions/beautiful.py,sha256=zN1-_bHytW3ImIEimJhE4WRzsqf9D3l9z-GImYB0D68,5240
-absfuyu/extensions/dev/__init__.py,sha256=M36S76t7Piq5i7bLtCiDph6ZwarOrc07FDRMMGbJayE,2689
+absfuyu/extensions/dev/__init__.py,sha256=GDHf4ojXULZu8Py20R8roxSWL7gaC7Z65a1okwrFtp0,6424
 absfuyu/extensions/dev/password_hash.py,sha256=toVWZKJ__jOxcmPhKBs58aYhzLV_0cF4AWwNzgACfBo,1794
 absfuyu/extensions/dev/passwordlib.py,sha256=Eoywj0_1tu_ALvt6_csRPznQ03nzUGSWvk2HmLy4JXM,6796
 absfuyu/extensions/dev/pkglib.py,sha256=X_SniqZbE2MdPQoh9uItJo1JTRbn43y2a8hkVy3ofW8,2215
 absfuyu/extensions/dev/project_starter.py,sha256=l16FjIwD6ImYZRw08BitzhrKvugc9Q6PBEipj6XZa-8,1561
 absfuyu/extensions/dev/shutdownizer.py,sha256=EMsUytPABrt1s3hpfwaE2ZpDNQncwKo9EDiYy3QFcT0,132
 absfuyu/extensions/extra/__init__.py,sha256=8zkMYDaPvCamCU8AecKiaBhYv39xb43JhLqi8bNm9Tk,552
-absfuyu/extensions/extra/data_analysis.py,sha256=9GIMp3pQpMpA3Amz8XoDKsWaSh3B_vkh2Jtt9JDXL5w,10475
+absfuyu/extensions/extra/data_analysis.py,sha256=OQhR38wLCWblQRwZT25WkBgeALWgv2gANQN52PrOnUw,26826
 absfuyu/fun/WGS.py,sha256=tU6exyU2FeHB4AI0XqrKAB945XVNSb6NBGZFinjgNYg,9145
 absfuyu/fun/__init__.py,sha256=fAu2odcOx6YpGXTb7aS69V70oBC6VfYugErC6fVNI58,6249
-absfuyu/fun/tarot.py,sha256=xfpbnqQrguYBo4Z_blBdu46ERgC8DdOglVNrmcWxwas,2519
+absfuyu/fun/tarot.py,sha256=VHFYbpZT-Ktf4LcGqXm137jEPN_4_cCMugf4ZVv9lMQ,2554
 absfuyu/game/__init__.py,sha256=2J8k8ntI8wlHjNWSWbrktW4K2-vkB6oveyt177-kUtw,4663
 absfuyu/game/sudoku.py,sha256=ub51EwTlfQLqw9la4HxfZdFE6aJXyPotXwOZ1W9h9_g,10450
 absfuyu/game/tictactoe.py,sha256=nSVTnCWEy9d5Jeo3KRb3mfeR1pzWNmKxTa5JC7usQ-Y,15278
-absfuyu/game/tictactoe2.py,sha256=oecwIZL-PjJu1mVSq2j6K-Xkqf60n6HOkd5niSAflWY,9517
+absfuyu/game/tictactoe2.py,sha256=lV1hJhS-qn8jLTo-C8M0wUnv27L2CW-AM_ohBLlWRiY,9639
 absfuyu/game/wordle.py,sha256=ZohB73nQ7iCHMdReBtZ9bHFz6_DVKrsxeB9PbnV7L_s,101133
 absfuyu/general/__init__.py,sha256=9L83GlWKZbYEAo_rDLEhet-ILOOZ4p5KH0jGaKXgYPg,2026
 absfuyu/general/content.py,sha256=8ox5HlDuYqVuUO38BmfpIqE0t7f80mB5a6fGDFfc20c,17375
-absfuyu/general/data_extension.py,sha256=1j7nmK8YEodi_9fD9fWzLtrI3ys1oP0rJugIIEJgNv4,40103
-absfuyu/general/generator.py,sha256=h5ZEUg_6G8kU8o_E6P-0cgJ1S5ItZtULYmazFIBqJas,7844
-absfuyu/general/human.py,sha256=yqZ-vqlvt-R17UKKplK92OVNYG3rKaiEBxIpVb8Ve9U,9026
+absfuyu/general/data_extension.py,sha256=uWUuKBjbhn6tsETX22R1pGU5ttk_w_yN8l3UGvh4Ol0,43657
+absfuyu/general/generator.py,sha256=Lm4MKXOCB6orXhCk1LgrZ_Tq8aMewJqaB6PikBB2ONY,9806
+absfuyu/general/human.py,sha256=WKlCYOA9lPRsWDDKXc2yAqwE_VzmMdurqQKkSX7yXV8,9591
 absfuyu/pkg_data/__init__.py,sha256=eIJGI9iXlJ6EqoNqjo2oB9HZ8KJ7lLK48SFyYWKbon8,4929
 absfuyu/pkg_data/chemistry.pkl,sha256=kYWNa_PVffoDnzT8b9Jvimmf_GZshPe1D-SnEKERsLo,4655
 absfuyu/pkg_data/tarot.pkl,sha256=ssXTCC_BQgslO5F-3a9HivbxFQ6BioIe2E1frPVi2m0,56195
@@ -44,12 +44,12 @@ absfuyu/util/api.py,sha256=h0J-RCNM1qJOwIgNuv-dPgCBvUpwgk1M1VO6m-7_0bI,4217
 absfuyu/util/json_method.py,sha256=QMgMVe4mSKXMzGFpHLsfMrusphDlei7uAWntZSbggxQ,2695
 absfuyu/util/lunar.py,sha256=Pr2wJa4JPkmKjINJOKrXx43Cco7p-3uSl_nSq0XsdwM,13839
 absfuyu/util/path.py,sha256=0MDyr0WK827WsP2IogaR0_V8Tea5ZVDf7ceBhdzNtzE,13438
-absfuyu/util/performance.py,sha256=fLE4kMuR9_D2E1-UdrVEygWIeXXOF2vW9ReP1rS3uN4,4283
+absfuyu/util/performance.py,sha256=qtdGy9Vtf38tjY2MAO4G8KywqkzkSMpfmvzYu1VnkYw,6561
 absfuyu/util/pkl.py,sha256=3lDaXrhOaa-8tMv4YYAXd-cbfzbmSwQsmVolN9i0FoA,1577
 absfuyu/util/zipped.py,sha256=F_h-1cDYqlhZFZlmkyLPxLwyuHALOe-tyaEI4Xu2Pvs,2529
-absfuyu-3.0.0.dist-info/LICENSE,sha256=V0E-QreSFFwyrt5YpB6Q4ifIfQkEOlEk0P7Hmc9ZQvU,1076
-absfuyu-3.0.0.dist-info/METADATA,sha256=toe2K4h2N2HYNdIdtmt9W0PdOU2ku3rT2xNjXR_QepY,8185
-absfuyu-3.0.0.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-absfuyu-3.0.0.dist-info/entry_points.txt,sha256=KutJbJf591TkDp3b2Llhc7r6fA8K8ELs6rL7sRJTl7I,47
-absfuyu-3.0.0.dist-info/top_level.txt,sha256=1Ud2uJ8XBmohoDfY4NqUpbuIMWMS3LowF_51uwUniY8,8
-absfuyu-3.0.0.dist-info/RECORD,,
+absfuyu-3.1.0.dist-info/LICENSE,sha256=V0E-QreSFFwyrt5YpB6Q4ifIfQkEOlEk0P7Hmc9ZQvU,1076
+absfuyu-3.1.0.dist-info/METADATA,sha256=VHd_XOgnNLd2RnUM02edyY9nbeZEc4AabeSA0_-xXy8,8185
+absfuyu-3.1.0.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+absfuyu-3.1.0.dist-info/entry_points.txt,sha256=KutJbJf591TkDp3b2Llhc7r6fA8K8ELs6rL7sRJTl7I,47
+absfuyu-3.1.0.dist-info/top_level.txt,sha256=1Ud2uJ8XBmohoDfY4NqUpbuIMWMS3LowF_51uwUniY8,8
+absfuyu-3.1.0.dist-info/RECORD,,