gobot-mc

This package allows you to use Mc as an npm dependency.

Part of the Gobot project.

Quick run

npx gobot mc --version

Quick use

npm i gobot

import { gobot } from 'gobot'
const bot = await gobot(`mc`)
const exitCode = await bot.run([`--version`])

Basic version locking

npm i gobot-mc

With gobot-mc present, Gobot will default to the mc version corresponding to the gobot-mc version you installed. Now you can use mc as a real dependency.

import { gobot } from 'gobot'
const bot = await gobot(`mc`)
const exitCode = await bot.run([`--version`])

Locking to a specific version

The gobot-mc package version always mirrors the underlying mc version:

npm i gobot-mc@2024.3.30152952

Override the default version imposed by this package

In rare cases, you may want to intentionally run a different version of mc even though gobot-mc is installed.

// Run a specific version (override)
const bot = await gobot(`mc`, { version: `2024.3.30152952` })
const exitCode = await bot.run([`--version`])

// Or the latest version (override)
const bot = await gobot(`mc`, { version: `*` })
const exitCode = await bot.run([`--version`])

Pass environment variables

import { gobot } from 'gobot'
const bot = await gobot(`mc`, {
  env: process.env, // This is not always necessary, but some apps do need it
})
const exitCode = await bot.run([`--version`])

Access the child process

import { gobot } from 'gobot'
const bot = await gobot(`mc`, {
  env: process.env,
})
const exitCode = await bot.run(
  [`--help`],
  { cwd: `./foo` }, // SpawnOptions
  (proc) => {
    // ChildProcess
    proc.stdout.on('exit', (code) => {
      console.log(`process has exited`)
    })
  },
)

Install globally for CLI access

Exactly one gobot-mc can be installed globally. It will receive a bin alias:

npm i -g gobot-mc
mc --help

# Upgrade to  @latest or any version
npm i -g gobot-mc@latest

gobot-mc comes with a bin shortcut for CLI usage.

Mc (https://min.io) runner for Gobot (https://github.com/benallfree/gobot)

Options

Full API docs

mc uses date-based version tags. npm requires semver, so Gobot converts them.

Format:

* Note: M[M] and D[D] are 1 digit for months 1-9 and 2 digits for moths 10-12 because semver doesn't support leading zeros.

Example:

* M[M] is 3 not 03 because it would create a leading 0 in the minor semver part. However, the SS portion of the patch part is still 09 because it's not a leading 0.

** D[D] is 8 not 08 because it would create a leading 0 in the patch semver part. However, the HH portion of the patch part is still 01 because it's not a leading 0.

View the Mc sample project on github.

Gobot has a growing list (currently 52) of official apps. Have you tried them all?

Join our Discord community.

If you are writing a nodejs application that depends upon binaries being present (like PocketHost does), you can add this package as a dependency and execute the binary via CLI or programmatically. This package will make sure your desired external binaries are always available.

If you just want to grab a binary quickly for your own use, npx gobot@latest <app> is quite a bit easier than manually downloading zips and installing binaries in shell paths. Gobot handles it all for you effortlessly.

We want to add native support for lots of binary apps!

If you use publish statically linked binary releases on github, you are already 98% compatible with Gobot. In fact, Gobot may already know how to work with it.

To see what initial support looks like:

npx gobot inspect <user>/<repo>

This will index all the releases from your repo and show you exactly what Gobot sees.

If you see everything you expect, you're golden. If things are missing, it may mean some custom programming. Either way, jump on Discord and let us know your results.

If you have the flexibility or are starting a new project, make sure your release names follows these rules:

• Ends in .zip, .tgz, .tar.gz, .bz2
• Include the version (semver recommended)
• Include the platform (freebsd, darwin, linux, win32)
• Include the architecture (arm64, x64, ia32, arm)

Note: GoReleaser is a great option if you're publish a Go-based project.

We could use help testing and making sure this works across lots of platforms.

To test a build locally:

pnpm test

gobot-mc versions mirror mc versions. Gobot knows about 266 releases of mc: