nuverse 0.1.0__tar.gz

nuverse-0.1.0/.gitignore

@@ -0,0 +1,99 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# uv
+uv.lock
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# IDEs
+.idea/
+.vscode/
+
+.DS_Store
+
+# Profiling
+*.prof
+*.lprof
+
+# Benchmarking
+benchmark_results/
+*.benchmark
+*.benchmarks
+
+# Ruff
+.ruff_cache/
+
+# Misc
+/*playground
+.db*/
+.state*/
+.logs*/
+
+# syncthing
+.stfolder
+
+# nuspace-ui (vite / node)
+node_modules/
+!src/nuspace/web/ui/dist/
+src/nuspace/web/ui/dist/*
+!src/nuspace/web/ui/dist/.gitkeep
+
+*.db/
+# local archive of the v0 prototype (reference only, never edited)
+_archive/

nuverse-0.1.0/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.5
+Name: nuverse
+Version: 0.1.0
+Summary: nuspace extensions: the apps and snippets a space offers out of the box.
+Project-URL: Repository, https://github.com/nustackdev/nuspace
+Author-email: Gor Arakelyan <gorarkln@gmail.com>
+License-Expression: AGPL-3.0-or-later
+Requires-Python: >=3.10
+Requires-Dist: nuspace
+Description-Content-Type: text/markdown
+
+# nuverse
+
+The extensions a [nuspace](https://github.com/nustackdev/nuspace) space offers out of the box: the apps `+` makes and the snippets `/` inserts.
+
+nuspace finds it on install through the `nuspace.extensions` entry point. You don't import it yourself.
+
+```
+pip install nuspace
+```
+
+Early. It tracks nuspace's unreleased v4 and needs it to be useful.

nuverse-0.1.0/README.md

@@ -0,0 +1,11 @@
+# nuverse
+
+The extensions a [nuspace](https://github.com/nustackdev/nuspace) space offers out of the box: the apps `+` makes and the snippets `/` inserts.
+
+nuspace finds it on install through the `nuspace.extensions` entry point. You don't import it yourself.
+
+```
+pip install nuspace
+```
+
+Early. It tracks nuspace's unreleased v4 and needs it to be useful.

nuverse-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "nuverse"
+version = "0.1.0"
+description = "nuspace extensions: the apps and snippets a space offers out of the box."
+readme = "README.md"
+license = "AGPL-3.0-or-later"
+authors = [{ name = "Gor Arakelyan", email = "gorarkln@gmail.com" }]
+requires-python = ">=3.10"
+dependencies = [
+    # nuverse imports nuspace, nuspace never imports nuverse: it finds this
+    # package through the entry point below, the same one a third party uses.
+    "nuspace",
+]
+
+[project.urls]
+Repository = "https://github.com/nustackdev/nuspace"
+
+[project.entry-points."nuspace.extensions"]
+nuverse = "nuverse:extension"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/nuverse"]
+
+[tool.uv.sources]
+nuspace = { workspace = true }

nuverse-0.1.0/src/nuverse/__init__.py

@@ -0,0 +1,31 @@
+"""nuverse: the extensions a space offers out of the box.
+
+- :mod:`.apps`: what ``+`` makes: ``page``, and later ``job``, ``chat``.
+- :mod:`.snippets`: what ``/`` inserts: ``prose``, ``program``, ``ticker``,
+  and later ``heading``, ``monaco``.
+
+nuspace finds this package through the ``nuspace.extensions`` entry point,
+which names :func:`extension`. Nothing is imported here at module scope:
+workers import cell programs, and a program never needs the registry.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+
+if TYPE_CHECKING:
+    from nuspace import Extension
+
+
+__all__ = ["extension"]
+
+
+def extension() -> Extension:
+    """Every nuverse app and snippet, as one extension."""
+    from nuspace import Extension
+
+    from .apps import APPS
+    from .snippets import SNIPPETS
+
+    return Extension(apps=APPS, snippets=SNIPPETS, envs={})

nuverse-0.1.0/src/nuverse/apps/__init__.py

@@ -0,0 +1,16 @@
+"""The apps ``+`` makes, one module each.
+
+Every module defines ``APP``: an :class:`~nuspace.App`, or None while it is
+still a placeholder, which is left out.
+"""
+
+from __future__ import annotations
+
+from . import chat, job, page
+
+
+__all__ = ["APPS"]
+
+
+#: Every app ready to register, in picker order.
+APPS = tuple(module.APP for module in (page, job, chat) if module.APP is not None)

nuverse-0.1.0/src/nuverse/apps/chat.py

@@ -0,0 +1,19 @@
+"""The ``chat`` app. Placeholder.
+
+TODO: another agent fills this in. Until then ``APP`` is None and the app is
+left out of :data:`nuverse.apps.APPS`.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+
+if TYPE_CHECKING:
+    from nuspace import App
+
+
+__all__ = ["APP"]
+
+
+APP: App | None = None

nuverse-0.1.0/src/nuverse/apps/job.py

@@ -0,0 +1,19 @@
+"""The ``job`` app. Placeholder.
+
+TODO: another agent fills this in. Until then ``APP`` is None and the app is
+left out of :data:`nuverse.apps.APPS`.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+
+if TYPE_CHECKING:
+    from nuspace import App
+
+
+__all__ = ["APP"]
+
+
+APP: App | None = None

nuverse-0.1.0/src/nuverse/apps/page.py

@@ -0,0 +1,26 @@
+"""The ``page`` app: a plane of cells the sidebar lists under Pages."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from nuspace import App, ops
+
+
+if TYPE_CHECKING:
+    import nu
+
+
+__all__ = ["APP", "page"]
+
+
+#: What the page app marks its planes with: drawn, listed, editable.
+META = {"ui": True, "made_by": "page", "editable": True}
+
+
+def page(plane_id: nu.StrArg | None = None, name: nu.StrArg = "") -> nu.Nu:
+    """A page plane. Yields its id, as :func:`~nuspace.ops.add_plane` does."""
+    return ops.add_plane(plane_id, name=name, meta=META)
+
+
+APP = App("page", "Pages", page, description="A plane of cells.")

nuverse-0.1.0/src/nuverse/snippets/__init__.py

@@ -0,0 +1,21 @@
+"""The snippets ``/`` inserts, one module each.
+
+Every module defines ``SOURCE``, the cell's prog, and ``SNIPPET``: a
+:class:`~nuspace.Snippet` over it, or None while it is still a placeholder,
+which is left out.
+"""
+
+from __future__ import annotations
+
+from . import heading, monaco, program, prose, ticker
+
+
+__all__ = ["SNIPPETS"]
+
+
+#: Every snippet ready to register, in menu order.
+SNIPPETS = tuple(
+    module.SNIPPET
+    for module in (prose, heading, program, ticker, monaco)
+    if module.SNIPPET is not None
+)

nuverse-0.1.0/src/nuverse/snippets/heading.py

@@ -0,0 +1,22 @@
+"""The ``heading`` snippet. Placeholder.
+
+TODO: another agent fills this in. Until then ``SOURCE`` is empty,
+``SNIPPET`` is None and the snippet is left out of
+:data:`nuverse.snippets.SNIPPETS`.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+
+if TYPE_CHECKING:
+    from nuspace import Snippet
+
+
+__all__ = ["SNIPPET", "SOURCE"]
+
+
+SOURCE = ""
+
+SNIPPET: Snippet | None = None

nuverse-0.1.0/src/nuverse/snippets/monaco.py

@@ -0,0 +1,22 @@
+"""The ``monaco`` snippet. Placeholder.
+
+TODO: another agent fills this in. Until then ``SOURCE`` is empty,
+``SNIPPET`` is None and the snippet is left out of
+:data:`nuverse.snippets.SNIPPETS`.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+
+if TYPE_CHECKING:
+    from nuspace import Snippet
+
+
+__all__ = ["SNIPPET", "SOURCE"]
+
+
+SOURCE = ""
+
+SNIPPET: Snippet | None = None

nuverse-0.1.0/src/nuverse/snippets/program.py

@@ -0,0 +1,29 @@
+"""The ``program`` snippet: what a fresh code cell starts as.
+
+One key in its own state, then done.
+"""
+
+from __future__ import annotations
+
+from nuspace import Snippet
+
+
+__all__ = ["SNIPPET", "SOURCE"]
+
+
+SOURCE = """\
+import nu
+import nustd.kv
+import nuspace
+
+
+class Note(nuspace.CellState):
+    hello = nustd.kv.StrRef.slot()
+
+
+def out():
+    # Bare state: the kernel lands it under this cell, whichever it is.
+    return Note.hello.set(nu.Str("world"))
+"""
+
+SNIPPET = Snippet("program", "Program", SOURCE)

nuverse-0.1.0/src/nuverse/snippets/prose.py

@@ -0,0 +1,44 @@
+"""The ``prose`` snippet: a document cell.
+
+One prose surface over a string in its own state, synced both ways. Every
+prose cell holds exactly this prog, and that is how the viewer tells one
+apart: what the person wrote lives in the state, not here.
+"""
+
+from __future__ import annotations
+
+from nuspace import Snippet
+
+
+__all__ = ["SNIPPET", "SOURCE"]
+
+
+SOURCE = """\
+import nu
+import nustd.kv
+import nustd.ui
+import nuspace
+
+
+class Doc(nuspace.CellState):
+    text = nustd.kv.StrRef.slot()
+
+
+def out():
+    body = nustd.ui.ProseRef("text")
+    held = nu.If(Doc.text.exists(), nu.ToStr(Doc.text), nu.Str(""))
+    return (
+        body.set(held)
+        >> body.set_placeholder(nu.Str("Write, or press / for blocks"))
+        >> nu.ParallelAsync(
+            # This tab typed: keep it. Every other tab on the plane hears it
+            # through the store.
+            nu.ReactForever(body.on_change(), Doc.text.set(nu.Str(body))),
+            # Somebody else typed: show it. The echo back to the author is a
+            # no-op, the text is already what it says.
+            nu.ReactForever(Doc.text.on_change(), body.set(nu.ToStr(Doc.text))),
+        )
+    )
+"""
+
+SNIPPET = Snippet("prose", "Text", SOURCE)

nuverse-0.1.0/src/nuverse/snippets/ticker.py

@@ -0,0 +1,33 @@
+"""The ``ticker`` snippet: a cell that draws.
+
+One stat tile, and a count kept in its own state, one a second while the
+plane is up.
+"""
+
+from __future__ import annotations
+
+from nuspace import Snippet
+
+
+__all__ = ["SNIPPET", "SOURCE"]
+
+
+SOURCE = """\
+import nu
+import nustd.kv
+import nustd.ui
+import nuspace
+
+
+class Tick(nuspace.CellState):
+    n = nustd.kv.IntRef.slot()
+
+
+def out():
+    tile = nustd.ui.StatRef("seconds")
+    now = nu.If(Tick.n.exists(), nu.Int(nu.ToInt(Tick.n)), nu.Int(0))
+    step = Tick.n.set(now + nu.Int(1)) >> tile.set_value(nu.ToStr(Tick.n))
+    return tile.set_label("seconds this plane was open") >> nu.ForeverDo(nu.DelayedDo(1.0, step))
+"""
+
+SNIPPET = Snippet("ticker", "Ticker", SOURCE)