rust/hgcli/pyoxidizer.bzl
changeset 44642 af739894a4c1
child 44643 bc847878f4c0
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/rust/hgcli/pyoxidizer.bzl	Tue Mar 31 19:07:36 2020 -0700
@@ -0,0 +1,153 @@
+# This file defines how PyOxidizer application building and packaging is
+# performed. See the pyoxidizer crate's documentation for extensive
+# documentation on this file format.
+
+# Obtain the default PythonDistribution for our build target. We link
+# this distribution into our produced executable and extract the Python
+# standard library from it.
+def make_dist():
+    return default_python_distribution()
+
+# Configuration files consist of functions which define build "targets."
+# This function creates a Python executable and installs it in a destination
+# directory.
+def make_exe(dist):
+    # This variable defines the configuration of the
+    # embedded Python interpreter.
+    python_config = PythonInterpreterConfig(
+        #     bytes_warning=0,
+        #     dont_write_bytecode=True,
+        #     ignore_environment=True,
+        #     inspect=False,
+        #     interactive=False,
+        #     isolated=False,
+        #     legacy_windows_fs_encoding=False,
+        #     legacy_windows_stdio=False,
+        #     no_site=True,
+        #     no_user_site_directory=True,
+        #     optimize_level=0,
+        #     parser_debug=False,
+        #     stdio_encoding=None,
+        #     unbuffered_stdio=False,
+        #     filesystem_importer=False,
+        #     sys_frozen=False,
+        #     sys_meipass=False,
+        #     sys_paths=None,
+        #     raw_allocator=None,
+        #     terminfo_resolution="dynamic",
+        #     terminfo_dirs=None,
+        #     use_hash_seed=False,
+        #     verbose=0,
+        #     write_modules_directory_env=None,
+        #     run_eval=None,
+        #     run_module=None,
+        #     run_noop=False,
+        #     run_repl=True,
+    )
+
+    # The run_eval, run_module, run_noop, and run_repl arguments are mutually
+    # exclusive controls over what the interpreter should do once it initializes.
+    #
+    # run_eval -- Run the specified string value via `eval()`.
+    # run_module -- Import the specified module as __main__ and run it.
+    # run_noop -- Do nothing.
+    # run_repl -- Start a Python REPL.
+    #
+    # These arguments can be ignored if you are providing your own Rust code for
+    # starting the interpreter, as Rust code has full control over interpreter
+    # behavior.
+
+    # Produce a PythonExecutable from a Python distribution, embedded
+    # resources, and other options. The returned object represents the
+    # standalone executable that will be built.
+    exe = dist.to_python_executable(
+        name = "hgcli",
+        config = python_config,
+        # Embed all extension modules, making this a fully-featured Python.
+        extension_module_filter = "all",
+
+        # Only package the minimal set of extension modules needed to initialize
+        # a Python interpreter. Many common packages in Python's standard
+        # library won't work with this setting.
+        #extension_module_filter='minimal',
+
+        # Only package extension modules that don't require linking against
+        # non-Python libraries. e.g. will exclude support for OpenSSL, SQLite3,
+        # other features that require external libraries.
+        #extension_module_filter='no-libraries',
+
+        # Only package extension modules that don't link against GPL licensed
+        # libraries.
+        #extension_module_filter='no-gpl',
+
+        # Include Python module sources. This isn't strictly required and it does
+        # make binary sizes larger. But having the sources can be useful for
+        # activities such as debugging.
+        include_sources = True,
+
+        # Whether to include non-module resource data/files.
+        include_resources = False,
+
+        # Do not include functionality for testing Python itself.
+        include_test = False,
+    )
+
+    # Invoke `pip install` with our Python distribution to install a single package.
+    # `pip_install()` returns objects representing installed files.
+    # `add_in_memory_python_resources()` adds these objects to the binary,
+    # marking them for in-memory loading.
+    #exe.add_in_memory_python_resources(dist.pip_install(["appdirs"]))
+
+    # Invoke `pip install` using a requirements file and add the collected resources
+    # to our binary.
+    #exe.add_in_memory_python_resources(dist.pip_install(["-r", "requirements.txt"]))
+
+    # Read Python files from a local directory and add them to our embedded
+    # context, taking just the resources belonging to the `foo` and `bar`
+    # Python packages.
+    #exe.add_in_memory_python_resources(dist.read_package_root(
+    #    path="/src/mypackage",
+    #    packages=["foo", "bar"],
+    #))
+
+    # Discover Python files from a virtualenv and add them to our embedded
+    # context.
+    #exe.add_in_memory_python_resources(dist.read_virtualenv(path="/path/to/venv"))
+
+    # Filter all resources collected so far through a filter of names
+    # in a file.
+    #exe.filter_from_files(files=["/path/to/filter-file"]))
+
+    # Return our `PythonExecutable` instance so it can be built and
+    # referenced by other consumers of this target.
+    return exe
+
+def make_embedded_resources(exe):
+    return exe.to_embedded_resources()
+
+def make_install(exe):
+    # Create an object that represents our installed application file layout.
+    files = FileManifest()
+
+    # Add the generated executable to our install layout in the root directory.
+    files.add_python_resource(".", exe)
+
+    return files
+
+# Tell PyOxidizer about the build targets defined above.
+register_target("dist", make_dist)
+register_target("exe", make_exe, depends = ["dist"], default = True)
+register_target("resources", make_embedded_resources, depends = ["exe"], default_build_script = True)
+register_target("install", make_install, depends = ["exe"])
+
+# Resolve whatever targets the invoker of this configuration file is requesting
+# be resolved.
+resolve_targets()
+
+# END OF COMMON USER-ADJUSTED SETTINGS.
+#
+# Everything below this is typically managed by PyOxidizer and doesn't need
+# to be updated by people.
+
+PYOXIDIZER_VERSION = "0.7.0-pre"
+PYOXIDIZER_COMMIT = "c772a1379c3026314eda1c8ea244b86c0658951d"