Add Cli launching, file associations, shortcut generation

docs/mkdocs.yml

@@ -8,6 +8,7 @@ nav:
     - Settings: settings.md
     - Manual Blender Installation: manual_build_installation.md
     - Build Initialization: build_initialization.md
+    - File Association: file_association.md
     - Troubleshooting: troubleshooting.md
     - Known Issues: known_issues.md
     - Feature Request: feature_request.md

docs/mkdocs/file_association.md

@@ -0,0 +1,41 @@
+<style>body {text-align: justify}</style>
+
+# File Association
+
+## Version Selection
+
+:   TODO
+
+## Branch
+
+:   TODO
+
+## Build Hash
+
+:   TODO
+
+## Date Selection
+
+:   TODO
+
+### Latest
+
+:   TODO
+
+### Any
+
+:   TODO
+
+### Oldest
+
+:   TODO
+
+## Build List
+
+:   TODO
+
+## Save Current Query
+
+:   TODO
+
+## Launch

docs/mkdocs/settings.md

@@ -4,15 +4,17 @@
 
 ## Settings Window
 
-To open the **Settings Window**, use the button with a gear icon on the top left of the **Main Window**. All changes are saved automatically.
+:   To open the **Settings Window**, use the button with a gear icon on the top left of the **Main Window**. All changes are saved automatically.
 
 ## General
 
 ![General page of Settings](imgs/settings_window_general.png)
 
 ### Library Folder
 
-**Library Folder** - a directory on the hard drive where all downloaded builds are stored. For detailed information, check the [Library Folder](library_folder.md) page.
+:   **Library Folder** - a directory on the hard drive where all downloaded builds are stored.
+
+:    For detailed information, check the [Library Folder](library_folder.md) page.
 
 ### Launch When System Starts
 
@@ -34,6 +36,35 @@ If this option is enabled, to completely close the **Blender Launcher** you need
 
 :   Sets the maximal number of **CPU Thread Blender** Launcher can use.
 
+### File Association
+:   Use the Blender Launcher as Default program to launch `.blend` files with the desired version
+:   For detail information, check the [File Association](file_association.md) page.
+
+#### Create Shortcut
+
+:   TODO
+
+#### Register File Association
+
+:   Add Blender Launcher as the Default program to open `.blend` and `.blend1` files
+
+#### Unregister File Association
+
+:   Remove the Blender Launcher as the Default program to open `.blend` and `.blend1` files
+
+#### Launch Time Duration
+
+:   Set the time to automatically lunch a `.blend` file with the corresponding version
+
+    !!! info
+        Blend files will be automatically lunch after this timer if the correspond Blender version exist in the [Blender Launcher Library](library_folder.md)
+
+    ```
+    -1 -> No Timer (Require the user to click on launch)
+     0 -> instant (Only if matching version exist)
+     3 -> 3 Seconde (Will lunch after 3s if matching version exist)
+    ```
+
 ## Appearance
 
 ![Appearance page of Settings](imgs/settings_window_appearance.png)

pyproject.toml

@@ -15,6 +15,7 @@ dependencies = [
     "pywin32==303; sys_platform == \"win32\"",
     "distro>=1.8.0",
     "semver>=3.0.2",
+    "zstandard>=0.23.0",
 ]
 requires-python = ">=3.9, <3.11"
 readme = "README.md"

scripts/build_win.bat

@@ -22,6 +22,7 @@ python -OO -m PyInstaller ^
 --name="Blender Launcher" ^
 --version-file="version.txt" ^
 --add-binary="source\resources\icons\winblender.ico;files" ^
+--add-data="source\resources\icons\bl\bl_file.ico;files" ^
 --add-binary="source\resources\certificates\custom.pem;files" ^
 --distpath="./dist/release" ^
 source\main.py

scripts/build_win_debug.bat

@@ -20,6 +20,7 @@ python -OO -m PyInstaller ^
 --name="Blender Launcher" ^
 --version-file="version.txt" ^
 --add-binary="source\resources\icons\winblender.ico;files" ^
+--add-data="source\resources\icons\bl\bl_file.ico;files" ^
 --add-binary="source\resources\certificates\custom.pem;files" ^
 --distpath="./dist/debug" ^
 source\main.py

source/items/enablable_list_widget_item.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from PyQt5.QtWidgets import QListWidgetItem
+
+if TYPE_CHECKING:
+    from modules.build_info import BuildInfo
+    from PyQt5.QtGui import QFont
+
+
+class EnablableListWidgetItem(QListWidgetItem):
+    def __init__(self, enabled_font: QFont, disable_font: QFont, build: BuildInfo, parent=None):
+        super().__init__(parent)
+        self._enabled = True
+        self.__enabled_font = enabled_font
+        self.__disable_font = disable_font
+        self.build = build
+
+    @property
+    def enabled(self):
+        return self._enabled
+
+    @enabled.setter
+    def enabled(self, value):
+        self._enabled = value
+        if value:
+            self.setFont(self.__enabled_font)
+        else:
+            self.setFont(self.__disable_font)
+
+    def __lt__(self, other: EnablableListWidgetItem):
+        return self.enabled < other.enabled if self.enabled != other.enabled else self.build < other.build

source/main.py

@@ -6,10 +6,14 @@
 import sys
 from argparse import ArgumentParser
 from pathlib import Path
+from typing import NoReturn
 
 import modules._resources_rc
 from modules import argument_parsing as ap
 from modules._platform import _popen, get_cache_path, get_cwd, get_launcher_name, get_platform, is_frozen
+from modules.cli_launching import cli_launch
+from modules.shortcut import register_windows_filetypes, unregister_windows_filetypes
+from modules.version_matcher import VALID_FULL_QUERIES, VALID_QUERIES, VERSION_SEARCH_SYNTAX
 from PyQt5.QtWidgets import QApplication
 from semver import Version
 from windows.dialog_window import DialogWindow
@@ -65,11 +69,15 @@ def main():
 
     subparsers = parser.add_subparsers(dest="command")
 
-    update_parser = subparsers.add_parser("update", help="Update the application to a new version.", add_help=False)
+    update_parser = subparsers.add_parser(
+        "update",
+        help="Update the application to a new version.",
+        add_help=False,
+    )
     add_help(update_parser)
     update_parser.add_argument("version", help="Version to update to.", nargs="?")
 
-    parser.add_argument("-debug", help="Enable debug logging.", action="store_true")
+    parser.add_argument("-d", "-debug", "--debug", help="Enable debug logging.", action="store_true")
     parser.add_argument("-set-library-folder", help="Set library folder", type=Path)
     parser.add_argument(
         "--offline",
@@ -84,12 +92,40 @@ def main():
         action="store_true",
     )
 
-    # possible launch_parser
-    # args:
-    #   "launch":               Launch a specific version of Blender. If no file or version is specified,
-    #                            the favorite build is chosen. If there is no favorite build, TODO: BUILD_CHOOSER
-    #   "-f" | "--file":        Path to a specific Blender file to launch.
-    #   "-v" | "--version":     Version to launch. If not specified, the latest stable release is used.
+    launch_parser = subparsers.add_parser(
+        "launch",
+        help="Launch a specific version of Blender. If not file or version is specified, Quick launch is chosen.",
+        add_help=False,
+    )
+    add_help(launch_parser)
+    grp = launch_parser.add_mutually_exclusive_group()
+    grp.add_argument("-f", "--file", type=Path, help="Path to a specific Blender file to launch.")
+    grp.add_argument(
+        "-ol", "--open-last", action="store_true", help="Open the last file in the specified blender build"
+    )
+
+    launch_parser.add_argument("-v", "--version", help=f"Version to launch. {VERSION_SEARCH_SYNTAX}")
+    launch_parser.add_argument(
+        "-c",
+        "--cli",
+        action="store_true",
+        help="Launch Blender from CLI. does not open any QT frontend. WARNING: LIKELY DOES NOT WORK IN WINDOWS BUNDLED EXECUTABLE",
+    )
+
+    # This could be used better
+    launch_target_parser = subparsers.add_parser(
+        "__launch_target",
+        help="This is a target for launching the program from a shortcut.",
+        add_help=False,
+    )
+    launch_target_parser.add_argument("file", nargs="?", type=Path, help="Path to a specific Blender file to launch.")
+
+    if sys.platform == "win32":
+        subparsers.add_parser(
+            "register",
+            help="Registers the program to read .blend builds. Adds Blender Launcher to the Open With window. (WIN ONLY)",
+        )
+        subparsers.add_parser("unregister", help="Undoes the changes that `register` makes. (WIN ONLY)")
 
     args, argv = parser.parse_known_args()
     if argv:
@@ -98,7 +134,7 @@ def main():
 
     # Custom help is necessary for frozen Windows builds
     if args.help:
-        ap.show_help(parser, update_parser, args)
+        ap.show_help(parser, update_parser, launch_parser, args)
         sys.exit(0)
 
     if args.debug:
@@ -118,8 +154,15 @@ def main():
     if args.command == "update":
         start_update(app, args.instanced, args.version)
 
-    # if args.command == "launch":
-    #     ...
+    if args.command == "launch":
+        start_launch(app, args.file, args.version, args.open_last, cli=args.cli)
+    if args.command == "__launch_target" and args.file:
+        start_launch(app, args.file, None, False)
+
+    if args.command == "register":
+        start_register()
+    if args.command == "unregister":
+        start_unregister()
 
     if not args.instanced:
         check_for_instance()
@@ -175,6 +218,56 @@ def start_update(app: QApplication, is_instanced: bool, tag: str | None):
         sys.exit(0)
 
 
+def start_launch(
+    app: QApplication,
+    file: Path | None = None,
+    version_query: str | None = None,
+    open_last: bool = False,
+    cli: bool = False,
+) -> NoReturn:
+    from modules.version_matcher import VersionSearchQuery
+    from windows.launching_window import LaunchingWindow
+
+    # convert version_query to VersionSearchQuery
+    if version_query is not None:
+        try:
+            query = VersionSearchQuery.parse(version_query)
+        except Exception:
+            print("Failed to parse query")
+            print(VERSION_SEARCH_SYNTAX)
+            print("Valid version queries include: ")
+            print(VALID_FULL_QUERIES)
+            sys.exit(1)
+    else:
+        query = None
+
+    # remove quotes around file path if they exist
+    if file is not None:
+        file = Path(str(file).strip('"'))
+
+    if cli:
+        cli_launch(file=file, version_query=query, open_last=open_last)
+        sys.exit(1)
+    else:
+        LaunchingWindow(app, version_query=query, blendfile=file, open_last=open_last).show()
+        sys.exit(app.exec())
+
+
+def start_register():
+    import sys
+
+    register_windows_filetypes()
+
+    sys.exit(0)
+
+
+def start_unregister():
+    import sys
+
+    unregister_windows_filetypes()
+    sys.exit(0)
+
+
 def check_for_instance():
     from PyQt5.QtCore import QByteArray
     from PyQt5.QtNetwork import QLocalSocket

source/modules/argument_parsing.py

@@ -29,19 +29,20 @@ def error(parser: ArgumentParser, msg: str):
 def show_help(
     parser: ArgumentParser,
     update_parser: ArgumentParser,
+    launch_parser: ArgumentParser,
     args: Namespace,
 ):
     if is_frozen() and sys.platform == "win32":
         if args.command == "update":
             show_windows_help(update_parser)
-        # elif args.command == "launch":
-        #     print_windows_help(launch_parser)
+        elif args.command == "launch":
+            show_windows_help(launch_parser)
         else:
             show_windows_help(parser)
     else:
         if args.command == "update":
             update_parser.print_help()
-        # elif args.command == "launch":
-        #     launch_parser.print_help()
+        elif args.command == "launch":
+            launch_parser.print_help()
         else:
             parser.print_help()