Metadata-Version: 2.1
Name: tox-server
Version: 0.2
Summary: A mini tox server for calling tox in a loop
Home-page: https://github.com/alexrudy/tox-server
Author: Alex Rudy
Author-email: alex.rudy@gmail.com
License: UNKNOWN
Description: # Tox Server
        
        ![Tests](https://github.com/alexrudy/tox-server/workflows/Tox%20Server%20Tests/badge.svg)
        
        `tox-server` is a command line tool which runs [tox](https://tox.readthedocs.io/en/latest/) in a loop
        and calls it with commands from a remote CLI. It responds to commands
        via [ZeroMQ](https://zeromq.org). It isn't super useful on its own (as it doesn't eliminate the startup time for tox, just runs it repeatedly) but it is
        helpful if your tests have to be run inside another environment with some setup cost, such as a docker container.
        
        ## Installation
        
        You can use `pip` to install `tox-server`:
        
        ```
        $ pip install git+https://github.com/alexrudy/tox-server.git@master
        ```
        
        (It will be published on pypi soon)
        
        ## Run the server
        
        On the remote host:
        
        ```
        $ tox-server serve
        ```
        
        The server binds to `127.0.0.1` (i.e. it will only accept connections from localhost) because it is
        not secured. If you are running it on an isolated network (like via docker), you can bind it to another host
        with `tox-server  -b 0.0.0.0 serve`.
        
        ## Run a tox command remotely
        
        On your local host, you can run a tox command:
        
        ```
        $ tox-server run -e py37
        ```
        
        This will run `tox -e py37` on the remote host.
        
        ## A note on security
        
        Basically, security is hard. This program doesn't provide any authentication mechanism, and I'm not tempted
        to add one. Before you expose ports from `tox-server` to the world wide web, I'd advise using something like
        SSH tunneling to provide security and authentication.
        
Keywords: utilties tox testing
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Utilities
Requires-Python: >=3.7, <4
Description-Content-Type: text/markdown
