marketplace:search
Introduction
marketplace:search finds features in the marketplace index. The index knows every feature’s contract, so you can ask which features provide a service or need another feature.
splent marketplace:search notes
Marketplace search · 'notes'
────────────────────────────────────────────────────────────────────────
● notes 1.4.0 full Notes owned by their author
notes_tags 0.0.1 full Tags on notes, and the notes of a tag
2 feature(s) · index from cache · details: splent feature:info <name>
The query matches the name, description, tags and provided services and models. ● marks the features your selected product already has.
Filtering by contract
splent marketplace:search --provides GalleryService
splent marketplace:search --requires notes
splent marketplace:search --archetype service
--provides takes the exact name of a route, service, model, hook or signal, and --requires a feature’s short name. Filters combine with AND.
Getting a fresh index
splent marketplace:search --refresh
The local copy, .splent_cache/marketplace/index.json, is used whenever it exists. SPLENT_INDEX_URL is fetched only when there is no copy, or with --refresh. To build an index yourself, run marketplace:index.
Listing a forge organisation live
splent marketplace:search --org my-org
With --org or --all, it skips the index and lists the repositories on the forge with their latest release. The query then matches the repository name, and the other filters do not apply. With no index at all, it lists splent-io this way.
Advanced
feature:searchis the same command. In a product with a feature calledsearch, that name belongs to the feature.
Live mode calls the forge API. Set
SPLENT_FORGE_TOKEN, orGITHUB_TOKEN, to raise the rate limit and see private repositories.
Reference
| Argument or option | Description |
|---|---|
QUERY |
Text to look for. Optional |
--category TEXT |
Filter by contract category |
--archetype |
Filter by archetype, full, light, service or config |
--tag TEXT |
Filter by contract tag |
--provides NAME |
Filter by a provided route, service, model, hook or signal |
--requires SHORT |
Filter by a required feature’s short name |
--refresh |
Fetch the index again from SPLENT_INDEX_URL |
--org ORG |
List this forge organisation live instead of searching the index |
--all |
Live mode. Show every repository of the organisation, splent-io without --org |
See also
feature:infoshows one feature’s contract.marketplace:indexbuilds the index.