optfunc2 0.2.0__tar.gz → 0.2.2__tar.gz

optfunc2-0.2.2/PKG-INFO

@@ -0,0 +1,201 @@
+Metadata-Version: 2.3
+Name: optfunc2
+Version: 0.2.2
+Summary: Generate command line options and help/tips from function automatically.
+License: PyPA
+Author: bajeer
+Author-email: z-bajeer@yeah.net
+Requires-Python: >=3.8,<4.0
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: docstring-parser (>=0.16,<0.17)
+Requires-Dist: prettytable (==3.11.0)
+Project-URL: Bug Reports, https://gitee.com/z-bajer/autocall/issues
+Project-URL: Homepage, https://gitee.com/z-bajer/autocall
+Project-URL: Source, https://gitee.com/z-bajer/autocall
+Description-Content-Type: text/markdown
+
+# Call function directly in cmd line
+
+### Features
+1. Allow user call functions directly in command line.
+2. Generate help tips automatically.
+3. Add default called functions if not function was specific.
+
+### Notice
+1. It's better to add argument type for each autocall functions.
+2. Function with @optfunc_default has @optfunc implicitly.
+3. Not support two type of variadic arguments.
+
+### ChangeLog
+### 0.2.2 (2025-2-16)
+1. Support single argument in bool type.
+2. Don't need user to pass globals() in cmdline_start().
+3. Support pytest to run test.
+4. Support omitting called function name who is default.
+5. pyproject.toml format change for poetry version 2.1.0.
+
+#### 0.2.1 (2025-2-14)
+1. Fix installing dependencies automatically.
+2. Add function 'called_directly' used to check if the function is called as entry point.
+   This function can be used in function development.
+   
+#### 0.1.2 (2023-05-06)
+1. Add support for default called functions.
+2. Fix README.md.
+3. Add ChangeLog in README.md.
+
+### Code example1 -- calculator
+``` python
+from optfunc2 import cmdline, cmdline_default, cmdline_start
+
+@cmdline_default
+def add(a: float, b: float):
+    """add two numbers
+
+    Args:
+        a (float): The First number
+        b (float): The Second number
+    """
+    print(f"{a} + {b} = {a + b}")
+
+@cmdline
+def multiply(x: int, y: int = 5):
+    """multiply two numbers. The second number is optional.
+
+    Args:
+        x (int): The First number
+        y (int, optional): The Second number. Defaults to 5.
+    """
+    print(f"{x} × {y} = {x * y}")
+
+@cmdline
+def stats(numbers: list):
+    """statistics of numbers in list
+
+    Args:
+        numbers (list): Target List.
+    """ 
+    print(f"sum: {sum(numbers)}")
+    print(f"average: {sum(numbers)/len(numbers):.2f}")
+
+if __name__ == "__main__":
+    cmdline_start(header_doc="✨ calc CLI", has_abbrev=True)
+```
+
+### Generate help tips automatically
+``` bash
+~/optfunc2$ python src/example_calc.py help
+Usage: src/example_calc.py [command] [<args>|--help]
+
+✨ calc CLI
+
+commands:
+    add          [default] add two numbers
+    multiply     multiply two numbers. The second number is optional.
+    stats        statistics of numbers in list
+
+~/optfunc2$ python src/example_calc.py add -h
+Usage: src/example_calc.py add [OPTIONS]
+
+add two numbers
+
+
+Arguments:
++-----+--------+-------+---------+-------------------+
+| Opt | Abbrev |  Type | Default |        Desc       |
++-----+--------+-------+---------+-------------------+
+| --a |   -a   | float |         |  The First number |
+| --b |   -b   | float |         | The Second number |
++-----+--------+-------+---------+-------------------+
+
+
+~/optfunc2$ python src/example_calc.py stats -h
+Usage: src/example_calc.py stats [OPTIONS]
+
+statistics of numbers in list
+
+
+Arguments:
++-----------+--------+------+---------+--------------+
+|    Opt    | Abbrev | Type | Default |     Desc     |
++-----------+--------+------+---------+--------------+
+| --numbers |   -n   | list |         | Target List. |
++-----------+--------+------+---------+--------------+
+```
+
+### Usage
+``` bash
+~/optfunc2$ python src/example_calc.py add -a 2.3 -b 3
+2.3 + 3.0 = 5.3
+~/optfunc2$ python src/example_calc.py -a 2.3 -b 3
+2.3 + 3.0 = 5.3
+~/optfunc2$ python src/example_calc.py multiply -x 3
+3 × 5 = 15
+~/optfunc2$ python src/example_calc.py stats --numbers '[1, 2, 3, 4, 5]'
+sum: 15
+average: 3.00
+```
+
+### Code example2 -- list files
+``` python
+from optfunc2 import cmdline, cmdline_default, cmdline_start
+import os
+
+@cmdline_default
+def list_files(directory: str = ".", show_size: bool = False):
+    """List files in a directory.
+
+    Args:
+        directory (str, optional): Target directory. Defaults to ".".
+        show_size (bool, optional): Whether to show size of file. Defaults to False.
+    """
+    for f in os.listdir(directory):
+        path = os.path.join(directory, f)
+        if show_size and os.path.isfile(path):
+            print(f"{f} ({os.path.getsize(path)} bytes)")
+        else:
+            print(f)
+
+if __name__ == "__main__":
+    cmdline_start(header_doc="📁 file manager", has_abbrev=True)
+```
+
+### Usage
+``` bash
+$ python src/example_file_operator.py -h
+Usage: src/example_file_operator.py [command] [<args>|--help]
+
+📁 file manager
+
+commands:
+    list_files     [default] List files in a directory.
+
+$ python src/example_file_operator.py list_files -h
+Usage: src/example_file_operator.py list_files [OPTIONS]
+
+List files in a directory.
+
+
+Arguments:
++-------------+--------+------+---------+--------------------------------------------------+
+|     Opt     | Abbrev | Type | Default |                       Desc                       |
++-------------+--------+------+---------+--------------------------------------------------+
+| --directory |   -d   | str  |   '.'   |        Target directory. Defaults to ".".        |
+| --show_size |   -s   | bool |  False  | Whether to show size of file. Defaults to False. |
++-------------+--------+------+---------+--------------------------------------------------+
+$ python src/example_file_operator.py
+LICENSE.txt
+.gitignore
+pyproject.toml
+$ python src/example_file_operator.py -s
+LICENSE.txt (1081 bytes)
+.gitignore (132 bytes)
+pyproject.toml (719 bytes)
+```

optfunc2-0.2.2/README.md

@@ -0,0 +1,178 @@
+# Call function directly in cmd line
+
+### Features
+1. Allow user call functions directly in command line.
+2. Generate help tips automatically.
+3. Add default called functions if not function was specific.
+
+### Notice
+1. It's better to add argument type for each autocall functions.
+2. Function with @optfunc_default has @optfunc implicitly.
+3. Not support two type of variadic arguments.
+
+### ChangeLog
+### 0.2.2 (2025-2-16)
+1. Support single argument in bool type.
+2. Don't need user to pass globals() in cmdline_start().
+3. Support pytest to run test.
+4. Support omitting called function name who is default.
+5. pyproject.toml format change for poetry version 2.1.0.
+
+#### 0.2.1 (2025-2-14)
+1. Fix installing dependencies automatically.
+2. Add function 'called_directly' used to check if the function is called as entry point.
+   This function can be used in function development.
+   
+#### 0.1.2 (2023-05-06)
+1. Add support for default called functions.
+2. Fix README.md.
+3. Add ChangeLog in README.md.
+
+### Code example1 -- calculator
+``` python
+from optfunc2 import cmdline, cmdline_default, cmdline_start
+
+@cmdline_default
+def add(a: float, b: float):
+    """add two numbers
+
+    Args:
+        a (float): The First number
+        b (float): The Second number
+    """
+    print(f"{a} + {b} = {a + b}")
+
+@cmdline
+def multiply(x: int, y: int = 5):
+    """multiply two numbers. The second number is optional.
+
+    Args:
+        x (int): The First number
+        y (int, optional): The Second number. Defaults to 5.
+    """
+    print(f"{x} × {y} = {x * y}")
+
+@cmdline
+def stats(numbers: list):
+    """statistics of numbers in list
+
+    Args:
+        numbers (list): Target List.
+    """ 
+    print(f"sum: {sum(numbers)}")
+    print(f"average: {sum(numbers)/len(numbers):.2f}")
+
+if __name__ == "__main__":
+    cmdline_start(header_doc="✨ calc CLI", has_abbrev=True)
+```
+
+### Generate help tips automatically
+``` bash
+~/optfunc2$ python src/example_calc.py help
+Usage: src/example_calc.py [command] [<args>|--help]
+
+✨ calc CLI
+
+commands:
+    add          [default] add two numbers
+    multiply     multiply two numbers. The second number is optional.
+    stats        statistics of numbers in list
+
+~/optfunc2$ python src/example_calc.py add -h
+Usage: src/example_calc.py add [OPTIONS]
+
+add two numbers
+
+
+Arguments:
++-----+--------+-------+---------+-------------------+
+| Opt | Abbrev |  Type | Default |        Desc       |
++-----+--------+-------+---------+-------------------+
+| --a |   -a   | float |         |  The First number |
+| --b |   -b   | float |         | The Second number |
++-----+--------+-------+---------+-------------------+
+
+
+~/optfunc2$ python src/example_calc.py stats -h
+Usage: src/example_calc.py stats [OPTIONS]
+
+statistics of numbers in list
+
+
+Arguments:
++-----------+--------+------+---------+--------------+
+|    Opt    | Abbrev | Type | Default |     Desc     |
++-----------+--------+------+---------+--------------+
+| --numbers |   -n   | list |         | Target List. |
++-----------+--------+------+---------+--------------+
+```
+
+### Usage
+``` bash
+~/optfunc2$ python src/example_calc.py add -a 2.3 -b 3
+2.3 + 3.0 = 5.3
+~/optfunc2$ python src/example_calc.py -a 2.3 -b 3
+2.3 + 3.0 = 5.3
+~/optfunc2$ python src/example_calc.py multiply -x 3
+3 × 5 = 15
+~/optfunc2$ python src/example_calc.py stats --numbers '[1, 2, 3, 4, 5]'
+sum: 15
+average: 3.00
+```
+
+### Code example2 -- list files
+``` python
+from optfunc2 import cmdline, cmdline_default, cmdline_start
+import os
+
+@cmdline_default
+def list_files(directory: str = ".", show_size: bool = False):
+    """List files in a directory.
+
+    Args:
+        directory (str, optional): Target directory. Defaults to ".".
+        show_size (bool, optional): Whether to show size of file. Defaults to False.
+    """
+    for f in os.listdir(directory):
+        path = os.path.join(directory, f)
+        if show_size and os.path.isfile(path):
+            print(f"{f} ({os.path.getsize(path)} bytes)")
+        else:
+            print(f)
+
+if __name__ == "__main__":
+    cmdline_start(header_doc="📁 file manager", has_abbrev=True)
+```
+
+### Usage
+``` bash
+$ python src/example_file_operator.py -h
+Usage: src/example_file_operator.py [command] [<args>|--help]
+
+📁 file manager
+
+commands:
+    list_files     [default] List files in a directory.
+
+$ python src/example_file_operator.py list_files -h
+Usage: src/example_file_operator.py list_files [OPTIONS]
+
+List files in a directory.
+
+
+Arguments:
++-------------+--------+------+---------+--------------------------------------------------+
+|     Opt     | Abbrev | Type | Default |                       Desc                       |
++-------------+--------+------+---------+--------------------------------------------------+
+| --directory |   -d   | str  |   '.'   |        Target directory. Defaults to ".".        |
+| --show_size |   -s   | bool |  False  | Whether to show size of file. Defaults to False. |
++-------------+--------+------+---------+--------------------------------------------------+
+$ python src/example_file_operator.py
+LICENSE.txt
+.gitignore
+pyproject.toml
+$ python src/example_file_operator.py -s
+LICENSE.txt (1081 bytes)
+.gitignore (132 bytes)
+pyproject.toml (719 bytes)
+```

optfunc2-0.2.2/pyproject.toml

@@ -0,0 +1,29 @@
+[project]
+name = "optfunc2"
+version = "0.2.2"
+description = "Generate command line options and help/tips from function automatically."
+authors = [
+    {name = "bajeer",email = "z-bajeer@yeah.net"}
+]
+license = {text = "PyPA"}
+readme = "README.md"
+requires-python = ">=3.8,<4.0"
+dependencies = [
+    "docstring-parser (>=0.16,<0.17)",
+    "prettytable (==3.11.0)"
+]
+
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[project.urls]
+"Homepage" = "https://gitee.com/z-bajer/autocall"
+"Bug Reports" = "https://gitee.com/z-bajer/autocall/issues"
+"Source" = "https://gitee.com/z-bajer/autocall"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.3.4"
+pytest-xdist = "^3.6.1"
+

{optfunc2-0.2.0 → optfunc2-0.2.2}/src/optfunc2/__init__.py

@@ -1,8 +1,9 @@
 #!/bin/python3
 
 __all__ = ['cmdline', 'cmdline_default', 'cmdline_start',
-           'optfunc', 'optfunc_default', 'optfunc_start']
+           'optfunc', 'optfunc_default', 'optfunc_start', 'called_directly']
 
+import atexit
 from optfunc2.parser import cmdline as cmdline
 from optfunc2.parser import cmdline_default as cmdline_default
 from optfunc2.parser import cmdline_start as cmdline_start
@@ -10,4 +11,4 @@ from optfunc2.parser import cmdline_start as cmdline_start
 from optfunc2.parser import cmdline as optfunc
 from optfunc2.parser import cmdline_default as optfunc_default
 from optfunc2.parser import cmdline_start as optfunc_start
-
+from .parser import called_directly

{optfunc2-0.2.0 → optfunc2-0.2.2}/src/optfunc2/parser.py

@@ -8,6 +8,9 @@ import ast
 registered_funcs = []
 registered_func_default = None
 
+# Main eval function in this module must be called only once.
+_called_func = None
+
 colors = {
     "red": 91,
     "blue": 94,
@@ -39,9 +42,6 @@ def decode_func_args(func: callable):
     abbrev_list.append('h')
     
     for name, param in inspect.signature(func).parameters.items():
-        if len(name) == 1:
-            abbrev_list.append(name)
-
         abbrev = name[0]
 
         desc = inspect.Signature.empty
@@ -61,23 +61,23 @@ def decode_func_args(func: callable):
     return args_list
 
 def get_and_check_opt(args_list: list, opt_name):
-    opt_name2 = opt_name
+    opt_name = opt_name
+    opt_name_full = ''
+    opt_name_abbrev = ''
     if opt_name.startswith('--'):
-        opt_name = opt_name[2:]
-        if len(opt_name) == 1:
-            raise ValueError(f'{opt_name} is not a valid option name.')
+        opt_name_full = opt_name[2:]
     elif opt_name.startswith('-'):
-        opt_name = opt_name[1:]
-        if len(opt_name) != 1:
-            raise ValueError(f'{opt_name} is not a valid option name.')
+        opt_name_abbrev = opt_name[1:]
+        if len(opt_name_abbrev) != 1:
+            raise ValueError(f'{opt_name} should be a single character abbreviation or full name beginning with --.')
     else:
         raise ValueError(f'{opt_name} is not a valid option name.')
     
     for idx, (_, name, abbrev, _, _, _) in enumerate(args_list):
-        if name == opt_name or abbrev == opt_name:
+        if name == opt_name_full or abbrev == opt_name_abbrev:
             return args_list.pop(idx)
         
-    raise ValueError(f'{opt_name2} not found.')
+    raise ValueError(f'{opt_name} not found.')
 
 def decode_opts(arg_pairs, func: callable):
     """
@@ -88,8 +88,12 @@ def decode_opts(arg_pairs, func: callable):
 
     for (opt, val) in arg_pairs:
         typ, name, _, anno, _, _ = get_and_check_opt(arg_list, opt)
+        # special case for assuming bool argument
+        if type(val) == bool and anno != bool:
+            raise ValueError(f'--{name} need more arguments.')
+        
         try:
-            if anno != inspect.Signature.empty:
+            if anno != inspect.Signature.empty and anno not in [dict, list]:
                 value = anno(val)
             else:
                 try: 
@@ -97,7 +101,13 @@ def decode_opts(arg_pairs, func: callable):
                 except Exception:
                     value = str(val)
 
-                anno = type(value)
+                anno_new = type(value)
+
+                if anno != inspect.Signature.empty:
+                    if anno_new != anno:
+                        raise ValueError(f'Value type of {opt} should be {anno.__name__}.')
+                
+                anno = anno_new
 
             opt_list.append((typ, name, anno, value))
             
@@ -126,12 +136,6 @@ def cmdline_default(func):
     global registered_funcs
     
     parameters = inspect.getfullargspec(func)
-
-    if len(parameters.args) != 0 and len(parameters.args) != len(parameters.defaults):
-        color_begin('red')
-        print(f'[Autocall Erroring]: Function annotated by @cmdline_default should have zero arguments or all arguments have default value.')
-        color_end()
-        exit(1)
     
     if registered_func_default:
         color_begin('yellow')
@@ -187,10 +191,7 @@ def cmd_help(func: callable, has_abbrev = True):
 
     for (type, name, abbrev, anno, default, desc) in args_list:
         # abbrev, anno, default, desc all may be empty
-        if len(name) == 1:
-            name = '-' + name
-        else:
-            name = '--' + name
+        name = '--' + name
 
         if abbrev == inspect.Signature.empty:
             abbrev = empty_tag
@@ -243,6 +244,10 @@ def help(header_doc):
             color_begin('green')
             print(f'    {f.__name__:<{max_name_len}s}', end='')
             color_end()
+            if f == registered_func_default:
+                color_begin('yellow')
+                print('[default] ', end='')
+                color_end()
             if doc:
                 doc_list = [d.strip() for d in doc.split('\n') if d.strip()]
                 doc = doc_list[0]
@@ -257,7 +262,8 @@ def match_and_check(name):
         Match the name with the function name.
         """
         global registered_funcs
-        for f in registered_funcs:
+        # [::-1] ensure the order of functions with same name.
+        for f in registered_funcs[::-1]:
             if f.__name__ == name:
                 return f
         
@@ -267,8 +273,10 @@ def pair_argv(argv, has_abbrev = True):
     """ Support these styles:
     --arg val
     --arg=val
+    --arg 
     -a val
     -aval
+    -a
     """
     if len(argv) == 0:
         return []
@@ -283,9 +291,14 @@ def pair_argv(argv, has_abbrev = True):
                 arg_pairs.append((arg, val))
             else:
                 if len(argv) == idx + 1:
-                    raise ValueError(f'No value given for argument {arg}.')
-                arg_pairs.append((arg, argv[idx+1]))
-                idx += 1
+                    arg_pairs.append((arg, True))
+                else:
+                    if argv[idx+1].startswith('-'):
+                        arg_pairs.append((arg, True))
+                    else:
+                        arg_pairs.append((arg, argv[idx+1]))
+                        idx += 1 
+                
         elif arg.startswith('-'):
             if not has_abbrev:
                 raise ValueError(f'Unknown argument {arg}. Abbreviations are not supported.')
@@ -293,14 +306,33 @@ def pair_argv(argv, has_abbrev = True):
             if len(arg) != 2:
                 arg_pairs.append((arg[0:2], arg[2:]))
             else:
-                arg_pairs.append((arg, argv[idx+1]))
-                idx += 1
+                # bool type can be used in single character.
+                if len(argv) == idx + 1: # Cmdline ended with a abbreviation, we assume it is a bool type argument.
+                    arg_pairs.append((arg, True))
+                else: # Next argument is belong to the next pair. We assume it is a bool type argument.
+                    if argv[idx+1].startswith('-'):
+                        arg_pairs.append((arg, True))
+                    else: # Normal.
+                        arg_pairs.append((arg, argv[idx+1]))
+                        idx += 1
+                
         idx += 1
     
     return arg_pairs
 
+def called_directly():
+    """Check if the function is called by optfunc2 directly.
+
+    Returns:
+        bool: True means called by optfunc2 directly.
+    """
+    global _called_func
+    return _called_func.__name__ == inspect.currentframe().f_back.f_code.co_name
+
+
+
 # def parse_run(argv = sys.argv[1:]):
-def cmdline_start(globals, locals = None, *, argv = sys.argv, header_doc: str = 'Help Tips Provided by Autocall.', has_abbrev = True):
+def cmdline_start(globals = None, locals = None, *, argv = sys.argv, header_doc: str = 'Help Tips Provided by Autocall.', has_abbrev = False):
     """Begin to handle argv and execute the corresponding function.
 
     Args:
@@ -308,18 +340,31 @@ def cmdline_start(globals, locals = None, *, argv = sys.argv, header_doc: str =
         locals (dict, optional): Used to be the execution environment.
         argv (list, optional): Advanced usage. Defaults to sys.argv.
         header_doc (str, optional): Will be printed as the header of help information.
-        has_abbrev (bool, optional): Whether to support abbreviations. Defaults to True.
+        has_abbrev (bool, optional): Whether to support abbreviations. Defaults to False. Be careful when using this option. The abbreviation may be dynamically changed.
     """
-
+    global _called_func
+    
+    # ensure only one call
+    if _called_func:
+        #return
+        pass # This function has to be called in main program explicitly.
+    
+    if not globals:
+        globals = inspect.currentframe().f_back.f_globals
+    
     if len(argv) == 1:
         if not registered_func_default:
-            return 
+            return
         argv.append(registered_func_default.__name__)
     
     if argv[1] == 'help' or argv[1] == '--help' or argv[1] == '-h':
         help(header_doc)
         return
     
+    if argv[1][0] == '-':
+        # use the default function
+        argv.insert(1, registered_func_default.__name__)
+    
     func = match_and_check(argv[1])
     
     if not func:
@@ -334,6 +379,8 @@ def cmdline_start(globals, locals = None, *, argv = sys.argv, header_doc: str =
         cmd_help(func, has_abbrev)
         return
     
+    _called_func = func
+    
     # parse argv
     arg_pairs = pair_argv(argv, has_abbrev)
     
@@ -352,4 +399,5 @@ def cmdline_start(globals, locals = None, *, argv = sys.argv, header_doc: str =
     func_call_str += ', '.join(final_args)
     func_call_str += ')'
     
-    eval(func_call_str, globals, locals)
+    # Return the called function's return value.
+    return eval(func_call_str, globals, locals)

optfunc2-0.2.0/PKG-INFO

@@ -1,99 +0,0 @@
-Metadata-Version: 2.1
-Name: optfunc2
-Version: 0.2.0
-Summary: Generate options from function.
-License: PyPA
-Author: bajeer
-Author-email: z_bajer@yeah.net
-Requires-Python: >=3.9,<4.0
-Classifier: License :: Other/Proprietary License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.9
-Requires-Dist: docstring_parser (>=0.16,<0.17)
-Requires-Dist: prettytable (>=3.14.0,<4.0.0)
-Description-Content-Type: text/markdown
-
-# Call function directly in cmd line
-
-### Features
-1. Allow user call functions directly in command line.
-2. Generate help tips automatically.
-3. Add default called functions if not function was specific.
-
-### Notice
-1. It's better to add argument type for each autocall functions.
-2. Function with @optfunc_default has @optfunc implicitly.
-3. Arguments of function with @optfunc_default should be optional or no argument.
-4. Not support two type of variadic arguments.
-
-### ChangeLog
-#### 0.1.2 (2023-05-06)
-1. Add support for default called functions.
-2. Fix README.md.
-3. Add ChangeLog in README.md.
-
-### Code example
-``` python
-from optfunc2 import *
-
-@optfunc
-def arg_test_positional_only(pos_only0, pos_only1: int, pos_only2 = 5, pos_only3: int = 6):
-    """summary for the function
-
-    Args:
-        pos_only0 (_type_): This is the first positional-only argument.
-        pos_only1 (int): This is the second positional-only argument.
-        pos_only2 (int, optional): This is the third positional-only argument. Defaults to 5.
-        pos_only3 (int, optional): This is the fourth positional-only argument. Defaults to 6.
-    """
-    " Argument test for positional-only arguments. "
-    print(f'pos_only0: {pos_only0}, pos_only1: {pos_only1}, pos_only2: {pos_only2}, pos_only3: {pos_only3}')
-    pass
-
-@optfunc
-def arg_test_positional_or_keyword(pos_or_kw, pos_or_kw1: int, pos_or_kw2 = 3, pos_or_kw3: int = 4):
-    " Argument test for positional-or-keyword arguments. "
-    print(f'pos_or_kw: {pos_or_kw}, pos_or_kw1: {pos_or_kw1}, pos_or_kw2: {pos_or_kw2}, pos_or_kw3: {pos_or_kw3}')
-    pass
-
-@optfunc
-def arg_test_kw_only(*, kw_only0, kw_only1: int, kw_only2 = 9, kw_only3: int = 10):
-    " Argument test for keyword-only arguments. "
-    print(f'kw_only0: {kw_only0}, kw_only1: {kw_only1}, kw_only2: {kw_only2}, kw_only3: {kw_only3}')
-    pass
-
-if __name__ == '__main__':
-    optfunc_start(globals=globals(), has_abbrev=False, header_doc='This is a test file for the module "autocall".')
-```
-### Run the code
-``` bash
-~/:$ python3 test.py -h
-Usage: test.py [command] [<args>|--help]
-
-This is a test file for the module "autocall".
-
-commands:
-    arg_test_positional_only           summary for the function
-    arg_test_positional_or_keyword     Argument test for positional-or-keyword arguments.
-    arg_test_kw_only                   Argument test for keyword-only arguments.
-
-~/:$ python3 test.py arg_test_positional_only -h
-Usage: test.py arg_test_positional_only [OPTIONS]
-
-summary for the function
-
-
-Arguments:
-+-------------+------+---------+-------------------------------------------------------------+
-|     Opt     | Type | Default |                             Desc                            |
-+-------------+------+---------+-------------------------------------------------------------+
-| --pos_only0 | any  |         |         This is the first positional-only argument.         |
-| --pos_only1 | int  |         |         This is the second positional-only argument.        |
-| --pos_only2 | any  |    5    |  This is the third positional-only argument. Defaults to 5. |
-| --pos_only3 | int  |    6    | This is the fourth positional-only argument. Defaults to 6. |
-+-------------+------+---------+-------------------------------------------------------------+
-~/:$ python3 test.py arg_test_positional_only --pos_only0 "good day" --pos_only1 2
-pos_only0: good day, pos_only1: 2, pos_only2: 5, pos_only3: 6
-```
-

optfunc2-0.2.0/README.md

@@ -1,82 +0,0 @@
-# Call function directly in cmd line
-
-### Features
-1. Allow user call functions directly in command line.
-2. Generate help tips automatically.
-3. Add default called functions if not function was specific.
-
-### Notice
-1. It's better to add argument type for each autocall functions.
-2. Function with @optfunc_default has @optfunc implicitly.
-3. Arguments of function with @optfunc_default should be optional or no argument.
-4. Not support two type of variadic arguments.
-
-### ChangeLog
-#### 0.1.2 (2023-05-06)
-1. Add support for default called functions.
-2. Fix README.md.
-3. Add ChangeLog in README.md.
-
-### Code example
-``` python
-from optfunc2 import *
-
-@optfunc
-def arg_test_positional_only(pos_only0, pos_only1: int, pos_only2 = 5, pos_only3: int = 6):
-    """summary for the function
-
-    Args:
-        pos_only0 (_type_): This is the first positional-only argument.
-        pos_only1 (int): This is the second positional-only argument.
-        pos_only2 (int, optional): This is the third positional-only argument. Defaults to 5.
-        pos_only3 (int, optional): This is the fourth positional-only argument. Defaults to 6.
-    """
-    " Argument test for positional-only arguments. "
-    print(f'pos_only0: {pos_only0}, pos_only1: {pos_only1}, pos_only2: {pos_only2}, pos_only3: {pos_only3}')
-    pass
-
-@optfunc
-def arg_test_positional_or_keyword(pos_or_kw, pos_or_kw1: int, pos_or_kw2 = 3, pos_or_kw3: int = 4):
-    " Argument test for positional-or-keyword arguments. "
-    print(f'pos_or_kw: {pos_or_kw}, pos_or_kw1: {pos_or_kw1}, pos_or_kw2: {pos_or_kw2}, pos_or_kw3: {pos_or_kw3}')
-    pass
-
-@optfunc
-def arg_test_kw_only(*, kw_only0, kw_only1: int, kw_only2 = 9, kw_only3: int = 10):
-    " Argument test for keyword-only arguments. "
-    print(f'kw_only0: {kw_only0}, kw_only1: {kw_only1}, kw_only2: {kw_only2}, kw_only3: {kw_only3}')
-    pass
-
-if __name__ == '__main__':
-    optfunc_start(globals=globals(), has_abbrev=False, header_doc='This is a test file for the module "autocall".')
-```
-### Run the code
-``` bash
-~/:$ python3 test.py -h
-Usage: test.py [command] [<args>|--help]
-
-This is a test file for the module "autocall".
-
-commands:
-    arg_test_positional_only           summary for the function
-    arg_test_positional_or_keyword     Argument test for positional-or-keyword arguments.
-    arg_test_kw_only                   Argument test for keyword-only arguments.
-
-~/:$ python3 test.py arg_test_positional_only -h
-Usage: test.py arg_test_positional_only [OPTIONS]
-
-summary for the function
-
-
-Arguments:
-+-------------+------+---------+-------------------------------------------------------------+
-|     Opt     | Type | Default |                             Desc                            |
-+-------------+------+---------+-------------------------------------------------------------+
-| --pos_only0 | any  |         |         This is the first positional-only argument.         |
-| --pos_only1 | int  |         |         This is the second positional-only argument.        |
-| --pos_only2 | any  |    5    |  This is the third positional-only argument. Defaults to 5. |
-| --pos_only3 | int  |    6    | This is the fourth positional-only argument. Defaults to 6. |
-+-------------+------+---------+-------------------------------------------------------------+
-~/:$ python3 test.py arg_test_positional_only --pos_only0 "good day" --pos_only1 2
-pos_only0: good day, pos_only1: 2, pos_only2: 5, pos_only3: 6
-```

optfunc2-0.2.0/pyproject.toml

@@ -1,23 +0,0 @@
-[tool.poetry]
-name = "optfunc2"
-version = "0.2.0"
-description = "Generate options from function."
-authors = ["bajeer <z_bajer@yeah.net>"]
-readme = "README.md"
-license = "PyPA"
-
-[tool.poetry.dependencies]
-python = ">=3.9,<4.0"
-prettytable = "^3.14.0"
-docstring_parser = "^0.16"
-
-[tool.poetry.dev-dependencies]
-
-[build-system]
-requires = ["poetry-core>=1.0.0"]
-build-backend = "poetry.core.masonry.api"
-
-[project.urls]
-"Homepage" = "https://gitee.com/z-bajer/autocall"
-"Bug Reports" = "https://gitee.com/z-bajer/autocall/issues"
-"Source" = "https://gitee.com/z-bajer/autocall"

optfunc2-0.2.0/setup.py

@@ -1,34 +0,0 @@
-# -*- coding: utf-8 -*-
-from setuptools import setup
-
-package_dir = \
-{'': 'src'}
-
-packages = \
-['optfunc2']
-
-package_data = \
-{'': ['*']}
-
-install_requires = \
-['docstring_parser>=0.16,<0.17', 'prettytable>=3.14.0,<4.0.0']
-
-setup_kwargs = {
-    'name': 'optfunc2',
-    'version': '0.2.0',
-    'description': 'Generate options from function.',
-    'long_description': '# Call function directly in cmd line\n\n### Features\n1. Allow user call functions directly in command line.\n2. Generate help tips automatically.\n3. Add default called functions if not function was specific.\n\n### Notice\n1. It\'s better to add argument type for each autocall functions.\n2. Function with @optfunc_default has @optfunc implicitly.\n3. Arguments of function with @optfunc_default should be optional or no argument.\n4. Not support two type of variadic arguments.\n\n### ChangeLog\n#### 0.1.2 (2023-05-06)\n1. Add support for default called functions.\n2. Fix README.md.\n3. Add ChangeLog in README.md.\n\n### Code example\n``` python\nfrom optfunc2 import *\n\n@optfunc\ndef arg_test_positional_only(pos_only0, pos_only1: int, pos_only2 = 5, pos_only3: int = 6):\n    """summary for the function\n\n    Args:\n        pos_only0 (_type_): This is the first positional-only argument.\n        pos_only1 (int): This is the second positional-only argument.\n        pos_only2 (int, optional): This is the third positional-only argument. Defaults to 5.\n        pos_only3 (int, optional): This is the fourth positional-only argument. Defaults to 6.\n    """\n    " Argument test for positional-only arguments. "\n    print(f\'pos_only0: {pos_only0}, pos_only1: {pos_only1}, pos_only2: {pos_only2}, pos_only3: {pos_only3}\')\n    pass\n\n@optfunc\ndef arg_test_positional_or_keyword(pos_or_kw, pos_or_kw1: int, pos_or_kw2 = 3, pos_or_kw3: int = 4):\n    " Argument test for positional-or-keyword arguments. "\n    print(f\'pos_or_kw: {pos_or_kw}, pos_or_kw1: {pos_or_kw1}, pos_or_kw2: {pos_or_kw2}, pos_or_kw3: {pos_or_kw3}\')\n    pass\n\n@optfunc\ndef arg_test_kw_only(*, kw_only0, kw_only1: int, kw_only2 = 9, kw_only3: int = 10):\n    " Argument test for keyword-only arguments. "\n    print(f\'kw_only0: {kw_only0}, kw_only1: {kw_only1}, kw_only2: {kw_only2}, kw_only3: {kw_only3}\')\n    pass\n\nif __name__ == \'__main__\':\n    optfunc_start(globals=globals(), has_abbrev=False, header_doc=\'This is a test file for the module "autocall".\')\n```\n### Run the code\n``` bash\n~/:$ python3 test.py -h\nUsage: test.py [command] [<args>|--help]\n\nThis is a test file for the module "autocall".\n\ncommands:\n    arg_test_positional_only           summary for the function\n    arg_test_positional_or_keyword     Argument test for positional-or-keyword arguments.\n    arg_test_kw_only                   Argument test for keyword-only arguments.\n\n~/:$ python3 test.py arg_test_positional_only -h\nUsage: test.py arg_test_positional_only [OPTIONS]\n\nsummary for the function\n\n\nArguments:\n+-------------+------+---------+-------------------------------------------------------------+\n|     Opt     | Type | Default |                             Desc                            |\n+-------------+------+---------+-------------------------------------------------------------+\n| --pos_only0 | any  |         |         This is the first positional-only argument.         |\n| --pos_only1 | int  |         |         This is the second positional-only argument.        |\n| --pos_only2 | any  |    5    |  This is the third positional-only argument. Defaults to 5. |\n| --pos_only3 | int  |    6    | This is the fourth positional-only argument. Defaults to 6. |\n+-------------+------+---------+-------------------------------------------------------------+\n~/:$ python3 test.py arg_test_positional_only --pos_only0 "good day" --pos_only1 2\npos_only0: good day, pos_only1: 2, pos_only2: 5, pos_only3: 6\n```\n',
-    'author': 'bajeer',
-    'author_email': 'z_bajer@yeah.net',
-    'maintainer': None,
-    'maintainer_email': None,
-    'url': None,
-    'package_dir': package_dir,
-    'packages': packages,
-    'package_data': package_data,
-    'install_requires': install_requires,
-    'python_requires': '>=3.9,<4.0',
-}
-
-
-setup(**setup_kwargs)