Metadata-Version: 2.1
Name: net-file
Version: 1.1.3
Summary: Ranged read file access abstraction.
Home-page: https://gitlab.com/kraevs/net-file
Author: Stanislav Kraev
Author-email: stanislav.kraev@gmail.com
License: MIT
Project-URL: Code, https://gitlab.com/kraevs/net-file
Project-URL: Issue tracker, https://gitlab.com/kraevs/net-file/issues
Description: # Net-file ranged read file access abstraction library
        
        net-file allows you to access files by URL the same way for different types of storage: 
         * local files
         * files served by http(s) servers like Nginx
         * files on SFTP
         * ...
        
        Second major feature of net-file is ranged access. So you can download only part of file
        starting from arbitrary position. 
        
        ## API
        
        ```python
            open_url(
                url: str,                   # File URL. For local file use file:///absolute/file/path
                start_bytes: int = None,    # For ranged access - the beginning of the range
                length: int = None          # For ranged access - range length
            ) -> NetFile
        ```
        
        Opens URL returning `NetFile` object. To read from file use `context manager` or `open()` / `close()`
        methods pair of `NetFile` object:
        
        ```python
            with open_url(
                    url='http://test.domain/example.mp4',
                    start_bytes=10000,
                    length=20000,
            ) as open_file:
                content = open_file.read()
                while content:
                    content = open_file.read()
        ```
        
        ![Speech Technology Center](https://gitlab.com/kraevs/net-file/-/raw/master/img/stc.png)
Platform: any
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.6
Description-Content-Type: text/markdown
