linked-data-python 0.2.0__tar.gz → 0.2.1__tar.gz

{linked_data_python-0.2.0 → linked_data_python-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linked-data-python
-Version: 0.2.0
+Version: 0.2.1
 Summary: Python extended with Semantic Web primitives: IRIs, RDF literals and Turtle-notation graphs as expressions, transpiled by island parsing.
 Author-email: Maxime Lefrançois <maxime.lefrancois@emse.fr>
 License: MIT
@@ -96,31 +96,31 @@ From Python: `import ldpy; ldpy.install()` then `import yourmodule` finds
 
 ## Documentation
 
-Read it at [`docs/`](docs/README.md) — start with the
-[home page](docs/README.md) for an overview, then:
+Read it at **<https://linked-data-python.readthedocs.io/>** — start with the
+home page for an overview, then:
 
-- **Tutorials** — [first steps](docs/tutorials/getting-started.md), then
-  [build a knowledge graph](docs/tutorials/build-a-knowledge-graph.md) from
+- **Tutorials** — [first steps](https://linked-data-python.readthedocs.io/en/latest/tutorials/getting-started/), then
+  [build a knowledge graph](https://linked-data-python.readthedocs.io/en/latest/tutorials/build-a-knowledge-graph/) from
   tabular data.
-- **How-to guides** — [run & import](docs/how-to/run-and-import.md),
-  [build graphs from tables](docs/how-to/build-graphs-from-tables.md),
-  [read and query](docs/how-to/query-a-graph.md),
-  [migrate from rdflib](docs/how-to/migrate-from-rdflib.md),
-  [VS Code](docs/how-to/use-vscode.md), [debugging](docs/how-to/debug.md),
-  [language server](docs/how-to/language-server.md),
-  [highlighting](docs/how-to/highlight-ldpy.md).
-- **Reference** — [the language](docs/reference/language/index.md), one page
-  per island family; [SPARQL expressions](docs/reference/sparql-expressions.md);
-  [CLI](docs/reference/cli.md); [Python API](docs/reference/api.md);
-  [language map formats](docs/reference/language-map.md).
-- **Explanation** — [why](docs/explanation/why.md),
-  [what real RDF code does](docs/explanation/what-real-code-does.md) (the
+- **How-to guides** — [run & import](https://linked-data-python.readthedocs.io/en/latest/how-to/run-and-import/),
+  [build graphs from tables](https://linked-data-python.readthedocs.io/en/latest/how-to/build-graphs-from-tables/),
+  [read and query](https://linked-data-python.readthedocs.io/en/latest/how-to/query-a-graph/),
+  [migrate from rdflib](https://linked-data-python.readthedocs.io/en/latest/how-to/migrate-from-rdflib/),
+  [VS Code](https://linked-data-python.readthedocs.io/en/latest/how-to/use-vscode/), [debugging](https://linked-data-python.readthedocs.io/en/latest/how-to/debug/),
+  [language server](https://linked-data-python.readthedocs.io/en/latest/how-to/language-server/),
+  [highlighting](https://linked-data-python.readthedocs.io/en/latest/how-to/highlight-ldpy/).
+- **Reference** — [the language](https://linked-data-python.readthedocs.io/en/latest/reference/language/), one page
+  per island family; [SPARQL expressions](https://linked-data-python.readthedocs.io/en/latest/reference/sparql-expressions/);
+  [CLI](https://linked-data-python.readthedocs.io/en/latest/reference/cli/); [Python API](https://linked-data-python.readthedocs.io/en/latest/reference/api/);
+  [language map formats](https://linked-data-python.readthedocs.io/en/latest/reference/language-map/).
+- **Explanation** — [why](https://linked-data-python.readthedocs.io/en/latest/explanation/why/),
+  [what real RDF code does](https://linked-data-python.readthedocs.io/en/latest/explanation/what-real-code-does/) (the
   corpus study that drove the language's second wave),
-  [designing the syntax](docs/explanation/designing-the-syntax.md),
-  [island parsing](docs/explanation/island-parsing.md),
-  [emission & semantics](docs/explanation/emission-and-semantics.md),
-  [tooling](docs/explanation/tooling.md),
-  [how this is tested](docs/explanation/how-it-is-tested.md).
+  [designing the syntax](https://linked-data-python.readthedocs.io/en/latest/explanation/designing-the-syntax/),
+  [island parsing](https://linked-data-python.readthedocs.io/en/latest/explanation/island-parsing/),
+  [emission & semantics](https://linked-data-python.readthedocs.io/en/latest/explanation/emission-and-semantics/),
+  [tooling](https://linked-data-python.readthedocs.io/en/latest/explanation/tooling/),
+  [how this is tested](https://linked-data-python.readthedocs.io/en/latest/explanation/how-it-is-tested/).
 
 Every `ldpy` and `python` block in the documentation is executed by the test
 suite, and its assertions are the test.

{linked_data_python-0.2.0 → linked_data_python-0.2.1}/README.md

@@ -54,31 +54,31 @@ From Python: `import ldpy; ldpy.install()` then `import yourmodule` finds
 
 ## Documentation
 
-Read it at [`docs/`](docs/README.md) — start with the
-[home page](docs/README.md) for an overview, then:
+Read it at **<https://linked-data-python.readthedocs.io/>** — start with the
+home page for an overview, then:
 
-- **Tutorials** — [first steps](docs/tutorials/getting-started.md), then
-  [build a knowledge graph](docs/tutorials/build-a-knowledge-graph.md) from
+- **Tutorials** — [first steps](https://linked-data-python.readthedocs.io/en/latest/tutorials/getting-started/), then
+  [build a knowledge graph](https://linked-data-python.readthedocs.io/en/latest/tutorials/build-a-knowledge-graph/) from
   tabular data.
-- **How-to guides** — [run & import](docs/how-to/run-and-import.md),
-  [build graphs from tables](docs/how-to/build-graphs-from-tables.md),
-  [read and query](docs/how-to/query-a-graph.md),
-  [migrate from rdflib](docs/how-to/migrate-from-rdflib.md),
-  [VS Code](docs/how-to/use-vscode.md), [debugging](docs/how-to/debug.md),
-  [language server](docs/how-to/language-server.md),
-  [highlighting](docs/how-to/highlight-ldpy.md).
-- **Reference** — [the language](docs/reference/language/index.md), one page
-  per island family; [SPARQL expressions](docs/reference/sparql-expressions.md);
-  [CLI](docs/reference/cli.md); [Python API](docs/reference/api.md);
-  [language map formats](docs/reference/language-map.md).
-- **Explanation** — [why](docs/explanation/why.md),
-  [what real RDF code does](docs/explanation/what-real-code-does.md) (the
+- **How-to guides** — [run & import](https://linked-data-python.readthedocs.io/en/latest/how-to/run-and-import/),
+  [build graphs from tables](https://linked-data-python.readthedocs.io/en/latest/how-to/build-graphs-from-tables/),
+  [read and query](https://linked-data-python.readthedocs.io/en/latest/how-to/query-a-graph/),
+  [migrate from rdflib](https://linked-data-python.readthedocs.io/en/latest/how-to/migrate-from-rdflib/),
+  [VS Code](https://linked-data-python.readthedocs.io/en/latest/how-to/use-vscode/), [debugging](https://linked-data-python.readthedocs.io/en/latest/how-to/debug/),
+  [language server](https://linked-data-python.readthedocs.io/en/latest/how-to/language-server/),
+  [highlighting](https://linked-data-python.readthedocs.io/en/latest/how-to/highlight-ldpy/).
+- **Reference** — [the language](https://linked-data-python.readthedocs.io/en/latest/reference/language/), one page
+  per island family; [SPARQL expressions](https://linked-data-python.readthedocs.io/en/latest/reference/sparql-expressions/);
+  [CLI](https://linked-data-python.readthedocs.io/en/latest/reference/cli/); [Python API](https://linked-data-python.readthedocs.io/en/latest/reference/api/);
+  [language map formats](https://linked-data-python.readthedocs.io/en/latest/reference/language-map/).
+- **Explanation** — [why](https://linked-data-python.readthedocs.io/en/latest/explanation/why/),
+  [what real RDF code does](https://linked-data-python.readthedocs.io/en/latest/explanation/what-real-code-does/) (the
   corpus study that drove the language's second wave),
-  [designing the syntax](docs/explanation/designing-the-syntax.md),
-  [island parsing](docs/explanation/island-parsing.md),
-  [emission & semantics](docs/explanation/emission-and-semantics.md),
-  [tooling](docs/explanation/tooling.md),
-  [how this is tested](docs/explanation/how-it-is-tested.md).
+  [designing the syntax](https://linked-data-python.readthedocs.io/en/latest/explanation/designing-the-syntax/),
+  [island parsing](https://linked-data-python.readthedocs.io/en/latest/explanation/island-parsing/),
+  [emission & semantics](https://linked-data-python.readthedocs.io/en/latest/explanation/emission-and-semantics/),
+  [tooling](https://linked-data-python.readthedocs.io/en/latest/explanation/tooling/),
+  [how this is tested](https://linked-data-python.readthedocs.io/en/latest/explanation/how-it-is-tested/).
 
 Every `ldpy` and `python` block in the documentation is executed by the test
 suite, and its assertions are the test.

{linked_data_python-0.2.0 → linked_data_python-0.2.1}/ldpy/__init__.py

@@ -11,7 +11,19 @@ package but is no longer imported by default.
 from ldpy.transpiler import transpile, LdpySyntaxError, LdpyWarning
 from ldpy.importer import install, uninstall, install_excepthook
 
-__version__ = "0.1.0.dev0"
+#: Read from the installed distribution rather than written here: two copies
+#: of a version number drift, and this one had — a 0.2.0 install announced
+#: itself as 0.1.0.dev0 in the editor status bar. The fallback covers a source
+#: tree that was never installed.
+try:
+    from importlib.metadata import PackageNotFoundError, version as _version
+    try:
+        __version__ = _version("linked-data-python")
+    except PackageNotFoundError:                      # pragma: no cover
+        __version__ = "0.0.0+unknown"
+    del _version, PackageNotFoundError
+except ImportError:                                   # pragma: no cover
+    __version__ = "0.0.0+unknown"
 __date__ = "2026-08-26"
 
 

{linked_data_python-0.2.0 → linked_data_python-0.2.1}/ldpy/debug.py

@@ -211,9 +211,13 @@ def main(argv=None):
 
     if args.breakpoints:
         lines = [int(x) for x in args.breakpoints.split(",") if x.strip()]
+        # ABSOLUTE paths: this output crosses a process boundary, and a
+        # relative path means nothing to a reader that does not share our
+        # working directory. An editor turning ".ldpy-build/x.py" into a URI
+        # gets "/.ldpy-build/x.py", rooted at the filesystem root.
         print(json.dumps({
-            "shadow": py_path,
-            "map": map_path,
+            "shadow": os.path.abspath(py_path),
+            "map": os.path.abspath(map_path),
             "breakpoints": dict(zip(
                 lines, translate_breakpoints(result.map, lines)))}))
         return 0

{linked_data_python-0.2.0 → linked_data_python-0.2.1}/linked_data_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linked-data-python
-Version: 0.2.0
+Version: 0.2.1
 Summary: Python extended with Semantic Web primitives: IRIs, RDF literals and Turtle-notation graphs as expressions, transpiled by island parsing.
 Author-email: Maxime Lefrançois <maxime.lefrancois@emse.fr>
 License: MIT
@@ -96,31 +96,31 @@ From Python: `import ldpy; ldpy.install()` then `import yourmodule` finds
 
 ## Documentation
 
-Read it at [`docs/`](docs/README.md) — start with the
-[home page](docs/README.md) for an overview, then:
+Read it at **<https://linked-data-python.readthedocs.io/>** — start with the
+home page for an overview, then:
 
-- **Tutorials** — [first steps](docs/tutorials/getting-started.md), then
-  [build a knowledge graph](docs/tutorials/build-a-knowledge-graph.md) from
+- **Tutorials** — [first steps](https://linked-data-python.readthedocs.io/en/latest/tutorials/getting-started/), then
+  [build a knowledge graph](https://linked-data-python.readthedocs.io/en/latest/tutorials/build-a-knowledge-graph/) from
   tabular data.
-- **How-to guides** — [run & import](docs/how-to/run-and-import.md),
-  [build graphs from tables](docs/how-to/build-graphs-from-tables.md),
-  [read and query](docs/how-to/query-a-graph.md),
-  [migrate from rdflib](docs/how-to/migrate-from-rdflib.md),
-  [VS Code](docs/how-to/use-vscode.md), [debugging](docs/how-to/debug.md),
-  [language server](docs/how-to/language-server.md),
-  [highlighting](docs/how-to/highlight-ldpy.md).
-- **Reference** — [the language](docs/reference/language/index.md), one page
-  per island family; [SPARQL expressions](docs/reference/sparql-expressions.md);
-  [CLI](docs/reference/cli.md); [Python API](docs/reference/api.md);
-  [language map formats](docs/reference/language-map.md).
-- **Explanation** — [why](docs/explanation/why.md),
-  [what real RDF code does](docs/explanation/what-real-code-does.md) (the
+- **How-to guides** — [run & import](https://linked-data-python.readthedocs.io/en/latest/how-to/run-and-import/),
+  [build graphs from tables](https://linked-data-python.readthedocs.io/en/latest/how-to/build-graphs-from-tables/),
+  [read and query](https://linked-data-python.readthedocs.io/en/latest/how-to/query-a-graph/),
+  [migrate from rdflib](https://linked-data-python.readthedocs.io/en/latest/how-to/migrate-from-rdflib/),
+  [VS Code](https://linked-data-python.readthedocs.io/en/latest/how-to/use-vscode/), [debugging](https://linked-data-python.readthedocs.io/en/latest/how-to/debug/),
+  [language server](https://linked-data-python.readthedocs.io/en/latest/how-to/language-server/),
+  [highlighting](https://linked-data-python.readthedocs.io/en/latest/how-to/highlight-ldpy/).
+- **Reference** — [the language](https://linked-data-python.readthedocs.io/en/latest/reference/language/), one page
+  per island family; [SPARQL expressions](https://linked-data-python.readthedocs.io/en/latest/reference/sparql-expressions/);
+  [CLI](https://linked-data-python.readthedocs.io/en/latest/reference/cli/); [Python API](https://linked-data-python.readthedocs.io/en/latest/reference/api/);
+  [language map formats](https://linked-data-python.readthedocs.io/en/latest/reference/language-map/).
+- **Explanation** — [why](https://linked-data-python.readthedocs.io/en/latest/explanation/why/),
+  [what real RDF code does](https://linked-data-python.readthedocs.io/en/latest/explanation/what-real-code-does/) (the
   corpus study that drove the language's second wave),
-  [designing the syntax](docs/explanation/designing-the-syntax.md),
-  [island parsing](docs/explanation/island-parsing.md),
-  [emission & semantics](docs/explanation/emission-and-semantics.md),
-  [tooling](docs/explanation/tooling.md),
-  [how this is tested](docs/explanation/how-it-is-tested.md).
+  [designing the syntax](https://linked-data-python.readthedocs.io/en/latest/explanation/designing-the-syntax/),
+  [island parsing](https://linked-data-python.readthedocs.io/en/latest/explanation/island-parsing/),
+  [emission & semantics](https://linked-data-python.readthedocs.io/en/latest/explanation/emission-and-semantics/),
+  [tooling](https://linked-data-python.readthedocs.io/en/latest/explanation/tooling/),
+  [how this is tested](https://linked-data-python.readthedocs.io/en/latest/explanation/how-it-is-tested/).
 
 Every `ldpy` and `python` block in the documentation is executed by the test
 suite, and its assertions are the test.

{linked_data_python-0.2.0 → linked_data_python-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "linked-data-python"
-version = "0.2.0"
+version = "0.2.1"
 description = "Python extended with Semantic Web primitives: IRIs, RDF literals and Turtle-notation graphs as expressions, transpiled by island parsing."
 readme = "README.md"
 license = { text = "MIT" }

{linked_data_python-0.2.0 → linked_data_python-0.2.1}/tests/test_debug.py

@@ -79,6 +79,10 @@ def test_cli_breakpoints_mode(tmp_path):
     d = json.loads(p.stdout)
     assert d["shadow"].endswith("prog.py")
     assert os.path.isfile(d["map"])
+    # absolute, because this output crosses a process boundary: an editor
+    # that turned a relative path into a URI would root it at "/"
+    assert os.path.isabs(d["shadow"]) and os.path.isabs(d["map"])
+    assert os.path.isfile(d["shadow"])
     assert d["breakpoints"]["2"] == 3
     assert d["breakpoints"]["5"] == 5    # prélude +1, effondrement du g{} -1
 

{linked_data_python-0.2.0 → linked_data_python-0.2.1}/tests/test_docstrings.py

@@ -55,3 +55,18 @@ def _missing(path):
 def test_public_api_documented(path):
     gaps = _missing(path)
     assert not gaps, "docstrings manquantes dans %s : %s" % (path, gaps)
+
+
+def test_version_comes_from_the_installed_distribution():
+    """Two copies of a version number drift, and this one did: a 0.2.0
+    install announced itself as 0.1.0.dev0 in the editor status bar."""
+    import ldpy
+    from importlib.metadata import version
+    assert ldpy.__version__ == version("linked-data-python")
+
+
+def test_probe_reports_that_same_version():
+    """`--probe` is what the VS Code status bar shows."""
+    from ldpy.debug import probe
+    import ldpy
+    assert probe()["version"] == ldpy.__version__