Skip to content

Conversation

@koaning
Copy link
Contributor

@koaning koaning commented Oct 27, 2025

This PR was made apon reflecting this message on Discord.

The user in this case was trying to figure out whether or not there was a present mode whenever you access the app meta information. The documentation doesn't actually confirm if this is the case. It doesn't list all the values that the run mode can represent.

Hence, I figured adding the AppMeta class to our documentation. That way a user could at least confirm themselves if it is/not supported.

@koaning koaning requested a review from akshayka as a code owner October 27, 2025 10:34
@vercel
Copy link

vercel bot commented Oct 27, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
marimo-docs Ready Ready Preview Comment Oct 27, 2025 8:44pm

@koaning koaning added the documentation Improvements or additions to documentation label Oct 27, 2025
docs/api/app.md Outdated

::: marimo.app_meta

::: marimo._runtime.app_meta.AppMeta
Copy link
Contributor

Choose a reason for hiding this comment

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

we don't normally document private classes, but since this is the return type of a public function, we should likely make this class public as well

Copy link
Contributor

Choose a reason for hiding this comment

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

this is what is looks like

image

@koaning koaning changed the title Document AppMeta Document AppMeta and make it public Oct 27, 2025
@koaning koaning added the enhancement New feature or request label Oct 27, 2025
akshayka
akshayka previously approved these changes Oct 27, 2025
@koaning
Copy link
Contributor Author

koaning commented Oct 27, 2025

@akshayka I want to make this public before merging. As @mscolnick points out, it's ugly to document something from a hidden module.

@koaning
Copy link
Contributor Author

koaning commented Oct 27, 2025

@mscolnick much better now, assuming we're cool with making it public like this.

CleanShot 2025-10-27 at 17 41 56

mscolnick
mscolnick previously approved these changes Oct 27, 2025
Copy link
Contributor

@mscolnick mscolnick left a comment

Choose a reason for hiding this comment

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

looks good, thanks!

@mscolnick
Copy link
Contributor

you will need to run hatch run +py=3.12 test-optional:test tests/test_api.py::test_api to update the snapshot of public APIs

@koaning
Copy link
Contributor Author

koaning commented Oct 27, 2025

@mscolnick should be all good now.

@mscolnick mscolnick merged commit 85649a7 into main Oct 27, 2025
38 of 41 checks passed
@mscolnick mscolnick deleted the appmeta-docs branch October 27, 2025 21:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants