Kopo Cli 🐶

A Deno registry browser in the terminal

Description

kopo is a tool, which helps you browse the Deno registries in your terminal, search for a specific module.

It currently supports deno.land/x and x.nest.land.

Usage

Run from the url:

deno run --unstable --allow-net https://deno.land/x/kopo

or install it like:

deno install --unstable --allow-net -f https://deno.land/x/kopo kopo

Features

Features depend on the capabilities of the browsed module repository.

deno.land/x

• Browse a paginated list of the modules
• Search through the modules with a keyword
• Display basic information about the module
• Show the raw README of the module, if one exists in the module’s repo
• Show the parsed flags from the README if provided.

x.nest.land

• Browse a paginated list of the modules
• Search through the modules with a keyword
• Display basic information about the module

🚩 Flags

🚧 This is just an experimental feature 🚧

This proposes a concept, where each module describes what are its required and optional flags in a parseable way.

How it works

The parser is here

Currently it searches for markdown table rows, which contain 2 or 3 columns.

• The first column needs to contain the flag inside backticks like ( --unstable ). things can be before it in the column, but not after, besides one space char.
• The second column indicates, whether the flag is required (*) or optional (empty). Putting _ in this column tells the parser to ignore the row.
• The optional third column can serve as a description why the flag is needed.

A table could look something like this: