issue_comments

CLI documentation:

• https://sqlite-utils.datasette.io/en/latest/cli.html#renaming-a-table
• https://sqlite-utils.datasette.io/en/latest/cli-reference.html#rename-table

Python method documentation: - https://sqlite-utils.datasette.io/en/latest/reference.html#sqlite_utils.db.Database.rename_table - https://sqlite-utils.datasette.io/en/latest/python-api.html#renaming-a-table

Manually testing new rename-table command: $ sqlite-utils schema /tmp/f.db CREATE TABLE [foo] ( [id] INTEGER, [name] TEXT ); $ sqlite-utils rename-table /tmp/f.db bad-table hi Error: Table "bad-table" could not be renamed. no such table: bad-table $ sqlite-utils rename-table /tmp/f.db foo foo Error: Table "foo" could not be renamed. there is already another table or index with this name: foo $ sqlite-utils rename-table /tmp/f.db foo bar $ sqlite-utils schema /tmp/f.db CREATE TABLE "bar" ( [id] INTEGER, [name] TEXT );

Also need a design for an option for the .transform() method to indicate that the new table should be created with a new name without dropping the old one.

I think keep_table="name_of_table" is good for this.

Trying out a simple first implementation: ```pycon

from sqlite_utils import Database db = Database(memory=True, tracer=print) PRAGMA recursive_triggers=on; None db["foo"].insert({"id": 1}) select name from sqlite_master where type = 'view' None select name from sqlite_master where type = 'table' None select name from sqlite_master where type = 'view' None select name from sqlite_master where type = 'table' None select name from sqlite_master where type = 'view' None CREATE TABLE [foo] ( [id] INTEGER ); None select name from sqlite_master where type = 'view' None INSERT INTO [foo] ([id]) VALUES (?); [1] select name from sqlite_master where type = 'table' None select name from sqlite_master where type = 'table' None PRAGMA table_info([foo]) None

For the CLI:

bash sqlite-utils rename-table data.db old_table_name new_table_name

For the Python code, should it go on Table or on Database? ```python db["foo"].rename_table("bar")

db.rename_table("foo", "bar") ``` I think I like the second better, it's slightly more clear.

Also need a design for an option for the .transform() method to indicate that the new table should be created with a new name without dropping the old one.