Metadata-Version: 2.1
Name: iniparser2
Version: 2.1.0
Summary: An INI parser or config parser
Home-page: https://github.com/HugeBrain16/iniparser2
Author: HugeBrain16
Author-email: joshtuck373@gmail.com
License: MIT
Description: # iniparser2
          
        [![Build Status](https://travis-ci.com/HugeBrain16/iniparser2.svg?branch=main)](https://travis-ci.com/HugeBrain16/iniparser2)  
          
        **iniparser2** is An INI parser or a Config parser.  
          
        this package is the improved version of [**iniparser**](https://github.com/HugeBrain16/iniparser) (it's gone, but will be back soon...) with more features.
          
        ---
          
        ## Installation
        - using pip
            + from pypi
                * `pip install iniparser2`
                * `pip install iniparser2 --upgrade`
            + from github repository
                * `pip install git+https://github.com/HugeBrain16/iniparser2.git`
            + from source
                * `pip install .`
        - from source
            + `python setup.py install`
            + `python setup.py install --user`
          
        ## Examples
        #### read string
        ```py
        import iniparser2
        
        string = """
        [me]
        name = josh
        age = 0
        """
        
        parser = iniparser2.INI()
        parser.read(string)
        
        print(parser)
        ```
          
        #### using parser methods
        ```py
        import iniparser2
        
        parser = iniparser2.INI()
        
        parser.set_section("me")
        parser.set("name", "josh", section="me")
        parser.set("age", 0, section="me")
        
        print(parser)
        ```
            
        #### read from file
        ```py
        import iniparser2
        
        parser = iniparser2.INI()
        parser.read_file("filename.ini")
        
        print(parser)
        ```
          
        #### read-write file
        `file.ini`
        ```ini
        car = 1
        bike = 1
        ```
          
        `main.py`
        ```py
        import iniparser2
        
        parser = iniparser2.INI(convert_property=True)
        parser.read_file("file.ini")
        
        parser.set("car", parser.get("car") + 1)
        parser.remove_property("bike")
        
        parser.write("file.ini")
        parser.read_file("file.ini")
        
        print(parser)
        ```
        ### Exceptions
        exceptions because why not
          
        - base exception
            + `ParsingError`
                * `ParseSectionError`
                * `ParsePropertyError`
                * `ParseDuplicateError`
        - something else
            + `DuplicateError`
            + `PropertyError`
            + `SectionError`
Keywords: iniparser configparser ini config parser file
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
