Deprecate usethis ci in v0.19.0 ahead of removal in v0.20.0 (#1416)

Copilot · nathanjmcdougall · web-flow · commit c00d2f01a205 · 2026-03-13T21:12:08.000+13:00
* Initial plan

* Deprecate `usethis ci` command ahead of removal in v0.20.0

Co-authored-by: nathanjmcdougall &lt;18602289+nathanjmcdougall@users.noreply.github.com&gt;

* Move deprecated=True to Typer() constructor instead of @app.command()

Co-authored-by: nathanjmcdougall &lt;18602289+nathanjmcdougall@users.noreply.github.com&gt;

---------

Co-authored-by: copilot-swe-agent[bot] &lt;198982749+Copilot@users.noreply.github.com&gt;
Co-authored-by: nathanjmcdougall &lt;18602289+nathanjmcdougall@users.noreply.github.com&gt;
diff --git a/src/usethis/_ui/app.py b/src/usethis/_ui/app.py
@@ -69,7 +69,12 @@
 )(
     usethis._ui.interface.test.test,
 )
-app.add_typer(usethis._ui.interface.ci.app, name="ci", rich_help_panel=rich_help_panel)
+app.add_typer(
+    usethis._ui.interface.ci.app,
+    name="ci",
+    rich_help_panel=rich_help_panel,
+    deprecated=True,
+)
 app.add_typer(
     usethis._ui.interface.tool.app, name="tool", rich_help_panel=rich_help_panel
 )
diff --git a/src/usethis/_ui/interface/ci.py b/src/usethis/_ui/interface/ci.py
@@ -5,7 +5,9 @@
 from usethis._ui.options import backend_opt, frozen_opt, offline_opt, quiet_opt
 
 app = typer.Typer(
-    help="Add config for Continuous Integration (CI) pipelines.", add_completion=False
+    help="Add config for Continuous Integration (CI) pipelines.",
+    add_completion=False,
+    deprecated=True,
 )
 
 
@@ -25,12 +27,14 @@ def bitbucket(
     backend: BackendEnum = backend_opt,
 ) -> None:
     from usethis._config_file import files_manager
-    from usethis._console import err_print
+    from usethis._console import err_print, warn_print
     from usethis._core.ci import use_ci_bitbucket
     from usethis.errors import UsethisError
 
     assert isinstance(backend, BackendEnum)
 
+    warn_print("'usethis ci' is deprecated and will be removed in v0.20.0.")
+
     with (
         usethis_config.set(
             offline=offline,
diff --git a/tests/usethis/_ui/interface/test_ci.py b/tests/usethis/_ui/interface/test_ci.py
@@ -37,6 +37,7 @@ def test_readme_example(self, tmp_path: Path):
         assert (
             result.output
             == """\
+⚠ 'usethis ci' is deprecated and will be removed in v0.20.0.
 ✔ Writing 'bitbucket-pipelines.yml'.
 ✔ Adding cache 'uv' definition to 'bitbucket-pipelines.yml'.
 ✔ Adding 'Run Ruff' to default pipeline in 'bitbucket-pipelines.yml'.
@@ -57,6 +58,7 @@ def test_none_backend(self, tmp_path: Path):
         assert result.exit_code == 0, result.output
         assert (tmp_path / "bitbucket-pipelines.yml").exists()
         assert result.output == (
+            "⚠ 'usethis ci' is deprecated and will be removed in v0.20.0.\n"
             "✔ Writing 'bitbucket-pipelines.yml'.\n"
             "✔ Adding placeholder step to default pipeline in 'bitbucket-pipelines.yml'.\n"
             "☐ Remove the placeholder pipeline step in 'bitbucket-pipelines.yml'.\n"

Original file line number	Diff line number	Diff line change
`@@ -69,7 +69,12 @@`
`69`	`69`	`)(`
`70`	`70`	`usethis._ui.interface.test.test,`
`71`	`71`	`)`
`72`		`-app.add_typer(usethis._ui.interface.ci.app, name="ci", rich_help_panel=rich_help_panel)`
	`72`	`+app.add_typer(`
	`73`	`+ usethis._ui.interface.ci.app,`
	`74`	`+ name="ci",`
	`75`	`+ rich_help_panel=rich_help_panel,`
	`76`	`+ deprecated=True,`
	`77`	`+)`
`73`	`78`	`app.add_typer(`
`74`	`79`	`usethis._ui.interface.tool.app, name="tool", rich_help_panel=rich_help_panel`
`75`	`80`	`)`