/sourcecred-tooling

Exploring SourceCred graphs

Primary LanguagePythonApache License 2.0Apache-2.0

sourcecred-tooling

This repository includes a set of scripts and other tools to play with the graphs created by SourceCred

Converters

  • convert_cred_to_graph: Converts CRED graphs (cred.json files) into other kind of graphs using the igraph-python library
  • convert_credResult_to_graph: Converts CRED graphs (credResult.json files) into other kind of graphs using the igraph-python library. The format of the input CRED graph must be a JSON file generated by the cli2 command. This file follows the credResult.js type definition
  • convert_outputV2_to_graph: Converts CRED graphs (output.json files) into other kind of graphs using the igraph-python library. This version of the script supports the new output v2 format added by this commit
  • convert_graph_to_D3JSON: Convert graphs (formats supported by igraph-python library, i.e., the output of the previous scripts) into a D3-comaptible JSON
  • convert_graph_to_graph: Converts CRED graphs (graph.json files) into other kind of graphs using the igraph-python library

Viewers

  • view_graph.py: Shows igraph-supported graph files
  • view_graph_D3.html: HTML page using the JSON output of convert_graph_to_D3JSON to visualize the graph using D3

Injecters & Modifiers

  • inject_weidght_to_graph.py: Injects a weights definition into a cred graph definition (created by the cli2 graph command)

CSV helpers

  • analyze_credResult_cred.py: Generates a CSV file from credResult graphs summarizing the cred accumulated per node in the graph
  • analyze_credResult_contributors.py: Generates a CSV file from credResult graphs summarizing the contributions of the user nodes in the graph
  • join_csvs.py: Given two CSVs generated by analyze_credResult.py, this script joins the CSV data by selecting only users (USERLIKE) rows and joining via their username. The result is printed in STDOUT
  • digest_csvs.py: Generates an HTML page (via STDOUT) including tables for the data generated by join_csvs.py script.

Ad-hoc stuff

  • view_graph_D3_codersVScommenters.html: HTML page that does the same as view_graph_D3.html plus changing the color of nodes according to cred values in the node. Please, check the comments at the header file