automatic import of python-argconfigparse

3 files changed, 923 insertions, 0 deletions

diff --git a/.gitignore b/.gitignore
index e69de29..f3da984 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/ArgConfigParse-0.2.7.tar.gz
diff --git a/python-argconfigparse.spec b/python-argconfigparse.spec
new file mode 100644
index 0000000..41a09ba
--- /dev/null
+++ b/python-argconfigparse.spec
@@ -0,0 +1,921 @@
+%global _empty_manifest_terminate_build 0
+Name:		python-ArgConfigParse
+Version:	0.2.7
+Release:	1
+Summary:	Merge multiple configuraton files and command line arguments into a single configuration
+License:	GP
+URL:		https://github.com/txoof/ArgConfigParse
+Source0:	https://mirrors.nju.edu.cn/pypi/web/packages/2f/8f/7a8119d7be8a1e645a45feb813d4c5ba4c412fde7c1375205d850eebaaa7/ArgConfigParse-0.2.7.tar.gz
+BuildArch:	noarch
+
+
+%description
+# ArgConfigParse
+Merge command line arguments and config file(s) into a single dictionary using python standard argparse and configparser modules.
+
+ArgConfigParse provides the following Classes and functions:
+
+**Classes** 
+* `ConfigFile()`
+* `CmdArg()`
+
+**Functions**
+* `merge_dict()`
+* `fullPath()`
+
+ConfigFile reads one or more config files and destructively merges each configuration file with the following file. Any keys/value pairs that are repeated in each subsequent config file will effectively over write the previous values for the same key. This is useful for handling system-wide configuration files that can be over-ridden with individual user configuration files.
+
+CmdArg parses sys.argv command line arguments and creates nested dictionaries that can be easily merged with the values from the ConfigFiles.
+
+Command line arguments that do not appear in the configuration file are stored in `__cmd_line` 
+
+## Examples
+### ConfigFile() Examples
+Class for handling multiple similar configuration files and merging the contents sequentially.
+
+**system wide configuration file**
+```
+    #/etc/spam_sketch
+    [Main]
+    menu = ["spam", "eggs and spam"]
+    debug = INFO
+    output_device = dead_parrot
+
+
+    [waiter]
+    name = Terry
+    tone = shrill
+    attempts = 10
+    pause = False
+```
+**user configuration file**
+```
+    #/home/monty/.config/spam_sketch
+    [Main]
+    menu = ["spam", "eggs and spam", "spam; spam; spam and eggs", "eggs; spam spam and toast"]
+    debug = DEBUG
+
+    [waiter]
+    name = John
+    tone = shrill
+    attempts = 10
+    pause = False
+
+    [customer1]
+    name = Eric
+    patience = .8
+    order = "anything but spam"
+
+    [customer2]
+    name = Graham
+    patience = .2
+    order = "toast"
+```
+
+**Read Configuration Files**
+```
+    import ArgConfigParse
+    # read /etc/spam_sketch followed by ~/.config/spam_sketch 
+    # values in ~/.config/spam_sketch override /etc/spam_sketch
+    config = ArgConfigParse.ConfigFile(['/etc/spam_sketch', '~/.config/spam_sketch'])
+
+    config.parse_config()
+    print(config.config_dict)
+    >>> {'Main': {'menu': '["spam", "eggs and spam", "spam; spam; spam and eggs", "eggs; spam spam and toast"]', 'debug': 'DEBUG', 'output_device': 'dead_parrot'}, 'waiter': {'name': 'John', 'tone': 'shrill', 'attempts': '10', 'pause': 'False'}, 'customer1': {'name': 'Eric', 'patience': '.8', 'order': '"anything but spam"'}, 'customer2': {'name': 'Graham', 'patience': '.2', 'order': '"toast"'}}
+
+```
+
+### CmdArg() Examples
+**Parse Command Line Arguments**
+```
+    import ArgConfigParse
+    # create the argument parser object
+    cmd_args = CmdArgs()
+    # set some toy sys.arv values
+    sys.argv = ['-V', '-m', ['spam', 'toast and spam', 'one dead parrot']]
+
+    # add arguments to be accepted from the command line
+
+    # this option will be stored in {'main': {'menu': <list>'}}
+    cmd_args.add_argument('-m', '--menu', ignore_none=True, 
+                          metavar='["item one", "item two", "item three"]', 
+                          type=list,
+                          dest='main__menu', 
+                          help='list of menu items')
+
+
+    # this option will be stored in {'waiter':{'tone': <value>'}}
+    cmd_args.add_argument('-t', '--tone', ignore_none=True, metavar='TONE', type=str,
+                           choices=['kind', 'shrill', 'annoying', 'loud'], dest='waiter__tone', 
+                           help='tone of waiter')
+
+    # this option will be stored in __cmd_line 
+    cmd_args.add_argument('-V', '--version', action='store_true', dest='version', 
+                          default=False, help='display version nubmer and exit')
+
+
+    # parse sys.argv values
+    cmd_args.parse_args()
+
+    # show parsed values
+    print(cmd_args.options)
+    >>> Namespace(main__menu=['spam', 'toast and spam', 'one dead parrot'], main__output_device=None, version=True, waiter__tone=None)
+
+    # show nested dictionary
+    print(cmd_args.nested_opts_dict)
+    >>> {'__cmd_line': {'version': True}, 'main': {'menu': ['spam', 'toast and spam', 'one dead parrot']}}
+```
+
+### merge_dict() Examples
+**Merge command line arguments and config files**
+```
+    # command line options override config files
+    options = merge_dict(config.config_dict, cmd_args.nested_opts_dict)
+    print(options)
+    >>> {'__cmd_line': {'version': True}, 'main': {'menu': ['spam', 'toast and spam', 'one dead parrot']}, 'Main': {'menu': '["spam", "eggs and spam", "spam; spam; spam and eggs", "eggs; spam spam and toast"]', 'debug': 'DEBUG', 'output_device': 'dead_parrot'}, 'waiter': {'name': 'John', 'tone': 'shrill', 'attempts': '10', 'pause': 'False'}, 'customer1': {'name': 'Eric', 'patience': '.8', 'order': '"anything but spam"'}, 'customer2': {'name': 'Graham', 'patience': '.2', 'order': '"toast"'}}
+
+
+
+    # config files override command line options
+    options merge_dict(cmd_args.nested_opts_dict, config.config_dict,)
+    print(options)
+    >>> {'Main': {'menu': '["spam", "eggs and spam", "spam; spam; spam and eggs", "eggs; spam spam and toast"]', 'debug': 'DEBUG', 'output_device': 'dead_parrot'}, 'waiter': {'name': 'John', 'tone': 'shrill', 'attempts': '10', 'pause': 'False'}, 'customer1': {'name': 'Eric', 'patience': '.8', 'order': '"anything but spam"'}, 'customer2': {'name': 'Graham', 'patience': '.2', 'order': '"toast"'}, '__cmd_line': {'version': True}, 'main': {'menu': ['spam', 'toast and spam', 'one dead parrot']}}    
+```
+
+## Documentation
+
+### class CmdArgs(builtins.object)
+     |  CmdArgs(args=None)
+     |  
+     |  command line argument parser object 
+     |  
+     |  
+     |  
+     |  
+     |  Args:
+     |      args(`list`): sys.argv is typically passed here
+     |      
+     |  Properties:
+     |      parser(`argparse.ArgumentParser`): argument parser object
+     |      args(`list`): list of arguments
+     |      unknown(`list`): list of unknown arguments that are ignored
+     |      options(NameSpace): argument parser generated namespace of arguments
+     |      opts_dict(`dict`): namespace -> dictionary
+     |  
+     |  Methods defined here:
+     |  
+     |  __init__(self, args=None)
+     |      Initialize self.  See help(type(self)) for accurate signature.
+     |  
+     |  add_argument(self, *args, **kwargs)
+     |      add arguments to the parser.argparse.ArgumentParser object 
+     |          use the standard *args and **kwargs for argparse
+     |          
+     |          arguments added using the kwarg `dest=section__option_name`
+     |          note the format [[section_name]]__[[option_name]]
+     |          will be nested in the `opts_dict` property in the format:
+     |          {'section': 
+     |                      {'option_name': 'value'
+     |                       'option_two': 'value'}}
+     |                       
+     |          the `nested_opts_dict` property can then be merged with a ConfigFile 
+     |          `config_dict` property using the merge_dicts() function:
+     |          merge_dicts(obj:`ConfigFile.config_dict`, obj:`Options.nested_opts_dict`) 
+     |          to override the options set in the configuration file(s) with
+     |          commandline arguments
+     |      
+     |      Args:
+     |          ignore_none(`bool`): ignore this option if set to `None` when building configuration dictionary
+     |          ignore_false(`bool`): ignore this option if set to `False` when building configuation dictionary
+     |          *args, **kwargs
+     |  
+     |  parse_args(self)
+     |      parse arguments and set dictionaries
+     |          
+     |      Sets:
+     |          args(`list`): list of arguments
+     |          unknown_args: args that have been passed, but are not known
+     |          options(Nampespace): namespace of parsed known arguments
+     |          opts_dict(`dict`): flat dictionary containing arguments
+     |          nested_opts_dict(`dict` of `dict` of `str`): parsed arguments
+     |              nested to match ConfigFile.opts_dict:
+     |              {'section_name': {'option1': 'valueY'
+     |                                'option2': 'valueZ'}
+     |                                
+     |               'section_two':  {'optionX': 'setting1'
+     |                                'optionY': 'other_setting'}}
+     |                                
+     |          see add_argument() for more information
+
+
+### class ConfigFile(builtins.object)
+     |  ConfigFile(config_files=None)
+     |  
+     |  Read and parse one or more INI style configuration files
+     |  
+     |      Creates a configparser.ConfigParser() object and reads multiple
+     |      configuration files. Settings in each file supersedes pervious files
+     |      `config_files`=[default, system, user] 
+     |      * default - read first
+     |      * system - read second and overwrites default
+     |      * user - read last and overwrites system
+     |      
+     |  Args:
+     |      config_files(`list`): list of configuration files to read
+     |  Properties:
+     |      config_files(`list` of `str` or `pathlib.PosixPath`): str or Path() objects to read
+     |      parser(`configparser.ConfigParser obj`): config parser object
+     |      config_dict(`dict` of `dict`): nested configuration dict following INI file format:
+     |          Sample config.ini:
+     |          
+     |              [Section]
+     |              option = value
+     |              option2 = True
+     |  
+     |              [Main]
+     |              log_level = DEBUG
+     |          
+     |          Yeilds -> config_dict:
+     |          
+     |              {'Section': {'option': 'value', 'option2': True}
+     |               'Main': {'log_level': 'DEBUG'}}
+     |  
+     |  Methods defined here:
+     |  
+     |  __init__(self, config_files=None)
+     |      Initialize self.  See help(type(self)) for accurate signature.
+     |  
+     |  parse_config(self)
+     |      reads and stores configuration values from `config_files` in left-to-right order
+     |          right-most section/option/values overwrite left-most section/option/values
+     |      
+     |      Returns:
+     |          config_dict(`dict` of `dict`)
+     |      Sets: config_dict
+
+### merge_dict(a, b)
+    recursivley merge two dictionarys overwriting values
+        known issue: if `a` contains a different data type than `b`, 
+        `b` will completely overwrite the data in `a`
+
+    Args:
+        a(`dict`): nested dictionary
+        b(`dict`): nested dictionary 
+
+    Returns:
+        `dict`
+
+### write(dictionary, file, create=False)
+    Help on function write in module __main__:
+
+    write(dictionary, file, create=False)
+        write a configuration dictionary to a file; skip over sections that begin with `__`
+
+        Args: 
+            dictionary(`dict`): nested dictionary
+            file(`string` or `Path`): path to config file
+            create(`bool`): create the file and path if it does not exist
+
+        Returns:
+            file(`Path`): path to config file
+
+## Limitations
+Configuration file section names cannot contain the following characters:
+* `'__'` -- two or more underscores consecutively
+    - OK: `main_section`
+    - OK: `waiter_configuration_settings`
+    - Not OK: `main__section` -- this will result in an unintended nested section in the options dictionary
+* `' '` -- one or more literal space
+
+
+```python
+
+```
+
+
+
+
+%package -n python3-ArgConfigParse
+Summary:	Merge multiple configuraton files and command line arguments into a single configuration
+Provides:	python-ArgConfigParse
+BuildRequires:	python3-devel
+BuildRequires:	python3-setuptools
+BuildRequires:	python3-pip
+%description -n python3-ArgConfigParse
+# ArgConfigParse
+Merge command line arguments and config file(s) into a single dictionary using python standard argparse and configparser modules.
+
+ArgConfigParse provides the following Classes and functions:
+
+**Classes** 
+* `ConfigFile()`
+* `CmdArg()`
+
+**Functions**
+* `merge_dict()`
+* `fullPath()`
+
+ConfigFile reads one or more config files and destructively merges each configuration file with the following file. Any keys/value pairs that are repeated in each subsequent config file will effectively over write the previous values for the same key. This is useful for handling system-wide configuration files that can be over-ridden with individual user configuration files.
+
+CmdArg parses sys.argv command line arguments and creates nested dictionaries that can be easily merged with the values from the ConfigFiles.
+
+Command line arguments that do not appear in the configuration file are stored in `__cmd_line` 
+
+## Examples
+### ConfigFile() Examples
+Class for handling multiple similar configuration files and merging the contents sequentially.
+
+**system wide configuration file**
+```
+    #/etc/spam_sketch
+    [Main]
+    menu = ["spam", "eggs and spam"]
+    debug = INFO
+    output_device = dead_parrot
+
+
+    [waiter]
+    name = Terry
+    tone = shrill
+    attempts = 10
+    pause = False
+```
+**user configuration file**
+```
+    #/home/monty/.config/spam_sketch
+    [Main]
+    menu = ["spam", "eggs and spam", "spam; spam; spam and eggs", "eggs; spam spam and toast"]
+    debug = DEBUG
+
+    [waiter]
+    name = John
+    tone = shrill
+    attempts = 10
+    pause = False
+
+    [customer1]
+    name = Eric
+    patience = .8
+    order = "anything but spam"
+
+    [customer2]
+    name = Graham
+    patience = .2
+    order = "toast"
+```
+
+**Read Configuration Files**
+```
+    import ArgConfigParse
+    # read /etc/spam_sketch followed by ~/.config/spam_sketch 
+    # values in ~/.config/spam_sketch override /etc/spam_sketch
+    config = ArgConfigParse.ConfigFile(['/etc/spam_sketch', '~/.config/spam_sketch'])
+
+    config.parse_config()
+    print(config.config_dict)
+    >>> {'Main': {'menu': '["spam", "eggs and spam", "spam; spam; spam and eggs", "eggs; spam spam and toast"]', 'debug': 'DEBUG', 'output_device': 'dead_parrot'}, 'waiter': {'name': 'John', 'tone': 'shrill', 'attempts': '10', 'pause': 'False'}, 'customer1': {'name': 'Eric', 'patience': '.8', 'order': '"anything but spam"'}, 'customer2': {'name': 'Graham', 'patience': '.2', 'order': '"toast"'}}
+
+```
+
+### CmdArg() Examples
+**Parse Command Line Arguments**
+```
+    import ArgConfigParse
+    # create the argument parser object
+    cmd_args = CmdArgs()
+    # set some toy sys.arv values
+    sys.argv = ['-V', '-m', ['spam', 'toast and spam', 'one dead parrot']]
+
+    # add arguments to be accepted from the command line
+
+    # this option will be stored in {'main': {'menu': <list>'}}
+    cmd_args.add_argument('-m', '--menu', ignore_none=True, 
+                          metavar='["item one", "item two", "item three"]', 
+                          type=list,
+                          dest='main__menu', 
+                          help='list of menu items')
+
+
+    # this option will be stored in {'waiter':{'tone': <value>'}}
+    cmd_args.add_argument('-t', '--tone', ignore_none=True, metavar='TONE', type=str,
+                           choices=['kind', 'shrill', 'annoying', 'loud'], dest='waiter__tone', 
+                           help='tone of waiter')
+
+    # this option will be stored in __cmd_line 
+    cmd_args.add_argument('-V', '--version', action='store_true', dest='version', 
+                          default=False, help='display version nubmer and exit')
+
+
+    # parse sys.argv values
+    cmd_args.parse_args()
+
+    # show parsed values
+    print(cmd_args.options)
+    >>> Namespace(main__menu=['spam', 'toast and spam', 'one dead parrot'], main__output_device=None, version=True, waiter__tone=None)
+
+    # show nested dictionary
+    print(cmd_args.nested_opts_dict)
+    >>> {'__cmd_line': {'version': True}, 'main': {'menu': ['spam', 'toast and spam', 'one dead parrot']}}
+```
+
+### merge_dict() Examples
+**Merge command line arguments and config files**
+```
+    # command line options override config files
+    options = merge_dict(config.config_dict, cmd_args.nested_opts_dict)
+    print(options)
+    >>> {'__cmd_line': {'version': True}, 'main': {'menu': ['spam', 'toast and spam', 'one dead parrot']}, 'Main': {'menu': '["spam", "eggs and spam", "spam; spam; spam and eggs", "eggs; spam spam and toast"]', 'debug': 'DEBUG', 'output_device': 'dead_parrot'}, 'waiter': {'name': 'John', 'tone': 'shrill', 'attempts': '10', 'pause': 'False'}, 'customer1': {'name': 'Eric', 'patience': '.8', 'order': '"anything but spam"'}, 'customer2': {'name': 'Graham', 'patience': '.2', 'order': '"toast"'}}
+
+
+
+    # config files override command line options
+    options merge_dict(cmd_args.nested_opts_dict, config.config_dict,)
+    print(options)
+    >>> {'Main': {'menu': '["spam", "eggs and spam", "spam; spam; spam and eggs", "eggs; spam spam and toast"]', 'debug': 'DEBUG', 'output_device': 'dead_parrot'}, 'waiter': {'name': 'John', 'tone': 'shrill', 'attempts': '10', 'pause': 'False'}, 'customer1': {'name': 'Eric', 'patience': '.8', 'order': '"anything but spam"'}, 'customer2': {'name': 'Graham', 'patience': '.2', 'order': '"toast"'}, '__cmd_line': {'version': True}, 'main': {'menu': ['spam', 'toast and spam', 'one dead parrot']}}    
+```
+
+## Documentation
+
+### class CmdArgs(builtins.object)
+     |  CmdArgs(args=None)
+     |  
+     |  command line argument parser object 
+     |  
+     |  
+     |  
+     |  
+     |  Args:
+     |      args(`list`): sys.argv is typically passed here
+     |      
+     |  Properties:
+     |      parser(`argparse.ArgumentParser`): argument parser object
+     |      args(`list`): list of arguments
+     |      unknown(`list`): list of unknown arguments that are ignored
+     |      options(NameSpace): argument parser generated namespace of arguments
+     |      opts_dict(`dict`): namespace -> dictionary
+     |  
+     |  Methods defined here:
+     |  
+     |  __init__(self, args=None)
+     |      Initialize self.  See help(type(self)) for accurate signature.
+     |  
+     |  add_argument(self, *args, **kwargs)
+     |      add arguments to the parser.argparse.ArgumentParser object 
+     |          use the standard *args and **kwargs for argparse
+     |          
+     |          arguments added using the kwarg `dest=section__option_name`
+     |          note the format [[section_name]]__[[option_name]]
+     |          will be nested in the `opts_dict` property in the format:
+     |          {'section': 
+     |                      {'option_name': 'value'
+     |                       'option_two': 'value'}}
+     |                       
+     |          the `nested_opts_dict` property can then be merged with a ConfigFile 
+     |          `config_dict` property using the merge_dicts() function:
+     |          merge_dicts(obj:`ConfigFile.config_dict`, obj:`Options.nested_opts_dict`) 
+     |          to override the options set in the configuration file(s) with
+     |          commandline arguments
+     |      
+     |      Args:
+     |          ignore_none(`bool`): ignore this option if set to `None` when building configuration dictionary
+     |          ignore_false(`bool`): ignore this option if set to `False` when building configuation dictionary
+     |          *args, **kwargs
+     |  
+     |  parse_args(self)
+     |      parse arguments and set dictionaries
+     |          
+     |      Sets:
+     |          args(`list`): list of arguments
+     |          unknown_args: args that have been passed, but are not known
+     |          options(Nampespace): namespace of parsed known arguments
+     |          opts_dict(`dict`): flat dictionary containing arguments
+     |          nested_opts_dict(`dict` of `dict` of `str`): parsed arguments
+     |              nested to match ConfigFile.opts_dict:
+     |              {'section_name': {'option1': 'valueY'
+     |                                'option2': 'valueZ'}
+     |                                
+     |               'section_two':  {'optionX': 'setting1'
+     |                                'optionY': 'other_setting'}}
+     |                                
+     |          see add_argument() for more information
+
+
+### class ConfigFile(builtins.object)
+     |  ConfigFile(config_files=None)
+     |  
+     |  Read and parse one or more INI style configuration files
+     |  
+     |      Creates a configparser.ConfigParser() object and reads multiple
+     |      configuration files. Settings in each file supersedes pervious files
+     |      `config_files`=[default, system, user] 
+     |      * default - read first
+     |      * system - read second and overwrites default
+     |      * user - read last and overwrites system
+     |      
+     |  Args:
+     |      config_files(`list`): list of configuration files to read
+     |  Properties:
+     |      config_files(`list` of `str` or `pathlib.PosixPath`): str or Path() objects to read
+     |      parser(`configparser.ConfigParser obj`): config parser object
+     |      config_dict(`dict` of `dict`): nested configuration dict following INI file format:
+     |          Sample config.ini:
+     |          
+     |              [Section]
+     |              option = value
+     |              option2 = True
+     |  
+     |              [Main]
+     |              log_level = DEBUG
+     |          
+     |          Yeilds -> config_dict:
+     |          
+     |              {'Section': {'option': 'value', 'option2': True}
+     |               'Main': {'log_level': 'DEBUG'}}
+     |  
+     |  Methods defined here:
+     |  
+     |  __init__(self, config_files=None)
+     |      Initialize self.  See help(type(self)) for accurate signature.
+     |  
+     |  parse_config(self)
+     |      reads and stores configuration values from `config_files` in left-to-right order
+     |          right-most section/option/values overwrite left-most section/option/values
+     |      
+     |      Returns:
+     |          config_dict(`dict` of `dict`)
+     |      Sets: config_dict
+
+### merge_dict(a, b)
+    recursivley merge two dictionarys overwriting values
+        known issue: if `a` contains a different data type than `b`, 
+        `b` will completely overwrite the data in `a`
+
+    Args:
+        a(`dict`): nested dictionary
+        b(`dict`): nested dictionary 
+
+    Returns:
+        `dict`
+
+### write(dictionary, file, create=False)
+    Help on function write in module __main__:
+
+    write(dictionary, file, create=False)
+        write a configuration dictionary to a file; skip over sections that begin with `__`
+
+        Args: 
+            dictionary(`dict`): nested dictionary
+            file(`string` or `Path`): path to config file
+            create(`bool`): create the file and path if it does not exist
+
+        Returns:
+            file(`Path`): path to config file
+
+## Limitations
+Configuration file section names cannot contain the following characters:
+* `'__'` -- two or more underscores consecutively
+    - OK: `main_section`
+    - OK: `waiter_configuration_settings`
+    - Not OK: `main__section` -- this will result in an unintended nested section in the options dictionary
+* `' '` -- one or more literal space
+
+
+```python
+
+```
+
+
+
+
+%package help
+Summary:	Development documents and examples for ArgConfigParse
+Provides:	python3-ArgConfigParse-doc
+%description help
+# ArgConfigParse
+Merge command line arguments and config file(s) into a single dictionary using python standard argparse and configparser modules.
+
+ArgConfigParse provides the following Classes and functions:
+
+**Classes** 
+* `ConfigFile()`
+* `CmdArg()`
+
+**Functions**
+* `merge_dict()`
+* `fullPath()`
+
+ConfigFile reads one or more config files and destructively merges each configuration file with the following file. Any keys/value pairs that are repeated in each subsequent config file will effectively over write the previous values for the same key. This is useful for handling system-wide configuration files that can be over-ridden with individual user configuration files.
+
+CmdArg parses sys.argv command line arguments and creates nested dictionaries that can be easily merged with the values from the ConfigFiles.
+
+Command line arguments that do not appear in the configuration file are stored in `__cmd_line` 
+
+## Examples
+### ConfigFile() Examples
+Class for handling multiple similar configuration files and merging the contents sequentially.
+
+**system wide configuration file**
+```
+    #/etc/spam_sketch
+    [Main]
+    menu = ["spam", "eggs and spam"]
+    debug = INFO
+    output_device = dead_parrot
+
+
+    [waiter]
+    name = Terry
+    tone = shrill
+    attempts = 10
+    pause = False
+```
+**user configuration file**
+```
+    #/home/monty/.config/spam_sketch
+    [Main]
+    menu = ["spam", "eggs and spam", "spam; spam; spam and eggs", "eggs; spam spam and toast"]
+    debug = DEBUG
+
+    [waiter]
+    name = John
+    tone = shrill
+    attempts = 10
+    pause = False
+
+    [customer1]
+    name = Eric
+    patience = .8
+    order = "anything but spam"
+
+    [customer2]
+    name = Graham
+    patience = .2
+    order = "toast"
+```
+
+**Read Configuration Files**
+```
+    import ArgConfigParse
+    # read /etc/spam_sketch followed by ~/.config/spam_sketch 
+    # values in ~/.config/spam_sketch override /etc/spam_sketch
+    config = ArgConfigParse.ConfigFile(['/etc/spam_sketch', '~/.config/spam_sketch'])
+
+    config.parse_config()
+    print(config.config_dict)
+    >>> {'Main': {'menu': '["spam", "eggs and spam", "spam; spam; spam and eggs", "eggs; spam spam and toast"]', 'debug': 'DEBUG', 'output_device': 'dead_parrot'}, 'waiter': {'name': 'John', 'tone': 'shrill', 'attempts': '10', 'pause': 'False'}, 'customer1': {'name': 'Eric', 'patience': '.8', 'order': '"anything but spam"'}, 'customer2': {'name': 'Graham', 'patience': '.2', 'order': '"toast"'}}
+
+```
+
+### CmdArg() Examples
+**Parse Command Line Arguments**
+```
+    import ArgConfigParse
+    # create the argument parser object
+    cmd_args = CmdArgs()
+    # set some toy sys.arv values
+    sys.argv = ['-V', '-m', ['spam', 'toast and spam', 'one dead parrot']]
+
+    # add arguments to be accepted from the command line
+
+    # this option will be stored in {'main': {'menu': <list>'}}
+    cmd_args.add_argument('-m', '--menu', ignore_none=True, 
+                          metavar='["item one", "item two", "item three"]', 
+                          type=list,
+                          dest='main__menu', 
+                          help='list of menu items')
+
+
+    # this option will be stored in {'waiter':{'tone': <value>'}}
+    cmd_args.add_argument('-t', '--tone', ignore_none=True, metavar='TONE', type=str,
+                           choices=['kind', 'shrill', 'annoying', 'loud'], dest='waiter__tone', 
+                           help='tone of waiter')
+
+    # this option will be stored in __cmd_line 
+    cmd_args.add_argument('-V', '--version', action='store_true', dest='version', 
+                          default=False, help='display version nubmer and exit')
+
+
+    # parse sys.argv values
+    cmd_args.parse_args()
+
+    # show parsed values
+    print(cmd_args.options)
+    >>> Namespace(main__menu=['spam', 'toast and spam', 'one dead parrot'], main__output_device=None, version=True, waiter__tone=None)
+
+    # show nested dictionary
+    print(cmd_args.nested_opts_dict)
+    >>> {'__cmd_line': {'version': True}, 'main': {'menu': ['spam', 'toast and spam', 'one dead parrot']}}
+```
+
+### merge_dict() Examples
+**Merge command line arguments and config files**
+```
+    # command line options override config files
+    options = merge_dict(config.config_dict, cmd_args.nested_opts_dict)
+    print(options)
+    >>> {'__cmd_line': {'version': True}, 'main': {'menu': ['spam', 'toast and spam', 'one dead parrot']}, 'Main': {'menu': '["spam", "eggs and spam", "spam; spam; spam and eggs", "eggs; spam spam and toast"]', 'debug': 'DEBUG', 'output_device': 'dead_parrot'}, 'waiter': {'name': 'John', 'tone': 'shrill', 'attempts': '10', 'pause': 'False'}, 'customer1': {'name': 'Eric', 'patience': '.8', 'order': '"anything but spam"'}, 'customer2': {'name': 'Graham', 'patience': '.2', 'order': '"toast"'}}
+
+
+
+    # config files override command line options
+    options merge_dict(cmd_args.nested_opts_dict, config.config_dict,)
+    print(options)
+    >>> {'Main': {'menu': '["spam", "eggs and spam", "spam; spam; spam and eggs", "eggs; spam spam and toast"]', 'debug': 'DEBUG', 'output_device': 'dead_parrot'}, 'waiter': {'name': 'John', 'tone': 'shrill', 'attempts': '10', 'pause': 'False'}, 'customer1': {'name': 'Eric', 'patience': '.8', 'order': '"anything but spam"'}, 'customer2': {'name': 'Graham', 'patience': '.2', 'order': '"toast"'}, '__cmd_line': {'version': True}, 'main': {'menu': ['spam', 'toast and spam', 'one dead parrot']}}    
+```
+
+## Documentation
+
+### class CmdArgs(builtins.object)
+     |  CmdArgs(args=None)
+     |  
+     |  command line argument parser object 
+     |  
+     |  
+     |  
+     |  
+     |  Args:
+     |      args(`list`): sys.argv is typically passed here
+     |      
+     |  Properties:
+     |      parser(`argparse.ArgumentParser`): argument parser object
+     |      args(`list`): list of arguments
+     |      unknown(`list`): list of unknown arguments that are ignored
+     |      options(NameSpace): argument parser generated namespace of arguments
+     |      opts_dict(`dict`): namespace -> dictionary
+     |  
+     |  Methods defined here:
+     |  
+     |  __init__(self, args=None)
+     |      Initialize self.  See help(type(self)) for accurate signature.
+     |  
+     |  add_argument(self, *args, **kwargs)
+     |      add arguments to the parser.argparse.ArgumentParser object 
+     |          use the standard *args and **kwargs for argparse
+     |          
+     |          arguments added using the kwarg `dest=section__option_name`
+     |          note the format [[section_name]]__[[option_name]]
+     |          will be nested in the `opts_dict` property in the format:
+     |          {'section': 
+     |                      {'option_name': 'value'
+     |                       'option_two': 'value'}}
+     |                       
+     |          the `nested_opts_dict` property can then be merged with a ConfigFile 
+     |          `config_dict` property using the merge_dicts() function:
+     |          merge_dicts(obj:`ConfigFile.config_dict`, obj:`Options.nested_opts_dict`) 
+     |          to override the options set in the configuration file(s) with
+     |          commandline arguments
+     |      
+     |      Args:
+     |          ignore_none(`bool`): ignore this option if set to `None` when building configuration dictionary
+     |          ignore_false(`bool`): ignore this option if set to `False` when building configuation dictionary
+     |          *args, **kwargs
+     |  
+     |  parse_args(self)
+     |      parse arguments and set dictionaries
+     |          
+     |      Sets:
+     |          args(`list`): list of arguments
+     |          unknown_args: args that have been passed, but are not known
+     |          options(Nampespace): namespace of parsed known arguments
+     |          opts_dict(`dict`): flat dictionary containing arguments
+     |          nested_opts_dict(`dict` of `dict` of `str`): parsed arguments
+     |              nested to match ConfigFile.opts_dict:
+     |              {'section_name': {'option1': 'valueY'
+     |                                'option2': 'valueZ'}
+     |                                
+     |               'section_two':  {'optionX': 'setting1'
+     |                                'optionY': 'other_setting'}}
+     |                                
+     |          see add_argument() for more information
+
+
+### class ConfigFile(builtins.object)
+     |  ConfigFile(config_files=None)
+     |  
+     |  Read and parse one or more INI style configuration files
+     |  
+     |      Creates a configparser.ConfigParser() object and reads multiple
+     |      configuration files. Settings in each file supersedes pervious files
+     |      `config_files`=[default, system, user] 
+     |      * default - read first
+     |      * system - read second and overwrites default
+     |      * user - read last and overwrites system
+     |      
+     |  Args:
+     |      config_files(`list`): list of configuration files to read
+     |  Properties:
+     |      config_files(`list` of `str` or `pathlib.PosixPath`): str or Path() objects to read
+     |      parser(`configparser.ConfigParser obj`): config parser object
+     |      config_dict(`dict` of `dict`): nested configuration dict following INI file format:
+     |          Sample config.ini:
+     |          
+     |              [Section]
+     |              option = value
+     |              option2 = True
+     |  
+     |              [Main]
+     |              log_level = DEBUG
+     |          
+     |          Yeilds -> config_dict:
+     |          
+     |              {'Section': {'option': 'value', 'option2': True}
+     |               'Main': {'log_level': 'DEBUG'}}
+     |  
+     |  Methods defined here:
+     |  
+     |  __init__(self, config_files=None)
+     |      Initialize self.  See help(type(self)) for accurate signature.
+     |  
+     |  parse_config(self)
+     |      reads and stores configuration values from `config_files` in left-to-right order
+     |          right-most section/option/values overwrite left-most section/option/values
+     |      
+     |      Returns:
+     |          config_dict(`dict` of `dict`)
+     |      Sets: config_dict
+
+### merge_dict(a, b)
+    recursivley merge two dictionarys overwriting values
+        known issue: if `a` contains a different data type than `b`, 
+        `b` will completely overwrite the data in `a`
+
+    Args:
+        a(`dict`): nested dictionary
+        b(`dict`): nested dictionary 
+
+    Returns:
+        `dict`
+
+### write(dictionary, file, create=False)
+    Help on function write in module __main__:
+
+    write(dictionary, file, create=False)
+        write a configuration dictionary to a file; skip over sections that begin with `__`
+
+        Args: 
+            dictionary(`dict`): nested dictionary
+            file(`string` or `Path`): path to config file
+            create(`bool`): create the file and path if it does not exist
+
+        Returns:
+            file(`Path`): path to config file
+
+## Limitations
+Configuration file section names cannot contain the following characters:
+* `'__'` -- two or more underscores consecutively
+    - OK: `main_section`
+    - OK: `waiter_configuration_settings`
+    - Not OK: `main__section` -- this will result in an unintended nested section in the options dictionary
+* `' '` -- one or more literal space
+
+
+```python
+
+```
+
+
+
+
+%prep
+%autosetup -n ArgConfigParse-0.2.7
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+	find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+	find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+	find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+	find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+	find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-ArgConfigParse -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Wed May 17 2023 Python_Bot <Python_Bot@openeuler.org> - 0.2.7-1
+- Package Spec generated
diff --git a/sources b/sources
new file mode 100644
index 0000000..320c366
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+639ad01562a677daa8fe94a9809cd492  ArgConfigParse-0.2.7.tar.gz