Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
play

GitHub Action

cargo-generate

v0.11.0

cargo-generate

play

cargo-generate

Run cargo-generate

Installation

Copy and paste the following snippet into your .yml file.

 
              
- name: cargo-generate

              
  uses: cargo-generate/[email protected]
Learn more about this action in cargo-generate/cargo-generate-action

Choose a version

cargo-generate GitHub Action

This action is used to run the cargo-generate tool in order to expand a template.

This is pushed to docker hub cargogenerate/cargo-generate-action.

Inputs

name

Required

This is the name of the project being expanded.

template

This is the URL/path to the repository holding the template. Defaults to .

branch

Branch for cloning the template.

subfolder

Subfolder within the template repository that'll be used as the template.

template_values_file

Specifies a file holding the values required for template expansion.

NOTE: cargo-generate is being run with the --silent option, so it will fail if any values are undefined during expansion.

other

This can be used to specify any other option for cargo-generate.

Example:

other: "--define foo=\"value\" --define bar=42"

Example

name: Try to expand local template using cargo-template
on:
  push:

jobs:
  build:
    runs-on: ubuntu-latest
    env:
      PROJECT_NAME: mytemplate
    steps:
      - uses: actions/checkout@v2
      - uses: cargo-generate/[email protected]
        with:
          name: ${{ env.PROJECT_NAME }}
      - uses: actions-rs/toolchain@v1
        with:
          toolchain: stable
      # we need to move the generated project to a temp folder, away from the template project
      # otherwise `cargo` runs would fail 
      # see https://github.com/rust-lang/cargo/issues/9922
      - run: |
          mv $PROJECT_NAME ${{ runner.temp }}/
          cd ${{ runner.temp }}/$PROJECT_NAME
          cargo check