python-argtools 0.0.1__tar.gz → 0.0.3__tar.gz

{python_argtools-0.0.1 → python_argtools-0.0.3}/PKG-INFO

@@ -1,27 +1,28 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: python-argtools
-Version: 0.0.1
+Version: 0.0.3
 Summary: Python argument tools.
-Home-page: https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/python-argtools
 License: MIT
+License-File: LICENSE
 Keywords: argument,tools
 Author: ChenyangGao
 Author-email: wosiwujm@gmail.com
-Requires-Python: >=3.10,<4.0
+Requires-Python: >=3.12,<4.0
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Project-URL: Repository, https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/python-argtools
+Project-URL: Homepage, https://github.com/ChenyangGao/python-modules/tree/main/python-argtools
+Project-URL: Repository, https://github.com/ChenyangGao/python-modules/tree/main/python-argtools
 Description-Content-Type: text/markdown
 
 # Python argument tools.
@@ -31,7 +32,7 @@ Description-Content-Type: text/markdown
 You can install from [pypi](https://pypi.org/project/python-argtools/)
 
 ```console
-pip install -U argtools
+pip install -U python-argtools
 ```
 
 ## Usage

{python_argtools-0.0.1 → python_argtools-0.0.3}/argtools/__init__.py

@@ -6,68 +6,88 @@ some arguments at one time and then use them repeatedly later.
 """
 
 __author__ = "ChenyangGao <https://chenyanggao.github.io>"
-__version__ = (0, 0, 1)
-__all__ = ["argcount", "Args", "UpdativeArgs"]
+__version__ = (0, 0, 3)
+__all__ = ["argcount", "Args", "UpdativeArgs", "Call"]
 
 from collections.abc import Callable
 from copy import copy
+from functools import partial, update_wrapper
 from inspect import getfullargspec
-from typing import Any, Callable, Generic, ParamSpec, TypeVar
+from types import MethodType, MethodWrapperType
+from typing import Any
 
 
-T = TypeVar("T")
-P = ParamSpec("P")
-
-
-def argcount(func: Callable) -> int:
+def argcount(func: Callable, /) -> int:
+    if isinstance(func, partial):
+        return max(0, argcount(func.func) - len(func.args))
+    is_method = isinstance(func, (MethodType, MethodWrapperType))
     try:
-        return func.__code__.co_argcount
+        return func.__code__.co_argcount - is_method
     except AttributeError:
-        return len(getfullargspec(func).args)
+        return len(getfullargspec(func).args) - is_method
 
 
-class Args(Generic[T, P]):
+class Args:
     """Takes some positional arguments and keyword arguments, 
     and put them into an instance, which can be used repeatedly 
     every next time.
 
     Fields::
-        self.pargs: the collected positional arguments
-        self.kargs: the collected keyword arguments
+        self.args: the collected positional arguments
+        self.kwargs: the collected keyword arguments
     """
-    __slots__ = ("pargs", "kargs")
+    __slots__ = ("args", "kwargs")
 
-    def __init__(self, /, *pargs, **kargs):
-        self.pargs: P.args = pargs
-        self.kargs: P.kwargs = kargs
+    def __init__(self, /, *args, **kwargs):
+        self.args = args
+        self.kwargs = kwargs
 
-    def __call__(self, /, func: Callable[..., T]) -> T:
+    def __call__[T](self, /, func: Callable[..., T]) -> T:
         """Pass in the collected positional arguments and keyword 
         arguments when calling the callable `func`."""
-        return func(*self.pargs, **self.kargs)
+        return func(*self.args, **self.kwargs)
 
     def __copy__(self, /):
-        return type(self)(*self.pargs, **self.kargs)
+        return type(self)(*self.args, **self.kwargs)
 
     def __eq__(self, other):
         if isinstance(other, Args):
-            return self.pargs == other.pargs and self.kargs == other.kargs
+            return self.args == other.args and self.kwargs == other.kwargs
         return False
 
+    def __getitem__(self, idx: int | slice | str | tuple[int | slice | str, ...], /):
+        cls = type(self)
+        pget = self.args.__getitem__
+        if isinstance(idx, (int, slice)):
+            return cls(pget(idx))
+        kget = self.kwargs.__getitem__
+        if isinstance(idx, str):
+            return cls(idx=kget(idx))
+        else:
+            pargs: list = []
+            kargs: dict = {}
+            add_parg = pargs.append
+            for idx_ in idx:
+                if isinstance(idx_, (int, slice)):
+                    add_parg(pget(idx_))
+                else:
+                    kargs[idx_] = kget(idx_)
+            return cls(*pargs, **kargs)
+
     def __iter__(self, /):
-        return iter((self.pargs, self.kargs))
+        return iter((self.args, self.kwargs))
 
     def __repr__(self):
         return "%s(%s)" % (
             type(self).__qualname__,
             ", ".join((
-                *map(repr, self.pargs),
-                *("%s=%r" % e for e in self.kargs.items()),
+                *map(repr, self.args),
+                *("%s=%r" % e for e in self.kwargs.items()),
             )),
         )
 
     @classmethod
-    def call(cls, /, func: Callable[..., T], args: Any = ()) -> T:
+    def call[T](cls, /, func: Callable[..., T], args: Any = ()) -> T:
         """Call the callable `func` and pass in the arguments `args`.
 
         The actual behavior as below:
@@ -81,12 +101,13 @@ class Args(Generic[T, P]):
         """
         if isinstance(args, Args):
             return args(func)
-        type_ = type(args)
-        if type_ is tuple:
+        args_type = type(args)
+        if args_type == tuple:
             return func(*args)
-        elif type_ is dict:
+        elif args_type == dict:
             return func(**args)
-        return func(args)
+        else:
+            return func(args)
 
 
 class UpdativeArgs(Args):
@@ -97,12 +118,12 @@ class UpdativeArgs(Args):
     collected arguments.
 
     Fields::
-        self.pargs: the collected positional arguments
-        self.kargs: the collected keyword arguments
+        self.args: the collected positional arguments
+        self.kwargs: the collected keyword arguments
     """
-    __slots__ = ("pargs", "kargs")
+    __slots__ = ("args", "kwargs")
 
-    def extend(self, /, *pargs, **kargs):
+    def extend(self, /, *args, **kwargs):
         """Extend the collected arguments.
 
         Examples::
@@ -113,17 +134,17 @@ class UpdativeArgs(Args):
         >>> args is args2
         True
         """
-        if pargs:
-            self.pargs += pargs
-        if kargs:
-            kargs0 = self.kargs
-            kargs0.update(
-                (k, kargs[k])
-                for k in kargs.keys() - kargs0.keys()
+        if args:
+            self.args += args
+        if kwargs:
+            kwargs0 = self.kwargs
+            kwargs0.update(
+                (k, kwargs[k])
+                for k in kwargs.keys() - kwargs0.keys()
             )
         return self
 
-    def copy_extend(self, /, *pargs, **kargs):
+    def copy_extend(self, /, *args, **kwargs):
         """Extend the collected arguments in a copied instance.
 
         Examples::
@@ -134,9 +155,9 @@ class UpdativeArgs(Args):
         >>> args is args2
         False
         """
-        return copy(self).extend(*pargs, **kargs)
+        return copy(self).extend(*args, **kwargs)
 
-    def prepend(self, /, *pargs, **kargs):
+    def prepend(self, /, *args, **kwargs):
         """Prepend the collected arguments.
 
         Examples::
@@ -147,13 +168,13 @@ class UpdativeArgs(Args):
         >>> args is args2
         True
         """
-        if pargs:
-            self.pargs = pargs + self.pargs
-        if kargs:
-            self.kargs.update(kargs)
+        if args:
+            self.args = args + self.args
+        if kwargs:
+            self.kwargs.update(kwargs)
         return self
 
-    def copy_prepend(self, /, *pargs, **kargs):
+    def copy_prepend(self, /, *args, **kwargs):
         """Prepend the collected arguments in a copied instance.
 
         Examples::
@@ -164,9 +185,9 @@ class UpdativeArgs(Args):
         >>> args is args2
         False
         """
-        return copy(self).prepend(*pargs, **kargs)
+        return copy(self).prepend(*args, **kwargs)
 
-    def update(self, /, *pargs, **kargs):
+    def update(self, /, *args, **kwargs):
         """Update the collected arguments.
 
         Examples::
@@ -180,17 +201,17 @@ class UpdativeArgs(Args):
         >>> args.update(7, 8, 10, 11, x=9, r=0)
         UpdativeArgs(7, 8, 10, 11, x=9, y=5, z=6, r=0)
         """
-        if pargs:
-            n = len(pargs) - len(self.pargs)
+        if args:
+            n = len(args) - len(self.args)
             if n >= 0:
-                self.pargs = pargs
+                self.args = args
             else:
-                self.pargs = pargs + self.pargs[n:]
-        if kargs:
-            self.kargs.update(kargs)
+                self.args = args + self.args[n:]
+        if kwargs:
+            self.kwargs.update(kwargs)
         return self
 
-    def copy_update(self, /, *pargs, **kargs):
+    def copy_update(self, /, *args, **kwargs):
         """Update the collected arguments in a copied instance.
 
         Examples::
@@ -213,9 +234,9 @@ class UpdativeArgs(Args):
         >>> args2 == args3
         True
         """
-        return copy(self).update(*pargs, **kargs)
+        return copy(self).update(*args, **kwargs)
 
-    def update_extend(self, /, *pargs, **kargs):
+    def update_extend(self, /, *args, **kwargs):
         """Update and entend the collected arguments.
 
         Examples::
@@ -229,19 +250,19 @@ class UpdativeArgs(Args):
         >>> args.update_extend(7, 8, x=9, r=0)
         UpdativeArgs(1, 2, 3, x=4, y=5, z=6, r=0)
         """
-        if pargs:
-            n = len(self.pargs) - len(pargs)
+        if args:
+            n = len(self.args) - len(args)
             if n < 0:
-                self.pargs += pargs[n:]
-        if kargs:
-            kargs0 = self.kargs
-            kargs0.update(
-                (k, kargs[k])
-                for k in kargs.keys() - kargs0.keys()
+                self.args += args[n:]
+        if kwargs:
+            kwargs0 = self.kwargs
+            kwargs0.update(
+                (k, kwargs[k])
+                for k in kwargs.keys() - kwargs0.keys()
             )
         return self
 
-    def copy_update_extend(self, /, *pargs, **kargs):
+    def copy_update_extend(self, /, *args, **kwargs):
         """Update and extend the collected arguments in
         a copied instance.
 
@@ -267,7 +288,37 @@ class UpdativeArgs(Args):
         >>> args2 == args3
         True
         """
-        return copy(self).update_extend(*pargs, **kargs)
+        return copy(self).update_extend(*args, **kwargs)
+
+
+class Call[**Params, R](partial):
+    """
+    """
+    def __new__(
+        cls, 
+        func: Callable[Params, R], 
+        /, 
+        *args: Params.args, 
+        **kwds: Params.kwargs, 
+    ):
+        if hasattr(func, "func"):
+            args = getattr(func, "args", ()) + args # type: ignore
+            kwargs: None | dict = None
+            try:
+                kwargs = getattr(func, "kwargs")
+            except AttributeError:
+                kwargs = getattr(func, "keywords", None)
+            if kwargs:
+                kwds = {**kwargs, **kwds} # type: ignore
+            func = func.func
+        return update_wrapper(super().__new__(cls, func, *args, **kwds), func)
+
+    @property
+    def kwargs(self, /) -> dict:
+        return self.keywords
+
+    def __call__(self, /) -> R:
+        return self.func(*self.args, **self.kwargs)
 
 
 if __name__ == "__main__":

{python_argtools-0.0.1 → python_argtools-0.0.3}/pyproject.toml

@@ -1,19 +1,19 @@
 [tool.poetry]
 name = "python-argtools"
-version = "0.0.1"
+version = "0.0.3"
 description = "Python argument tools."
 authors = ["ChenyangGao <wosiwujm@gmail.com>"]
 license = "MIT"
 readme = "readme.md"
-homepage = "https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/python-argtools"
-repository = "https://github.com/ChenyangGao/web-mount-packs/tree/main/python-module/python-argtools"
+homepage = "https://github.com/ChenyangGao/python-modules/tree/main/python-argtools"
+repository = "https://github.com/ChenyangGao/python-modules/tree/main/python-argtools"
 keywords = ["argument", "tools"]
 classifiers = [
     "License :: OSI Approved :: MIT License",
     "Development Status :: 5 - Production/Stable",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3 :: Only",
     "Operating System :: OS Independent",
     "Intended Audience :: Developers",
@@ -26,7 +26,7 @@ include = [
 ]
 
 [tool.poetry.dependencies]
-python = "^3.10"
+python = "^3.12"
 
 [build-system]
 requires = ["poetry-core"]

{python_argtools-0.0.1 → python_argtools-0.0.3}/readme.md

@@ -5,7 +5,7 @@
 You can install from [pypi](https://pypi.org/project/python-argtools/)
 
 ```console
-pip install -U argtools
+pip install -U python-argtools
 ```
 
 ## Usage