pearsend

PearSend

A simple CLI client for peer-to-peer file or message sending. Written in Python.

Features

It supports file or message of size upto about 8.85 PeB (1 PiB ~ 10^6 GiB)!.
Protection against transmission error using CRC32 checksum.
Comes with CLI (command-line argument) and Interactive mode, both!

Installation

Install it using pip

pip install pearsend

Usage Examples

Command-line Mode

Help Text

sumit@HAL9000:~/Documents/PearSend$ python3 pearsend.py -h
usage: pearsend.py [-h] [-i] [-f FILEPATH] [--host HOST] [-p PORT]
                   [-m MESSAGE]
                   {send,receive}

positional arguments:
  {send,receive}        Whether to send or receive

optional arguments:
  -h, --help            show this help message and exit
  -i, --interactive     If the program is to be run in interactive mode
  -f FILEPATH, --filepath FILEPATH
                        Path of the file to be sent or to save incoming data
                        to
  --host HOST           Address of the source or target machine
  -p PORT, --port PORT  Port for listening on or sending to
  -m MESSAGE, --message MESSAGE
                        Message to send

Sending text message

Receiver

sumit@HAL9000:~/Documents/PearSend$ python3 pearsend.py receive -p 5000
[*] Listening for connections on: 10.194.52.135:5000

[*] Connection from : 10.194.52.135:47804
[*] The incoming data is >
b'Hello HAL!'

Sender

sumit@HAL9000:~/Documents/PearSend$ python3 pearsend.py send --host 10.194.52.135 -m "Hello HAL!"

[*] Sent message succesfully!

Sending binary file

Receiver

sumit@HAL9000:~/Documents/PearSend$ python3 pearsend.py receive -p 5000 -f recd.png
[*] Listening for connections on: 10.194.52.135:5000

[*] Connection from : 10.194.52.135:47808
[*] Incoming data saved to recd.png

Sender

sumit@HAL9000:~/Documents/PearSend$ python3 pearsend.py send --host 10.194.52.135 -f image.png

[*] Sent message succesfully!

Interactive Mode

Sending text message

Receiver

sumit@HAL9000:~/Documents/PearSend$ python3 pearsend.py receive -i
[?] Port to listen on:
[?] File to save the incoming data to. Leave blank to output to terminal:
[*] Listening for connections on: 10.194.52.135:5000

[*] Connection from : 10.194.52.135:36240
[*] The incoming data is >
b'Hello HAL!'

Sender

sumit@HAL9000:~/Documents/PearSend$ python3 pearsend.py send -i
[?] The address of the target machine: 10.194.52.135
[?] Enter the port to connect to:
[?] The file to send. Leave blank for text message:
[?] Enter the message: Hello HAL!

[*] Sent message succesfully!

Sending binary file

Receiver

sumit@HAL9000:~/Documents/PearSend$ python3 pearsend.py receive -i
[?] Port to listen on:
[?] File to save the incoming data to. Leave blank to output to terminal: recd.jpg
[*] Listening for connections on: 10.194.52.135:5000

[*] Connection from : 10.194.52.135:36242
[*] Incoming data saved to recd.jpg

Sender

sumit@HAL9000:~/Documents/PearSend$ python3 pearsend.py send -i
[?] The address of the target machine: 10.194.52.135
[?] Enter the port to connect to:
[?] The file to send. Leave blank for text message: image.jpg

[*] Sent message succesfully!

Release files for pearsend 0.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pearsend 0.0.3
File	Size	Uploaded
pearsend-0.0.3.tar.gz	5.8 kB	Dec 11, 2017	Details

Built distribution (wheel)

Table of built distributions (wheels) for pearsend 0.0.3
File	Interpreter	ABI	Platform	Reset
pearsend-0.0.3-py2.py3-none-any.whl 6.2 kB Dec 11, 2017	Python 2, Python 3	none	any	Details

Total release size: 12.0 kB

Release files / pearsend-0.0.3.tar.gz

Download URL	pearsend-0.0.3.tar.gz
Size	5.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`3d1db57735ce6cd3ab84a2f70987960ed076bc511d08288b15ba39d71513aac1`
BLAKE2b-256 checksum How to use checksums	`32fb497cd6c2bf52516ac2d9afe18e5db6d8dd5b6c32323661321bc6b9f2eda8`
Upload date	Dec 11, 2017
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / pearsend-0.0.3-py2.py3-none-any.whl

Download URL	pearsend-0.0.3-py2.py3-none-any.whl
Size	6.2 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`7838a4af367e59f3b0e62583f7eefb4cf14c79e1d659acd6b929364d7260477d`
BLAKE2b-256 checksum How to use checksums	`f375295a456048544d74093834d03b3ec041ff0ccbc2b30fbfa0d2cf6e517f03`
Upload date	Dec 11, 2017
Uploaded using Trusted Publishing? What is trusted publishing?	No