Metadata-Version: 2.1
Name: aiowatcher
Version: 0.0.5
Summary: Asynchronous library to watch files in real time.
Home-page: https://github.com/py-paulo/aiowatcher.git
Author: Paulo Roberto <paulo.rb.beserra@gmail.com>
Author-email: paulo.rb.beserra@gmail.com
License: Apache 2
Project-URL: GitHub: issues, https://github.com/py-paulo/aiowatcher/issues
Project-URL: GitHub: repo, https://github.com/py-paulo/aiowatcher
Description: ---
        
        <p align="center"><a href="https://img.shields.io/pypi/v/aiowatcher" target="_blank" rel="noopener noreferrer">
            <img width="256px" height="126px" src="https://i.pinimg.com/originals/1b/2a/2a/1b2a2a3a94cae52f318e1893303a0834.png" alt="AIOWatcher logo"></a>
        </p>
        
        <p align="center">
            <img alt="GitHub code size in bytes" src="https://img.shields.io/github/languages/code-size/py-paulo/aiowatcher">
            <img alt="PyPI" src="https://img.shields.io/pypi/v/aiowatcher">
            <img alt="PyPI - Wheel" src="https://img.shields.io/pypi/wheel/aiowatcher">
            <img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/py-paulo/aiowatcher">
            <br>
            <img alt="GitHub" src="https://img.shields.io/github/license/py-paulo/aiowatcher">
        </p>
        
        ---
        
        Library to "watch" files in a directory and call a
        callback function `(filename, lines)` every time one of the monitored files is recorded, in real time.
        
        In practical terms, this can be compared to UNIX's `tail -F * .log` command,
        but instead of having lines printed in stdout, a Python function is called.
        
        Like tail, it is in charge of "watching" new files that are
        created after startup and "unlock" those that are removed in the meantime.
        This means that you will be able to "follow" and support rotating log files as well.
        
        ## Key Features
        
        - Uses Asyncio for asynchronous reading and monitoring.
        - The implementation chooses automatically depending on the compatibility of the system.
        - Monitoring of several files in the same directory or just one.
        - Asynchronous callback function.
        
        ### Getting started
        
        All code samples require Python 3.6+.
        
        #### Basic Usage
        
        ```
        import asyncio
        from aiowatcher import AIOWatcher
        
        async def callback(filename, line):
            print(line)
        
        async def main():
            lw = AIOWatcher('var', callback, extensions=['txt'])
            await lw.init()
            await lw.loop()
        
        loop = asyncio.get_event_loop()
        loop.run_until_complete(main())    
        ```
        
        #### Non blocking
        
        ```
        import asyncio
        from aiowatcher import AIOWatcher
        
        async def callback(filename, line):
            print(line)
        
        async def main():
            lw = AIOWatcher('var', callback, extensions=['txt'])
            while True:
                await lw.loop(blocking=False)
                await asyncio.sleep(0.1)
        
        loop = asyncio.get_event_loop()
        loop.run_until_complete(main())
        ```
        
        #### Tail
        
        ```
        import asyncio
        from aiowatcher import AIOWatcher
        
        async def callback(filename, lines):
            for line in lines:
                print(line[:-1])
        
        async def main():
            lw = AIOWatcher('var', callback, extensions=['txt'])
            await lw.tail(3)
        
        loop = asyncio.get_event_loop()
        loop.run_until_complete(main())
        ```
        
        ### License
        
        ``aiowatcher`` is offered under the Apache 2 license.
        
        
        ### Source code
        
        The latest version of the developer is available on a GitHub repository:
        https://github.com/py-paulo/aiowatcher.git
        
        # Changelog
        
        ## 0.0.5 (22-09-2020)
        
        ### Features
        
        * new `AIOWatcher().tail` function to read  **N** lines from a file and return as list.
        
        ### Bugfixes
        
        * `AIOWatcher.readlines()` returns a list instead of a string.
Keywords: aio,python,asyncio,fileio,io
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Operating System :: POSIX
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Framework :: AsyncIO
Provides: aiowatcher
Requires-Python: >=3.6
Description-Content-Type: text/markdown
