Better help for sqlite-utils create-table

simonw · May 29, 2021 · b3d11f5 · b3d11f5
1 parent 9a8c6fa
commit b3d11f5
Show file tree

Hide file tree

Showing 2 changed files with 11 additions and 1 deletion.
diff --git a/docs/dogs.db b/docs/dogs.db
diff --git a/sqlite_utils/cli.py b/sqlite_utils/cli.py
@@ -922,7 +922,17 @@ def upsert(
 def create_table(
     path, table, columns, pk, not_null, default, fk, ignore, replace, load_extension
 ):
-    "Add a table with the specified columns"
+    """
+    Add a table with the specified columns. Columns should be specified using
+    name, type pairs, for example:
+
+    \b
+    sqlite-utils create-table my.db people \\
+        id integer \\
+        name text \\
+        height float \\
+        photo blob --pk id
+    """
     db = sqlite_utils.Database(path)
     _load_extensions(db, load_extension)
     if len(columns) % 2 == 1: