sashiny 0.1.1__tar.gz

sashiny-0.1.1/.gitignore

@@ -0,0 +1,35 @@
+# R
+.Rproj.user/
+.Rhistory
+.RData
+.Ruserdata
+*.Rcheck/
+R/*.tar.gz
+R/docs/
+renv/library/
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+# SAS / secrets
+sascfg_personal.py
+*.authinfo
+.Renviron
+.env
+# OS
+.DS_Store
+
+# testthat failure snapshots
+R/tests/testthat/_problems/
+R/tests/testthat/testthat-problems.rds
+
+# Build artifacts at repo root
+/SAShiny_*.tar.gz

sashiny-0.1.1/CHANGELOG.md

@@ -0,0 +1,73 @@
+# Changelog
+
+All notable changes to the Python library are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project uses
+[Semantic Versioning](https://semver.org/).
+
+## [0.1.1]
+
+### Fixed
+- `import sashiny` no longer requires the optional `shiny` extra. `app` and
+  `modules` are imported lazily, so the core package works with only its
+  declared dependencies.
+- SAS-literal values (quoted/dquoted text/choice, numeric, date, multichoice,
+  dataset, validated bare) are emitted without `%superq`, so `WHERE` clauses
+  work on real SAS 9.4 (issue #16). Only `raw` text/choice keeps `%superq`.
+
+### Fixed (SAS OnDemand for Academics)
+- `SaspyEngine` submits `options notes;` once per new SAS session (spec 6.1).
+  ODA starts sessions with `NONOTES`, which removed the `NOTE:` sentinels, so
+  every run was reported as an error and the program log was empty.
+- The SAS version is read from the `SXVER=` output line, not the source echo,
+  which servers like ODA include in the log (it was reported as `&sysvlong;`).
+
+## [0.1.0]
+
+### Added (live demo tests)
+- Before starting saspy, `SaspyEngine` checks that Java is available for IOM
+  connections and that `~/.authinfo` has an entry for the profile's `authkey`
+  (`sashiny.engines.saspy.preflight`). Without the second check saspy would
+  prompt for credentials on stdin, which hangs a Shiny app.
+- `tests/live` runs the demo scenarios (`examples/demo-scenarios.yml`) on real
+  SAS when `SASHINY_LIVE=1`; offline tests check the scenarios and any
+  committed recordings.
+
+### Added (live engine and result collection)
+- `SaspyEngine` runs end to end: the session starts from a generated saspy
+  configuration file, persists across runs, and is restarted after a failure.
+  Dataset inputs are uploaded with `df2sd` (spec §7) from a user file or the
+  contract's sample. Every output type is collected per spec §8.2: tables (raw or
+  SAS-formatted, with metadata and row counts), plots, HTML, scoped logs, and
+  csv/xlsx/xpt/sas7bdat/rtf/pdf downloads. A failing output becomes
+  `{"error": ...}` without affecting the others (`metadata.collect_errors`).
+- `choices_from` inputs read their choices from SAS at session start (§6.4).
+- Recordings (§8.3): `SaspyEngine(record_to=...)` / `connect(..., record_to=...)`
+  save each run; `MockEngine` replays them with the shared R/Python key and
+  reports `metadata.recording` as `"replayed"` or `"missing"`.
+- `sashiny.collect`, `sashiny.upload` and `sashiny.recording` modules;
+  `UploadFile`, `UploadError`, `load_recording` and `save_recording` exports.
+- Shiny modules render one card per contract output, apply contract defaults,
+  convert Shiny values to the contract JSON form, support file uploads with a
+  "use the sample" toggle, and offer downloads.
+- `Pool` accepts an engine factory (one SAS session per pooled session), is an
+  `Engine` itself, closes discarded sessions, and keeps sessions on input
+  validation errors.
+- Demo app: live profiles (ODA, Viya, SAS 9.4) with automatic offline fallback.
+
+### Changed
+- Output values in `Result.outputs` are the language-neutral JSON values of spec
+  §8.1 (`TableResult` and `LogLine` remain exported for compatibility).
+- `uploads=` accepts file paths, `UploadFile` objects or `True` (sample).
+
+### Fixed
+- Result metadata `contract_sha256` is now the SHA-256 of the contract YAML bytes
+  (spec §8); previously it hashed the SAS program. `Contract` gains a `path` field.
+
+### Added
+- Contract loader and validator (`sashiny.contract`).
+- Value validation and rendering (`sashiny.values`).
+- Generated SAS wrapper (`sashiny.wrapper`).
+- Mock engine with record/replay and saspy engine with connection selection
+  (`sashiny.engines`).
+- Bounded session pool (`sashiny.pool`), runner (`sashiny.run`), result object
+  (`sashiny.result`), and Shiny modules (`sashiny.modules`).

sashiny-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mehar Pratap Singh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sashiny-0.1.1/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.5
+Name: sashiny
+Version: 0.1.1
+Summary: Use unchanged SAS programs as the server of Shiny applications.
+Project-URL: Homepage, https://github.com/procogia/SAShiny
+Project-URL: Source, https://github.com/procogia/SAShiny/tree/main/Python
+Project-URL: Issues, https://github.com/procogia/SAShiny/issues
+Author-email: Mehar Pratap Singh <meharpsingh@gmail.com>
+Maintainer: Shreya Sharma, Love ProCogia, Igor ProCogia, Ahmer Khan
+Maintainer-email: Mehar Pratap Singh <meharpsingh@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: aml,clinical,dashboard,sas,saspy,shiny,viya
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: jsonschema>=4.18
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.13; extra == 'dev'
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Provides-Extra: saspy
+Requires-Dist: saspy>=5.100; extra == 'saspy'
+Provides-Extra: shiny
+Requires-Dist: shiny>=1.0; extra == 'shiny'
+Provides-Extra: upload
+Requires-Dist: openpyxl>=3.1; extra == 'upload'
+Requires-Dist: pandas>=2.0; extra == 'upload'
+Requires-Dist: pyreadstat>=1.2; extra == 'upload'
+Description-Content-Type: text/markdown
+
+# SAShiny (Python)
+
+Python library for SAShiny. Use an unchanged SAS program as the server of a Shiny for Python app.
+
+> Status: pre-alpha. The contract is specified in
+> [`spec/CONTRACT.md`](https://github.com/procogia/SAShiny/blob/main/spec/CONTRACT.md).
+
+```sh
+# development version (repository is private until the first release)
+uv pip install "git+https://github.com/procogia/SAShiny#subdirectory=Python"
+```
+
+SAS is a registered trademark of SAS Institute Inc. Shiny is a registered trademark of Posit
+Software, PBC. This project is not affiliated with or endorsed by either company.

sashiny-0.1.1/README.md

@@ -0,0 +1,14 @@
+# SAShiny (Python)
+
+Python library for SAShiny. Use an unchanged SAS program as the server of a Shiny for Python app.
+
+> Status: pre-alpha. The contract is specified in
+> [`spec/CONTRACT.md`](https://github.com/procogia/SAShiny/blob/main/spec/CONTRACT.md).
+
+```sh
+# development version (repository is private until the first release)
+uv pip install "git+https://github.com/procogia/SAShiny#subdirectory=Python"
+```
+
+SAS is a registered trademark of SAS Institute Inc. Shiny is a registered trademark of Posit
+Software, PBC. This project is not affiliated with or endorsed by either company.

sashiny-0.1.1/pyproject.toml

@@ -0,0 +1,98 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "sashiny"
+dynamic = ["version"]
+description = "Use unchanged SAS programs as the server of Shiny applications."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Mehar Pratap Singh", email = "meharpsingh@gmail.com" }]
+maintainers = [
+  { name = "Mehar Pratap Singh", email = "meharpsingh@gmail.com" },
+  { name = "Shreya Sharma" },
+  { name = "Love ProCogia" },
+  { name = "Igor ProCogia" },
+  { name = "Ahmer Khan" },
+]
+keywords = ["sas", "shiny", "saspy", "viya", "dashboard", "clinical", "aml"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Intended Audience :: Science/Research",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Scientific/Engineering :: Information Analysis",
+  "Typing :: Typed",
+]
+dependencies = [
+  "jsonschema>=4.18",
+  "pyyaml>=6.0",
+]
+
+[project.optional-dependencies]
+saspy = ["saspy>=5.100"]
+shiny = ["shiny>=1.0"]
+upload = ["pandas>=2.0", "openpyxl>=3.1", "pyreadstat>=1.2"]
+dev = ["pytest>=8", "pytest-cov>=5", "ruff>=0.8", "mypy>=1.13"]
+
+[project.urls]
+Homepage = "https://github.com/procogia/SAShiny"
+Source = "https://github.com/procogia/SAShiny/tree/main/Python"
+Issues = "https://github.com/procogia/SAShiny/issues"
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "pytest-cov>=5",
+    "ruff>=0.8",
+    "mypy>=1.13",
+    "shiny>=1.9.0",
+    "pandas>=2.0",
+    "openpyxl>=3.1",
+    "pyreadstat>=1.2",
+]
+
+[tool.hatch.version]
+path = "src/sashiny/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/sashiny"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/sashiny", "tests", "README.md", "LICENSE", "CHANGELOG.md"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "W", "F", "I", "UP", "B", "SIM", "C4", "RUF", "D", "S", "PT", "PL"]
+ignore = ["D203", "D213"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["D", "S101", "PLR2004"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+files = ["src"]
+
+[[tool.mypy.overrides]]
+module = ["yaml", "jsonschema", "saspy", "pandas"]
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["tests"]
+addopts = ["--strict-markers", "--strict-config", "-ra"]
+markers = ["live: needs a real SAS session (SASHINY_LIVE=1); see tests/live/conftest.py"]

sashiny-0.1.1/src/sashiny/__init__.py

@@ -0,0 +1,68 @@
+"""SAShiny: use unchanged SAS programs as the server of Shiny applications.
+
+SAS is a registered trademark of SAS Institute Inc. Shiny is a registered
+trademark of Posit Software, PBC. This project is not affiliated with or
+endorsed by either company.
+"""
+
+from typing import Any
+
+from .contract import Contract, Issue, load, validate
+from .engines import Engine, MockEngine, SaspyEngine, connect, load_profiles
+from .lint import lint
+from .pool import Pool
+from .recording import load_recording, save_recording
+from .result import LogLine, Result, TableResult
+from .run import run
+from .upload import UploadError, UploadFile
+from .values import render_values
+from .wrapper import reset_code, wrapper_code
+
+__all__ = [
+    "Contract",
+    "Engine",
+    "Issue",
+    "LogLine",
+    "MockEngine",
+    "Pool",
+    "Result",
+    "SaspyEngine",
+    "TableResult",
+    "UploadError",
+    "UploadFile",
+    "__version__",
+    "app",
+    "connect",
+    "lint",
+    "load",
+    "load_profiles",
+    "load_recording",
+    "render_values",
+    "reset_code",
+    "run",
+    "save_recording",
+    "validate",
+    "wrapper_code",
+]
+
+__version__ = "0.1.1"
+
+
+def __getattr__(name: str) -> Any:
+    """Lazily expose ``app`` and ``modules``, which need the optional ``shiny``.
+
+    The core package must import without ``shiny`` installed (it is an optional
+    extra). ``app`` and ``modules`` are only imported when first accessed.
+    """
+    if name == "app":
+        from .app import app as _app  # noqa: PLC0415 - optional dependency
+
+        globals()["app"] = _app
+        return _app
+    if name == "modules":
+        from importlib import import_module  # noqa: PLC0415 - optional dependency
+
+        _modules = import_module(f"{__name__}.modules")
+        globals()["modules"] = _modules
+        return _modules
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")