magic-rift 0.1.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (13) hide show
  1. magic_rift-0.1.1/LICENSE +21 -0
  2. magic_rift-0.1.1/PKG-INFO +164 -0
  3. magic_rift-0.1.1/README.md +135 -0
  4. magic_rift-0.1.1/magic_rift.egg-info/PKG-INFO +164 -0
  5. magic_rift-0.1.1/magic_rift.egg-info/SOURCES.txt +11 -0
  6. magic_rift-0.1.1/magic_rift.egg-info/dependency_links.txt +1 -0
  7. magic_rift-0.1.1/magic_rift.egg-info/entry_points.txt +2 -0
  8. magic_rift-0.1.1/magic_rift.egg-info/requires.txt +5 -0
  9. magic_rift-0.1.1/magic_rift.egg-info/top_level.txt +1 -0
  10. magic_rift-0.1.1/pyproject.toml +47 -0
  11. magic_rift-0.1.1/rift.py +1935 -0
  12. magic_rift-0.1.1/setup.cfg +4 -0
  13. magic_rift-0.1.1/wordlist.txt +7776 -0
magic_rift-0.1.1/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Arpit
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
magic_rift-0.1.1/PKG-INFO ADDED
@@ -0,0 +1,164 @@
1
+ Metadata-Version: 2.4
2
+ Name: magic-rift
3
+ Version: 0.1.1
4
+ Summary: Share files like magic - disposable file sharing via your public IP
5
+ Author: Arpit
6
+ License-Expression: MIT
7
+ Keywords: file-sharing,upnp,tunnel,http-server,peer-to-peer
8
+ Classifier: Development Status :: 4 - Beta
9
+ Classifier: Intended Audience :: Developers
10
+ Classifier: Intended Audience :: End Users/Desktop
11
+ Classifier: Operating System :: OS Independent
12
+ Classifier: Programming Language :: Python :: 3
13
+ Classifier: Programming Language :: Python :: 3.8
14
+ Classifier: Programming Language :: Python :: 3.9
15
+ Classifier: Programming Language :: Python :: 3.10
16
+ Classifier: Programming Language :: Python :: 3.11
17
+ Classifier: Programming Language :: Python :: 3.12
18
+ Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
19
+ Classifier: Topic :: System :: Networking
20
+ Classifier: Topic :: Utilities
21
+ Requires-Python: >=3.8
22
+ Description-Content-Type: text/markdown
23
+ License-File: LICENSE
24
+ Provides-Extra: dev
25
+ Requires-Dist: pytest>=7.0; extra == "dev"
26
+ Requires-Dist: mypy>=1.0; extra == "dev"
27
+ Requires-Dist: ruff>=0.1.0; extra == "dev"
28
+ Dynamic: license-file
29
+
30
+ # Rift
31
+
32
+ One-time file sharing from your machine.
33
+
34
+ Rift starts a temporary server, prints a share link, and shuts down after the first successful download.
35
+
36
+ ## Install
37
+
38
+ Python 3.8+ required.
39
+
40
+ ```bash
41
+ uv tool install magic-rift
42
+ ```
43
+
44
+ Or:
45
+
46
+ ```bash
47
+ uvx magic-rift --version
48
+ ```
49
+
50
+ Or with pip:
51
+
52
+ ```bash
53
+ pip install magic-rift
54
+ ```
55
+
56
+ ## Quick Start
57
+
58
+ Share a file:
59
+
60
+ ```bash
61
+ rift share /path/to/file.pdf
62
+ ```
63
+
64
+ Rift prints a disposable link like:
65
+
66
+ ```text
67
+ https://PUBLIC_IP:PORT/4-crystal-salmon
68
+ ```
69
+
70
+ After one successful download, the server exits and the link stops working.
71
+
72
+ Stop manually anytime with `Ctrl+C`.
73
+
74
+ ## Most Useful Commands
75
+
76
+ Share with random port (default):
77
+
78
+ ```bash
79
+ rift share file.zip
80
+ ```
81
+
82
+ Share on a fixed port:
83
+
84
+ ```bash
85
+ rift share file.zip --port 9000
86
+ ```
87
+
88
+ Disable TLS:
89
+
90
+ ```bash
91
+ rift share file.zip --no-ssl
92
+ ```
93
+
94
+ Set default port:
95
+
96
+ ```bash
97
+ rift config set port 9000
98
+ ```
99
+
100
+ View config:
101
+
102
+ ```bash
103
+ rift config list
104
+ ```
105
+
106
+ Reset config:
107
+
108
+ ```bash
109
+ rift config reset
110
+ ```
111
+
112
+ ## How Connectivity Works
113
+
114
+ Rift tries methods in this order:
115
+
116
+ 1. `cloudflared` (if installed)
117
+ 2. `natpmp`
118
+ 3. `upnp`
119
+ 4. `localhost.run` (SSH tunnel)
120
+
121
+ If automatic forwarding/tunneling fails, Rift still runs locally and tells you to configure routing manually.
122
+
123
+ ## Security Notes
124
+
125
+ - Links are one-time and include a random secret path.
126
+ - Files are served directly from your machine.
127
+ - HTTPS may use a self-signed cert by default, which can show browser warnings.
128
+ - If cert setup is unavailable, Rift can fall back to HTTP.
129
+ - No built-in authentication. Encrypt sensitive files before sharing.
130
+
131
+ ## Troubleshooting
132
+
133
+ Public IP detection failed:
134
+
135
+ - Check your public IP manually.
136
+ - Retry with a fixed method, for example:
137
+
138
+ ```bash
139
+ rift share file.zip --method cloudflared
140
+ ```
141
+
142
+ Port in use:
143
+
144
+ ```bash
145
+ rift share file.zip --port 9001
146
+ ```
147
+
148
+ Permission error:
149
+
150
+ ```bash
151
+ chmod +r file.zip
152
+ ```
153
+
154
+ ## Configuration Path
155
+
156
+ Rift stores config at:
157
+
158
+ ```text
159
+ ~/.config/rift/config.json
160
+ ```
161
+
162
+ ## License
163
+
164
+ MIT
magic_rift-0.1.1/README.md ADDED
@@ -0,0 +1,135 @@
1
+ # Rift
2
+
3
+ One-time file sharing from your machine.
4
+
5
+ Rift starts a temporary server, prints a share link, and shuts down after the first successful download.
6
+
7
+ ## Install
8
+
9
+ Python 3.8+ required.
10
+
11
+ ```bash
12
+ uv tool install magic-rift
13
+ ```
14
+
15
+ Or:
16
+
17
+ ```bash
18
+ uvx magic-rift --version
19
+ ```
20
+
21
+ Or with pip:
22
+
23
+ ```bash
24
+ pip install magic-rift
25
+ ```
26
+
27
+ ## Quick Start
28
+
29
+ Share a file:
30
+
31
+ ```bash
32
+ rift share /path/to/file.pdf
33
+ ```
34
+
35
+ Rift prints a disposable link like:
36
+
37
+ ```text
38
+ https://PUBLIC_IP:PORT/4-crystal-salmon
39
+ ```
40
+
41
+ After one successful download, the server exits and the link stops working.
42
+
43
+ Stop manually anytime with `Ctrl+C`.
44
+
45
+ ## Most Useful Commands
46
+
47
+ Share with random port (default):
48
+
49
+ ```bash
50
+ rift share file.zip
51
+ ```
52
+
53
+ Share on a fixed port:
54
+
55
+ ```bash
56
+ rift share file.zip --port 9000
57
+ ```
58
+
59
+ Disable TLS:
60
+
61
+ ```bash
62
+ rift share file.zip --no-ssl
63
+ ```
64
+
65
+ Set default port:
66
+
67
+ ```bash
68
+ rift config set port 9000
69
+ ```
70
+
71
+ View config:
72
+
73
+ ```bash
74
+ rift config list
75
+ ```
76
+
77
+ Reset config:
78
+
79
+ ```bash
80
+ rift config reset
81
+ ```
82
+
83
+ ## How Connectivity Works
84
+
85
+ Rift tries methods in this order:
86
+
87
+ 1. `cloudflared` (if installed)
88
+ 2. `natpmp`
89
+ 3. `upnp`
90
+ 4. `localhost.run` (SSH tunnel)
91
+
92
+ If automatic forwarding/tunneling fails, Rift still runs locally and tells you to configure routing manually.
93
+
94
+ ## Security Notes
95
+
96
+ - Links are one-time and include a random secret path.
97
+ - Files are served directly from your machine.
98
+ - HTTPS may use a self-signed cert by default, which can show browser warnings.
99
+ - If cert setup is unavailable, Rift can fall back to HTTP.
100
+ - No built-in authentication. Encrypt sensitive files before sharing.
101
+
102
+ ## Troubleshooting
103
+
104
+ Public IP detection failed:
105
+
106
+ - Check your public IP manually.
107
+ - Retry with a fixed method, for example:
108
+
109
+ ```bash
110
+ rift share file.zip --method cloudflared
111
+ ```
112
+
113
+ Port in use:
114
+
115
+ ```bash
116
+ rift share file.zip --port 9001
117
+ ```
118
+
119
+ Permission error:
120
+
121
+ ```bash
122
+ chmod +r file.zip
123
+ ```
124
+
125
+ ## Configuration Path
126
+
127
+ Rift stores config at:
128
+
129
+ ```text
130
+ ~/.config/rift/config.json
131
+ ```
132
+
133
+ ## License
134
+
135
+ MIT
magic_rift-0.1.1/magic_rift.egg-info/PKG-INFO ADDED
@@ -0,0 +1,164 @@
1
+ Metadata-Version: 2.4
2
+ Name: magic-rift
3
+ Version: 0.1.1
4
+ Summary: Share files like magic - disposable file sharing via your public IP
5
+ Author: Arpit
6
+ License-Expression: MIT
7
+ Keywords: file-sharing,upnp,tunnel,http-server,peer-to-peer
8
+ Classifier: Development Status :: 4 - Beta
9
+ Classifier: Intended Audience :: Developers
10
+ Classifier: Intended Audience :: End Users/Desktop
11
+ Classifier: Operating System :: OS Independent
12
+ Classifier: Programming Language :: Python :: 3
13
+ Classifier: Programming Language :: Python :: 3.8
14
+ Classifier: Programming Language :: Python :: 3.9
15
+ Classifier: Programming Language :: Python :: 3.10
16
+ Classifier: Programming Language :: Python :: 3.11
17
+ Classifier: Programming Language :: Python :: 3.12
18
+ Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
19
+ Classifier: Topic :: System :: Networking
20
+ Classifier: Topic :: Utilities
21
+ Requires-Python: >=3.8
22
+ Description-Content-Type: text/markdown
23
+ License-File: LICENSE
24
+ Provides-Extra: dev
25
+ Requires-Dist: pytest>=7.0; extra == "dev"
26
+ Requires-Dist: mypy>=1.0; extra == "dev"
27
+ Requires-Dist: ruff>=0.1.0; extra == "dev"
28
+ Dynamic: license-file
29
+
30
+ # Rift
31
+
32
+ One-time file sharing from your machine.
33
+
34
+ Rift starts a temporary server, prints a share link, and shuts down after the first successful download.
35
+
36
+ ## Install
37
+
38
+ Python 3.8+ required.
39
+
40
+ ```bash
41
+ uv tool install magic-rift
42
+ ```
43
+
44
+ Or:
45
+
46
+ ```bash
47
+ uvx magic-rift --version
48
+ ```
49
+
50
+ Or with pip:
51
+
52
+ ```bash
53
+ pip install magic-rift
54
+ ```
55
+
56
+ ## Quick Start
57
+
58
+ Share a file:
59
+
60
+ ```bash
61
+ rift share /path/to/file.pdf
62
+ ```
63
+
64
+ Rift prints a disposable link like:
65
+
66
+ ```text
67
+ https://PUBLIC_IP:PORT/4-crystal-salmon
68
+ ```
69
+
70
+ After one successful download, the server exits and the link stops working.
71
+
72
+ Stop manually anytime with `Ctrl+C`.
73
+
74
+ ## Most Useful Commands
75
+
76
+ Share with random port (default):
77
+
78
+ ```bash
79
+ rift share file.zip
80
+ ```
81
+
82
+ Share on a fixed port:
83
+
84
+ ```bash
85
+ rift share file.zip --port 9000
86
+ ```
87
+
88
+ Disable TLS:
89
+
90
+ ```bash
91
+ rift share file.zip --no-ssl
92
+ ```
93
+
94
+ Set default port:
95
+
96
+ ```bash
97
+ rift config set port 9000
98
+ ```
99
+
100
+ View config:
101
+
102
+ ```bash
103
+ rift config list
104
+ ```
105
+
106
+ Reset config:
107
+
108
+ ```bash
109
+ rift config reset
110
+ ```
111
+
112
+ ## How Connectivity Works
113
+
114
+ Rift tries methods in this order:
115
+
116
+ 1. `cloudflared` (if installed)
117
+ 2. `natpmp`
118
+ 3. `upnp`
119
+ 4. `localhost.run` (SSH tunnel)
120
+
121
+ If automatic forwarding/tunneling fails, Rift still runs locally and tells you to configure routing manually.
122
+
123
+ ## Security Notes
124
+
125
+ - Links are one-time and include a random secret path.
126
+ - Files are served directly from your machine.
127
+ - HTTPS may use a self-signed cert by default, which can show browser warnings.
128
+ - If cert setup is unavailable, Rift can fall back to HTTP.
129
+ - No built-in authentication. Encrypt sensitive files before sharing.
130
+
131
+ ## Troubleshooting
132
+
133
+ Public IP detection failed:
134
+
135
+ - Check your public IP manually.
136
+ - Retry with a fixed method, for example:
137
+
138
+ ```bash
139
+ rift share file.zip --method cloudflared
140
+ ```
141
+
142
+ Port in use:
143
+
144
+ ```bash
145
+ rift share file.zip --port 9001
146
+ ```
147
+
148
+ Permission error:
149
+
150
+ ```bash
151
+ chmod +r file.zip
152
+ ```
153
+
154
+ ## Configuration Path
155
+
156
+ Rift stores config at:
157
+
158
+ ```text
159
+ ~/.config/rift/config.json
160
+ ```
161
+
162
+ ## License
163
+
164
+ MIT
magic_rift-0.1.1/magic_rift.egg-info/SOURCES.txt ADDED
@@ -0,0 +1,11 @@
1
+ LICENSE
2
+ README.md
3
+ pyproject.toml
4
+ rift.py
5
+ wordlist.txt
6
+ magic_rift.egg-info/PKG-INFO
7
+ magic_rift.egg-info/SOURCES.txt
8
+ magic_rift.egg-info/dependency_links.txt
9
+ magic_rift.egg-info/entry_points.txt
10
+ magic_rift.egg-info/requires.txt
11
+ magic_rift.egg-info/top_level.txt
magic_rift-0.1.1/magic_rift.egg-info/entry_points.txt ADDED
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ rift = rift:main
magic_rift-0.1.1/magic_rift.egg-info/requires.txt ADDED
@@ -0,0 +1,5 @@
1
+
2
+ [dev]
3
+ pytest>=7.0
4
+ mypy>=1.0
5
+ ruff>=0.1.0
magic_rift-0.1.1/pyproject.toml ADDED
@@ -0,0 +1,47 @@
1
+ [build-system]
2
+ requires = ["setuptools>=61.0", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "magic-rift"
7
+ version = "0.1.1"
8
+ description = "Share files like magic - disposable file sharing via your public IP"
9
+ readme = "README.md"
10
+ requires-python = ">=3.8"
11
+ license = "MIT"
12
+ license-files = ["LICENSE"]
13
+ authors = [
14
+ {name = "Arpit"}
15
+ ]
16
+ keywords = ["file-sharing", "upnp", "tunnel", "http-server", "peer-to-peer"]
17
+ classifiers = [
18
+ "Development Status :: 4 - Beta",
19
+ "Intended Audience :: Developers",
20
+ "Intended Audience :: End Users/Desktop",
21
+ "Operating System :: OS Independent",
22
+ "Programming Language :: Python :: 3",
23
+ "Programming Language :: Python :: 3.8",
24
+ "Programming Language :: Python :: 3.9",
25
+ "Programming Language :: Python :: 3.10",
26
+ "Programming Language :: Python :: 3.11",
27
+ "Programming Language :: Python :: 3.12",
28
+ "Topic :: Internet :: WWW/HTTP :: HTTP Servers",
29
+ "Topic :: System :: Networking",
30
+ "Topic :: Utilities",
31
+ ]
32
+
33
+ [project.scripts]
34
+ rift = "rift:main"
35
+
36
+ [tool.setuptools]
37
+ py-modules = ["rift"]
38
+
39
+ [tool.setuptools.data-files]
40
+ "." = ["wordlist.txt"]
41
+
42
+ [project.optional-dependencies]
43
+ dev = [
44
+ "pytest>=7.0",
45
+ "mypy>=1.0",
46
+ "ruff>=0.1.0",
47
+ ]