Skip to content

docs(cli): align preset module lists with actual smpy new behavior - #145

Merged
antosubash merged 1 commit into
mainfrom
feature/feat-smpy-preset-standard-different-module-1brhe
May 13, 2026
Merged

docs(cli): align preset module lists with actual smpy new behavior#145
antosubash merged 1 commit into
mainfrom
feature/feat-smpy-preset-standard-different-module-1brhe

Conversation

@antosubash

Copy link
Copy Markdown
Owner

Summary

  • Installation and quickstart docs claimed --preset standard shipped auth, users, permissions, dashboard, settings, feature_flags, but the CLI's PRESETS in framework/cli/simple_module_cli/catalog.py:63-67 actually resolves standard to auth, users, dashboard, permissions.
  • Updated the preset table and the quickstart --yes blurb to match what the CLI prints.
  • Added a note that simple_module_settings is a hardcoded baseline dep in framework/cli/simple_module_cli/templates/host/pyproject.toml.tpl:10, which is why it lands in the venv even on minimal.

Fixes #136.

This is option 1 from the issue's suggested fixes (docs follow CLI). Option 2 (expand the standard preset in the CLI to include settings + feature_flags) would be a behavior change for --yes callers, against the original spec's "no behavior change for existing scripts" intent — happy to switch approaches if a richer documented standard is preferred.

Test plan

  • smpy new test --yes --no-install announces Modules: auth, users, dashboard, permissions (matches table)
  • smpy new test --yes --preset minimal --no-install announces Modules: auth, users (matches table)
  • smpy new test --yes --preset full --no-install announces all 8 catalog modules (matches table)
  • Docs render correctly on the docs site

The installation and quickstart docs described `--preset standard` as
including `permissions`, `settings`, and `feature_flags`, but the CLI's
`PRESETS` in `framework/cli/simple_module_cli/catalog.py` resolves
`standard` to just `auth, users, dashboard, permissions`. Update the
docs to match what the CLI actually does, and note that
`simple_module_settings` ships as a hard-coded baseline dep of every
scaffolded host (which is why it lands in the venv regardless of
preset).

Fixes #136
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying simple-module-python with  Cloudflare Pages  Cloudflare Pages

Latest commit: 42de64f
Status: ✅  Deploy successful!
Preview URL: https://8820df65.simple-module-python.pages.dev
Branch Preview URL: https://feature-feat-smpy-preset-sta.simple-module-python.pages.dev

View logs

@antosubash
antosubash merged commit 6b457c7 into main May 13, 2026
12 checks passed
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.

smpy new --preset standard installs a different module set than the docs claim

1 participant