sqlite-utils bulk command

[simonw]

Refs #375

Still needs:

• Refactor @insert_upsert_options so that it doesn't duplicate @import_options
• Tests
• Documentation
• Try it against a really big file

[codecov]

Codecov Report

Merging #377 (f4ea0d3) into main (b6dad08) will decrease coverage by 0.01%.
The diff coverage is 96.00%.

@@            Coverage Diff             @@
##             main     #377      +/-   ##
==========================================
- Coverage   96.52%   96.50%   -0.02%     
==========================================
  Files           6        6              
  Lines        2330     2378      +48     
==========================================
+ Hits         2249     2295      +46     
- Misses         81       83       +2     

Impacted Files	Coverage Δ
sqlite_utils/cli.py	95.49% <94.28%> (-0.06%)	⬇️
sqlite_utils/db.py	97.68% <100.00%> (+0.03%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update b6dad08...f4ea0d3. Read the comment docs.

[simonw]

Documentation: https://github.com/simonw/sqlite-utils/blob/f4ea0d32c0543373eefaa9b9f3911eb07549eecb/docs/cli.rst#executing-sql-in-bulk

[simonw]

I tested this like so:

% wget 'https://raw.githubusercontent.com/wri/global-power-plant-database/master/output_database/global_power_plant_database.csv'
% sqlite-utils create-database test.db
% sqlite-utils create-table test.db power_plants url text owner text
% sqlite-utils schema test.db 
CREATE TABLE [power_plants] (
   [url] TEXT,
   [owner] TEXT
);
% sqlite-utils bulk test.db 'insert into power_plants (url, owner) values (:url, :owner)' global_power_plant_database.csv --csv
  [------------------------------------]    0%
  [###################################-]   99%
% sqlite-utils tables --counts test.db -t
table           count
------------  -------
power_plants    33643