hinge 0.1.0__py3-none-any.whl

hinge-0.1.0.dist-info/METADATA

@@ -0,0 +1,309 @@
+Metadata-Version: 2.4
+Name: hinge
+Version: 0.1.0
+Summary: Heterogeneous Information Network tool for GitHub research datasets
+Project-URL: Homepage, https://github.com/marcotonnarelli/hinge
+Project-URL: Repository, https://github.com/marcotonnarelli/hinge
+Project-URL: Issues, https://github.com/marcotonnarelli/hinge/issues
+Author-email: Filippo Scaramuzza <f.scaramuzza@tue.nl>, Marco Tonnarelli <m.tonnarelli@tue.nl>, Gergő Bocsárdi <a.g.bocsardi@tue.nl>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: dbt,duckdb,github,graph,heterogeneous-information-network,mining
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.12
+Requires-Dist: dbt-core>=1.8
+Requires-Dist: dbt-duckdb>=1.8
+Requires-Dist: duckdb>=1.0
+Requires-Dist: networkx>=3.3
+Requires-Dist: orjson>=3.10
+Requires-Dist: pyarrow>=16.0
+Requires-Dist: pydantic>=2.7
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.7
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: import-linter>=2.0; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.2; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Requires-Dist: types-pyyaml; extra == 'dev'
+Provides-Extra: tui
+Requires-Dist: textual>=0.70; extra == 'tui'
+Provides-Extra: web
+Requires-Dist: fastapi>=0.111; extra == 'web'
+Requires-Dist: uvicorn>=0.30; extra == 'web'
+Description-Content-Type: text/markdown
+
+# HINGE — Heterogeneous Information Network for Generalized Extraction 
+
+`hinge` ingests GitHub activity datasets (JSONL today; CSV/Parquet planned), persists
+them as a typed multi-relational graph in DuckDB, and exposes **projections** —
+dbt SQL models that derive task-specific sub-graphs and export them to formats
+consumed by Gephi, NetworkX, igraph, etc.
+
+This is a research artefact accompanying an ICSME 2026 Tools and Data Showcase submission.
+
+---
+
+## Quick start
+
+```bash
+# 1. Install (uv is the only supported package manager)
+uv sync --all-extras
+
+# 2. Ingest a dataset
+uv run hinge ingest path/to/events.jsonl --reader numfocus
+# → ingested 48 elements → 29 nodes, 19 edges (0 violations)
+# → Dataset ID: 78fc87c370944dc2b4a4e2d4bdd97ce1
+
+# 3. Use the printed Dataset ID to run a projection and export
+uv run hinge export \
+  --dataset 78fc87c370944dc2b4a4e2d4bdd97ce1 \
+  --projection user-user-repo-collaboration \
+  --format gml \
+  -o out/graph.gml
+
+# 4. Inspect all ingested datasets
+uv run hinge list datasets
+```
+
+Or via Docker:
+
+```bash
+docker compose build
+cp path/to/events.jsonl ./data/
+docker compose run --rm hinge hinge ingest /data/events.jsonl --reader numfocus
+docker compose run --rm hinge hinge export \
+  --dataset <id> --projection user-user-repo-collaboration --format gml -o /output/graph.gml
+```
+
+The DuckDB store lives at `$HINGE_STORE_PATH` (default `./network.duckdb`
+locally, `/store/network.duckdb` inside the container). Multiple datasets
+can coexist in the same file — each ingest run gets a unique Dataset ID.
+
+---
+
+## HIN contract + adapters
+
+The source-agnostic core starts at the adapter contract tables:
+
+```text
+source-specific adapter
+  -> contract_accounts / contract_repositories / contract_artifacts / contract_relations
+  -> hin_nodes / hin_edges
+  -> dbt projections
+  -> exporters
+```
+
+The `numfocus` reader uses a DuckDB adapter for this repo's NumFocus Actions
+JSONL scrape. It is intentionally source-specific: it knows paths like
+`$.actor.login` and `$.details.pull_request.id`. Other data sources should
+implement their own adapter that writes the same `contract_*` tables; then the
+HIN views and dbt recipes can run unchanged.
+
+The generic Python `ReaderStage` path is still available for simple custom
+readers, but large JSONL ingests should use a DuckDB/SQL contract adapter where
+possible.
+
+---
+
+## Adding a new projection
+
+A projection is a dbt SQL model that derives a task-specific sub-graph from
+the typed HIN stored in DuckDB. Adding one requires exactly four files/edits
+and no changes to the kernel.
+
+### Step 1 — Write the SQL model
+
+Create `hinge/dbt/models/networks/<name>.sql`. The model should read from
+the canonical HIN dbt models and produce a fixed set of columns:
+
+```sql
+-- Inputs (prefer these canonical HIN models, never the raw tables)
+{{ ref('hin_nodes') }}
+{{ ref('hin_edges') }}
+
+-- Output (prefer the network_edges macro; it emits this standard schema)
+network_edges(
+    recipe_name, recipe_version,
+    source_node_id, source_node_type,
+    target_node_id, target_node_type,
+    directed, edge_type,
+    weight, weight_kind,
+    n_contexts, n_events,
+    first_seen_at, last_seen_at,
+    time_bin, bot_policy,
+    properties
+)
+```
+
+`DbtProjection` converts this richer schema into `TypedEdge` objects for existing
+exporters, merging standard fields and `properties` into edge attrs.
+
+The upstream HIN models are built from `active_*` views created by the store
+immediately before dbt runs — they are already filtered to the requested
+`dataset_id`, so network SQL never needs to reference `dataset_id` at all.
+
+**Nodes-only projections:** the pipeline derives output nodes from the union
+of `source_node_id` and `target_node_id` in the result table. A projection that
+emits no edges will therefore produce no nodes either. The workaround is to use
+**self-loop edges** (`source_node_id = target_node_id`): they make the nodes
+visible to the exporter, carry metadata in `properties`, and can be filtered out
+in downstream tools with `G.remove_edges_from(nx.selfloop_edges(G))`.
+
+See [dev_interaction.sql](hinge/dbt/models/networks/dev_interaction.sql)
+for a full working example with a documented input/output contract.
+
+### Step 2 — Create the spec module
+
+Create `hinge/stages/projection/specs/<name>.py` and expose a `SPEC` constant:
+
+```python
+from hinge.kernel.projection.projection_spec import ProjectionSpec
+
+SPEC = ProjectionSpec(
+    name="my-projection",          # CLI key: --projection my-projection
+    description="...",
+    model_name="my_projection",    # must match the .sql file stem
+    output_node_types=["user"],
+    output_edge_types=["my_edge_label"],
+)
+```
+
+This is a plain value object — no class, no inheritance. The registry loads
+the module and returns the `SPEC` attribute directly.
+
+### Step 3 — Register the entry-point
+
+Add one line to `pyproject.toml`:
+
+```toml
+[project.entry-points."hinge.projection_specs"]
+my-projection = "hinge.stages.projection.specs.my_projection:SPEC"
+```
+
+Third-party packages can register projections the same way — no fork required.
+
+### Step 4 — Re-install so the entry-point is picked up
+
+```bash
+uv sync --all-extras
+uv run hinge list projections    # → my-projection should appear
+```
+
+Entry-points are baked into `.dist-info/entry_points.txt` at install time.
+Without this step the registry will not find the new spec.
+
+### Run it
+
+```bash
+uv run hinge export \
+  --dataset <id> \
+  --projection my-projection \
+  --format gml \
+  -o output/result.gml
+```
+
+### Local SQL custom projection
+
+For research-specific variants, write a local dbt model and run it without
+packaging or entry-points:
+
+```bash
+uv run hinge export-sql custom_star_user_repo.sql \
+  --dataset <id> \
+  --format gml \
+  -o output/custom.gml
+```
+
+The SQL file is temporarily added to the built-in dbt project, so it can use
+`ref('hin_edges')`, `ref('int_user_artifact_incidence')`, and all macros under
+`hinge/dbt/macros/`. It must still emit the standard `network_edges` schema.
+Use `--name valid_model_name` if the filename is not a valid dbt identifier.
+
+See [docs/custom-projections.md](docs/custom-projections.md).
+
+---
+
+## Logging
+
+Logs go to **stderr** by default. Use env vars to control verbosity and persistence:
+
+| Variable | Purpose | Default |
+|---|---|---|
+| `HINGE_LOG_LEVEL` | `DEBUG` / `INFO` / `WARNING` / `ERROR` | `INFO` |
+| `HINGE_LOG_FILE` | Also write logs to this file at full `DEBUG` detail | _(none)_ |
+
+```bash
+# See all pipeline milestones (default)
+uv run hinge ingest events.jsonl --reader numfocus
+
+# See every batch, dbt SQL, store open/close
+HINGE_LOG_LEVEL=DEBUG uv run hinge ingest events.jsonl --reader numfocus
+
+# Persist a full debug log to disk (useful for long ingest runs)
+HINGE_LOG_FILE=hinge.log uv run hinge ingest events.jsonl --reader numfocus
+tail -f hinge.log
+```
+
+---
+
+## Common commands
+
+```bash
+# Ingest NumFocus Actions JSONL via the DuckDB -> HIN contract adapter
+uv run hinge ingest events.jsonl --reader numfocus
+
+# Inspect stored datasets
+uv run hinge list datasets
+uv run hinge list projections
+uv run hinge list readers
+uv run hinge list exporters
+
+# Export
+uv run hinge export --dataset <id> --projection user-user-repo-collaboration --format gml -o out.gml
+
+# Dev / CI
+uv run pytest                                # tests
+uv run ruff check .                          # lint
+uv run ruff format .                         # format
+uv run mypy hinge/kernel hinge/frontends     # strict type-check
+uv run lint-imports                          # enforce kernel/stages/frontends boundary
+```
+
+---
+
+## Makefile (development)
+
+A `Makefile` is provided for quick local iteration. It uses hardcoded defaults
+(fixture file, `numfocus` reader, `user-user-repo-collaboration` projection, GML format) so
+you don't have to remember arguments during development — **not intended for
+production use**.
+
+```bash
+make install     # uv sync --all-extras
+make run         # ingest fixture + export graph in one shot
+make ingest      # ingest tests/fixtures/events_10.jsonl --reader numfocus
+make export      # export the latest dataset (auto-detects ID from the store)
+make test        # pytest
+make lint        # ruff check
+make fmt         # ruff format
+make typecheck   # mypy on kernel + frontends
+make clean       # delete output/, dbt artefacts, caches
+make reset       # clean + delete network.duckdb (full fresh start)
+```
+
+Any default can be overridden on the command line:
+
+```bash
+make run   READER=numfocus LOG_LEVEL=DEBUG
+make export FORMAT=graphml OUTPUT=output/graph.graphml
+```

hinge-0.1.0.dist-info/RECORD

@@ -0,0 +1,111 @@
+hinge/__init__.py,sha256=yVsheukxlHtBh1mKOtlZ441hdyycWVEPKlPNer_J_EM,175
+hinge/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hinge/config/logging_setup.py,sha256=LJeJuoyraOQgIfxpm71OWQuPwZ2XWi_8Fy7wNR2OXNA,2038
+hinge/config/settings.py,sha256=fWAuyKPxBIcKEStfX1WYGWs3uPBL_SQ_sFeP_DiHCRk,589
+hinge/config/types.yaml,sha256=ZmVJQu22HJ9YDRLc19iaxu92IxFS0uUjsr3m1Nk-auM,1110
+hinge/dbt/.user.yml,sha256=mJg0YPvdYshUURVJfSSgmJPBXTd9uvgTwN-RWj06DvQ,41
+hinge/dbt/dbt_project.yml,sha256=BDvNgBk8tAEXx_pDYL2TcNQWluY8TJ09HOfFbesuEJM,290
+hinge/dbt/profiles.yml,sha256=oMvY5y8Nzpx5RSVRk9L1QMB51BjKv8tgooJPAt5nxF8,253
+hinge/dbt/macros/apply_time_window.sql,sha256=_DQBWR9eUbKaDVUYNWtGKTyjA0OhGR0b13x9OB_8s0s,364
+hinge/dbt/macros/assert_recipe_supported.sql,sha256=B4LcXQ7gPxsD9Rp8tw3syj_XnBH8SD-CxcLX0juHQuA,3288
+hinge/dbt/macros/build_incidence.sql,sha256=BWh5OLstIp1FY1ebapieC5KS0Dfr9G3wOn0BNkpgCt8,1284
+hinge/dbt/macros/collapse_path.sql,sha256=2LMT_cRGMGGSQjJPBpT-aqg6VfQPD94t9UCGARsCoQ4,984
+hinge/dbt/macros/filter_bots.sql,sha256=fRcYdqE3JE5AAX-MNxkyV6eN_uk3OmGe6-U2vO62Z1Y,983
+hinge/dbt/macros/network_edges.sql,sha256=k0myGty2oDeKz2ePjnhvTCpDtJITTVbuqDcuduOCMvw,1177
+hinge/dbt/macros/project_bipartite.sql,sha256=kKZwWc5yInls089Z-SiFWkEBdvsY1DozqPJt6B2TUo8,1238
+hinge/dbt/macros/slice_edges.sql,sha256=hnp4Qwa2g6G5xAltAqtjj5GWIxQlXwH_8M_3bCYlh1I,1342
+hinge/dbt/models/hin/hin_accounts.sql,sha256=JvHdFsq2GTvyOaolOuHR4VyJZF4iu-aycLhvXv1wf6c,398
+hinge/dbt/models/hin/hin_artifacts.sql,sha256=t6MuGYkXp-dmkPqeOCCDftEG7fN6riD0bP8WKOErURE,468
+hinge/dbt/models/hin/hin_capabilities.sql,sha256=hkDJYDybIf3JkLsVqZqsT2bU5_7TnHk0C0Lq5HwnQkI,2684
+hinge/dbt/models/hin/hin_edges.sql,sha256=oTF0JrdcloxAj2HSCnpg9x8hXta-pRFR7FaRHBjGq3Q,1662
+hinge/dbt/models/hin/hin_nodes.sql,sha256=m3IMoUwYvUTYCxsDjyFGki1qhv0WtA744TLYluqWrrQ,925
+hinge/dbt/models/hin/hin_repositories.sql,sha256=lGRLQTHsXeDEBMxfbxx6C7e95p-6PheBRIpNwAy_KsQ,453
+hinge/dbt/models/intermediate/int_developer_repo_affiliation.sql,sha256=ynP_X1DN6dBFWC_gT0rqJz6eK1Lgz9_ZWj3tsik0zmg,846
+hinge/dbt/models/intermediate/int_user_artifact_incidence.sql,sha256=FPqqsZP5i9sjmF9jLHioR_MHJ2A9fgZoNRhqAr9EfC0,412
+hinge/dbt/models/networks/artifact_reference.sql,sha256=z_IR0t-V5Hlimuz88fbzG6kiIL7DUK7OiGmah3YSufY,806
+hinge/dbt/models/networks/co_commit_user_user.sql,sha256=7-u2EzZcU7yhC1p5Wxas7SUDzQWN1lkVAFrFKn9uiEw,1315
+hinge/dbt/models/networks/co_edit_file_user_user.sql,sha256=Vs6Gp6qtCkFEc7Ei4oDGIDopDw4KhvXy06NDPIa2-DA,1282
+hinge/dbt/models/networks/co_edit_line_user_user.sql,sha256=M3JMuqVYO2qT8ZQW2GChqvqGbBCLrtEg99kWtOAhpoc,1292
+hinge/dbt/models/networks/dev_interaction.sql,sha256=RCA9MIt-wmh3koIntS_3ohsqilboIGTZFrH9i8nxHkY,4822
+hinge/dbt/models/networks/developer_repo_affiliation.sql,sha256=NmIikSKba95ysDeSsDijTPhIvqpK79APoxtnWy1ZO18,596
+hinge/dbt/models/networks/follow_user_user.sql,sha256=m7h24h8Hq7HDlOmtIeqzIsjqFJ4NxvdhUnqsxHnu9CQ,701
+hinge/dbt/models/networks/fork_repo_repo.sql,sha256=METms8QZm9OST6Y8eh8DbqHm8THg7sU18fUkFLu-onA,693
+hinge/dbt/models/networks/issue_co_participation.sql,sha256=8Z_dqSRn0-FIVqapOo6lre3B8XsSn0Qj5WBrE5k_pFE,1446
+hinge/dbt/models/networks/issue_participation.sql,sha256=ja1D7JRzIJ6rQh3eNG_saYMjbErV_FrpDAZaEapE9nE,1150
+hinge/dbt/models/networks/pr_author_reviewer.sql,sha256=TI9qovx-wxVyeCC82iL5l0pvdPAv-fyJpKeS8J1znuM,1987
+hinge/dbt/models/networks/pr_participation.sql,sha256=oP6TkntxNnCvfLs42Z3yRL8T6vjiGjdUDHOdco9EoIY,1171
+hinge/dbt/models/networks/pr_reviewer_coreview.sql,sha256=S9G-Bk0slp-qWFHDw19wXZWPuPdfJqt5ClPVsWueghs,1307
+hinge/dbt/models/networks/repo_shared_contributors.sql,sha256=UxMALaxzolxR3g5FP5cHAsKn-YiWAQoj00fERMS1vEE,1155
+hinge/dbt/models/networks/star_user_repo.sql,sha256=cROUkE5ecFll1dFlLIEViFP457H-Ol1J0B5-RIbzKoc,699
+hinge/dbt/models/networks/user_mention_user.sql,sha256=eZ8WMxySPA_UoyTl4KYAfCy9eM3tiyYHM1X8SP1I8eE,1938
+hinge/dbt/models/networks/watch_user_repo.sql,sha256=yp2gl3SzpiAp2e7dvcl8Ki3P9Wl5vLNmUgAD41olmGY,697
+hinge/dbt/models/sources/sources.yml,sha256=9g_nw6bndhlrMWH3mjcVC1vp8RUMj_vxmEwVg-WjcW4,2358
+hinge/dbt/models/staging/stg_accounts.sql,sha256=kf2D__UMe5RQbMd_3qxW33ljg6UOgrnpxnoNWOtc6Nw,97
+hinge/dbt/models/staging/stg_adapter_manifest.sql,sha256=dHAnBRQYPy6crCChP_lZAqCW6HdhBUAp1tljVmcqaDM,105
+hinge/dbt/models/staging/stg_artifacts.sql,sha256=T-oUZTSHZYI7X3NH-65KZCRi3qRvEGAqIAsmdHfQKzI,98
+hinge/dbt/models/staging/stg_relations.sql,sha256=hSIMOiuI5-tQ8YrqUct9yR5NsYPfiSf46lYyBnTtP5E,98
+hinge/dbt/models/staging/stg_repositories.sql,sha256=QPbEdFeQYZg8VAaE7kLlZl4xXubFQGFjdvaVDbZct1c,101
+hinge/dbt/seeds/ref_recipe_requirements.csv,sha256=Wd5PcN4MSSHyq4CppT8sulHtb3oEdH2GzjAsSSQBYPs,1210
+hinge/frontends/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hinge/frontends/lib.py,sha256=rZztKwXP3yljJzHnJqLjrUY2-RT54jKAML2kemN_OTQ,4627
+hinge/frontends/cli/__init__.py,sha256=8lzSTHavtyxQaXcuqkD5EBY6MPHn-icoIw7Am6MCSTQ,59
+hinge/frontends/cli/app.py,sha256=C-mSzUtqBHenYbPui1H7Z4cqtaSYEbjcBKxLcKoQgoU,6638
+hinge/frontends/tui/__init__.py,sha256=JHkc1MUsZYwDl-iNVBq939qznQo3ol0X7S32XYQv8eU,284
+hinge/frontends/web/__init__.py,sha256=XcrUOdp_DJNe8Pi2CiOnZXRqZfWB-zKBdE-ovmyVeLE,205
+hinge/kernel/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hinge/kernel/registry.py,sha256=ryAzebg4JwcplxVs8QWzmBY7FNoVtuCH8BMe-6al3pQ,2381
+hinge/kernel/runner.py,sha256=HDbz-Bv7NefsRMgRksRLOLK9tSc6N095Iv01T4_1R2w,8137
+hinge/kernel/projection/__init__.py,sha256=4iZA_OXzqOCq5lACPfcbTp4EMxDx7AkcirvlN3SrpMw,285
+hinge/kernel/projection/projected_graph.py,sha256=U1koWmW5GCzL2fIocTjpFnPqhm4J3IvJiC8r2Wch0lw,931
+hinge/kernel/projection/projection_spec.py,sha256=gbKtj9oUPzPoysGQSjqOncspnMM_G0rcSC5iRjKddVI,1084
+hinge/kernel/protocols/__init__.py,sha256=i0MUWeLlxQXCktqaqSrXzifgKmSwtkq5o-THoEt7Q9g,674
+hinge/kernel/protocols/dataset_view.py,sha256=Z8Nv0QvVTRTWX67y8fZ1dkecblKwuEAq0V1PQ8Rm-0Y,988
+hinge/kernel/protocols/exporter_stage.py,sha256=e2Gb8QbJU9qZp9U3PSVKoCq69ipHmCn7NAO5efhioS8,635
+hinge/kernel/protocols/projection_stage.py,sha256=bxFvvXfMRfvs0Z6CiXILtQlZOn07UVkrqcy0wPfC9zM,1051
+hinge/kernel/protocols/reader_stage.py,sha256=svnloypqoxqYcB6GIpnH8FVk3VkxRTh2JC4zjakcuyI,1823
+hinge/kernel/protocols/store_stage.py,sha256=zUQfloR1aaK4YrRbo_OY_Ih3Lpoio77lbhnutr5V3-g,2272
+hinge/kernel/schema/__init__.py,sha256=MhSCAbx5jJX7PiqxGoHmF3106C80H3yctMJYAgfDLvs,363
+hinge/kernel/schema/hin_schema.py,sha256=u2RazJ2nSVGrza8XNs4zZMqsm5y-eP1YoB4D6Nf3B1k,1277
+hinge/kernel/schema/schema_violation.py,sha256=ahZHb1XlWIixp2xMYsfSvaXuCsZyQb5M2rnrfjSprAY,525
+hinge/kernel/schema/typed_edge.py,sha256=dhdFYbeExR1Nvuj4kM7b_kiAe6KIJYx4B5uG0jM_G1k,592
+hinge/kernel/schema/typed_node.py,sha256=enZ2JlKQzuKMsNAAWjxloxgKV34QRJUwsqVCVfBj3bQ,444
+hinge/stages/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hinge/stages/exporters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hinge/stages/exporters/csv_exporter.py,sha256=5uJsIvLufFoSSNRbaQ3A1w8utoP9fTeooL12niyAbpk,2369
+hinge/stages/exporters/dot_exporter.py,sha256=JCY8PMs2BdnaFyMHzfgDauFTIl_BSvTCGtiZiDsUBu4,434
+hinge/stages/exporters/gexf_exporter.py,sha256=iU3gUT3NyK6wimi_Hy_AxbKdjU1K6A7QTUNxg3p-t28,436
+hinge/stages/exporters/gml_exporter.py,sha256=2M1ZsJ3l55W_P3th8Nhy668dndLAGaSk6xWj8CyIRbY,2524
+hinge/stages/exporters/graphml_exporter.py,sha256=U028uKovQf4QRK2Hf-P1Q9qga_4Ez_W0mt0DIT5Z43c,442
+hinge/stages/exporters/jsonld_exporter.py,sha256=ja6O0-aH7JTT8s36J7LjU4x2ILbZaHO4Fqyfqag2tHc,440
+hinge/stages/exporters/networkx_exporter.py,sha256=hm4JAYkIQqujvbe_K6723QVOEnnUTfWuB8hLXb7Xnbs,1790
+hinge/stages/exporters/parquet_exporter.py,sha256=oA6a7qnSc20yIorPDpSwz_PnCoaDHTAuXqZbF8gsoSk,442
+hinge/stages/projection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hinge/stages/projection/dbt_projection.py,sha256=IBRf3dAd-VU8jvwTrntAnSD90D8W0MCpObM9XZCTzSQ,13867
+hinge/stages/projection/specs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hinge/stages/projection/specs/artifact_reference.py,sha256=MnlDLdsH28GgYrJnd-i6KVrU-VjOu33sEMjBChwYCWA,513
+hinge/stages/projection/specs/co_commit_user_user.py,sha256=VBh_BznSk_MocXdthVULhcyOar_ujui67D9KZHjyAao,456
+hinge/stages/projection/specs/co_edit_file_user_user.py,sha256=Uo6dn2eKwfac2elaH2eyhX7My_hGmTl-vSqD9W0JMVY,438
+hinge/stages/projection/specs/co_edit_line_user_user.py,sha256=Z2c-QzkXkakub02ys5La8lCXEVEPwNJTY47bN3TWjwc,447
+hinge/stages/projection/specs/dev_interaction.py,sha256=VyD08reBNg_ONliDEqeUb7iMnGGvY99TJN-aigi8Zng,1010
+hinge/stages/projection/specs/developer_repo_affiliation.py,sha256=s7kRN7bZvHpTDDn_JQdoN6TjBdOx5HTAPY7dUV24fSI,545
+hinge/stages/projection/specs/follow_user_user.py,sha256=7NuanWqd375m4pKObLgRlU3Y5cXyT_zAhV2OKdlT4z8,434
+hinge/stages/projection/specs/fork_repo_repo.py,sha256=o2qH9mc93yjI5LKEDNTTD2-XUvqORAruTCTF6uMSCs0,427
+hinge/stages/projection/specs/issue_co_participation.py,sha256=bhLDyii34qeNpgOMSFHJkeK2ZzX_rYKq7f4YSbS9TZ0,457
+hinge/stages/projection/specs/issue_participation.py,sha256=QNEzGOcL0PIrzAzqCOkc-LTCUXf9S5BEbi4j8UzXnew,466
+hinge/stages/projection/specs/pr_author_reviewer.py,sha256=h2b3uBHpQowuJXVud3QtUp5WyAazCAUZ9nu3yBzLRkA,438
+hinge/stages/projection/specs/pr_participation.py,sha256=eD8uN3gJTPABIWmn4S7Fq0TkTlaJ5Y8WyyK4pYWfKx8,471
+hinge/stages/projection/specs/pr_reviewer_coreview.py,sha256=ibxg38M6rtE900WYbyMyplf2HiNYfIysFaEFAtCJkOU,442
+hinge/stages/projection/specs/repo_shared_contributors.py,sha256=KzZkKv1_sKN4x8T2kLdbvIooZZGAs9BgH1IGnvzNvuY,472
+hinge/stages/projection/specs/star_user_repo.py,sha256=5ib-u7KSavgbtVd_BdSKzeZiFc2eSrZ51BVrhpVl7_w,476
+hinge/stages/projection/specs/user_mention_user.py,sha256=WFYAn915_ZOUl4FCirHJln3cTdKrAp3loRxJqYMhJC8,443
+hinge/stages/projection/specs/watch_user_repo.py,sha256=ZJylv-XXe-4urBrdWpgiuOLctsAounPEh47ffq8r-Ic,455
+hinge/stages/readers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hinge/stages/readers/_numfocus_contract_adapter.py,sha256=5owQzuMgaaFqFLdWUvUQVeC9qCGuinnoR8QhmJ2RU1A,21924
+hinge/stages/readers/numfocus_reader.py,sha256=dXFCjUGIy69CscNo2dctRFn01qE35EsXNYz9cnq282E,2653
+hinge/stages/store/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hinge/stages/store/duckdb_store.py,sha256=eZ9NLbodc_vtZ90hzR7rdo8WLfGD7Hyh8gLEML1xuoc,20155
+hinge-0.1.0.dist-info/METADATA,sha256=dZSn08Ct9oeGFoPyx4pFXaQc_ATMCDPam3WewpkBINw,10404
+hinge-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+hinge-0.1.0.dist-info/entry_points.txt,sha256=R0nw4ZNq1CBh87Y0NU6wXCIIgZNwEeMEhqvmSNcRGVY,1856
+hinge-0.1.0.dist-info/licenses/LICENSE,sha256=Yc8_1CXgv6_b-qpi-CU0Sq0fqJr570EtDQEgc-rs5CA,1075
+hinge-0.1.0.dist-info/RECORD,,

hinge-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

hinge-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,35 @@
+[console_scripts]
+hinge = hinge.frontends.cli.app:app
+
+[hinge.exporters]
+csv = hinge.stages.exporters.csv_exporter:CsvExporter
+gml = hinge.stages.exporters.gml_exporter:GmlExporter
+networkx = hinge.stages.exporters.networkx_exporter:NetworkXExporter
+
+[hinge.projection_specs]
+artifact-artifact-reference = hinge.stages.projection.specs.artifact_reference:SPEC
+repo-repo-fork = hinge.stages.projection.specs.fork_repo_repo:SPEC
+repo-repo-shared-contributors = hinge.stages.projection.specs.repo_shared_contributors:SPEC
+user-issue-participation = hinge.stages.projection.specs.issue_participation:SPEC
+user-pr-participation = hinge.stages.projection.specs.pr_participation:SPEC
+user-repo-affiliation = hinge.stages.projection.specs.developer_repo_affiliation:SPEC
+user-repo-star = hinge.stages.projection.specs.star_user_repo:SPEC
+user-repo-watch = hinge.stages.projection.specs.watch_user_repo:SPEC
+user-user-co-commit = hinge.stages.projection.specs.co_commit_user_user:SPEC
+user-user-co-edit-file = hinge.stages.projection.specs.co_edit_file_user_user:SPEC
+user-user-co-edit-line = hinge.stages.projection.specs.co_edit_line_user_user:SPEC
+user-user-follow = hinge.stages.projection.specs.follow_user_user:SPEC
+user-user-issue-co-participation = hinge.stages.projection.specs.issue_co_participation:SPEC
+user-user-mention = hinge.stages.projection.specs.user_mention_user:SPEC
+user-user-pr-author-reviewer = hinge.stages.projection.specs.pr_author_reviewer:SPEC
+user-user-pr-co-review = hinge.stages.projection.specs.pr_reviewer_coreview:SPEC
+user-user-repo-collaboration = hinge.stages.projection.specs.dev_interaction:SPEC
+
+[hinge.projections]
+dbt = hinge.stages.projection.dbt_projection:DbtProjection
+
+[hinge.readers]
+numfocus = hinge.stages.readers.numfocus_reader:NumFocusReader
+
+[hinge.stores]
+duckdb = hinge.stages.store.duckdb_store:DuckDBStore

hinge-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Filippo Scaramuzza
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.