GitLab
How to use GitLab as your jsrepo registry.
Branches and Tags
jsrepo supports GitLab so that you can just paste a link to the repo homepage and it will be handled correctly.
Because of this all of the following paths work:
https://gitlab.com/ieedan/std # default branch shorthand
https://gitlab.com/ieedan/std/-/tree/v1.5.0 # tag reference
https://gitlab.com/ieedan/std/-/tree/next # branch reference
Using Tags for Versioning
Tags can be a great solution to ensuring remote tests and blocks stay on a consistent version.
{
"$schema": "https://unpkg.com/jsrepo@1.27.0/schemas/project-config.json",
// use a specific version tag
"repos": ["https://gitlab.com/ieedan/std/-/tree/v1.5.0"],
"path": "src/blocks",
"includeTests": false,
"watermark": true,
"formatter": "prettier",
"paths": {
"*": "./src/blocks"
}
}
Tags do not however work like npm packages. Tags are completely mutable meaning a malicious registry could publish over a tag with different code.
This is why it's always important to make sure you trust the owner of the registry.
gitlab Shorthand
When referencing GitLab as the provider you can use the gitlab shorthand in place of https://gitlab.com.
Example:
In the jsrepo.json:
{
"$schema": "https://unpkg.com/jsrepo@1.27.0/schemas/project-config.json",
// use gitlab instead of https://gitlab.com
"repos": ["gitlab/ieedan/std"],
"path": "src/blocks",
"includeTests": false,
"watermark": true,
"formatter": "prettier",
"paths": {
"*": "./src/blocks"
}
}