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:search is the same command. In a product with a feature called search, that name belongs to the feature.

Live mode calls the forge API. Set SPLENT_FORGE_TOKEN, or GITHUB_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


Back to top

splent. Distributed by an LGPL license v3. Contact us: drorganvidez@us.es