# CLI

Rudel registreerib oma käsud jaotises `wp rudel`. WP-CLI lükkab tagasi siin loetlemata valiku veaga `unknown --<name> parameter`.

Manustatud kasutuse jaoks saate juurkäsku ümber nimetada, määrates enne plugina laadimist väärtuse `RUDEL_CLI_COMMAND` failis `wp-config.php`.

```php
define( 'RUDEL_CLI_COMMAND', 'sandbox' );
```

See muudab käsu `wp rudel create` käsuks `wp sandbox create`. Käsu toimimine ei muutu.

Käsud töötavad vaikimisi hosti vastu. Mis tahes muu käsu WP-CLI käivitamiseks liivakastis määrake `RUDEL_ENVIRONMENT`:

```bash
RUDEL_ENVIRONMENT=alpha-3be7 wp option get blogname
```

## create

```bash
wp rudel create [--name=<name>] [--theme=<slug>] [--clone-from=<id>] [--owner=<owner>] [--labels=<labels>] [--purpose=<purpose>] [--protected] [--ttl-days=<days>] [--expires-at=<timestamp>] [--git=<remote>] [--type=<theme|plugin>] [--template=<label>]
```

Loob liivakasti ja prindib selle ID.

| Valik | Tähendus |
|--------|---------|
| `--name` | Inimloetav nimi. ID koosneb nimest ja neljast kuueteistkümnendmärgist. Vaikimisi kasutatakse hoidla nime koos väärtusega `--git`, muul juhul väärtust `sandbox`. |
| `--theme` | Liivakasti kopeeritav teema. See peab olema hosti paigaldatud. Vaikimisi kasutatakse hosti aktiivset teemat või lähteliivakasti teemat koos väärtusega `--clone-from`. |
| `--clone-from` | Kloonib hosti asemel olemasoleva liivakasti tabelid ja teema. |
| `--owner`, `--labels`, `--purpose` | Metaandmed. Sildid eraldatakse komadega. |
| `--protected` | Jätab liivakasti puhastamisest välja. |
| `--ttl-days` | Aegumine loomise hetkest arvates. |
| `--expires-at` | Selgesõnaline aegumisaja ajatempel. |
| `--git` | Kloonib liivakasti kataloogi kaughoidla. Vt [Git](https://rudel.inline0.dev/et/docs/features/git). |
| `--type` | Kuhu `--git` teeb checkout'i: `theme` (vaikimisi) või `plugin`. |
| `--template` | Kirjele salvestatav silt, vaikimisi `blank`. Salvestatud malli ei laadita. |

`--clone-db`, `--clone-themes`, `--clone-plugins`, `--clone-uploads`, `--clone-all`, `--shared-plugins` ja `--shared-uploads` on aegunud. Need muudavad ainult edenemisteateid: iga liivakast kloonib tabelid, kopeerib ühe teema ning jagab pluginaid ja üleslaadimisi.

Käsk lõpeb soovitusega kopeerida `cd` liivakasti kataloogi ja käivitada `wp post list`. See töötab hostis, sest liivakasti kataloogis olev `wp-cli.yml` osutab hosti URL-ile. Kasutage selle asemel käsku `RUDEL_ENVIRONMENT`.

## loend

```bash
wp rudel list [--format=<table|json|csv|yaml|count>]
```

Loetleb liivakastid koos ID, nime, omaniku, kaitstuse, aegumise, oleku, malli sildi, loomise aja ja kataloogi suurusega.

## teave

```bash
wp rudel info <id> [--format=<table|json|yaml>]
```

Näitab üht liivakasti kirjet, sh tabeli eesliidet, teemat, silte, kloonimise metaandmeid, URL ja sisu teed.

## uuendamine

```bash
wp rudel update <id> [--owner=<owner>] [--labels=<labels>] [--purpose=<purpose>] [--protected] [--unprotected] [--ttl-days=<days>] [--expires-at=<timestamp>] [--clear-expiry]
```

Uuendab metaandmeid. `--ttl-days` arvestab kestust alates praegusest hetkest. See ei muuda liivakasti saidi sisu.

## hävitamine

```bash
wp rudel destroy <id> [--force]
```

Eemaldab liivakasti tabelid, kataloogi ja lingitud tööpuud ning kustutab selle kirje. Käsk küsib kinnitust; `--force` jätab küsimise vahele. Kaitstus ei takista käsku `destroy`: kaitstud liivakast hävitatakse nagu iga teinegi.

## olek

```bash
wp rudel status
```

Väljastab tabeli algkäivituse oleku, praeguse liivakasti, liivakastide kataloogi, liivakastide arvu, väärtused `rudel_config` ja teabe selle kohta, kas automaatika on ajastatud. Väljastab alati tabeli ja eirab valikut `--format`.

## puhastamine

```bash
wp rudel cleanup [--dry-run] [--max-age-days=<days>] [--max-idle-days=<days>] [--merged]
```

Ilma valikuta `--merged` eemaldab kaitsmata liivakastid, mille aegumistähtaeg on möödas või mis on vanemad kui vanusepiirang või olnud jõude kauem kui jõudeoleku piirang. `--max-age-days` ja `--max-idle-days` alistavad selle käivituse jaoks valiku `rudel_config`. Valikuga `--merged` eemaldatakse liivakastid, mille lingitud Git tööpuu harud on liidetud. Kaitstud liivakastid jäetakse alati vahele. Vaadake teemat [Puhastamine](https://rudel.inline0.dev/et/docs/features/cleanup).

## logid

```bash
wp rudel logs <id> [--lines=<lines>] [--follow] [--clear]
```

Väljastab liivakasti `debug.log` viimased read (vaikimisi 50). `--follow` käivitab `tail -f`; `--clear` tühjendab faili. Vaadake teemat [Tõrgete logimine](https://rudel.inline0.dev/et/docs/features/logging).

## hetktõmmis

```bash
wp rudel snapshot <id> --name=<name>
```

Loob nimega hetktõmmise.

## taastamine

```bash
wp rudel restore <id> --snapshot=<name> [--force]
```

Taastab hetktõmmise. Käsk küsib kinnitust; `--force` jätab küsimise vahele. Vaadake teemat [Hetktõmmised](https://rudel.inline0.dev/et/docs/features/snapshots).

## mall

```bash
wp rudel template save <id> --name=<name> [--description=<description>]
wp rudel template list [--format=<table|json|csv|yaml|count>]
wp rudel template delete <name> [--force]
```

Salvestab, loetleb ja kustutab mallide koopiaid. Ükski käsk ei loo salvestatud malli põhjal liivakasti. Vaadake teemat [Mallid](https://rudel.inline0.dev/et/docs/features/templates).

## üleslükkamine

```bash
wp rudel push <id> [--git=<remote>] [--dir=<dir>] [--message=<message>]
```

Salvestab liivakasti kataloogis oleva töökoopia muudatused ja lükkab need harusse `rudel/<id>`.

| Valik | Tähendus |
|--------|---------|
| `--git` | Kaug-repo URL. Vajalik ainult siis, kui ühtegi pole salvestatud; jäetakse meelde pärast esimest edukat üleslükkamist. |
| `--dir` | Liivakasti kataloogi suhtes määratud kataloog, näiteks `themes/my-theme`. Vaikimisi salvestatud töökoopia kataloog, selle puudumisel kogu liivakasti kataloog. |
| `--message` | Salvestamise teade, vaikimisi `Update from Rudel sandbox`. |

Vaadake teemat [Git](https://rudel.inline0.dev/et/docs/features/git).