# P2PD
``[Python >= 3.5] [Mac, Win, Nix, BSD, Android]``
[![Demo image](https://github.com/robertsdotpm/p2pd/blob/main/demo_small.gif?raw=true)](https://github.com/robertsdotpm/p2pd/blob/main/demo_large.gif)
[Watch demo on Asciinema](https://asciinema.org/a/EhADOwnoPt5KBiQDbwR69bNHS)
Welcome to the new release of **P2PD.** P2PD is a library for doing
peer-to-peer networking in Python. This release offers a new methodology
for improving connectivity between hosts. It works on private networks, across
the Internet, and even in-between nodes on the same machine.
Tens of thousands of lines of code have been updated. Most modules have been refactored or re-written. The protocol has been replaced and now supports encryption; TCP punching now works with IPv6; The STUN client supports hundreds more servers; UPnP is less noisy (and actually works); Networking code has been refreshed to reduce errors; Core connectivity methods have been redesigned (and tested quite thoroughly.)
The new release also includes a simple domain system that offers open,
authenticated, registration-free, domain names. The feature is free
to use (though some resource limits apply.)
## Installation
On non-windows systems make sure you have gcc and python3-devel installed.
python3 -m pip install p2pd
## Demo
For an interactive demo type this in your terminal.
python3 -m p2pd.demo
## Documentation
https://p2pd.readthedocs.io/
## Features
**P2PD** is a new project aiming to make peer-to-peer networking
simple and ubiquitous. P2PD can be used either as a library or as a service.
As a library P2PD is written in Python 3 using asyncio for everything.
As a service P2PD provides a REST API on http://127.0.0.1:12333/.
The REST API is provided for non-Python languages.
P2PD offers engineers the following features:
- Multiple strategies for establishing peer-to-peer direct connections.
- **Direct connect** = Connect to a reachable node.
- **Reverse connect** = Tell a node to connect to you.
- **TCP hole punching** = Simultaneous TCP connections.
- **TURN** = Use a proxy server as a last resort.
- **Advanced NAT detection.** P2PD can detect 7 different types of NATs and
5 different sub-types for a combined total of **35 unique NAT
configurations.** The result is better NAT bypass.
- **Smart TCP hole punching.** The TCP hole punching algorithm has been
designed to require minimal communication between peers to increase
the chances of success. The algorithm supports a diverse number of
NAT configurations for the best results possible.
- **Port forwarding (IPv4) and pin hole (IPv6.)** Automatically
handles opening ports on the router to increase reachability.
- **Multi-interface.** Focuses on NICs as the starting point
for building services. Introduces 'routes' as a
way to provide visibility into external addresses. You can build
services that support IPv4, IPv6, TCP, and UDP without writing
different code for each of them.
- **Minimal dependencies.** Most of the code in P2PD uses the Python
standard library to improve portability and reduce packaging issues.
- **Built on open protocols.**
**STUN** for address lookups, **MQTT** for signaling messages, and
**TURN** for last resort message relaying.
All of these protocols have public infrastructure.
Raw data
{
"_id": null,
"home_page": "http://github.com/robertsdotpm/p2pd",
"name": "p2pd",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "NAT traversal, TCP hole punching, simultaneous open, UPnP, STUN, TURN, SIP, DHCP, add IP to interface, NATPMP, P2P, Peer-to-peer networking library, python",
"author": "Matthew Roberts",
"author_email": "matthew@roberts.pm",
"download_url": "https://files.pythonhosted.org/packages/7d/52/92399e0080453c0ef3dd15f4d3ad7070002f3177f9286ae8cf2bb05b87d2/p2pd-3.0.3.tar.gz",
"platform": null,
"description": "# P2PD\n\n``[Python >= 3.5] [Mac, Win, Nix, BSD, Android]``\n\n[![Demo image](https://github.com/robertsdotpm/p2pd/blob/main/demo_small.gif?raw=true)](https://github.com/robertsdotpm/p2pd/blob/main/demo_large.gif)\n\n[Watch demo on Asciinema](https://asciinema.org/a/EhADOwnoPt5KBiQDbwR69bNHS)\n\nWelcome to the new release of **P2PD.** P2PD is a library for doing\npeer-to-peer networking in Python. This release offers a new methodology\nfor improving connectivity between hosts. It works on private networks, across\nthe Internet, and even in-between nodes on the same machine.\n\nTens of thousands of lines of code have been updated. Most modules have been refactored or re-written. The protocol has been replaced and now supports encryption; TCP punching now works with IPv6; The STUN client supports hundreds more servers; UPnP is less noisy (and actually works); Networking code has been refreshed to reduce errors; Core connectivity methods have been redesigned (and tested quite thoroughly.)\n\nThe new release also includes a simple domain system that offers open,\nauthenticated, registration-free, domain names. The feature is free\nto use (though some resource limits apply.)\n\n## Installation\n\nOn non-windows systems make sure you have gcc and python3-devel installed.\n\n python3 -m pip install p2pd\n\n## Demo\n\nFor an interactive demo type this in your terminal.\n\n python3 -m p2pd.demo\n\n## Documentation\n\nhttps://p2pd.readthedocs.io/\n\n## Features\n\n**P2PD** is a new project aiming to make peer-to-peer networking\nsimple and ubiquitous. P2PD can be used either as a library or as a service.\nAs a library P2PD is written in Python 3 using asyncio for everything.\nAs a service P2PD provides a REST API on http://127.0.0.1:12333/.\nThe REST API is provided for non-Python languages.\n\nP2PD offers engineers the following features:\n\n- Multiple strategies for establishing peer-to-peer direct connections.\n\n - **Direct connect** = Connect to a reachable node.\n - **Reverse connect** = Tell a node to connect to you.\n - **TCP hole punching** = Simultaneous TCP connections.\n - **TURN** = Use a proxy server as a last resort.\n- **Advanced NAT detection.** P2PD can detect 7 different types of NATs and\n 5 different sub-types for a combined total of **35 unique NAT\n configurations.** The result is better NAT bypass.\n- **Smart TCP hole punching.** The TCP hole punching algorithm has been\n designed to require minimal communication between peers to increase\n the chances of success. The algorithm supports a diverse number of\n NAT configurations for the best results possible.\n- **Port forwarding (IPv4) and pin hole (IPv6.)** Automatically\n handles opening ports on the router to increase reachability.\n- **Multi-interface.** Focuses on NICs as the starting point\n for building services. Introduces 'routes' as a\n way to provide visibility into external addresses. You can build\n services that support IPv4, IPv6, TCP, and UDP without writing\n different code for each of them.\n- **Minimal dependencies.** Most of the code in P2PD uses the Python\n standard library to improve portability and reduce packaging issues.\n- **Built on open protocols.**\n **STUN** for address lookups, **MQTT** for signaling messages, and\n **TURN** for last resort message relaying.\n All of these protocols have public infrastructure.\n",
"bugtrack_url": null,
"license": "public domain",
"summary": "Asynchronous P2P networking library and service",
"version": "3.0.3",
"project_urls": {
"Homepage": "http://github.com/robertsdotpm/p2pd"
},
"split_keywords": [
"nat traversal",
" tcp hole punching",
" simultaneous open",
" upnp",
" stun",
" turn",
" sip",
" dhcp",
" add ip to interface",
" natpmp",
" p2p",
" peer-to-peer networking library",
" python"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7d5292399e0080453c0ef3dd15f4d3ad7070002f3177f9286ae8cf2bb05b87d2",
"md5": "1505093edc4b6a053cc1c4d4039e7d24",
"sha256": "fdb2977f649fd2eabb89025a3cc2e289c2faa8eb777334bdc79734ea5050ffa3"
},
"downloads": -1,
"filename": "p2pd-3.0.3.tar.gz",
"has_sig": false,
"md5_digest": "1505093edc4b6a053cc1c4d4039e7d24",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 809748,
"upload_time": "2024-12-11T13:26:05",
"upload_time_iso_8601": "2024-12-11T13:26:05.572960Z",
"url": "https://files.pythonhosted.org/packages/7d/52/92399e0080453c0ef3dd15f4d3ad7070002f3177f9286ae8cf2bb05b87d2/p2pd-3.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-11 13:26:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "robertsdotpm",
"github_project": "p2pd",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"circle": true,
"requirements": [
{
"name": "netifaces",
"specs": [
[
"==",
"0.11.0"
]
]
},
{
"name": "ntplib",
"specs": []
},
{
"name": "xmltodict",
"specs": []
},
{
"name": "ecdsa",
"specs": []
},
{
"name": "pyroute2",
"specs": []
},
{
"name": "winregistry",
"specs": []
},
{
"name": "fasteners",
"specs": []
},
{
"name": "aiodns",
"specs": []
},
{
"name": "aiounittest",
"specs": [
[
"==",
"1.4.2"
]
]
}
],
"lcname": "p2pd"
}