Metadata-Version: 2.1
Name: dist_exe
Version: 0.0.4
Summary: Distributed execution utility.
Home-page: https://github.com/glentner/dist_exe
Author: Geoffrey Lentner
Author-email: <glentner@purdue.edu>
License: Apache License 2.0
Description: Distributed Executor
        ====================
        
        [![GitHub License](http://img.shields.io/badge/license-Apache-blue.svg?style=flat)](https://www.apache.org/licenses/LICENSE-2.0)
        [![Python Version](http://img.shields.io/badge/python-3.7-orange.svg?style=flat)](https://docs.python.org/3.7)
        
        A cross-platform reference implementation for processing shell commands over
        a distributed, asynchronous queue. `dist_exe` is a single producer
        (server) many consumer (client) system. It functions similar to *GNU Parallel*
        but scales out to many servers and even across operating systems.
        
        This tool uses only standard library methods so there are no dependencies.
        It has been tested on Linux, macOS, and Windows 10 in Python 3.7 environments.
        The server and clients don't even need to be using the same platform.
        
        
        Installation
        ------------
        
        ```
        pip install dist_exe [--upgrade] [--user]
        ```
        
        
        Usage
        -----
        
        The _server_ role reads from standard input and publishes to a queue. If you don't 
        have something actively creating work a good approach is to create a _MANIFEST_ file
        and use `tail -f` to wait for work to arrive.
        
        ```
        user@host-01: ~ $ touch MANIFEST
        user@host-01: ~ $ tail -f MANIFEST | dist_exe server -H 0.0.0.0 -p 5050 -k SECRET
        ```
        
        The _client_ role connects to the remote queue and pulls items off, executing them using the local shell.
        You can specify a template for the command line invocation, otherwise the items are take as being the entire
        invocation.
        
        ```
        user@host-02: ~ $ dist_exe client -H host-01 -p 5050 -k SECRET -t 'echo {}'
        ```
Keywords: distributed asynchronous queue
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: Apache Software License
Description-Content-Type: text/markdown
