danielutils 0.9.6__tar.gz → 0.9.62__tar.gz

{danielutils-0.9.6 → danielutils-0.9.62}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: danielutils
-Version: 0.9.6
+Version: 0.9.62
 Summary: A python utils library for things I find useful
 Home-page: https://github.com/danielnachumdev/danielutils
 Author: danielnachumdev
@@ -36,7 +36,6 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: Microsoft :: Windows
 Requires-Python: >=3.8.17
 Description-Content-Type: text/markdown
-Requires-Dist: tqdm
 
 
 [![Python package](https://github.com/danielnachumdev/danielutils/actions/workflows/python-package.yml/badge.svg)](https://github.com/danielnachumdev/danielutils/actions/workflows/python-package.yml)
@@ -44,7 +43,7 @@ Requires-Dist: tqdm
 [![Python 3.10.11](https://img.shields.io/badge/python-3.10.11-blue.svg)](https://www.python.org/downloads/release/python-31011/)
 [![gitleaks](https://github.com/danielnachumdev/danielutils/actions/workflows/gitleaks.yml/badge.svg)](https://github.com/danielnachumdev/danielutils/actions/workflows/gitleaks.yml)
 [![CodeQL](https://github.com/danielnachumdev/danielutils/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/danielnachumdev/danielutils/actions/workflows/github-code-scanning/codeql)
-# danielutils v=0.9.6
+# danielutils v=0.9.62
 A utils library for things that I find useful for my coding workflow.\
 Feel free to use and / or contribute / improve my code :)
 

{danielutils-0.9.6 → danielutils-0.9.62}/README.md

@@ -4,7 +4,7 @@
 [![Python 3.10.11](https://img.shields.io/badge/python-3.10.11-blue.svg)](https://www.python.org/downloads/release/python-31011/)
 [![gitleaks](https://github.com/danielnachumdev/danielutils/actions/workflows/gitleaks.yml/badge.svg)](https://github.com/danielnachumdev/danielutils/actions/workflows/gitleaks.yml)
 [![CodeQL](https://github.com/danielnachumdev/danielutils/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/danielnachumdev/danielutils/actions/workflows/github-code-scanning/codeql)
-# danielutils v=0.9.6
+# danielutils v=0.9.62
 A utils library for things that I find useful for my coding workflow.\
 Feel free to use and / or contribute / improve my code :)
 

danielutils-0.9.62/danielutils/Classes/__init__.py

@@ -0,0 +1,6 @@
+from .sorted_builtins import *
+from .typed_builtins import *
+from .convenience import *
+from .frange import *
+from .counter import *
+from .repl import *

{danielutils-0.9.6/danielutils/classes → danielutils-0.9.62/danielutils/Classes}/frange.py

@@ -49,7 +49,7 @@ class brange(frange):
     def __iter__(self):
         itr = super().__iter__()
         try:
-            from tqdm import tqdm  # type:ignore  # pylint: disable=import-error
+            from my_tqdm import tqdm  # type:ignore  # pylint: disable=import-error
             return iter(tqdm(itr, desc=f"{self}", total=len(self)))
         except:
             return itr

danielutils-0.9.6/danielutils/classes/Shell.py → danielutils-0.9.62/danielutils/Classes/repl.py

@@ -35,7 +35,7 @@ class Command:
         return self.callback(*args, **kwargs)
 
 
-class Shell:
+class REPL:
     """a class to easily create a shell application and get functionality for free
     """
 
@@ -82,7 +82,7 @@ class Shell:
 
 
 __all__ = [
-    "Shell",
+    "REPL",
     "Command",
     "Argument"
 ]

danielutils-0.9.62/danielutils/Conversions/__init__.py

@@ -0,0 +1,2 @@
+from .main_conversions import *
+from .specialized_conversions import *

{danielutils-0.9.6/danielutils/conversions/SpecializedConversions → danielutils-0.9.62/danielutils/Conversions/specialized_conversions}/to_hex.py

@@ -1,5 +1,5 @@
 from ...metaclasses.OverloadMeta import OverloadMeta
-from ..MainConversions import int_to_hex, char_to_hex
+from ..main_conversions import int_to_hex, char_to_hex
 
 
 @OverloadMeta.overload

{danielutils-0.9.6/danielutils/conversions/SpecializedConversions → danielutils-0.9.62/danielutils/Conversions/specialized_conversions}/to_int.py

@@ -1,6 +1,6 @@
 """functions that convert values to int"""
 from typing import Union, List as t_list
-from ..MainConversions import char_to_int
+from ..main_conversions import char_to_int
 from ...reflection import get_python_version
 if get_python_version() >= (3, 9):
     from builtins import list as t_list

{danielutils-0.9.6/danielutils/decorators → danielutils-0.9.62/danielutils/Decorators}/__init__.py

@@ -11,3 +11,4 @@ from .chain_decorators import *
 from .threadify import *
 from .delay_call import *
 from .deprecate import *
+from .processify import *

danielutils-0.9.62/danielutils/Decorators/processify.py

@@ -0,0 +1,57 @@
+import inspect
+import functools
+import multiprocessing
+
+from ..reflection import get_n_caller_func, get_current_frame, get_n_prev_frame
+from ..multi_x import process_id
+import pickle
+
+
+def processify(func):
+    """Modifies the function so that when calling it, a new process
+    will start to run it with provided arguments. Note that no return
+    value will be given.
+
+    Args:
+        func (Callable): the function to make a process
+
+    Returns:
+        Callable: the modified function
+    """
+    multiprocessing.freeze_support()
+
+    @functools.wraps(func)
+    def wrapper(*args, **kwargs):
+        main_pid = kwargs.get("__main_pid", process_id())
+        if process_id() == main_pid:
+            frame = get_n_prev_frame(2)
+            dct = {k: v for k, v in frame.f_globals.items() if type(v) != type(inspect)}
+            p = multiprocessing.Process(target=_run_func, args=(main_pid, dct, func.__name__, args, kwargs))
+            p.start()
+            p.join()  # Optionally wait for the process to finish
+        else:
+            del kwargs["__main_pid"]
+            return func(*args, **kwargs)
+
+    return wrapper
+
+
+
+def _run_func(main_pid: int, dct: dict, func_name: str, args, kwargs) -> None:
+    return dct[func_name](*args, __main_pid=main_pid, **kwargs)
+
+def debug_info(include_builtins: bool = False) -> dict:
+    f = get_n_prev_frame(2)
+    g = {k: v for k, v in f.f_globals.items() if k != "__builtins__"} if not include_builtins else dict(f.f_globals)
+    return {
+        "file": f.f_code.co_filename,
+        "function": f.f_code.co_qualname,
+        "line": f.f_lineno,
+        "globals": g,
+        "locals": dict(f.f_locals)
+    }
+
+
+__all__ = [
+    "processify"
+]

{danielutils-0.9.6/danielutils/functions → danielutils-0.9.62/danielutils/Functions}/isoftype.py

@@ -171,9 +171,6 @@ def __handle_callable(params: tuple) -> bool:
     if len(t_args) == 0:
         return True
 
-    obj_return_type = obj_hints.get('return')
-    obj_param_types = list(obj_hints.values())[:-1] if obj_hints else None
-    t_return_type = t_args[1]
     if get_python_version() < (3, 9):
         if isoftype(t_args[0][0], [ParamSpec, concatenate_t]):
             return True
@@ -181,6 +178,10 @@ def __handle_callable(params: tuple) -> bool:
         if isoftype(t_args[0], [ParamSpec, concatenate_t]):
             return True
 
+    obj_return_type = obj_hints.get('return')
+    obj_param_types = list(obj_hints.values())[:-1] if obj_hints else None
+    t_return_type = t_args[1]
+
     if isinstance(t_args[0], Iterable):
         t_param_types = list(t_args[0])
         A = obj_param_types + [obj_return_type] if obj_param_types else None

{danielutils-0.9.6/danielutils/metaclasses → danielutils-0.9.62/danielutils/MetaClasses}/InstanceCacheMeta.py

@@ -1,4 +1,4 @@
-from ..classes.Counter import Counter
+from ..classes.counter import Counter
 
 
 class InstanceCacheMeta(type):

{danielutils-0.9.6/danielutils/reflection → danielutils-0.9.62/danielutils/Reflection}/Class.py

@@ -1,7 +1,12 @@
 import inspect
+from ..reflection import get_python_version
+if get_python_version() >= (3, 9):
+    from builtins import list as t_list  # type:ignore
+else:
+    from typing import List as t_list
 
 
-def get_explicitly_declared_functions(cls: type) -> list[str]:
+def get_explicitly_declared_functions(cls: type) -> t_list[str]:
     """
     Returns the names of the functions that are explicitly declared in a class.
 

{danielutils-0.9.6/danielutils/reflection → danielutils-0.9.62/danielutils/Reflection}/File.py

@@ -2,7 +2,7 @@ import inspect
 import os
 from typing import Optional, cast
 from types import FrameType
-from .get_prev_frame import get_prev_frame
+from .get_prev_frame import get_prev_frame_from
 
 
 def get_filename() -> Optional[str]:
@@ -11,7 +11,7 @@ def get_filename() -> Optional[str]:
     Returns:
         Optional[str]: name of file
     """
-    frame = get_prev_frame(inspect.currentframe())
+    frame = get_prev_frame_from(inspect.currentframe())
     if frame is None:
         return None
     frame = cast(FrameType, frame)
@@ -25,7 +25,7 @@ def get_caller_filename() -> Optional[str]:
     Returns:
         Optional[str]: name of file
     """
-    frame = get_prev_frame(get_prev_frame(inspect.currentframe()))
+    frame = get_prev_frame_from(get_prev_frame_from(inspect.currentframe()))
     if frame is None:
         return None
     frame = cast(FrameType, frame)

{danielutils-0.9.6/danielutils/reflection → danielutils-0.9.62/danielutils/Reflection}/Function.py

@@ -1,9 +1,9 @@
 import inspect
 from typing import cast, Optional, Callable, Any
 from types import FrameType
-from .get_prev_frame import get_prev_frame
-
+from .get_prev_frame import get_prev_frame_from, get_n_prev_frame
 from ..reflection import get_python_version
+
 if get_python_version() < (3, 9):
     from typing import List as t_list, Set as t_set  # pylint: disable=ungrouped-imports
 else:
@@ -22,32 +22,12 @@ def get_caller_name(steps_back: int = 0) -> Optional[str]:
         raise TypeError("steps_back must be an int")
     if steps_back < 0:
         raise ValueError("steps_back must be a non-negative integer")
-    # different implementation:
-
-    # RGX = r'File ".*", line \d+, in (.+)\n'
-    # # traceback_list = get_traceback()
-    # # callee_frame = traceback_list[-1]
-    # # callee_name = re.search(RGX, callee_frame).group(1)
-    # # caller_frame = traceback_list[-2]
-    # # caller_name = re.search(RGX, caller_frame).group(1)
-
-    # this is more readable:
-
-    # current_frame = inspect.currentframe()
-    # callee_frame = current_frame.f_back
-    # # callee_name = callee_frame.f_code.co_name
-    # caller_frame = callee_frame.f_back
-    # caller_name = caller_frame.f_code.co_name
-    # return caller_name
-    frame = get_prev_frame(get_prev_frame(inspect.currentframe()))
-    if frame is None:
+    if (frame := get_n_prev_frame(2)) is None:
         return None
     frame = cast(FrameType, frame)
     while steps_back > 0:
-        frame = get_prev_frame(frame)
-        if frame is None:
+        if (frame := cast(FrameType, get_prev_frame_from(frame))) is None:
             return None
-        frame = cast(FrameType, frame)
         steps_back -= 1
     return frame.f_code.co_name
 
@@ -114,6 +94,40 @@ def is_function_annotated_properly(func: Callable, ignore: Optional[set] = None,
     return True
 
 
+def get_current_func():
+    caller_frame = get_n_prev_frame(2)
+    caller_name = caller_frame.f_code.co_name
+    caller_func = caller_frame.f_globals[caller_name]
+    return caller_func
+
+
+def get_caller_func() -> Optional[Callable]:
+    caller_frame = get_n_prev_frame(3)
+    if (caller_name := caller_frame.f_code.co_name) == "<module>":
+        return None
+    caller_func = caller_frame.f_globals[caller_name]
+    return caller_func
+
+
+import json
+
+
+def get_n_caller_func(n_steps: int = 1) -> Optional[Callable]:
+    caller_frame = get_n_prev_frame(2 + n_steps)
+    # print(json.dumps(dict(caller_frame.f_globals), default=str, indent=4))
+    if (caller_name := caller_frame.f_code.co_name) == "<module>":
+        return None
+    caller_func = caller_frame.f_globals[caller_name]
+    return caller_func
+
+
+def get_caller_module_name() -> Optional[str]:
+    caller_func = get_caller_func()
+    if caller_func is None:
+        return None
+    return caller_func.__module__
+
+
 def get_mro(obj: Any) -> t_list[type]:
     """returns the mro of an object
 
@@ -132,5 +146,9 @@ __all__ = [
     "get_caller_name",
     "get_function_return_type",
     "is_function_annotated_properly",
-    "get_mro"
+    "get_mro",
+    "get_current_func",
+    "get_caller_func",
+    "get_n_caller_func",
+    "get_caller_module_name"
 ]

{danielutils-0.9.6/danielutils/reflection → danielutils-0.9.62/danielutils/Reflection}/__init__.py

@@ -4,7 +4,7 @@ from .Function import *
 from .get_traceback import *
 from .Module import *
 from .Class import *
-
+from .get_prev_frame import *
 # def get_class(module_name: str, class_name: str) -> type:
 #     """dynammically loads the module and returns the class from this file
 

danielutils-0.9.62/danielutils/Reflection/get_prev_frame.py

@@ -0,0 +1,30 @@
+import inspect
+from typing import Optional
+from types import FrameType
+
+
+def get_current_frame() -> Optional[FrameType]:
+    return get_prev_frame_from(inspect.currentframe())
+
+
+def get_prev_frame_from(frame: Optional[FrameType]) -> Optional[FrameType]:
+    """Get the previous frame (caller's frame) in the call stack."""
+    return frame.f_back if frame is not None else None
+
+
+def get_n_prev_frame(n_steps: int = 1) -> Optional[FrameType]:
+    if (f := get_current_frame()) is None:
+        return None
+    i = 0
+    while i < n_steps:
+        if (f := f.f_back) is None:
+            return None
+        i += 1
+    return f
+
+
+__all__ = [
+    "get_current_frame",
+    "get_prev_frame_from",
+    "get_n_prev_frame"
+]

danielutils-0.9.6/danielutils/time.py → danielutils-0.9.62/danielutils/Time.py

@@ -1,7 +1,12 @@
+import time
 from datetime import datetime
 from typing import Callable, TypeVar
-from typing_extensions import ParamSpec
-import time
+from .reflection import get_python_version
+
+if get_python_version() < (3, 9):
+    from typing_extensions import ParamSpec
+else:
+    from typing import ParamSpec  # type:ignore # pylint: disable=ungrouped-imports
 T = TypeVar("T")
 P = ParamSpec("P")
 
@@ -15,11 +20,13 @@ def measure(func: Callable[P, T]) -> Callable[P, float]:
     Returns:
         float: The time taken in seconds to execute the given function.
     """
+
     def wrapper(*args, **kwargs) -> float:
         start = time.time()
         func(*args, **kwargs)
         end = time.time()
-        return end-start
+        return end - start
+
     return wrapper
 
 

{danielutils-0.9.6 → danielutils-0.9.62}/danielutils/__init__.py

@@ -19,12 +19,13 @@ from .print import *
 from .exceptions import PrintCatchOne
 from .reflection import *
 from .metaclasses import *
-from .datetime import *
+from .date_time import *
 from .generators import *
 from .snippets import *
 from .aliases import *
 from .signals import *
 from .university import *
-from .tqdm import tqdm
-from .threading import *
+from .my_tqdm import *
+from .threads import *
 from .loops import *
+from .multi_x import *

danielutils-0.9.62/danielutils/data_structures/__init__.py

@@ -0,0 +1,7 @@
+from .queue import *
+from .heap import *
+from .comparer import *
+from .node import *
+from .graph import *
+from .stack import *
+from .default_dict import *

danielutils-0.9.62/danielutils/data_structures/default_dict.py

@@ -0,0 +1,16 @@
+"""
+My implementation to collections.defaultdict
+"""
+
+
+class DefaultDict(dict):
+    def __init__(self, cls):
+        self._cls = cls
+
+    def __getitem__(self, key):
+        return super().get(key, self._cls())
+
+
+__all__ = [
+    "DefaultDict"
+]

danielutils-0.9.6/danielutils/data_structures/Graph.py → danielutils-0.9.62/danielutils/data_structures/graph.py

@@ -1,6 +1,6 @@
 from typing import Optional, Generator, List as t_list, Set as t_set
-from .Queue import Queue
-from .Node import MultiNode
+from .queue import Queue
+from .node import MultiNode
 from ..reflection import get_python_version
 if get_python_version() >= (3, 9):
     from builtins import list as t_list, set as t_set

danielutils-0.9.6/danielutils/data_structures/Heap.py → danielutils-0.9.62/danielutils/data_structures/heap.py

@@ -1,5 +1,5 @@
 from typing import Any, Union
-from .Comparer import Comparer, CompareGreater, CompareSmaller
+from .comparer import Comparer, CompareGreater, CompareSmaller
 
 
 class Heap:

danielutils-0.9.6/danielutils/data_structures/Queue.py → danielutils-0.9.62/danielutils/data_structures/queue.py

@@ -1,6 +1,6 @@
 from typing import Callable, Any, Union
-from .Heap import Heap
-from .Comparer import Comparer, CompareGreater
+from .heap import Heap
+from .comparer import Comparer, CompareGreater
 from .functions import default_weight_function
 from ..metaclasses import AtomicClassMeta
 

danielutils-0.9.6/danielutils/data_structures/Stack.py → danielutils-0.9.62/danielutils/data_structures/stack.py

@@ -1,5 +1,5 @@
 from typing import Optional, Generator, Any, cast
-from .Node import Node
+from .node import Node
 
 
 class Stack:

danielutils-0.9.62/danielutils/multi_x.py

@@ -0,0 +1,16 @@
+import os
+import threading
+
+
+def process_id() -> int:
+    return os.getpid()
+
+
+def thread_id() -> int:
+    return threading.get_ident()
+
+
+__all__ = [
+    "process_id",
+    "thread_id"
+]

danielutils-0.9.6/danielutils/tqdm.py → danielutils-0.9.62/danielutils/my_tqdm.py

@@ -1,10 +1,15 @@
 from typing import Optional
 from tqdm import tqdm
+from .reflection import get_python_version
+if get_python_version() >= (3, 9):
+    from builtins import list as t_list  # type:ignore
+else:
+    from typing import List as t_list
 
 
 class ProgressBarPool:
-    def __init__(self, num_of_bars: int = 1, *, global_options: Optional[dict] = None, individual_options: Optional[list[Optional[dict]]] = None) -> None:
-        self.bars: list[tqdm] = []
+    def __init__(self, num_of_bars: int = 1, *, global_options: Optional[dict] = None, individual_options: Optional[t_list[Optional[dict]]] = None) -> None:
+        self.bars: t_list[tqdm] = []
         if global_options is None:
             global_options = {}
         if individual_options is None:

{danielutils-0.9.6/danielutils/threading → danielutils-0.9.62/danielutils/threads}/worker.py

@@ -3,6 +3,11 @@ from abc import ABC, abstractmethod
 from typing import Optional, Any
 from logging import error
 import danielutils
+from ..reflection import get_python_version
+if get_python_version() >= (3, 9):
+    from builtins import tuple as t_tuple  # type:ignore
+else:
+    from typing import Tuple as t_tuple
 
 
 class Worker(ABC):
@@ -47,16 +52,16 @@ class Worker(ABC):
         execution of a single job
         """
         self._work(obj)
-        self.notify()
+        self._notify()
 
-    def notify(self) -> None:
+    def _notify(self) -> None:
         """utility method to be called on the end of each iteration of work 
         to signal actions if needed
         will call 'notification_function'
         """
         self.pool._notify()  # pylint: disable=protected-access
 
-    def acquire(self) -> Optional[tuple[Any]]:
+    def acquire(self) -> Optional[t_tuple[Any]]:
         """acquire a new job object to work on from the pool
         will return a tuple of only one object (the job) or None if there are no more jobs
         Returns:

{danielutils-0.9.6/danielutils/threading → danielutils-0.9.62/danielutils/threads}/worker_pool.py

@@ -2,18 +2,23 @@ from queue import Queue
 from typing import Optional, Any
 from threading import Semaphore
 from .worker import Worker
+from ..reflection import get_python_version
+if get_python_version() >= (3, 9):
+    from builtins import type as t_type, tuple as t_tuple, list as t_list  # type:ignore
+else:
+    from typing import Type as t_type, Tuple as t_tuple, List as t_list
 
 
 class WorkerPool:
     """A worker pool class
     """
 
-    def __init__(self, num_workers: int, worker_class: type[Worker], w_kwargs: dict, global_variables: dict) -> None:
+    def __init__(self, num_workers: int, worker_class: t_type[Worker], w_kwargs: dict, global_variables: dict) -> None:
         self.num_workers = num_workers
         self.global_variables: dict = global_variables
-        self.q: Queue[tuple[Any]] = Queue()
+        self.q: Queue[t_tuple[Any]] = Queue()
         self.worker_class = worker_class
-        self.workers: list[Worker] = []
+        self.workers: t_list[Worker] = []
         self.sem = Semaphore(0)
         self.w_kwargs = w_kwargs
 
@@ -30,7 +35,7 @@ class WorkerPool:
         self.q.put((job,))
         self.sem.release()
 
-    def _acquire(self) -> Optional[tuple[Any]]:
+    def _acquire(self) -> Optional[t_tuple[Any]]:
         """acquire a new job from the pool
 
         Returns:
@@ -57,6 +62,10 @@ class WorkerPool:
         if self.q.unfinished_tasks <= 0:
             self.sem.release(self.num_workers)
 
+    def join(self) -> None:
+        for w in self.workers:
+            w.thread.join()
+
 
 __all__ = [
     "WorkerPool"

{danielutils-0.9.6 → danielutils-0.9.62}/danielutils.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: danielutils
-Version: 0.9.6
+Version: 0.9.62
 Summary: A python utils library for things I find useful
 Home-page: https://github.com/danielnachumdev/danielutils
 Author: danielnachumdev
@@ -36,7 +36,6 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: Microsoft :: Windows
 Requires-Python: >=3.8.17
 Description-Content-Type: text/markdown
-Requires-Dist: tqdm
 
 
 [![Python package](https://github.com/danielnachumdev/danielutils/actions/workflows/python-package.yml/badge.svg)](https://github.com/danielnachumdev/danielutils/actions/workflows/python-package.yml)
@@ -44,7 +43,7 @@ Requires-Dist: tqdm
 [![Python 3.10.11](https://img.shields.io/badge/python-3.10.11-blue.svg)](https://www.python.org/downloads/release/python-31011/)
 [![gitleaks](https://github.com/danielnachumdev/danielutils/actions/workflows/gitleaks.yml/badge.svg)](https://github.com/danielnachumdev/danielutils/actions/workflows/gitleaks.yml)
 [![CodeQL](https://github.com/danielnachumdev/danielutils/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/danielnachumdev/danielutils/actions/workflows/github-code-scanning/codeql)
-# danielutils v=0.9.6
+# danielutils v=0.9.62
 A utils library for things that I find useful for my coding workflow.\
 Feel free to use and / or contribute / improve my code :)