package dkml-package-console

You can search for identifiers within the package.

in-package search v0.2.0

On This Page

Error Handling
Author Supplied Types
Running Programs
Installation Paths
Command Line Processing

dkml-package-console
- Library dkml-package-console.common
  - Dkml_package_console_common
    
    Author_types
    
    Windows_registry
    
    Add_remove_programs
- Library dkml-package-console.create
  - Dkml_package_console_create
- Library dkml-package-console.entry
  - Dkml_package_console_entry
- Library dkml-package-console.setup
  - Dkml_package_console_setup
- Library dkml-package-console.uninstaller
  - Dkml_package_console_uninstaller
- Sources
  - dkml-package-console.common
    
    author_types.ml
    
    dkml_package_console_common.ml
    
    dkml_package_console_common__.ml
    
    error_utils.ml
    
    spawn.ml
    
    windows_registry.ml
  - dkml-package-console.create
    
    dkml_package_console_create.ml
    
    dkml_package_console_create__.ml
    
    installer_archive.ml
    
    installer_sfx.ml
    
    manifests.ml
    
    populate_archive.ml
    
    seven_z.ml
    
    shell_scripts.ml
  - dkml-package-console.entry
    
    dkml_package_console_entry.ml
  - dkml-package-console.setup
    
    dkml_package_console_setup.ml
  - dkml-package-console.uninstaller
    
    dkml_package_console_uninstaller.ml

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

Module `Dkml_package_console_common`Source

Sourceval console_component_name : string

console_component_name is the name of the component that has executables that help run console installers (like gsudo.exe on Windows to elevate privileges).

Sourceval console_required_components : string list

console_required_components are the names of components that console installers require to be present. It always includes console_component_name but may include other components.

At minimum, these other required components include:

"staging-ocamlrun" because Dkml_package_console_entry.entry uses ocamlrun to run the dkml-package.bc bytecode.

Source

val needs_install_admin : 
  reg:Dkml_install_register.Component_registry.t ->
  selector:Dkml_install_register.Component_registry.component_selector ->
  log_config:Dkml_install_api.Log_config.t ->
  target_abi:Dkml_install_api.Context.Abi_v2.t ->
  prefix_dir:Fpath.t ->
  archive_dir:Fpath.t ->
  staging_files_source:Dkml_install_runner.Path_location.staging_files_source ->
  bool Dkml_install_api.Forward_progress.t

Source

val needs_uninstall_admin : 
  reg:Dkml_install_register.Component_registry.t ->
  selector:Dkml_install_register.Component_registry.component_selector ->
  log_config:Dkml_install_api.Log_config.t ->
  target_abi:Dkml_install_api.Context.Abi_v2.t ->
  prefix_dir:Fpath.t ->
  archive_dir:Fpath.t ->
  staging_files_source:Dkml_install_runner.Path_location.staging_files_source ->
  bool Dkml_install_api.Forward_progress.t

Error Handling

Sourceval get_ok_or_failwith_string : ('a, string) result -> 'a

Sourceval get_ok_or_failwith_rresult : ('a, Rresult.R.msg) result -> 'a

Sourceval box_err : string -> 'a

Author Supplied Types

Sourcemodule Author_types : sig ... end

Sourceval version_m_n_o_p : string -> string

ver_m_n_o_p ver converts the version ver into the "mmmmm.nnnnn.ooooo.ppppp" format required by an Application Manifest.

Confer https://docs.microsoft.com/en-us/windows/win32/sbscs/application-manifests#assemblyidentity

Running Programs

Source

val spawn : 
  ?err_ok:bool ->
  Bos.Cmd.t ->
  unit Dkml_install_api.Forward_progress.t

spawn ?err_ok cmd launches the command cmd and waits for its response.

Use err_ok = true if you want to log errors but continue.

Source

val elevated_cmd : 
  target_abi:Dkml_install_api.Context.Abi_v2.t ->
  staging_files_source:Dkml_install_runner.Path_location.staging_files_source ->
  Bos.Cmd.t ->
  Bos.Cmd.t Dkml_install_api.Forward_progress.t

elevated_cmd ~target_abi ~staging_files_source cmd translates the command cmd into a command that elevates privileges using "gsudo.exe" from the staging files staging_files_source on Windows machines, or "doas", "sudo" or "su" on the PATH on Unix machines.

Installation Paths

Source

val get_user_installation_prefix : 
  program_name:Author_types.program_name ->
  target_abi:Dkml_install_api__Types.Context.Abi_v2.t ->
  prefix_opt:string option ->
  Fpath.t Dkml_install_api.Forward_progress.t

get_user_installation_prefix ~program_name ~target_abi ~prefix_opt returns where user programs should be installed; either the prefix prefix_opt = Some prefix or uses the platform convention when prefix_opt = None.

Platform Conventions

The user programs would be installed to these locations by default:

Windows: "$env:LOCALAPPDATA\\Programs\\<name_full>" when prefer_spaces = False or "$env:LOCALAPPDATA\\Programs\\<name_camel_case_nospaces>" otherwise. This pattern closely conforms to the standard established by "$env:LOCALAPPDATA\\Programs\\Microsoft VS Code"

macOS: "~/Applications/<name_full>.app" when prefer_spaces = False or "~/Applications/<name_camel_case_nospaces>.app" otherwise.

Linux: If "$XDG_DATA_HOME" is defined then "$XDG_DATA_HOME/<name_kebab_lower_case>" otherwise "$HOME/.local/share/<name_kebab_lower_case>"

Command Line Processing

Sourcetype package_args = {

log_config : Dkml_install_api.Log_config.t;
prefix_opt : string option;
component_selector : string list;
static_files_source : Dkml_install_runner.Path_location.static_files_source;
staging_files_source : Dkml_install_runner.Path_location.staging_files_source;

}

Common options between setup.exe and uninstaller.exe

Source

val package_args_t : 
  program_name:Author_types.program_name ->
  target_abi:Dkml_install_api__Types.Context.Abi_v2.t ->
  install_direction:Dkml_install_register.install_direction ->
  package_args Cmdliner.Term.t

Cmdliner.Term.t for the common options between setup.exe and uninstaller.exe

Sourcemodule Windows_registry : sig ... end

package dkml-package-console

Module Dkml_package_console_commonSource

Error Handling

Author Supplied Types

Running Programs

Installation Paths

Command Line Processing

Module `Dkml_package_console_common`Source