get things from one computer to another, safely
Go to file
Brian Warner 443d248972 manager: call inbound.set_listener_endpoint() before start()
This should fix the immediate issue of the remote side opening a
subchannel (and sending data on it) before the local side even sees the
Endpoints, so before it can register a listening factory to receive the OPEN.

We were already buffering early OPENs in the SubchannelListenerEndpoint, but
this makes sure that endpoint is available (for the manager's Inbound half to
deliver) them as soon as the dilation connection is established.

The downside to buffering OPENs (and all data written to inbound subchannels)
is that the application has no way to reject or pause them, until it
registers the listening factory. If the application never calls
`listen_ep.listen()`, we'll buffer this data forever (or until the wormhole
is closed). The upside is that we don't lose a roundtrip waiting for an ack
on the OPEN. See ticket #335 for more details.

refs #335
2019-07-08 01:12:39 -07:00
docs docs: add dilation state machines diagram 2019-07-05 15:56:13 -07:00
misc remove server-related source files, munin plugins 2018-02-20 23:46:29 -08:00
pyi use pyinstaller to build wormhole fat/standalone binary 2018-06-02 18:05:45 +02:00
src/wormhole manager: call inbound.set_listener_endpoint() before start() 2019-07-08 01:12:39 -07:00
.appveyor.yml appveyor: set TOXENV separately for each python version 2019-05-05 19:22:06 -04:00
.coveragerc add 'coverage' environment for tox 2016-05-24 16:03:39 -07:00
.gitattributes initial setup.py, versioneer-ification 2015-02-10 00:48:19 -08:00
.gitignore use pyinstaller to build wormhole fat/standalone binary 2018-06-02 18:05:45 +02:00
.travis.yml README: drop python3.4 support 2019-07-05 15:50:00 -07:00
LICENSE Initial commit 2015-02-10 00:38:44 -08:00
MANIFEST.in MANIFEST.in: add some missing files 2018-10-16 16:29:24 -07:00
NEWS.md NEWS: update for 0.11.2 release 2018-11-13 15:08:53 -08:00
README.md README: drop python3.4 support 2019-07-05 15:50:00 -07:00
setup.cfg setup.cfg: bump flake8 max-line-length to 85 2018-12-23 15:22:57 -05:00
setup.py setup.py: hush deprecation warning 2019-02-10 11:18:48 -08:00
snapcraft.yaml Merge PR237 2017-07-31 12:29:21 -07:00
tox.ini add 'tox -e docs', travis job to exercise it 2019-05-05 18:02:00 -04:00
versioneer.py Correct spelling mistakes 2018-11-23 07:38:21 +00:00

Magic Wormhole

PyPI Build Status Windows Build Status codecov.io Docs

Get things from one computer to another, safely.

This package provides a library and a command-line tool named wormhole, which makes it possible to get arbitrary-sized files and directories (or short pieces of text) from one computer to another. The two endpoints are identified by using identical "wormhole codes": in general, the sending machine generates and displays the code, which must then be typed into the receiving machine.

The codes are short and human-pronounceable, using a phonetically-distinct wordlist. The receiving side offers tab-completion on the codewords, so usually only a few characters must be typed. Wormhole codes are single-use and do not need to be memorized.

For complete documentation, please see https://magic-wormhole.readthedocs.io or the docs/ subdirectory.

License, Compatibility

This library is released under the MIT license, see LICENSE for details.

This library is compatible with python2.7, 3.5, 3.6, and 3.7.