How usn-library/urge works
URGE is a browser-based research-dataset README generator. Researchers import existing documentation or repository metadata, complete a guided form, optionally check grammar, then download structured exports or send a README to a repository draft. The graph reflects the README’s documented capabilities and the sampled route, client, and statistics code; unsampled endpoint wiring is represented only where the README explicitly documents it.
Main entry points: dvurge.js Form workflow · app.py Web routes · button_stats.py Usage counters · dataverse.html Guided form
Components 24
README workflow
- Guided form
templates/dataverse.html - Form workflow
static/dvurge.js - README content
static/dvurge.js - Grammar check
static/dvurge.js - Web routes
app.py
Metadata imports
- DMP import
static/dvurge.js - README and JSON import
static/dvurge.js - Dataverse import
app.py - Figshare import
app.py - Zenodo import
app.py - ORCID lookup
app.py
Exports and delivery
- README and JSON exports
static/dvurge.js - Dataverse draft send
static/dvurge.js - Figshare draft send
app.py - QR codes
static/dvurge.js
External services
- Dataverse
- Figshare
- Zenodo
- ORCID
- LanguageTool
Anonymous statistics
- Usage counters
button_stats.py - Page counter
view_counter.py - Statistics database
view_counter.py
Other components
- Researcher
Connections 35
- Researcher → Guided form: uses
- Guided form → Form workflow: submits fields
- Form workflow → DMP import: imports plan
- Form workflow → README and JSON import: loads documentation
- Form workflow → Dataverse import: requests metadata
- Form workflow → Figshare import: requests metadata
- Form workflow → Zenodo import: requests metadata
- Form workflow → ORCID lookup: requests lookup
- Dataverse import → Web routes: calls routes
- Figshare import → Web routes: calls routes
- Zenodo import → Web routes: calls routes
- ORCID lookup → Web routes: calls route
- Web routes → Dataverse: fetches records
- Web routes → Figshare: fetches articles
- Web routes → Zenodo: fetches depositions
- Web routes → ORCID: searches
- Dataverse import → Form workflow: returns metadata
- Figshare import → Form workflow: returns metadata
- Zenodo import → Form workflow: returns metadata
- Form workflow → README content: builds content
- README content → Grammar check: checks description
- Grammar check → LanguageTool: checks grammar
- Form workflow → README and JSON exports: generates files
- README content → README and JSON exports: formats fields
- README content → Dataverse draft send: sends README
- Dataverse draft send → Dataverse: uploads draft file
- Form workflow → Figshare draft send: requests upload
- Figshare draft send → Web routes: calls route
- Web routes → Figshare: uploads draft file
- README content → QR codes: renders codes
- Web routes → Usage counters: records button click
- Web routes → Page counter: increments page view
- Usage counters → Statistics database: writes counts
- Page counter → Statistics database: updates count
- Researcher → Usage counters: clicks export