Crate perl_lsp_launcher 

CLI and startup configuration primitives for the Perl LSP binary.

This crate extracts the runtime launch decision surface into a dedicated crate so feature profiles, transport mode semantics, and BDD-grid interoperability stay in one place and remain stable across binaries.

Re-exports

pub use timing::StartupReport;

pub use timing::StartupTimer;

Modules

timing

Lightweight startup phase timer for profiling server initialization.

Structs

LaunchConfig

Canonical launch configuration consumed by the server runtime.

LaunchPlan

Fully resolved launch request.

LspArgs

Command line arguments for the Perl LSP binary.

TransportArgs

Transport options shared by server binaries.

Enums

FeatureProfile

Known feature profiles for runtime capability selection.

LaunchAction

Runtime action selected by CLI parsing.

LaunchParseError

Parse-time errors emitted by the CLI parser.

TransportMode

How the server should connect to the editor or test client.

Constants

DEFAULT_LSP_PORT

Default port used by socket transport.

Functions

catalog_advertised_feature_ids

Return advertised feature IDs from the current profile, intersecting with the catalog so this API remains aligned to the BDD grid.

compliance_percent_for_profile

Compliance percent for a specific runtime profile, using the same grid semantics.

format_health_output

Format a colored health status line.

format_info_output

Format the --info output block.

format_startup_banner

Format the one-line process-start banner written to stderr before the LSP handshake.

help_text

Human-readable CLI help text shared by CLI consumers.

init_logging

Initialize tracing once for the current process.

log_server_startup

Emit a consistent startup log line for server binaries.

logging_filter

Resolve the effective tracing filter for the current process.

parse_args

Parse command line arguments for the Perl LSP launcher.

port_in_use_message

Produce a user-friendly message when the TCP port is already in use.

shell_completion

Generate shell completion script for the given shell name.

should_enable_logging

Returns whether runtime logging should be enabled.

startup_banner

Emit the process-start banner to stderr.

to_json_for_profile

Profile-aware feature catalog JSON.

trackable_feature_count_for_grid

Number of BDD rows that participate in coverage accounting.