package dkml-install-runner

You can search for identifiers within the package.

in-package search v0.2.0

dkml-install-runner
- Library dkml-install-runner
  - Dkml_install_runner
    
    Path_eval
    
    Global_context
    
    Interpreter
    
    Private
    
    Host_abi
    
    Ocaml_abi
    
    Cmdliner_common
    
    Cmdliner_runner
    
    Arg
    
    Cmd
    
    Term
    
    Os_utils
    
    Path_location
    
    Error_handling
    
    Let_syntax
    
    Let_syntax
    
    Monad_syntax
- Library dkml-install-runner.admin
  - Dkml_install_runner_admin
- Library dkml-install-runner.user
  - Dkml_install_runner_user
- Sources
  - dkml-install-runner
    
    cmdliner_common.ml
    
    cmdliner_runner.ml
    
    dkml_install_runner.ml
    
    dkml_install_runner__.ml
    
    error_handling.ml
    
    host_abi.ml
    
    ocaml_abi.ml
    
    os_utils.ml
    
    path_eval.ml
    
    path_location.ml
    
    types.ml
  - dkml-install-runner.admin
    
    dkml_install_runner_admin.ml
  - dkml-install-runner.user
    
    dkml_install_runner_user.ml

Legend:
Page
Library
Module
Module type
Parameter
Class
Class type
Source

Module `Dkml_install_runner.Cmdliner_runner`Source

module Arg = Cmdliner.Arg

module Cmd = Cmdliner.Cmd

module Term = Cmdliner.Term

Source

val help : 
  [> `Pager ] as 'a ->
  string list ->
  string option ->
  [> `Error of bool * string | `Help of 'a * string option | `Ok of unit ]

Sourceval help_secs : [> `P of string | `S of string ] list

Source

val setup_log : 
  Fmt.style_renderer option ->
  Logs.level option ->
  Dkml_install_api.Log_config.t

Sourceval setup_log_t : Dkml_install_api.Log_config.t Term.t

Source

val create_context : 
  install_direction:Dkml_install_register.install_direction ->
  staging_default:Path_location.staging_default ->
  target_abi:Dkml_install_api.Context.Abi_v2.t ->
  string ->
  Dkml_install_register.Component_registry.t ->
  Dkml_install_api.Log_config.t ->
  Fpath.t ->
  Fpath.t ->
  string option ->
  string option ->
  Dkml_install_api.Context.t Dkml_install_api.Forward_progress.t

Sourceval quote : string -> string

Sourceval err_no : string -> string -> string

Sourceval err_not_dir : string -> string

Sourceval raw_pp_str : Format.formatter -> string -> unit

Source

val raw_dir : 
  (string ->
  [> `Error of string | `Ok of string ])
  * (Format.formatter ->
  string ->
  unit)

Sourceval prefix_dir_t : Fpath.t Term.t

Sourceval exec_dir : Fpath.t

Directory containing dkml-package.bc or whatever executable (perhaps a renamed setup.exe in a non-bin folder) is currently running.

Sourceval enduser_archive_dir : unit -> Fpath.t Dkml_install_api.Forward_progress.t

The root directory that was uncompressed at end-user install time

Sourceval staging_default_dir_for_package : archive_dir:Fpath.t -> Fpath.t

staging_default_dir_for_package ~archive_dir. For the benefit of Windows and macOS we keep the directory name ("sg") small.

Sourceval static_default_dir_for_package : archive_dir:Fpath.t -> Fpath.t

static_default_dir_for_package ~archive_dir. For the benefit of Windows and macOS we keep the directory name ("st") small.

Sourceval staging_files_opt_t : string option Cmdliner.Term.t

Sourceval static_files_opt_t : string option Cmdliner.Term.t

Sourceval opam_context_opt_t : string option Cmdliner.Term.t

Source

val staging_files_source_for_package_t : 
  Path_location.staging_files_source Dkml_install_api.Forward_progress.t Term.t

staging_files_source_for_package_t is the setup.exe/uninstall.exe Term.t for the staging files directory. It defaults to the sibling directory "staging".

Source

val static_files_source_for_package_t : 
  Path_location.static_files_source Dkml_install_api.Forward_progress.t Term.t

static_files_source_for_package_t is the setup.exe/uninstall.exe Term.t for the static files directory. It defaults to the sibling directory "static".

Source

val unwrap_progress_t : 
  default:'a ->
  'a Dkml_install_api.Forward_progress.t Term.t ->
  'a Term.t

Source

val unwrap_progress_nodefault_t : 
  'a Dkml_install_api.Forward_progress.t Term.t ->
  'a Term.t

Source

val ctx_for_runner_t : 
  install_direction:Dkml_install_register.install_direction ->
  target_abi:Dkml_install_api.Context.Abi_v2.t ->
  string ->
  Dkml_install_register.Component_registry.t ->
  Dkml_install_api.Context.t Term.t

ctx_for_runner_t component_name reg creates a user.exe/admin.exe Term for component component_name that sets up logging and any other global state, and defines the context record.

The package (setup.exe/uninstall.exe) will typically use sudo on Unix or gsudo on Windows to elevate the privileges of `admin.exe`. However it is very unlikely that the environment variables are propagated from the user (setup.exe) to the elevated process (admin.exe). So the staging directory must be specified (`No_staging_default`) when the runner user.exe/admin.exe is launched.

That is, the user process setup.exe can pass its environment variable OPAM_SWITCH_PREFIX (if specified with the no argument `--opam-context` option of setup.exe) into the staging directory argument for admin.exe.

Source

val ctx_for_package_t : 
  install_direction:Dkml_install_register.install_direction ->
  target_abi:Dkml_install_api.Context.Abi_v2.t ->
  string ->
  Dkml_install_register.Component_registry.t ->
  Dkml_install_api.Context.t Term.t

ctx_for_package_t component_name reg creates a setup.exe/uninstall.exe Term for component component_name that sets up logging and any other global state, and defines the context record.

Unlike ctx_for_runner_t the expectation is that setup.exe/uninstall.exe will be directly launched by the user and have access to the user's environment variables, especially OPAM_SWITCH_PREFIX. So the no argument --opam-context option of setup.exe can default to OPAM_SWITCH_PREFIX.

Unlike ctx_for_runner_t the staging directory has a default (`Staging_default_dir`) based on relative paths from setup.exe.

Source

val to_selector : 
  string list ->
  Dkml_install_register.Component_registry.component_selector

Source

val component_selector_t : 
  install_direction:Dkml_install_register.install_direction ->
  string list Cmdliner.Term.t

Source

val common_runner_args : 
  log_config:Dkml_install_api.Log_config.t ->
  prefix_dir:Fpath.t ->
  staging_files_source:Path_location.staging_files_source ->
  string array

Sourceval help_cmd : unit Cmd.t

Source

val eval_progress : 
  unit Dkml_install_api.Forward_progress.t Cmd.t ->
  Cmd.Exit.code

package dkml-install-runner

Module Dkml_install_runner.Cmdliner_runnerSource

Module `Dkml_install_runner.Cmdliner_runner`Source