Skip to content

Conversation

@freakboy3742
Copy link
Member

Makes 2 small changes to the determination of app name:

  • If an App ID is provided (which is documented as required unless there's Briefcase-style packaging metadata), the app name is determined from the app ID, rather than the module name
  • The app ID is always normalised.

This fixes #3926, which identified that running python -m toga_demo resulted in the wrong app icon (because the app icon was evaluated as resources/toga_demo, whereas if you ran with briefcase, you would get the icon (because Briefcase would embed the icon into the app binary)

It also fixes the fact that toga wasn't listed as a dependency (because of the use of setuptools-dynamic-dependencies), and that some of the other definitions needed for successful Briefcase operation weren't listed.

The app won't run on iOS, Android or Web, so those configurations are now disabled.

PR Checklist:

  • All new features have been tested
  • All new features have been documented
  • I have read the CONTRIBUTING.md file
  • I will abide by the code of conduct

@freakboy3742 freakboy3742 requested a review from mhsmith November 28, 2025 02:15
Copy link
Member

@mhsmith mhsmith left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's keep discussion about the substance of the change in one place in #3926.

#. If the `app_id` argument was provided, its last segment will be used. For
example, an `app_id` of `com.example.my-app` would yield a distribution
name of `my-app`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This isn't rendering as a list.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This seems to be a bug/limitation of mkdocstrings when used with Sphinx-style docstrings. For some reason, the parser isn't reading any content that includes newlines.

I've logged this as mkdocstrings/mkdocstrings#808; in the meantime, I've reworked the text to not require bullet points.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Main window icon is ignored when launching toga_demo as a module

2 participants