# CLI

Rudel registrira svoje ukaze pod `wp rudel`. WP-CLI zavrne možnost, ki ni navedena za ukaz, z napako `unknown --<name> parameter`.

Za vdelano uporabo lahko preimenujete korenski ukaz tako, da določite `RUDEL_CLI_COMMAND` v `wp-config.php`, preden se vtičnik naloži.

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

S tem se `wp rudel create` spremeni v `wp sandbox create`. Delovanje ukaza ostane nespremenjeno.

Ukazi so privzeto usmerjeni na gostitelja. Če želite kateri koli drug ukaz WP-CLI izvesti znotraj peskovnika, nastavite `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>]
```

Ustvari peskovnik in izpiše njegov ID.

| Možnost | Pomen |
|--------|---------|
| `--name` | Človeku berljivo ime. ID je sestavljen iz imena in štirih šestnajstiških znakov. Privzeta vrednost je ime repozitorija z `--git`, sicer `sandbox`. |
| `--theme` | Tema za kopiranje v peskovnik. Nameščena mora biti na gostitelju. Privzeto je to aktivna tema gostitelja ali tema izvornega peskovnika z `--clone-from`. |
| `--clone-from` | Namesto gostitelja klonira tabele in temo iz obstoječega peskovnika. |
| `--owner`, `--labels`, `--purpose` | Metapodatki. Oznake so ločene z vejicami. |
| `--protected` | Izvzame peskovnik iz čiščenja. |
| `--ttl-days` | Čas poteka glede na čas ustvarjanja. |
| `--expires-at` | Izrecen časovni žig poteka. |
| `--git` | Klonira oddaljeni repozitorij v imenik peskovnika. Glejte [Git](https://rudel.inline0.dev/sl/docs/features/git). |
| `--type` | Mesto, kamor `--git` izvede odjavo: `theme` (privzeto) ali `plugin`. |
| `--template` | Oznaka, shranjena v zapisu; privzeto `blank`. Shranjene predloge ne naloži. |

`--clone-db`, `--clone-themes`, `--clone-plugins`, `--clone-uploads`, `--clone-all`, `--shared-plugins` in `--shared-uploads` so zastareli. Spreminjajo samo sporočila o poteku: vsako peskovno okolje klonira tabele, kopira eno temo ter uporablja skupne vtičnike in naložene datoteke.

Ukaz se konča z namigom, naj v imenik peskovnega okolja prenesete `cd` in zaženete `wp post list`. To se izvede na gostitelju, ker `wp-cli.yml` v imeniku peskovnega okolja kaže na gostiteljski URL. Namesto tega uporabite `RUDEL_ENVIRONMENT`.

## seznam

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

Izpiše peskovna okolja z ID-jem, imenom, lastnikom, zaščito, potekom veljavnosti, stanjem, oznako predloge, časom ustvarjanja in velikostjo imenika.

## info

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

Prikaže zapis enega peskovnega okolja, vključno s predpono tabel, temo, oznakami, metapodatki klona, URL in potjo do vsebine.

## posodobitev

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

Posodobi metapodatke. `--ttl-days` šteje od zdaj naprej. Vsebine mesta v peskovnem okolju ne spremeni.

## uničenje

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

Odstrani tabele peskovnega okolja in njegov imenik ter povezane delovne kopije, nato pa izbriše njegov zapis. Ukaz zahteva potrditev; `--force` preskoči poziv. Zaščita ne prepreči `destroy`: zaščiteno peskovno okolje se uniči enako kot katero koli drugo.

## stanje

```bash
wp rudel status
```

Izpiše tabelo s stanjem zagona, trenutnim peskovnim okoljem, imenikom peskovnih okolij, njihovim številom, vrednostmi `rudel_config` in podatkom, ali je avtomatizacija načrtovana. Vedno izpiše tabelo in prezre `--format`.

## čiščenje

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

Brez možnosti `--merged` odstrani nezaščitena peskovna okolja, ki jim je potekla veljavnost, so starejša od starostne omejitve ali so nedejavna dlje od omejitve nedejavnosti. Možnosti `--max-age-days` in `--max-idle-days` za ta zagon preglasita `rudel_config`. Z možnostjo `--merged` odstrani peskovna okolja, katerih povezane veje delovnih kopij Git so združene. Zaščitena peskovna okolja vedno preskoči. Glejte [Čiščenje](https://rudel.inline0.dev/sl/docs/features/cleanup).

## dnevniki

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

Izpiše zadnje vrstice dnevniške datoteke peskovnega okolja `debug.log` (privzeto 50). `--follow` zažene `tail -f`; `--clear` izprazni datoteko. Glejte [Beleženje napak](https://rudel.inline0.dev/sl/docs/features/logging).

## posnetek

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

Ustvari poimenovan posnetek.

## obnovitev

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

Obnovi posnetek. Ukaz zahteva potrditev; `--force` preskoči poziv. Glejte [Posnetki](https://rudel.inline0.dev/sl/docs/features/snapshots).

## predloga

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

Shrani, izpiše in izbriše kopije predlog. Noben ukaz ne ustvari peskovnega okolja iz shranjene predloge. Glejte [Predloge](https://rudel.inline0.dev/sl/docs/features/templates).

## potisni

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

Potrdi spremembe in potisne kopijo za delo v imeniku peskovnega okolja v vejo `rudel/<id>`.

| Možnost | Pomen |
|--------|---------|
| `--git` | Oddaljeni URL. Potreben samo, če ni shranjen; po prvem uspešnem potisku si ga ukaz zapomni. |
| `--dir` | Imenik glede na imenik peskovnega okolja, na primer `themes/my-theme`. Privzeto se uporabi shranjeni imenik kopije za delo, sicer celoten imenik peskovnega okolja. |
| `--message` | Sporočilo potrditve, privzeto `Update from Rudel sandbox`. |

Glejte [Git](https://rudel.inline0.dev/sl/docs/features/git).