fastws-cli 0.0.18__tar.gz → 0.0.20__tar.gz

{fastws_cli-0.0.18 → fastws_cli-0.0.20}/PKG-INFO

@@ -1,16 +1,16 @@
 Metadata-Version: 2.4
 Name: fastws-cli
-Version: 0.0.18
+Version: 0.0.20
 Summary: Fast workspace tools for multi-repo management
 Author: Jeremy Howard
-License: Apache-2.0
+License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/AnswerDotAI/fastws
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: fastcore>=2.2.28
+Requires-Dist: fastcore>=2.2.33
 Requires-Dist: fastgit>=0.1.2
 Requires-Dist: ghapi>=2.0.6
 Requires-Dist: packaging
@@ -195,6 +195,34 @@ ws-build --project solveit  # only this package and its transitive workspace dep
 
 `--project` selects by package name and follows declared runtime and build dependencies, including workspace packages in external checkouts. Other packages in the output directory are left untouched. Without it, the whole workspace is built as before.
 
+### `cargo develop`
+
+Rebuild a mixed Rust/Python project's extension and replace it in the editable source package:
+
+```bash
+cargo develop
+cargo develop --path /path/to/project
+```
+
+Run from the project root, or give its directory with `--path`. The command reads `python-source`, `module-name`, `manifest-path` and features from `[tool.maturin]`. It always builds with Cargo's `test` profile, matching bare `cargo test`. The project must produce a `cdylib` and set `python-source`. To use release settings without command-line flags, add `[profile.test]` with `inherits = "release"` to `Cargo.toml`. Keep incremental compilation enabled for the local crate in that profile.
+
+Make the initial editable installation through `ws-sync` or maturin. Repeat that installation when package metadata or entry points change. Running Python processes keep the extension they loaded.
+
+Cargo must already build a loadable Python extension. For PyO3 extension-module builds on macOS, configure the linker in `build.rs` with `pyo3_build_config::add_extension_module_link_args()`. This command does not inject maturin's extra compiler flags.
+
+To share the library build with `cargo test`, also produce an `rlib` and use the same features for both commands. Rust unit tests compile a separate library with `cfg(test)`; integration tests reuse the ordinary library. `cargo develop` does not change the project's Cargo configuration or its test layout.
+
+Set `native-binaries = true` under `[tool.fastws]` to build and install the package's Cargo binary targets into the active venv alongside its extension. Cargo reports the executable paths; there is no separate list of binary names.
+
+For wheels containing these binaries, use `fastws.build_backend` as the build backend and include `fastws-cli>=0.0.20` alongside maturin in `[build-system].requires`. Set `[tool.maturin].data` to the wheel-data directory. The backend stages Python-free binaries in its `scripts/` subdirectory, then delegates packaging to maturin. Explicit profile and target arguments from maturin's build settings also apply to the binaries.
+
+Direct maturin CLI builds bypass the Python build backend. Stage the binaries first with the shared command:
+
+```bash
+cargo stage --profile dist
+maturin build --profile dist
+```
+
 ### `ws-sync`
 
 Syncing proceeds in this order:
@@ -208,7 +236,7 @@ By default, `ws-sync` uses the active venv's parent as the workspace root. It cr
 
 Project scanning respects `tool.uv.workspace.members` and `exclude`. If a member directory lacks `pyproject.toml`, such as a fresh empty clone, sync warns and skips the `uv sync` step.
 
-Fastws maintains `tool.uv.workspace.exclude`. It excludes unlisted top-level directories without a valid Python project. It also excludes listed Rust or JavaScript projects without `pyproject.toml`. For a listed checkout with none of `pyproject.toml`, `Cargo.toml`, or `package.json`, sync warns and skips installation.
+Fastws maintains `tool.uv.workspace.exclude`. It excludes unlisted top-level directories without a valid Python project. It also excludes listed Rust or JavaScript projects without `pyproject.toml`. It also excludes listed project templates, whose `[project].name` still holds a `{placeholder}`, because uv cannot parse that name. For a listed checkout with none of `pyproject.toml`, `Cargo.toml`, or `package.json`, sync warns and skips installation.
 
 Existing globs, entries for missing directories, and entries for checkouts that are still not Python projects are retained. Use `exclude = [...]` under `[tool.fastws]` to specify exclusions the scan cannot infer, such as keeping a valid project out of the workspace. Adding members preserves hand-written `[tool.uv.sources]` entries, including path and Git sources.
 
@@ -224,7 +252,9 @@ Each sync updates `workspaces` in the root `package.json`. It creates the file w
 
 An optional tracked `package.json.shared` is merged into the root `package.json` on every sync. Object-valued fields merge one level deep, shared values win conflicts, and arrays replace rather than concatenate. Unrelated local settings remain; removing a shared key does not delete its local value. Workspace discovery still manages `workspaces`. Use this file for shared policy such as version-pinned npm `allowScripts` approvals.
 
-After `uv sync`, fastws runs `<tool> install` at the workspace root. It then runs `<tool> run build` in each JavaScript package containing both `Cargo.toml` and a `build` script. Cargo handles incremental compilation. Other build steps still run.
+After `uv sync`, fastws runs `cargo develop` in each mixed Rust/Python project. Cargo skips unchanged compilation inputs. These projects should keep only packaging inputs in `tool.uv.cache-keys`; Rust source changes are handled by Cargo rather than triggering a separate maturin editable build. Maturin packages with `bindings = "bin"` keep their existing uv installation path.
+
+Fastws then runs `<tool> install` at the workspace root. It runs `<tool> run build` in each JavaScript package containing both `Cargo.toml` and a `build` script. Cargo handles incremental compilation. Other build steps still run.
 
 For npm, sync hides routine install summaries and build-command banners. Install warnings, audit findings, unreviewed install scripts, and failure diagnostics remain visible. Build scripts retain their own output; configure their tools to suppress routine progress. Other package managers retain their normal output.
 
@@ -311,4 +341,4 @@ await check_release('mdhtml')     # one repo: list of unreleased commit summarie
 
 ## Tests
 
-Run `pytest -q` for the regular suite. `pytest -q tests/test_setup.py -m slow` also builds the current package and bootstraps a fresh environment with real Git and uv; it may fetch package dependencies. Run `chkstyle fastws tests` after edits.
+Run `pytest -q`. Keep tests concise and focused on substantive logic. Do not test policy choices, settings, constants, or orchestration. Do not add tests merely because code changed.

{fastws_cli-0.0.18 → fastws_cli-0.0.20}/README.md

@@ -170,6 +170,34 @@ ws-build --project solveit  # only this package and its transitive workspace dep
 
 `--project` selects by package name and follows declared runtime and build dependencies, including workspace packages in external checkouts. Other packages in the output directory are left untouched. Without it, the whole workspace is built as before.
 
+### `cargo develop`
+
+Rebuild a mixed Rust/Python project's extension and replace it in the editable source package:
+
+```bash
+cargo develop
+cargo develop --path /path/to/project
+```
+
+Run from the project root, or give its directory with `--path`. The command reads `python-source`, `module-name`, `manifest-path` and features from `[tool.maturin]`. It always builds with Cargo's `test` profile, matching bare `cargo test`. The project must produce a `cdylib` and set `python-source`. To use release settings without command-line flags, add `[profile.test]` with `inherits = "release"` to `Cargo.toml`. Keep incremental compilation enabled for the local crate in that profile.
+
+Make the initial editable installation through `ws-sync` or maturin. Repeat that installation when package metadata or entry points change. Running Python processes keep the extension they loaded.
+
+Cargo must already build a loadable Python extension. For PyO3 extension-module builds on macOS, configure the linker in `build.rs` with `pyo3_build_config::add_extension_module_link_args()`. This command does not inject maturin's extra compiler flags.
+
+To share the library build with `cargo test`, also produce an `rlib` and use the same features for both commands. Rust unit tests compile a separate library with `cfg(test)`; integration tests reuse the ordinary library. `cargo develop` does not change the project's Cargo configuration or its test layout.
+
+Set `native-binaries = true` under `[tool.fastws]` to build and install the package's Cargo binary targets into the active venv alongside its extension. Cargo reports the executable paths; there is no separate list of binary names.
+
+For wheels containing these binaries, use `fastws.build_backend` as the build backend and include `fastws-cli>=0.0.20` alongside maturin in `[build-system].requires`. Set `[tool.maturin].data` to the wheel-data directory. The backend stages Python-free binaries in its `scripts/` subdirectory, then delegates packaging to maturin. Explicit profile and target arguments from maturin's build settings also apply to the binaries.
+
+Direct maturin CLI builds bypass the Python build backend. Stage the binaries first with the shared command:
+
+```bash
+cargo stage --profile dist
+maturin build --profile dist
+```
+
 ### `ws-sync`
 
 Syncing proceeds in this order:
@@ -183,7 +211,7 @@ By default, `ws-sync` uses the active venv's parent as the workspace root. It cr
 
 Project scanning respects `tool.uv.workspace.members` and `exclude`. If a member directory lacks `pyproject.toml`, such as a fresh empty clone, sync warns and skips the `uv sync` step.
 
-Fastws maintains `tool.uv.workspace.exclude`. It excludes unlisted top-level directories without a valid Python project. It also excludes listed Rust or JavaScript projects without `pyproject.toml`. For a listed checkout with none of `pyproject.toml`, `Cargo.toml`, or `package.json`, sync warns and skips installation.
+Fastws maintains `tool.uv.workspace.exclude`. It excludes unlisted top-level directories without a valid Python project. It also excludes listed Rust or JavaScript projects without `pyproject.toml`. It also excludes listed project templates, whose `[project].name` still holds a `{placeholder}`, because uv cannot parse that name. For a listed checkout with none of `pyproject.toml`, `Cargo.toml`, or `package.json`, sync warns and skips installation.
 
 Existing globs, entries for missing directories, and entries for checkouts that are still not Python projects are retained. Use `exclude = [...]` under `[tool.fastws]` to specify exclusions the scan cannot infer, such as keeping a valid project out of the workspace. Adding members preserves hand-written `[tool.uv.sources]` entries, including path and Git sources.
 
@@ -199,7 +227,9 @@ Each sync updates `workspaces` in the root `package.json`. It creates the file w
 
 An optional tracked `package.json.shared` is merged into the root `package.json` on every sync. Object-valued fields merge one level deep, shared values win conflicts, and arrays replace rather than concatenate. Unrelated local settings remain; removing a shared key does not delete its local value. Workspace discovery still manages `workspaces`. Use this file for shared policy such as version-pinned npm `allowScripts` approvals.
 
-After `uv sync`, fastws runs `<tool> install` at the workspace root. It then runs `<tool> run build` in each JavaScript package containing both `Cargo.toml` and a `build` script. Cargo handles incremental compilation. Other build steps still run.
+After `uv sync`, fastws runs `cargo develop` in each mixed Rust/Python project. Cargo skips unchanged compilation inputs. These projects should keep only packaging inputs in `tool.uv.cache-keys`; Rust source changes are handled by Cargo rather than triggering a separate maturin editable build. Maturin packages with `bindings = "bin"` keep their existing uv installation path.
+
+Fastws then runs `<tool> install` at the workspace root. It runs `<tool> run build` in each JavaScript package containing both `Cargo.toml` and a `build` script. Cargo handles incremental compilation. Other build steps still run.
 
 For npm, sync hides routine install summaries and build-command banners. Install warnings, audit findings, unreviewed install scripts, and failure diagnostics remain visible. Build scripts retain their own output; configure their tools to suppress routine progress. Other package managers retain their normal output.
 
@@ -286,4 +316,4 @@ await check_release('mdhtml')     # one repo: list of unreleased commit summarie
 
 ## Tests
 
-Run `pytest -q` for the regular suite. `pytest -q tests/test_setup.py -m slow` also builds the current package and bootstraps a fresh environment with real Git and uv; it may fetch package dependencies. Run `chkstyle fastws tests` after edits.
+Run `pytest -q`. Keep tests concise and focused on substantive logic. Do not test policy choices, settings, constants, or orchestration. Do not add tests merely because code changed.

{fastws_cli-0.0.18 → fastws_cli-0.0.20}/fastws/__init__.py

@@ -1,4 +1,6 @@
-__version__ = "0.0.18"
+__version__ = "0.0.20"
+
+
 
 
 

fastws_cli-0.0.20/fastws/build_backend.py

@@ -0,0 +1,38 @@
+r"Maturin build backend that includes Cargo binaries in Python wheels."
+import argparse
+from pathlib import Path
+import maturin
+from .cargo import settings, stage_binaries
+
+
+def _stage(config_settings):
+    parser = argparse.ArgumentParser(add_help=False)
+    parser.add_argument('--profile')
+    parser.add_argument('--release', action='store_true')
+    parser.add_argument('--target')
+    args, _ = parser.parse_known_args(maturin.get_maturin_pep517_args(config_settings))
+    root = Path.cwd()
+    profile = args.profile or ('release' if args.release else settings(root)['maturin'].get('profile', 'release'))
+    stage_binaries(root, profile, args.target)
+
+
+def build_wheel(wheel_directory, config_settings=None, metadata_directory=None):
+    _stage(config_settings)
+    return maturin.build_wheel(wheel_directory, config_settings, metadata_directory)
+
+
+def build_editable(wheel_directory, config_settings=None, metadata_directory=None):
+    _stage(config_settings)
+    return maturin.build_editable(wheel_directory, config_settings, metadata_directory)
+
+
+def prepare_metadata_for_build_wheel(metadata_directory, config_settings=None):
+    (Path.cwd()/settings(Path.cwd())['maturin']['data']).mkdir(parents=True, exist_ok=True)
+    return maturin.prepare_metadata_for_build_wheel(metadata_directory, config_settings)
+
+
+prepare_metadata_for_build_editable = prepare_metadata_for_build_wheel
+build_sdist = maturin.build_sdist
+get_requires_for_build_wheel = maturin.get_requires_for_build_wheel
+get_requires_for_build_editable = maturin.get_requires_for_build_editable
+get_requires_for_build_sdist = maturin.get_requires_for_build_sdist

fastws_cli-0.0.20/fastws/cargo.py

@@ -0,0 +1,67 @@
+r"Build and install Cargo artifacts for mixed Rust/Python projects."
+import json, os, shutil, subprocess, sys, sysconfig
+from pathlib import Path
+
+try: import tomllib
+except ModuleNotFoundError: import tomli as tomllib
+
+
+def settings(root):
+    "Read the project's tool configuration."
+    return tomllib.loads((root/'pyproject.toml').read_text()).get('tool', {})
+
+
+def build(root, *, library=True, binaries=False, profile=None, target=None, no_default_features=False):
+    "Build with Cargo and return this package's compiler artifacts."
+    cfg = settings(root)['maturin']
+    manifest = (root/'Cargo.toml').resolve()
+    binding = (root/cfg.get('manifest-path', 'Cargo.toml')).resolve()
+    cmd = ['cargo', 'build', '--manifest-path', str(manifest), '--message-format=json-render-diagnostics']
+    if library: cmd.append('--lib')
+    if binaries: cmd.append('--bins')
+    if profile := profile or cfg.get('profile'): cmd += ['--profile', profile]
+    if target: cmd += ['--target', target]
+    if no_default_features: cmd.append('--no-default-features')
+    else:
+        if features := cfg.get('features'): cmd += ['--features', ','.join(features)]
+        for flag in ('all-features', 'no-default-features'):
+            if cfg.get(flag): cmd.append('--' + flag)
+    out = subprocess.run(cmd, cwd=root, stdout=subprocess.PIPE, text=True, check=True).stdout
+    messages = [json.loads(line) for line in out.splitlines()]
+    return [m for m in messages if m.get('reason') == 'compiler-artifact' and Path(m['manifest_path']) in (manifest, binding)]
+
+
+def replace(source, destination):
+    "Replace an installed artifact without changing the file held by running processes."
+    destination.parent.mkdir(parents=True, exist_ok=True)
+    tmp = destination.with_name(destination.name + '.tmp')
+    shutil.copy2(source, tmp)
+    os.replace(tmp, destination)
+    return destination
+
+
+def develop(root):
+    "Install a Python extension and opted-in binaries from one Cargo build."
+    tool = settings(root)
+    cfg = tool['maturin']
+    if 'python-source' not in cfg: raise SystemExit(r'cargo develop requires tool.maturin.python-source')
+    binaries = tool.get('fastws', {}).get('native-binaries', False)
+    artifacts = build(root, binaries=binaries, profile='test')
+    artifact, = [m for m in artifacts if 'cdylib' in m['target']['crate_types']]
+    lib, = [f for f in artifact['filenames'] if Path(f).suffix in ('.dylib', '.so', '.dll')]
+    module = cfg.get('module-name', artifact['target']['name'])
+    dest = root/cfg['python-source']/Path(*module.split('.'))
+    paths = [replace(lib, dest.with_name(dest.name + sysconfig.get_config_var('EXT_SUFFIX')))]
+    if binaries:
+        env = Path(os.environ.get('VIRTUAL_ENV', sys.prefix))
+        scripts = env/('Scripts' if os.name == 'nt' else 'bin')
+        paths += [replace(m['executable'], scripts/Path(m['executable']).name) for m in artifacts if m.get('executable')]
+    return paths
+
+
+def stage_binaries(root, profile=None, target=None):
+    "Stage Python-free Cargo binaries in maturin's wheel-data directory."
+    cfg = settings(root)['maturin']
+    dest = root/cfg['data']/'scripts'
+    artifacts = build(root, library=False, binaries=True, profile=profile, target=target, no_default_features=True)
+    return [replace(m['executable'], dest/Path(m['executable']).name) for m in artifacts if m.get('executable')]

{fastws_cli-0.0.18 → fastws_cli-0.0.20}/fastws/core.py

@@ -1,6 +1,6 @@
 "Fast workspace tools for multi-repo management."
 
-__all__ = ["ws_setup", "ws_clone", "ws_pull", "ws_status", "ws_branches", "ws_build", "ws_sync", "ws_add", "ws_remove"]
+__all__ = ["ws_setup", "ws_clone", "ws_pull", "ws_status", "ws_branches", "ws_build", "ws_sync", "ws_add", "ws_remove", "cargo_develop", "cargo_stage"]
 
 import ast, fnmatch, glob, hashlib, json, os, re, shlex, shutil, subprocess, sys, time
 from pathlib import Path
@@ -176,13 +176,21 @@ def _remove_from_pyproject(pyproject_path: Path, names: list[str]) -> list[str]:
     pyproject_path.write_text(content)
     return removed
 
-def _read_pyproject_name(path: Path) -> str|None:
+def _pyproject_name(path: Path) -> str|None:
+    "`[project].name` as written, with any `{placeholder}` slots left in"
     try: data = tomllib.loads(path.read_text())
     except tomllib.TOMLDecodeError:
         print(f"Skipping invalid TOML: {path}")
         return None
     name = data.get("project", {}).get("name")
-    return name if isinstance(name, str) and name and "{" not in name and "}" not in name else None
+    return name if isinstance(name, str) and name else None
+
+def _is_placeholder(name: str|None) -> bool: return bool(name) and ("{" in name or "}" in name)
+
+def _read_pyproject_name(path: Path) -> str|None:
+    "`[project].name`, or None when it is missing or still a template placeholder"
+    name = _pyproject_name(path)
+    return None if _is_placeholder(name) else name
 
 def _ws_projects(root: Path) -> list[str]:
     return [name for d in (o for o in _ws_dirs(root) if (o/"pyproject.toml").exists())
@@ -208,6 +216,10 @@ def _non_python_project(d: Path) -> bool:
     "A Rust or JS project without a Python layer is not a pending Python scaffold."
     return not (d/"pyproject.toml").exists() and any((d/f).exists() for f in ("Cargo.toml", "package.json"))
 
+def _template_dir(d: Path) -> bool:
+    "A project template. Its `[project].name` still holds `{placeholder}` slots, so uv cannot parse it."
+    return (d/"pyproject.toml").exists() and _is_placeholder(_pyproject_name(d/"pyproject.toml"))
+
 def _pending_dirs(root: Path) -> list[str]:
     "uv workspace dirs that are not Python projects yet; sync stops rather than let uv fail on them"
     return [d.name for d in _ws_dirs(root) if not (d/"pyproject.toml").exists()]
@@ -218,7 +230,7 @@ def _sync_ws_excludes(pyproject_path: Path, root: Path, tracked: set[str]) -> tu
     Kept as-is: `[tool.fastws].exclude` entries (intent), globs, missing dirs, and tracked dirs
     (repos.txt checkouts) that are still not valid Python projects. Auto-managed: entries for other
     existing dirs are regenerated each sync, excluding dirs without a valid pyproject (tracked dirs
-    only when they are Cargo-only crates or npm-only packages, since a tracked dir with none of those files is a pending member
+    only when they are Cargo-only crates, npm-only packages, or templates with a `{placeholder}` name, since a tracked dir with none of those files is a pending member
     awaiting scaffolding) and un-excluding dirs that gained one; deliberately excluding a real
     project takes a `[tool.fastws]` entry."""
     if not pyproject_path.exists(): return [], []
@@ -231,7 +243,7 @@ def _sync_ws_excludes(pyproject_path: Path, root: Path, tracked: set[str]) -> tu
     kept = [e for e in cur if e in intent or any(c in e for c in "*?[") or not (root/e).is_dir() or (e in tracked and not _valid_project_dir(root/e))]
     kept += [e for e in intent if e not in kept]
     auto = [d.name for d in _project_dirs(root, exclude=kept) if not d.name.startswith(".") and any(_matches_ws(d.name, m) for m in members)
-        and (d.name not in tracked or _non_python_project(d)) and not _valid_project_dir(d)]
+        and (d.name not in tracked or _non_python_project(d) or _template_dir(d)) and not _valid_project_dir(d)]
     survivors = set(kept) | set(auto)
     new = [e for e in cur if e in survivors] + [e for e in kept + auto if e not in cur]
     if new == cur: return [], []
@@ -545,6 +557,26 @@ def _build_projects(root: Path, repos_file: str, project: str = None) -> list[tu
     dirs = dep_closure(key, graph)
     return [(n,d) for n,d in res if d in dirs]
 
+@call_parse(pos=['command'])
+def cargo_develop(
+    command: str = 'develop', # Subcommand name supplied by Cargo
+    path: str = '.', # Rust/Python project directory
+):
+    r"Build and install a mixed Rust/Python project's extension and opted-in binaries."
+    from .cargo import develop
+    for dest in develop(Path(path).resolve()): print(f'Installed {dest}')
+
+@call_parse(pos=['command'])
+def cargo_stage(
+    command: str = 'stage', # Subcommand name supplied by Cargo
+    path: str = '.', # Rust/Python project directory
+    profile: str = '', # Cargo profile; defaults to the maturin profile or dev
+    target: str = '', # Cargo target triple
+):
+    r"Stage Python-free native binaries for maturin wheel builds."
+    from .cargo import stage_binaries
+    for dest in stage_binaries(Path(path).resolve(), profile or None, target or None): print(f'Staged {dest}')
+
 @call_parse
 def ws_build(
     workspace: str = "",  # Workspace root; defaults to active venv parent when available
@@ -911,6 +943,9 @@ async def ws_sync(
     if up: _cargo_update(root, workers=workers)
     _sync_cargo_keys(root)
     subprocess.run(["uv", "sync", "-U"] if up else ["uv", "sync"], check=True, cwd=root)
+    for _,d in _build_projects(root, repos_file):
+        cfg = tomllib.loads((d/'pyproject.toml').read_text()).get('tool', {}).get('maturin', {})
+        if 'python-source' in cfg and cfg.get('bindings') != 'bin': cargo_develop(path=str(d))
     if up: _upgrade_stamp(root).touch()
     if js_members: _sync_js(root, js_members)
 

{fastws_cli-0.0.18 → fastws_cli-0.0.20}/fastws_cli.egg-info/PKG-INFO

@@ -1,16 +1,16 @@
 Metadata-Version: 2.4
 Name: fastws-cli
-Version: 0.0.18
+Version: 0.0.20
 Summary: Fast workspace tools for multi-repo management
 Author: Jeremy Howard
-License: Apache-2.0
+License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/AnswerDotAI/fastws
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: fastcore>=2.2.28
+Requires-Dist: fastcore>=2.2.33
 Requires-Dist: fastgit>=0.1.2
 Requires-Dist: ghapi>=2.0.6
 Requires-Dist: packaging
@@ -195,6 +195,34 @@ ws-build --project solveit  # only this package and its transitive workspace dep
 
 `--project` selects by package name and follows declared runtime and build dependencies, including workspace packages in external checkouts. Other packages in the output directory are left untouched. Without it, the whole workspace is built as before.
 
+### `cargo develop`
+
+Rebuild a mixed Rust/Python project's extension and replace it in the editable source package:
+
+```bash
+cargo develop
+cargo develop --path /path/to/project
+```
+
+Run from the project root, or give its directory with `--path`. The command reads `python-source`, `module-name`, `manifest-path` and features from `[tool.maturin]`. It always builds with Cargo's `test` profile, matching bare `cargo test`. The project must produce a `cdylib` and set `python-source`. To use release settings without command-line flags, add `[profile.test]` with `inherits = "release"` to `Cargo.toml`. Keep incremental compilation enabled for the local crate in that profile.
+
+Make the initial editable installation through `ws-sync` or maturin. Repeat that installation when package metadata or entry points change. Running Python processes keep the extension they loaded.
+
+Cargo must already build a loadable Python extension. For PyO3 extension-module builds on macOS, configure the linker in `build.rs` with `pyo3_build_config::add_extension_module_link_args()`. This command does not inject maturin's extra compiler flags.
+
+To share the library build with `cargo test`, also produce an `rlib` and use the same features for both commands. Rust unit tests compile a separate library with `cfg(test)`; integration tests reuse the ordinary library. `cargo develop` does not change the project's Cargo configuration or its test layout.
+
+Set `native-binaries = true` under `[tool.fastws]` to build and install the package's Cargo binary targets into the active venv alongside its extension. Cargo reports the executable paths; there is no separate list of binary names.
+
+For wheels containing these binaries, use `fastws.build_backend` as the build backend and include `fastws-cli>=0.0.20` alongside maturin in `[build-system].requires`. Set `[tool.maturin].data` to the wheel-data directory. The backend stages Python-free binaries in its `scripts/` subdirectory, then delegates packaging to maturin. Explicit profile and target arguments from maturin's build settings also apply to the binaries.
+
+Direct maturin CLI builds bypass the Python build backend. Stage the binaries first with the shared command:
+
+```bash
+cargo stage --profile dist
+maturin build --profile dist
+```
+
 ### `ws-sync`
 
 Syncing proceeds in this order:
@@ -208,7 +236,7 @@ By default, `ws-sync` uses the active venv's parent as the workspace root. It cr
 
 Project scanning respects `tool.uv.workspace.members` and `exclude`. If a member directory lacks `pyproject.toml`, such as a fresh empty clone, sync warns and skips the `uv sync` step.
 
-Fastws maintains `tool.uv.workspace.exclude`. It excludes unlisted top-level directories without a valid Python project. It also excludes listed Rust or JavaScript projects without `pyproject.toml`. For a listed checkout with none of `pyproject.toml`, `Cargo.toml`, or `package.json`, sync warns and skips installation.
+Fastws maintains `tool.uv.workspace.exclude`. It excludes unlisted top-level directories without a valid Python project. It also excludes listed Rust or JavaScript projects without `pyproject.toml`. It also excludes listed project templates, whose `[project].name` still holds a `{placeholder}`, because uv cannot parse that name. For a listed checkout with none of `pyproject.toml`, `Cargo.toml`, or `package.json`, sync warns and skips installation.
 
 Existing globs, entries for missing directories, and entries for checkouts that are still not Python projects are retained. Use `exclude = [...]` under `[tool.fastws]` to specify exclusions the scan cannot infer, such as keeping a valid project out of the workspace. Adding members preserves hand-written `[tool.uv.sources]` entries, including path and Git sources.
 
@@ -224,7 +252,9 @@ Each sync updates `workspaces` in the root `package.json`. It creates the file w
 
 An optional tracked `package.json.shared` is merged into the root `package.json` on every sync. Object-valued fields merge one level deep, shared values win conflicts, and arrays replace rather than concatenate. Unrelated local settings remain; removing a shared key does not delete its local value. Workspace discovery still manages `workspaces`. Use this file for shared policy such as version-pinned npm `allowScripts` approvals.
 
-After `uv sync`, fastws runs `<tool> install` at the workspace root. It then runs `<tool> run build` in each JavaScript package containing both `Cargo.toml` and a `build` script. Cargo handles incremental compilation. Other build steps still run.
+After `uv sync`, fastws runs `cargo develop` in each mixed Rust/Python project. Cargo skips unchanged compilation inputs. These projects should keep only packaging inputs in `tool.uv.cache-keys`; Rust source changes are handled by Cargo rather than triggering a separate maturin editable build. Maturin packages with `bindings = "bin"` keep their existing uv installation path.
+
+Fastws then runs `<tool> install` at the workspace root. It runs `<tool> run build` in each JavaScript package containing both `Cargo.toml` and a `build` script. Cargo handles incremental compilation. Other build steps still run.
 
 For npm, sync hides routine install summaries and build-command banners. Install warnings, audit findings, unreviewed install scripts, and failure diagnostics remain visible. Build scripts retain their own output; configure their tools to suppress routine progress. Other package managers retain their normal output.
 
@@ -311,4 +341,4 @@ await check_release('mdhtml')     # one repo: list of unreleased commit summarie
 
 ## Tests
 
-Run `pytest -q` for the regular suite. `pytest -q tests/test_setup.py -m slow` also builds the current package and bootstraps a fresh environment with real Git and uv; it may fetch package dependencies. Run `chkstyle fastws tests` after edits.
+Run `pytest -q`. Keep tests concise and focused on substantive logic. Do not test policy choices, settings, constants, or orchestration. Do not add tests merely because code changed.

{fastws_cli-0.0.18 → fastws_cli-0.0.20}/fastws_cli.egg-info/SOURCES.txt

@@ -2,6 +2,8 @@ LICENSE
 README.md
 pyproject.toml
 fastws/__init__.py
+fastws/build_backend.py
+fastws/cargo.py
 fastws/core.py
 fastws/releases.py
 fastws_cli.egg-info/PKG-INFO

{fastws_cli-0.0.18 → fastws_cli-0.0.20}/fastws_cli.egg-info/entry_points.txt

@@ -1,4 +1,6 @@
 [console_scripts]
+cargo-develop = fastws.core:cargo_develop
+cargo-stage = fastws.core:cargo_stage
 ws-add = fastws.core:ws_add
 ws-branches = fastws.core:ws_branches
 ws-build = fastws.core:ws_build

{fastws_cli-0.0.18 → fastws_cli-0.0.20}/fastws_cli.egg-info/requires.txt

@@ -1,4 +1,4 @@
-fastcore>=2.2.28
+fastcore>=2.2.33
 fastgit>=0.1.2
 ghapi>=2.0.6
 packaging

{fastws_cli-0.0.18 → fastws_cli-0.0.20}/pyproject.toml

@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools>=68", "wheel"]
+requires = ["setuptools>=77"]
 build-backend = "setuptools.build_meta"
 
 [project]
@@ -8,7 +8,7 @@ dynamic = ["version"]
 description = "Fast workspace tools for multi-repo management"
 readme = "README.md"
 requires-python = ">=3.10"
-license = { text = "Apache-2.0" }
+license = "Apache-2.0"
 authors = [{ name = "Jeremy Howard" }]
 classifiers = [
   "Programming Language :: Python :: 3",
@@ -16,7 +16,7 @@ classifiers = [
 ]
 
 dependencies = [
-  "fastcore>=2.2.28",
+  "fastcore>=2.2.33",
   "fastgit>=0.1.2",
   "ghapi>=2.0.6",
   "packaging",
@@ -33,6 +33,8 @@ dev = [
 ]
 
 [project.scripts]
+cargo-develop = "fastws.core:cargo_develop"
+cargo-stage = "fastws.core:cargo_stage"
 ws-setup = "fastws.core:ws_setup"
 ws-clone = "fastws.core:ws_clone"
 ws-pull = "fastws.core:ws_pull"
@@ -47,10 +49,6 @@ ws-releases = "fastws.releases:ws_releases"
 [project.urls]
 Homepage = "https://github.com/AnswerDotAI/fastws"
 
-[tool.pytest.ini_options]
-asyncio_mode = "auto"
-markers = ["slow: builds and installs a fresh workspace; may fetch package dependencies"]
-addopts = "-m 'not slow'"
 
 [tool.setuptools.dynamic]
 version = { attr = "fastws.__version__" }

fastws_cli-0.0.20/tests/test_build.py

@@ -0,0 +1,25 @@
+import pytest
+import fastws.core as core
+
+
+def _mk_proj(root, name, extra=''):
+    d = root/name
+    d.mkdir()
+    (d/'pyproject.toml').write_text(fr'''[project]
+name = "{name}"
+{extra}
+''')
+    return d
+
+
+def test_build_dependency_selection(tmp_path):
+    root = tmp_path/'ws'
+    root.mkdir()
+    _mk_proj(root, 'app', r'''dependencies = ["My.Lib>=1"]''')
+    _mk_proj(root, 'my-lib', r'''[build-system]
+requires = ["external"]''')
+    external = _mk_proj(tmp_path, 'external', r'''dependencies = ["app", "published-only"]''')
+    _mk_proj(root, 'unrelated')
+    (root/'repos-local.txt').write_text(f'owner/external {external}')
+    assert {n for n,d in core._build_projects(root, 'repos.txt', 'APP')} == {'app', 'my-lib', 'external'}
+    with pytest.raises(SystemExit, match='No workspace project'): core._build_projects(root, 'repos.txt', 'missing')

fastws_cli-0.0.20/tests/test_releases.py

@@ -0,0 +1,15 @@
+from fastcore.basics import AttrDict
+
+import fastws.releases as relmod
+
+
+def _rel(tag): return AttrDict(tag_name=tag)
+
+
+def test_newest_tag_by_version_not_publish_order():
+    assert relmod._newest_tag([_rel("v0.1.17"), _rel("v0.1.18"), _rel("v0.1.9")]) == "v0.1.18"
+    assert relmod._newest_tag([]) is None
+
+
+
+

fastws_cli-0.0.20/tests/test_setup.py

@@ -0,0 +1,15 @@
+import pytest
+import fastws.core as core
+
+
+def test_setup_preserves_existing_destinations(tmp_path):
+    marker = tmp_path/'keep.txt'
+    marker.write_text('personal work')
+    with pytest.raises(SystemExit, match='exists'): core.ws_setup('org/base', str(tmp_path))
+    assert marker.read_text() == 'personal work'
+    link = tmp_path/'link'
+    link.symlink_to(tmp_path/'missing')
+    with pytest.raises(SystemExit, match='exists'): core.ws_setup('org/base', str(link))
+    assert link.is_symlink() and not (tmp_path/'missing').exists()
+
+