Metadata-Version: 1.1
Name: ftpbench
Version: 1.0
Summary: Benchmark for ftp servers
Home-page: http://github.com/selectel/ftpbench
Author: Konstantin Enchant
Author-email: sirkonst@gmail.com
License: MIT
Description: .. -*- mode: rst -*-
        
        What is ``ftpbench``?
        ---------------------
        
        It's benchmark for load testing FTP servers.
        
        
        Feature
        -------
        
        * login benchmark
        * upload benchmark (STOR command)
        * download benchmark (RETR command)
        * run test for multiple servers
        * auto-detection for dns round-robin records
        * save result to cvs file
        
        
        Requires
        --------
        
        * gevent (http://www.gevent.org/)
        * dnspython (http://www.dnspython.org/)
        * docopt (http://docopt.org)
        * Timecard (https://github.com/selectel/timecard)
        
        
        Installation
        ------------
        
        From source::
        
            $ git clone https://github.com/selectel/ftpbench
            $ cd ftpbench/
            $ python setup.py install  # auto install all requires
        
        From pypi::
        
            $ pip install ftpbench
        
        Standalone for ubuntu::
        
            $ apt-get install python-gevent python-dnspython
            $ git clone https://github.com/selectel/ftpbench
            $ cd ftpbench/ftpbench/
            $ wget https://raw.githubusercontent.com/docopt/docopt/master/docopt.py
            $ wget https://raw.githubusercontent.com/selectel/timecard/master/timecard.py
            $ python ftpbench.py --help
        
        
        Usage
        -----
        
        Run::
        
            $ ftpbench --help
        
            FTP benchmark.
        
            Usage:
                ftpbench --help
                ftpbench -h <host> -u <user> -p <password> [options] login
                ftpbench -h <host> -u <user> -p <password> [options] upload <workdir> [-s <size>]
                ftpbench -h <host> -u <user> -p <password> [options] download <workdir> [-s <size>] [--files <count>]
        
            Connection options:
                -h <host>, --host=<host>              FTP host [default: 127.0.0.1:21]
                                                      You can list multiple servers, separated by commas,
                                                      e.g.: -h 10.0.0.1,10.0.0.2,10.0.0.3.
                                                      Auto-detection of dns round-robin records is supported.
                -u <user>, --user=<user>              FTP user
                -p <password>, --password=<password>  FTP password
        
            Timing options:
                -t <sec>, --timeout=<sec>             Timeout for operation [default: 10]
                --maxrun=<minutes>                    Duration of benchmarking in minutes [default: 5]
                --fixevery=<sec>                      Recording period for stat values [default: 5]
        
            Benchmark options:
                -c <count>, --concurrent=<count>      Concurrent operations [default: 10]
                --csv=<file>                          Save result to csv file
                <workdir>                             Base ftp dir to store test files
                -s <size>, --size=<size>              Size of test files in MB [default: 10]
                --files <count>                       Number of files generated for download test [default: 10]
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Environment :: Console :: Framebuffer
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Natural Language :: Russian
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Software Development :: Testing :: Traffic Generation
Classifier: Topic :: System :: Benchmark
Classifier: Topic :: Utilities
