From 98f1cf845dbb8d6f4c29a51801fb529ceb9efeb5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jure=20=C5=A0orn?= <sornjure@gmail.com>
Date: Sat, 11 Jan 2020 20:11:43 +0100
Subject: [PATCH] Shell commands

---
 README.md  | 23 +++++++++++++++--------
 index.html | 17 +++++++++++------
 2 files changed, 26 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index 948342a..fee1720 100644
--- a/README.md
+++ b/README.md
@@ -1677,14 +1677,21 @@ import os
 <str> = os.popen('<shell_command>').read()
 ```
 
-#### Using subprocess:
-```python
->>> import subprocess, shlex
->>> a = subprocess.run(shlex.split('ls -a'), stdout=subprocess.PIPE)
->>> a.stdout
-b'.\n..\nfile1.txt\nfile2.txt\n'
->>> a.returncode
-0
+#### Sends '1 + 1' to calculator and captures its output:
+```python
+>>> from subprocess import run
+>>> run('bc', input='1 + 1\n', capture_output=True, encoding='utf-8')
+CompletedProcess(args='bc', returncode=0, stdout='2\n', stderr='')
+```
+
+#### Sends 'test.in' to calculator running in standard mode and saves its output to 'test.out':
+```python
+>>> from shlex import split
+>>> os.popen('echo 1 + 1 > test.in')
+>>> run(split('bc -s'), stdin=open('test.in'), stdout=open('test.out', 'w'))
+CompletedProcess(args=['bc', '-s'], returncode=0)
+>>> os.popen('cat test.out').read()
+'2\n'
 ```
 
 
diff --git a/index.html b/index.html
index efbfcf4..7ef0cea 100644
--- a/index.html
+++ b/index.html
@@ -1522,12 +1522,17 @@ shutil.rmtree(&lt;path&gt;)               <span class="hljs-comment"># Deletes n
 &lt;str&gt; = os.popen(<span class="hljs-string">'&lt;shell_command&gt;'</span>).read()
 </code></pre></div>
 
-<div><h4 id="usingsubprocess">Using subprocess:</h4><pre><code class="python language-python hljs"><span class="hljs-meta">&gt;&gt;&gt; </span><span class="hljs-keyword">import</span> subprocess, shlex
-<span class="hljs-meta">&gt;&gt;&gt; </span>a = subprocess.run(shlex.split(<span class="hljs-string">'ls -a'</span>), stdout=subprocess.PIPE)
-<span class="hljs-meta">&gt;&gt;&gt; </span>a.stdout
-<span class="hljs-string">b'.\n..\nfile1.txt\nfile2.txt\n'</span>
-<span class="hljs-meta">&gt;&gt;&gt; </span>a.returncode
-<span class="hljs-number">0</span>
+<div><h4 id="sends11tocalculatorandcapturesitsoutput">Sends '1 + 1' to calculator and captures its output:</h4><pre><code class="python language-python hljs"><span class="hljs-meta">&gt;&gt;&gt; </span><span class="hljs-keyword">from</span> subprocess <span class="hljs-keyword">import</span> run
+<span class="hljs-meta">&gt;&gt;&gt; </span>run(<span class="hljs-string">'bc'</span>, input=<span class="hljs-string">'1 + 1\n'</span>, capture_output=<span class="hljs-keyword">True</span>, encoding=<span class="hljs-string">'utf-8'</span>)
+CompletedProcess(args=<span class="hljs-string">'bc'</span>, returncode=<span class="hljs-number">0</span>, stdout=<span class="hljs-string">'2\n'</span>, stderr=<span class="hljs-string">''</span>)
+</code></pre></div>
+
+<div><h4 id="sendstestintocalculatorrunninginstandardmodeandsavesitsoutputtotestout">Sends 'test.in' to calculator running in standard mode and saves its output to 'test.out':</h4><pre><code class="python language-python hljs"><span class="hljs-meta">&gt;&gt;&gt; </span><span class="hljs-keyword">from</span> shlex <span class="hljs-keyword">import</span> split
+<span class="hljs-meta">&gt;&gt;&gt; </span>os.popen(<span class="hljs-string">'echo 1 + 1 &gt; test.in'</span>)
+<span class="hljs-meta">&gt;&gt;&gt; </span>run(split(<span class="hljs-string">'bc -s'</span>), stdin=open(<span class="hljs-string">'test.in'</span>), stdout=open(<span class="hljs-string">'test.out'</span>, <span class="hljs-string">'w'</span>))
+CompletedProcess(args=[<span class="hljs-string">'bc'</span>, <span class="hljs-string">'-s'</span>], returncode=<span class="hljs-number">0</span>)
+<span class="hljs-meta">&gt;&gt;&gt; </span>os.popen(<span class="hljs-string">'cat test.out'</span>).read()
+<span class="hljs-string">'2\n'</span>
 </code></pre></div>
 
 <div><h2 id="json"><a href="#json" name="json">#</a>JSON</h2><p><strong>Text file format for storing collections of strings and numbers.</strong></p><pre><code class="python language-python hljs"><span class="hljs-keyword">import</span> json