framework-py 0.1.0.dev8__py3-none-any.whl → 0.1.0.dev9__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
framework/_agents_md.py CHANGED
@@ -117,12 +117,11 @@ def _environment(spec: dict[str, Any]) -> str:
117
117
 
118
118
 
119
119
  def _packages(spec: dict[str, Any]) -> str:
120
- names = list((spec.get("packages") or {}).get("default_packages") or {})
120
+ from framework.create import pyproject_dependencies
121
+
122
+ names = [name for name, _ in pyproject_dependencies(spec)]
121
123
  lines = [f"## Installed Packages {REGENERATE}", ""]
122
- if names:
123
- lines += [f"**Dependencies** (in pyproject.toml): framework-py, {', '.join(names)}", ""]
124
- else:
125
- lines += ["**Dependencies** (in pyproject.toml): framework-py", ""]
124
+ lines += [f"**Dependencies** (in pyproject.toml): {', '.join(names)}", ""]
126
125
  lines.append('Add packages with `fw.package_add("name")`.')
127
126
  return "\n".join(lines)
128
127
 
framework/_yaml.py CHANGED
@@ -7,15 +7,24 @@ match R:
7
7
  - ``y``, ``Y``, ``n``, and ``N`` are booleans, as they are in R.
8
8
  - The ``!expr`` tag is kept as the string ``"!expr <code>"`` for later
9
9
  evaluation.
10
+
11
+ ``update()`` edits a settings file in place with ruamel.yaml, so the comments,
12
+ the layout of sequences, and quoting in the rest of the file are kept.
10
13
  """
11
14
 
12
15
  from __future__ import annotations
13
16
 
17
+ import io
14
18
  import re
19
+ import warnings
20
+ from collections.abc import Callable
15
21
  from pathlib import Path
16
22
  from typing import Any
17
23
 
18
24
  import yaml
25
+ from ruamel.yaml import YAML
26
+ from ruamel.yaml.error import MantissaNoDotYAML1_1Warning
27
+ from ruamel.yaml.representer import RoundTripRepresenter
19
28
 
20
29
  _BOOL_TAG = "tag:yaml.org,2002:bool"
21
30
  _SHORT_BOOLS = {"y": True, "n": False}
@@ -88,3 +97,65 @@ def dump(data: Any) -> str:
88
97
  def write(path: Path, data: Any) -> None:
89
98
  path.parent.mkdir(parents=True, exist_ok=True)
90
99
  path.write_text(dump(data), encoding="utf-8")
100
+
101
+
102
+ # Editing in place ------------------------------------------------------------
103
+
104
+
105
+ class _RoundTripRepresenter(RoundTripRepresenter):
106
+ pass
107
+
108
+
109
+ def _round_trip_str(representer: RoundTripRepresenter, value: str) -> Any:
110
+ # YAML 1.1 output already quotes strings such as "no" and "y". R also reads "."
111
+ # and ".na" as NA, so they are quoted too, as _dump() does.
112
+ if _R_SPECIAL.match(value):
113
+ return representer.represent_scalar("tag:yaml.org,2002:str", value, style="'")
114
+ return representer.represent_str(value)
115
+
116
+
117
+ def _round_trip_none(representer: RoundTripRepresenter, _: None) -> Any:
118
+ return representer.represent_scalar("tag:yaml.org,2002:null", "~")
119
+
120
+
121
+ _RoundTripRepresenter.add_representer(str, _round_trip_str)
122
+ _RoundTripRepresenter.add_representer(type(None), _round_trip_none)
123
+ _DIRECTIVE = "%YAML 1.1\n---\n"
124
+
125
+
126
+ def _round_trip() -> YAML:
127
+ handler = YAML()
128
+ handler.Representer = _RoundTripRepresenter
129
+ # YAML 1.1, as R and PyYAML read it: yes/no and y/n are booleans, 012 is octal,
130
+ # and a new string that would read as something else is quoted
131
+ handler.version = (1, 1)
132
+ handler.preserve_quotes = True
133
+ handler.width = 1_000_000
134
+ handler.indent(mapping=2, sequence=2, offset=0)
135
+ return handler
136
+
137
+
138
+ def update(path: Path, change: Callable[[Any], Any]) -> None:
139
+ """Edit a YAML file in place, keeping its comments and layout.
140
+
141
+ ``change`` receives the file's content (mappings and sequences that behave like dicts
142
+ and lists, or None for an empty or missing file), changes it in place or returns a new
143
+ value, and the result is written back. Values read from the file keep their form,
144
+ except that YAML 1.1 booleans such as ``yes`` are written ``true`` and ``false``. New
145
+ sequences are block sequences, and new booleans are ``true`` and ``false``.
146
+ """
147
+ text = path.read_text(encoding="utf-8") if path.is_file() else ""
148
+ handler = _round_trip()
149
+ with warnings.catch_warnings():
150
+ # "1e3" is a string to PyYAML and a float to ruamel; either way it is written
151
+ # back as it was
152
+ warnings.simplefilter("ignore", MantissaNoDotYAML1_1Warning)
153
+ data = handler.load(text) if text.strip() else None
154
+ result = change(data)
155
+ data = data if result is None else result
156
+ out = io.StringIO()
157
+ handler.dump(data, out)
158
+ # The version directive is only for ruamel: R and PyYAML read YAML 1.1 anyway
159
+ written = out.getvalue().removeprefix(_DIRECTIVE)
160
+ path.parent.mkdir(parents=True, exist_ok=True)
161
+ path.write_text(written, encoding="utf-8")
framework/create.py CHANGED
@@ -294,9 +294,16 @@ def _package_key(name: str) -> str:
294
294
  return re.sub(r"[-_.]+", "-", name).lower()
295
295
 
296
296
 
297
- def _pyproject(spec: Mapping[str, Any]) -> str:
297
+ def pyproject_dependencies(spec: Mapping[str, Any]) -> list[tuple[str, str]]:
298
+ """The dependencies a new project's pyproject.toml lists, as (name, requirement) pairs.
299
+
300
+ AGENTS.md lists the same names, so both come from here.
301
+ """
298
302
  packages = (spec.get("packages") or {}).get("default_packages") or {}
299
- dependencies = ["framework-py", *(_dependency(n, e) for n, e in packages.items())]
303
+ dependencies = [
304
+ ("framework-py", "framework-py"),
305
+ *((name, _dependency(name, entry or {})) for name, entry in packages.items()),
306
+ ]
300
307
  # A project renders and edits with its workflow's tools out of the box. The spec's
301
308
  # packages win when they name one of these, with a version for example.
302
309
  tools = [
@@ -304,7 +311,14 @@ def _pyproject(spec: Mapping[str, Any]) -> str:
304
311
  *(_JUPYTER_PACKAGES if spec_tool_on(spec, "jupyter") else ()),
305
312
  ]
306
313
  named = {_package_key(name) for name in packages}
307
- dependencies += [name for name in dict.fromkeys(tools) if _package_key(name) not in named]
314
+ dependencies += [
315
+ (name, name) for name in dict.fromkeys(tools) if _package_key(name) not in named
316
+ ]
317
+ return dependencies
318
+
319
+
320
+ def _pyproject(spec: Mapping[str, Any]) -> str:
321
+ dependencies = [requirement for _, requirement in pyproject_dependencies(spec)]
308
322
  lines = [
309
323
  "[project]",
310
324
  f'name = "{kebab_case(spec["name"])}"',
@@ -361,9 +375,15 @@ def _git_init(root: Path) -> None:
361
375
  ["git", "-C", str(root), *args], capture_output=True, text=True, check=False
362
376
  )
363
377
 
378
+ from framework.hooks import git_hooks_install, outer_repository
379
+
380
+ top = outer_repository(root)
381
+ if top is not None:
382
+ # git init would hide the project from the repository it sits in
383
+ inform(f" Project is tracked by the enclosing git repository at {top}")
384
+ return
364
385
  git("init")
365
386
  inform(" Initialized git repository")
366
- from framework.hooks import git_hooks_install
367
387
 
368
388
  if git_hooks_install(root / "settings.yml", verbose=False):
369
389
  inform(" Installed git hooks")
@@ -1032,12 +1052,20 @@ def project_add_directory(project_path: str | Path, key: str, label: str, path:
1032
1052
  folder = root / path
1033
1053
  folder.mkdir(parents=True, exist_ok=True)
1034
1054
 
1035
- raw = _yaml.read(settings_file) or {}
1036
- config = raw["default"] if isinstance(raw.get("default"), dict) else raw
1037
- extra = [e for e in (config.get("extra_directories") or []) if e.get("key") != key]
1038
- extra.append({"key": key, "label": label, "path": path})
1039
- config["extra_directories"] = extra
1040
- _yaml.write(settings_file, raw)
1055
+ def add(raw: Any) -> Any:
1056
+ raw = raw if isinstance(raw, dict) else {}
1057
+ config = raw["default"] if isinstance(raw.get("default"), dict) else raw
1058
+ extra = config.get("extra_directories")
1059
+ if not isinstance(extra, list):
1060
+ extra = config["extra_directories"] = []
1061
+ # Edited in place, so the file keeps its comments
1062
+ for index in reversed(range(len(extra))):
1063
+ if isinstance(extra[index], dict) and extra[index].get("key") == key:
1064
+ del extra[index]
1065
+ extra.append({"key": key, "label": label, "path": path})
1066
+ return raw
1067
+
1068
+ _yaml.update(settings_file, add)
1041
1069
  return folder
1042
1070
 
1043
1071
 
framework/data.py CHANGED
@@ -486,30 +486,23 @@ def _derive_name(file_path: Path, config: dict[str, Any], root: Path) -> str:
486
486
 
487
487
 
488
488
  def _catalog_set(name: str, entry: dict[str, Any]) -> None:
489
- """Write one catalog entry into settings.yml or the split file that holds ``data``."""
489
+ """Write one catalog entry into settings.yml or the split file that holds ``data``.
490
+
491
+ The file is edited in place, so its comments and other entries keep their form.
492
+ """
490
493
  settings_file = find_settings_file()
491
494
  if settings_file is None:
492
495
  raise SettingsError("Configuration file 'settings.yml' (or legacy config.yml) not found")
493
496
  raw = _yaml.read(settings_file) or {}
494
- environment = "default" if isinstance(raw.get("default"), dict) else None
495
- config = raw[environment] if environment else raw
496
- source = config.get("data")
497
-
498
- if isinstance(source, str):
499
- split_path = in_root(source, settings_file.parent)
500
- content = _yaml.read(split_path) if split_path.is_file() else None
501
- current = content.get("data", content) if isinstance(content, dict) else None
502
- else:
503
- split_path = None
504
- current = source
505
- if not isinstance(current, dict):
506
- current = {}
507
-
508
- # An entry already written with dotted keys is updated where it is.
509
- existing = catalog_locate(name, current)
510
- if existing is not None:
511
- existing[0][existing[1]] = entry
512
- else:
497
+ config = raw["default"] if isinstance(raw.get("default"), dict) else raw
498
+ source = config.get("data") if isinstance(config, dict) else None
499
+
500
+ def set_entry(current: dict[str, Any]) -> None:
501
+ # An entry already written with dotted keys is updated where it is.
502
+ existing = catalog_locate(name, current)
503
+ if existing is not None:
504
+ existing[0][existing[1]] = entry
505
+ return
513
506
  node = current
514
507
  parts = name.split(".")
515
508
  for part in parts[:-1]:
@@ -518,11 +511,33 @@ def _catalog_set(name: str, entry: dict[str, Any]) -> None:
518
511
  node = node[part]
519
512
  node[parts[-1]] = entry
520
513
 
521
- if split_path is not None:
522
- _yaml.write(split_path, {"data": current})
523
- else:
524
- config["data"] = current
525
- _yaml.write(settings_file, raw)
514
+ if isinstance(source, str):
515
+
516
+ def in_split(content: Any) -> Any:
517
+ content = content if isinstance(content, dict) else {}
518
+ if isinstance(content.get("data"), dict):
519
+ set_entry(content["data"])
520
+ return content
521
+ if "data" in content or not content:
522
+ content["data"] = {}
523
+ set_entry(content["data"])
524
+ return content
525
+ # A split file without the data key holds the catalog itself
526
+ set_entry(content)
527
+ return {"data": content}
528
+
529
+ _yaml.update(in_root(source, settings_file.parent), in_split)
530
+ return
531
+
532
+ def in_settings(raw: Any) -> Any:
533
+ raw = raw if isinstance(raw, dict) else {}
534
+ config = raw["default"] if isinstance(raw.get("default"), dict) else raw
535
+ if not isinstance(config.get("data"), dict):
536
+ config["data"] = {}
537
+ set_entry(config["data"])
538
+ return raw
539
+
540
+ _yaml.update(settings_file, in_settings)
526
541
 
527
542
 
528
543
  def data_add(
framework/hooks.py CHANGED
@@ -27,6 +27,7 @@ import subprocess
27
27
  import sys
28
28
  from importlib.resources import files
29
29
  from pathlib import Path
30
+ from typing import Any
30
31
 
31
32
  import pandas as pd
32
33
 
@@ -80,27 +81,39 @@ def _hook_settings(path: Path) -> dict[str, bool]:
80
81
 
81
82
 
82
83
  def _set_hook_setting(path: Path, name: str, value: bool) -> None:
83
- """Set ``git: hooks: <name>`` in the settings file, or in its split git file."""
84
+ """Set ``git: hooks: <name>`` in the settings file, or in its split git file.
85
+
86
+ The file is edited in place, so its comments are kept.
87
+ """
84
88
  raw = _yaml.read(path) or {}
85
- env = raw.setdefault("default", {}) if _has_environment_sections(raw) else raw
86
- if env is None:
87
- env = raw["default"] = {}
88
- reference = env.get("git")
89
+ env = raw.get("default") if _has_environment_sections(raw) else raw
90
+ reference = env.get("git") if isinstance(env, dict) else None
89
91
  if isinstance(reference, str) and reference.startswith("settings/"):
90
- split_path = path.parent / reference
91
- split = (_yaml.read(split_path) if split_path.is_file() else None) or {}
92
- git = split.setdefault("git", {}) if "git" in split or not split else split
93
- git.setdefault("hooks", {})[name] = value
94
- _yaml.write(split_path, split)
92
+
93
+ def set_in_split(split: Any) -> Any:
94
+ split = split if isinstance(split, dict) else {}
95
+ git = _mapping(split, "git") if "git" in split or not split else split
96
+ _mapping(git, "hooks")[name] = value
97
+ return split
98
+
99
+ _yaml.update(path.parent / reference, set_in_split)
95
100
  return
96
- git = env.get("git") if isinstance(env.get("git"), dict) else None
97
- if git is None:
98
- git = env["git"] = {}
99
- hooks = git.get("hooks") if isinstance(git.get("hooks"), dict) else None
100
- if hooks is None:
101
- hooks = git["hooks"] = {}
102
- hooks[name] = value
103
- _yaml.write(path, raw)
101
+
102
+ def set_in_settings(raw: Any) -> Any:
103
+ raw = raw if isinstance(raw, dict) else {}
104
+ env = _mapping(raw, "default") if _has_environment_sections(raw) else raw
105
+ _mapping(_mapping(env, "git"), "hooks")[name] = value
106
+ return raw
107
+
108
+ _yaml.update(path, set_in_settings)
109
+
110
+
111
+ def _mapping(parent: dict[str, Any], key: str) -> dict[str, Any]:
112
+ """``parent[key]``, made an empty mapping when it is missing or not a mapping."""
113
+ if not isinstance(parent.get(key), dict):
114
+ parent[key] = {}
115
+ child: dict[str, Any] = parent[key]
116
+ return child
104
117
 
105
118
 
106
119
  def _hook_name(name: str) -> str:
@@ -278,10 +291,14 @@ def git_hooks_enable(
278
291
  Raises:
279
292
  ValueError: When ``hook_name`` is not a known check, including the removed
280
293
  "ai_sync".
281
- FrameworkError: When the settings file is not found.
294
+ FrameworkError: When the settings file is not found, or the project is inside a git
295
+ repository whose top is a folder above it. The settings are left unchanged then.
282
296
  """
283
297
  name = _hook_name(hook_name)
284
298
  path = _settings_path(settings_file)
299
+ top = outer_repository(path.parent)
300
+ if top is not None:
301
+ raise _nested_error(path.parent, top)
285
302
  _set_hook_setting(path, name, True)
286
303
  _say(verbose, f"✓ Enabled {name} hook")
287
304
  return git_hooks_install(path, force=False, verbose=verbose)
framework/notebooks.py CHANGED
@@ -63,18 +63,20 @@ def _project() -> tuple[Path, dict[str, Any]]:
63
63
 
64
64
 
65
65
  def notebook_title(name: str) -> str:
66
- """The default title for a new notebook, as R makes it.
66
+ """The default title for a new notebook, in sentence case, as R makes it.
67
67
 
68
- A name with spaces is already a title and is kept as typed ("My cool analysis"). A
69
- file-style name has its ``-`` and ``_`` turned into spaces and each word capitalized:
70
- "bp-summary" becomes "Bp Summary" and "01_load_data" becomes "01 Load Data".
68
+ A name with spaces or capitals is already a title and is kept as typed ("My cool
69
+ analysis", "BP-summary"). A file-style name has its ``-`` and ``_`` turned into spaces
70
+ and its first character capitalized, with the rest left as typed: "setup-and-settings"
71
+ becomes "Setup and settings" and "01_load_data" becomes "01 load data".
71
72
  """
72
- if re.search(r"\s", name.strip()):
73
- return name.strip()
74
- words = [word for word in re.split(r"[-_\s]+", name) if word]
75
- if not words:
73
+ stripped = name.strip()
74
+ if re.search(r"\s|[A-Z]", stripped):
75
+ return stripped
76
+ title = " ".join(word for word in re.split(r"[-_]+", stripped) if word)
77
+ if not title:
76
78
  return name
77
- return " ".join(word[0].upper() + word[1:] for word in words)
79
+ return title[0].upper() + title[1:]
78
80
 
79
81
 
80
82
  def slugify(text: str) -> str:
framework/outputs.py CHANGED
@@ -263,6 +263,29 @@ def save_report(
263
263
  return destination
264
264
 
265
265
 
266
+ def _render_keeping_source(command: list[str], source: Path) -> subprocess.CompletedProcess[str]:
267
+ """Run ``quarto render`` and put a ``.ipynb`` source back as it was.
268
+
269
+ Quarto writes cell outputs back into a Jupyter notebook it executes (with
270
+ ``--execute``), and saved notebooks must keep the source unchanged, so its bytes and
271
+ times are restored after the render, even when the render fails or is interrupted.
272
+ """
273
+ if source.suffix.lower() != ".ipynb":
274
+ return subprocess.run(command, capture_output=True, text=True, check=False)
275
+ original = source.read_bytes()
276
+ times = source.stat()
277
+ try:
278
+ return subprocess.run(command, capture_output=True, text=True, check=False)
279
+ finally:
280
+ try:
281
+ changed = source.read_bytes() != original
282
+ except OSError:
283
+ changed = True
284
+ if changed:
285
+ source.write_bytes(original)
286
+ os.utime(source, ns=(times.st_atime_ns, times.st_mtime_ns))
287
+
288
+
266
289
  def save_notebook(
267
290
  file: str | Path,
268
291
  name: str | None = None,
@@ -284,7 +307,8 @@ def save_notebook(
284
307
  overwrite: Replace an existing file.
285
308
  embed_resources: For HTML, embed images and styles in one file. False overrides the
286
309
  project's ``_quarto.yml`` and saves the page's ``_files/`` folder beside it.
287
- quarto_args: Extra arguments for ``quarto render``.
310
+ quarto_args: Extra arguments for ``quarto render``. A ``.ipynb`` rendered with
311
+ ``--execute`` is left unchanged: its outputs go into the saved file only.
288
312
  """
289
313
  source = Path(file)
290
314
  if not source.is_file() or source.suffix.lower() not in (".qmd", ".ipynb"):
@@ -308,7 +332,7 @@ def save_notebook(
308
332
  command += ["--embed-resources"] if embed_resources else ["-M", "embed-resources:false"]
309
333
  command.extend(quarto_args)
310
334
  inform(f"Rendering {source.name}...")
311
- result = subprocess.run(command, capture_output=True, text=True, check=False)
335
+ result = _render_keeping_source(command, source)
312
336
  if result.returncode != 0:
313
337
  raise FrameworkError(f"Quarto render failed\n{result.stdout}{result.stderr}")
314
338
  # Inside a Quarto project, the output keeps the file's folder under
@@ -23,8 +23,10 @@ def doc_title(path: str | Path) -> str | None:
23
23
  """The ``title`` in a Quarto document's YAML front matter, or None.
24
24
 
25
25
  A ``.qmd`` or ``.Rmd`` file's front matter opens the file. A Jupyter notebook's sits
26
- in its first cell, a raw cell, as Quarto reads it. Publishing uses the title in place
27
- of the file name, as R does.
26
+ in its first cell, a raw cell, as Quarto reads it. A notebook whose first cell is a
27
+ markdown cell starting with a level-1 heading (``# Title``, as Framework's notebook
28
+ stub has) takes the heading, as Quarto does. Publishing uses the title in place of the
29
+ file name, as R does.
28
30
  """
29
31
  import yaml
30
32
 
@@ -37,10 +39,13 @@ def doc_title(path: str | Path) -> str | None:
37
39
  if suffix == ".ipynb":
38
40
  cells = json.loads(text).get("cells") or []
39
41
  first = cells[0] if cells else {}
40
- if first.get("cell_type") != "raw":
41
- return None
42
42
  body = first.get("source", "")
43
43
  text = "".join(body) if isinstance(body, list) else str(body)
44
+ if first.get("cell_type") == "markdown":
45
+ heading = re.match(r"\A\s*#[ \t]+(.+?)[ \t#]*(?:\r?\n|\Z)", text)
46
+ return heading.group(1).strip() if heading else None
47
+ if first.get("cell_type") != "raw":
48
+ return None
44
49
  except (OSError, UnicodeError, ValueError, AttributeError):
45
50
  return None
46
51
  match = re.match(r"\A\s*---[ \t]*\r?\n(.*?)\r?\n(?:---|\.\.\.)[ \t]*(\r?\n|\Z)", text, re.S)
framework/scaffold.py CHANGED
@@ -190,7 +190,8 @@ def scaffold(settings_file: str | Path | None = None) -> Path:
190
190
  Call it at the top of every notebook and script. It:
191
191
 
192
192
  - finds the project root and loads its ``.env`` and settings,
193
- - creates framework.db if needed and records the scaffold time,
193
+ - creates framework.db if needed and records the scaffold time (a bare project gets
194
+ no framework.db until something needs it, as when it was created),
194
195
  - sets the random seed when ``seed_on_scaffold`` is on (or ``FW_SEED`` is set),
195
196
  - puts the project's ``functions`` folder on the import path, and
196
197
  - runs ``scaffold.py`` from the project root, if there is one.
@@ -220,8 +221,10 @@ def scaffold(settings_file: str | Path | None = None) -> Path:
220
221
  root = path.resolve().parent
221
222
  config = settings_read(path)
222
223
  _load_dotenv(config, root)
223
- db.ensure_db(root)
224
- _mark_scaffolded(root)
224
+ # A bare project has no framework.db until something needs it, as at creation
225
+ if config.get("project_type") != "bare" or db.db_path(root).exists():
226
+ db.ensure_db(root)
227
+ _mark_scaffolded(root)
225
228
  _set_seed(config)
226
229
  _add_function_folders(config, root)
227
230
 
@@ -276,7 +279,9 @@ def status() -> None:
276
279
  if top is not None:
277
280
  lines.append(f" Inside the repository at {top} (counts are for this project)")
278
281
  lines.append(f" Branch: {_git('-C', str(root), 'branch', '--show-current')}")
279
- lines.append(f" Commits: {_git('-C', str(root), 'rev-list', '--count', 'HEAD', *scope)}")
282
+ label = "Commits touching this project" if top is not None else "Commits"
283
+ count = _git("-C", str(root), "rev-list", "--count", "HEAD", *scope)
284
+ lines.append(f" {label}: {count}")
280
285
  changes = (_git("-C", str(root), "status", "--porcelain", "--", ".") or "").splitlines()
281
286
  lines.append(
282
287
  f" Uncommitted changes: {len(changes)}" if changes else " Working tree clean"
framework/settings.py CHANGED
@@ -123,6 +123,20 @@ def modify_list(base: Any, update: Any) -> Any:
123
123
  return result
124
124
 
125
125
 
126
+ def _modify_in_place(base: dict[str, Any], update: Mapping[str, Any]) -> dict[str, Any]:
127
+ """``modify_list()`` that changes ``base`` itself, so a file read for editing keeps
128
+ the comments on the entries it does not replace."""
129
+ for key, value in update.items():
130
+ current = base.get(key)
131
+ if key in base and isinstance(current, dict) and isinstance(value, dict):
132
+ _modify_in_place(current, value)
133
+ elif key in base and _is_r_list(current) and _is_r_list(value):
134
+ base[key] = modify_list(current, value)
135
+ else:
136
+ _r_assign(base, key, value)
137
+ return base
138
+
139
+
126
140
  def merge_env(base: Any, override: Any) -> Any:
127
141
  """Merge an environment section over ``default``, as R's ``.fw_merge_env()`` does.
128
142
 
@@ -498,7 +512,8 @@ def settings_write(
498
512
  (``{"git": {...}}``) or leave it out. Without ``section``, the
499
513
  whole file is replaced, wrapped in a ``default:`` environment.
500
514
 
501
- Comments in a rewritten file are not kept.
515
+ Writing a section keeps the file's comments and the rest of its layout, except in
516
+ the section replaced. Writing the whole file replaces it, comments included.
502
517
 
503
518
  Args:
504
519
  values: The settings to write. Without ``section``, a mapping without a ``default``
@@ -533,24 +548,37 @@ def settings_write(
533
548
  )
534
549
  current = _yaml.read(path) or {}
535
550
  if _has_environment_sections(current):
536
- environment = active_environment()
537
- env_config = current.setdefault(environment, {})
538
- if env_config is None:
539
- env_config = current[environment] = {}
551
+ environment: str | None = active_environment()
552
+ env_config = current.get(environment)
540
553
  else:
541
554
  # A flat file has no environments: its sections are at the top level.
555
+ environment = None
542
556
  env_config = current
557
+ reference = env_config.get(section) if isinstance(env_config, dict) else None
543
558
 
544
- reference = env_config.get(section)
545
559
  if isinstance(reference, str) and reference.startswith("settings/"):
546
560
  split_path = path.parent / reference
547
561
  if not split_path.is_file():
548
562
  raise SettingsError(f"Split file '{reference}' does not exist")
549
- split = _yaml.read(split_path) or {}
550
- if split and section not in split:
551
- # An older split file without the section key: wrap it, as R does.
552
- split = {section: split}
553
- _yaml.write(split_path, modify_list(split, _split_values(section, values)))
554
- else:
555
- env_config[section] = dict(values)
556
- _yaml.write(path, current)
563
+
564
+ def merge_split(split: Any) -> Any:
565
+ split = split if isinstance(split, dict) else {}
566
+ if split and section not in split:
567
+ # An older split file without the section key: wrap it, as R does.
568
+ split = {section: split}
569
+ return _modify_in_place(split, _split_values(section, values))
570
+
571
+ _yaml.update(split_path, merge_split)
572
+ return
573
+
574
+ def replace_section(raw: Any) -> Any:
575
+ raw = raw if isinstance(raw, dict) else {}
576
+ target = raw
577
+ if environment is not None:
578
+ if not isinstance(raw.get(environment), dict):
579
+ raw[environment] = {}
580
+ target = raw[environment]
581
+ target[section] = dict(values)
582
+ return raw
583
+
584
+ _yaml.update(path, replace_section)
framework/storage.py CHANGED
@@ -29,7 +29,7 @@ import subprocess
29
29
  import tempfile
30
30
  from collections.abc import Callable, Mapping
31
31
  from dataclasses import dataclass
32
- from pathlib import Path
32
+ from pathlib import Path, PurePosixPath
33
33
  from typing import Any
34
34
 
35
35
  import pandas as pd
@@ -766,7 +766,8 @@ def publish_notebook(
766
766
  share_unlisted: Explicitly allow collection readers to access an unlisted artifact.
767
767
  allow_private: Deprecated name for ``include_private``.
768
768
  title: The published title, on Framework Cloud and named destinations. Default: the
769
- ``title`` in the document's YAML front matter, else its file name.
769
+ ``title`` in the document's YAML front matter (for a Jupyter notebook, or a
770
+ level-1 heading opening its first markdown cell), else its file name.
770
771
  description: A short description, on Framework Cloud and named destinations.
771
772
 
772
773
  Returns:
@@ -901,6 +902,17 @@ def _publish_route(to: str | None, connection: str | None) -> tuple[Any, str | N
901
902
  return selected, None
902
903
 
903
904
 
905
+ def _data_slug(dest: str) -> str:
906
+ """publish_data()'s slug: ``dest`` without its extension, with each ``/`` as ``-``.
907
+
908
+ ``"tables/demo.csv"`` becomes ``"tables-demo"``, so the folder part is kept.
909
+ """
910
+ path = PurePosixPath(dest.replace("\\", "/").removesuffix(".gz"))
911
+ if path.name:
912
+ path = path.with_suffix("")
913
+ return "-".join(part for part in path.parts if part not in ("", ".", "..", "/"))
914
+
915
+
904
916
  def publish_data(
905
917
  data: pd.DataFrame | str | Path,
906
918
  dest: str,
@@ -911,6 +923,8 @@ def publish_data(
911
923
  *,
912
924
  to: str | None = None,
913
925
  allow_private: bool | None = None,
926
+ title: str | None = None,
927
+ description: str | None = None,
914
928
  ) -> str:
915
929
  """Upload a DataFrame (as CSV, Parquet, or JSON) or a data file.
916
930
 
@@ -918,15 +932,18 @@ def publish_data(
918
932
 
919
933
  Like ``publish()``, it follows ``to``, then ``publish.default``. An S3 destination, an
920
934
  explicit ``connection``, or a project without ``publish.default`` gets a plain upload
921
- to the bucket at ``dest``. Folder, GitHub, and Cloud destinations publish the file with
922
- ``publish()``, under ``dest``'s file name, which (without its extension) is the slug.
935
+ to the bucket at ``dest``. Folder, GitHub, and Cloud destinations publish with
936
+ ``publish()``: a DataFrame becomes the same typed table ``publish()`` makes of it, and a
937
+ file is published under ``dest``'s file name. The slug is ``dest`` without its
938
+ extension, with each ``/`` turned into ``-``: ``"tables/demo.csv"`` publishes as
939
+ ``tables-demo``.
923
940
 
924
941
  Args:
925
942
  data: A DataFrame to write in ``format``, or the path of a file to upload as is.
926
943
  dest: The object's path in the bucket, including any extension. For other
927
- destinations, its file name names the file and the slug.
928
- format: How a DataFrame is written. One of "csv", "parquet", or "json" (records).
929
- Default: "csv". It is checked for files too, but does not change them.
944
+ destinations, it names the slug, and its file name names a published file.
945
+ format: How a DataFrame is written to a bucket. One of "csv", "parquet", or "json"
946
+ (records). Default: "csv". It is checked for files too, but does not change them.
930
947
  connection: A storage bucket name from the settings. Default: the project's default
931
948
  bucket, then one marked ``default: true``, then the first.
932
949
  compress: Gzip the file before uploading.
@@ -935,18 +952,38 @@ def publish_data(
935
952
  to: A destination name from ``publish.destinations``, or a driver name, as in
936
953
  ``publish()``. Default: ``publish.default``.
937
954
  allow_private: Deprecated name for ``include_private``.
955
+ title: The published title, on Framework Cloud and named destinations. Default: the
956
+ slug.
957
+ description: A short description, on Framework Cloud and named destinations.
938
958
 
939
959
  Returns:
940
960
  The public URL (for a folder destination without a ``url``, its location).
941
961
 
942
962
  Raises:
943
963
  FrameworkError: When ``format`` is not allowed, the file is missing or has "private"
944
- in its path and is not confirmed, no bucket is configured, or the upload fails.
964
+ in its path and is not confirmed, no bucket is configured, the upload fails, or
965
+ a title or description is given for a plain bucket upload.
945
966
  """
946
967
  if format not in ("csv", "parquet", "json"):
947
968
  raise FrameworkError("format must be csv, parquet, or json (rds is R-only)")
948
969
  include = include_private_arg(include_private, allow_private)
949
970
  selected, bucket_name = _publish_route(to, connection)
971
+ if selected is None and (title is not None or description is not None):
972
+ raise FrameworkError("Artifact metadata requires publishing to Framework Cloud.")
973
+ if selected is not None and isinstance(data, pd.DataFrame):
974
+ # The same typed table publish() makes of a DataFrame
975
+ slug = _data_slug(dest)
976
+ inform(f"Publishing {dest} as {slug}")
977
+ published = publish(
978
+ data,
979
+ to=selected.name,
980
+ slug=slug,
981
+ include_private=True,
982
+ title=title,
983
+ description=description,
984
+ )
985
+ assert isinstance(published, str)
986
+ return published
950
987
  with tempfile.TemporaryDirectory(prefix="publish_data_") as temp:
951
988
  if isinstance(data, pd.DataFrame):
952
989
  source = Path(temp) / f"data.{format}"
@@ -972,8 +1009,16 @@ def publish_data(
972
1009
  staged = Path(temp) / "stage" / Path(dest).name
973
1010
  staged.parent.mkdir()
974
1011
  shutil.copy2(source, staged)
975
- slug = Path(Path(dest).name.removesuffix(".gz")).stem
976
- published = publish(staged, to=selected.name, slug=slug, include_private=True)
1012
+ slug = _data_slug(dest)
1013
+ inform(f"Publishing {dest} as {slug}")
1014
+ published = publish(
1015
+ staged,
1016
+ to=selected.name,
1017
+ slug=slug,
1018
+ include_private=True,
1019
+ title=title,
1020
+ description=description,
1021
+ )
977
1022
  assert isinstance(published, str)
978
1023
  return published
979
1024
  url = upload_file(source, dest, resolve_bucket(bucket_name))
@@ -991,6 +1036,8 @@ def publish_dir(
991
1036
  *,
992
1037
  to: str | None = None,
993
1038
  allow_private: bool | None = None,
1039
+ title: str | None = None,
1040
+ description: str | None = None,
994
1041
  ) -> list[str]:
995
1042
  """Upload the files in a folder. ``pattern`` is a regular expression on the paths.
996
1043
 
@@ -1015,6 +1062,9 @@ def publish_dir(
1015
1062
  to: A destination name from ``publish.destinations``, or a driver name, as in
1016
1063
  ``publish()``. Default: ``publish.default``.
1017
1064
  allow_private: Deprecated name for ``include_private``.
1065
+ title: The published title, on Framework Cloud and named destinations. Default: the
1066
+ slug.
1067
+ description: A short description, on Framework Cloud and named destinations.
1018
1068
 
1019
1069
  Returns:
1020
1070
  The public URL of each file uploaded. The list is empty when no file matched. For
@@ -1022,7 +1072,8 @@ def publish_dir(
1022
1072
 
1023
1073
  Raises:
1024
1074
  FrameworkError: When the folder is missing, a file has "private" in its path and is
1025
- not confirmed, no bucket is configured, or an upload fails.
1075
+ not confirmed, no bucket is configured, an upload fails, or a title or description
1076
+ is given for a plain bucket upload.
1026
1077
  """
1027
1078
  folder = Path(dir)
1028
1079
  if not folder.is_dir():
@@ -1034,11 +1085,20 @@ def publish_dir(
1034
1085
  return []
1035
1086
  confirm_private_upload(files, include)
1036
1087
  selected, bucket_name = _publish_route(to, connection)
1088
+ if selected is None and (title is not None or description is not None):
1089
+ raise FrameworkError("Artifact metadata requires publishing to Framework Cloud.")
1037
1090
  dest = dest or folder.resolve().name
1038
1091
  if selected is not None:
1039
1092
  slug = Path(dest.rstrip("/")).name
1040
1093
  if pattern is None and recursive:
1041
- published = publish(folder, to=selected.name, slug=slug, include_private=True)
1094
+ published = publish(
1095
+ folder,
1096
+ to=selected.name,
1097
+ slug=slug,
1098
+ include_private=True,
1099
+ title=title,
1100
+ description=description,
1101
+ )
1042
1102
  else:
1043
1103
  # Publish only the selected files, keeping their paths inside the folder
1044
1104
  with tempfile.TemporaryDirectory(prefix="fw_publish_dir_") as temp:
@@ -1047,7 +1107,14 @@ def publish_dir(
1047
1107
  target = stage / file.relative_to(folder)
1048
1108
  target.parent.mkdir(parents=True, exist_ok=True)
1049
1109
  shutil.copy2(file, target)
1050
- published = publish(stage, to=selected.name, slug=slug, include_private=True)
1110
+ published = publish(
1111
+ stage,
1112
+ to=selected.name,
1113
+ slug=slug,
1114
+ include_private=True,
1115
+ title=title,
1116
+ description=description,
1117
+ )
1051
1118
  return [published] if isinstance(published, str) else list(published)
1052
1119
  bucket = resolve_bucket(bucket_name)
1053
1120
  inform(f"Uploading {len(files)} files...")
@@ -56,6 +56,10 @@ framework.db-shm
56
56
  # QUARTO ARTIFACTS
57
57
  # ============================================================================
58
58
 
59
+ # Quarto adds these two lines, in this form, unless they are here already
60
+ /.quarto/
61
+ **/*.quarto_ipynb
62
+ # A folder with its own _quarto.yml gets its own .quarto/
59
63
  .quarto/
60
64
  _freeze/
61
65
  *_cache/
@@ -53,6 +53,10 @@ framework.db-shm
53
53
  # QUARTO ARTIFACTS
54
54
  # ============================================================================
55
55
 
56
+ # Quarto adds these two lines, in this form, unless they are here already
57
+ /.quarto/
58
+ **/*.quarto_ipynb
59
+ # A folder with its own _quarto.yml gets its own .quarto/
56
60
  .quarto/
57
61
  _freeze/
58
62
  *_cache/
@@ -54,6 +54,10 @@ framework.db-shm
54
54
  # QUARTO ARTIFACTS
55
55
  # ============================================================================
56
56
 
57
+ # Quarto adds these two lines, in this form, unless they are here already
58
+ /.quarto/
59
+ **/*.quarto_ipynb
60
+ # A folder with its own _quarto.yml gets its own .quarto/
57
61
  .quarto/
58
62
  _freeze/
59
63
  *_cache/
@@ -78,6 +78,10 @@ framework.db-shm
78
78
  # QUARTO ARTIFACTS
79
79
  # ============================================================================
80
80
 
81
+ # Quarto adds these two lines, in this form, unless they are here already
82
+ /.quarto/
83
+ **/*.quarto_ipynb
84
+ # A folder with its own _quarto.yml gets its own .quarto/
81
85
  .quarto/
82
86
  _freeze/
83
87
  *_cache/
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: framework-py
3
- Version: 0.1.0.dev8
3
+ Version: 0.1.0.dev9
4
4
  Summary: Structured data science projects: a data catalog, integrity tracking, caching, outputs, and AI guardrails
5
5
  Project-URL: Homepage, https://framework.pub
6
6
  Project-URL: Source, https://github.com/frameworktools/framework-py
@@ -26,6 +26,7 @@ Requires-Dist: keyring>=25
26
26
  Requires-Dist: pandas>=2.2
27
27
  Requires-Dist: pyarrow>=16
28
28
  Requires-Dist: pyyaml>=6.0
29
+ Requires-Dist: ruamel-yaml>=0.18
29
30
  Requires-Dist: secretstorage>=3.2; sys_platform == 'linux'
30
31
  Provides-Extra: duckdb
31
32
  Requires-Dist: duckdb>=1.0; extra == 'duckdb'
@@ -1,6 +1,6 @@
1
1
  framework/__init__.py,sha256=8nI4dfPbAHBKWM_vPuQbs1RUbi7fO9MEuJAVdvBBPu0,6003
2
2
  framework/__main__.py,sha256=CnSGHPB54v3Uqed9020bgseg_2AZzb1lnJFl8nlX8CM,6044
3
- framework/_agents_md.py,sha256=Bwrf9pPYOoq9JeP7RFtcL3rx0xI6N9LXiXwD9CmJjvA,8247
3
+ framework/_agents_md.py,sha256=sMGpAP7EEIxbLdgRKBrTS6qBj_ZbBi7vcBOHB1h_XuE,8172
4
4
  framework/_artifacts.py,sha256=cOk2XLqctoqLaQSkksmc7cP4W0_AgqSxYNCTJxyZyik,36068
5
5
  framework/_defaults_cache.py,sha256=pyqQ7rMcKwo_fTSAvDDNyQXIAjiJZfWccnkRPw340WQ,1711
6
6
  framework/_keychain.py,sha256=9QW8dFDhgy0knWCCu9blttIe_nCG0UhdY77wrVa1h6M,2798
@@ -11,7 +11,7 @@ framework/_private.py,sha256=pZpvs1CSaUiSPCaBvqF13r2uwbXD8f5UFsCVu-9TzQY,2545
11
11
  framework/_secretservice.py,sha256=zv5UvEekQic466qRmVpLG_hfEkisikHfab8e6kyzS2k,2450
12
12
  framework/_time.py,sha256=mv-BS3NjOo0hr6bwYRhUBY-3sG6SJmzaboaMD62QcJw,306
13
13
  framework/_wincred.py,sha256=oJGS37Dcw_PZVmiAGRu4H_lhcOC5-FqGGYfxVUGPPmU,3891
14
- framework/_yaml.py,sha256=ZJqh9ywmBEbD0VpV0FODcyAkvCsUTyj2W0MisFNRyT0,2372
14
+ framework/_yaml.py,sha256=fslcba4AC4Zi-8spaE5GZoQ-PAqaumuxN3RvFeyRzTw,5293
15
15
  framework/adopt.py,sha256=8Trxg7y8zIN3lrFwKBb_7KTfcXnt4t3f7zox5x0ss4I,14056
16
16
  framework/ai.py,sha256=ZI7DmEiDi0hrxOLCvh-3aU9cgGcCznOtovRVl9rrXj8,9145
17
17
  framework/bootstrap.py,sha256=kBznHCosXkpVCuMYdIP3Ii8SOiWvtQtEP60oWdka3Qk,9468
@@ -21,28 +21,28 @@ framework/cloud.py,sha256=0JjZB3lem8k3nNh_RkNZdv0KhNboyY6ZaP1eUFgiY_o,49551
21
21
  framework/config_home.py,sha256=iSb0VuENgNOSnsZ_v53xFqjRiGgrB7OzZbHbyDOqKzs,8265
22
22
  framework/connections.py,sha256=1sUTSDbCCCF7NWZydEMGOibPDHGTCi3St8M4rG27vds,20686
23
23
  framework/console.py,sha256=zQ0LuFDcxe1W1kuc5E1bJ03h8d3cvwFoqDT8dAJQyN0,1267
24
- framework/create.py,sha256=vttSCGdVdqxGesTppSDYJkiDcWSAOjYyuWZEavVaJRs,42389
25
- framework/data.py,sha256=vAemLeCYGcCuqkICXLHzaTewb1W0t8ZZ3X2Hm-Oofs0,22579
24
+ framework/create.py,sha256=7Q2pdBs89Y9Sm1COLeJo5o02Ml9xl7-RKyUOAQbsMTs,43378
25
+ framework/data.py,sha256=W8_guuFDLK7gR3vf7Ssew07pY-IEtvJSuXIgk8-nfLY,23204
26
26
  framework/db.py,sha256=Wruez2V352xA3gjk5RcUi_0zncFsDwTs9Gwa2hXBY3Y,8099
27
27
  framework/dotenv.py,sha256=6YQVR8d0CnHXHAYxvP3E4Am4Ei9mzqN2g63w_ft7qa0,4642
28
28
  framework/errors.py,sha256=BIrWiMUuxmCBNVGxg-9vUAbht3N8On7iyacp0bnTUNk,1103
29
29
  framework/features.py,sha256=abwC9XCdC0Mm-WFBN-Qw7ztBiFm_mWLqftl7MTNWjc8,7595
30
30
  framework/global_config.py,sha256=fYLaxN_6Wc2xrIASn77dWkvGR3uuX-111bvfFPB82A4,11036
31
- framework/hooks.py,sha256=7p-U6rzN-9WPcYzQn4uqtgXalEib0M0a94xQxh7DJ90,19958
31
+ framework/hooks.py,sha256=7FSXK86soBK9zISdRaLGfIQvwfDXe68dZuZO86pWBaQ,20551
32
32
  framework/integrity.py,sha256=2hXk95tlNGs6HVTFA0AqcPWQg2AiO6Hy0APMIXHpCTU,586
33
- framework/notebooks.py,sha256=Df6bV4fkIFhsvHV9T_BZQGltT4FUOyVAoDhWQljD-L8,19813
34
- framework/outputs.py,sha256=VpYz9Bao4cHkgPHlYzESBFkavw6_FyGBkRt1G9oPoTM,14857
33
+ framework/notebooks.py,sha256=0pDrZrj7OO8kjnLpfu66Gc-7wP4trLAVN7WFQH3aG6I,19926
34
+ framework/outputs.py,sha256=Kmml_85dIfC1qZTS8zVipN0Odcgh6tU1HGa1RLCKNLc,15921
35
35
  framework/packages.py,sha256=gsHpPxDanOCT46f16X3vtmeuJXHC-5ovud7xmbyO29c,15273
36
36
  framework/project.py,sha256=2pF8ZVh60BEDuh9D3z0VUAOZLNgnCYFT9oW1_UUv2NA,1805
37
- framework/publish_bundle.py,sha256=Y4Dmy4YQjbMqAPfnrtBEgs2rO9hJstJruWR4dz0eW7M,24267
37
+ framework/publish_bundle.py,sha256=c0dZfKC6bpZnrdW67UVCxXoO-YWGigGQQUbDL_X4clk,24641
38
38
  framework/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
39
39
  framework/quarto.py,sha256=QpEV7rID4_4j8mbhcrkrprrZL15eOYI_PwL-jvE6dY4,9977
40
- framework/scaffold.py,sha256=x_r8w95xspy-MJ38Y0rLhGilVK-5XxNOPfx-oA0dAMQ,12808
40
+ framework/scaffold.py,sha256=UwJw503gOZIp_Y2fHiDuxeG6BUNsy9Yq2k7ZsvEPqz0,13169
41
41
  framework/scratch.py,sha256=idxthUR5BIMX7FIGS7KzIuhOrO3-HKLbBsV8It3EEE4,3890
42
42
  framework/security.py,sha256=eYjYW2ZUqd1zC5jvTJAZebLRHMHSdkog01r-18NcDRM,26112
43
- framework/settings.py,sha256=BGCnfnT_SqP0Cvpo0XYGF74tNi8IrIhPxQ9KaZWrakY,21240
43
+ framework/settings.py,sha256=hsIMZBBUHuOExQzimILQ5ku_cZvl31LAJryjIM-PHjg,22397
44
44
  framework/skill_sync.py,sha256=xiaIPTGIExXcBIMAOeg44WLPMPdixZps_2twxelioow,19412
45
- framework/storage.py,sha256=V8XtltpTUbp4C0x2olugIsFeW2_BSGAK69XnoDUJhYA,50234
45
+ framework/storage.py,sha256=2FBk7vbMvS2g4A3g62UwkowNdsqCE3cyMNiGsvv2k00,52946
46
46
  framework/_assets/init.sql,sha256=-aIiuIcCmBniGKq-CHdRtUiV9e_CLXoqxxd05snmgOE,1156
47
47
  framework/_assets/adopt/rules.json,sha256=au7YTeHzOiYotm-lT8ap3kb1t1WmOAeZeEgoumIb7_4,2868
48
48
  framework/_assets/features/jupyter.json,sha256=BlPgR9OIfmlMVTstwpWbYrAA4MNx61QvK9lybrNtGgA,736
@@ -94,10 +94,10 @@ framework/spec/merge.py,sha256=5KP_Xp5yLZUKODj6ZUliC4TZxKVgoYV6--yFU5LCp8U,6287
94
94
  framework/spec/resolve.py,sha256=DJfekI5abo0vwYUEjdEfsLahxDZv55vHPlSFf5ArLCA,11997
95
95
  framework/templates/defaults.yml,sha256=TFxs3C4NXG7cGEaA0fbJMMPDFUDAwCcmwubv48-t6fY,3873
96
96
  framework/templates/reader.html,sha256=SBw3I3rRMdAyoBosMVuZ9Yp177P11CoxIAaG0OOuvQg,19772
97
- framework/templates/gitignore/course,sha256=D7DkdMeS_SMfaKcTgV5B7WUGzzL2zhU9boYxMP--2xo,2841
98
- framework/templates/gitignore/presentation,sha256=CAl2vPcA1Lgv1CXsVmuKf7DtIVs-g6WEWnPnOuGmMdc,2743
99
- framework/templates/gitignore/project,sha256=D8jFTFhIyJyTIh1xrPE5wFkvuJlSkqaqeJYafnmRPts,2622
100
- framework/templates/gitignore/sensitive,sha256=mz0KwMHq1UJhOGJTFzTbzJug6C6p2wbec9ADl2veqhE,3550
97
+ framework/templates/gitignore/course,sha256=VbNFPxggk8XlXEOVedO9no6B9W6Ixm_ASWe0ufZCyzw,3001
98
+ framework/templates/gitignore/presentation,sha256=4HOErO4zm2HEX2q_JS_vH-0lFMxCWAv1H6PKqyKBIQg,2903
99
+ framework/templates/gitignore/project,sha256=kHfqjTvWZ51AsApXipBKSCdOIpaYsE0mG8t5-tK1y-A,2782
100
+ framework/templates/gitignore/sensitive,sha256=8mKH9WUvn3TRc6QtvboLFvcbfQOGGebRQNMKZzGzzy0,3710
101
101
  framework/templates/skills/framework-data/.framework-skill.json,sha256=L0FERNLIhL_71u3ex0zhp8qW-W7dHGdXEGp038D5taY,139
102
102
  framework/templates/skills/framework-data/SKILL.md,sha256=ddZjgx1YH7tdMNEgaLRPUhu-tCAi3xzcPJrK6SZ7_yg,1932
103
103
  framework/templates/skills/framework-outputs/.framework-skill.json,sha256=RZN5cYD13n9dEt_sJVO3rXJOL1zG3UXeyvlyoFtIzdU,142
@@ -113,7 +113,7 @@ framework/templates/stubs/notebook-default.qmd,sha256=8Js1S2BcHYeQWmJS-kt31gBvIj
113
113
  framework/templates/stubs/notebook-minimal.qmd,sha256=2U2k8judffhrh_6m6r6OAbQBCYEtViAjeKRBqBYCJTM,178
114
114
  framework/templates/stubs/notebook-revealjs.qmd,sha256=_ztT_gHoudpB5DIjlbvtB5zQ8163DeV8xbWcT-HgJrI,409
115
115
  framework/templates/stubs/script-default.py,sha256=vbWqgW0_rHot17mQC3tYb92g_9L-cbTOeL3y99BRrSk,216
116
- framework_py-0.1.0.dev8.dist-info/METADATA,sha256=X1GbhmP0cKxC0Qhgy3qzWxUvNueQ87QHV3lU89izigA,4151
117
- framework_py-0.1.0.dev8.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
118
- framework_py-0.1.0.dev8.dist-info/licenses/LICENSE,sha256=giOOgSwALkZimC7uhLZQK8Untez641bLW1-2-Cjvmq0,1072
119
- framework_py-0.1.0.dev8.dist-info/RECORD,,
116
+ framework_py-0.1.0.dev9.dist-info/METADATA,sha256=jJ8FQORZkE2RinFGuyGdoMLW5WRw-BbhhyTbBj17VRQ,4184
117
+ framework_py-0.1.0.dev9.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
118
+ framework_py-0.1.0.dev9.dist-info/licenses/LICENSE,sha256=giOOgSwALkZimC7uhLZQK8Untez641bLW1-2-Cjvmq0,1072
119
+ framework_py-0.1.0.dev9.dist-info/RECORD,,