feat: add Paragon build-tokens command using tutor custom jobs #2
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
This pull request introduces the initial implementation of the
paragon build-tokensCLI command within the Tutor plugin ecosystem. It leverages a lightweight Docker container and Tutor's custom job framework to facilitate the building of Paragon design tokens.Key Changes
Docker and Build Process
paragon-builder): Added a Dockerfile for the Paragon Builder, which uses a Node.js Alpine base image to install the Paragon CLI and execute theme builds.entrypoint.sh): Added a script to handle argument parsing and the theme compilation, it integrates with tutor jobs execution framework.paragon-builder-jobservice inlocal-docker-compose-jobs-servicesto run theme builds as Docker-based jobs.Command Execution
docommand (build_tokens) inplugin.pyto enable the flexible theme building via the Tutor CLI. This command supports options for source-only builds, token references, specific themes, and verbose logging.Usage Instructions
Build the Docker Image:
After installing and enabling the plugin, build the Docker image with the following command:
Run the Build Job:
Execute the build job using:
Note: A comprehensive list of available options for the
build-tokenscommand can be found in theREADME.rstfile.