kaluza-cli

Command line interface for Kaluza, inspired by npm

Install

To install kaluza

sudo curl -sL https://mesopelagique.github.io/kaluza-cli/install.sh | bash

This will install kaluza to /usr/local/bin

On linux ubuntu

Make sure to have zlip installed

sudo apt-get install zlib1g

and swift https://swift.org/download/#releases

Usage

Init a project

kaluza init

A component.json file will be created in current folder (with name of the project)

Add a dependency

kaluza add <github user>/<github repository>

example:

kaluza add mesopelagique/formula_compose

A dependency will be added to your component.json without installing

Add a developpement dependency

kaluza add mesopelagique/formula_compose -D

Development dependencies, or devDependencies are components that are consumed by requiring them in files or run as binaries, during the development phase. These are components that are only necessary during development and not necessary for the production build

Install a dependency

kaluza install mesopelagique/formula_compose

A dependency will be added to your component.json if not already added, and the dependency installed into Components

Installed mean a binary could be downloaded if available with github release, or if you are in git reporisory a git submodule will be added, and if not, a git clone will be done

Install configured dependencies

kaluza install

Install all dependencies defined in component.json

Install a specific version

Use @ to specify a release version.

kaluza install mesopelagique/formula_compose@1.0.0

For this example the binary or the source will be taken from https://github.com/mesopelagique/formula_compose/releases/1.0.0

Uninstall a dependency

example:

kaluza uninstall mesopelagique/formula_compose

Options

• --no-bin: do not use binary or archive from release, use git command instead to get dependencies

• --no-save: install the dependencies but do not save for later

• --verbose: allow to display debug information

• -g, --global: allow to install into your 4D.app instead of current component.

  • For component useful only for dev purpose
  • $HOME/Library/Application Support/4D/kaluza.json file will save your dependencies.

To build

swift build -c release

On linux

You need swift and also zlip, on ubuntu 18

sudo apt install zlib1g-dev

TODO

• release workflow
• install command
• better argument parsing (manage order etc...)
• interactive init like npm
• install globally (in 4d app ?)
• list command
• uninstall command
• recursive dependencies