From 0c5c4bdbd6e03ec4e6cd970cde387306c791cb54 Mon Sep 17 00:00:00 2001
From: Nathan McDougall <nathan.j.mcdougall@gmail.com>
Date: Wed, 18 Jun 2025 22:22:41 +1200
Subject: [PATCH 1/6] Add README draft

---
 README.md | 64 +++++++++++++++++++++++++++++++++++++------------------
 1 file changed, 43 insertions(+), 21 deletions(-)

diff --git a/README.md b/README.md
index 143da5e0..f7a77cb6 100644
--- a/README.md
+++ b/README.md
@@ -85,6 +85,7 @@ $ pipx run usethis tool ruff
 - [`usethis author`](#usethis-author) — Set new author information for the project.
 - [`usethis docstyle`](#usethis-docstyle-style) — Set new author information for the project.
 - [`usethis rule`](#usethis-rule-rulecode) — Set a docstring style convention for the project, and [enforce it with Ruff](https://docs.astral.sh/ruff/rules/#pydocstyle-d).
+- [`usethis status`](#usethis-status-status) — Set the development status of the project (via trove classifiers).
 
 ### Manage README
 
@@ -349,23 +350,27 @@ Supported options:
 - `--offline` to disable network access and rely on caches
 - `--quiet` to suppress output
 
-### `usethis rule <rulecode>`
+### `usethis readme`
 
-Add (or manage configuration) of Ruff and Deptry rules in `pyproject.toml`.
+Add a README.md file to the project.
 
-See [the Ruff documentation](https://docs.astral.sh/ruff/rules/) for a list of available
-rules, and [the Deptry documentation](https://deptry.com/rules-violations/) for a list
-of available rules.
+Supported options:
 
-Example:
+- `--quiet` to suppress output
+- `--badges` to also add badges to the README.md file
 
-`usethis rule RUF001`
+### `usethis author`
 
-Supported options:
+Set new author information for the project.
 
-- `--remove` to remove the rule selection or ignore status.
-- `--ignore` to add the rule to the ignore list (or remove it if --remove is specified).
-- `--offline` to disable network access and rely on caches
+Required options:
+
+- `--name` for the new author's name
+
+Other supported options:
+
+- `--email` to set the author email address
+- `--overwrite` to overwrite all existing author information
 - `--quiet` to suppress output
 
 ### `usethis docstyle <style>`
@@ -388,28 +393,45 @@ Supported options:
 
 - `--quiet` to suppress output
 
-### `usethis readme`
+### `usethis rule <rulecode>`
 
-Add a README.md file to the project.
+Add (or manage configuration) of Ruff and Deptry rules in `pyproject.toml`.
+
+See [the Ruff documentation](https://docs.astral.sh/ruff/rules/) for a list of available
+rules, and [the Deptry documentation](https://deptry.com/rules-violations/) for a list
+of available rules.
+
+Example:
+
+`usethis rule RUF001`
 
 Supported options:
 
+- `--remove` to remove the rule selection or ignore status.
+- `--ignore` to add the rule to the ignore list (or remove it if --remove is specified).
+- `--offline` to disable network access and rely on caches
 - `--quiet` to suppress output
-- `--badges` to also add badges to the README.md file
 
-### `usethis author`
+### `usethis status <status>`
 
-Set new author information for the project.
+Set the development status of the project via trove classifiers.
 
-Required options:
+By default, the status is set to "Development Status :: 1 - Planning".
 
-- `--name` for the new author's name
+Possible values:
 
-Other supported options:
+- `usethis status planning` or `usethis status 1` for "Development Status :: 1 - Planning"
+- `usethis status pre-alpha` or `usethis status 2` for "Development Status :: 2 - Pre-Alpha"
+- `usethis status alpha` or `usethis status 3` for "Development Status :: 3 - Alpha"
+- `usethis status beta` or `usethis status 4` for "Development Status :: 4 - Beta"
+- `usethis status production` or `usethis status 5` for "Development Status :: 5 - Production/Stable"
+- `usethis status mature` or `usethis status 6` for "Development Status :: 6 - Mature"
+- `usethis status inactive` or `usethis status 7` for "Development Status :: 7 - Inactive"
+
+Supported options:
 
-- `--email` to set the author email address
-- `--overwrite` to overwrite all existing author information
 - `--quiet` to suppress output
+- `--badges` to add an associated badge to the README file
 
 ### `usethis list`
 

From a7175cd51cb2dcdfa47d795518f804e780ab8bf9 Mon Sep 17 00:00:00 2001
From: Nathan McDougall <nathan.j.mcdougall@gmail.com>
Date: Thu, 19 Jun 2025 14:53:15 +1200
Subject: [PATCH 2/6] Set up basic scaffolding

---
 pyproject.toml                   |  4 ++--
 src/usethis/_app.py              |  7 +++++++
 src/usethis/_core/status.py      | 27 +++++++++++++++++++++++++++
 src/usethis/_interface/status.py | 29 +++++++++++++++++++++++++++++
 4 files changed, 65 insertions(+), 2 deletions(-)
 create mode 100644 src/usethis/_core/status.py
 create mode 100644 src/usethis/_interface/status.py

diff --git a/pyproject.toml b/pyproject.toml
index 0c7c0169..8c500c9d 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -198,7 +198,7 @@ name = "usethis._interface"
 type = "layers"
 layers = [
   # Note; if you're adding an interface, make sure it's in the README too.
-  "author | badge | browse | ci | docstyle | format_ | init | lint | list | readme | rule | show | spellcheck | test | tool | version",
+  "author | badge | browse | ci | docstyle | format_ | init | lint | list | readme | rule | show | spellcheck | status | test | tool | version",
 ]
 containers = [ "usethis._interface" ]
 exhaustive = true
@@ -209,7 +209,7 @@ type = "layers"
 layers = [
   # docstyle uses (Ruff) tool, badge uses readme
   "badge | docstyle | list | rule",
-  "author | browse | ci | readme | show | tool",
+  "author | browse | ci | readme | show | status | tool",
 ]
 containers = [ "usethis._core" ]
 exhaustive = true
diff --git a/src/usethis/_app.py b/src/usethis/_app.py
index f4332289..b29904a0 100644
--- a/src/usethis/_app.py
+++ b/src/usethis/_app.py
@@ -15,6 +15,7 @@
 import usethis._interface.rule
 import usethis._interface.show
 import usethis._interface.spellcheck
+import usethis._interface.status
 import usethis._interface.test
 import usethis._interface.tool
 import usethis._interface.version
@@ -76,6 +77,12 @@
 )(
     usethis._interface.rule.rule,
 )
+app.command(
+    help="Set the development status of the project (via trove classifiers).",
+    rich_help_panel=rich_help_panel,
+)(
+    usethis._interface.status.status,
+)
 
 rich_help_panel = "Manage README"
 app.add_typer(
diff --git a/src/usethis/_core/status.py b/src/usethis/_core/status.py
new file mode 100644
index 00000000..1232444c
--- /dev/null
+++ b/src/usethis/_core/status.py
@@ -0,0 +1,27 @@
+from enum import Enum
+
+
+class DevelopmentStatusEnum(Enum):
+    planning = "planning"
+    prealpha = "prealpha"
+    alpha = "alpha"
+    beta = "beta"
+    production = "production"
+    mature = "mature"
+    inactive = "inactive"
+
+
+class DevelopmentStatusCodeEnum(Enum):
+    planning = 1
+    prealpha = 2
+    alpha = 3
+    beta = 4
+    production = 5
+    mature = 6
+    inactive = 7
+
+
+def use_development_status(
+    status: DevelopmentStatusEnum | DevelopmentStatusCodeEnum,
+) -> None:
+    raise NotImplementedError
diff --git a/src/usethis/_interface/status.py b/src/usethis/_interface/status.py
new file mode 100644
index 00000000..33f80339
--- /dev/null
+++ b/src/usethis/_interface/status.py
@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+import typer
+
+from usethis._config import quiet_opt, usethis_config
+from usethis._config_file import files_manager
+from usethis._console import err_print
+from usethis._core.status import (
+    DevelopmentStatusCodeEnum,
+    DevelopmentStatusEnum,
+    use_development_status,
+)
+from usethis.errors import UsethisError
+
+
+def status(
+    status: DevelopmentStatusEnum | DevelopmentStatusCodeEnum = typer.Argument(
+        default="planning", help="Docstring style to enforce."
+    ),
+    quiet: bool = quiet_opt,
+) -> None:
+    assert isinstance(status, DevelopmentStatusEnum | DevelopmentStatusCodeEnum)
+
+    with usethis_config.set(quiet=quiet), files_manager():
+        try:
+            use_development_status(status)
+        except UsethisError as err:
+            err_print(err)
+            raise typer.Exit(code=1) from None

From ddee1f97c30497b754e737e480796a31627b8b11 Mon Sep 17 00:00:00 2001
From: Nathan McDougall <nathan.j.mcdougall@gmail.com>
Date: Fri, 20 Jun 2025 20:13:43 +1200
Subject: [PATCH 3/6] Implement use_development_status with tests

---
 src/usethis/_core/status.py                |  73 ++++++-
 src/usethis/_integrations/file/toml/io_.py |   4 +-
 src/usethis/_interface/status.py           |   5 +-
 tests/usethis/_core/test_status.py         | 241 +++++++++++++++++++++
 4 files changed, 306 insertions(+), 17 deletions(-)
 create mode 100644 tests/usethis/_core/test_status.py

diff --git a/src/usethis/_core/status.py b/src/usethis/_core/status.py
index 1232444c..3db5f228 100644
--- a/src/usethis/_core/status.py
+++ b/src/usethis/_core/status.py
@@ -1,27 +1,76 @@
+from __future__ import annotations
+
 from enum import Enum
 
+from usethis._console import tick_print
+from usethis._integrations.file.pyproject_toml.io_ import PyprojectTOMLManager
+from usethis._integrations.uv.init import ensure_pyproject_toml
+
 
 class DevelopmentStatusEnum(Enum):
     planning = "planning"
+    planning_code = "1"
     prealpha = "prealpha"
+    prealpha_code = "2"
     alpha = "alpha"
+    alpha_code = "3"
     beta = "beta"
+    beta_code = "4"
     production = "production"
+    production_code = "5"
     mature = "mature"
+    mature_code = "6"
     inactive = "inactive"
-
-
-class DevelopmentStatusCodeEnum(Enum):
-    planning = 1
-    prealpha = 2
-    alpha = 3
-    beta = 4
-    production = 5
-    mature = 6
-    inactive = 7
+    inactive_code = "7"
 
 
 def use_development_status(
-    status: DevelopmentStatusEnum | DevelopmentStatusCodeEnum,
+    status: DevelopmentStatusEnum,
 ) -> None:
-    raise NotImplementedError
+    ensure_pyproject_toml()
+
+    new_classifier = _STATUS_TO_CLASSIFIER_MAP[status]
+
+    dispstatus = new_classifier.removeprefix("Development Status :: ")
+
+    tick_print(f"Setting development status to '{dispstatus}'.")
+
+    mgr = PyprojectTOMLManager()
+    try:
+        existing_classifiers = mgr[["project", "classifiers"]]
+    except KeyError:
+        existing_classifiers = []
+    existing_status_classifiers = {
+        classifier
+        for classifier in existing_classifiers
+        if classifier in STATUS_CLASSIFIERS
+    }
+    mgr.remove_from_list(
+        keys=["project", "classifiers"],
+        values=existing_status_classifiers,
+    )
+
+    mgr.extend_list(
+        keys=["project", "classifiers"],
+        values=[new_classifier],
+    )
+
+
+_STATUS_TO_CLASSIFIER_MAP = {
+    DevelopmentStatusEnum.planning: "Development Status :: 1 - Planning",
+    DevelopmentStatusEnum.planning_code: "Development Status :: 1 - Planning",
+    DevelopmentStatusEnum.prealpha: "Development Status :: 2 - Pre-Alpha",
+    DevelopmentStatusEnum.prealpha_code: "Development Status :: 2 - Pre-Alpha",
+    DevelopmentStatusEnum.alpha: "Development Status :: 3 - Alpha",
+    DevelopmentStatusEnum.alpha_code: "Development Status :: 3 - Alpha",
+    DevelopmentStatusEnum.beta: "Development Status :: 4 - Beta",
+    DevelopmentStatusEnum.beta_code: "Development Status :: 4 - Beta",
+    DevelopmentStatusEnum.production: "Development Status :: 5 - Production/Stable",
+    DevelopmentStatusEnum.production_code: "Development Status :: 5 - Production/Stable",
+    DevelopmentStatusEnum.mature: "Development Status :: 6 - Mature",
+    DevelopmentStatusEnum.mature_code: "Development Status :: 6 - Mature",
+    DevelopmentStatusEnum.inactive: "Development Status :: 7 - Inactive",
+    DevelopmentStatusEnum.inactive_code: "Development Status :: 7 - Inactive",
+}
+
+STATUS_CLASSIFIERS = set(_STATUS_TO_CLASSIFIER_MAP.values())
diff --git a/src/usethis/_integrations/file/toml/io_.py b/src/usethis/_integrations/file/toml/io_.py
index 04fd6973..096c3fbe 100644
--- a/src/usethis/_integrations/file/toml/io_.py
+++ b/src/usethis/_integrations/file/toml/io_.py
@@ -31,7 +31,7 @@
 )
 
 if TYPE_CHECKING:
-    from collections.abc import Sequence
+    from collections.abc import Collection, Sequence
     from pathlib import Path
     from typing import ClassVar
 
@@ -278,7 +278,7 @@ def extend_list(self, *, keys: Sequence[Key], values: list[Any]) -> None:
 
         self.commit(toml_document)
 
-    def remove_from_list(self, *, keys: Sequence[Key], values: list[Any]) -> None:
+    def remove_from_list(self, *, keys: Sequence[Key], values: Collection[Any]) -> None:
         if not keys:
             msg = "At least one ID key must be provided."
             raise ValueError(msg)
diff --git a/src/usethis/_interface/status.py b/src/usethis/_interface/status.py
index 33f80339..da523cf8 100644
--- a/src/usethis/_interface/status.py
+++ b/src/usethis/_interface/status.py
@@ -6,7 +6,6 @@
 from usethis._config_file import files_manager
 from usethis._console import err_print
 from usethis._core.status import (
-    DevelopmentStatusCodeEnum,
     DevelopmentStatusEnum,
     use_development_status,
 )
@@ -14,12 +13,12 @@
 
 
 def status(
-    status: DevelopmentStatusEnum | DevelopmentStatusCodeEnum = typer.Argument(
+    status: DevelopmentStatusEnum = typer.Argument(
         default="planning", help="Docstring style to enforce."
     ),
     quiet: bool = quiet_opt,
 ) -> None:
-    assert isinstance(status, DevelopmentStatusEnum | DevelopmentStatusCodeEnum)
+    assert isinstance(status, DevelopmentStatusEnum)
 
     with usethis_config.set(quiet=quiet), files_manager():
         try:
diff --git a/tests/usethis/_core/test_status.py b/tests/usethis/_core/test_status.py
new file mode 100644
index 00000000..894f01d4
--- /dev/null
+++ b/tests/usethis/_core/test_status.py
@@ -0,0 +1,241 @@
+from pathlib import Path
+
+import pytest
+
+from usethis._core.status import DevelopmentStatusEnum, use_development_status
+from usethis._integrations.file.pyproject_toml.io_ import PyprojectTOMLManager
+from usethis._test import change_cwd
+
+
+class TestUseDevelopmentStatus:
+    def test_planning(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
+        # Arrange
+        status = DevelopmentStatusEnum.planning
+
+        # Act
+        with change_cwd(uv_init_dir), PyprojectTOMLManager():
+            use_development_status(status)
+
+        # Assert
+        assert (
+            "Development Status :: 1 - Planning"
+            in uv_init_dir.joinpath("pyproject.toml").read_text()
+        )
+        with PyprojectTOMLManager() as mgr:
+            assert (
+                "Development Status :: 1 - Planning" in mgr[["project", "classifiers"]]
+            )
+        out, err = capfd.readouterr()
+        assert not err
+        assert out == "✔ Setting development status to '1 - Planning'.\n"
+
+    def test_prealpha(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
+        # Arrange
+        status = DevelopmentStatusEnum.prealpha
+
+        # Act
+        with change_cwd(uv_init_dir), PyprojectTOMLManager():
+            use_development_status(status)
+
+        # Assert
+        assert (
+            "Development Status :: 2 - Pre-Alpha"
+            in uv_init_dir.joinpath("pyproject.toml").read_text()
+        )
+        with PyprojectTOMLManager() as mgr:
+            assert (
+                "Development Status :: 2 - Pre-Alpha" in mgr[["project", "classifiers"]]
+            )
+        out, err = capfd.readouterr()
+        assert not err
+        assert out == "✔ Setting development status to '2 - Pre-Alpha'.\n"
+
+    def test_alpha(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
+        # Arrange
+        status = DevelopmentStatusEnum.alpha
+
+        # Act
+        with change_cwd(uv_init_dir), PyprojectTOMLManager():
+            use_development_status(status)
+
+        # Assert
+        assert (
+            "Development Status :: 3 - Alpha"
+            in uv_init_dir.joinpath("pyproject.toml").read_text()
+        )
+        with PyprojectTOMLManager() as mgr:
+            assert "Development Status :: 3 - Alpha" in mgr[["project", "classifiers"]]
+        out, err = capfd.readouterr()
+        assert not err
+        assert out == "✔ Setting development status to '3 - Alpha'.\n"
+
+    def test_beta(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
+        # Arrange
+        status = DevelopmentStatusEnum.beta
+
+        # Act
+        with change_cwd(uv_init_dir), PyprojectTOMLManager():
+            use_development_status(status)
+
+        # Assert
+        assert (
+            "Development Status :: 4 - Beta"
+            in uv_init_dir.joinpath("pyproject.toml").read_text()
+        )
+        with PyprojectTOMLManager() as mgr:
+            assert "Development Status :: 4 - Beta" in mgr[["project", "classifiers"]]
+        out, err = capfd.readouterr()
+        assert not err
+        assert out == "✔ Setting development status to '4 - Beta'.\n"
+
+    def test_production(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
+        # Arrange
+        status = DevelopmentStatusEnum.production
+
+        # Act
+        with change_cwd(uv_init_dir), PyprojectTOMLManager():
+            use_development_status(status)
+
+        # Assert
+        assert (
+            "Development Status :: 5 - Production/Stable"
+            in uv_init_dir.joinpath("pyproject.toml").read_text()
+        )
+        with PyprojectTOMLManager() as mgr:
+            assert (
+                "Development Status :: 5 - Production/Stable"
+                in mgr[["project", "classifiers"]]
+            )
+        out, err = capfd.readouterr()
+        assert not err
+        assert out == "✔ Setting development status to '5 - Production/Stable'.\n"
+
+    def test_mature(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
+        # Arrange
+        status = DevelopmentStatusEnum.mature
+
+        # Act
+        with change_cwd(uv_init_dir), PyprojectTOMLManager():
+            use_development_status(status)
+
+        # Assert
+        assert (
+            "Development Status :: 6 - Mature"
+            in uv_init_dir.joinpath("pyproject.toml").read_text()
+        )
+        with PyprojectTOMLManager() as mgr:
+            assert "Development Status :: 6 - Mature" in mgr[["project", "classifiers"]]
+        out, err = capfd.readouterr()
+        assert not err
+        assert out == "✔ Setting development status to '6 - Mature'.\n"
+
+    def test_inactive(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
+        # Arrange
+        status = DevelopmentStatusEnum.inactive
+
+        # Act
+        with change_cwd(uv_init_dir), PyprojectTOMLManager():
+            use_development_status(status)
+
+        # Assert
+        assert (
+            "Development Status :: 7 - Inactive"
+            in uv_init_dir.joinpath("pyproject.toml").read_text()
+        )
+        with PyprojectTOMLManager() as mgr:
+            assert (
+                "Development Status :: 7 - Inactive" in mgr[["project", "classifiers"]]
+            )
+        out, err = capfd.readouterr()
+        assert not err
+        assert out == "✔ Setting development status to '7 - Inactive'.\n"
+
+    def test_no_pyproject_toml(self, tmp_path: Path, capfd: pytest.CaptureFixture[str]):
+        # Arrange
+        status = DevelopmentStatusEnum.planning
+
+        # Act
+        with change_cwd(tmp_path), PyprojectTOMLManager():
+            use_development_status(status)
+
+        # Assert
+        out, err = capfd.readouterr()
+        assert not err
+        assert out == (
+            "✔ Writing 'pyproject.toml'.\n"
+            "✔ Setting development status to '1 - Planning'.\n"
+        )
+
+    def test_replace_existing_classifier(
+        self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]
+    ):
+        # Arrange
+        status = DevelopmentStatusEnum.beta
+
+        # Create an existing classifier
+        (uv_init_dir / "pyproject.toml").write_text(
+            """\
+[project]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+]
+"""
+        )
+
+        # Act
+        with change_cwd(uv_init_dir), PyprojectTOMLManager():
+            use_development_status(status)
+
+        # Assert
+        assert (
+            "Development Status :: 4 - Beta"
+            in uv_init_dir.joinpath("pyproject.toml").read_text()
+        )
+        with PyprojectTOMLManager() as mgr:
+            assert mgr[["project", "classifiers"]] == ["Development Status :: 4 - Beta"]
+            assert (
+                "Development Status :: 3 - Alpha" not in mgr[["project", "classifiers"]]
+            )
+        out, err = capfd.readouterr()
+        assert not err
+        assert out == "✔ Setting development status to '4 - Beta'.\n"
+
+    def test_replace_multiple_existing_classifiers(
+        self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]
+    ):
+        # Arrange
+        status = DevelopmentStatusEnum.production
+
+        # Create existing classifiers
+        (uv_init_dir / "pyproject.toml").write_text(
+            """\
+[project]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Development Status :: 4 - Beta",
+]
+"""
+        )
+
+        # Act
+        with change_cwd(uv_init_dir), PyprojectTOMLManager():
+            use_development_status(status)
+
+        # Assert
+        assert (
+            "Development Status :: 5 - Production/Stable"
+            in uv_init_dir.joinpath("pyproject.toml").read_text()
+        )
+        with PyprojectTOMLManager() as mgr:
+            assert mgr[["project", "classifiers"]] == [
+                "Development Status :: 5 - Production/Stable"
+            ]
+            assert (
+                "Development Status :: 3 - Alpha" not in mgr[["project", "classifiers"]]
+            )
+            assert (
+                "Development Status :: 4 - Beta" not in mgr[["project", "classifiers"]]
+            )
+        out, err = capfd.readouterr()
+        assert not err
+        assert out == "✔ Setting development status to '5 - Production/Stable'.\n"

From 78e9ee517bfd6295d4e2e579e1ba4ba125ba32cd Mon Sep 17 00:00:00 2001
From: Nathan McDougall <nathan.j.mcdougall@gmail.com>
Date: Fri, 20 Jun 2025 20:21:28 +1200
Subject: [PATCH 4/6] Add interface test

---
 tests/usethis/_interface/test_status.py | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 tests/usethis/_interface/test_status.py

diff --git a/tests/usethis/_interface/test_status.py b/tests/usethis/_interface/test_status.py
new file mode 100644
index 00000000..c45c9c5e
--- /dev/null
+++ b/tests/usethis/_interface/test_status.py
@@ -0,0 +1,20 @@
+from pathlib import Path
+
+from typer.testing import CliRunner
+
+from usethis._app import app
+from usethis._test import change_cwd
+
+
+class TestStatus:
+    def test_successful(self, tmp_path: Path):
+        # Act
+        runner = CliRunner()
+        with change_cwd(tmp_path):
+            result = runner.invoke(app, ["status", "beta"])
+
+        # Assert
+        assert result.exit_code == 0, result.output
+        assert result.output == (
+            "✔ Writing 'pyproject.toml'.\n✔ Setting development status to '4 - Beta'.\n"
+        )

From af41da091781b6bd93355d166022cf4675c3db75 Mon Sep 17 00:00:00 2001
From: Nathan McDougall <nathan.j.mcdougall@gmail.com>
Date: Fri, 20 Jun 2025 20:24:41 +1200
Subject: [PATCH 5/6] Add tests for using numeric codes

---
 tests/usethis/_core/test_status.py      | 21 +++++++++++++++++++++
 tests/usethis/_interface/test_status.py | 12 ++++++++++++
 2 files changed, 33 insertions(+)

diff --git a/tests/usethis/_core/test_status.py b/tests/usethis/_core/test_status.py
index 894f01d4..794bd28d 100644
--- a/tests/usethis/_core/test_status.py
+++ b/tests/usethis/_core/test_status.py
@@ -29,6 +29,27 @@ def test_planning(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
         assert not err
         assert out == "✔ Setting development status to '1 - Planning'.\n"
 
+    def test_planning_code(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
+        # Arrange
+        status = DevelopmentStatusEnum.planning_code
+
+        # Act
+        with change_cwd(uv_init_dir), PyprojectTOMLManager():
+            use_development_status(status)
+
+        # Assert
+        assert (
+            "Development Status :: 1 - Planning"
+            in uv_init_dir.joinpath("pyproject.toml").read_text()
+        )
+        with PyprojectTOMLManager() as mgr:
+            assert (
+                "Development Status :: 1 - Planning" in mgr[["project", "classifiers"]]
+            )
+        out, err = capfd.readouterr()
+        assert not err
+        assert out == "✔ Setting development status to '1 - Planning'.\n"
+
     def test_prealpha(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
         # Arrange
         status = DevelopmentStatusEnum.prealpha
diff --git a/tests/usethis/_interface/test_status.py b/tests/usethis/_interface/test_status.py
index c45c9c5e..3529bfaa 100644
--- a/tests/usethis/_interface/test_status.py
+++ b/tests/usethis/_interface/test_status.py
@@ -18,3 +18,15 @@ def test_successful(self, tmp_path: Path):
         assert result.output == (
             "✔ Writing 'pyproject.toml'.\n✔ Setting development status to '4 - Beta'.\n"
         )
+
+    def test_numerical_code(self, tmp_path: Path):
+        # Act
+        runner = CliRunner()
+        with change_cwd(tmp_path):
+            result = runner.invoke(app, ["status", "5"])
+
+        # Assert
+        assert result.exit_code == 0, result.output
+        assert result.output == (
+            "✔ Writing 'pyproject.toml'.\n✔ Setting development status to '5 - Production/Stable'.\n"
+        )

From 2dc5d7a582fa9651a73a98765e8384982c828542 Mon Sep 17 00:00:00 2001
From: Nathan McDougall <nathan.j.mcdougall@gmail.com>
Date: Fri, 20 Jun 2025 21:00:15 +1200
Subject: [PATCH 6/6] Add `--status` flag to `usethis init`. Remove default for
 `usethis status`

---
 README.md                               | 13 ++++++++++---
 src/usethis/_core/status.py             |  2 +-
 src/usethis/_interface/init.py          | 13 ++++++++++++-
 src/usethis/_interface/status.py        |  2 +-
 tests/usethis/_core/test_status.py      | 22 +++++++++++-----------
 tests/usethis/_interface/test_init.py   | 20 +++++++++++++++++---
 tests/usethis/_interface/test_status.py | 13 +++++++++++--
 7 files changed, 63 insertions(+), 22 deletions(-)

diff --git a/README.md b/README.md
index f7a77cb6..f02858a6 100644
--- a/README.md
+++ b/README.md
@@ -189,6 +189,15 @@ Supported options:
   - `numpy` for [NumPy docstring style](https://numpydoc.readthedocs.io/en/latest/format.html#docstring-standard)
   - `google` for [Google docstring style](https://google.github.io/styleguide/pyguide.html#38-comments-and-docstrings)
   - `pep257` for [PEP 257 docstring style](https://www.python.org/dev/peps/pep-0257/)
+- `--status` to set the development status of the project. Defaults to `planning`.
+  Possible values:
+  - `planning` or `1` for "Development Status :: 1 - Planning"
+  - `pre-alpha` or `2` for "Development Status :: 2 - Pre-Alpha"
+  - `alpha` or `3` for "Development Status :: 3 - Alpha"
+  - `beta` or `4` for "Development Status :: 4 - Beta"
+  - `production` or `5` for "Development Status :: 5 - Production/Stable"
+  - `mature` or `6` for "Development Status :: 6 - Mature"
+  - `inactive` or `7` for "Development Status :: 7 - Inactive"
 - `--offline` to disable network access and rely on caches
 - `--quiet` to suppress output
 - `--frozen` to leave the virtual environment and lockfile unchanged (i.e. do not install dependencies, nor update lockfiles)
@@ -416,9 +425,7 @@ Supported options:
 
 Set the development status of the project via trove classifiers.
 
-By default, the status is set to "Development Status :: 1 - Planning".
-
-Possible values:
+Possible values (required):
 
 - `usethis status planning` or `usethis status 1` for "Development Status :: 1 - Planning"
 - `usethis status pre-alpha` or `usethis status 2` for "Development Status :: 2 - Pre-Alpha"
diff --git a/src/usethis/_core/status.py b/src/usethis/_core/status.py
index 3db5f228..300b98e5 100644
--- a/src/usethis/_core/status.py
+++ b/src/usethis/_core/status.py
@@ -33,7 +33,7 @@ def use_development_status(
 
     dispstatus = new_classifier.removeprefix("Development Status :: ")
 
-    tick_print(f"Setting development status to '{dispstatus}'.")
+    tick_print(f"Setting the development status to '{dispstatus}'.")
 
     mgr = PyprojectTOMLManager()
     try:
diff --git a/src/usethis/_interface/init.py b/src/usethis/_interface/init.py
index e1536c9d..61a3122c 100644
--- a/src/usethis/_interface/init.py
+++ b/src/usethis/_interface/init.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import typer
 from typing_extensions import assert_never
 
@@ -16,6 +18,7 @@
 )
 from usethis._core.docstyle import DocStyleEnum, use_docstyle
 from usethis._core.readme import add_readme
+from usethis._core.status import DevelopmentStatusEnum, use_development_status
 from usethis._core.tool import use_pre_commit
 from usethis._integrations.uv.init import opinionated_uv_init
 from usethis._toolset.format_ import use_formatters
@@ -25,7 +28,7 @@
 from usethis.errors import UsethisError
 
 
-def init(  # noqa: PLR0913
+def init(  # noqa: PLR0913, PLR0915
     format_: bool = typer.Option(
         True, "--format/--no-format", help="Add recommended formatters."
     ),
@@ -57,6 +60,11 @@ def init(  # noqa: PLR0913
         "--docstyle",
         help="Set a docstring style convention for the project.",
     ),
+    status: DevelopmentStatusEnum = typer.Option(
+        "planning",
+        "--status",
+        help="Set the development status of the project.",
+    ),
     offline: bool = offline_opt,
     quiet: bool = quiet_opt,
     frozen: bool = frozen_opt,
@@ -81,6 +89,9 @@ def init(  # noqa: PLR0913
             opinionated_uv_init()
             add_readme()
 
+            assert isinstance(status, DevelopmentStatusEnum)
+            use_development_status(status)
+
             if pre_commit:
                 tick_print("Adding the pre-commit framework.")
                 with usethis_config.set(alert_only=True):
diff --git a/src/usethis/_interface/status.py b/src/usethis/_interface/status.py
index da523cf8..c1edb5aa 100644
--- a/src/usethis/_interface/status.py
+++ b/src/usethis/_interface/status.py
@@ -14,7 +14,7 @@
 
 def status(
     status: DevelopmentStatusEnum = typer.Argument(
-        default="planning", help="Docstring style to enforce."
+        default=..., help="Docstring style to enforce."
     ),
     quiet: bool = quiet_opt,
 ) -> None:
diff --git a/tests/usethis/_core/test_status.py b/tests/usethis/_core/test_status.py
index 794bd28d..46dc8f35 100644
--- a/tests/usethis/_core/test_status.py
+++ b/tests/usethis/_core/test_status.py
@@ -27,7 +27,7 @@ def test_planning(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
             )
         out, err = capfd.readouterr()
         assert not err
-        assert out == "✔ Setting development status to '1 - Planning'.\n"
+        assert out == "✔ Setting the development status to '1 - Planning'.\n"
 
     def test_planning_code(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
         # Arrange
@@ -48,7 +48,7 @@ def test_planning_code(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str
             )
         out, err = capfd.readouterr()
         assert not err
-        assert out == "✔ Setting development status to '1 - Planning'.\n"
+        assert out == "✔ Setting the development status to '1 - Planning'.\n"
 
     def test_prealpha(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
         # Arrange
@@ -69,7 +69,7 @@ def test_prealpha(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
             )
         out, err = capfd.readouterr()
         assert not err
-        assert out == "✔ Setting development status to '2 - Pre-Alpha'.\n"
+        assert out == "✔ Setting the development status to '2 - Pre-Alpha'.\n"
 
     def test_alpha(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
         # Arrange
@@ -88,7 +88,7 @@ def test_alpha(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
             assert "Development Status :: 3 - Alpha" in mgr[["project", "classifiers"]]
         out, err = capfd.readouterr()
         assert not err
-        assert out == "✔ Setting development status to '3 - Alpha'.\n"
+        assert out == "✔ Setting the development status to '3 - Alpha'.\n"
 
     def test_beta(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
         # Arrange
@@ -107,7 +107,7 @@ def test_beta(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
             assert "Development Status :: 4 - Beta" in mgr[["project", "classifiers"]]
         out, err = capfd.readouterr()
         assert not err
-        assert out == "✔ Setting development status to '4 - Beta'.\n"
+        assert out == "✔ Setting the development status to '4 - Beta'.\n"
 
     def test_production(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
         # Arrange
@@ -129,7 +129,7 @@ def test_production(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
             )
         out, err = capfd.readouterr()
         assert not err
-        assert out == "✔ Setting development status to '5 - Production/Stable'.\n"
+        assert out == "✔ Setting the development status to '5 - Production/Stable'.\n"
 
     def test_mature(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
         # Arrange
@@ -148,7 +148,7 @@ def test_mature(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
             assert "Development Status :: 6 - Mature" in mgr[["project", "classifiers"]]
         out, err = capfd.readouterr()
         assert not err
-        assert out == "✔ Setting development status to '6 - Mature'.\n"
+        assert out == "✔ Setting the development status to '6 - Mature'.\n"
 
     def test_inactive(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
         # Arrange
@@ -169,7 +169,7 @@ def test_inactive(self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]):
             )
         out, err = capfd.readouterr()
         assert not err
-        assert out == "✔ Setting development status to '7 - Inactive'.\n"
+        assert out == "✔ Setting the development status to '7 - Inactive'.\n"
 
     def test_no_pyproject_toml(self, tmp_path: Path, capfd: pytest.CaptureFixture[str]):
         # Arrange
@@ -184,7 +184,7 @@ def test_no_pyproject_toml(self, tmp_path: Path, capfd: pytest.CaptureFixture[st
         assert not err
         assert out == (
             "✔ Writing 'pyproject.toml'.\n"
-            "✔ Setting development status to '1 - Planning'.\n"
+            "✔ Setting the development status to '1 - Planning'.\n"
         )
 
     def test_replace_existing_classifier(
@@ -219,7 +219,7 @@ def test_replace_existing_classifier(
             )
         out, err = capfd.readouterr()
         assert not err
-        assert out == "✔ Setting development status to '4 - Beta'.\n"
+        assert out == "✔ Setting the development status to '4 - Beta'.\n"
 
     def test_replace_multiple_existing_classifiers(
         self, uv_init_dir: Path, capfd: pytest.CaptureFixture[str]
@@ -259,4 +259,4 @@ def test_replace_multiple_existing_classifiers(
             )
         out, err = capfd.readouterr()
         assert not err
-        assert out == "✔ Setting development status to '5 - Production/Stable'.\n"
+        assert out == "✔ Setting the development status to '5 - Production/Stable'.\n"
diff --git a/tests/usethis/_interface/test_init.py b/tests/usethis/_interface/test_init.py
index c87d3678..c6ef09ba 100644
--- a/tests/usethis/_interface/test_init.py
+++ b/tests/usethis/_interface/test_init.py
@@ -12,7 +12,9 @@ def test_pre_commit_included(self, tmp_path: Path):
         # Act
         runner = CliRunner()
         with change_cwd(tmp_path):
-            result = runner.invoke(app, ["init", "--pre-commit"])
+            result = runner.invoke(
+                app, ["init", "--pre-commit"], catch_exceptions=False
+            )
 
         # Assert
         assert result.exit_code == 0, result.output
@@ -21,6 +23,7 @@ def test_pre_commit_included(self, tmp_path: Path):
             "✔ Writing 'pyproject.toml' and initializing project.\n"
             "✔ Writing 'README.md'.\n"
             "☐ Populate 'README.md' to help users understand the project.\n"
+            "✔ Setting the development status to '1 - Planning'.\n"
             "✔ Adding the pre-commit framework.\n"
             "☐ Run 'uv run pre-commit run --all-files' to run the hooks manually.\n"
             "✔ Adding recommended linters.\n"
@@ -71,6 +74,7 @@ def test_readme_example(self, tmp_path: Path):
 ✔ Writing 'pyproject.toml' and initializing project.
 ✔ Writing 'README.md'.
 ☐ Populate 'README.md' to help users understand the project.
+✔ Setting the development status to '1 - Planning'.
 ✔ Adding recommended linters.
 ☐ Run 'uv run ruff check --fix' to run the Ruff linter with autofixes.
 ☐ Run 'uv run deptry src' to run deptry.
@@ -110,13 +114,22 @@ def test_no_err_when_pyproject_toml_exists(self, tmp_path: Path):
         # Assert
         assert result.exit_code == 0, result.output
 
-    def test_bitbucket_and_docstyle(self, tmp_path: Path):
+    def test_bitbucket_docstyle_and_status(self, tmp_path: Path):
         # Act
         runner = CliRunner()
         with change_cwd(tmp_path):
             result = runner.invoke(
                 app,
-                ["init", "--ci", "bitbucket", "--docstyle", "numpy", "--pre-commit"],
+                [
+                    "init",
+                    "--ci",
+                    "bitbucket",
+                    "--docstyle",
+                    "numpy",
+                    "--pre-commit",
+                    "--status",
+                    "production",
+                ],
             )
 
         # Assert
@@ -126,6 +139,7 @@ def test_bitbucket_and_docstyle(self, tmp_path: Path):
             "✔ Writing 'pyproject.toml' and initializing project.\n"
             "✔ Writing 'README.md'.\n"
             "☐ Populate 'README.md' to help users understand the project.\n"
+            "✔ Setting the development status to '5 - Production/Stable'.\n"
             "✔ Adding the pre-commit framework.\n"
             "☐ Run 'uv run pre-commit run --all-files' to run the hooks manually.\n"
             "✔ Adding recommended linters.\n"
diff --git a/tests/usethis/_interface/test_status.py b/tests/usethis/_interface/test_status.py
index 3529bfaa..6e57b53b 100644
--- a/tests/usethis/_interface/test_status.py
+++ b/tests/usethis/_interface/test_status.py
@@ -16,7 +16,7 @@ def test_successful(self, tmp_path: Path):
         # Assert
         assert result.exit_code == 0, result.output
         assert result.output == (
-            "✔ Writing 'pyproject.toml'.\n✔ Setting development status to '4 - Beta'.\n"
+            "✔ Writing 'pyproject.toml'.\n✔ Setting the development status to '4 - Beta'.\n"
         )
 
     def test_numerical_code(self, tmp_path: Path):
@@ -28,5 +28,14 @@ def test_numerical_code(self, tmp_path: Path):
         # Assert
         assert result.exit_code == 0, result.output
         assert result.output == (
-            "✔ Writing 'pyproject.toml'.\n✔ Setting development status to '5 - Production/Stable'.\n"
+            "✔ Writing 'pyproject.toml'.\n✔ Setting the development status to '5 - Production/Stable'.\n"
         )
+
+    def test_no_args(self, tmp_path: Path):
+        # Act
+        runner = CliRunner()
+        with change_cwd(tmp_path):
+            result = runner.invoke(app, ["status"])
+
+        # Assert
+        assert result.exit_code == 2, result.output