Metadata-Version: 1.1
Name: disk-bench
Version: 0.2.1
Summary: CLI tool to benchmark drive performance
Home-page: https://github.com/rsyring/disk-bench
Author: Randy Syring
Author-email: randy@thesyrings.us
License: MIT
Description: .. default-role:: code
        
        Disk Bench
        ##########
        
        Designed to run similar tests as Crystal Disk Mark using fio with user friendly output options.
        
        Tests ran:
        
        * Sequential read/write w/ 1MB block size
        * Random read/write w/ 512K block size
        * Queue depth 32 random read/write 4K blocks size
        
        Install
        =======
        
        ::
        
            # system install
            $ sudo pip3 install disk-bench
        
            # user install
            $ pip3 install --user disk-bench
        
        Usage
        =====
        
        ::
        
            $ disk-bench --help
        
            # Default runs fio w/ --loops=3 and --size=1G
            $ disk-bench /mnt/disk-to-test/whatever
        
            # Show CSV output (for easy copy/paste into Excel or Google Sheets)
            $ disk-bench /mnt/disk-to-test/whatever --style=csv
        
            # Quick
            $ disk-bench /mnt/disk-to-test/whatever --loops=1 --size=1M
        
        
        Command Details
        ===============
        
        The `fio` command we are running is essentially:
        
            fio --directory . --filename=disk~bench.tmp --output-format=json --stonewall \
            --ioengine=libaio --direct=0 --gtod_reduce=1 \
            --name=seqread --bs=1m --rw=read --size=64G \
            --name=seqwrite --bs=1m --rw=write --size=64G \
            --name=randread --bs=512k --rw=randread --size=4G \
            --name=randwrite --bs=512k --rw=randwrite --size=4G \
            --name=4kQD32read --bs=4k --iodepth=32 --rw=randread --size=4G \
            --name=4kQD32write --bs=4k --iodepth=32 --rw=randwrite --size=4G \
            --name=4kQD16 --bs=4k --iodepth=32 --rw=randrw --rwmixread=65 --size=4G
        
        
        Changelog
        =========
        
        0.2.1 released 2018-12-22
        -------------------------
        
        - add fio command example to readme (d4f6bef_)
        - add direct flag back (578f509_)
        
        .. _d4f6bef: https://github.com/rsyring/disk-bench/commit/d4f6bef
        .. _578f509: https://github.com/rsyring/disk-bench/commit/578f509
        
        
        0.2.0 released 2018-12-21
        -------------------------
        
        - change tests we run and output format (df6ac7b_)
        
        .. _df6ac7b: https://github.com/rsyring/disk-bench/commit/df6ac7b
        
        
        0.1.4 released 2018-12-21
        -------------------------
        
        - fix cli direct flag (74aa304_)
        
        .. _74aa304: https://github.com/rsyring/disk-bench/commit/74aa304
        
        
        0.1.3 released 2018-12-21
        -------------------------
        
        - support non-direct IO (f5ba899_)
        
        .. _f5ba899: https://github.com/rsyring/disk-bench/commit/f5ba899
        
        
        0.1.2 released 2018-12-20
        -------------------------
        
        - fix some packaging issues (f908a1d_)
        
        .. _f908a1d: https://github.com/rsyring/disk-bench/commit/f908a1d
        
        
        0.1.1 released 2018-12-20
        -------------------------
        
        - fix pypi name (10d6115_)
        
        .. _10d6115: https://github.com/rsyring/disk-bench/commit/10d6115
        
        0.1.0 released 2018-12-20
        -------------------------
        
        - add tox & CI (12cfca5_)
        - fix json bytes/text for Python 3.5 (475e3ee_)
        - add tox improve package (ee8efc4_)
        
        .. _12cfca5: https://github.com/rsyring/disk-bench/commit/12cfca5
        .. _475e3ee: https://github.com/rsyring/disk-bench/commit/475e3ee
        .. _ee8efc4: https://github.com/rsyring/disk-bench/commit/ee8efc4
        
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
