Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(v3): small fixes #3942

Open
wants to merge 37 commits into
base: v3.0
Choose a base branch
from
Open

docs(v3): small fixes #3942

wants to merge 37 commits into from

Conversation

JacobCoffee
Copy link
Member

Description

  • fixes wording on table
  • fixes code colorway (sidestream changes also in litestar-sphinx-theme v3 branch)
  • (needs review?) add missing example files

@JacobCoffee JacobCoffee requested review from provinzkraut and a team as code owners January 10, 2025 06:22
@github-actions github-actions bot added area/dependencies This PR involves changes to the dependencies area/docs This PR involves changes to the documentation size: small type/docs labels Jan 10, 2025
Copy link
Member Author

Choose a reason for hiding this comment

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

y are these even needed though?

Copy link
Contributor

Choose a reason for hiding this comment

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

I dont think so since this is deprecated in v2

Copy link
Contributor

Choose a reason for hiding this comment

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

I dont think so since this is deprecated in v2

#[tool.uv.sources]
# Only needed when working on the theme; also need to uncomment docs package
#litestar-sphinx-theme = { path = "../litestar-sphinx-theme", editable = true }

Copy link
Contributor

Choose a reason for hiding this comment

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

it feels weird to have to comment / uncomment to work on docs, or there's something I dont get, isn't there a better way ?

Copy link
Member

@cofin cofin Jan 10, 2025

Choose a reason for hiding this comment

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

Yes, I think you can use something like this

with this in the pyproject.toml as well:

[tool.hatch.metadata]
allow-direct-references = true

Copy link
Member Author

Choose a reason for hiding this comment

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

Would this work? The issue I am fighting and that this solves currently is that I can have a locally checked out copy of litestar-sphinx-theme and can uncomment this section and the one in the docs = [...] group so that changes can be seen live across the project without having to push upstream or something.

Copy link
Member

Choose a reason for hiding this comment

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

Yep. I think this should handle this case.

JacobCoffee and others added 17 commits January 15, 2025 17:41
* Trigger documentation build

* Trigger documentation build

* docs: update to v3 style

* docs: move some things to litestar.dev repo, change versioning, add environment tag

* docs: update landing page

* chore: update lockfile

* chore: add AA upper constraint

* fix(docs): re-colonize

* docs: enable sphinx-togglebutton

* docs: use current year var

* deps: update deps

* fix(docs): do not link __name__ for now

* fix(docs): use correct link to page

---------

Co-authored-by: Peter Schutt <[email protected]>
* Remove deprecated StaticFiles and StaticFilesConfig
* remove special casing of static files app from handlers/router
* remove outdated docs sections
* Add what's new section
* Rename tests for consistency
This PR changes behavior of parameters that are typed in a union with `None`. Prior behavior was to implicitly default their value to `None` if a value wasn't provided making an apparently non-optional parameter (i.e., no declared default) actually optional. Surprising behavior at best, dangerous at worst.

New behavior is to throw a client error when a parameter without a default is not provided.
* refactor: removes deprecated OpenAPIController

This PR removes all deprecated elements of OpenAPIConfig and the OpenAPIController, removes any obsolete tests and refactors tests that were parametrized to test both OpenAPIController and the router-based approach.

* docs: What's new entry

* Update docs/usage/openapi/ui_plugins.rst

Co-authored-by: Jacob Coffee <[email protected]>

* Update litestar/openapi/config.py

* fix: remove whitespace

* fix: import table formatting

(i hope)

---------

Co-authored-by: Jacob Coffee <[email protected]>
…e` (#3393)

* Remove 'app' parameter from `.to_asgi_response`
Remove the deprecated utility functions, `get_litestar_scope_state``, ``set_litestar_scope_state``, ``delete_litestar_scope_state``, and ``is_sync_or_async_generator``.
* remove handler names
* Remove option handler creation from HTTPRoute
* Remove methods attribute from BaseRoute
* Move kwargs model to handlers and creation to on_registration
* Store kwargs model on handlers instead of routes
* Simplify HTTPRoute route_handler_map creation
* Simplify Router.route_handler_method_map
* Relax typing of HTTPRoute
* Move handling logic to route handlers
* Remove scope_type
* Don't pass route to HTTPRouteHandler during handling
* Don't pass scope to handle methods
* Resolve and establish connections in routes; Only pass connections to handlers

---------

Co-authored-by: Jacob Coffee <[email protected]>
Co-authored-by: Peter Schutt <[email protected]>
fix(docs): adjust build script
* Backport static files path traversal fix
* make route handlers functional decorators
…deprecated params of internal `ExceptionHandlerMiddleware` (#3435)

* refactor!: Remove deprecated `app` param of `Response.to_asgi_response` (#3393)
* Remove 'app' parameter from `.to_asgi_response`
* Remove debug param
* Remove exception_handlers param
* Remove litestar.middleware.exceptions
@github-actions github-actions bot removed area/enums This PR involves changes to the enums area/controller area/connection area/constants This PR involves changes to the constants area/template area/types This PR involves changes to the custom types area/response area/static-files area/logging area/middleware This PR involves changes to the middleware area/asgi area/kwargs size: large area/private-api This PR involves changes to the privatized API area/handlers This PR involves changes to the handlers area/testing area/openapi This PR involves changes to the OpenAPI schema area/channels area/contrib This PR involves changes to the contrib (Deprecated) area/router labels Jan 15, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/dependencies This PR involves changes to the dependencies area/docs This PR involves changes to the documentation pr/internal size: small type/docs
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants