Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/calibreapp/cli
Calibre’s Node.js API and Command Line Client (CLI).
https://github.com/calibreapp/cli
calibre cli nodejs
Last synced: about 2 months ago
JSON representation
Calibre’s Node.js API and Command Line Client (CLI).
- Host: GitHub
- URL: https://github.com/calibreapp/cli
- Owner: calibreapp
- License: mit
- Created: 2017-09-27T05:33:50.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2024-08-01T18:16:56.000Z (about 2 months ago)
- Last Synced: 2024-08-01T20:44:24.276Z (about 2 months ago)
- Topics: calibre, cli, nodejs
- Language: JavaScript
- Homepage: https://calibreapp.com/node-api
- Size: 3.68 MB
- Stars: 132
- Watchers: 6
- Forks: 17
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Calibre’s Node.js API and Command Line Client (CLI)
[](https://www.npmjs.com/package/calibre)
[](https://github.com/calibreapp/cli/blob/main/LICENSE)
This repository contains [Calibre’s](https://calibreapp.com/) APIs you can use to fetch and manage your monitoring data. The Command Line Client (CLI) is designed for simple tasks right from your terminal. We recommend using the Node.js API for more complex tasks and automation.
> ℹ️ **Please note:** Using the APIs requires an active Calibre account (in trial or on a paid plan).
## 🖇 Table of Contents
1. [Installation](#-installation)
2. [Authentication](#-authentication)
3. [Features](#-features)
4. [Usage](#-usage)
5. [Package Exports](#-package-exports)
6. [Script Examples](#-script-examples)
7. [Contributing](#-contributing)
8. [Resources](#-resources)
9. [License](#-license)
## 📥 Installation
To install the latest version globally, run this command:
```bash
npm install -g calibre
```
or save it directly to your project:
```bash
npm install calibre --save
```
The `calibre` package is built to support **all current Node.js LTS releases**.
## 🔐 Authentication
To authenticate to Calibre and use the APIs, **you will need to create or use an existing API Token**. Learn about the [types of API Tokens and how to create them here](https://calibreapp.com/docs/account-and-billing/manage-api-tokens).
Once you have an API Token, you can [store it locally](https://calibreapp.com/docs/automation/tokens#store-a-token-locally):
```bash
calibre token set
```
Or alternately, set [`CALIBRE_API_TOKEN` environment variable](https://calibreapp.com/docs/automation/tokens#store-a-token-as-an-environment-variable).
## 💡 Features
- **Manage performance with a single command**. Retrieve all speed data and manage the test environment and settings.
- **Run [Single Page Tests](https://calibreapp.com/docs/automation/single-page-tests)**. Create one-off tests privately or share them with your team.
- **Monitor speed across your release process**. Track performance between deploys and mark them on your charts.
- **Use Calibre within CI/CD**. Every command has a `--json` flag for machine-readable output.
- **Script any action**. We export all API methods to the Calibre `npm` package..
## 🛠 Usage
To see a full list of available commands, subcommands and options run:
```bash
$ calibre --help
$ calibre --help
```
or [see all commands](CLI_COMMANDS.md) in this repository or [Calibre’s documentation](https://calibreapp.com/docs/automation/cli-commands).
In Node, you can use the either ES Modules or CommonJS versions accordingly:
```javascript
// ES Modules
import { Site } from 'calibre'
await Site.list()
```
```javascript
// CommonJS
const { Site } = require('calibre')
await Site.list()
```
## 📤 Package exports
In addition to the named default exports shown above, the `calibre` package also exports CLI related metadata, which is used to generate CLI documentation.
### CLI Commands
Each CLI command is a Node module that exports `command`, `describe`, `handler` and `builder`. You can import all CLI commands from `calibre/cli-commands` (see [`src/cli.js`](https://github.com/calibreapp/cli/blob/main/src/cli.js) for reference).
```javascript
import Commands from 'calibre/cli-commands'
```
### CLI Metadata
You can import command metadata (used to generate CLI documentation) from the `calibre/cli-metadata` export:
```javascript
import { getCommandMetaData } from 'calibre/cli-metadata'
console.log(JSON.stringify(getCommandMetaData(), null, 2))
```
## 🙌🏻 Contributing
Happy to hear you’re interested in contributing to Calibre’s APIs! Please find our contribution guidelines [here](CONTRIBUTING.md).
## 🖥 Script Examples
We prepared a handful of examples for common actions you might want to perform:
- [Node.js examples](examples/nodejs)
- [Bash examples](examples/bash)
## 📚 Resources
Find code examples and more information for the [CLI](https://calibreapp.com/docs/automation/cli) and [Node.js API](https://calibreapp.com/docs/automation/node) in our documentation.
## 💼 License
This project is [MIT licensed](LICENSE).