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 +4 -5
- framework/_yaml.py +71 -0
- framework/create.py +38 -10
- framework/data.py +40 -25
- framework/hooks.py +36 -19
- framework/notebooks.py +11 -9
- framework/outputs.py +26 -2
- framework/publish_bundle.py +9 -4
- framework/scaffold.py +9 -4
- framework/settings.py +42 -14
- framework/storage.py +80 -13
- framework/templates/gitignore/course +4 -0
- framework/templates/gitignore/presentation +4 -0
- framework/templates/gitignore/project +4 -0
- framework/templates/gitignore/sensitive +4 -0
- {framework_py-0.1.0.dev8.dist-info → framework_py-0.1.0.dev9.dist-info}/METADATA +2 -1
- {framework_py-0.1.0.dev8.dist-info → framework_py-0.1.0.dev9.dist-info}/RECORD +19 -19
- {framework_py-0.1.0.dev8.dist-info → framework_py-0.1.0.dev9.dist-info}/WHEEL +0 -0
- {framework_py-0.1.0.dev8.dist-info → framework_py-0.1.0.dev9.dist-info}/licenses/LICENSE +0 -0
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
|
-
|
|
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
|
-
|
|
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
|
|
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 = [
|
|
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 += [
|
|
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
|
|
1036
|
-
|
|
1037
|
-
|
|
1038
|
-
|
|
1039
|
-
|
|
1040
|
-
|
|
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
|
-
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
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
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
|
|
525
|
-
|
|
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.
|
|
86
|
-
if env
|
|
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
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
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
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
_yaml.
|
|
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
|
|
69
|
-
file-style name has its ``-`` and ``_`` turned into spaces
|
|
70
|
-
|
|
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
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
if
|
|
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
|
|
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 =
|
|
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
|
framework/publish_bundle.py
CHANGED
|
@@ -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.
|
|
27
|
-
|
|
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
|
|
224
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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.
|
|
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
|
-
|
|
550
|
-
|
|
551
|
-
|
|
552
|
-
split
|
|
553
|
-
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
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
|
|
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
|
|
922
|
-
``publish()
|
|
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
|
|
928
|
-
format: How a DataFrame is written. One of "csv", "parquet", or "json"
|
|
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,
|
|
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 =
|
|
976
|
-
|
|
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,
|
|
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(
|
|
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(
|
|
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.
|
|
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=
|
|
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=
|
|
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=
|
|
25
|
-
framework/data.py,sha256=
|
|
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=
|
|
31
|
+
framework/hooks.py,sha256=7FSXK86soBK9zISdRaLGfIQvwfDXe68dZuZO86pWBaQ,20551
|
|
32
32
|
framework/integrity.py,sha256=2hXk95tlNGs6HVTFA0AqcPWQg2AiO6Hy0APMIXHpCTU,586
|
|
33
|
-
framework/notebooks.py,sha256=
|
|
34
|
-
framework/outputs.py,sha256=
|
|
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=
|
|
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=
|
|
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=
|
|
43
|
+
framework/settings.py,sha256=hsIMZBBUHuOExQzimILQ5ku_cZvl31LAJryjIM-PHjg,22397
|
|
44
44
|
framework/skill_sync.py,sha256=xiaIPTGIExXcBIMAOeg44WLPMPdixZps_2twxelioow,19412
|
|
45
|
-
framework/storage.py,sha256=
|
|
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=
|
|
98
|
-
framework/templates/gitignore/presentation,sha256=
|
|
99
|
-
framework/templates/gitignore/project,sha256=
|
|
100
|
-
framework/templates/gitignore/sensitive,sha256=
|
|
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.
|
|
117
|
-
framework_py-0.1.0.
|
|
118
|
-
framework_py-0.1.0.
|
|
119
|
-
framework_py-0.1.0.
|
|
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,,
|
|
File without changes
|
|
File without changes
|