Metadata-Version: 1.1
Name: RSFile
Version: 2.1
Summary: RSFile advanced I/O file streams
Home-page: https://github.com/pakal/rsfile
Author: Pascal Chambon
Author-email: pythoniks@gmail.com
License: http://www.opensource.org/licenses/mit-license.php
Description: RSFILE
        ================
        
        RSFile provides pure-python drop-in replacements for the classes of the **io** module, and for the **open()** builtin.
        
        Its goal is to provide a cross-platform, reliable, and comprehensive synchronous file I/O API, with advanced features like fine-grained opening modes, shared/exclusive file record locking, thread-safety, cache synchronization, file descriptor inheritability, and handy stat getters (size, inode, times...).
        
        .. END OF PART KINDA SHARED WITH SPHINX DOC INDEX ..
        
        Possible use cases for this library: concurrently writing to logs without ending up with garbled data, manipulating sensitive data like disk-based databases, synchronizing heterogeneous producer/consumer processes when multiprocessing semaphores aren't an option...
        
        This version 2 of the lib drops support for Python2.6, and puts RSFile in compliance with the numerous evolutions that happened to the I/O modules of the stdlib, over the past years.
        
        Tested on python2.7 and python3.3+, on windows and unix-like systems. *Should* work with IronPython/Jython/PyPy too, since it uses stdlib utilities and ctypes bridges.
        
        .. image:: https://travis-ci.org/pakal/rsfile.svg?branch=master
            :target: https://travis-ci.org/pakal/rsfile
        
        **Learn more about RSFile : http://rsfile.readthedocs.io/**
        
        
        
        INSTALL
        ------------
        
        Using pip is recommended, although installing from a checkout of the repository (via setup.py) also works:
        
        ::
        
            $ pip install rsfile
        
        
        QUICKSTART
        ------------
        
        ::
        
            from rsfile import rsopen
        
            with rsopen("myfile.txt", "w") as f:
                f.write(u"This string will be veeeeeryyyyy safely written to file.")
        
            with rsopen("myfile.txt", "WANISB", locking=False, thread_safe=False) as f:
                f.write(b"See the docs for info on these cool new modes and parameters.")
        
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Topic :: System :: Filesystems
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS :: MacOS X
