knight-bus
Knight bus can safely and losslessly transport your python objects from one computer to another.
Usage
- To hail the bus, you need to install it first:
pip install knight-bus
- Then you need to get a pair of RSA-keys(Skip this step if you already have your keys):
from loopyCryptor import generate_RSA_key pub_key, pri_key = generate_RSA_key() # Then you can either print it and copy to your code or # save the key as a file ...
- Launch the Receiver
from knight_bus.Receiver import Receiver key = b"-----BEGIN RSA PRIVATE KEY-----\n ......" receiver = Receiver(key) obj = receiver.recv() # This step blocks until an object is received.
- Use Sender to send object
from knight_bus.Sender import Sender key = b"-----BEGIN PUBLIC KEY-----\n ......" sender = Sender(key, ip="....", port=...) sender.send([1,2,"3",{"4":"four"}])
- The object has been transported to
obj
by knight-bus!!!
How does it work?
- Note: As a muggle user, there is no need to worry about how the knight-bus deforms and works.
- The knight-bus is based on lots of magic technology, such as
pickle
,pycryptodome
,socket
andloopyCrypto
The following is the workflow of the knightBus (when using default parameters). You can also call some setting functions and adjust some parameters to customize your workflow.
- Once
Reciever
is instantiation, it create a listen socket, bind the address and waiting for connection. - Once
Sender
is instantiation, it create a socket to receiver. Later whenSender.send
is called, it will calculate the md5 & size of the transfer object, encrypt the result along with a salt and a magic code with the given RSA public key, finally send cipher text to the receiver. - When
Reciever
get the cipher text, it use the given RSA private key decrypt the text and check the magic code. If matched, it will calculate md5 of a list which contains the salt, size and md5(object). Then sign the result along with the magic code, finally send the signature back. - Then
Sender
verify the signature and then start to transport the encrypt object. -
Reciever
get the encrypt object and check its md5 and size(make sure it is what you want), decrypt it to the object if md5 and size matched. - Finally, you will get a deep copy of the origin object in another machine.
Why do I need it?
We already have so many muggle ways to transport data, like json
. However, I am tired of thinking about data types and care less about efficiency. I always like to make or use magic(black box) to solve problems. Just throw the raw material in, then wait for magic, poof!