Squirrelix.CLI (Squirrelix v0.1.0)

Copy Markdown View Source

Project discovery and PostgreSQL connection helpers.

This module mirrors upstream Squirrel CLI behaviour using Elixir data structures: maps for discovered files, structs for connection options, and {:ok, _} / {:error, reason} tuples for fallible operations.

Summary

Types

discovered_sql_files()

Functions

connection_options_from_variables(env, project_name)
directory_to_output_file(directory)
discover_sql_directories(path)

Recursively finds sql/ directories and their .sql files under path.

parse_connection_url(raw)
query_directories(root)
query_files(root)

Types

discovered_sql_files()

@type discovered_sql_files() :: %{required(Path.t()) => [Path.t()]}

Functions

connection_options_from_variables(env, project_name)

@spec connection_options_from_variables(map(), String.t() | nil) ::
  Squirrelix.ConnectionOptions.t()

directory_to_output_file(directory)

@spec directory_to_output_file(String.t()) :: String.t()

discover_sql_directories(path)

@spec discover_sql_directories(Path.t()) :: discovered_sql_files()

Recursively finds sql/ directories and their .sql files under path.

Returns a map of directory paths to sorted SQL file paths.

parse_connection_url(raw)

@spec parse_connection_url(String.t()) ::
  {:ok, Squirrelix.ConnectionOptions.t()} | {:error, :invalid_url}

query_directories(root)

@spec query_directories(Path.t()) :: [Squirrelix.QueryDirectory.t()]

query_files(root)

@spec query_files(Path.t()) :: discovered_sql_files()