Metadata-Version: 1.0
Name: clitool
Version: 0.4.0
Summary: Command Line Tool Utilities
Home-page: https://github.com/skitazaki/python-clitool
Author: KITAZAKI Shigeru
Author-email: skitazaki@gmail.com
License: Apache
Description: 
        ===================================
        Command Line Tool Utilities
        ===================================
        
        * One line argument parsing function and decorator
        * Simple configuration loader
        * Stream utility with some logging
        * CSV reader/writer unicode support for Python 2.x (in official document)
        * Apache accesslog parser
        
        Requirements
        ============
        
        * Python 2.7 or 3.x
        
        Python 2.4, 2.5, 2.6 are not supported.
        
        Install
        =======
        
        Use ``pip`` via PyPI.
        
        ::
        
            pip install clitool
        
        Bootstrap
        =========
        
        At first, create your script file using module script, ``clitool.cli``.
        
        ::
        
            $ python -m clitool.cli -o your-script.py
        
        This file can parse basic command line options and arguments.
        
        ::
        
            $ ./your-script.py --help
            usage: your-script.py [-h] [-c FILE] [-o FILE] [--basedir BASEDIR]
                                  [--input-encoding INPUT_ENCODING]
                                  [--output-encoding OUTPUT_ENCODING]
                                  [--processes PROCESSES] [--chunksize CHUNKSIZE]
                                  [-v | -q]
                                  [FILE [FILE ...]]
        
            positional arguments:
              FILE
        
            optional arguments:
              -h, --help            show this help message and exit
              -c FILE, --config FILE
                                    configuration file
              -o FILE, --output FILE
                                    output file
              --basedir BASEDIR     base directory
              --input-encoding INPUT_ENCODING
                                    encoding of input source
              --output-encoding OUTPUT_ENCODING
                                    encoding of output distination
              --processes PROCESSES
                                    count of processes
              --chunksize CHUNKSIZE
                                    a number of chunks submitted to the process pool
              -v, --verbose         set logging to verbose mode
              -q, --quiet           set logging to quiet mode
        
        Edit this script on your own :D
        
        Examples
        ========
        
        Example scripts exist in git repository.
        
        * csv2db.py: read csv data and import database via 'SQLAlchemy'.
        * csv2gexf.py: read csv data and dump them by GEXF format via 'NetworkX'.
        * csv2json.py: read csv data and dump them by JSON format.
        * csv2kml.py: read csv data and dump them by KML format via 'simplekml'.
        * logfile.py: parse Apache access log and create report.
        * logparams.py: parse Apache access log and analyze query parameters.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
