ibridgesgui 2.1.2__tar.gz → 2.2.0__tar.gz

{ibridgesgui-2.1.2 → ibridgesgui-2.2.0}/.github/workflows/linter.yml

@@ -12,6 +12,7 @@ on:
       - 'docs/**'
       - 'README.md'
       - '_quarto.yml'
+      - '_styles/**'
       - 'index.qmd'
       
   pull_request:
@@ -19,6 +20,7 @@ on:
       - 'docs/**'
       - 'README.md'
       - '_quarto.yml'
+      - '_styles/**'
       - 'index.qmd'
 
 jobs:
@@ -27,7 +29,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest]
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
         include:
           - os: windows-latest
             python-version: "3.12"
@@ -36,10 +38,10 @@ jobs:
     runs-on: ${{ matrix.os }}
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
 
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
 

{ibridgesgui-2.1.2 → ibridgesgui-2.2.0}/.github/workflows/publish.yml

@@ -12,7 +12,7 @@ jobs:
       contents: write
     steps:
       - name: Check out repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Set up Quarto
         uses: quarto-dev/quarto-actions/setup@v2

{ibridgesgui-2.1.2 → ibridgesgui-2.2.0}/.github/workflows/pypi_release.yml

@@ -24,9 +24,9 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
     - name: Set up Python
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: '3.x'
     - name: Install dependencies
@@ -36,7 +36,7 @@ jobs:
     - name: Build package
       run: python -m build
     - name: Publish package
-      uses: pypa/gh-action-pypi-publish@v1.12.4 
+      uses: pypa/gh-action-pypi-publish@release/v1
       with:
         user: __token__
         password: ${{ secrets.PYPI_API_TOKEN }}

{ibridgesgui-2.1.2 → ibridgesgui-2.2.0}/.github/workflows/tests.yml

@@ -3,7 +3,19 @@ name: Tests
 on:
   push:
     branches: [main, develop]
+    paths-ignore:
+      - 'docs/**'
+      - 'README.md'
+      - '_quarto.yml'
+      - '_styles/**'
+      - 'index.qmd'
   pull_request:
+    paths-ignore:
+      - 'docs/**'
+      - 'README.md'
+      - '_quarto.yml'
+      - '_styles/**'
+      - 'index.qmd'
 
 permissions:
   contents: write
@@ -14,23 +26,21 @@ jobs:
       fail-fast: true
       matrix:
         os: [ubuntu-latest]
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
         include:
           - os: macos-latest
             python-version: "3.13"
     runs-on: ${{ matrix.os }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
 
-      # -----------------------------
       # Linux-only Qt dependencies
-      # -----------------------------
       - name: Install Qt system dependencies (Linux)
         if: runner.os == 'Linux'
         run: |
@@ -48,18 +58,14 @@ jobs:
             libxcb-xfixes0 \
             xvfb
 
-      # -----------------------------
-      # Install Python dependencies
-      # -----------------------------
+
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
           python -m pip install .[test]
           python -m pip install pytest pytest-cov
 
-      # -----------------------------
       # Set Qt to offscreen mode
-      # -----------------------------
       - name: Configure Qt for headless mode
         run: |
           echo "QT_QPA_PLATFORM=offscreen" >> $GITHUB_ENV
@@ -69,9 +75,7 @@ jobs:
           echo "QT_QPA_PLATFORM=offscreen" >> $GITHUB_ENV
           echo "QT_MAC_WANTS_LAYER=1" >> $GITHUB_ENV
 
-      # -----------------------------
-      # Run tests 
-      # -----------------------------
+
       - name: Run tests and coverage
         run: |
             python -m pytest --cov=ibridgesgui --cov-report=xml --cov-report=term-missing --cov-fail-under=70 tests

{ibridgesgui-2.1.2 → ibridgesgui-2.2.0}/.gitignore

@@ -141,3 +141,7 @@ dmypy.json
 .pyre/
 
 /.quarto/
+_html/
+_site/
+
+**/*.quarto_ipynb

{ibridgesgui-2.1.2 → ibridgesgui-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ibridgesgui
-Version: 2.1.2
+Version: 2.2.0
 Summary: Graphical user interface for accessing data and metadata on iRODS servers.
 Author-email: Christine Staiger <c.staiger@uu.nl>
 License:                   GNU LESSER GENERAL PUBLIC LICENSE
@@ -512,17 +512,18 @@ Project-URL: GitHub, https://github.com/chStaiger/iBridges-Gui
 Project-URL: documentation, https://github.com/chStaiger/iBridges-Gui
 Keywords: irods,data management,storage
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 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: Programming Language :: Python :: 3.14
 Classifier: Development Status :: 3 - Alpha
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: PySide6>=6.8.1
-Requires-Dist: ibridges<2.2,>=2.1.0
-Requires-Dist: setproctitle==1.3.7
+Requires-Dist: ibridges<2.3,>=2.2.0
+Requires-Dist: setproctitle==1.3.8
 Requires-Dist: importlib-resources; python_version <= "3.10"
 Requires-Dist: jsonschema
 Provides-Extra: test

ibridgesgui-2.2.0/_quarto.yml

@@ -0,0 +1,41 @@
+project:
+  type: website
+  output-dir: ./_html
+
+website:
+  title: "iBridges GUI"
+  navbar:
+    title: false
+    logo: docs/screenshots/logo.png
+    left:
+      - href: index.qmd
+        text: Home
+      - href: docs/info.qmd
+        text: What is iBridges-Gui?
+      - href: docs/getting-started.qmd
+        text: Getting started
+      - href: docs/userdoc.qmd
+        text: Documentation
+      - href: docs/developers.qmd
+        text: Contributing to iBridges
+      - href: docs/faq.qmd
+        text: FAQ
+    tools:
+      - icon: github
+        menu:
+          - text: Source Code
+            url: https://github.com/iBridges-for-iRODS/iBridges-GUI
+          - text: Report and Issue
+            url: https://github.com/iBridges-for-iRODS/iBridges-GUI/issues
+format:
+  html:
+    theme: flatly
+    css: 
+      - _styles/ibridges.css
+      - _styles/hyperlinks.css
+      - _styles/toc.css
+      - _styles/callouts.css
+      - _styles/code.css
+      - _styles/navbar.css
+      - _styles/search_icon.css
+    toc: true

ibridgesgui-2.2.0/_styles/callouts.css

@@ -0,0 +1,39 @@
+/* Base header override */
+.callout-header {
+  background-color: #a8e3d7 !important;
+}
+
+/* Note callout */
+.callout.callout-note {
+  border-left-color: #548641 !important;
+}
+
+/* Warning callout */
+.callout.callout-warning {
+  border-left-color: #E67E22 !important;
+}
+
+/* ----------------------------------------------------------
+   TIP CALLOUT — iBridges style
+   ---------------------------------------------------------- */
+
+/* Main accent colour */
+.callout.callout-tip {
+  border-left-color: #15a589 !important;
+}
+
+/* Lighter background (15a589 → lighten by ~35%) */
+.callout.callout-tip .callout-header {
+  background-color: #c8efe6 !important;  /* soft mint */
+  color: #0f7f68 !important;             /* darker accent for text */
+}
+
+/* Icon in main accent colour */
+.callout.callout-tip .callout-icon svg {
+  fill: #15a589 !important;
+}
+
+/* Body text in accent colour */
+.callout.callout-tip .callout-body {
+  color: #0f7f68 !important;
+}

ibridgesgui-2.2.0/_styles/code.css

@@ -0,0 +1,6 @@
+/* Code text color override */
+code,
+pre code,
+.reveal pre code {
+  color: #15a589 !important;
+}

ibridgesgui-2.2.0/_styles/hyperlinks.css

@@ -0,0 +1,24 @@
+/* Default link color (brand green) */
+#quarto-content a {
+  color: #58585a !important;
+  font-weight: normal;
+  text-decoration: none;
+}
+
+/* Hover: bold + darker green */
+#quarto-content a:hover {
+  color: #58585a !important;   /* darker shade derived from #528641 */
+  font-weight: bold;
+  text-decoration: underline;  /* remove if you prefer no underline */
+}
+
+/* Active (clicked) */
+#quarto-content a:active {
+  color: #58585a !important;
+  font-weight: bold;
+}
+
+/* Visited links (keep consistent) */
+#quarto-content a:visited {
+  color: #58585a !important;
+}

ibridgesgui-2.2.0/_styles/ibridges.css

@@ -0,0 +1,127 @@
+/*-- scss:defaults --*/
+
+/* Fonts */
+@import url('https://fonts.googleapis.com/css?family=Merriweather:wght@300&family=Open+Sans&display=swap');
+@import url('https://fonts.googleapis.com/css2?family=Nunito:wght@300;800&display=swap');
+
+$font-family-sans-serif: 'Nunito', Tahoma, sans-serif !default;
+
+/* Headings */
+$presentation-heading-font: 'Merriweather', Tahoma, sans-serif !default;
+$presentation-heading-color: #000000 !default;
+$h1-font-size: 3.0em !default;
+$h2-font-size: 2.7em !default;
+$h3-font-size: 2.15em !default;
+
+/*-- scss:rules --*/
+
+/* Title slide h1 */
+section.slide h1 {
+  margin-left: 5vw;
+}
+
+/* Section headings */
+section.slide h2 {
+  color: black !important;
+  background-color: #d3d3d3 !important;
+  width: 100%;
+  position: relative;
+  left: -30vw;
+
+  padding-left: 20vw;
+  padding-right: 20vw;
+  padding-top: 5px;
+  padding-bottom: 10px;
+  margin-left: 5vw;
+
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+}
+
+/* Theme section blocks */
+.theme-section {
+  text-align: left;
+  margin-top: 1.2em;
+  margin-left: 5vw;
+}
+
+/* Code blocks */
+.reveal pre code {
+  background-color: #FFFFFF;
+  font-size: 0.8em;
+  padding: 0.4em;
+  margin: 0.2em;
+}
+
+.cell {
+  margin: 1em;
+}
+
+/* Subtitle + author */
+.subtitle,
+.author {
+  color: #000000;
+  font-size: $h2-font-size;
+  font-family: $presentation-heading-font;
+}
+
+/* Footer */
+.reveal .footer {
+  color: #000000;
+  font-family: $presentation-heading-font;
+}
+
+/* Slide numbers */
+.reveal .slide-number {
+  font-family: $presentation-heading-font;
+}
+
+.slide-number {
+  bottom: 10px !important;
+  right: 10px !important;
+  top: unset !important;
+  color: #000000 !important;
+}
+
+/* Lists */
+.reveal li {
+  padding: 10px;
+}
+
+/* Center helper */
+.center-x {
+  text-align: center;
+}
+
+/* Dark background links */
+section.has-dark-background a,
+section.has-dark-background a:hover {
+  color: #d3d3d3;
+}
+
+.reveal .controls {
+  color: #15a588 !important;
+}
+
+.reveal .controls button {
+  color: #15a588 !important;
+  opacity: 1 !important; /* ensures they don’t fade */
+}
+
+.reveal .progress span {
+  background-color: #15a588 !important;
+}
+
+a,
+a:visited {
+  color: #15a588 !important;
+}
+
+a:hover,
+a:focus {
+  color: #0f7f68 !important; /* slightly darker hover */
+}
+.navbar {
+  background-color: #c8efe6 !important;
+}

ibridgesgui-2.2.0/_styles/navbar.css

@@ -0,0 +1,13 @@
+.navbar {
+  background-color: #c8efe6 !important;
+}
+/* Move tools to the left side */
+.quarto-navbar-tools {
+  order: -1 !important;
+  margin-right: 1rem !important;
+}
+
+.navbar-nav.ms-auto {
+  margin-left: auto !important; /* keep right menu spacing intact */
+}
+

ibridgesgui-2.2.0/_styles/search_icon.css

@@ -0,0 +1,13 @@
+/* Ultimate override for Quarto search icon */
+.navbar button.quarto-search-button svg,
+.navbar button.quarto-search-button svg *,
+.navbar .quarto-search-icon,
+.navbar .quarto-search-icon *,
+.navbar svg[role="img"],
+.navbar svg[role="img"] *,
+.navbar svg,
+.navbar svg * {
+  fill: #15a589 !important;
+  stroke: #15a589 !important;
+  color: #15a589 !important;
+}

ibridgesgui-2.2.0/_styles/toc.css

@@ -0,0 +1,44 @@
+/* Default TOC text (black) */
+#quarto-margin-sidebar #TOC .nav-link {
+  color: #000000 !important;
+}
+
+/* Hover state (your green) */
+#quarto-margin-sidebar #TOC .nav-link:hover {
+  color: #15a588 !important;
+}
+
+/* Active section (your green) */
+#quarto-margin-sidebar #TOC .nav-link.active {
+  color: #15a588 !important;
+  font-weight: 600;
+}
+
+/* Override Bootstrap link variables inside this TOC only */
+#quarto-margin-sidebar #TOC {
+  --bs-link-color: #000000;
+  --bs-link-hover-color: #15a588;
+  --bs-link-active-color: #15a588;
+}
+
+/* 1. Restore the original light gray left border for ALL TOC items */
+#quarto-margin-sidebar #TOC .nav-link {
+  border-left: 1px solid #dee2e6 !important;  /* original Quarto/Cosmo gray */
+  box-shadow: none !important;               /* remove Cosmo's blue shadow */
+}
+
+/* 2. Hover: green bar */
+#quarto-margin-sidebar #TOC .nav-link:hover {
+  border-left: 2px solid #15a588 !important;
+}
+
+/* 3. Active (but NOT the first item): green bar */
+#quarto-margin-sidebar #TOC ul > li:not(:first-child) > .nav-link.active {
+  border-left: 2px solid #15a588 !important;
+}
+
+/* 4. First item active: keep the light gray line, no green, no blue */
+#quarto-margin-sidebar #TOC ul > li:first-child > .nav-link.active {
+  border-left: 1px solid #dee2e6 !important;  /* restore gray */
+  box-shadow: none !important;                /* kill Cosmo's blue shadow */
+}

{ibridgesgui-2.1.2 → ibridgesgui-2.2.0}/coverage.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="114" height="20" role="img" aria-label="coverage: 83.18%"><title>coverage: 83.18%</title><filter id="blur"><feGaussianBlur stdDeviation="16"/></filter><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="114" height="20" rx="3"/></clipPath><g clip-path="url(#r)"><rect width="61" height="20" fill="#555"/><rect x="61" width="53" height="20" fill="#67ac09"/><rect width="114" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="315" y="150" fill-opacity=".8" filter="url(#blur)" textLength="510">coverage</text><text x="315" y="150" fill-opacity=".3" textLength="510">coverage</text></g><text x="315" y="140" textLength="510">coverage</text></g><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="865" y="150" fill-opacity=".8" filter="url(#blur)" textLength="430">83.18%</text><text x="865" y="150" fill-opacity=".3" textLength="430">83.18%</text></g><text x="865" y="140" textLength="430">83.18%</text></g></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="114" height="20" role="img" aria-label="coverage: 84.04%"><title>coverage: 84.04%</title><filter id="blur"><feGaussianBlur stdDeviation="16"/></filter><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="114" height="20" rx="3"/></clipPath><g clip-path="url(#r)"><rect width="61" height="20" fill="#555"/><rect x="61" width="53" height="20" fill="#67ac09"/><rect width="114" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="315" y="150" fill-opacity=".8" filter="url(#blur)" textLength="510">coverage</text><text x="315" y="150" fill-opacity=".3" textLength="510">coverage</text></g><text x="315" y="140" textLength="510">coverage</text></g><g transform="scale(.1)"><g aria-hidden="true" fill="#010101"><text x="865" y="150" fill-opacity=".8" filter="url(#blur)" textLength="430">84.04%</text><text x="865" y="150" fill-opacity=".3" textLength="430">84.04%</text></g><text x="865" y="140" textLength="430">84.04%</text></g></g></svg>

ibridgesgui-2.2.0/docs/developers.qmd

@@ -0,0 +1,127 @@
+---
+title: "Developer Guide"
+format:
+  html:
+    toc: true
+    toc-location: right
+---
+
+## Extending iBridges‑GUI {#extending-ibridges-gui}
+
+iBridges‑GUI supports a modular plugin system that allows developers to add new functionality through custom tabs.  
+Your plugin is automatically detected and integrated into the main application at runtime.
+
+A minimal example and template structure are available in the  
+**[plugin example repository](https://github.com/iBridges-for-iRODS/ibridges-gui-tab-example)**.
+
+## Contributing {#contributing}
+
+iBridges‑GUI is an open‑source project, and we welcome contributions of all kinds — from bug reports and feature ideas to full pull requests.
+
+Main repository:  
+**[iBridges‑GUI on GitHub](https://github.com/iBridges-for-iRODS/iBridges-GUI)**
+
+### Contribution workflow
+
+1. Fork the repository  
+2. Create a feature branch from `develop`  
+3. Implement your changes  
+4. Submit a pull request back to `develop`
+
+This workflow helps us review changes efficiently and maintain a clean development history.
+
+## Code structure overview {#code-structure-overview}
+
+The core application lives in the  
+**[`ibridgesgui`](https://github.com/iBridges-for-iRODS/iBridges-GUI/tree/develop/ibridgesgui)**  
+package. Its architecture is modular, separating UI, logic, and iRODS operations into clear components.
+
+
+### Top-level modules {#top-level-modules}
+
+These modules provide the core functionality used across the application:
+
+- `__main__.py` — application entry point  
+- `config.py` — configuration handling  
+- `gui_utils.py` — shared GUI helpers  
+- `threads.py` — background worker threads  
+- `info.py` — application metadata  
+- `irods_tree_model.py` — iRODS tree model  
+- `login.py` — authentication  
+- `logviewer.py` — log viewer tab  
+- `welcome.py` — startup screen  
+- `md_schemas/` — metadata schema definitions  
+
+
+### mainmenu/ {#mainmenu}
+
+The orchestration layer of the application:
+
+- `main_window.py` — main Qt window hosting all tabs  
+- `tab_manager.py` — loads and organizes built‑in tabs  
+- `plugin_manager.py` — discovers and loads plugin tabs  
+- `session_manager.py` — manages user session state  
+- `config_manager.py` — handles configuration files and user-defined settings  
+
+This directory is the best starting point for understanding how the application is assembled.
+
+
+### browsertab/ {#browsertab}
+
+Implements the iRODS browser tab using a model–controller–view structure:
+
+- `browser_model.py` — data model  
+- `browser_controller.py` — navigation and logic  
+- `browser.py` — UI  
+- `irods_browser_service.py` — iRODS operations  
+
+
+### searchtab/ {#searchtab}
+
+Implements the search interface:
+
+- `search_model.py` — query state and results  
+- `search_controller.py` — executes searches and handles filters  
+- `search.py` — UI for building queries and viewing results  
+
+
+### synctab/ {#synctab}
+
+Implements synchronization:
+
+- `sync_model.py` — sync state and configuration  
+- `sync_controller.py` — sync logic and background tasks  
+- `sync.py` — UI for managing sync jobs  
+
+
+### popup_widgets/ {#popup-widgets}
+
+Reusable dialogs for:
+
+- creating collections  
+- creating directories  
+- uploading/downloading  
+- renaming  
+- metadata editing  
+- configuration checks  
+- resource tree dialogs  
+
+Each dialog has its own file, making them easy to reuse or extend.
+
+
+### ui_files/ {#ui-files}
+
+Contains:
+
+- Qt Designer `.ui` files  
+- auto‑generated Python wrappers  
+- matching controller/view logic  
+
+This keeps UI layout editable without touching logic.
+
+
+### icons/ {#icons}
+
+Contains all icons used in the GUI, including navigation arrows, sync indicators, loading animations, and the application logo.
+
+