Metadata-Version: 1.1
Name: nkit4py
Version: 2.1.1
Summary: Fast XML to Python data (and vise versa) converter and filter. Written in C++ using Expat SAX parser.
Home-page: https://github.com/eye3/nkit4py
Author: Boris T. Darchiev
Author-email: boris.darchiev@gmail.com
License: Apache-2.0 <http://www.apache.org/licenses/LICENSE-2.0>
Description: Introduction
        ============
        
        nkit4py - is a nkit C++ library port to Python (see https://github.com/eye3/nkit.git).
        There is the same port to Node.js - nkit4nodejs (see https://github.com/eye3/nkit4nodejs.git)
        
        With nkit4py module you can convert XML string to Python data and vise versa.
        
        With XML-to-Python-data possibilities you can:
        ----------------------------------------------
         
        - Create Python data structures, which are different from the structure 
          of XML source.
          
        - Create multiple Python structures from one XML source.
        
        - Explicitly identify those elements and attributes in XML source that you
          want to use for building Python data structures.
          Thus, it's possible to filter out unnecessary XML-data.
        
        - Explicitly define Python type of scalar (primitive) data,
          fetched from XML source.
          Integers, numbers, strings, datetimes and booleans are supported.
        
        - Control progress of chunked download and parsing of big XML string
        
        - With extra options you can tune some aspects of conversion:
        	- trim text data
        	- explicitly define white space characters for trim option
        	- choose unicode or string type for text data
        
        Conversion is carried out using SAX parser Expat, so it's fast and uses less
        memory when parsing huge XML files.
        
        Module supports not only native Expat XML encodings, but also many others
        (see /deps/nkit/src/encoding/langs.inc)
        
        With Python-data-to-XML possibilities you can:
        ----------------------------------------------
        
        - Define root element name of result xml string
        - Define item element name for lists
        - Define encoding of result xml string
        - Pretty print with custom indentation and newline characters
        - Define special object key name for attributes
        - Define special object key name for text
        - Define which element of result xml string must contain CDATA section
        - Define precision for float numbers
        - Define format for Date objects
        
        
        Installation
        ============
        
        On Linux & Mac OS
        -----------------
        
            pip install nkit4py
        
        On Windows
        ----------
        
        Library compiles on MSVS Express version >= 2012.
        
        For MSVS 2012:
        
            SET VS90COMNTOOLS=%VS110COMNTOOLS%
        
            pip install nkit4py
        
        For MSVS 2013:
        
            SET VS90COMNTOOLS=%VS120COMNTOOLS%
        
            pip install nkit4py
        
        Usage
        =====
        
        See https://github.com/eye3/nkit4py
        
        Author
        ======
        
        Boris T. Darchiev (boris.darchiev@gmail.com)
        
        On github: https://github.com/eye3
        
        Any feedback or pull request are welcome!
        
Keywords: xml python object list json convertor filter fast expat sax xpath nkit nkit4py xml2py xml2json
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Environment :: MacOS X
Classifier: Environment :: No Input/Output (Daemon)
Classifier: Environment :: Win32 (MS Windows)
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Other Audience
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: MacOS
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: C++
Classifier: Topic :: Text Processing
Classifier: Topic :: Text Processing :: Filters
Classifier: Topic :: Text Processing :: Markup :: XML
Classifier: Topic :: Software Development :: Libraries :: Python Modules
