Metadata-Version: 2.1
Name: syncstream
Version: 0.3.0
Summary: A python tool for synchronize the messages from different threads, processes or hosts.
Home-page: https://github.com/cainmagi/sync-stream
Author: Yuchen Jin
Author-email: cainmagi@gmail.com
License: MIT
Project-URL: Bug Tracker, https://github.com/cainmagi/sync-stream/issues
Description: # Sync-stream
        
        This project is designed for providing the synchoronization of the stdout / stderr among different threads, processes, devices or hosts. The package could be used for the following cases:
        
        1. Use `syncstream.LineBuffer`: Multiple threads are created. The messages (stdout) from different threads are required to be collected.
        2. Use `syncstream.LineProcBuffer` in the main process, and `syncstream.LineProcMirror` in the sub-processes: Multiple sub-processes are created on the same device. The stdout / stderr of each process is redirected to a `LineProcMirror`, and the results are collected by `LineProcBuffer`.
        3. Use `syncstream.LineFileBuffer`: Multiple processes are created. These processes may be deployed on different devices (even with different platforms), but all devices could get accessed to the same shared disk. In this case, the message could be shared by locked files. Each process would hold an independent `LineFileBuffer` pointing to the same log files.
        4. Use `syncstream.LineHostBuffer` on the server side, and `syncstream.LineHostMirror` on the client side: Multiple processes are deployed on different devices, and they could not share the same disk. In this case, the message are synchronized by the web service. Each process would hold a `LineHostMirror`, and the results would be collected by `LineHostBuffer`.
        
        The basic package would not contain the `file` and `host` modules. To install the package, please use the following options:
        
        ```bash
        pip install syncstream[option1,option2...]
        ```
        
        | Option  | Supports |
        | :-----: | :------- |
        | `file` | Install dependencies for the `file` module. The module provides `syncstream.LineFileBuffer`. |
        | `host` | Install dependencies for the `host` module. The module provides `syncstream.LineHostBuffer`, and `syncstream.LineHostMirror`. |
        
        ## Documentation
        
        To be built...
        
        ## Update reports
        
        ### 0.3.0 @ 6/4/2021
        
        1. Support the stop signal for `mproc` and `host` modules.
        2. Fix some bugs in the testing script.
        3. Fix typos.
        
        ### 0.2.2 @ 5/25/2021
        
        1. Add `clear()` methods for all buffers and mirrors.
        2. Fix typos in the package setup and info file.
        3. Fix a bug caused by writing data to the host in the testing scripts for Linux.
        
        ### 0.2.1 @ 5/24/2021
        
        1. Add the PyPI publish workflow.
        
        ### 0.2.0 @ 5/24/2021
        
        1. Finish the synchronization based on the file lock package `fasteners`.
        2. Finish the synchronization based on the web service packages `flask`, `flask-restful` and `urllib3`.
        3. Fix the compatibility of the testing scripts for `py36`, `py37`.
        
        ### 0.1.0 @ 5/22/2021
        
        1. Finish the synchronization based on the stdlib.
        2. Create this project.
        
Keywords: stdout,stdout-redirection,multiprocessing,synchronization,stream,python,python3,python-library
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: file
Provides-Extra: host
