docs: improve helper example section

glennie · glennie · commit 6ae421b1c255 · 2021-08-29T15:12:45.000+02:00
Added an example for using envrionement variable for tokens.
diff --git a/docs/cli-usage.rst b/docs/cli-usage.rst
@@ -170,6 +170,25 @@ In `/path/to/helper.sh`:
 
     #!/bin/bash
     pass show path/to/password | head -n 1
+    
+Example for an `environnement variable`:
+
+.. code-block:: ini
+
+   [global]
+   default = somewhere
+   ssl_verify = true
+   timeout = 5
+
+   [somewhere]
+   url = http://somewhe.re
+   private_token = helper: printf -- '%%s' ${GITLAB_TOKEN}
+   timeout = 1
+
+**Notice:**
+
+   * ``printf`` is the executable provided by coreutils package (on a debian based distribution).
+   * ``%`` must be escaped using an other `%` (in order to allow `configparser` load configuration properly.
 
 CLI
 ===
