Documentation
🧱 Create an extension

🧱 Create an extension

Valet can be extended to let the user create its own set of commands and libraries.

➕ Create an extension

The core command valet self extend my-extension allows to create a new extension (here named my-extension).

Open the created directory (or cd into it) and start creating your new commands and libraries.

📂 Extensions location and anatomy

Extensions are created as a directory under the Valet user directory (which defaults to ~/.valet.d).

This command will initialize your new extension with the following files:

        • extensions.json
        • settings.json
        • valet.code-snippets
            • lib-valet
            • lib-valet.md
            • .gitignore

          • About these files:

          • .vscode: contains the Visual Studio Code configuration files, will only be created if you have Visual Studio Code installed. See work on bash scripts for more information.
            • extensions.json: contains the list of recommended extensions to install in Visual Studio Code.
            • settings.json: contains the default settings for Visual Studio Code.
            • valet.code-snippets: contains the code snippets for Visual Studio Code. This is a symlink to ~/.valet.d/valet.code-snippets which get created by the valet self document command.
          • commands.d: contains the bash scripts defining the commands of the extension.
          • libraries.d: contains the bash scripts defining the libraries of the extension.
          • tests.d: contains the tests for the commands and libraries of the extension.
          • lib-valet: This is a symlink to ~/.valet.d/lib-valet which get created by the valet self document command. It contains the prototype of each functions defined in Valet libraries.
          • lib-valet.md: This is a symlink to ~/.valet.d/lib-valet.md which get created by the valet self document command. It contains the documentation of each functions defined in Valet libraries.

          🛜 Share your extensions

          To share your extension, make it a git repository with git init, then commit and push your files to a remote Git server such as GitHub.

          Others can then install your extension with the valet self extend command. For instance, the command valet self extend https://github.com/jcaillon/valet-devops-toolbox.git will install the valet-devops-toolbox extension from GitHub.

          ℹ️

          By default, the valet self extend command will install the extension from the latest git reference.

          As a best practice, you should version your extension and always push the latest version to the latest branch.

          You can also install a specific version of the extension by providing the git reference --version my-ref. See valet self extend --help for more options.

          🚧 Install dependencies

          If your extension requires additional dependencies, you can create a extension.setup.sh script at the root of your extension directory.

          This script will be sourced from Valet when installing or updating the extension. You can use Valet functions as if you were coding a command.

          ℹ️
          The user will have the possibility to skip the execution of this script.
          Configuration Create a new command