mirror of
https://github.com/mikefarah/yq.git
synced 2025-01-14 04:25:36 +00:00
Updated instructions
This commit is contained in:
Mike Farah
parent
e5bcfedbe9
commit
0f8b864321
@ -325,6 +325,27 @@
|
|||||||
Deleting nodes in-place
|
Deleting nodes in-place
|
||||||
</a>
|
</a>
|
||||||
|
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li class="md-nav__item">
|
||||||
|
<a href="#splat" title="Splat" class="md-nav__link">
|
||||||
|
Splat
|
||||||
|
</a>
|
||||||
|
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li class="md-nav__item">
|
||||||
|
<a href="#prefix-splat" title="Prefix Splat" class="md-nav__link">
|
||||||
|
Prefix Splat
|
||||||
|
</a>
|
||||||
|
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li class="md-nav__item">
|
||||||
|
<a href="#array-splat" title="Array Splat" class="md-nav__link">
|
||||||
|
Array Splat
|
||||||
|
</a>
|
||||||
|
|
||||||
</li>
|
</li>
|
||||||
|
|
||||||
<li class="md-nav__item">
|
<li class="md-nav__item">
|
||||||
@ -446,6 +467,27 @@
|
|||||||
Deleting nodes in-place
|
Deleting nodes in-place
|
||||||
</a>
|
</a>
|
||||||
|
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li class="md-nav__item">
|
||||||
|
<a href="#splat" title="Splat" class="md-nav__link">
|
||||||
|
Splat
|
||||||
|
</a>
|
||||||
|
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li class="md-nav__item">
|
||||||
|
<a href="#prefix-splat" title="Prefix Splat" class="md-nav__link">
|
||||||
|
Prefix Splat
|
||||||
|
</a>
|
||||||
|
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li class="md-nav__item">
|
||||||
|
<a href="#array-splat" title="Array Splat" class="md-nav__link">
|
||||||
|
Array Splat
|
||||||
|
</a>
|
||||||
|
|
||||||
</li>
|
</li>
|
||||||
|
|
||||||
<li class="md-nav__item">
|
<li class="md-nav__item">
|
||||||
@ -552,6 +594,91 @@
|
|||||||
</code></pre>
|
</code></pre>
|
||||||
|
|
||||||
<p>will update the sample.yaml file so that the 'c' node is deleted</p>
|
<p>will update the sample.yaml file so that the 'c' node is deleted</p>
|
||||||
|
<h3 id="splat">Splat<a class="headerlink" href="#splat" title="Permanent link">¶</a></h3>
|
||||||
|
<p>Given a sample.yaml file of:</p>
|
||||||
|
<pre><code class="yaml">---
|
||||||
|
bob:
|
||||||
|
item1:
|
||||||
|
cats: bananas
|
||||||
|
dogs: woof
|
||||||
|
item2:
|
||||||
|
cats: apples
|
||||||
|
dogs: woof2
|
||||||
|
thing:
|
||||||
|
cats: oranges
|
||||||
|
dogs: woof3
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<p>then</p>
|
||||||
|
<pre><code class="bash">yq d sample.yaml bob.*.cats
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<p>will output:</p>
|
||||||
|
<pre><code class="yaml">---
|
||||||
|
bob:
|
||||||
|
item1:
|
||||||
|
dogs: woof
|
||||||
|
item2:
|
||||||
|
dogs: woof2
|
||||||
|
thing:
|
||||||
|
dogs: woof3
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<h3 id="prefix-splat">Prefix Splat<a class="headerlink" href="#prefix-splat" title="Permanent link">¶</a></h3>
|
||||||
|
<p>Given a sample.yaml file of:</p>
|
||||||
|
<pre><code class="yaml">---
|
||||||
|
bob:
|
||||||
|
item1:
|
||||||
|
cats: bananas
|
||||||
|
dogs: woof
|
||||||
|
item2:
|
||||||
|
cats: apples
|
||||||
|
dogs: woof2
|
||||||
|
thing:
|
||||||
|
cats: oranges
|
||||||
|
dogs: woof3
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<p>then</p>
|
||||||
|
<pre><code class="bash">yq d sample.yaml bob.item*.cats
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<p>will output:</p>
|
||||||
|
<pre><code class="yaml">---
|
||||||
|
bob:
|
||||||
|
item1:
|
||||||
|
dogs: woof
|
||||||
|
item2:
|
||||||
|
dogs: woof2
|
||||||
|
thing:
|
||||||
|
cats: oranges
|
||||||
|
dogs: woof3
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<h3 id="array-splat">Array Splat<a class="headerlink" href="#array-splat" title="Permanent link">¶</a></h3>
|
||||||
|
<p>Given a sample.yaml file of:</p>
|
||||||
|
<pre><code class="yaml">---
|
||||||
|
bob:
|
||||||
|
- cats: bananas
|
||||||
|
dogs: woof
|
||||||
|
- cats: apples
|
||||||
|
dogs: woof2
|
||||||
|
- cats: oranges
|
||||||
|
dogs: woof3
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<p>then</p>
|
||||||
|
<pre><code class="bash">yq d sample.yaml bob.[*].cats
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<p>will output:</p>
|
||||||
|
<pre><code class="yaml">---
|
||||||
|
bob:
|
||||||
|
- dogs: woof
|
||||||
|
- dogs: woof2
|
||||||
|
- dogs: woof3
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
<h3 id="multiple-documents-delete-from-single-document">Multiple Documents - delete from single document<a class="headerlink" href="#multiple-documents-delete-from-single-document" title="Permanent link">¶</a></h3>
|
<h3 id="multiple-documents-delete-from-single-document">Multiple Documents - delete from single document<a class="headerlink" href="#multiple-documents-delete-from-single-document" title="Permanent link">¶</a></h3>
|
||||||
<p>Given a sample.yaml file of:</p>
|
<p>Given a sample.yaml file of:</p>
|
||||||
<pre><code class="yaml">something: else
|
<pre><code class="yaml">something: else
|
||||||
|
|||||||
@ -282,6 +282,13 @@
|
|||||||
Splat
|
Splat
|
||||||
</a>
|
</a>
|
||||||
|
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li class="md-nav__item">
|
||||||
|
<a href="#prefix-splat" title="Prefix Splat" class="md-nav__link">
|
||||||
|
Prefix Splat
|
||||||
|
</a>
|
||||||
|
|
||||||
</li>
|
</li>
|
||||||
|
|
||||||
<li class="md-nav__item">
|
<li class="md-nav__item">
|
||||||
@ -446,6 +453,13 @@
|
|||||||
Splat
|
Splat
|
||||||
</a>
|
</a>
|
||||||
|
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li class="md-nav__item">
|
||||||
|
<a href="#prefix-splat" title="Prefix Splat" class="md-nav__link">
|
||||||
|
Prefix Splat
|
||||||
|
</a>
|
||||||
|
|
||||||
</li>
|
</li>
|
||||||
|
|
||||||
<li class="md-nav__item">
|
<li class="md-nav__item">
|
||||||
@ -540,12 +554,36 @@ bob:
|
|||||||
cats: bananas
|
cats: bananas
|
||||||
item2:
|
item2:
|
||||||
cats: apples
|
cats: apples
|
||||||
|
thing:
|
||||||
|
cats: oranges
|
||||||
</code></pre>
|
</code></pre>
|
||||||
|
|
||||||
<p>then</p>
|
<p>then</p>
|
||||||
<pre><code class="bash">yq r sample.yaml bob.*.cats
|
<pre><code class="bash">yq r sample.yaml bob.*.cats
|
||||||
</code></pre>
|
</code></pre>
|
||||||
|
|
||||||
|
<p>will output</p>
|
||||||
|
<pre><code class="yaml">- bananas
|
||||||
|
- apples
|
||||||
|
- oranges
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<h3 id="prefix-splat">Prefix Splat<a class="headerlink" href="#prefix-splat" title="Permanent link">¶</a></h3>
|
||||||
|
<p>Given a sample.yaml file of:</p>
|
||||||
|
<pre><code class="yaml">---
|
||||||
|
bob:
|
||||||
|
item1:
|
||||||
|
cats: bananas
|
||||||
|
item2:
|
||||||
|
cats: apples
|
||||||
|
thing:
|
||||||
|
cats: oranges
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<p>then</p>
|
||||||
|
<pre><code class="bash">yq r sample.yaml bob.item*.cats
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
<p>will output</p>
|
<p>will output</p>
|
||||||
<pre><code class="yaml">- bananas
|
<pre><code class="yaml">- bananas
|
||||||
- apples
|
- apples
|
||||||
|
|||||||
File diff suppressed because one or more lines are too long
@ -294,6 +294,27 @@
|
|||||||
Adding new fields
|
Adding new fields
|
||||||
</a>
|
</a>
|
||||||
|
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li class="md-nav__item">
|
||||||
|
<a href="#splat" title="Splat" class="md-nav__link">
|
||||||
|
Splat
|
||||||
|
</a>
|
||||||
|
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li class="md-nav__item">
|
||||||
|
<a href="#prefix-splat" title="Prefix Splat" class="md-nav__link">
|
||||||
|
Prefix Splat
|
||||||
|
</a>
|
||||||
|
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li class="md-nav__item">
|
||||||
|
<a href="#array-splat" title="Array Splat" class="md-nav__link">
|
||||||
|
Array Splat
|
||||||
|
</a>
|
||||||
|
|
||||||
</li>
|
</li>
|
||||||
|
|
||||||
<li class="md-nav__item">
|
<li class="md-nav__item">
|
||||||
@ -460,6 +481,27 @@
|
|||||||
Adding new fields
|
Adding new fields
|
||||||
</a>
|
</a>
|
||||||
|
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li class="md-nav__item">
|
||||||
|
<a href="#splat" title="Splat" class="md-nav__link">
|
||||||
|
Splat
|
||||||
|
</a>
|
||||||
|
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li class="md-nav__item">
|
||||||
|
<a href="#prefix-splat" title="Prefix Splat" class="md-nav__link">
|
||||||
|
Prefix Splat
|
||||||
|
</a>
|
||||||
|
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li class="md-nav__item">
|
||||||
|
<a href="#array-splat" title="Array Splat" class="md-nav__link">
|
||||||
|
Array Splat
|
||||||
|
</a>
|
||||||
|
|
||||||
</li>
|
</li>
|
||||||
|
|
||||||
<li class="md-nav__item">
|
<li class="md-nav__item">
|
||||||
@ -579,6 +621,81 @@
|
|||||||
- new thing
|
- new thing
|
||||||
</code></pre>
|
</code></pre>
|
||||||
|
|
||||||
|
<h3 id="splat">Splat<a class="headerlink" href="#splat" title="Permanent link">¶</a></h3>
|
||||||
|
<p>Given a sample.yaml file of:</p>
|
||||||
|
<pre><code class="yaml">---
|
||||||
|
bob:
|
||||||
|
item1:
|
||||||
|
cats: bananas
|
||||||
|
item2:
|
||||||
|
cats: apples
|
||||||
|
thing:
|
||||||
|
cats: oranges
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<p>then</p>
|
||||||
|
<pre><code class="bash">yq w sample.yaml bob.*.cats meow
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<p>will output:</p>
|
||||||
|
<pre><code class="yaml">---
|
||||||
|
bob:
|
||||||
|
item1:
|
||||||
|
cats: meow
|
||||||
|
item2:
|
||||||
|
cats: meow
|
||||||
|
thing:
|
||||||
|
cats: meow
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<h3 id="prefix-splat">Prefix Splat<a class="headerlink" href="#prefix-splat" title="Permanent link">¶</a></h3>
|
||||||
|
<p>Given a sample.yaml file of:</p>
|
||||||
|
<pre><code class="yaml">---
|
||||||
|
bob:
|
||||||
|
item1:
|
||||||
|
cats: bananas
|
||||||
|
item2:
|
||||||
|
cats: apples
|
||||||
|
thing:
|
||||||
|
cats: oranges
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<p>then</p>
|
||||||
|
<pre><code class="bash">yq w sample.yaml bob.item*.cats meow
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<p>will output:</p>
|
||||||
|
<pre><code class="yaml">---
|
||||||
|
bob:
|
||||||
|
item1:
|
||||||
|
cats: meow
|
||||||
|
item2:
|
||||||
|
cats: meow
|
||||||
|
thing:
|
||||||
|
cats: oranges
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<h3 id="array-splat">Array Splat<a class="headerlink" href="#array-splat" title="Permanent link">¶</a></h3>
|
||||||
|
<p>Given a sample.yaml file of:</p>
|
||||||
|
<pre><code class="yaml">---
|
||||||
|
bob:
|
||||||
|
- cats: bananas
|
||||||
|
- cats: apples
|
||||||
|
- cats: oranges
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<p>then</p>
|
||||||
|
<pre><code class="bash">yq w sample.yaml bob[*].cats meow
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
|
<p>will output:</p>
|
||||||
|
<pre><code class="yaml">---
|
||||||
|
bob:
|
||||||
|
- cats: meow
|
||||||
|
- cats: meow
|
||||||
|
- cats: meow
|
||||||
|
</code></pre>
|
||||||
|
|
||||||
<h3 id="appending-value-to-an-array-field">Appending value to an array field<a class="headerlink" href="#appending-value-to-an-array-field" title="Permanent link">¶</a></h3>
|
<h3 id="appending-value-to-an-array-field">Appending value to an array field<a class="headerlink" href="#appending-value-to-an-array-field" title="Permanent link">¶</a></h3>
|
||||||
<p>Given a sample.yaml file of:</p>
|
<p>Given a sample.yaml file of:</p>
|
||||||
<pre><code class="yaml">b:
|
<pre><code class="yaml">b:
|
||||||
|
|||||||
@ -59,6 +59,93 @@ yq d -i sample.yaml b.c
|
|||||||
will update the sample.yaml file so that the 'c' node is deleted
|
will update the sample.yaml file so that the 'c' node is deleted
|
||||||
|
|
||||||
|
|
||||||
|
### Splat
|
||||||
|
Given a sample.yaml file of:
|
||||||
|
```yaml
|
||||||
|
---
|
||||||
|
bob:
|
||||||
|
item1:
|
||||||
|
cats: bananas
|
||||||
|
dogs: woof
|
||||||
|
item2:
|
||||||
|
cats: apples
|
||||||
|
dogs: woof2
|
||||||
|
thing:
|
||||||
|
cats: oranges
|
||||||
|
dogs: woof3
|
||||||
|
```
|
||||||
|
then
|
||||||
|
```bash
|
||||||
|
yq d sample.yaml bob.*.cats
|
||||||
|
```
|
||||||
|
will output:
|
||||||
|
```yaml
|
||||||
|
---
|
||||||
|
bob:
|
||||||
|
item1:
|
||||||
|
dogs: woof
|
||||||
|
item2:
|
||||||
|
dogs: woof2
|
||||||
|
thing:
|
||||||
|
dogs: woof3
|
||||||
|
```
|
||||||
|
|
||||||
|
### Prefix Splat
|
||||||
|
Given a sample.yaml file of:
|
||||||
|
```yaml
|
||||||
|
---
|
||||||
|
bob:
|
||||||
|
item1:
|
||||||
|
cats: bananas
|
||||||
|
dogs: woof
|
||||||
|
item2:
|
||||||
|
cats: apples
|
||||||
|
dogs: woof2
|
||||||
|
thing:
|
||||||
|
cats: oranges
|
||||||
|
dogs: woof3
|
||||||
|
```
|
||||||
|
then
|
||||||
|
```bash
|
||||||
|
yq d sample.yaml bob.item*.cats
|
||||||
|
```
|
||||||
|
will output:
|
||||||
|
```yaml
|
||||||
|
---
|
||||||
|
bob:
|
||||||
|
item1:
|
||||||
|
dogs: woof
|
||||||
|
item2:
|
||||||
|
dogs: woof2
|
||||||
|
thing:
|
||||||
|
cats: oranges
|
||||||
|
dogs: woof3
|
||||||
|
```
|
||||||
|
|
||||||
|
### Array Splat
|
||||||
|
Given a sample.yaml file of:
|
||||||
|
```yaml
|
||||||
|
---
|
||||||
|
bob:
|
||||||
|
- cats: bananas
|
||||||
|
dogs: woof
|
||||||
|
- cats: apples
|
||||||
|
dogs: woof2
|
||||||
|
- cats: oranges
|
||||||
|
dogs: woof3
|
||||||
|
```
|
||||||
|
then
|
||||||
|
```bash
|
||||||
|
yq d sample.yaml bob.[*].cats
|
||||||
|
```
|
||||||
|
will output:
|
||||||
|
```yaml
|
||||||
|
---
|
||||||
|
bob:
|
||||||
|
- dogs: woof
|
||||||
|
- dogs: woof2
|
||||||
|
- dogs: woof3
|
||||||
|
```
|
||||||
|
|
||||||
### Multiple Documents - delete from single document
|
### Multiple Documents - delete from single document
|
||||||
Given a sample.yaml file of:
|
Given a sample.yaml file of:
|
||||||
|
|||||||
@ -99,6 +99,28 @@ bob:
|
|||||||
cats: oranges
|
cats: oranges
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Array Splat
|
||||||
|
Given a sample.yaml file of:
|
||||||
|
```yaml
|
||||||
|
---
|
||||||
|
bob:
|
||||||
|
- cats: bananas
|
||||||
|
- cats: apples
|
||||||
|
- cats: oranges
|
||||||
|
```
|
||||||
|
then
|
||||||
|
```bash
|
||||||
|
yq w sample.yaml bob[*].cats meow
|
||||||
|
```
|
||||||
|
will output:
|
||||||
|
```yaml
|
||||||
|
---
|
||||||
|
bob:
|
||||||
|
- cats: meow
|
||||||
|
- cats: meow
|
||||||
|
- cats: meow
|
||||||
|
```
|
||||||
|
|
||||||
### Appending value to an array field
|
### Appending value to an array field
|
||||||
Given a sample.yaml file of:
|
Given a sample.yaml file of:
|
||||||
```yaml
|
```yaml
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user