# 民 Palabra [![License][LicenseIMGURL]][LicenseURL] [![NPM version][NPMIMGURL]][NPMURL] [![Build Status][BuildStatusIMGURL]][BuildStatusURL] [![Coverage Status][CoverageIMGURL]][CoverageURL]

[NPMURL]: https://npmjs.org/package/palabra "npm"
[NPMIMGURL]: https://img.shields.io/npm/v/palabra.svg?style=flat
[BuildStatusURL]: https://github.com/coderaiser/palabra/actions?query=workflow%3A%22Node+CI%22 "Build Status"
[BuildStatusIMGURL]: https://github.com/coderaiser/palabra/workflows/Node%20CI/badge.svg
[LicenseURL]: https://tldrlegal.com/license/mit-license "MIT License"
[LicenseIMGURL]: https://img.shields.io/badge/license-MIT-317BF9.svg?style=flat
[CoverageURL]: https://coveralls.io/github/coderaiser/palabra?branch=master
[CoverageIMGURL]: https://coveralls.io/repos/coderaiser/palabra/badge.svg?branch=master&service=github

Install packages easier than ever before.
Palabra install packages named letras, each letra is a set of commands, written in declarative form,
and compiled during install to bash script.

<img width="546" height="405" alt="image" src="https://github.com/user-attachments/assets/272fb625-a51e-488f-9d58-89268f810efb" />

## Install

```
npm i palabra -g
```

## Usage

First thing you should do is create `.palabra.json` with soft you want to install, like this:

```json
{
    "directorio": "~/.local/src",
    "letras": {
        "fasm": "*"
    }
}
```

Then run:

```sh
palabra
```

### `(i)nstall`

You can also use interactive mode:

```
palabra install bun node deno rust go nvim fasm -d /usr/local/src
```

You can also pass version:

```
palabra i nvim@0.11
```

Default installation directory is `~/.local/src`.

### `(l)ist`

To list all packages that can be installed use `l`:

```
$ palabra l
amber bin bun deno f4 fasm gdu go mwget node nvchad nvim nvm oxker rizin rust yara zero
```

### `(r)emove`

```
palabra r mwget
```

## Env variables

Use `PALABRA_DIR` or [`XDG_DATA_HOME`](https://specifications.freedesktop.org/basedir/latest/) to override default installation path `~/.local/share`.

That's it!

## Types of letras

There is a different types of letras. Each author release in one of next ways.

### Single binary

Provided url to executable, that should be downloaded and set `chmod +x`, and
then copy to directory `$PALABRA_DIR` and make symlinks.

### Single Binary archive

Provided url to archive with single executable, that should be downloaded, and
then copy to directory `$PALABRA_DIR` and made symlinks.

### Nested archive

Provided url to archive with nested directory structure, that should be downloaded,
extracted and then copied to directory `$PALABRA_DIR` and made symlinks.

### Root archive

Provided url to archive with all files located on top level, that should be downloaded,
extracted and then copied to directory `$PALABRA_DIR` and made symlinks.

### Script

Provided url to script that should be downloaded and executed

## License

MIT