Option to ignore inserts if primary key exists already

Support for SQLite's INSERT OR IGNORE

In the API layer it looks like this:

    fresh_db["test"].insert({"id": 1, "bar": 3}, ignore=True)

For the CLI layer it looks like this:

    $ sqlite-utils insert data.db dogs dogs.json --ignore

Closes #21

tests/test_cli.py

@@ -362,6 +362,27 @@ def test_insert_newline_delimited(db_path):
     ] == db.execute_returning_dicts("select foo, n from from_json_nl")
 
 
+def test_insert_ignore(db_path, tmpdir):
+    db = Database(db_path)
+    db["dogs"].insert({"id": 1, "name": "Cleo"}, pk="id")
+    json_path = str(tmpdir / "dogs.json")
+    open(json_path, "w").write(json.dumps([{"id": 1, "name": "Bailey"}]))
+    # Should raise error without --ignore
+    result = CliRunner().invoke(
+        cli.cli, ["insert", db_path, "dogs", json_path, "--pk", "id"]
+    )
+    assert 0 != result.exit_code, result.output
+    # If we use --ignore it should run OK
+    result = CliRunner().invoke(
+        cli.cli, ["insert", db_path, "dogs", json_path, "--pk", "id", "--ignore"]
+    )
+    assert 0 == result.exit_code, result.output
+    # ... but it should actually have no effect
+    assert [{"id": 1, "name": "Cleo"}] == db.execute_returning_dicts(
+        "select * from dogs"
+    )
+
+
 def test_upsert(db_path, tmpdir):
     test_insert_multiple_with_primary_key(db_path, tmpdir)
     json_path = str(tmpdir / "upsert.json")

tests/test_create.py

@@ -392,6 +392,18 @@ def test_insert_thousands_ignores_extra_columns_after_first_100(fresh_db):
     assert [{"i": 101, "word": None}] == rows
 
 
+def test_insert_ignore(fresh_db):
+    fresh_db["test"].insert({"id": 1, "bar": 2}, pk="id")
+    # Should raise an error if we try this again
+    with pytest.raises(sqlite3.IntegrityError):
+        fresh_db["test"].insert({"id": 1, "bar": 2}, pk="id")
+    # Using ignore=True should cause our insert to be silently ignored
+    fresh_db["test"].insert({"id": 1, "bar": 3}, pk="id", ignore=True)
+    # Only one row, and it should be bar=2, not bar=3
+    rows = fresh_db.execute_returning_dicts("select * from test")
+    assert [{"id": 1, "bar": 2}] == rows
+
+
 def test_insert_hash_id(fresh_db):
     dogs = fresh_db["dogs"]
     id = dogs.upsert({"name": "Cleo", "twitter": "cleopaws"}, hash_id="id").last_pk