sqlbuild 0.48.6__tar.gz → 0.48.7__tar.gz

sqlbuild-0.48.7/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.48.7"
+}

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.48.7](https://github.com/chio-labs/sqlbuild/compare/v0.48.6...v0.48.7) (2026-08-02)
+
+
+### Bug Fixes
+
+* **loaders:** isolate schemas and clone managed sources ([253cd2b](https://github.com/chio-labs/sqlbuild/commit/253cd2b44732cc34adf6e753bf0746f3d8f648b9))
+* **loaders:** isolate schemas and clone managed sources ([3003167](https://github.com/chio-labs/sqlbuild/commit/300316787a6bf5678a942a5534f986c0c7cbf7d1))
+
+
+### Documentation
+
+* surface local configuration workflow ([ae7cdd7](https://github.com/chio-labs/sqlbuild/commit/ae7cdd703c4d6329c8697ec6da4a95fc4bebe007))
+
 ## [0.48.6](https://github.com/chio-labs/sqlbuild/compare/v0.48.5...v0.48.6) (2026-08-02)
 
 

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlbuild
-Version: 0.48.6
+Version: 0.48.7
 Summary: Typed, test-first SQL pipelines with local E2E testing
 License-File: LICENSE
 Requires-Python: >=3.12

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sqlbuild"
-version = "0.48.6"
+version = "0.48.7"
 description = "Typed, test-first SQL pipelines with local E2E testing"
 readme = "README.md"
 requires-python = ">=3.12"

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/src/sqlbuild/.agents/skills/sqlbuild/SKILL.md

@@ -356,6 +356,12 @@ cd waffle-shop
 
 This creates a self-contained waffle shop project with everything you need to explore SQLBuild.
 
+The playground creates the shared `sqlbuild_project.toml`; that is sufficient for this
+quickstart. In a team project, you can additionally create a gitignored
+`sqlbuild_local.toml` to select your usual target and override your personal development
+schema or credentials without changing the committed project config. See
+[Project Configuration](/concepts/project-configuration#sqlbuild_local-toml).
+
 ### 2. Plan
 
 Preview what SQLBuild will do:
@@ -1590,6 +1596,26 @@ SQLBuild projects are configured with two files in the project root:
 - **`sqlbuild_project.toml`** - shared project configuration, committed to version control
 - **`sqlbuild_local.toml`** - local developer overrides, gitignored
 
+Most projects need only one committed `sqlbuild_project.toml`. Define shared targets such
+as `dev` and `prod` there, including clone policies and team-wide defaults. Do not maintain
+separate complete project files for each environment.
+
+Create `sqlbuild_local.toml` only when a developer or execution environment needs different
+target selection, credentials, schemas, adapter settings, or variables. SQLBuild loads it
+automatically and merges its explicitly configured values over the shared project config.
+
+```text
+project/
+  sqlbuild_project.toml   # committed: shared targets and behavior
+  sqlbuild_local.toml     # gitignored: this developer's overrides
+```
+
+Add the local file to `.gitignore`:
+
+```gitignore
+sqlbuild_local.toml
+```
+
 ### sqlbuild_project.toml
 
 A complete example:
@@ -1658,6 +1684,7 @@ A target is a named build context - the schema, database, or connection you buil
 | Field | Description |
 |-------|-------------|
 | `schema` | Schema for all models in this target |
+| `loader_schema` | Default write schema for managed source loaders; falls back to `schema` |
 | `database` | Database for all models in this target |
 | `connection` | Override the base connection config |
 | `vars` | Target-specific project variables |
@@ -1668,16 +1695,14 @@ A target is a named build context - the schema, database, or connection you buil
 
 ```toml
 [targets.prod]
-schema = "prod"
-
-[targets.prod.vars]
-source_schema = "raw_prod"
+schema = "analytics_prod"
+loader_schema = "raw_prod"
+defer_sources_to = "prod"
 
 [targets.dev]
-schema = "dev"
-
-[targets.dev.vars]
-source_schema = "raw_dev"
+schema = "analytics_dev"
+loader_schema = "raw_dev"
+defer_sources_to = "prod"
 
 [targets.staging]
 schema = "staging"
@@ -1686,6 +1711,15 @@ schema = "staging"
 database = "staging.duckdb"
 ```
 
+Managed loader writes use the active target's `loader_schema`, falling back to its model
+`schema`. Managed source reads use the target named by `defer_sources_to`, or the active
+target itself when deferral is omitted. In the example, `load --target dev` writes to
+`raw_dev`, while models built in dev read from `raw_prod`.
+
+SQLBuild rejects targets on the same warehouse/database when their managed loader writes
+resolve to the same schema. Two targets may read the same schema through deferral, but they
+cannot both own loader writes there.
+
 #### Selecting a target
 
 The active target is determined by (in order of precedence):
@@ -1695,6 +1729,21 @@ The active target is determined by (in order of precedence):
 3. `default_target` in `sqlbuild_project.toml`
 4. No target (models build to the default schema)
 
+A typical developer keeps shared target definitions in `sqlbuild_project.toml` and selects
+their normal target once in the optional local file:
+
+```toml
+# sqlbuild_local.toml
+target = "dev"
+
+[targets.dev]
+schema = "dev_alice"
+loader_schema = "raw_alice"
+```
+
+Commands then use `dev` automatically. An explicit command such as `sqb build --target prod`
+still takes precedence for that invocation.
+
 #### Clone policies
 
 Targets can declare whether they allow cloning to or from:
@@ -1912,12 +1961,17 @@ See [skills CLI reference](/cli/skills) for usage details.
 
 ### sqlbuild_local.toml
 
-Local developer overrides. This file should be gitignored.
+Local developer overrides. This optional file is loaded automatically and should be
+gitignored. Only put values that differ from the shared project configuration here.
 
 ```toml
 target = "dev"
 
-[connection]
+[targets.dev]
+schema = "dev_alice"
+loader_schema = "raw_alice"
+
+[targets.dev.connection]
 database = "my_local.duckdb"
 
 [settings]
@@ -1936,7 +1990,13 @@ debug_mode = "true"
 | `settings` | Override global settings (only explicitly set fields take effect) |
 | `vars` | Developer-specific variable overrides (merged on top of project + target vars) |
 
-This replaces the common dbt pattern of switching profiles or setting environment variables to change targets. Each developer sets their target, connection, and preferences once in `sqlbuild_local.toml` and it persists across sessions.
+Target blocks support the same local overrides, including `schema`, `loader_schema`,
+`connection`, `vars`, source deferral, reuse, and clone policy fields. Unspecified values
+continue to come from `sqlbuild_project.toml`.
+
+This replaces the common dbt pattern of switching profiles or setting environment variables
+to change targets. Each developer sets their target, connection, and preferences once in
+`sqlbuild_local.toml` and it persists across sessions.
 
 ## Overview
 
@@ -2665,7 +2725,7 @@ Use [`sqb freshness`](/cli/freshness) to observe source freshness on demand with
 |-------|-------------|
 | `name` | Source name, used in `__source("name")` references |
 | `database` | Target database (optional) |
-| `schema` | Target schema (optional) |
+| `schema` | Physical source schema (optional). For managed sources, overrides target `loader_schema`; otherwise managed loaders fall back to `loader_schema`, then target `schema`. |
 | `table` | Target table name (defaults to `name` if omitted) |
 | `expression` | Inline SQL expression (alternative to table reference) |
 | `managed` | Set to `true` to bind the source to the `@loader` function of the same name (see [Loaders](/concepts/python-nodes/loaders)) |
@@ -6553,20 +6613,36 @@ When `--reload` is passed, `ctx.is_reload` is `True` in the loader function. Thi
 
 ### Source deferral
 
-When using multiple targets, loaders write data into the active target. But models may need to read source data from a different target (e.g. reading production data while developing in dev). The `defer_sources_to` field controls this:
+Loader writes and managed source reads are resolved separately. `loader_schema` controls
+where a target's loaders write; `defer_sources_to` optionally selects another target whose
+managed sources models should read.
 
 ```toml
 [targets.dev]
-schema = "dev"
+schema = "analytics_dev"
+loader_schema = "raw_dev"
 defer_sources_to = "prod"
 
 [targets.prod]
-schema = "prod"
+schema = "analytics_prod"
+loader_schema = "raw_prod"
 ```
 
-With this config, models in the `dev` target read managed source data from `prod` schema, even though `sqb load` writes to `dev`. This prevents accidentally reading empty or partial source tables during development.
+With this config:
+
+- `sqb load --target dev` writes to `raw_dev`.
+- `sqb load --target prod` writes to `raw_prod`.
+- Models built in dev read from `raw_prod` because dev defers source reads to prod.
+- Models built in prod read from `raw_prod` because omitted deferral defaults to the active target.
+
+If `loader_schema` is omitted, loaders fall back to the active target's model `schema`, then
+the adapter default schema. An explicit `schema` on a managed source overrides the target
+default. SQLBuild validates final managed-loader write namespaces and rejects two targets
+on the same warehouse/database that could write to the same schema.
 
-If a target uses managed sources but does not declare `defer_sources_to`, SQLBuild raises an error rather than guessing.
+`defer_sources_to` never redirects loader writes. It only changes `__source()` and Python
+`source()` reads. This lets developers test loaders in an isolated schema without making
+development models consume partial development source data.
 
 ### Schema evolution
 
@@ -9906,6 +9982,7 @@ sqb --project-dir <path> build [flags]
 
 | Flag | Description |
 |------|-------------|
+| `--target` | Build against a configured target instead of the active/default target |
 | `--changes-only` | Skip models, seeds, audits, and Python nodes that are already current; build only stale work |
 | `--no-tests` | Skip SQL unit tests |
 | `--no-audits` | Skip audits |
@@ -10581,14 +10658,17 @@ Copy model relations between configured targets.
 
 ## sqb clone
 
-Copies model relations from one target to another. It uses adapter-native cloning where supported and physical copies where required; `--hard-copy` forces a physical copy on adapters that support both.
+Copies selected relations from one target to another. It uses adapter-native cloning where supported and physical copies where required; `--hard-copy` forces a physical copy on adapters that support both.
 
 No `manifest.json` generation or artifact management is required. Clone works directly against live targets.
 
+When `--to` is omitted, the destination is the active target selected by `--target`,
+`sqlbuild_local.toml`, or `default_target`, in that order.
+
 ### Usage
 
 ```bash
-sqb --project-dir <path> clone --from <target> --to <target> [flags]
+sqb --project-dir <path> clone --from <target> [--to <target>] [flags]
 ```
 
 ### Flags
@@ -10596,7 +10676,7 @@ sqb --project-dir <path> clone --from <target> --to <target> [flags]
 | Flag | Description |
 |------|-------------|
 | `--from` | Source target (required) |
-| `--to` | Destination target (required) |
+| `--to` | Destination target; defaults to the active target |
 | `--hard-copy` | Force physical table copies instead of zero-copy cloning |
 | `--no-sql-validation` | Skip compile-time SQL syntax validation |
 | `--select`, `-s` | Select specific models to clone |
@@ -10608,6 +10688,9 @@ sqb --project-dir <path> clone --from <target> --to <target> [flags]
 # Clone all models from prod to dev
 sqb clone --from prod --to dev
 
+# Equivalent when dev is the active target
+sqb clone --from prod
+
 # Clone only marts to dev
 sqb clone --from prod --to dev --select path:models/marts
 
@@ -10615,6 +10698,24 @@ sqb clone --from prod --to dev --select path:models/marts
 sqb clone --from prod --to dev --hard-copy
 ```
 
+### Managed sources
+
+Clone includes selected managed physical sources when the destination target reads its own
+loader namespace. Sources are copied before seeds and models so views can be recreated in a
+destination that has never been built.
+
+Source locations respect target configuration:
+
+- The origin relation comes from the target that the origin uses for managed source reads.
+- The destination relation uses the destination target's `loader_schema`, falling back to
+  its model `schema`.
+- If the destination defers source reads to another target, clone reuses that target's source
+  relation and does not copy or overwrite it.
+- Expression sources and unmanaged external sources are not cloned.
+
+`--hard-copy` controls how included relations are copied. It does not change which managed
+sources are selected.
+
 ### Clone policies
 
 Targets deny cloning by default. Enable the origin and destination explicitly in `sqlbuild_project.toml`:
@@ -10627,7 +10728,7 @@ allow_as_clone_origin = true
 allow_as_clone_destination = true
 ```
 
-The origin target must already contain the built relations being cloned. The configured warehouse credentials must be able to read those relations and create relations in the destination. See [Project Configuration](/concepts/project-configuration) for details.
+The origin target must already contain the built relations being cloned. The configured warehouse credentials must be able to read those relations and create relations in the destination. Managed physical sources may bootstrap a destination that has not been built. See [Project Configuration](/concepts/project-configuration) for details.
 
 ## diff
 

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/src/sqlbuild/cli/commands/_helpers/build_planning/defer_clone.py

@@ -43,7 +43,7 @@ from sqlbuild.compiler.planner.types import MaterializationType
 from sqlbuild.executor.clone.main.execute import execute_clone
 from sqlbuild.executor.clone.main.fingerprinting import copy_clone_fingerprints
 from sqlbuild.executor.clone.main.run_prephase_clone_stream import run_prephase_clone_stream
-from sqlbuild.executor.clone.models import CloneExecutionResult
+from sqlbuild.executor.clone.models import CloneExecutionResult, CloneSourceEntries
 from sqlbuild.executor.clone.types import CloneStatus
 
 
@@ -230,6 +230,10 @@ def run_defer_clone_prephase(
 
         def run_clone(on_item: Any) -> CloneExecutionResult:
             return execute_clone(
+                source_entries=CloneSourceEntries(
+                    origin=clone_pipeline.origin_source_entries,
+                    destination=clone_pipeline.destination_source_entries,
+                ),
                 origin_model_entries=clone_pipeline.origin_model_entries,
                 destination_model_entries=clone_pipeline.destination_model_entries,
                 origin_seed_entries=clone_pipeline.origin_seed_entries,

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/src/sqlbuild/cli/commands/_helpers/clone/connections.py

@@ -30,7 +30,7 @@ def connect_clone_targets(
     destination_connection_config: dict[str, object] = resolve_target_connection_config(
         discovered_inputs=invocation.discovered_inputs,
         project_dir=invocation.effective_project_dir,
-        target_name=request.destination_target_name,
+        target_name=invocation.destination_target_name,
         cli_vars=request.cli_vars,
     )
     progress: PlanningProgressReporter = PlanningProgressReporter(

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/src/sqlbuild/cli/commands/_helpers/clone/execution.py

@@ -15,7 +15,11 @@ from sqlbuild.cli.commands.models import (
 )
 from sqlbuild.executor.clone.main.execute import execute_clone
 from sqlbuild.executor.clone.main.fingerprinting import copy_clone_fingerprints
-from sqlbuild.executor.clone.models import CloneExecutionResult, CloneItemResult
+from sqlbuild.executor.clone.models import (
+    CloneExecutionResult,
+    CloneItemResult,
+    CloneSourceEntries,
+)
 from sqlbuild.executor.clone.types import CloneItemCallback
 
 
@@ -34,6 +38,10 @@ def execute_clone_plan(
         use_color=invocation.use_color,
     )
     result: CloneExecutionResult = execute_clone(
+        source_entries=CloneSourceEntries(
+            origin=preparation.pipeline_result.origin_source_entries,
+            destination=preparation.pipeline_result.destination_source_entries,
+        ),
         origin_model_entries=preparation.pipeline_result.origin_model_entries,
         destination_model_entries=preparation.pipeline_result.destination_model_entries,
         origin_seed_entries=preparation.pipeline_result.origin_seed_entries,

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/src/sqlbuild/cli/commands/_helpers/clone/invocation.py

@@ -9,6 +9,7 @@ from typing import TextIO
 from sqlbuild.adapter.contract.classes.base_adapter import BaseAdapter
 from sqlbuild.cli.commands._helpers.clone.validation import validate_clone_request
 from sqlbuild.cli.commands._helpers.runtime.adapters import resolve_adapter
+from sqlbuild.cli.commands.exceptions import CliUserError
 from sqlbuild.cli.commands.models import CloneCommandRequest, CloneInvocation
 from sqlbuild.cli.progress.classes.planning_progress_reporter import PlanningProgressReporter
 from sqlbuild.compiler.discovery.main.discover import discover_project_inputs
@@ -17,6 +18,7 @@ from sqlbuild.presentation.main.supports_color import supports_color
 from sqlbuild.spec.contracts.main.resolve_effective_adapter_name import (
     resolve_effective_adapter_name,
 )
+from sqlbuild.spec.contracts.main.resolve_target_name import resolve_target_name
 
 
 def resolve_clone_invocation(*, request: CloneCommandRequest) -> CloneInvocation:
@@ -36,10 +38,22 @@ def resolve_clone_invocation(*, request: CloneCommandRequest) -> CloneInvocation
         project_dir=effective_project_dir
     )
     progress.complete("Discovered project.")
+    destination_target_name: str | None = request.destination_target_name
+    if destination_target_name is None:
+        destination_target_name = resolve_target_name(
+            project_config=discovered_inputs.project_config,
+            local_config=discovered_inputs.local_config,
+            selected_target=None,
+        )
+    if destination_target_name is None:
+        raise CliUserError(
+            "clone requires --to when the project has no active target",
+            code="C406",
+        )
     validate_clone_request(
         discovered_inputs=discovered_inputs,
         origin_target_name=request.origin_target_name,
-        destination_target_name=request.destination_target_name,
+        destination_target_name=destination_target_name,
     )
     adapter_name: str = resolve_effective_adapter_name(
         project_config=discovered_inputs.project_config,
@@ -53,6 +67,7 @@ def resolve_clone_invocation(*, request: CloneCommandRequest) -> CloneInvocation
         discovered_inputs=discovered_inputs,
         adapter_name=adapter_name,
         adapter=adapter,
+        destination_target_name=destination_target_name,
         use_color=use_color,
         progress_stream=progress_stream,
     )

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/src/sqlbuild/cli/commands/_helpers/clone/outputs.py

@@ -23,13 +23,15 @@ def write_clone_execution_header(
 ) -> None:
     """Write the standard clone execution header."""
 
-    clone_total: int = len(preparation.pipeline_result.destination_model_entries) + len(
-        preparation.pipeline_result.destination_seed_entries
+    clone_total: int = (
+        len(preparation.pipeline_result.destination_source_entries)
+        + len(preparation.pipeline_result.destination_model_entries)
+        + len(preparation.pipeline_result.destination_seed_entries)
     )
     invocation.progress_stream.write(
         render_clone_header(
             origin_target_name=request.origin_target_name,
-            destination_target_name=request.destination_target_name,
+            destination_target_name=invocation.destination_target_name,
             total=clone_total,
             use_color=invocation.use_color,
         )

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/src/sqlbuild/cli/commands/_helpers/clone/planning.py

@@ -17,7 +17,7 @@ from sqlbuild.cli.commands.models import (
 from sqlbuild.cli.progress.classes.planning_progress_reporter import PlanningProgressReporter
 from sqlbuild.compiler.pipeline.main.clone import run_clone_pipeline
 from sqlbuild.compiler.pipeline.models import ClonePipelineResult
-from sqlbuild.compiler.planner.models import ModelPlanEntry, SeedPlanEntry
+from sqlbuild.compiler.planner.models import CloneSourcePlanEntry, ModelPlanEntry, SeedPlanEntry
 
 
 def prepare_clone_execution(
@@ -38,7 +38,7 @@ def prepare_clone_execution(
         discovered_inputs=invocation.discovered_inputs,
         adapter=invocation.adapter,
         origin_target_name=request.origin_target_name,
-        destination_target_name=request.destination_target_name,
+        destination_target_name=invocation.destination_target_name,
         no_sql_validation=request.no_sql_validation,
         select=request.select,
         exclude=request.exclude,
@@ -54,6 +54,13 @@ def prepare_clone_execution(
         pipeline_result.destination_model_entries
     )
     destination_seed_entries: tuple[SeedPlanEntry, ...] = pipeline_result.destination_seed_entries
-    if not destination_model_entries and not destination_seed_entries:
+    destination_source_entries: tuple[CloneSourcePlanEntry, ...] = (
+        pipeline_result.destination_source_entries
+    )
+    if (
+        not destination_model_entries
+        and not destination_seed_entries
+        and not destination_source_entries
+    ):
         raise CliUserError("no cloneable resources found in the selected scope", code="C407")
     return CloneExecutionPreparation(pipeline_result=pipeline_result)

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/src/sqlbuild/cli/commands/_helpers/clone/virtual.py

@@ -34,7 +34,7 @@ def execute_virtual_clone(*, request: CloneCommandRequest, invocation: CloneInvo
         discovered_inputs=invocation.discovered_inputs,
         adapter=invocation.adapter,
         origin_target_name=request.origin_target_name,
-        destination_target_name=request.destination_target_name,
+        destination_target_name=invocation.destination_target_name,
         origin_connection_config=resolve_target_connection_config(
             discovered_inputs=invocation.discovered_inputs,
             project_dir=invocation.effective_project_dir,
@@ -44,7 +44,7 @@ def execute_virtual_clone(*, request: CloneCommandRequest, invocation: CloneInvo
         destination_connection_config=resolve_target_connection_config(
             discovered_inputs=invocation.discovered_inputs,
             project_dir=invocation.effective_project_dir,
-            target_name=request.destination_target_name,
+            target_name=invocation.destination_target_name,
             cli_vars=request.cli_vars,
         ),
         options=CloneOptions(

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/src/sqlbuild/cli/commands/_helpers/entry/dispatch.py

@@ -281,8 +281,8 @@ def dispatch_cli_command(*, args: CliNamespace, handlers: CliEntrypointHandlers)
             cli_vars=args.vars,
         )
     if args.command == CliCommand.CLONE:
-        if args.from_target is None or args.to_target is None:
-            raise CliUserError("clone requires --from and --to", code="C406")
+        if args.from_target is None:
+            raise CliUserError("clone requires --from", code="C406")
         return handlers.run_clone(
             CloneCommandRequest(
                 project_dir=project_dir,

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/src/sqlbuild/cli/commands/_helpers/entry/parser.py

@@ -234,7 +234,7 @@ def _add_data_parsers(
     clone_parser: argparse.ArgumentParser = subparsers.add_parser(CliCommand.CLONE)
     clone_parser.add_argument("--no-sql-validation", action="store_true", default=False)
     clone_parser.add_argument("--from", dest="from_target", required=True)
-    clone_parser.add_argument("--to", dest="to_target", required=True)
+    clone_parser.add_argument("--to", dest="to_target", default=None)
     clone_parser.add_argument("--hard-copy", action="store_true", default=False)
     clone_parser.add_argument("--virtual-env", default=None)
     clone_parser.add_argument("--skip-locked", action="store_true", default=False)

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/src/sqlbuild/cli/commands/_helpers/playground/copy.py

@@ -33,7 +33,6 @@ materialized = "table"
 
 [targets.dev]
 schema = "main"
-defer_sources_to = "dev"
 """
 
 _PYTHON_NODES_README: str = """# SQLBuild Python Nodes Playground
@@ -200,7 +199,6 @@ materialized = "table"
 
 [targets.dev]
 schema = "dev"
-defer_sources_to = "dev"
 
 [targets.dev.state]
 backend = "duckdb"

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/src/sqlbuild/cli/commands/_helpers/playground/templates/waffle_shop/sqlbuild_project.toml

@@ -16,7 +16,6 @@ schema = "prod"
 
 [targets.dev]
 schema = "dev"
-defer_sources_to = "dev"
 
 [path_defaults.staging]
 materialized = "view"

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/src/sqlbuild/cli/commands/models.py

@@ -374,7 +374,7 @@ class CloneCommandRequest:
     no_color: bool
     no_sql_validation: bool
     origin_target_name: str
-    destination_target_name: str
+    destination_target_name: str | None
     hard_copy: bool
     virtual_env: str | None = None
     skip_locked: bool = False
@@ -392,6 +392,7 @@ class CloneInvocation:
     discovered_inputs: DiscoveredProjectInputs
     adapter_name: str
     adapter: BaseAdapter
+    destination_target_name: str
     use_color: bool
     progress_stream: TextIO
 

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/src/sqlbuild/compiler/compile/_helpers/assembly/project.py

@@ -149,6 +149,7 @@ def assemble_compiled_project(
             _assemble_compiled_source(
                 source_input=source_input,
                 target_config=inputs.effective_target,
+                effective_vars=inputs.effective_vars,
             )
             for source_input in inputs.source_inputs
         ),
@@ -403,10 +404,12 @@ def _assemble_compiled_source(
     *,
     source_input: CompileSourceInput,
     target_config: TargetConfig | None,
+    effective_vars: dict[str, object],
 ) -> CompiledSource:
     source_entry: SourceEntry = _build_source_relation_entry(
         source_entry=source_input.source_entry,
         target_config=target_config,
+        effective_vars=effective_vars,
     )
     return CompiledSource(
         key=CompiledObjectKey(resource_type=CompiledResourceType.SOURCE, name=source_entry.name),
@@ -421,15 +424,44 @@ def _build_source_relation_entry(
     *,
     source_entry: SourceEntry,
     target_config: TargetConfig | None,
+    effective_vars: dict[str, object],
 ) -> SourceEntry:
     if source_entry.loader is None or target_config is None:
         return source_entry
     return replace(
         source_entry,
         database=(
-            source_entry.database if source_entry.database is not None else target_config.database
+            source_entry.database
+            if source_entry.database is not None
+            else _expand_target_value(
+                value=target_config.database,
+                effective_vars=effective_vars,
+            )
         ),
-        schema=source_entry.schema if source_entry.schema is not None else target_config.schema,
+        schema=(
+            source_entry.schema
+            if source_entry.schema is not None
+            else _expand_target_value(
+                value=target_config.loader_schema or target_config.schema,
+                effective_vars=effective_vars,
+            )
+        ),
+    )
+
+
+def _expand_target_value(*, value: str | None, effective_vars: dict[str, object]) -> str | None:
+    if value is None:
+        return None
+    return str(
+        expand_template_data(
+            value=value,
+            variables=effective_vars,
+            context_values={},
+            context_label="managed source target",
+            allow_context=False,
+            preserve_context_tokens=False,
+            preserve_unknown_context=False,
+        )
     )
 
 

{sqlbuild-0.48.6 → sqlbuild-0.48.7}/src/sqlbuild/compiler/discovery/_helpers/yml/project.py

@@ -461,6 +461,7 @@ def _load_targets(*, payload: object, file_path: Path) -> dict[str, TargetConfig
             vars=_load_string_mapping(payload=target_mapping.get("vars"), file_path=file_path),
             database=_optional_str(payload=target_mapping, key="database"),
             schema=_optional_str(payload=target_mapping, key="schema"),
+            loader_schema=_optional_str(payload=target_mapping, key="loader_schema"),
             defer_sources_to=_optional_str(payload=target_mapping, key="defer_sources_to"),
             defer_clone_from=_optional_str(payload=target_mapping, key="defer_clone_from"),
             reuse_from=_optional_str(payload=target_mapping, key="reuse_from"),
@@ -528,6 +529,7 @@ def _load_local_targets(*, payload: object, file_path: Path) -> dict[str, LocalT
             vars=_load_string_mapping(payload=target_mapping.get("vars"), file_path=file_path),
             database=_optional_str(payload=target_mapping, key="database"),
             schema=_optional_str(payload=target_mapping, key="schema"),
+            loader_schema=_optional_str(payload=target_mapping, key="loader_schema"),
             defer_sources_to=_optional_str(payload=target_mapping, key="defer_sources_to"),
             defer_clone_from=_optional_str(payload=target_mapping, key="defer_clone_from"),
             reuse_from=_optional_str(payload=target_mapping, key="reuse_from"),