🌠 Asterism

Asterism is a CLI that provides a set of tools to build a Orama instance from your favorite database.

🚀 Getting Started

📦 Installation

# You can install Orama using `npm`, `yarn`, `pnpm`:
npm install -g @mateonunez/asterism

📝 Usage

Asterism provides a CLI that can be used to generate a Orama instance from a database. The CLI can be used as follows:

Usage: asterism [options] [command]

Asterism CLI

Options:
  -v, --version                 output the current version
  -h, --help                    display help for command

Commands:
  migrate [options] [database]  Initialize a new Orama instance from your
                                current database
  search [options] [term]       Search for a Orama instance in your instances
  help [command]                display help for command

🧩 Migrate

# asterism migrate --help

Usage: asterism migrate [options] [database]

Initialize a new Orama instance from your current database

Arguments:
  database                           The database to migrate

Options:
  -H, --host <host>                  Database host (default: "127.0.0.1")
  -p, --port <port>                  Port to run the server on (default: "3306")
  -d, --databaseName <databaseName>  Database connection string
  -t, --tableName <tableName>        Table name
  -u, --user <user>                  Database user (default: "root")
  -w, --password <password>          Database password (default: "toor")
  -o, --outputDir <outputDir>        Output directory (default: "./out")
  -s, --strict <strict>              Strict mode (default: "false")
  --help                             display help for command

The CLI provides a migrate command that can be used to generate a Orama instance from a database. The command can be used as follows:

> asterism migrate

🔎 Search

# asterism search --help

Usage: asterism search [options] [term]

Search for a Orama instance in your instances

Arguments:
  term                          The term to search for

Options:
  -c, --cacheDisabled           Disable cache
  -i, --inputDir <inputDir>     Orama databases directory (default: "./orama")
  -o, --outputDir <outputDir>   Output directory to save results in a JSON
                                (default: "./out")
  -h, --help                    display help for command

The CLI provides a search command that can be used to search a term in your instances. The command can be used as follows:

> asterism search "john"

⚠️ Testing

Asterism needs a database to run the tests. At first run the docker-compose file.

docker-compose up -d

Then, run the tests using npm, yarn or pnpm:

npm run test

📝 License

MIT