thepythonbook 0.1.0__py3-none-any.whl

thepythonbook/__init__.py

@@ -0,0 +1,95 @@
+"""Turn Python code into a link that opens and runs it at pythoncompiler.io."""
+
+__version__ = "0.1.0"
+__all__ = ["link", "link_file"]
+
+SITE = "https://pythoncompiler.io/"
+MAX_LINK = 8000
+_SAFE = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+-$"
+
+
+def _compress(text):
+    """LZ-String's compressToEncodedURIComponent, so the site's editor can read it."""
+    if not text:
+        return ""
+    dictionary, pending = {}, set()
+    word, enlarge_in, next_code, num_bits = "", 2, 3, 2
+    out, value, position = [], 0, 0
+
+    def bit(b):
+        nonlocal value, position
+        value = (value << 1) | b
+        if position == 5:
+            out.append(_SAFE[value])
+            value, position = 0, 0
+        else:
+            position += 1
+
+    def bits(number, count):
+        for _ in range(count):
+            bit(number & 1)
+            number >>= 1
+
+    def write_word():
+        nonlocal enlarge_in, num_bits
+        if word in pending:
+            code = ord(word[0])
+            wide = code >= 256
+            bits(1 if wide else 0, num_bits)
+            bits(code, 16 if wide else 8)
+            enlarge_in -= 1
+            if enlarge_in == 0:
+                enlarge_in, num_bits = 2 ** num_bits, num_bits + 1
+            pending.discard(word)
+        else:
+            bits(dictionary[word], num_bits)
+        enlarge_in -= 1
+        if enlarge_in == 0:
+            enlarge_in, num_bits = 2 ** num_bits, num_bits + 1
+
+    # JavaScript strings are UTF-16, so work in the same units.
+    raw = text.encode("utf-16-le", "surrogatepass")
+    for i in range(0, len(raw), 2):
+        char = chr(raw[i] | (raw[i + 1] << 8))
+        if char not in dictionary:
+            dictionary[char] = next_code
+            next_code += 1
+            pending.add(char)
+        joined = word + char
+        if joined in dictionary:
+            word = joined
+        else:
+            write_word()
+            dictionary[joined] = next_code
+            next_code += 1
+            word = char
+    if word:
+        write_word()
+    bits(2, num_bits)
+    while True:
+        value <<= 1
+        if position == 5:
+            out.append(_SAFE[value])
+            break
+        position += 1
+    return "".join(out)
+
+
+def link(code):
+    """Return a link that opens this Python code in the online editor."""
+    if not isinstance(code, str):
+        raise TypeError("link() takes the code as a string; use link_file() for a file")
+    if not code.strip():
+        raise ValueError("there is no code to share")
+    url = SITE + "?code=" + _compress(code)
+    if len(url) > MAX_LINK:
+        raise ValueError(
+            "this code makes a link of %d characters, over the limit of %d" % (len(url), MAX_LINK)
+        )
+    return url
+
+
+def link_file(path):
+    """Return a link that opens this Python file in the online editor."""
+    with open(path, encoding="utf-8") as f:
+        return link(f.read())

thepythonbook/__main__.py

@@ -0,0 +1,20 @@
+import sys
+
+from . import link_file
+
+
+def main(argv=None):
+    args = sys.argv[1:] if argv is None else argv
+    if len(args) != 1 or args[0] in ("-h", "--help"):
+        print("Usage: python -m thepythonbook hello.py")
+        return 0 if args and args[0] in ("-h", "--help") else 2
+    try:
+        print(link_file(args[0]))
+    except (OSError, ValueError, UnicodeDecodeError) as err:
+        print("Could not make a link: %s" % err, file=sys.stderr)
+        return 1
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

thepythonbook-0.1.0.dist-info/METADATA

@@ -0,0 +1,33 @@
+Metadata-Version: 2.5
+Name: thepythonbook
+Version: 0.1.0
+Summary: Turn a Python file into a link that opens and runs it in the browser at pythoncompiler.io.
+Project-URL: Homepage, https://pythoncompiler.io/
+Author: Selva Prabhakaran
+License-Expression: MIT
+License-File: LICENSE
+Keywords: education,online compiler,python,share code
+Classifier: Intended Audience :: Education
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Education
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# thepythonbook
+
+Turn a Python file into a link. Anyone who opens the link gets the code in the online editor at [pythoncompiler.io](https://pythoncompiler.io/), where it runs in their browser with nothing to install.
+
+```
+pip install thepythonbook
+python -m thepythonbook hello.py
+```
+
+From Python, including a notebook:
+
+```python
+import thepythonbook as tb
+
+print(tb.link("print('Hello')"))
+```
+
+The code travels inside the link, so nothing is uploaded. Very long programs make links too long to open: over 8,000 characters raises an error.

thepythonbook-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+thepythonbook/__init__.py,sha256=hRdIxIMFc-49M6V1RPNE2KQhll6TSZzQojjF3ZSB7eA,2906
+thepythonbook/__main__.py,sha256=2u0Q6EGAsWaaLr-CSjAAIqjoFTVag-kR729qTNTWG-I,534
+thepythonbook-0.1.0.dist-info/METADATA,sha256=l-jWeznrDRrgzEAFHCm7lqiUu2aiZ-jgVGwmV9h0Eh0,1063
+thepythonbook-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+thepythonbook-0.1.0.dist-info/entry_points.txt,sha256=nG73PePeSD2SdGdCU99XZ5daWb_brwT21JjY-img4q0,62
+thepythonbook-0.1.0.dist-info/licenses/LICENSE,sha256=TrI6PLwAol4xx6JszSaIj29cYbINIjg4JbnMsTaW5qs,1074
+thepythonbook-0.1.0.dist-info/RECORD,,

thepythonbook-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

thepythonbook-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+thepythonbook = thepythonbook.__main__:main

thepythonbook-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Selva Prabhakaran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.