scitex-os 0.1.8

Host check + safe file mv — standalone module from the SciTeX ecosystem

scitex-os

Host check + safe file move helpers — zero-dep, pure stdlib.

Full Documentation · uv pip install scitex-os[all]

---

Problem and Solution

#	Problem	Solution
1	Host-specific scripts use socket.gethostname() == 'X' -- different style across every repo; no consistent error message when the check fails	scitex_os.check_host / is_host / verify_host -- single canonical helper triple; check_host and is_host return bool, verify_host calls sys.exit(1) on mismatch
2	os.rename(src, dst) breaks across filesystems -- "Invalid cross-device link" when the target is on a different mount	scitex_os.mv(src, dst) -- atomic when same filesystem, copy+unlink fallback otherwise; auto-creates parent dir

Installation

pip install scitex-os

Quick Start

import scitex_os as sxos

if sxos.is_host("compute-01"):
    sxos.mv(src, tgt)

1 Interfaces

Python API

import scitex_os as sxos

sxos.is_host("hostname")          # bool
sxos.check_host("hostname")       # bool
sxos.verify_host("hostname")      # sys.exit(1) on mismatch

sxos.mv(src, tgt)                 # shutil.move with mkdir(tgt)

Status

Standalone fork of scitex.os. Pure stdlib — zero deps. The umbrella package's scitex.os import path is preserved via a sys.modules-alias bridge.

Architecture

scitex_os/
├── _check_host.py        ← is_host / check_host / verify_host
├── _mv.py                ← `mv` (shutil.move + mkdir(target.parent))
└── __init__.py           ← public surface (zero deps beyond stdlib)

Demo

flowchart LR
    A[script.py] -->|is_host| B{hostname<br/>matches?}
    B -- yes --> C[sxos.mv src → tgt<br/>auto mkdir parent]
    B -- no --> D[skip / raise]

import scitex_os as sxos

if sxos.is_host("compute-01"):
    sxos.mv("results/run.csv", "/shared/runs/2026-05-07/run.csv")
# parent dir is auto-created; cross-filesystem moves are handled.

$ python -c "import scitex_os; print(scitex_os.is_host('laptop'))"
True

Part of SciTeX

scitex-os is part of SciTeX. Install via the umbrella with pip install scitex[os] to use as scitex.os (Python) or scitex os ... (CLI).

Four Freedoms for Research

0. The freedom to run your research anywhere — your machine, your terms.
1. The freedom to study how every step works — from raw data to final manuscript.
2. The freedom to redistribute your workflows, not just your papers.
3. The freedom to modify any module and share improvements with the community.

AGPL-3.0 — because we believe research infrastructure deserves the same freedoms as the software it runs on.

License

AGPL-3.0-only (see LICENSE).

---