license¶
vb license SUBCOMMAND [OPTIONS]
Description¶
Manage project and third-party SDK licenses.
Subcommands¶
vb license add (update)¶
vb license add|update LICENSENAME [OPTIONS] [KEY=VALUE] ...
Description¶
Add or update a license. KEY=VALUE pairs set fields or labels. If the
same field is set by both an option and KEY=VALUE, the option wins.
Special keys (case insensitive): version, type, homepage,
checkin. All other keys are treated as label keys and can be repeated.
A single argument may also contain multiple labels separated by ,.
Label syntax: KEY is 1-63 chars of [A-Z a-z 0-9 _ . -] and must start/end
with alnum; KEY must not be in or notin. VALUE is empty or 1-63 chars
of [A-Z a-z 0-9 _ . -] (no spaces) and must start/end with alnum.
For update, KEY= (or KEY=””) deletes that label. When using
comma-separated labels, VALUE must not contain ,. LICENSENAME must
be a well-formed license name: 1-100 characters, no leading/trailing
spaces, no control characters (tab/newline), and no consecutive spaces.
Options¶
- -f, --file FILE¶
Path to the license content file.
- -v, --version VERSION¶
SDK version.
- -t, --type TYPE¶
License type, such as MIT, BSD, GPL, etc.
- -h, --homepage URL¶
SDK homepage URL.
- -c, --checkin HASH¶
Check-in hashes associated with the license (space or
,separated).
vb license remove¶
vb license remove LICENSENAME VALUE ...
Description¶
remove one or more fields from a license. VALUEs include version,
type, homepage, checkins, labels or a specific label name.
vb license enable (disable)¶
vb license enable|disable LICENSENAME
Description¶
Mark a license as disable, or enable a previously disable license.
vb license import¶
vb license import FILE...
Description¶
Import licenses from TOML export files. Existing licenses are updated in place; missing licenses are created. Checkins entries are validated as checkins and stored in long-hash form; labels are upserted
vb license export¶
vb license export [LICENSENAME] [OPTIONS]
Description¶
Export licenses to stdout or a file in toml, text, json, or xlsx format.
By default, all licenses are exported. Use
-t|--type to choose the format (toml,
text, json, xlsx). Use -o|--output
to write to a file (required for xlsx).
Options¶
- -t, --type TYPE¶
Export type, such as
toml,text,json,xlsx.
- -o, --output FILE¶
Output file path.
- -f, --format FORMAT¶
Entry format. If
--typeistoml, license labels must appear at the end. A string which can contain the following placeholders:%n license name %d date %u last changed user %v license version %t license type %h license homepage %c license content %C Checkin hash %L license label %N Newline (only for text export)
- --date DATE_FORMAT¶
Specify the output date format. Allowed values include:
iso ISO-8601 timestamp. short Date only, YYYY-MM-DD. rfc RFC822 format.
vb license ls (list)¶
vb license ls|list [OPTIONS]
Description¶
List licenses.
Options¶
- -F, --format FORMAT¶
Entry format. A string which can contain the following placeholders:
%n license name %d date %u last changed user %v license version %t license type %h license homepage %N Newline
- --date DATE_FORMAT¶
Specify the output date format. Allowed values include:
iso ISO-8601 timestamp. short Date only, YYYY-MM-DD. rfc RFC822 format.
Filter options¶
- --all¶
include disabled licenses.
- --disabled¶
only show disabled licenses.
- --verbose¶
show License content in the listing.
- --type TYPE¶
filter by type.
- --checkin HASH¶
filter by checkin.
- --label SELECTOR¶
filter by label selector (key, !key, key=value, key!=value, key in (v1,v2), key notin (v1,v2)); use
,for AND;typeis treated as a special label.
Examples¶
Create a repository
$ vb init license_repo.vbyte
project-id: 9aefea11724b22b918953fda83f7b2c6e65492dc
server-id: acfd43d2f0dbc5ced05649c8619532fc3eb63799
admin-user: ubuntu (initial remote-access password is "yaUerTAfs9")
$ vb open -f license_repo.vbyte
project-name: <unnamed>
repository: /tmp/sphinx_tests/68672033/license_repo/license_repo.vbyte
local-root: /tmp/sphinx_tests/68672033/license_repo/
config-db: /tmp/sphinx_tests/68672033/.visionbyte
project-code: 9aefea11724b22b918953fda83f7b2c6e65492dc
checkout: 328e885624c0c7ac7050cebdffc25bb84b252894 2026-03-31 13:00:25 UTC
tags: trunk
comment: initial empty check-in (user: ubuntu)
check-ins: 1
Add zlib license
$ vb sys cat LICENSE-zlib
Copyright notice:
(C) 1995-2022 Jean-loup Gailly and Mark Adler
This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.
Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not
claim that you wrote the original software. If you use this software
in a product, an acknowledgment in the product documentation would be
appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be
misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.
Jean-loup Gailly Mark Adler
jloup@gzip.org madler@alumni.caltech.edu
$ vb license add zlib -f LICENSE-zlib -t zlib -h "https://zlib.net/"
License zlib added
Import libuv license from a toml file
$ vb sys cat LICENSE-libuv.toml
[libuv]
Name="libuv"
Version="1.5.10"
Type="MIT"
Homepage="https://github.com/libuv/libuv"
License="""
Copyright (c) 2015-present libuv project contributors.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to
deal in the Software without restriction, including without limitation the
rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
sell copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
IN THE SOFTWARE.
"""
[libuv.Labels]
Targets="CLI"
Notes="Asynchronous_IO"
$ vb license import LICENSE-libuv.toml
Successfully created license libuv
Update zlib license type and version
$ vb license update zlib -t "Zlib License" -v 1.3.1
License zlib updated
Remove libuv version information
$ vb license remove libuv version
Successfully removed specified fields from license libuv
List all licenses with default format
$ vb license ls
Name: zlib
Type: Zlib License
Version: 1.3.1
Homepage: https://zlib.net/
Name: libuv
Type: MIT
Version:
Homepage: https://github.com/libuv/libuv
Export zlib license to stdout
$ vb license export zlib
Name:zlib
Version:1.3.1
Type:Zlib License
Homepage:https://zlib.net/
User:ubuntu
Date:2026-03-31 13:00:25
Checkins:
License:
Copyright notice:
(C) 1995-2022 Jean-loup Gailly and Mark Adler
This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.
Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not
claim that you wrote the original software. If you use this software
in a product, an acknowledgment in the product documentation would be
appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be
misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.
Jean-loup Gailly Mark Adler
jloup@gzip.org madler@alumni.caltech.edu
Export zlib license to TOML format
$ vb license export zlib -t toml
[zlib]
Name="zlib"
Version="1.3.1"
Type="Zlib License"
Homepage="https://zlib.net/"
User="ubuntu"
Date="2026-03-31 13:00:25"
License="""
Copyright notice:
(C) 1995-2022 Jean-loup Gailly and Mark Adler
This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.
Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not
claim that you wrote the original software. If you use this software
in a product, an acknowledgment in the product documentation would be
appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be
misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.
Jean-loup Gailly Mark Adler
jloup@gzip.org madler@alumni.caltech.edu
"""
Disable libuv license
$ vb license ls -F "%n"
zlib
libuv
$ vb license disable libuv
Saved new control artifact 23f4999c6ba289cce8ff7c7939d8549642ecdb13dd4461b1c080a669ec0f388a (RID 6).
license libuv disable
Enable libuv license
$ vb license enable libuv
Saved new control artifact 39512c0d18459c45c1c4fd029260e7a06566165ad0d82741d6b9a0fc6a00e15e (RID 7).
license libuv enable
Filter licenses by type
$ vb license ls -type "MIT"
Name: libuv
Type: MIT
Version:
Homepage: https://github.com/libuv/libuv
Filter licenses with a label selector: MIT type and an existing ‘Notes’ label.
$ vb license update libuv Notes=Asyc_IO
License libuv updated
$ vb license ls --label "type=MIT, Notes"
Name: libuv
Type: MIT
Version:
Homepage: https://github.com/libuv/libuv