optfunc2 0.1__tar.gz

optfunc2-0.1/LICENSE.txt

@@ -0,0 +1,19 @@
+Copyright (c) 2016 The Python Packaging Authority (PyPA)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

optfunc2-0.1/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.1
+Name: optfunc2
+Version: 0.1
+Summary: Generate options from function.
+Author-email: bajeer <z_bajer@yeah.net>
+Maintainer-email: bajeer <z_bajer@yeah.net>
+License: Copyright (c) 2016 The Python Packaging Authority (PyPA)
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy of
+        this software and associated documentation files (the "Software"), to deal in
+        the Software without restriction, including without limitation the rights to
+        use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+        of the Software, and to permit persons to whom the Software is furnished to do
+        so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://gitee.com/z-bajer/autocall
+Project-URL: Bug Reports, https://gitee.com/z-bajer/autocall/issues
+Project-URL: Source, https://gitee.com/z-bajer/autocall
+Keywords: call,function,option
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+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
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Provides-Extra: dev
+Requires-Dist: check-manifest; extra == "dev"
+Provides-Extra: test
+Requires-Dist: coverage; extra == "test"
+
+# 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.
+
+#### TODO
+1. Beautiful print.
+
+#### Code example
+``` python
+from optfunc 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.1/README.md

@@ -0,0 +1,79 @@
+# 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.
+
+#### TODO
+1. Beautiful print.
+
+#### Code example
+``` python
+from optfunc 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.1/pyproject.toml

@@ -0,0 +1,164 @@
+# Guide (user-friendly):
+# https://packaging.python.org/en/latest/guides/writing-pyproject-toml/
+
+# Specification (technical, formal):
+# https://packaging.python.org/en/latest/specifications/pyproject-toml/
+
+
+# Choosing a build backend:
+# https://packaging.python.org/en/latest/tutorials/packaging-projects/#choosing-a-build-backend
+[build-system]
+# A list of packages that are needed to build your package:
+requires = ["setuptools"]  # REQUIRED if [build-system] table is used
+# The name of the Python object that frontends will use to perform the build:
+build-backend = "setuptools.build_meta"  # If not defined, then legacy behavior can happen.
+
+
+[project]
+# This is the name of your project. The first time you publish this
+# package, this name will be registered for you. It will determine how
+# users can install this project, e.g.:
+#
+# $ pip install sampleproject
+#
+# And where it will live on PyPI: https://pypi.org/project/sampleproject/
+#
+# There are some restrictions on what makes a valid project name
+# specification here:
+# https://packaging.python.org/specifications/core-metadata/#name
+name = "optfunc2"  # REQUIRED, is the only field that cannot be marked as dynamic.
+
+# Versions should comply with PEP 440:
+# https://www.python.org/dev/peps/pep-0440/
+#
+# For a discussion on single-sourcing the version, see
+# https://packaging.python.org/guides/single-sourcing-package-version/
+version = "0.1"  # REQUIRED, although can be dynamic
+
+# This is a one-line description or tagline of what your project does. This
+# corresponds to the "Summary" metadata field:
+# https://packaging.python.org/specifications/core-metadata/#summary
+description = "Generate options from function."
+
+# This is an optional longer description of your project that represents
+# the body of text which users will see when they visit PyPI.
+#
+# Often, this is the same as your README, so you can just read it in from
+# that file directly.
+#
+# This field corresponds to the "Description" metadata field:
+# https://packaging.python.org/specifications/core-metadata/#description-optional
+readme = "README.md"
+
+# Specify which Python versions you support. In contrast to the
+# 'Programming Language' classifiers in this file, 'pip install' will check this
+# and refuse to install the project if the version does not match. See
+# https://packaging.python.org/guides/distributing-packages-using-setuptools/#python-requires
+requires-python = ">=3.7"
+
+# This is either text indicating the license for the distribution, or a file
+# that contains the license.
+# https://packaging.python.org/en/latest/specifications/core-metadata/#license
+license = {file = "LICENSE.txt"}
+
+# This field adds keywords for your project which will appear on the
+# project page. What does your project relate to?
+#
+# Note that this is a list of additional keywords, separated
+# by commas, to be used to assist searching for the distribution in a
+# larger catalog.
+keywords = ["call", "function", "option"]
+
+# This should be your name or the name of the organization who originally
+# authored the project, and a valid email address corresponding to the name
+# listed.
+authors = [
+  {name = "bajeer", email = "z_bajer@yeah.net" }
+]
+
+# This should be your name or the names of the organization who currently
+# maintains the project, and a valid email address corresponding to the name
+# listed.
+maintainers = [
+  {name = "bajeer", email = "z_bajer@yeah.net" }
+]
+
+# Classifiers help users find your project by categorizing it.
+#
+# For a list of valid classifiers, see https://pypi.org/classifiers/
+classifiers = [
+  # How mature is this project? Common values are
+  #   3 - Alpha
+  #   4 - Beta
+  #   5 - Production/Stable
+  "Development Status :: 3 - Alpha",
+
+  # Indicate who your project is intended for
+  "Intended Audience :: Developers",
+  "Topic :: Software Development",
+
+  # Pick your license as you wish
+  "License :: OSI Approved :: MIT License",
+
+  # Specify the Python versions you support here. In particular, ensure
+  # that you indicate you support Python 3. These classifiers are *not*
+  # checked by "pip install". See instead "requires-python" key in this file.
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.7",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Programming Language :: Python :: 3 :: Only",
+]
+
+# This field lists other packages that your project depends on to run.
+# Any package you put here will be installed by pip when your project is
+# installed, so they must be valid existing projects.
+#
+# For an analysis of this field vs pip's requirements files see:
+# https://packaging.python.org/discussions/install-requires-vs-requirements/
+
+# List additional groups of dependencies here (e.g. development
+# dependencies). Users will be able to install these using the "extras"
+# syntax, for example:
+#
+#   $ pip install sampleproject[dev]
+#
+# Optional dependencies the project provides. These are commonly 
+# referred to as "extras". For a more extensive definition see:
+# https://packaging.python.org/en/latest/specifications/dependency-specifiers/#extras
+[project.optional-dependencies]
+dev = ["check-manifest"]
+test = ["coverage"]
+
+# List URLs that are relevant to your project
+#
+# This field corresponds to the "Project-URL" and "Home-Page" metadata fields:
+# https://packaging.python.org/specifications/core-metadata/#project-url-multiple-use
+# https://packaging.python.org/specifications/core-metadata/#home-page-optional
+#
+# Examples listed include a pattern for specifying where the package tracks
+# issues, where the source is hosted, where to say thanks to the package
+# maintainers, and where to support the project financially. The key is
+# what's used to render the link text on PyPI.
+[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"
+
+# The following would provide a command line executable called `sample`
+# which executes the function `main` from this package when invoked.
+#[project.scripts]
+#sample = "sample:main"
+
+
+# This is configuration specific to the `setuptools` build backend.
+# If you are using a different build backend, you will need to change this.
+#[tool.setuptools]
+# If there are data files included in your packages that need to be
+# installed, specify them here.
+#package-data = {"sample" = ["*.dat"]}

optfunc2-0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

optfunc2-0.1/src/optfunc2/__init__.py

@@ -0,0 +1,13 @@
+#!/bin/python3
+
+__all__ = ['cmdline', 'cmdline_default', 'cmdline_start',
+           'optfunc', 'optfunc_default', 'optfunc_start']
+
+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
+
+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
+

optfunc2-0.1/src/optfunc2/parser.py

@@ -0,0 +1,353 @@
+import inspect
+import prettytable
+import docstring_parser
+import sys
+import ast
+
+# functions taged by @cmdline
+registered_funcs = []
+registered_func_default = None
+
+colors = {
+    "red": 91,
+    "blue": 94,
+    "green": 92,
+    "magenta": 95,
+    "yellow": 93,
+    "black": 90,
+    "cyan": 96,
+}
+
+def color_begin(color):
+    print('\033[{}m'.format(colors[color]), end='')
+    
+def color_end():
+    print('\033[0m', end='')
+
+def decode_func_args(func: callable):
+    """
+    (type, name, abbreviation, annotation, default, doc)
+    """
+    
+    doc = func.__doc__
+    docstring = docstring_parser.parse(doc)
+    
+    args_list = []
+    abbrev_list = []
+    
+    # -h has been occupied by help command.
+    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
+        for param_docstring in docstring.params:
+            if name == param_docstring.arg_name:
+                desc = param_docstring.description
+                break
+
+        if abbrev not in abbrev_list:
+            abbrev_list.append(abbrev)
+        else:
+            abbrev = inspect.Signature.empty
+        
+        args_list.append((param.kind, name, abbrev, param.annotation, param.default, desc))
+    
+    
+    return args_list
+
+def get_and_check_opt(args_list: list, opt_name):
+    opt_name2 = opt_name
+    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.')
+    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.')
+    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:
+            return args_list.pop(idx)
+        
+    raise ValueError(f'{opt_name2} not found.')
+
+def decode_opts(arg_pairs, func: callable):
+    """
+    (type, name, annotation, value)
+    """
+    arg_list = decode_func_args(func)
+    opt_list = []
+
+    for (opt, val) in arg_pairs:
+        typ, name, _, anno, _, _ = get_and_check_opt(arg_list, opt)
+        try:
+            if anno != inspect.Signature.empty:
+                value = anno(val)
+            else:
+                try: 
+                    value = ast.literal_eval(val)
+                except Exception:
+                    value = str(val)
+
+                anno = type(value)
+
+            opt_list.append((typ, name, anno, value))
+            
+        except ValueError:
+            raise ValueError(f'Value type of {opt} should be {anno.__name__}.')
+    
+    for (typ, name, _, anno, default, _) in arg_list:
+        if default == inspect.Signature.empty:
+            raise ValueError(f'--{name} is required.')
+        
+        opt_list.append((typ, name, anno, default))
+        
+    return opt_list
+
+def hibit_variadic(func: callable):
+    arg_list = decode_func_args(func)
+    for (typ, _, _, _, _, _) in arg_list:
+        if typ == inspect.Parameter.VAR_POSITIONAL or typ == inspect.Parameter.VAR_KEYWORD:
+            color_begin('red')
+            print(f'[Autocall Error]: Function {func.__name__} annotated by @cmdline has variadic arguments.')
+            color_end()
+            exit(1)
+
+def cmdline_default(func):
+    global registered_func_default
+    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')
+        print(f'[Autocall Warning]: @cmdline_default can only be used once or the last one will be used.')
+        color_end()
+
+    registered_func_default = func
+    
+    hibit_variadic(func)
+
+    if func not in registered_funcs:
+        registered_funcs.append(func)
+    
+    # globals()[funcname] = func
+    return func
+
+def cmdline(func):
+    global registered_funcs
+    if func not in registered_funcs:
+        registered_funcs.append(func)
+
+    hibit_variadic(func)
+    return func
+
+    
+def cmd_help(func: callable, has_abbrev = True):
+    args_list = decode_func_args(func)
+    
+    func_desc = docstring_parser.parse(func.__doc__).description
+    
+    empty_tag = ''
+    
+    color_begin('blue')
+    print(f'Usage: {sys.argv[0]} {func.__name__} ', end='')
+    print('[OPTIONS]')
+    color_end()
+    print()
+    
+    if func_desc != None:
+        print(func_desc)
+    else:
+        print('Help Tips Provided by Autocall.')
+
+    print()
+       
+    if len(args_list) == 0:
+        return
+    
+    print('Arguments:')
+
+    table = prettytable.PrettyTable()
+    table.field_names = ['Opt', 'Abbrev', 'Type', 'Default', 'Desc']
+
+    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
+
+        if abbrev == inspect.Signature.empty:
+            abbrev = empty_tag
+        else:
+            abbrev = '-' + abbrev
+        
+        if anno == inspect.Signature.empty:
+            anno = 'any'
+        else:
+            anno = anno.__name__
+        
+        if default == inspect.Signature.empty:
+            default = empty_tag
+        else:
+            default = repr(default)
+        
+        if desc == inspect.Signature.empty:
+            desc = empty_tag
+            
+        table.add_row([name, abbrev, anno, default, desc])
+    
+    if not has_abbrev:
+        table.del_column('Abbrev')
+
+    print(table)
+
+def help(header_doc):
+        """
+        Give the argument \"verbose\" instead of \"notverbose\" to print detail information.
+        """
+        global registered_funcs
+
+        color_begin('blue')
+        print(f'Usage: {sys.argv[0]} ', end='')
+        # print('[--help] ', end='')
+        color_begin('green')
+        print('[command] [<args>|--help]')
+        color_end()
+        print()
+        
+        print(header_doc)
+        print()
+        
+        print('commands:')
+
+        max_name_len = max([len(f.__name__) for f in registered_funcs]) + 5
+        
+        for f in registered_funcs:
+            doc = f.__doc__
+            color_begin('green')
+            print(f'    {f.__name__:<{max_name_len}s}', end='')
+            color_end()
+            if doc:
+                doc_list = [d.strip() for d in doc.split('\n') if d.strip()]
+                doc = doc_list[0]
+                print(doc)
+            else:
+                print()
+        
+        print()
+
+def match_and_check(name):
+        """
+        Match the name with the function name.
+        """
+        global registered_funcs
+        for f in registered_funcs:
+            if f.__name__ == name:
+                return f
+        
+        return None
+
+def pair_argv(argv, has_abbrev = True):
+    """ Support these styles:
+    --arg val
+    --arg=val
+    -a val
+    -aval
+    """
+    if len(argv) == 0:
+        return []
+    
+    idx = 0
+    arg_pairs = []
+    while idx < len(argv):
+        arg = argv[idx]
+        if arg.startswith('--'):
+            if '=' in arg:
+                arg, val = arg.split('=')
+                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
+        elif arg.startswith('-'):
+            if not has_abbrev:
+                raise ValueError(f'Unknown argument {arg}. Abbreviations are not supported.')
+            
+            if len(arg) != 2:
+                arg_pairs.append((arg[0:2], arg[2:]))
+            else:
+                arg_pairs.append((arg, argv[idx+1]))
+                idx += 1
+        idx += 1
+    
+    return arg_pairs
+
+# 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):
+    """Begin to handle argv and execute the corresponding function.
+
+    Args:
+        globals (dict): Used to be the execution environment.
+        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.
+    """
+
+    if len(argv) == 1:
+        return
+    
+    if argv[1] == 'help' or argv[1] == '--help' or argv[1] == '-h':
+        help(header_doc)
+        return
+    
+    func = match_and_check(argv[1])
+    
+    if not func:
+        color_begin('red')
+        print(f'[Autocall Warning]: Unknown command \"{argv[1]}\". Use \"--help\" or \"help\" to get help.')
+        color_end()
+        return
+    
+    # Not exception will be raised when no more arguments are given.
+    argv = argv[2:]
+    if '-h' in argv or '--help' in argv:
+        cmd_help(func, has_abbrev)
+        return
+    
+    # parse argv
+    arg_pairs = pair_argv(argv, has_abbrev)
+    
+    # get opt_list from arg_pairs
+    opt_list = decode_opts(arg_pairs, func)
+
+    final_args = []
+    
+    for (typ, name, anno, value) in opt_list:
+        if typ != inspect.Parameter.POSITIONAL_ONLY:
+            final_args.append(f'{name}={repr(value)}')
+        else:
+            final_args.append(repr(value))
+    
+    func_call_str = f'{func.__name__}('    
+    func_call_str += ', '.join(final_args)
+    func_call_str += ')'
+    
+    eval(func_call_str, globals, locals)

optfunc2-0.1/src/optfunc2.egg-info/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.1
+Name: optfunc2
+Version: 0.1
+Summary: Generate options from function.
+Author-email: bajeer <z_bajer@yeah.net>
+Maintainer-email: bajeer <z_bajer@yeah.net>
+License: Copyright (c) 2016 The Python Packaging Authority (PyPA)
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy of
+        this software and associated documentation files (the "Software"), to deal in
+        the Software without restriction, including without limitation the rights to
+        use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+        of the Software, and to permit persons to whom the Software is furnished to do
+        so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://gitee.com/z-bajer/autocall
+Project-URL: Bug Reports, https://gitee.com/z-bajer/autocall/issues
+Project-URL: Source, https://gitee.com/z-bajer/autocall
+Keywords: call,function,option
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+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
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Provides-Extra: dev
+Requires-Dist: check-manifest; extra == "dev"
+Provides-Extra: test
+Requires-Dist: coverage; extra == "test"
+
+# 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.
+
+#### TODO
+1. Beautiful print.
+
+#### Code example
+``` python
+from optfunc 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.1/src/optfunc2.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE.txt
+README.md
+pyproject.toml
+src/test.py
+src/optfunc2/__init__.py
+src/optfunc2/parser.py
+src/optfunc2.egg-info/PKG-INFO
+src/optfunc2.egg-info/SOURCES.txt
+src/optfunc2.egg-info/dependency_links.txt
+src/optfunc2.egg-info/requires.txt
+src/optfunc2.egg-info/top_level.txt

optfunc2-0.1/src/optfunc2.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

optfunc2-0.1/src/optfunc2.egg-info/requires.txt

@@ -0,0 +1,6 @@
+
+[dev]
+check-manifest
+
+[test]
+coverage

optfunc2-0.1/src/optfunc2.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+optfunc2
+test

optfunc2-0.1/src/test.py

@@ -0,0 +1,41 @@
+#!/bin/python3
+import sys
+import os
+# sys.path.append("Z:\\autocall\\src")
+current_dir = os.path.dirname(os.path.realpath(__file__))
+autocall_dir = os.path.join(current_dir, 'src')
+sys.path.insert(0, current_dir)
+# print(sys.path)
+# sys.path.append(autocall_dir)
+# print(current_dir)
+from autocall import *
+import autocall
+
+@cmdline
+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
+
+@cmdline
+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
+
+@cmdline
+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__':
+    cmdline_start(globals=globals(), has_abbrev=False, header_doc='This is a test file for the module "autocall".')