aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorHåkon Solbjørg <hlsolbjorg@gmail.com>2019-04-02 01:18:25 +0200
committerHåkon Solbjørg <hlsolbjorg@gmail.com>2019-04-02 19:56:29 +0200
commit7b2c213167401f8100031f38c61679b161d5d73e (patch)
tree5f15babaa92fc66ff9c6367b38d35e7b89b88e12
parenteb5106409259144159c46cd4c2470621f4d6abe9 (diff)
chore: Update README with some instructions 📝
-rw-r--r--README.rst23
1 files changed, 23 insertions, 0 deletions
diff --git a/README.rst b/README.rst
index 7ea2815..c242d3c 100644
--- a/README.rst
+++ b/README.rst
@@ -2,3 +2,26 @@ TG label scripts
================
Scripts.
+
+Usage
+-----
+
+The ``--help`` parameter is pretty helpful.
+
+Run the script with either ``cables`` or ``switches``,
+depending if you want labels for cables or switches.
+Configure the application further if needed. Consult ``--help``.
+
+Specify gondul credentials either using environment variables
+(``GONDUL_USERNAME``, ``GONDUL_PASSWORD``) or the command line.
+It's also possible to update the API root or API endpoint to use,
+as well as a regex for matching switches.
+
+Specify the output file with the ``--outfile`` argument.
+
+For cables, specify the number of uplinks (``--uplinks``),
+copies (``--copies``) and when to split (``--split``)
+the CSV files for the label printer. Supply APs to print
+labels for them to, either by identifying the switch with ``--ap``
+or by supplying a newline-separated file of switch identifiers
+through ``--aps-file`` (e.g. ``33-1`` to add an AP to that switch).