b64-clip 1.0.0__tar.gz

b64_clip-1.0.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Eric Joye
+
+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.

b64_clip-1.0.0/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: b64-clip
+Version: 1.0.0
+Summary: Base64 encode/decode with clipboard, zero dependencies
+Author: b64-clip contributors
+License: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# b64-clip
+
+Base64 encode/decode with clipboard, zero dependencies.
+
+Encode auth tokens, config values, certificate data, and more — result is
+automatically copied to your clipboard.
+
+## Install
+
+```bash
+pip install b64-clip
+```
+
+Or run directly (no install):
+
+```bash
+python3 b64_clip.py encode "hello world"
+```
+
+## Usage
+
+```bash
+# Encode a string
+b64-clip encode "hello world"
+# Output: aGVsbG8gd29ybGQ=
+# (also copied to clipboard)
+
+# Decode a string
+b64-clip decode "aGVsbG8gd29ybGQ="
+# Output: hello world
+# (also copied to clipboard)
+
+# Encode a file
+b64-clip encode --file cert.pem
+
+# Decode a file
+b64-clip decode --file encoded.txt
+
+# Pipe from stdin
+echo "test" | b64-clip encode
+
+# URL-safe base64 decode
+b64-clip decode --url-safe "PDw_Pz4-"
+```
+
+## What it does
+
+- **Encode**: Takes any input (string, file, or stdin) and outputs base64
+- **Decode**: Takes base64 input and outputs the decoded plaintext
+- **Clipboard**: Automatically copies the result to your clipboard on macOS,
+  Linux (xclip/wl-copy), and Windows (clip.exe)
+- **Zero dependencies**: Python stdlib only — no pip install needed at runtime
+
+## Requirements
+
+- Python 3.11+
+- For clipboard support: `xclip` on Linux (install with `sudo apt install xclip`),
+  `pbcopy` on macOS (built-in), `clip.exe` on Windows (built-in)
+
+## Security
+
+Nothing is logged or stored. The tool processes data in memory only and does not
+write any temporary files or make network requests.
+
+## License
+
+MIT

b64_clip-1.0.0/README.md

@@ -0,0 +1,67 @@
+# b64-clip
+
+Base64 encode/decode with clipboard, zero dependencies.
+
+Encode auth tokens, config values, certificate data, and more — result is
+automatically copied to your clipboard.
+
+## Install
+
+```bash
+pip install b64-clip
+```
+
+Or run directly (no install):
+
+```bash
+python3 b64_clip.py encode "hello world"
+```
+
+## Usage
+
+```bash
+# Encode a string
+b64-clip encode "hello world"
+# Output: aGVsbG8gd29ybGQ=
+# (also copied to clipboard)
+
+# Decode a string
+b64-clip decode "aGVsbG8gd29ybGQ="
+# Output: hello world
+# (also copied to clipboard)
+
+# Encode a file
+b64-clip encode --file cert.pem
+
+# Decode a file
+b64-clip decode --file encoded.txt
+
+# Pipe from stdin
+echo "test" | b64-clip encode
+
+# URL-safe base64 decode
+b64-clip decode --url-safe "PDw_Pz4-"
+```
+
+## What it does
+
+- **Encode**: Takes any input (string, file, or stdin) and outputs base64
+- **Decode**: Takes base64 input and outputs the decoded plaintext
+- **Clipboard**: Automatically copies the result to your clipboard on macOS,
+  Linux (xclip/wl-copy), and Windows (clip.exe)
+- **Zero dependencies**: Python stdlib only — no pip install needed at runtime
+
+## Requirements
+
+- Python 3.11+
+- For clipboard support: `xclip` on Linux (install with `sudo apt install xclip`),
+  `pbcopy` on macOS (built-in), `clip.exe` on Windows (built-in)
+
+## Security
+
+Nothing is logged or stored. The tool processes data in memory only and does not
+write any temporary files or make network requests.
+
+## License
+
+MIT

b64_clip-1.0.0/b64_clip.egg-info/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: b64-clip
+Version: 1.0.0
+Summary: Base64 encode/decode with clipboard, zero dependencies
+Author: b64-clip contributors
+License: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# b64-clip
+
+Base64 encode/decode with clipboard, zero dependencies.
+
+Encode auth tokens, config values, certificate data, and more — result is
+automatically copied to your clipboard.
+
+## Install
+
+```bash
+pip install b64-clip
+```
+
+Or run directly (no install):
+
+```bash
+python3 b64_clip.py encode "hello world"
+```
+
+## Usage
+
+```bash
+# Encode a string
+b64-clip encode "hello world"
+# Output: aGVsbG8gd29ybGQ=
+# (also copied to clipboard)
+
+# Decode a string
+b64-clip decode "aGVsbG8gd29ybGQ="
+# Output: hello world
+# (also copied to clipboard)
+
+# Encode a file
+b64-clip encode --file cert.pem
+
+# Decode a file
+b64-clip decode --file encoded.txt
+
+# Pipe from stdin
+echo "test" | b64-clip encode
+
+# URL-safe base64 decode
+b64-clip decode --url-safe "PDw_Pz4-"
+```
+
+## What it does
+
+- **Encode**: Takes any input (string, file, or stdin) and outputs base64
+- **Decode**: Takes base64 input and outputs the decoded plaintext
+- **Clipboard**: Automatically copies the result to your clipboard on macOS,
+  Linux (xclip/wl-copy), and Windows (clip.exe)
+- **Zero dependencies**: Python stdlib only — no pip install needed at runtime
+
+## Requirements
+
+- Python 3.11+
+- For clipboard support: `xclip` on Linux (install with `sudo apt install xclip`),
+  `pbcopy` on macOS (built-in), `clip.exe` on Windows (built-in)
+
+## Security
+
+Nothing is logged or stored. The tool processes data in memory only and does not
+write any temporary files or make network requests.
+
+## License
+
+MIT

b64_clip-1.0.0/b64_clip.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+b64_clip.py
+pyproject.toml
+b64_clip.egg-info/PKG-INFO
+b64_clip.egg-info/SOURCES.txt
+b64_clip.egg-info/dependency_links.txt
+b64_clip.egg-info/entry_points.txt
+b64_clip.egg-info/top_level.txt

b64_clip-1.0.0/b64_clip.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

b64_clip-1.0.0/b64_clip.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+b64-clip = b64_clip:main

b64_clip-1.0.0/b64_clip.egg-info/top_level.txt

@@ -0,0 +1 @@
+b64_clip

b64_clip-1.0.0/b64_clip.py

@@ -0,0 +1,123 @@
+#!/usr/bin/env python3
+"""b64-clip — Base64 encode/decode with clipboard, zero dependencies."""
+
+import argparse
+import base64
+import os
+import platform
+import subprocess
+import sys
+
+
+def copy_to_clipboard(text: str) -> bool:
+    """Copy text to clipboard. Returns True on success, False on failure."""
+    system = platform.system()
+    try:
+        if system == "Darwin":
+            proc = subprocess.run(["pbcopy"], input=text.encode(), check=True)
+        elif system == "Windows":
+            proc = subprocess.run(["clip.exe"], input=text.encode(), check=True)
+        else:
+            # Linux and other Unix — try xclip, then wl-copy (Wayland)
+            for cmd in (["xclip", "-selection", "clipboard"],
+                        ["wl-copy"]):
+                try:
+                    proc = subprocess.run(cmd, input=text.encode(), check=True)
+                    break
+                except FileNotFoundError:
+                    continue
+            else:
+                print("WARNING: No clipboard tool found (xclip or wl-copy). "
+                      "Install xclip for clipboard support.", file=sys.stderr)
+                return False
+        return True
+    except (FileNotFoundError, subprocess.CalledProcessError) as e:
+        print(f"WARNING: Clipboard copy failed ({e}). "
+              "Output is still shown above.", file=sys.stderr)
+        return False
+
+
+def read_input(args) -> bytes:
+    """Read input from --file, positional string, or stdin."""
+    if args.file:
+        fpath = os.path.expanduser(args.file)
+        if not os.path.isfile(fpath):
+            print(f"Error: File not found: {args.file}", file=sys.stderr)
+            sys.exit(1)
+        with open(fpath, "rb") as f:
+            return f.read()
+
+    if args.string:
+        return args.string.encode()
+
+    # Stdin pipe mode
+    if not sys.stdin.isatty():
+        return sys.stdin.buffer.read()
+
+    print("Error: No input provided. Pass a string argument, --file, or pipe data via stdin.",
+          file=sys.stderr)
+    sys.exit(1)
+
+
+def encode(args):
+    """Base64-encode input and print + copy to clipboard."""
+    raw = read_input(args)
+    encoded = base64.b64encode(raw).decode()
+    print(encoded)
+    copy_to_clipboard(encoded)
+
+
+def decode(args, url_safe: bool = False):
+    """Base64-decode input and print + copy to clipboard."""
+    raw = read_input(args).strip()
+    raw_str = raw.decode()
+
+    # Auto-detect URL-safe base64
+    if not url_safe and ("-" in raw_str or "_" in raw_str):
+        url_safe = True
+
+    try:
+        if url_safe:
+            # Add padding if missing
+            padding = 4 - len(raw_str) % 4
+            if padding != 4:
+                raw_str += "=" * padding
+            decoded = base64.urlsafe_b64decode(raw_str).decode()
+        else:
+            decoded = base64.b64decode(raw_str).decode()
+    except Exception as e:
+        print(f"Error: Decode failed ({e}). Check that input is valid base64.",
+              file=sys.stderr)
+        sys.exit(1)
+
+    print(decoded)
+    copy_to_clipboard(decoded)
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="b64-clip",
+        description="Base64 encode/decode with clipboard, zero dependencies."
+    )
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    # encode subcommand
+    enc = subparsers.add_parser("encode", help="Encode input to base64")
+    enc.add_argument("string", nargs="?", default=None, help="String to encode")
+    enc.add_argument("--file", "-f", default=None, help="File to encode")
+    enc.set_defaults(func=encode)
+
+    # decode subcommand
+    dec = subparsers.add_parser("decode", help="Decode base64 to plaintext")
+    dec.add_argument("string", nargs="?", default=None, help="Base64 string to decode")
+    dec.add_argument("--file", "-f", default=None, help="File containing base64 to decode")
+    dec.add_argument("--url-safe", action="store_true", default=False,
+                      help="Use URL-safe base64 alphabet")
+    dec.set_defaults(func=lambda args: decode(args, url_safe=args.url_safe))
+
+    args = parser.parse_args()
+    args.func(args)
+
+
+if __name__ == "__main__":
+    main()

b64_clip-1.0.0/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "b64-clip"
+version = "1.0.0"
+description = "Base64 encode/decode with clipboard, zero dependencies"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.11"
+authors = [{name = "b64-clip contributors"}]
+dependencies = []
+
+[project.scripts]
+b64-clip = "b64_clip:main"
+
+[tool.setuptools]
+py-modules = ["b64_clip"]

b64_clip-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+