remove obsolete routing code and examples

api_docs_and_examples.py

@@ -807,35 +807,6 @@ You can also set `respond=False` to send a command without waiting for a respons
         ui.button('fire and forget', on_click=alert)
         ui.button('receive result', on_click=get_date)
 
-    h3('Routes')
-
-    # @example(ui.get)
-    def get_example():
-        from starlette import requests, responses
-
-        @ui.get('/another/route/{id}')
-        def produce_plain_response(id: str, request: requests.Request):
-            return responses.PlainTextResponse(f'{request.client.host} asked for id={id}')
-
-        ui.link('Try yet another route!', 'another/route/42')
-
-    # @example(ui.add_static_files)
-    def add_static_files_example():
-        ui.add_static_files('/examples', 'examples')
-        ui.link('Slideshow Example (raw file)', 'examples/slideshow/main.py')
-        with ui.image('examples/slideshow/slides/slide1.jpg'):
-            ui.label('first image from slideshow').classes('absolute-bottom text-subtitle2')
-
-    # @example(ui.add_route)
-    def add_route_example():
-        import starlette
-
-        ui.add_route(starlette.routing.Route(
-            '/new/route', lambda _: starlette.responses.PlainTextResponse('Response')
-        ))
-
-        ui.link('Try the new route!', 'new/route')
-
     h3('Configuration')
 
     @example('''#### ui.run

nicegui/routes.py

@@ -1,126 +0,0 @@
-import inspect
-import os.path
-from functools import wraps
-from typing import Any, Callable, Dict, List
-
-import justpy as jp
-from starlette.requests import Request
-from starlette.responses import FileResponse, PlainTextResponse
-from starlette.routing import BaseRoute, Convertor, Mount, Route, compile_path
-from starlette.staticfiles import StaticFiles
-
-from . import globals
-from .helpers import is_coroutine
-
-
-def add_route(self, route: BaseRoute) -> None:
-    """Route
-
-    Adds a new `Starlette route <https://www.starlette.io/routing/>`_.
-    Routed paths must start with a slash "/".
-    Also see `@ui.get <https://nicegui.io/reference#get_decorator>`_ and `ui.add_static_files <https://nicegui.io/reference#get_decorator>`_
-    for more convenient ways to deliver non-UI content.
-
-    :param route: Starlette route including a path and a function to be called
-    """
-    globals.app.routes.insert(0, route)
-
-
-def add_static_files(self, path: str, directory: str) -> None:
-    """Static Files
-
-    Makes a local directory available at the specified endpoint, e.g. `'/static'`.
-    Do only put non-security-critical files in there, as they are accessible to everyone.
-
-    :param path: string that starts with a slash "/"
-    :param directory: folder with static files to serve under the given path
-    """
-    add_route(None, Mount(path, app=StaticFiles(directory=directory)))
-
-
-def convert_arguments(request: Request, converters: Dict[str, Convertor], func: Callable) -> Dict[str, Any]:
-    args = {name: converter.convert(request.path_params.get(name)) for name, converter in converters.items()}
-    parameters = inspect.signature(func).parameters
-    for key in parameters:
-        if parameters[key].annotation.__name__ == 'bool':
-            args[key] = bool(args[key])
-        if parameters[key].annotation.__name__ == 'int':
-            args[key] = int(args[key])
-        elif parameters[key].annotation.__name__ == 'float':
-            args[key] = float(args[key])
-        elif parameters[key].annotation.__name__ == 'complex':
-            args[key] = complex(args[key])
-    if 'request' in parameters and 'request' not in args:
-        args['request'] = request
-    return args
-
-
-def get(self, path: str):
-    """GET Decorator
-
-    Decorating a function with `@ui.get` makes it available at the specified endpoint, e.g. `'/another/route/<id>'`.
-
-    Path parameters can be passed to the request handler like with `FastAPI <https://fastapi.tiangolo.com/tutorial/path-params/>`_.
-    If type-annotated, they are automatically converted to `bool`, `int`, `float` and `complex` values.
-    An optional `request` argument gives access to the complete request object.
-
-    :param path: string that starts with a slash "/"
-    """
-    *_, converters = compile_path(path)
-
-    def decorator(func):
-        @wraps(func)
-        async def decorated(request: Request):
-            args = convert_arguments(request, converters, func)
-            return await func(**args) if is_coroutine(func) else func(**args)
-        add_route(None, Route(path, decorated))
-        return decorated
-    return decorator
-
-
-def add_dependencies(py_filepath: str, dependencies: List[str] = []) -> None:
-    vue_filepath = os.path.splitext(os.path.realpath(py_filepath))[0] + '.js'
-
-    for dependency in dependencies:
-        is_remote = dependency.startswith('http://') or dependency.startswith('https://')
-        src = dependency if is_remote else f'lib/{dependency}'
-        if src not in jp.component_file_list:
-            jp.component_file_list += [src]
-            if not is_remote:
-                filepath = f'{os.path.dirname(vue_filepath)}/{src}'
-                route = Route(f'/{src}', lambda _, filepath=filepath: FileResponse(filepath))
-                jp.app.routes.insert(0, route)
-
-    if vue_filepath not in jp.component_file_list:
-        filename = os.path.basename(vue_filepath)
-        jp.app.routes.insert(0, Route(f'/{filename}', lambda _: FileResponse(vue_filepath)))
-        jp.component_file_list += [filename]
-
-
-def create_exclude_routes() -> None:
-    def void(_: Request) -> PlainTextResponse:
-        return PlainTextResponse()
-
-    if 'chart' in globals.config.excludes:
-        add_route(None, Route('/templates/local/highcharts.js', void))
-    if 'colors' in globals.config.excludes:
-        add_route(None, Route('/colors.js', void))
-    if 'interactive_image' in globals.config.excludes:
-        add_route(None, Route('/interactive_image.js', void))
-    if 'keyboard' in globals.config.excludes:
-        add_route(None, Route('/keyboard.js', void))
-    if 'log' in globals.config.excludes:
-        add_route(None, Route('/log.js', void))
-    if 'joystick' in globals.config.excludes:
-        add_route(None, Route('/joystick.js', void))
-        add_route(None, Route('/lib/nipplejs.min.js', void))
-    if 'scene' in globals.config.excludes:
-        add_route(None, Route('/scene.js', void))
-        add_route(None, Route('/lib/CSS2DRenderer.js', void))
-        add_route(None, Route('/lib/CSS3DRenderer.js', void))
-        add_route(None, Route('/lib/OrbitControls.js', void))
-        add_route(None, Route('/lib/STLLoader.js', void))
-        add_route(None, Route('/lib/three.min.js', void))
-        add_route(None, Route('/lib/tween.umd.min.js', void))
-    if 'table' in globals.config.excludes:
-        add_route(None, Route('/templates/local/ag-grid-community.js', void))