sqlite-utils rows --order option, closes #469

docs/cli-reference.rst

@@ -713,6 +713,7 @@ See :ref:`cli_rows`.
     Options:
       -c, --column TEXT           Columns to return
       --where TEXT                Optional where clause
+      -o, --order TEXT            Order by ('column' or 'column desc')
       -p, --param <TEXT TEXT>...  Named :parameters for where clause
       --limit INTEGER             Number of rows to return - defaults to everything
       --offset INTEGER            SQL offset to use

docs/cli.rst

@@ -467,6 +467,8 @@ Or pass named parameters using ``--where`` in combination with ``-p``::
     $ sqlite-utils rows dogs.db dogs -c name --where 'name = :name' -p name Cleo
     [{"name": "Cleo"}]
 
+You can define a sort order using ``--order column`` or ``--order 'column desc'``.
+
 Use ``--limit N`` to only return the first ``N`` rows. Use ``--offset N`` to return rows starting from the specified offset.
 
 .. note::

sqlite_utils/cli.py

@@ -1985,6 +1985,7 @@ def search(
 @click.argument("dbtable")
 @click.option("-c", "--column", type=str, multiple=True, help="Columns to return")
 @click.option("--where", help="Optional where clause")
+@click.option("-o", "--order", type=str, help="Order by ('column' or 'column desc')")
 @click.option(
     "-p",
     "--param",
@@ -2011,6 +2012,7 @@ def rows(
     dbtable,
     column,
     where,
+    order,
     param,
     limit,
     offset,
@@ -2037,6 +2039,8 @@ def rows(
     sql = "select {} from [{}]".format(columns, dbtable)
     if where:
         sql += " where " + where
+    if order:
+        sql += " order by " + order
     if limit:
         sql += " limit {}".format(limit)
     if offset:

tests/test_cli.py

@@ -881,6 +881,15 @@ def test_query_memory_does_not_create_file(tmpdir):
             ["-c", "name", "--where", "id = :id", "--param", "id", "1"],
             '[{"name": "Cleo"}]',
         ),
+        # --order
+        (
+            ["-c", "id", "--order", "id desc", "--limit", "1"],
+            '[{"id": 2}]',
+        ),
+        (
+            ["-c", "id", "--order", "id", "--limit", "1"],
+            '[{"id": 1}]',
+        ),
     ],
 )
 def test_rows(db_path, args, expected):