UPdate.

2026-01-26 05:12:14 +01:00
parent a59dbe1d55
commit fe2f087d9f
143 changed files with 13333 additions and 15112 deletions
@@ -0,0 +1,90 @@
+{# retoor <retoor@molodetz.nl> #}
+{% extends 'page.html' %}
+
+{% set page_title = "subprocess" %}
+{% set breadcrumb = [{"url": "api/index.html", "title": "API Reference"}, {"title": "subprocess"}] %}
+{% set prev_page = {"url": "api/sqlite.html", "title": "sqlite"} %}
+{% set next_page = {"url": "api/sysinfo.html", "title": "sysinfo"} %}
+
+{% block article %}
+                <h1>subprocess</h1>
+
+                <p>The <code>subprocess</code> module allows running external commands and capturing their output.</p>
+
+                <pre><code>import "subprocess" for Subprocess</code></pre>
+
+                <h2>Subprocess Class</h2>
+
+                <div class="class-header">
+                    <h3>Subprocess</h3>
+                    <p>External process execution</p>
+                </div>
+
+                <h3>Static Methods</h3>
+
+                <div class="method-signature">
+                    <span class="method-name">Subprocess.run</span>(<span class="param">command</span>) → <span class="type">Map</span>
+                </div>
+                <p>Runs a command and waits for it to complete.</p>
+                <ul class="param-list">
+                    <li><span class="param-name">command</span> <span class="param-type">(List)</span> - Command and arguments as a list</li>
+                    <li><span class="returns">Returns:</span> Map with "stdout", "stderr", and "exitCode"</li>
+                </ul>
+                <pre><code>var result = Subprocess.run(["ls", "-la"])
+System.print("Exit code: %(result["exitCode"])")
+System.print("Output: %(result["stdout"])")</code></pre>
+
+                <div class="method-signature">
+                    <span class="method-name">Subprocess.run</span>(<span class="param">command</span>, <span class="param">input</span>) → <span class="type">Map</span>
+                </div>
+                <p>Runs a command with input data provided to stdin.</p>
+                <ul class="param-list">
+                    <li><span class="param-name">command</span> <span class="param-type">(List)</span> - Command and arguments</li>
+                    <li><span class="param-name">input</span> <span class="param-type">(String)</span> - Input to send to stdin</li>
+                </ul>
+                <pre><code>var result = Subprocess.run(["cat"], "Hello, World!")
+System.print(result["stdout"])  // Hello, World!</code></pre>
+
+                <h2>Examples</h2>
+
+                <h3>Running Commands</h3>
+                <pre><code>import "subprocess" for Subprocess
+
+var result = Subprocess.run(["echo", "Hello"])
+System.print(result["stdout"])  // Hello
+
+var files = Subprocess.run(["ls", "-la", "/tmp"])
+System.print(files["stdout"])</code></pre>
+
+                <h3>Checking Exit Codes</h3>
+                <pre><code>import "subprocess" for Subprocess
+
+var result = Subprocess.run(["grep", "pattern", "file.txt"])
+if (result["exitCode"] == 0) {
+    System.print("Found: %(result["stdout"])")
+} else {
+    System.print("Not found or error")
+}</code></pre>
+
+                <h3>Processing Data</h3>
+                <pre><code>import "subprocess" for Subprocess
+import "json" for Json
+
+var result = Subprocess.run(["curl", "-s", "https://api.example.com/data"])
+if (result["exitCode"] == 0) {
+    var data = Json.parse(result["stdout"])
+    System.print(data)
+}</code></pre>
+
+                <h3>Piping Data</h3>
+                <pre><code>import "subprocess" for Subprocess
+
+var input = "line1\nline2\nline3"
+var result = Subprocess.run(["wc", "-l"], input)
+System.print("Lines: %(result["stdout"].trim())")</code></pre>
+
+                <div class="admonition warning">
+                    <div class="admonition-title">Warning</div>
+                    <p>Commands are not executed through a shell. Use explicit command and argument lists, not shell command strings.</p>
+                </div>
+{% endblock %}