VideoTubeEditor 1.0.1__py3-none-any.whl

VideoTubeEditor/__init__.py

@@ -0,0 +1,8 @@
+# Package public surface — requirement-python-packaging / requirement-python-coding-style
+# Do not re-export undefined symbols from .cli.
+
+__version__ = "1.0.1"
+
+from .cli import main
+
+__all__ = ["__version__", "main"]

VideoTubeEditor/__main__.py

@@ -0,0 +1,6 @@
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

VideoTubeEditor/about_page.py

@@ -0,0 +1,280 @@
+# =============================================================================
+# About page composer.
+# requirement-python-oop — class AboutPage.
+# requirement-python-about — identity lines, host check, and the star box.
+# requirement-domain-videoeditor — the domain sentence on the identity block.
+# =============================================================================
+from __future__ import print_function, unicode_literals
+
+import os
+import sys
+
+from .check_system import CheckSystem
+
+
+class AboutPage:
+    """Identity lines, install sentence, and the star box. One class, one module.
+
+    The host check is CheckSystem. Cli writes CheckSystem(...) and passes it here.
+    """
+
+    def __init__(
+        self,
+        check,
+        app_name,
+        version,
+        author,
+        updated,
+        homepage,
+        download_url,
+        usage,
+        console_name,
+        logger=None,
+    ):
+        self.logger = logger
+        if logger is not None:
+            logger.log_message("instantiated", component="AboutPage")
+        if not isinstance(check, CheckSystem):
+            raise TypeError("about host check is CheckSystem")
+        self.check = check
+        self.app_name = app_name
+        self.version = version
+        self.author = author
+        self.updated = updated
+        self.homepage = homepage
+        self.download_url = download_url
+        self.usage = usage
+        self.console_name = console_name
+
+    def _is_source_checkout(self, path):
+        """True when path is this package inside a source tree that has pyproject.toml."""
+        marker = "{}src{}VideoTubeEditor{}".format(os.sep, os.sep, os.sep)
+        if marker not in path:
+            return False
+        cursor = os.path.dirname(path)
+        for _ in range(8):
+            if os.path.isfile(os.path.join(cursor, "pyproject.toml")):
+                return True
+            parent = os.path.dirname(cursor)
+            if parent == cursor:
+                return False
+            cursor = parent
+        return False
+
+    def install_kind(self, path):
+        """
+        General Purpose: global, local, or uninstalled for an about location.
+        A source checkout is uninstalled. A copy under the home directory is local.
+        """
+        path = os.path.realpath(path)
+        parts = path.split(os.sep)
+        packaged = "site-packages" in parts or "dist-packages" in parts
+        if not packaged and self._is_source_checkout(path):
+            return "uninstalled"
+        home = os.path.realpath(os.path.expanduser("~"))
+        in_home = path == home or path.startswith(home + os.sep)
+        base = os.path.basename(path)
+        script_names = (
+            self.console_name,
+            self.app_name,
+            "video-tube-editor",
+            "video-join",
+            "video-speed",
+        )
+        if in_home and (packaged or base in script_names):
+            return "local"
+        if path.startswith("/usr/") or path.startswith("/opt/") or path.startswith("/bin/"):
+            return "global"
+        if packaged and not in_home:
+            return "global"
+        return "uninstalled"
+
+    def install_sentence(self, kind):
+        """General Purpose: The location sentence inside the about box."""
+        if kind == "global":
+            return "You are using the GLOBAL INSTALLED version, location:"
+        if kind == "local":
+            return "You are using the LOCAL INSTALLED version, location:"
+        return "You are using an UNINSTALLED version, location:"
+
+    def about_box_lines(
+        self,
+        usage=None,
+        location=None,
+        kind=None,
+        homepage=None,
+        download_url=None,
+        author=None,
+        updated=None,
+    ):
+        """
+        General Purpose: Star-bordered about box.
+        An empty download URL omits the install line.
+        The title uses the package version string. It is not a second integer triple.
+        """
+        if usage is None:
+            usage = self.usage
+        if location is None:
+            location = self.check.self_location()
+        if kind is None:
+            kind = self.install_kind(location)
+        if homepage is None:
+            homepage = self.homepage
+        if download_url is None:
+            download_url = self.download_url
+        if author is None:
+            author = self.author
+        if updated is None:
+            updated = self.updated
+        app = self.install_sentence(kind)
+        python_exe = self.check.python_executable_name() or "python3"
+        msg1 = "{} ({}) by {} on {}".format(
+            self.app_name, self.version, author, updated
+        )
+        if download_url == "":
+            msg = [
+                msg1,
+                "",
+                app,
+                "    {}".format(location),
+                "",
+                "Basic Usage:",
+                "    {}".format(usage),
+                "",
+                "Please visit our homepage: ",
+                '    "{}"'.format(homepage),
+                "",
+                "",
+                "",
+                "",
+            ]
+        else:
+            msg = [
+                msg1,
+                "",
+                app,
+                "    {}".format(location),
+                "",
+                "Basic Usage:",
+                "    {}".format(usage),
+                "",
+                "Please visit our homepage: ",
+                '    "{}"'.format(homepage),
+                "",
+                "Installation command:",
+                "    curl -fsSL {} | {}".format(download_url, python_exe),
+                "",
+            ]
+        if download_url == "":
+            if homepage == "":
+                max_line = len(msg) - 3
+            else:
+                max_line = len(msg) - 2
+        else:
+            max_line = len(msg) - 1
+        if max_line < 1:
+            max_line = len(msg)
+        max_len = 0
+        for index in range(0, max_line):
+            if len(msg[index]) > max_len:
+                max_len = len(msg[index])
+        boxed = []
+        for index in range(0, max_line):
+            boxed.append(msg[index] + (" " * (max_len - len(msg[index]))))
+        star = "*" * (max_len + 4)
+        blank = " " * max_len
+        lines = [star, "* {} *".format(blank)]
+        for row in boxed:
+            lines.append("* {} *".format(row))
+        lines.append("* {} *".format(blank))
+        lines.append(star)
+        return lines
+
+    def framework_about(self):
+        """
+        General Purpose: About text for the menu result page.
+        requirement-python-about: identity (with window libraries), host check, and the install box.
+        """
+        lines = [
+            "{} {}".format(self.app_name, self.version),
+            "Domain: Concatenate two local videos, and cut, speed, or boomerang an MP4",
+            "Runtime tools: FFmpeg (copy, re-encode, cut, speed); OpenCV (duration); GTK 4 and GStreamer (window)",
+            "Entry points: {}, video-join, video-speed, python -m {}".format(
+                self.console_name, self.app_name
+            ),
+        ]
+        lines.extend(self.window_library_lines())
+        lines.append("")
+        lines.extend(self.check.check_system_lines())
+        lines.append("")
+        lines.extend(self.about_box_lines())
+        return "\n".join(lines)
+
+    def _windows_host(self) -> bool:
+        """True on Windows, including Windows Python under Git Bash.
+
+        requirement-python-windows. The miss text stays on requirement-python-about.
+        """
+        if os.name == "nt" or sys.platform.startswith("win"):
+            return True
+        return os.environ.get("OS", "").lower().startswith("windows")
+
+    def _probe_window_libraries(self):
+        """Read GTK 4 and GStreamer from this interpreter. Missing stays not available."""
+        gtk_text = "not available"
+        gst_text = "not available"
+        dist = "/usr/lib/python3/dist-packages"
+        if os.path.isdir(os.path.join(dist, "gi")) and dist not in sys.path:
+            sys.path.append(dist)
+        try:
+            import gi
+
+            gi.require_version("Gtk", "4.0")
+            from gi.repository import Gtk
+
+            gtk_text = "{}.{}.{}".format(
+                Gtk.get_major_version(),
+                Gtk.get_minor_version(),
+                Gtk.get_micro_version(),
+            )
+        except Exception:
+            gtk_text = "not available"
+        try:
+            import gi
+
+            gi.require_version("Gst", "1.0")
+            from gi.repository import Gst
+
+            major, minor, micro = Gst.version()[:3]
+            gst_text = "{}.{}.{}".format(major, minor, micro)
+        except Exception:
+            gst_text = "not available"
+        return gtk_text, gst_text
+
+    def window_library_lines(self, gtk_text=None, gst_text=None, on_windows=None):
+        """GTK 4 and GStreamer for this Python. The lines stay text and install nothing."""
+        if gtk_text is None or gst_text is None:
+            found_gtk, found_gst = self._probe_window_libraries()
+            if gtk_text is None:
+                gtk_text = found_gtk
+            if gst_text is None:
+                gst_text = found_gst
+        if on_windows is None:
+            on_windows = self._windows_host()
+        lines = [
+            "Window libraries:",
+            "    GTK 4: {}".format(gtk_text),
+            "    GStreamer: {}".format(gst_text),
+        ]
+        missing = gtk_text == "not available" or gst_text == "not available"
+        if on_windows and missing:
+            lines.extend(
+                [
+                    "    Windows: this Python cannot import GTK 4 and GStreamer.",
+                    "    The picture window needs both libraries in this Python. This page checks them and does not install them.",
+                    "    On Windows, run video-tube-editor tui.",
+                ]
+            )
+        elif on_windows:
+            lines.append("    Windows: this Python can import GTK 4 and GStreamer.")
+        return lines