pubnetwork 0.1.0__tar.gz

pubnetwork-0.1.0/.gitignore

@@ -0,0 +1,38 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+*.egg
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+htmlcov/
+.coverage
+coverage.xml
+
+# OS
+.DS_Store
+Thumbs.db
+
+# PubNet cache
+.pubnet/
+
+# Generated reports
+*_pubnet.html
+
+# Jupyter
+.ipynb_checkpoints/

pubnetwork-0.1.0/CHANGELOG.md

@@ -0,0 +1,8 @@
+# CHANGELOG.md — PubNet
+
+Significant changes, grouped by date. Not every commit, just things
+worth knowing about when picking up the project after a break.
+
+## 2026-05-14
+
+- **Project created** — pyproject.toml with hatchling, 13 dependencies, `pubnet` CLI entry poin

pubnetwork-0.1.0/LICENSE

@@ -0,0 +1,139 @@
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## License
+
+This project is licensed under the PolyForm Noncommercial 1.0.0 license.
+
+Free for academic, educational, and non-commercial research use.
+
+Commercial use requires a separate license.
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose.  However, you may
+only distribute the software according to [Distribution
+License](#distribution-license) and make changes or new works
+based on the software according to [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software.  Your license
+to distribute covers distributing the software with
+changes and new works permitted by [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study, private
+entertainment, hobby projects, amateur pursuits, or religious
+observance, without any anticipated commercial application,
+is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution,
+public research organization, public safety or health
+organization, environmental protection organization,
+or government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting
+from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else.  These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice.  Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.

pubnetwork-0.1.0/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: pubnetwork
+Version: 0.1.0
+Summary: Publication network analyser — co-author graphs, citation trends, topic clusters from Google Scholar
+Author-email: Sanjiv Kumar <drsanjivk@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: dash-bootstrap-components>=1.5
+Requires-Dist: dash-cytoscape>=1.0
+Requires-Dist: dash>=2.14
+Requires-Dist: jinja2>=3.0
+Requires-Dist: networkx>=3.0
+Requires-Dist: plotly>=5.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyvis>=0.3
+Requires-Dist: rapidfuzz>=3.0
+Requires-Dist: requests>=2.28
+Requires-Dist: scholarly>=1.7
+Requires-Dist: scikit-learn>=1.3
+Provides-Extra: dev
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: serpapi
+Requires-Dist: google-search-results>=2.4; extra == 'serpapi'
+Description-Content-Type: text/markdown
+
+# PubNet
+
+Publication network analyser for researchers. Given a Google Scholar profile, PubNet fetches your publications and generates interactive visualisations: co-author networks, citation trends, topic clusters, journal impact factors, and formatted references.
+
+## Features
+
+- **Co-author network graph** - interactive force-directed graph showing collaboration patterns
+- **Citation trends** - yearly citation counts with rolling h-index overlay
+- **Publications per year** - output volume over time
+- **Topic clusters** - TF-IDF + k-means clustering of research themes
+- **Journal impact factors** - Scimago CSV lookup with OpenAlex API fallback
+- **Crossref enrichment** - corrects venue names and adds DOIs via free Crossref API
+- **Reference formatting** - APA, MLA, BibTeX, Vancouver, Chicago with copy-to-clipboard
+- **Two interfaces** - CLI (self-contained HTML report) and Dash GUI (live interactive exploration)
+
+## Install
+
+```bash
+pip install pubnetwork
+```
+
+Or for development:
+
+```bash
+git clone https://github.com/sanjiv856/pubnet.git
+cd pubnet
+pip install -e .
+```
+
+Requires Python 3.10+.
+
+## Quick start
+
+### Demo (bundled profile)
+
+```bash
+pubnet demo
+```
+
+Generates `sanjiv_kumar_pubnet.html` using the bundled Scholar profile.
+
+### Analyse a Scholar profile
+
+```bash
+pubnet analyze --scholar-url "https://scholar.google.com/citations?user=ML7X29AAAAAJ"
+```
+
+Or by author ID:
+
+```bash
+pubnet analyze --author-id ML7X29AAAAAJ
+```
+
+### Interactive GUI
+
+```bash
+pubnet gui
+```
+
+Opens a Dash web app at `http://localhost:8050` with sidebar navigation, filters, and interactive charts.
+
+## CLI options
+
+```
+pubnet analyze [OPTIONS]
+
+  --scholar-url TEXT           Google Scholar profile URL
+  --author-id TEXT             Google Scholar author ID
+  --builtin                    Use bundled demo profile
+  --format [apa|mla|bibtex|vancouver|chicago]
+                               Reference format (default: apa)
+  --topics INTEGER             Number of topic clusters (default: 5)
+  -o, --output PATH            Output HTML file path
+  --no-cache                   Force fresh Scholar fetch
+  --crossref / --no-crossref   Crossref venue correction (default: enabled)
+  -v, --verbose                Debug logging
+```
+
+## Architecture
+
+```
+Fetch (scholarly) -> Clean/Dedup (rapidfuzz) -> Crossref Enrich -> Analyse -> Render
+```
+
+Core library with pure-function analysis modules shared by both CLI and GUI:
+
+| Module | Purpose |
+|--------|---------|
+| `fetch.py` | Scholar fetcher with JSON cache |
+| `analyze.py` | Co-author graph, citation trends, topic clusters, stats |
+| `formatters.py` | APA/MLA/BibTeX/Vancouver/Chicago references |
+| `journal_if.py` | Scimago CSV + OpenAlex API impact factors |
+| `crossref.py` | Free Crossref API for venue correction |
+| `report.py` | Jinja2 HTML report renderer |
+| `gui/` | Dash interactive app |
+
+## Cache management
+
+```bash
+pubnet cache list    # Show cached profiles
+pubnet cache clear   # Remove all cached data
+```
+
+Profiles are cached to `~/.pubnet/cache/` to avoid repeated Scholar fetches.
+
+## Tech stack
+
+Python 3.10+ with scholarly, pydantic, networkx, dash, dash-cytoscape, plotly, scikit-learn, click, jinja2, rapidfuzz.
+
+## Tests
+
+```bash
+pip install -e .
+pytest tests/
+```

pubnetwork-0.1.0/README.md

@@ -0,0 +1,115 @@
+# PubNet
+
+Publication network analyser for researchers. Given a Google Scholar profile, PubNet fetches your publications and generates interactive visualisations: co-author networks, citation trends, topic clusters, journal impact factors, and formatted references.
+
+## Features
+
+- **Co-author network graph** - interactive force-directed graph showing collaboration patterns
+- **Citation trends** - yearly citation counts with rolling h-index overlay
+- **Publications per year** - output volume over time
+- **Topic clusters** - TF-IDF + k-means clustering of research themes
+- **Journal impact factors** - Scimago CSV lookup with OpenAlex API fallback
+- **Crossref enrichment** - corrects venue names and adds DOIs via free Crossref API
+- **Reference formatting** - APA, MLA, BibTeX, Vancouver, Chicago with copy-to-clipboard
+- **Two interfaces** - CLI (self-contained HTML report) and Dash GUI (live interactive exploration)
+
+## Install
+
+```bash
+pip install pubnetwork
+```
+
+Or for development:
+
+```bash
+git clone https://github.com/sanjiv856/pubnet.git
+cd pubnet
+pip install -e .
+```
+
+Requires Python 3.10+.
+
+## Quick start
+
+### Demo (bundled profile)
+
+```bash
+pubnet demo
+```
+
+Generates `sanjiv_kumar_pubnet.html` using the bundled Scholar profile.
+
+### Analyse a Scholar profile
+
+```bash
+pubnet analyze --scholar-url "https://scholar.google.com/citations?user=ML7X29AAAAAJ"
+```
+
+Or by author ID:
+
+```bash
+pubnet analyze --author-id ML7X29AAAAAJ
+```
+
+### Interactive GUI
+
+```bash
+pubnet gui
+```
+
+Opens a Dash web app at `http://localhost:8050` with sidebar navigation, filters, and interactive charts.
+
+## CLI options
+
+```
+pubnet analyze [OPTIONS]
+
+  --scholar-url TEXT           Google Scholar profile URL
+  --author-id TEXT             Google Scholar author ID
+  --builtin                    Use bundled demo profile
+  --format [apa|mla|bibtex|vancouver|chicago]
+                               Reference format (default: apa)
+  --topics INTEGER             Number of topic clusters (default: 5)
+  -o, --output PATH            Output HTML file path
+  --no-cache                   Force fresh Scholar fetch
+  --crossref / --no-crossref   Crossref venue correction (default: enabled)
+  -v, --verbose                Debug logging
+```
+
+## Architecture
+
+```
+Fetch (scholarly) -> Clean/Dedup (rapidfuzz) -> Crossref Enrich -> Analyse -> Render
+```
+
+Core library with pure-function analysis modules shared by both CLI and GUI:
+
+| Module | Purpose |
+|--------|---------|
+| `fetch.py` | Scholar fetcher with JSON cache |
+| `analyze.py` | Co-author graph, citation trends, topic clusters, stats |
+| `formatters.py` | APA/MLA/BibTeX/Vancouver/Chicago references |
+| `journal_if.py` | Scimago CSV + OpenAlex API impact factors |
+| `crossref.py` | Free Crossref API for venue correction |
+| `report.py` | Jinja2 HTML report renderer |
+| `gui/` | Dash interactive app |
+
+## Cache management
+
+```bash
+pubnet cache list    # Show cached profiles
+pubnet cache clear   # Remove all cached data
+```
+
+Profiles are cached to `~/.pubnet/cache/` to avoid repeated Scholar fetches.
+
+## Tech stack
+
+Python 3.10+ with scholarly, pydantic, networkx, dash, dash-cytoscape, plotly, scikit-learn, click, jinja2, rapidfuzz.
+
+## Tests
+
+```bash
+pip install -e .
+pytest tests/
+```

pubnetwork-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pubnetwork"
+version = "0.1.0"
+description = "Publication network analyser — co-author graphs, citation trends, topic clusters from Google Scholar"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    { name = "Sanjiv Kumar", email = "drsanjivk@gmail.com" },
+]
+dependencies = [
+    "scholarly>=1.7",
+    "pydantic>=2.0",
+    "rapidfuzz>=3.0",
+    "networkx>=3.0",
+    "pyvis>=0.3",
+    "plotly>=5.0",
+    "scikit-learn>=1.3",
+    "click>=8.0",
+    "jinja2>=3.0",
+    "dash>=2.14",
+    "dash-bootstrap-components>=1.5",
+    "dash-cytoscape>=1.0",
+    "requests>=2.28",
+]
+
+[project.optional-dependencies]
+serpapi = ["google-search-results>=2.4"]
+dev = ["pytest>=7.0", "pytest-cov", "ruff"]
+
+[project.scripts]
+pubnet = "pubnet.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pubnet"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100

pubnetwork-0.1.0/src/pubnet/__init__.py

@@ -0,0 +1,3 @@
+"""PubNet — Publication network analyser for researchers."""
+
+__version__ = "0.1.0"