Metadata-Version: 1.1
Name: bitrot
Version: 0.9.0
Summary: Detects bit rotten files on the hard drive to save your precious photo and music collection from slow decay.
Home-page: https://github.com/ambv/bitrot/
Author: Łukasz Langa
Author-email: lukasz@langa.pl
License: MIT
Description: ======
        bitrot
        ======
        
        Detects bit rotten files on the hard drive to save your precious photo
        and music collection from slow decay.
        
        Usage
        -----
        
        Go to the desired directory and simply invoke::
        
          $ bitrot
        
        This will start digging through your directory structure recursively
        indexing all files found. The index is stored in a ``.bitrot.db`` file
        which is a SQLite 3 database.
        
        Next time you run ``bitrot`` it will add new files and update the index
        for files with a changed modification date. Most importantly however, it
        will report all errors, e.g. files that changed on the hard drive but
        still have the same modification date.
        
        All paths stored in ``.bitrot.db`` are relative so it's safe to rescan
        a folder after moving it to another drive.
        
        Performance
        -----------
        
        Obviously depends on how fast the underlying drive is. No rigorous
        performance tests have been done. For informational purposes, a typical
        5400 RPM laptop hard drive scanning a 60+ GB music library takes around
        15 minutes. On an OCZ Vertex 3 SSD drive ``bitrot`` is able to scan
        a 100 GB Aperture library in under 10 minutes. Both tests on HFS+.
        
        Change Log
        ----------
        
        0.9.0
        ~~~~~
        
        * bugfix: bitrot.db checksum checking messages now obey --quiet
        
        * Python 3 compatibility
        
        0.8.0
        ~~~~~
        
        * bitrot now keeps track of its own database's bitrot by storing
          a checksum of .bitrot.db in .bitrot.sha512
        
        * bugfix: now properly uses the filesystem encoding to decode file names
          for use with the .bitrotdb database. Report and original patch by
          pallinger.
        
        0.7.1
        ~~~~~
        
        * bugfix: SHA1 computation now works correctly on Windows; previously
          opened files in text-mode. This fix will change hashes of files
          containing some specific bytes like 0x1A.
        
        0.7.0
        ~~~~~
        
        * when a file changes or is renamed, the timestamp of the last check is
          updated, too
        
        * bugfix: files that disappeared during the run are now properly ignored
        
        * bugfix: files that are locked or with otherwise denied access are
          skipped. If they were read before, they will be considered "missing"
          in the report.
        
        * bugfix: if there are multiple files with the same content in the
          scanned directory tree, renames are now handled properly for them
        
        * refactored some horrible code to be a little less horrible
        
        0.6.0
        ~~~~~
        
        * more control over performance with ``--commit-interval`` and
          ``--chunk-size`` command-line arguments
        
        * bugfix: symbolic links are now properly skipped (or can be followed if
          ``--follow-links`` is passed)
        
        * bugfix: files that cannot be opened are now gracefully skipped
        
        * bugfix: fixed a rare division by zero when run in an empty directory
        
        0.5.1
        ~~~~~
        
        * bugfix: warn about test mode only in test mode
        
        0.5.0
        ~~~~~
        
        * ``--test`` command-line argument for testing the state without
          updating the database on disk (works for testing databases you don't
          have write access to)
        
        * size of the data read is reported upon finish
        
        * minor performance updates
        
        0.4.0
        ~~~~~
        
        * renames are now reported as such
        
        * all non-regular files (e.g. symbolic links, pipes, sockets) are now
          skipped
        
        * progress presented in percentage
        
        0.3.0
        ~~~~~
        
        * ``--sum`` command-line argument for easy comparison of multiple
          databases
        
        0.2.1
        ~~~~~
        
        * fixed regression from 0.2.0 where new files caused a ``KeyError``
          exception
        
        0.2.0
        ~~~~~
        
        * ``--verbose`` and ``--quiet`` command-line arguments
        
        * if a file is no longer there, its entry is removed from the database
        
        0.1.0
        ~~~~~
        
        * First published version.
        
        Authors
        -------
        
        Glued together by `Łukasz Langa <mailto:lukasz@langa.pl>`_. Multiple
        improvements by `Yang Zhang <mailto:yaaang@gmail.com>`_, `Jean-Louis
        Fuchs <mailto:ganwell@fangorn.ch>`_ and `Phil Lundrigan <mailto:philipbl@cs.utah.edu>`_.
        
Keywords: file checksum database
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python
Classifier: Topic :: System :: Filesystems
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: Software Development :: Libraries :: Python Modules
