Add force parameter to create

changes/1870.feature.rst

@@ -0,0 +1 @@
+Added force flag to create command to overwrite existing scaffolds

docs/reference/commands/create.rst

@@ -32,4 +32,9 @@ to delete and regenerate the app.
 Options
 =======
 
-There are no additional command line options.
+The following options can be provided at the command line.
+
+``--force``
+---------------------------------------
+
+Automatically overwrite any existing scaffold for the nominated platform instead of asking for confirmation.

src/briefcase/commands/create.py

@@ -91,6 +91,13 @@ def app_template_url(self) -> str:
  """The URL for a cookiecutter repository to use when creating apps."""
  return f"https://github.com/beeware/briefcase-{self.platform}-{self.output_format}-template.git"
 
+ def add_options(self, parser):
+ parser.add_argument(
+ "--force",
+ action="store_true",
+ help="Automatically confirm overwriting existing scaffold",
+ )
+
  def support_package_filename(self, support_revision: str) -> str:
  """The query arguments to use in a support package query request."""
  return f"Python-{self.python_version_tag}-{self.platform}-support.b{support_revision}.tar.gz"
@@ -858,19 +865,27 @@ def cleanup_app_content(self, app: AppConfig):
  self.logger.verbose(f"Removing {relative_path}")
  path.unlink()
 
- def create_app(self, app: AppConfig, test_mode: bool = False, **options):
+ def create_app(
+ self,
+ app: AppConfig,
+ test_mode: bool = False,
+ auto_confirm: bool = False,
+ **options,
+ ):
  """Create an application bundle.
 
  :param app: The config object for the app
  :param test_mode: Should the app be updated in test mode? (default: False)
+ :param auto_confirm: Should any existing scaffold be automatically overwritten?
+ (default: False)
  """
  if not app.supported:
  raise UnsupportedPlatform(self.platform)
 
  bundle_path = self.bundle_path(app)
  if bundle_path.exists():
  self.logger.info()
- confirm = self.input.boolean_input(
+ confirm = auto_confirm or self.input.boolean_input(
  f"Application {app.app_name!r} already exists; overwrite", default=False
  )
  if not confirm:
@@ -935,18 +950,21 @@ def verify_app_tools(self, app: AppConfig):
  def __call__(
  self,
  app: AppConfig | None = None,
+ auto_overwrite: bool = False,
  **options,
  ) -> dict | None:
  # Confirm host compatibility, that all required tools are available,
  # and that the app configuration is finalized.
  self.finalize(app)
 
  if app:
- state = self.create_app(app, **options)
+ state = self.create_app(app, auto_overwrite, **options)
  else:
  state = None
  for app_name, app in sorted(self.apps.items()):
- state = self.create_app(app, **full_options(state, options))
+ state = self.create_app(
+ app, auto_overwrite, **full_options(state, options)
+ )
 
  return state