gismap 0.3.0__tar.gz → 0.4.0__tar.gz

{gismap-0.3.0 → gismap-0.4.0}/.github/workflows/build.yml

@@ -34,7 +34,7 @@ jobs:
     - name: Set up uv
       uses: astral-sh/setup-uv@v5
       with:
-        version: "0.9.11"
+        version: "0.9.27"
 
     - name: Run tests
       run: |

{gismap-0.3.0 → gismap-0.4.0}/.github/workflows/docs.yml

@@ -29,7 +29,7 @@ jobs:
       - name: Set up uv
         uses: astral-sh/setup-uv@v5
         with:
-          version: "0.9.11"
+          version: "0.9.27"
 
       - name: Setup Pandoc
         uses: pandoc/actions/setup@v1
@@ -39,6 +39,7 @@ jobs:
       - name: Build Sphinx documentation
         run: |
           uv sync --all-extras
+          uv run python -m gismap.build
           uv run sphinx-build -a -E -b html docs build
 
       - name: Deploy Sphinx documentation on Github Pages

gismap-0.4.0/.github/workflows/ldb-build.yml

@@ -0,0 +1,98 @@
+name: Build LDB Database
+
+on:
+  schedule:
+    - cron: '0 2 * * 0'  # Weekly on Sunday 2 AM UTC
+  workflow_dispatch:  # Manual trigger
+
+jobs:
+  build-ldb:
+    name: Build and Upload LDB Database
+    runs-on: ubuntu-latest
+    timeout-minutes: 60  # Build takes ~30 min, allow margin
+    permissions:
+      contents: write  # To upload release assets
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.9.27"
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Build LDB database
+        run: |
+          echo "Building LDB database from DBLP TTL..."
+          uv run python -m gismap.build
+          echo "Build complete."
+
+      - name: Locate and verify database
+        id: locate-db
+        run: |
+          # Find database in platformdirs location
+          DB_PATH=$(uv run python -c "from gismap.sources.ldb import LDB_PATH; print(LDB_PATH)")
+          echo "Database path: $DB_PATH"
+
+          if [ ! -f "$DB_PATH" ]; then
+            echo "ERROR: Database not found at $DB_PATH"
+            exit 1
+          fi
+
+          # Get file size
+          DB_SIZE=$(stat -c%s "$DB_PATH")
+          echo "Database size: $DB_SIZE bytes ($(echo "scale=2; $DB_SIZE / 1073741824" | bc) GB)"
+
+          # Get counts
+          AUTHOR_COUNT=$(uv run python -c "from gismap.sources.ldb import LDB; LDB.load_db(); print(len(LDB.authors))")
+          PUBLI_COUNT=$(uv run python -c "from gismap.sources.ldb import LDB; LDB.load_db(); print(len(LDB.publis))")
+          echo "Authors: $AUTHOR_COUNT, Publications: $PUBLI_COUNT"
+
+          echo "db_path=$DB_PATH" >> $GITHUB_OUTPUT
+          echo "db_size=$DB_SIZE" >> $GITHUB_OUTPUT
+          echo "author_count=$AUTHOR_COUNT" >> $GITHUB_OUTPUT
+          echo "publi_count=$PUBLI_COUNT" >> $GITHUB_OUTPUT
+
+      - name: Find latest release
+        id: latest-release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          LATEST_TAG=$(gh release list --limit 1 --json tagName -q '.[0].tagName')
+          if [ -z "$LATEST_TAG" ]; then
+            echo "ERROR: No releases found"
+            exit 1
+          fi
+          echo "Latest release: $LATEST_TAG"
+          echo "tag=$LATEST_TAG" >> $GITHUB_OUTPUT
+
+      - name: Upload LDB to release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          echo "Uploading ldb.pkl.zst to release ${{ steps.latest-release.outputs.tag }}..."
+          gh release upload "${{ steps.latest-release.outputs.tag }}" \
+            "${{ steps.locate-db.outputs.db_path }}" \
+            --clobber
+          echo "Upload complete!"
+
+      - name: Summary
+        run: |
+          echo "## LDB Build Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "| Metric | Value |" >> $GITHUB_STEP_SUMMARY
+          echo "|--------|-------|" >> $GITHUB_STEP_SUMMARY
+          echo "| Release | ${{ steps.latest-release.outputs.tag }} |" >> $GITHUB_STEP_SUMMARY
+          echo "| Authors | ${{ steps.locate-db.outputs.author_count }} |" >> $GITHUB_STEP_SUMMARY
+          echo "| Publications | ${{ steps.locate-db.outputs.publi_count }} |" >> $GITHUB_STEP_SUMMARY
+          echo "| Database Size | $(echo "scale=2; ${{ steps.locate-db.outputs.db_size }} / 1073741824" | bc) GB |" >> $GITHUB_STEP_SUMMARY
+          echo "| Build Date | $(date -u +%Y-%m-%dT%H:%M:%SZ) |" >> $GITHUB_STEP_SUMMARY

gismap-0.4.0/.github/workflows/release.yml

@@ -0,0 +1,77 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish-pypi:
+    name: Publish Python Package
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    environment:
+      name: pypi
+    permissions:
+      id-token: write  # Required for PyPI trusted publishing
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.9.11"  # Pin to specific uv version
+
+      - name: Build package
+        run: uv build --no-sources  # Recommended for production builds
+
+      - name: Publish to PyPI
+        run: uv publish -v dist/*
+
+  build-ldb:
+    name: Build LDB Database
+    runs-on: ubuntu-latest
+    timeout-minutes: 60  # Build takes ~30 min
+    permissions:
+      contents: write  # To upload release assets
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.9.11"
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Build LDB database
+        run: |
+          echo "Building LDB database from DBLP TTL..."
+          uv run python -m gismap.build
+          echo "Build complete."
+
+      - name: Locate database
+        id: locate-db
+        run: |
+          DB_PATH=$(uv run python -c "from gismap.sources.ldb import LDB_PATH; print(LDB_PATH)")
+          echo "Database path: $DB_PATH"
+          echo "db_path=$DB_PATH" >> $GITHUB_OUTPUT
+
+      - name: Upload LDB to release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          echo "Uploading ldb.pkl.zst to release ${{ github.event.release.tag_name }}..."
+          gh release upload "${{ github.event.release.tag_name }}" \
+            "${{ steps.locate-db.outputs.db_path }}" \
+            --clobber
+          echo "Upload complete!"

{gismap-0.3.0 → gismap-0.4.0}/HISTORY.md

@@ -2,7 +2,6 @@
 
 ## Pipeline
 
-- Offline DBLP
 - anHALyze: tools to spot HAL issues (bad author metada, DBLP comparison, widget)
 - EgoConf: find your conferences journals
 - Easier access to graph customization
@@ -10,6 +9,21 @@
 - Custom CSS (e.g. transparent background)
 - Gismo integration
 
+## 0.4.0 (2026-01-27): Local DB
+
+New DB: LDB (Local DB). All the strengths of DBLP, None of its weaknesses.
+
+- Convert the whole DBLP relational DB into a Gismap compatible local object.
+- Introduces new compressed list format (Zlist) to keep the DB in memory.
+- Use Bag-of-Factors to enable approximate search.
+- You can build your own dataset or just rely on the one we provide and update.
+
+Also, Lamsade added to the gallery.
+
+## 0.3.1 (2025-11-27): Bug fixes
+
+- Fix BS4 dependency issue.
+- Errors in readme
 
 ## 0.3.0 (2025-11-25): Bigger, faster, prettier
 

{gismap-0.3.0 → gismap-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gismap
-Version: 0.3.0
+Version: 0.4.0
 Summary: GisMap leverages DBLP and HAL databases to provide cartography tools for you and your lab.
 Project-URL: Repository, https://github.com/balouf/gismap
 Project-URL: Documentation, https://balouf.github.io/gismap
@@ -9,12 +9,14 @@ Maintainer-email: Fabien Mathieu <fabien.mathieu@normalesup.org>
 License-Expression: MIT
 License-File: AUTHORS.md
 Requires-Python: >=3.10
+Requires-Dist: beautifulsoup4>=4.14.2
 Requires-Dist: bof>=0.3.5
 Requires-Dist: distinctipy>=1.3.4
 Requires-Dist: domonic>=0.9.13
 Requires-Dist: gismo>=0.5.2
 Requires-Dist: ipykernel>=6.30.1
 Requires-Dist: ipywidgets>=8.1.8
+Requires-Dist: platformdirs>=4.5.0
 Requires-Dist: tqdm>=4.67.1
 Description-Content-Type: text/markdown
 
@@ -61,17 +63,28 @@ Install GisMap:
 $ pip install gismap
 ```
 
-Use GisMap to produce a collaboration graph (HTML):
+Use GisMap to display a collaboration graph (HTML) from a Notebook:
 
 ```pycon
->>> from gismap.sources.hal import HAL
->>> from gismap.lab import ListLab
->>> lab = ListLab(["Fabien Mathieu", "François Baccelli", "Ludovic Noirie", "Céline Comte", "Sébastien Tixeuil"], dbs="hal")
+>>> from gismap.lab import ListMap
+>>> lab = ListMap(["Fabien Mathieu", "François Baccelli", "Ludovic Noirie", "Céline Comte", "Sébastien Tixeuil"], dbs="hal")
 >>> lab.update_authors()
 >>> lab.update_publis()
 >>> lab.show_html()
 ```
 
+If you are not using Jupyter Lab/Notebook, rich display will not work.
+Instead, save the HTML and display it on your browser:
+
+```pycon
+>>> from gismap.lab import ListMap
+>>> lab = ListMap(["Fabien Mathieu", "François Baccelli", "Ludovic Noirie", "Céline Comte", "Sébastien Tixeuil"], dbs="hal")
+>>> lab.update_authors()
+>>> lab.update_publis()
+>>> lab.save_html("my_graph")
+```
+
+
 ## Credits
 
 This package was created with [Cookiecutter][CC] and the [Package Helper 3][PH3] project template.

{gismap-0.3.0 → gismap-0.4.0}/README.md

@@ -41,17 +41,28 @@ Install GisMap:
 $ pip install gismap
 ```
 
-Use GisMap to produce a collaboration graph (HTML):
+Use GisMap to display a collaboration graph (HTML) from a Notebook:
 
 ```pycon
->>> from gismap.sources.hal import HAL
->>> from gismap.lab import ListLab
->>> lab = ListLab(["Fabien Mathieu", "François Baccelli", "Ludovic Noirie", "Céline Comte", "Sébastien Tixeuil"], dbs="hal")
+>>> from gismap.lab import ListMap
+>>> lab = ListMap(["Fabien Mathieu", "François Baccelli", "Ludovic Noirie", "Céline Comte", "Sébastien Tixeuil"], dbs="hal")
 >>> lab.update_authors()
 >>> lab.update_publis()
 >>> lab.show_html()
 ```
 
+If you are not using Jupyter Lab/Notebook, rich display will not work.
+Instead, save the HTML and display it on your browser:
+
+```pycon
+>>> from gismap.lab import ListMap
+>>> lab = ListMap(["Fabien Mathieu", "François Baccelli", "Ludovic Noirie", "Céline Comte", "Sébastien Tixeuil"], dbs="hal")
+>>> lab.update_authors()
+>>> lab.update_publis()
+>>> lab.save_html("my_graph")
+```
+
+
 ## Credits
 
 This package was created with [Cookiecutter][CC] and the [Package Helper 3][PH3] project template.

gismap-0.4.0/binder/postBuild

@@ -0,0 +1,21 @@
+#!/bin/bash
+set -ex
+
+# Create gismap data directory (Linux path from platformdirs)
+mkdir -p ~/.local/share/gismap
+
+# Download LDB from the pinned release
+# UPDATE THIS URL when releasing new versions
+LDB_URL="https://github.com/balouf/gismap/releases/download/v0.4.0/ldb.pkl.zst"
+
+echo "Downloading LDB database for Binder image..."
+curl -L -o ~/.local/share/gismap/ldb.pkl.zst "$LDB_URL"
+
+# Verify download
+if [ ! -f ~/.local/share/gismap/ldb.pkl.zst ]; then
+    echo "ERROR: Failed to download ldb.pkl.zst"
+    exit 1
+fi
+
+ls -lh ~/.local/share/gismap/ldb.pkl.zst
+echo "LDB database successfully embedded in Binder image"

gismap-0.4.0/binder/requirements.txt

@@ -0,0 +1 @@
+git+https://github.com/balouf/gismap.git@v0.4.0#egg=gismap

{gismap-0.3.0 → gismap-0.4.0}/docs/reference/database.md

@@ -12,6 +12,21 @@ Abstract description of GisMap DB interface.
     :members:
 ```
 
+## LDB (Local DBLP)
+
+Interface for *dblp computer science bibliography* (https://dblp.org/) using a local copy of the database.
+
+```{eval-rst}
+.. automodule:: gismap.sources.ldb
+    :members:
+```
+
+
+```{eval-rst}
+.. automodule:: gismap.sources.dblp_ttl
+    :members:
+```
+
 
 ## DBLP (online)
 

{gismap-0.3.0 → gismap-0.4.0}/docs/reference/examples.md

@@ -14,6 +14,22 @@
     :members:
 ```
 
+
+## Cedric
+
+```{eval-rst}
+.. automodule:: gismap.lab_examples.cedric
+    :members:
+```
+
+## LAMSADE
+
+```{eval-rst}
+.. automodule:: gismap.lab_examples.lamsade
+    :members:
+```
+
+
 ## LINCS
 
 ```{eval-rst}

{gismap-0.3.0 → gismap-0.4.0}/docs/reference/utils.md

@@ -29,6 +29,16 @@ Keep track of things.
     :members:
 ```
 
+## Zlist
+
+Convert a list into a succession of compressed frames. Reduces memory footprint at the price of slower random access (sequential access is unaffected).
+
+```{eval-rst}
+.. automodule:: gismap.utils.zlist
+    :members:
+```
+
+
 ## Text
 
 Text manipulation tools.

{gismap-0.3.0 → gismap-0.4.0}/docs/tutorials/cedric.ipynb

@@ -23,8 +23,17 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "from gismap.lab_examples.cedric import CedricFull\n",
-    "cedric = CedricFull(dbs=\"hal\")\n",
+    "from gismap.lab_examples.cedric import CedricFull"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "3",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "cedric = CedricFull()\n",
     "cedric.update_authors()\n",
     "cedric.update_publis()\n",
     "cedric.show_html()"

{gismap-0.3.0 → gismap-0.4.0}/docs/tutorials/egomap.ipynb

@@ -44,7 +44,7 @@
    "source": [
     ":::note\n",
     "\n",
-    "For small tests, we query both HAL and DBLP (default behavior), but for large retrievals we use HAL only, as it is faster.\n",
+    "Before the introduction of LDB, mixing HAL and DBLP took a lot of time due to DBLP request limitations. Now dual requests can be performed transparently.\n",
     ":::"
    ]
   },
@@ -73,7 +73,7 @@
    "source": [
     "from gismap.lab import EgoMap as Map\n",
     "\n",
-    "celine = Map(\"Céline Comte\", dbs=\"hal\")\n",
+    "celine = Map(\"Céline Comte\")\n",
     "celine.build()"
    ]
   },
@@ -119,9 +119,9 @@
    "outputs": [],
    "source": [
     "nidhi = Map(\n",
-    "    \"Nidhi Hegde (img: https://sites.ualberta.ca/~nidhih/images/circle1.png)\", dbs=\"hal\"\n",
+    "    \"Nidhi Hegde (img: https://sites.ualberta.ca/~nidhih/images/circle1.png)\"\n",
     ")\n",
-    "nidhi.build(target=60)"
+    "nidhi.build(target=80)"
    ]
   },
   {
@@ -177,6 +177,30 @@
    "source": [
     "julie.show_html()"
    ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "17",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "kathrin = Map(\n",
+    "    \"Kathrin Hanauer (img: https://homepage.univie.ac.at/kathrin.hanauer/assets/img/portrait.jpg)\",\n",
+    "    dbs=\"ldb\",\n",
+    ")\n",
+    "kathrin.build()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "18",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "kathrin.show_html()"
+   ]
   }
  ],
  "metadata": {

{gismap-0.3.0 → gismap-0.4.0}/docs/tutorials/examples.md

@@ -4,5 +4,6 @@
 toulouse
 lip6
 cedric
+lamsade
 lincs
 :::