# CLI

Rudel reģistrē savas komandas sadaļā `wp rudel`. WP-CLI noraida opciju, kas nav norādīta pie komandas, izraisot `unknown --<name> parameter`.

Iegultai lietošanai varat pārdēvēt saknes komandu, definējot `RUDEL_CLI_COMMAND` failā `wp-config.php` pirms spraudņa ielādes.

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

Tādējādi `wp rudel create` tiek mainīta uz `wp sandbox create`. Komandas darbība nemainās.

Pēc noklusējuma komandas darbojas ar saimniekdatoru. Lai izpildītu jebkuru citu WP-CLI komandu smilškastē, iestatiet `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>]
```

Izveido smilškasti un izvada tās ID.

| Opcija | Nozīme |
|--------|---------|
| `--name` | Cilvēkam saprotams nosaukums. ID veido nosaukums un četras heksadecimālas rakstzīmes. Pēc noklusējuma — repozitorija nosaukums ar `--git`, citādi `sandbox`. |
| `--theme` | Tēma, ko kopēt smilškastē. Tai jābūt instalētai saimniekdatorā. Pēc noklusējuma — saimniekdatora aktīvā tēma vai avota smilškastes tēma ar `--clone-from`. |
| `--clone-from` | Klonē tabulas un tēmu no esošas smilškastes, nevis saimniekdatora. |
| `--owner`, `--labels`, `--purpose` | Metadati. Etiķetes atdala ar komatiem. |
| `--protected` | Izslēdz smilškasti no tīrīšanas. |
| `--ttl-days` | Derīguma termiņš no izveides brīža. |
| `--expires-at` | Skaidri norādīta derīguma termiņa laika atzīme. |
| `--git` | Klonē attālu repozitoriju smilškastes direktorijā. Skatiet [Git](https://rudel.inline0.dev/lv/docs/features/git). |
| `--type` | Kur `--git` veic izrakstīšanu: `theme` (pēc noklusējuma) vai `plugin`. |
| `--template` | Ierakstā saglabāta etiķete, pēc noklusējuma `blank`. Tā neielādē saglabātu veidni. |

`--clone-db`, `--clone-themes`, `--clone-plugins`, `--clone-uploads`, `--clone-all`, `--shared-plugins` un `--shared-uploads` ir novecojušas. Tās maina tikai progresa ziņojumus: katra smilškaste klonē tabulas, kopē vienu tēmu un koplieto spraudņus un augšupielādes.

Komandas beigās tiek ieteikts pāriet uz smilškastes direktoriju ar `cd` un palaist `wp post list`. Tas darbojas ar saimniekdatoru, jo `wp-cli.yml` smilškastes direktorijā norāda uz saimniekdatora URL. Tā vietā izmantojiet `RUDEL_ENVIRONMENT`.

## list

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

Uzskaita smilškastes, norādot ID, nosaukumu, īpašnieku, aizsardzību, derīguma termiņu, statusu, veidnes etiķeti, izveides laiku un direktorijas lielumu.

## info

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

Parāda vienu smilškastes ierakstu, tostarp tabulu prefiksu, tēmu, etiķetes, klonēšanas metadatus, URL un satura ceļu.

## update

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

Atjaunina metadatus. `--ttl-days` skaita no pašreizējā brīža. Smilškastes vietnes saturs netiek mainīts.

## destroy

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

Dzēš smilškastes tabulas, tās direktoriju un saistītos darba kokus, kā arī tās ierakstu. Komanda pieprasa apstiprinājumu; `--force` izlaiž šo pieprasījumu. Aizsardzība neliedz izmantot `destroy`: aizsargāta smilškaste tiek iznīcināta tāpat kā jebkura cita.

## status

```bash
wp rudel status
```

Izvada tabulu ar sākotnējās ielādes stāvokli, pašreizējo smilškasti, smilškastu direktoriju, smilškastu skaitu, vērtībām `rudel_config` un informāciju, vai ir ieplānota automatizācija. Vienmēr tiek izvadīta tabula, un `--format` tiek ignorēts.

## cleanup

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

Bez `--merged` noņem neaizsargātas smilškastes, kuru derīguma termiņš ir beidzies, kuras pārsniedz vecuma ierobežojumu vai nav izmantotas ilgāk par neaktivitātes ierobežojumu. `--max-age-days` un `--max-idle-days` šai palaišanas reizei ignorē `rudel_config`. Ar `--merged` noņem smilškastes, kuru saistīto Git darba koku atzari ir sapludināti. Aizsargātas smilškastes vienmēr tiek izlaistas. Skatiet [Tīrīšana](https://rudel.inline0.dev/lv/docs/features/cleanup).

## logs

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

Izvada smilškastes `debug.log` pēdējās rindas (pēc noklusējuma — 50). `--follow` palaiž `tail -f`; `--clear` iztukšo failu. Skatiet [Kļūdu žurnalēšana](https://rudel.inline0.dev/lv/docs/features/logging).

## snapshot

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

Izveido nosauktu momentuzņēmumu.

## restore

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

Atjauno momentuzņēmumu. Komanda pieprasa apstiprinājumu; `--force` izlaiž šo pieprasījumu. Skatiet [Momentuzņēmumi](https://rudel.inline0.dev/lv/docs/features/snapshots).

## template

```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]
```

Saglabā, uzskaita un dzēš veidņu kopijas. Neviena komanda neizveido smilškasti no saglabātas veidnes. Skatiet [Veidnes](https://rudel.inline0.dev/lv/docs/features/templates).

## push

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

Apstiprina un nosūta smilškastes direktorijā esošo darba kopiju uz atzaru `rudel/<id>`.

| Opcija | Nozīme |
|--------|---------|
| `--git` | Attālais URL. Nepieciešams tikai tad, ja vērtība nav saglabāta; pēc pirmās veiksmīgās nosūtīšanas tā tiek iegaumēta. |
| `--dir` | Direktorija attiecībā pret smilškastes direktoriju, piemēram, `themes/my-theme`. Pēc noklusējuma — saglabātā izrakstīšanas direktorija, citādi visa smilškastes direktorija. |
| `--message` | Apstiprinājuma ziņojums, pēc noklusējuma `Update from Rudel sandbox`. |

Skatiet [Git](https://rudel.inline0.dev/lv/docs/features/git).