mountaineer 0.5.2.dev4__tar.gz → 0.7.0.dev1__tar.gz

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/Cargo.lock

@@ -83,7 +83,7 @@ version = "0.69.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "a00dc851838a2120612785d195287475a3ac45514741da670b735818822129a0"
 dependencies = [
- "bitflags 2.4.2",
+ "bitflags 2.6.0",
  "cexpr",
  "clang-sys",
  "itertools",
@@ -108,15 +108,15 @@ checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"
 
 [[package]]
 name = "bitflags"
-version = "2.4.2"
+version = "2.6.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ed570934406eb16438a4e976b1b4500774099c13b8cb96eec99f620f05090ddf"
+checksum = "b048fb63fd8b5923fc5aa7b340d8e156aec7ec02f0c78fa8a6ddc2613f6f71de"
 
 [[package]]
 name = "bumpalo"
-version = "3.14.0"
+version = "3.16.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7f30e7476521f6f8af1a1c4c0b8cc94f0bee37d91763d0ca2665f299b6cd8aec"
+checksum = "79296716171880943b8470b5f8d03aa55eb2e645a4874bdbb28adb49162e012c"
 
 [[package]]
 name = "cast"
@@ -292,9 +292,9 @@ checksum = "6f62601b00b651d26d422baa52499ff2ca6b624a78bee06fefdb1120a38a9ad3"
 
 [[package]]
 name = "either"
-version = "1.9.0"
+version = "1.13.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a26ae43d7bcc3b814de94796a5e736d4029efb0ee900c12e2d54c993ad1a1e07"
+checksum = "60b1af1c220855b6ceac025d3f6ecdd2b7c4894bfe9cd9bda4fbb4bc7c0d4cf0"
 
 [[package]]
 name = "env_filter"
@@ -535,7 +535,7 @@ dependencies = [
 
 [[package]]
 name = "mountaineer"
-version = "0.5.2-dev4"
+version = "0.7.0-dev1"
 dependencies = [
  "criterion",
  "deno_core_icudata",
@@ -567,9 +567,9 @@ dependencies = [
 
 [[package]]
 name = "num-traits"
-version = "0.2.17"
+version = "0.2.19"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "39e3200413f237f41ab11ad6d161bc7239c84dcb631773ccd7de3dfe4b5c267c"
+checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
 dependencies = [
  "autocfg",
 ]
@@ -816,7 +816,7 @@ version = "0.38.31"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "6ea3e1a662af26cd7a3ba09c0297a31af215563ecf42817c98df621387f4e949"
 dependencies = [
- "bitflags 2.4.2",
+ "bitflags 2.6.0",
  "errno",
  "libc",
  "linux-raw-sys",
@@ -958,7 +958,7 @@ version = "0.89.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "fe2197fbef82c98f7953d13568a961d4e1c663793b5caf3c74455a13918cdf33"
 dependencies = [
- "bitflags 2.4.2",
+ "bitflags 2.6.0",
  "fslock",
  "gzip-header",
  "home",

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/Cargo.toml

@@ -15,7 +15,7 @@ harness = false
 
 [package]
 name = "mountaineer"
-version = "0.5.2-dev4"
+version = "0.7.0-dev1"
 edition = "2021"
 
 [dependencies]
@@ -29,8 +29,6 @@ md5 = "0.7.0"
 log = "0.4"
 env_logger = "0.11"
 libc = "0.2"
-
-[dev-dependencies]
 tempfile = "3.10.1"
 
 [dependencies.pyo3]

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: mountaineer
-Version: 0.5.2.dev4
+Version: 0.7.0.dev1
 Requires-Dist: pydantic
 Requires-Dist: fastapi
 Requires-Dist: inflection
@@ -209,7 +209,7 @@ Now that we've newly created this controller, we wire it up to the application.
 ```python
 # my_webapp/app.py
 from mountaineer.app import AppController
-from mountaineer.js_compiler.postcss import PostCSSBundler
+from mountaineer.client_compiler.postcss import PostCSSBundler
 from mountaineer.render import LinkAttribute, Metadata
 
 from my_webapp.config import AppConfig

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/README.md

@@ -191,7 +191,7 @@ Now that we've newly created this controller, we wire it up to the application.
 ```python
 # my_webapp/app.py
 from mountaineer.app import AppController
-from mountaineer.js_compiler.postcss import PostCSSBundler
+from mountaineer.client_compiler.postcss import PostCSSBundler
 from mountaineer.render import LinkAttribute, Metadata
 
 from my_webapp.config import AppConfig

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/create_mountaineer_app/create_mountaineer_app/templates/project/[project_name]/app.py

@@ -1,5 +1,5 @@
 from mountaineer.app import AppController
-from mountaineer.js_compiler.postcss import PostCSSBundler
+from mountaineer.client_compiler.postcss import PostCSSBundler
 from mountaineer.render import LinkAttribute, Metadata
 
 {% if create_stub_files %}

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/docs_website/docs/api/build_plugins/base.md

@@ -2,4 +2,4 @@
 
 Use the `ClientBuilderBase` to implement a new stage or custom handling during the frontend build lifecycle. Note that this API is still under development and might change between minor Mountaineer versions.
 
-::: mountaineer.js_compiler.base.ClientBuilderBase
+::: mountaineer.client_compiler.base.ClientBuilderBase

mountaineer-0.7.0.dev1/docs_website/docs/api/build_plugins/postcss.md

@@ -0,0 +1,3 @@
+# PostCSS
+
+::: mountaineer.client_compiler.postcss.PostCSSBundler

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/docs_website/docs/api/cli.md

@@ -10,6 +10,11 @@ CLI Plugins provide default handling for the most common lifecycle events during
 
 ::: mountaineer.cli.handle_build
 
+Building your app will compile your TypeScript into the client-side bundle that will be downloaded
+by the browser. It also ahead-of-time generates the server code that will be run as part of [SSR](./ssr.md).
+You'll want to do it before deploying your application into production - but since a full build can take up
+to 10s, `handle_runserver` provides a better workflow for daily development.
+
 ## Database CLI
 
 ::: mountaineer.database.cli.handle_createdb

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/docs_website/docs/api/ssr.md

@@ -10,4 +10,4 @@ Most SSR logic is handled in our embedded Rust layer. In Rust we spin up a V8 is
 
 ## Source Maps
 
-::: mountaineer.js_compiler.source_maps.SourceMapParser
+::: mountaineer.client_compiler.source_maps.SourceMapParser

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/docs_website/docs/api/watch_server.md

@@ -2,8 +2,8 @@
 
 Used by Mountaineer CLI hooks to isolate your server and push updates to live-reload browsers. You probably won't have to deal with this class explicitly.
 
+::: mountaineer.app_manager.HotReloadManager
+
 ::: mountaineer.watch.PackageWatchdog
 
 ::: mountaineer.watch_server.WatcherWebservice
-
-::: mountaineer.cli.IsolatedEnvProcess

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/docs_website/docs/database_migrations.md

@@ -134,7 +134,7 @@ The `up_revision` and `down_revision` are used to track the migration state. The
 
 ## Extending Migration Files
 
-The `Migrator` object is a thin wrapper around the `DatabaseActions` object, which is a collection of common migration operations. If you need to perform a more complex migration operation, you can customize the logic by calling `migrator.actor` yourself. Head over to the [DatabaseActions documentation](/database/migrations) to see the full list of available migration operations.
+The `Migrator` object is a thin wrapper around the `DatabaseActions` object, which is a collection of common migration operations. If you need to perform a more complex migration operation, you can customize the logic by calling `migrator.actor` yourself. Head over to the [DatabaseActions documentation](./api/database/migrations.md) to see the full list of available migration operations.
 
 In addition to the actor, you can also access the underlying database session object. This is useful if you need to run raw SQL queries that aren't covered by the actor object.
 

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/docs_website/docs/deploy.md

@@ -110,6 +110,18 @@ COPY --from=server-hooks-builder /usr/src/app/{my_webapp}/views /venv/lib/python
 CMD ["/venv/bin/uvicorn", "{my_webapp}.main:app", "--host", "0.0.0.0", "--port", "3000"]
 ```
 
+## Local Testing
+
+Once your Docker image is built, the best way to test it is to run it locally with `docker run`.
+However you can also simulate what the production service is doing by running:
+
+```bash
+poetry run build
+ENVIRONMENT=PRODUCTION poetry run uvicorn {my_webapp}.main:app --host localhost --port 5006
+```
+
+This runs with production-minified assets and the same configuration as the production server.
+
 ## Common Errors
 
 If you see "required file not found" when you try to run this docker image, double check that your venv is pointing to the correct version of Python within the container:

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/docs_website/docs/internal/core_library.md

@@ -21,6 +21,35 @@ You can also run maturin just with `poetry run maturin develop`, which will be m
 
 You'll also need a system-wide installation of esbuild. If you don't have one when you run the build pipline it will install one for you within `~/.cache/mountaineer/esbuild`.
 
+## External Application
+
+If you want to test your mountaineer changes against a real webapp, you can build a wheel and then add it
+to your project's virtual environment:
+
+```bash
+$ poetry run maturin build --release
+
+   Finished `release` profile [optimized] target(s) in 51.28s
+📦 Built wheel for CPython 3.12 to /Users/piercefreeman/projects/mountaineer/target/wheels/mountaineer-0.1.0-cp312-cp312-macosx_11_0_arm64.whl
+```
+
+Then, in your other project. If you've already installed a previous local mountaineer wheel, you'll have to run with `--force-reinstall` to prompt pip
+to actually swap out the wheels versus ignoring the same version number.
+
+```bash
+poetry run pip install [--force-reinstall] /Users/piercefreeman/projects/mountaineer/target/wheels/mountaineer-0.1.0-cp312-cp312-macosx_11_0_arm64.whl
+```
+
+## Logging
+
+It's sometimes helpful to run Mountaineer with verbose logging, whether you're developing new functionality
+or trying to diagnose a problem. You can set the `MOUNTAINEER_LOG_LEVEL` environment variable to `DEBUG` to
+enable verbose logging:
+
+```bash
+$ MOUNTAINEER_LOG_LEVEL=DEBUG poetry run runserver
+```
+
 ## Development Utilities
 
 1. Python Testing
@@ -56,4 +85,3 @@ You'll also need a system-wide installation of esbuild. If you don't have one wh
     $ docker run -it mountaineer
     $ make install-deps
     $ make test-integrations
-    ```

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/docs_website/docs/postcss.md

@@ -13,7 +13,7 @@ npm install postcss-cli
 After this you can leverage the `PostCSSBundler` within your custom build pipeline:
 
 ```python
-from mountaineer.js_compiler.postcss import PostCSSBundler
+from mountaineer.client_compiler.postcss import PostCSSBundler
 
 controller = AppController(
     custom_builders=[

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/docs_website/docs/quickstart.md

@@ -144,7 +144,7 @@ Now that we've newly created this controller, we wire it up to the application.
 
 ```python title="my_webapp/app.py"
 from mountaineer.app import AppController
-from mountaineer.js_compiler.postcss import PostCSSBundler
+from mountaineer.client_compiler.postcss import PostCSSBundler
 from mountaineer.render import LinkAttribute, Metadata
 
 from my_webapp.config import AppConfig

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/docs_website/mkdocs.yml

@@ -62,7 +62,6 @@ nav:
       - api/database/dependencies.md
       - api/database/migrations.md
     - Build Plugins:
-      - api/build_plugins/javascript.md
       - api/build_plugins/postcss.md
       - api/build_plugins/base.md
   - Internal:

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/mountaineer/__init__.py

@@ -5,12 +5,12 @@ from fastapi import Depends as Depends
 from mountaineer.actions.passthrough_dec import passthrough as passthrough
 from mountaineer.actions.sideeffect_dec import sideeffect as sideeffect
 from mountaineer.app import AppController as AppController
+from mountaineer.client_compiler.postcss import PostCSSBundler as PostCSSBundler
 from mountaineer.config import ConfigBase as ConfigBase
 from mountaineer.controller import ControllerBase as ControllerBase
 from mountaineer.controller_layout import LayoutControllerBase as LayoutControllerBase
 from mountaineer.dependencies import CoreDependencies as CoreDependencies
 from mountaineer.exceptions import APIException as APIException
-from mountaineer.js_compiler.postcss import PostCSSBundler as PostCSSBundler
 from mountaineer.paths import ManagedViewPath as ManagedViewPath
 from mountaineer.render import (
     LinkAttribute as LinkAttribute,

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/mountaineer/__tests__/actions/test_passthrough_dec.py

@@ -29,14 +29,16 @@ def test_markup_passthrough():
     class ExamplePassthroughModel(BaseModel):
         first_name: str
 
-    class TestController(ControllerBase):
+    class ExampleController(ControllerBase):
+        view_path = "/test.tsx"
+
         @passthrough
         def get_external_data(self) -> ExamplePassthroughModel:
             return ExamplePassthroughModel(
                 first_name="John",
             )
 
-    metadata = get_function_metadata(TestController.get_external_data)
+    metadata = get_function_metadata(ExampleController.get_external_data)
     assert metadata.action_type == FunctionActionType.PASSTHROUGH
     assert metadata.get_passthrough_model() == ExamplePassthroughModel
     assert metadata.function_name == "get_external_data"
@@ -56,6 +58,7 @@ class ExamplePassthroughModel(BaseModel):
 
 class ExampleController(ControllerBase):
     url: str = "/test/{query_id}/"
+    view_path = "/test.tsx"
 
     def __init__(self):
         super().__init__()
@@ -135,6 +138,7 @@ class ExampleModel(BaseModel):
 
 class ExampleIterableController(ControllerBase):
     url = "/example"
+    view_path = "/test.tsx"
 
     async def render(self) -> None:
         pass
@@ -207,8 +211,9 @@ async def test_can_call_iterable():
 
 @pytest.mark.asyncio
 async def test_raw_response():
-    class TestController(ControllerBase):
+    class ExampleController(ControllerBase):
         url: str = "/test/{query_id}/"
+        view_path = "/test.tsx"
 
         def render(
             self,
@@ -221,7 +226,7 @@ async def test_raw_response():
             return JSONResponse(content={"raw_value": "success"})
 
     app = AppController(view_root=Path())
-    controller = TestController()
+    controller = ExampleController()
     app.register(controller)
 
     controller_definition = app.definition_for_controller(controller)

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/mountaineer/__tests__/actions/test_sideeffect_dec.py

@@ -35,6 +35,8 @@ def test_markup_sideeffect():
         first_name: str
 
     class TestController(ControllerBase):
+        view_path = "/test.tsx"
+
         # We declare as complicated a payload as @sideeffect supports so we can
         # see the full amount of metadata properties that are set
         @sideeffect(
@@ -56,6 +58,7 @@ def test_markup_sideeffect():
 
 class ControllerCommon(ControllerBase):
     url: str = "/test/{query_id}/"
+    view_path = "/test.tsx"
 
     def __init__(self):
         super().__init__()
@@ -234,6 +237,7 @@ async def test_get_render_parameters(
 
     class TestController(ControllerBase):
         url: str = "/test/{path_param}/"
+        view_path = "/test.tsx"
 
         def render(
             self,
@@ -292,6 +296,7 @@ def test_limit_codepath_experimental(
 ):
     class ExampleController(ControllerBase):
         url: str = "/test/{query_id}/"
+        view_path = "/test.tsx"
 
         def render(
             self,

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/mountaineer/__tests__/client_builder/test_builder.py

@@ -85,6 +85,8 @@ def test_generate_link_aggregator(builder: ClientBuilder):
 
 def test_generate_link_aggregator_ignores_layout(builder: ClientBuilder):
     class ExampleLayout(LayoutControllerBase):
+        view_path = "/test.tsx"
+
         async def render(self) -> None:
             pass
 

{mountaineer-0.5.2.dev4/mountaineer/__tests__/js_compiler → mountaineer-0.7.0.dev1/mountaineer/__tests__/client_compiler}/test_postcss.py

@@ -1,6 +1,6 @@
 import pytest
 
-from mountaineer.js_compiler.postcss import PostCSSBundler
+from mountaineer.client_compiler.postcss import PostCSSBundler
 from mountaineer.paths import ManagedViewPath
 
 

{mountaineer-0.5.2.dev4/mountaineer/__tests__/js_compiler → mountaineer-0.7.0.dev1/mountaineer/__tests__/client_compiler}/test_source_maps.py

@@ -5,7 +5,7 @@ import pytest
 
 from mountaineer import mountaineer as mountaineer_rs  # type: ignore
 from mountaineer.__tests__.fixtures import get_fixture_path
-from mountaineer.js_compiler.source_maps import (
+from mountaineer.client_compiler.source_maps import (
     SourceMapParser,
     SourceMapSchema,
 )

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/mountaineer/__tests__/fixtures/ci_webapp/ci_webapp/app.py

@@ -1,5 +1,5 @@
 from mountaineer import AppController, LinkAttribute, Metadata
-from mountaineer.js_compiler.postcss import PostCSSBundler
+from mountaineer.client_compiler.postcss import PostCSSBundler
 
 from ci_webapp.config import AppConfig
 from ci_webapp.controllers.complex import ComplexController

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/mountaineer/__tests__/fixtures/ci_webapp/ci_webapp/cli.py

@@ -3,12 +3,14 @@ from mountaineer.cli import handle_build, handle_runserver, handle_watch
 
 
 @command()
+@option("--host", default="127.0.0.1")
 @option("--port", default=5006)
-def runserver(port):
+def runserver(host: str, port: int):
     handle_runserver(
         package="ci_webapp",
         webservice="ci_webapp.main:app",
         webcontroller="ci_webapp.app:controller",
+        host=host,
         port=port,
         subscribe_to_mountaineer=True,
     )

mountaineer-0.7.0.dev1/mountaineer/__tests__/fixtures/ci_webapp/ci_webapp/views/app/home/element.tsx

@@ -0,0 +1,5 @@
+import React from "react";
+
+export const CustomComponent = () => {
+  return <div>Demonstrate an imported component!</div>;
+};

{mountaineer-0.5.2.dev4 → mountaineer-0.7.0.dev1}/mountaineer/__tests__/fixtures/ci_webapp/ci_webapp/views/app/home/page.tsx

@@ -1,5 +1,6 @@
 import React from "react";
 import { useServer, HTTPValidationErrorException } from "./_server";
+import { CustomComponent } from "./element";
 
 const Home = () => {
   const serverState = useServer();
@@ -13,6 +14,7 @@ const Home = () => {
         Hello {serverState.client_ip}, current count is{" "}
         {serverState.current_count} {serverState.random_uuid}
       </p>
+      <CustomComponent />
       <p>
         <a
           className="font-medium text-blue-500"