`gelx_cli`

A command-line interface for gelx to generate fully typed Rust code from your Gel schema and query files.

Installation

The gelx_cli is distributed as part of the gelx workspace. To use it, you can build the workspace and then run the gelx binary from the target directory, or install it using cargo:

cargo install gelx_cli

Alternatively, you can install it directly from the github repo:

cargo install --git https://github.com/ifiokjr/gelx.git gelx_cli

Ensure your Gel instance is running and accessible, as the CLI needs to connect to it to introspect the schema and query types.

Run gelx help to see the available commands and options.

Generate fully typed rust code from your gel schema and inline queries.

Usage: gelx [OPTIONS] <COMMAND>

Commands:
  generate  Generates Rust code from the crate in the current directory
  check     Checks if the generated Rust code is up-to-date
  help      Print this message or the help of the given subcommand(s)

Options:
      --cwd <CWD>  Optional working directory to run the command from
  -h, --help       Print help
  -V, --version    Print version

Global Options

--cwd <path>: Specifies a working directory to run the command from. If provided, gelx will change to this directory before performing any operations. This is useful if you are invoking gelx from a directory different from your project's root.

Usage

The gelx CLI tool generates Rust code from .edgeql files located in your project. It reads configuration from your crate's Cargo.toml file, specifically under the [package.metadata.gelx] section.

Commands

`gelx generate`

Generates Rust code from the crate in the current directory

Usage: gelx generate [OPTIONS]

Options:
      --stdout     Print the generated code to stdout instead of writing to a file
      --cwd <CWD>  Optional working directory to run the command from
  -h, --help       Print help

This command generates Rust code based on your .edgeql query files and the Gel schema.

gelx generate --cwd path/to/your/crate

Or run the command with the --stdout flag to print the generated code to the terminal:

gelx generate --cwd path/to/your/crate --stdout

The CLI will:

Read configuration from [package.metadata.gelx] in your Cargo.toml.
Scan the directory specified by queries (default: ./queries) for .edgeql files.
Connect to your Gel instance to get type information for each query.
Generate corresponding Rust modules.
If --stdout is used, print the combined code to the terminal.
Otherwise, write the combined code to the file specified by output_file (default: ./src/gelx_generated.rs).

`gelx check`

Checks if the generated Rust code is up-to-date

Usage: gelx check [OPTIONS]

Options:
      --cwd <CWD>  Optional working directory to run the command from
  -h, --help       Print help

This command verifies if the currently generated code is up-to-date with your schema and query files. It's useful for CI pipelines to ensure that code generation has been run after any changes.

gelx check --cwd path/to/your/crate

The CLI will:

Perform the same generation process as gelx generate in memory.
Compare the newly generated code with the content of the existing output_file.
If they match, it will exit successfully (status code 0).
If they differ, it will print an error message and exit with a non-zero status code, indicating that gelx generate needs to be run.

Configuration

The gelx CLI reads its configuration from the Cargo.toml file of the crate it is being run in. The configuration should be placed under the [package.metadata.gelx] table.

Refer to the main gelx crate readme.md for all the configuration options.

Contributing

This crate is part of the gelx workspace. Please refer to the main project's contributing guide for details on how to set up the development environment and contribute.

License

Unlicense, see the license file in the root of the workspace.

gelx_cli 0.5.1

gelx_cli