rbrowser 0.1.6__py3-none-any.whl

rbrowser-0.1.6.dist-info/METADATA

@@ -0,0 +1,123 @@
+Metadata-Version: 2.4
+Name: rbrowser
+Version: 0.1.6
+Summary: Launch RBrowser with a local or remote (SSH) directory as a file server
+Author: RBrowser Team
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: flask>=2.0
+Requires-Dist: flask-cors>=4.0
+
+# RBrowser CLI
+
+Launch [RBrowser](https://rbrowser.org) with a local or remote (SSH) directory
+as a file server backend. **The frontend UI is bundled inside the wheel** —
+one `pip install` and you're ready to go (no Node.js, no extra build step).
+
+## Install
+
+```bash
+pip install rbrowser-cli
+```
+
+## Usage
+
+```bash
+# Open current directory (UI served from http://localhost:<port>)
+rbrowser open .
+
+# Open a specific directory
+rbrowser open /data/myproject
+
+# Open a remote SSH directory (requires ssh-agent or key auth)
+rbrowser open user@host:/data/myproject
+
+# Use a custom port
+rbrowser open . --port 8888
+
+# Override the bundled UI with a hosted RBrowser
+rbrowser open . --frontend https://rbrowser.org
+```
+
+The CLI prints (and auto-opens) a URL like
+`http://localhost:<port>/#/main?fileServerUrl=...`, which jumps the user
+directly to the Main view's File Explorer panel — no home-page detour.
+
+When run on a remote SSH host, the URL is printed as a Ctrl+Click hyperlink so
+you can open it from your local terminal.
+
+---
+
+## Maintainer notes (release flow)
+
+End users do **not** need to do this. To produce a wheel that ships the UI:
+
+```bash
+# One-shot: install JS deps, build frontend, build sdist + wheel
+node rbrowser-cli/scripts/build_release.mjs
+
+# Skip the npm install (faster local iterations)
+node rbrowser-cli/scripts/build_release.mjs --skip-install
+
+# Or via npm:
+npm run release:cli                 # full pipeline
+npm run build:cli-wheel             # skip-install variant
+
+# Output is in rbrowser-cli/dist/  (sdist + wheel)
+```
+
+### Publishing to PyPI via GitHub Actions
+
+The workflow [`.github/workflows/publish-rbrowser-cli.yml`](../.github/workflows/publish-rbrowser-cli.yml)
+publishes a release to PyPI using **Trusted Publishing** (OIDC — no API
+token in repo secrets). To set it up once:
+
+1. On <https://pypi.org/manage/account/publishing/>, add a _pending publisher_:
+   - PyPI project name: `rbrowser-cli`
+   - Owner: `typekey` · Repository: `rna-browser`
+   - Workflow: `publish-rbrowser-cli.yml`
+   - Environment: `pypi`
+2. In the GitHub repo Settings → Environments, create an environment named
+   `pypi` (optionally with a required reviewer).
+
+Then to release:
+
+```bash
+# One-liner: bump patch version, build, commit, tag, push.
+# (PyPI is published automatically by the GitHub Action.)
+npm run release:cli:patch        # 0.1.0 -> 0.1.1
+npm run release:cli:minor        # 0.1.0 -> 0.2.0
+npm run release:cli:major        # 0.1.0 -> 1.0.0
+
+# Or pick an explicit version (and add --push when ready):
+node rbrowser-cli/scripts/release.mjs 0.2.3 --push
+
+# Dry-run / inspect first; create the tag locally without pushing:
+node rbrowser-cli/scripts/release.mjs patch              # local tag only
+node rbrowser-cli/scripts/release.mjs patch --dry-run    # print, don't mutate
+```
+
+What `release.mjs` does:
+
+1. Resolves the new version (explicit or `patch` / `minor` / `major` bump).
+2. Verifies the working tree is clean and on `main` (override with
+   `--allow-dirty` / `--branch=…`).
+3. Rewrites `pyproject.toml`'s version.
+4. Runs the full local build (skip with `--no-build`) so you can spot any
+   issue before the tag is pushed.
+5. Commits, creates the annotated tag `rbrowser-cli-vX.Y.Z`, and (with
+   `--push`) pushes both to `origin` — which fires the publish workflow.
+
+Manual fallback (no script):
+
+```bash
+# Update version in rbrowser-cli/pyproject.toml first.
+git commit -am "chore(rbrowser-cli): release v0.1.1"
+git tag rbrowser-cli-v0.1.1
+git push origin main rbrowser-cli-v0.1.1
+```
+
+`pyproject.toml` already declares `frontend/**/*` as `package-data`, so the
+built UI is included in the wheel automatically.

rbrowser-0.1.6.dist-info/RECORD

@@ -0,0 +1,118 @@
+rbrowser_cli/__init__.py,sha256=3xrOfIhiATUWy5OndOVg3x-mtkvjyWZPfID20AbwlIw,96
+rbrowser_cli/cli.py,sha256=rZk7HtttegVT-PODCuZ0PQlLlg1HirS_33Rsuo-vEHE,4602
+rbrowser_cli/output.py,sha256=pO1P1LxLUJYBSQSfhGS3434IIZFTSDlBwIeJKUCBov8,2650
+rbrowser_cli/path_parser.py,sha256=X6Ih0ke_k8IDloOKfYtoD2aur9NwbCriZcUoQb2S83A,1637
+rbrowser_cli/server_local.py,sha256=irehyCRRYrplD0bCZ5BAJbgZA-gpo2Plqjwm2ORMgoc,7708
+rbrowser_cli/server_ssh.py,sha256=vNi3ab63joYUGDbpseysBKnMxn3WGDzKTxRsQKHvM-Q,10196
+rbrowser_cli/frontend/favicon.ico,sha256=6ICwAuKpPi_JOvgE3zKO88-OHHXyUL8E_kkHDpLkcgk,15406
+rbrowser_cli/frontend/index.html,sha256=Sm0BbWZuKI0hYMg9f4B86zF1JqmONT6_KTDdTqwLL0Y,2050
+rbrowser_cli/frontend/logo192.png,sha256=uXQVPYoVnmR1Va8zIaWR7lYCZAxtgI-aHLcPYW-l9i4,27833
+rbrowser_cli/frontend/logo512.png,sha256=P6Kodjqv2L_zxxXqyqBVzfXWvSHTU4Et4Bz4NAp6Nm0,170907
+rbrowser_cli/frontend/manifest.json,sha256=ULPYw5A68_eNhxuUVXqxT045yhkurKPSz6hjyGcnmhQ,492
+rbrowser_cli/frontend/robots.txt,sha256=kNJLw79pisHhc3OVAimMzKcq3x9WT6sF9IS4xI0crdI,67
+rbrowser_cli/frontend/assets/fonts/desyrel/desyrel.png,sha256=K9ER-UMITbERhzrfG9200YzAXIjDvjAomtRSDcj64W0,310362
+rbrowser_cli/frontend/assets/fonts/desyrel/desyrel.xml,sha256=nM9dPfjPahBBFsEsgTQ6Ole7Q-PrDL21TGMM-LVLpw4,112219
+rbrowser_cli/frontend/assets/fonts/inter/Inter-16.png,sha256=mSVRv_vl6npUcZ1DfAnzJdf4jONm5jBbHxHtDfeAx4E,7135
+rbrowser_cli/frontend/assets/fonts/inter/Inter-16.xml,sha256=q56ULkysqmFo5N8iqRiX1Qtm5we_Rnjc2OmCNhnh8Kc,10206
+rbrowser_cli/frontend/assets/fonts/inter/Inter-72.png,sha256=IGhVI2wFqWuySxdiIcCkfjyATCWFzJK6x9-RporqoLY,54482
+rbrowser_cli/frontend/assets/fonts/inter/Inter-72.xml,sha256=vssN_ja8Wn6nZtpOmM5tpyJ9zpWNn5Z3aGtKoETDGEc,10471
+rbrowser_cli/frontend/assets/fonts/inter/Inter-ExtraLightBETA.png,sha256=gJhzCfiJL1Vj4w_B1G0x1bYKNqz02UAXRIQLm0FjbEQ,55024
+rbrowser_cli/frontend/assets/fonts/inter/Inter-ExtraLightBETA.xml,sha256=5_00ZqUpW1lmlmC5rtCQmvuyehNJ3n-HgPkNyUPtfJk,40751
+rbrowser_cli/frontend/assets/fonts/inter/Inter-Light-18.png,sha256=NqE7IFzFue9p3YT49mCrKzk6W2AVkAtf-koaOi05Fxo,20320
+rbrowser_cli/frontend/assets/fonts/inter/Inter-Light-18.xml,sha256=ETVx-3Gczvxeranswx1gg5PGtwhyO6vRXE9-qOqVSvA,33672
+rbrowser_cli/frontend/assets/fonts/inter/Inter-Light-64.png,sha256=UQ53jU5DJ9u5f70TOnT5t-1SJaO346NmBKKtfzNXG5s,110597
+rbrowser_cli/frontend/assets/fonts/inter/Inter-Light-64.xml,sha256=ocfkM0PQZs0rufyYhOspVb-12Wjj4yNkEuFSVX9MJeI,40755
+rbrowser_cli/frontend/assets/fonts/inter/Inter-LightBETA-64.png,sha256=1NJav3l_PN9pQZ2mUs9E__f78e39W6ksPlVscMfg-yw,48050
+rbrowser_cli/frontend/assets/fonts/inter/Inter-LightBETA-64.xml,sha256=1p4QppskJ39ZpYicIYDt8r-9W-Jihiaf6l16Ft8IcP0,40748
+rbrowser_cli/frontend/assets/fonts/inter/Inter-LightBETA.png,sha256=GQ5BFXa4RWdm6MDpw4Wc8b1494Q8j91eqho-I6DU7zA,8113
+rbrowser_cli/frontend/assets/fonts/inter/Inter-LightBETA.xml,sha256=qMANyPz2EQSxZe69roCSPC2-_Gu7mOZM2R_5YQcUkew,32368
+rbrowser_cli/frontend/assets/fonts/inter/Inter-Regular.json,sha256=nG1jv2FIHwCRR2KQH6JiwXZxif8Cf_t42poIE7giH_8,46231
+rbrowser_cli/frontend/assets/fonts/inter/Inter-Regular.png,sha256=wudtvrs6on3NRW4N3JFaM0ZosWOxZxQFEpBlWG2V7gs,54557
+rbrowser_cli/frontend/assets/fonts/inter/Inter-Regular.xml,sha256=HzBT1NNBu00XC0jD8pttYn75Vc97fDMZ93_nO7U59cw,11342
+rbrowser_cli/frontend/assets/fonts/inter/Inter-SemiBold-64.png,sha256=7dAE-jMveS5T4KKOOe_DuuDCFhe9CzaDS2PzAPw224I,49856
+rbrowser_cli/frontend/assets/fonts/inter/Inter-SemiBold-64.xml,sha256=67-V3GPaHnhTLkwKFsLe6KSx8KGy-ZXJ8iS7YrrPlcc,41016
+rbrowser_cli/frontend/assets/fonts/inter/inter.xml,sha256=itVz72w-9rR6SJ8mtmFuCwjLTa2NlWHkmM7hzDOTaLk,46720
+rbrowser_cli/frontend/assets/fonts/inter/inter_0.png,sha256=OXD2Kn_LHUOFr2l8-1FmjROq-tDPCOHwzlMCYP-YDBQ,7736
+rbrowser_cli/frontend/assets/fonts/inter_regular/Inter-Regular.json,sha256=WzvP-YZ5FhQmPzJapRzeTggpY_hfLYADurpOLS3Z7wo,46263
+rbrowser_cli/frontend/assets/fonts/inter_regular/Inter-Regular.ttf,sha256=QNaS_OGI5EceKzy6k3vpZ4ePYxrT67vc1YdofH6-DII,411640
+rbrowser_cli/frontend/assets/fonts/inter_regular/font.0.png,sha256=sOVhK4Ork85m4qJziULPmTpyj7aHNXEhPgDogk7fTuQ,231987
+rbrowser_cli/frontend/assets/fonts/inter_regular/font.1.png,sha256=glPcOj3HsVifsmWOv5ys44R-h_AjpxQnIVtFXJz-IOk,98541
+rbrowser_cli/frontend/assets/fonts/inter_regular/font.png,sha256=FdhSaUO_dLQyuWP9q1LM86kyWAFl_4UpWr7yF_0XgmI,338241
+rbrowser_cli/frontend/assets/fonts/opensans/OpenSans-Regular.json,sha256=mejpdlaZdk_WfnlTWgH1DaECKVa9NhdGph4LYXYBaX0,32337
+rbrowser_cli/frontend/assets/fonts/opensans/OpenSans-Regular.ttf,sha256=ZTBIAnfaYu_eBH6ybnin5TLRz67skWA-aNY4drlmnw0,130832
+rbrowser_cli/frontend/assets/fonts/opensans/font.png,sha256=0R5MMt5BXtEaEVmwz_CvDFr-8FRxwVaS3MXNdvmw4Bk,232432
+rbrowser_cli/frontend/assets/g3d/genome.g3d,sha256=Zp17MaFjJtOTcPSdGPDzBGDw86qBCTgV0z8arFI8WCI,20159535
+rbrowser_cli/frontend/assets/icon/settings.svg,sha256=j04um_twsh6yS19drZLdPh_1UtzR6A9Xb33s9BhVjPE,1462
+rbrowser_cli/frontend/assets/textures/arrow_down.png,sha256=lqO0fMcMUgAjmxezt2GeD4EgHp3rj6auzI6PmsUds4I,21859
+rbrowser_cli/frontend/assets/textures/arrow_up.png,sha256=V0h5mLz5CCk6vlnnICihLsAk_biSeDjLFY_tH7Jv0OE,21839
+rbrowser_cli/frontend/assets/textures/ball_gray.png,sha256=_6ax1dwnbn_o8nJ0hWPo_nSgc_4k8ASrMUGi_zsugGg,2696
+rbrowser_cli/frontend/assets/textures/ball_gray3.png,sha256=ulC1gz8JdkmBGMxnn719O4JG-zi0C-sZz0hgR3N5A6c,2715
+rbrowser_cli/frontend/assets/textures/ball_gray_10x10.png,sha256=PUE9YuLvGIfcsv9LENHuOzarDbnSk8KVkk0y5qgnPUM,310
+rbrowser_cli/frontend/assets/textures/ball_gray_5x5.png,sha256=A-W2Z-Ng55Eb63NKy-yaZJs0CpjeMH_B8zNXo3yJpMQ,2586
+rbrowser_cli/frontend/assets/textures/ball_white_100.png,sha256=ei3U0ARayBelRbyNiM2nzVdIfIa2vS5_boEd9A-cOqw,5434
+rbrowser_cli/frontend/assets/textures/ball_white_20.png,sha256=FRVWktUYg55UyBGV1jeh0GnMr5o-6kW7141ml6oOGKs,813
+rbrowser_cli/frontend/assets/textures/ball_white_40.png,sha256=x1E3cgMpNInO7xLWYhVoBRhsUX8u4iOyV8JWMNrlX4c,2076
+rbrowser_cli/frontend/assets/textures/base_A.png,sha256=tbtT2-7t5FQPsGUIhPk4HHWLwv2Lx7c7oXE7ztb6o2g,7346
+rbrowser_cli/frontend/assets/textures/base_C.png,sha256=cHuHgU6Q2smvnIUvdF5u_Yy2VHowaDH0YjkqcgqgHfs,8569
+rbrowser_cli/frontend/assets/textures/base_G.png,sha256=wXyLwdyQjNyk_b2ey06UGCpvoB069W24JJbG4i-ibJ0,8126
+rbrowser_cli/frontend/assets/textures/base_T.png,sha256=HO3uS4tdgbxyEDET35LrMe2G0pM28D57Y2EW9BV6zjc,3325
+rbrowser_cli/frontend/assets/textures/base_U.png,sha256=ROuudXbP-RhWCJDbFewS5_kNGJVGGsUeeNWWh-phWIk,5728
+rbrowser_cli/frontend/assets/textures/circle_100.png,sha256=42AePsds1qmDBZ9jkTXmoopltMFaU04KKEz0WriSsXY,8522
+rbrowser_cli/frontend/assets/textures/circle_black_100.png,sha256=brUhIvjISB08uQEULM8fYrlFePk6Xy5wb-W50o_5p1U,8083
+rbrowser_cli/frontend/assets/textures/circle_red.png,sha256=Vu5IGGjO94gc2GCs2JXlIwRew0dTDSXNE-JMW3oAibs,10009
+rbrowser_cli/frontend/assets/textures/circle_white_100.png,sha256=LvV42J7umsisYRFEPwAXGf_ccvLszdk56AspZ6YI3aA,7886
+rbrowser_cli/frontend/assets/textures/diamond copy.png,sha256=6BFrb45G3bwldo1t7iDARyQg_1fs0969tztnd6yKhNg,371
+rbrowser_cli/frontend/assets/textures/diamond.png,sha256=sfQjuOF-KJlWwsMxQlTnQXXY1oB7rUx5UOtjJ8lC1Ww,44768
+rbrowser_cli/frontend/assets/textures/diamond2.png,sha256=w65fDZ_X7Bzs92LH5jjWL7FfRhiq1R-Y8QXLpenXhHc,314
+rbrowser_cli/frontend/assets/textures/drop.png,sha256=N3H5BGS4DfXWVs_630mVPW7boZhjzWTW_iEq8x8HJ6I,483
+rbrowser_cli/frontend/assets/textures/drop_line.png,sha256=CV5FEO2szj7n1IxzSbwRjy5x49qmhWr9Gg4Xkqsd8zU,510
+rbrowser_cli/frontend/assets/textures/ele_gray.png,sha256=eMpEUXYczH95CXOV10hPk_lHtDkpgxSinf9lbEe6Fv8,2375
+rbrowser_cli/frontend/assets/textures/ele_grays.png,sha256=MCg-ztE1oVPn_-o7vrCOvKo75jBjO2FgNg4PfIR-pBM,136
+rbrowser_cli/frontend/assets/textures/ele_green.png,sha256=LXDhhgCBONRCU1tyZ9X0-O5LuV8uHlFtDdHyrhRGbMY,2392
+rbrowser_cli/frontend/assets/textures/ele_ocean.png,sha256=fbjQhbSmYwwqcmKKuzkS53154Q1BSccZy4LvLaXpWZ4,2392
+rbrowser_cli/frontend/assets/textures/ele_red.png,sha256=FZCWx98YMEN_T4RrtgjN2cZcKAdH76e2Uue6OhWhcIM,2387
+rbrowser_cli/frontend/assets/textures/ele_sky.png,sha256=iAywvvBccAgdPNdDkn85UCXUvTFpcPrHeney21n6cqM,2389
+rbrowser_cli/frontend/assets/textures/ele_soft_gray.png,sha256=nRpSPSTRbjcDN26QnTuxgkpOWSKPHM0asw9WGQzpvfs,2382
+rbrowser_cli/frontend/assets/textures/ele_yellow.png,sha256=SY14gFNGw9MrcFloYqcDpz7Cg3TNa6BBCWQRUgebubg,2384
+rbrowser_cli/frontend/assets/textures/texture.psd,sha256=3KwOi0MVmDvdaNBb9BEhP8JgzK4TSgZr6X_S5oHtsK8,263626
+rbrowser_cli/frontend/assets/textures/texture_ATCG.psd,sha256=P-Gwlbzx5zCNrmBkU1TznBxuvwbTbYaBqeK_6nyGGUY,213792
+rbrowser_cli/frontend/assets/textures/texture_circle_org.png,sha256=Oti8CBN6ljWzvclDWg7LVfN-dIRH13M3iFE5Co6ZYbA,1810
+rbrowser_cli/frontend/assets/textures/texture_diamond.psd,sha256=rDXCw_HyaI_VBtw6sP1puj_zJhdKsoIweFZlC_dY2CA,198910
+rbrowser_cli/frontend/assets/textures/texture_grey_border_main.png,sha256=8S2BJW5KuLvFnyZCKt6bqiGXRZZWhJKCos7reDcsc8c,197
+rbrowser_cli/frontend/assets/textures/texture_grey_main.png,sha256=iWFA6H4kByM1j1oURKn9DkSsMv0kXs5rXz0EfTqJ3ZE,76028
+rbrowser_cli/frontend/assets/textures/texture_grey_main.psd,sha256=mmASZen6wDAxAy0xBHKPmgtJ_EMlIGXpaj3SXHXiVJc,82382
+rbrowser_cli/frontend/assets/textures/triangle.png,sha256=F8LqHivl9wY64ulzcQmLEb5sZ2zNylfVIJpFJ6M82FE,407
+rbrowser_cli/frontend/static/css/index.ArNRqnY1.css,sha256=w5eZSq6ZyZsoCNTaKWo7FS4f2vymiqIVLm26SPm3GlQ,112455
+rbrowser_cli/frontend/static/css/index.CroWzXsC.css,sha256=bk3AFBvJVLaohP472ymGizyaQ_o527ch2GVY7n8d5y4,5460
+rbrowser_cli/frontend/static/css/index.DPMyIVYU.css,sha256=3yLV0nT9W5t57jLDy2kNcGc9vXiIkKUgotbW6NM1GlQ,11669
+rbrowser_cli/frontend/static/js/AppstoreAddOutlined.D5ilOMxt.chunk.js,sha256=jIGy3QVU2k-3c7QCgAf60Gd-47rNl5zDktQQtyAVo8k,27363
+rbrowser_cli/frontend/static/js/CheckCircleRounded.DVZy-MCf.chunk.js,sha256=GQTJSCoJCZAe6Q-XxDij5Z8nQxuFaW0aCIC0kABQcKI,518
+rbrowser_cli/frontend/static/js/ClearAllRounded.CUJRdVDQ.chunk.js,sha256=JPiwFw-2cCz9DtzIcf_GWu9PKxeYTQhGElNHew6xMJs,1015
+rbrowser_cli/frontend/static/js/ExpandMore.C46BDO5j.chunk.js,sha256=sCJhi7iUSmi4hMU5Xh8JFYW6C9p0rq1F_aZvWo98CPk,322
+rbrowser_cli/frontend/static/js/Refresh.C83YUbTk.chunk.js,sha256=fXyIKZW2IW4MNAgq0FEot5WPcEYmdaVWG80WXp_FXls,1079
+rbrowser_cli/frontend/static/js/d3-vendor.D2vplkPo.chunk.js,sha256=ZXgyPIn13wNEwQvik4MZ1GZJ_gfCNk7IpOKjTilIMTA,71537
+rbrowser_cli/frontend/static/js/datahub-data.BkMvslYe.chunk.js,sha256=VotTJPzcPzr_Uqyt2ml_241zyXgK8A_Qje6e3leiVYc,6495833
+rbrowser_cli/frontend/static/js/index.B36BqAW0.chunk.js,sha256=Tl48boFv8niBA-YpXANmpkhpz79Iov0FIXvypuzJVgY,176
+rbrowser_cli/frontend/static/js/index.B79vQDf2.chunk.js,sha256=TTpAsaVHEPtN5Kx6GyhdlTdtKwwx2FXD3EW2sB7WMMM,180
+rbrowser_cli/frontend/static/js/index.D1QXMsT8.chunk.js,sha256=CJ31PkwVtebZKp98hu0ZOvcf_UUH44QNlVIsnx__dH0,18373
+rbrowser_cli/frontend/static/js/index.DICxSQgm.chunk.js,sha256=PCINMimMQDYF8VZXpGr4-xvQkPL9kJa0kLUWwEsqU-0,19624
+rbrowser_cli/frontend/static/js/index.DezPsQiY.chunk.js,sha256=h56O5_ZImi0RtlqOkwrmFPm65oLVfrmvz6Zls-UCELg,175
+rbrowser_cli/frontend/static/js/index.DhVVPnZF.chunk.js,sha256=bROX10jslvgRLP0LrQnOqee_5E6KIvpDuhrsQ1X6blw,2711
+rbrowser_cli/frontend/static/js/index.DpkFDdug.js,sha256=rN5kxxn66E3uqUIkQSfK1rWUoa_brv2sG91ZyeFGEzo,5414995
+rbrowser_cli/frontend/static/js/index.JBr0C4Rc.chunk.js,sha256=M9VmxmyAkt2AoUCBLoKa2yjopkRPhSPGsJ5sktJZi5c,32889
+rbrowser_cli/frontend/static/js/index.Lr6WmsZR.chunk.js,sha256=J08UvX0VNeB2Bfr3TZcArHpp1A5WwOysUFMQExRUZow,1125121
+rbrowser_cli/frontend/static/js/index.Pv0g6RaM.chunk.js,sha256=VgMcGilSeh5zgLKzjnhxTcI5vIrHSScICQphKxQvYaU,20868
+rbrowser_cli/frontend/static/js/index.WaMjEOTD.chunk.js,sha256=Y0OGdmChLqFp7pLX5Ne_a6x2Suoec7xHeWYyQN5_5nE,443226
+rbrowser_cli/frontend/static/js/index.oG4Fdp8e.chunk.js,sha256=h5P76xwif2TLlEf08DcXoYBwStRwYtPOBZ5Qdhn2Ywk,173
+rbrowser_cli/frontend/static/js/index.pFX21XGS.chunk.js,sha256=iJrFmGPUz1Ozbke_XmKbijeZar5JMiWvFI4wFrUik1s,362
+rbrowser_cli/frontend/static/js/index.qnCfw2-y.chunk.js,sha256=TEyU4WT2m2W3bfAM7A6nw38hfgyvhki36mpPFi-3yOE,177
+rbrowser_cli/frontend/static/js/mui-vendor.C2wT3-V2.chunk.js,sha256=xsADdOggWNyd80qGqqOxXrVOrkWlKnqoXANbPWqD4OA,538970
+rbrowser_cli/frontend/static/js/pixi-vendor.DwNHHdM-.chunk.js,sha256=LrwCZ80dbg6w2J02B9DKgvMRg0kUP9cxWQUmFa17tO4,545356
+rbrowser_cli/frontend/static/js/react-vendor.C018e_IG.chunk.js,sha256=zGww_42Hb3I8XbrnscR5deoSBq_uCVYrCB0RJDsvWnM,332907
+rbrowser_cli/frontend/static/js/redux-vendor.BYT4ly2K.chunk.js,sha256=P1qsAkmzmQm8fYyTtks68O7pBxYBPLxVMyNCe3ywXlg,55608
+rbrowser_cli/frontend/static/media/logo.BdaLZdU8.png,sha256=uXQVPYoVnmR1Va8zIaWR7lYCZAxtgI-aHLcPYW-l9i4,27833
+rbrowser-0.1.6.dist-info/METADATA,sha256=3wJo4u7xYyZbogM-Lq9G8s_Hm2B1CyxjKHQLqoYU7q0,3979
+rbrowser-0.1.6.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+rbrowser-0.1.6.dist-info/entry_points.txt,sha256=e_DDMn8YRILhEpxUlFOs5Isx92vXkqrTvGyhoQblKLg,51
+rbrowser-0.1.6.dist-info/top_level.txt,sha256=2DRyc1CVp4w33iomZHKDf9BaEpnbduZxeW1sqNtyQaQ,13
+rbrowser-0.1.6.dist-info/RECORD,,

rbrowser-0.1.6.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

rbrowser-0.1.6.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+rbrowser = rbrowser_cli.cli:main

rbrowser-0.1.6.dist-info/top_level.txt

@@ -0,0 +1 @@
+rbrowser_cli

rbrowser_cli/__init__.py

@@ -0,0 +1,3 @@
+"""RBrowser CLI — launch RBrowser with a local or remote directory."""
+
+__version__ = "0.1.0"

rbrowser_cli/cli.py

@@ -0,0 +1,143 @@
+"""Click CLI entry-point for ``rbrowser``."""
+
+from __future__ import annotations
+
+import socket
+import sys
+from pathlib import Path
+from urllib.parse import quote, urlencode
+
+import click
+from werkzeug.serving import make_server
+
+from .output import is_remote_session, print_banner
+from .path_parser import parse_path
+
+
+FRONTEND_FALLBACK = "https://rbrowser.org"
+_BUNDLED_FRONTEND_DIR = Path(__file__).parent / "frontend"
+
+
+def _has_bundled_frontend() -> bool:
+    return (_BUNDLED_FRONTEND_DIR / "index.html").is_file()
+
+
+def _pick_port(preferred: int) -> int:
+    """Return an available port. If ``preferred`` is 0, OS picks one."""
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        try:
+            s.bind(("0.0.0.0", preferred))
+        except OSError as e:
+            raise click.ClickException(f"Port {preferred} is not available: {e}") from e
+        return s.getsockname()[1]
+
+
+def _detect_host_for_url(is_remote_cli: bool) -> str:
+    """Pick the host the user's browser should connect to.
+
+    - When the CLI runs locally, ``localhost`` is the safest default.
+    - When the CLI runs on a remote SSH server, fall back to the externally
+      visible hostname / first non-loopback IPv4 so the user's local browser
+      can reach it (or, if SSH port-forwarding is set up, ``localhost``).
+    """
+    if not is_remote_cli:
+        return "localhost"
+    try:
+        host = socket.gethostname()
+        ip = socket.gethostbyname(host)
+        if ip and not ip.startswith("127."):
+            return host
+    except OSError:
+        pass
+    return "localhost"
+
+
+@click.group()
+@click.version_option()
+def cli() -> None:
+    """RBrowser CLI."""
+
+
+@cli.command("open")
+@click.argument("path")
+@click.option("--port", "-p", type=int, default=0, show_default=False,
+              help="Port to bind (default: random free port).")
+@click.option("--frontend", default=None,
+              help=("RBrowser frontend. Default: bundled (if installed), else "
+                    f"{FRONTEND_FALLBACK}. Pass an http(s):// URL to override."))
+@click.option("--host", default="0.0.0.0", show_default=True,
+              help="Bind address for the file server.")
+def open_cmd(path: str, port: int, frontend: str | None, host: str) -> None:
+    """Start the file server for PATH and open RBrowser.
+
+    PATH may be a local directory or ``user@host:/remote/path``.
+    """
+    parsed = parse_path(path)
+
+    # Decide frontend mode: bundled (served from this same server) vs external URL.
+    use_bundled = False
+    if frontend is None:
+        if _has_bundled_frontend():
+            use_bundled = True
+        else:
+            frontend = FRONTEND_FALLBACK
+    elif frontend.lower() in ("bundled", "local"):
+        if not _has_bundled_frontend():
+            raise click.ClickException(
+                "Bundled frontend not found. Reinstall rbrowser-cli or pass --frontend URL."
+            )
+        use_bundled = True
+
+    static_dir = str(_BUNDLED_FRONTEND_DIR) if use_bundled else None
+
+    if parsed.is_remote:
+        from .server_ssh import create_app
+        app = create_app(parsed.ssh_target, parsed.path, static_dir=static_dir)
+    else:
+        from .server_local import create_app
+        app = create_app(parsed.path, static_dir=static_dir)
+
+    bound_port = _pick_port(port) if port else _pick_port(0)
+    remote_session = is_remote_session()
+    url_host = _detect_host_for_url(remote_session)
+
+    server_url = f"http://{url_host}:{bound_port}"
+    if use_bundled:
+        # Bundled frontend: served from the same origin → only need ?root=.
+        # The frontend infers fileServerUrl from window.location.
+        qs = urlencode({"root": parsed.display()}, quote_via=quote)
+        frontend_url = f"{server_url}/#/main?{qs}"
+    else:
+        # External UI: must include fileServerUrl (different origin).
+        qs = urlencode({
+            "fileServerUrl": server_url,
+            "root": parsed.display(),
+        }, quote_via=quote)
+        frontend_url = f"{frontend.rstrip('/')}/#/main?{qs}"
+
+    print_banner(
+        server_url=server_url,
+        frontend_url=frontend_url,
+        root_display=parsed.display(),
+        is_remote=remote_session,
+        bundled=use_bundled,
+    )
+
+    server = make_server(host, bound_port, app, threaded=True)
+    try:
+        server.serve_forever()
+    except KeyboardInterrupt:
+        click.echo("\nShutting down…")
+        server.shutdown()
+
+
+def main() -> None:
+    try:
+        cli()
+    except click.ClickException as e:
+        e.show()
+        sys.exit(e.exit_code)
+
+
+if __name__ == "__main__":
+    main()