npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@gros/collaboration-graph

v0.0.1

Published

Graph of relations between project members and the projects they work on.

Downloads

4

Readme

Collaboration Graph

This visualization produces a directed graph of relations between project members and the projects they work on.

Configuration

Copy the file lib/config.json to config.json and adjust environmental settings in that file. The current configuration options are:

  • encrypt_url: The URL prefix for the encryption endpoint server to connect to request the encrypted version of a name for searching purposes. The server must have this JSON endpoint, when given the unencrypted value in a query string, provide a result, which is a JSON object containing at least two items: the encrypted variant of the provided value with the key value, and the encryption level of this variant with the ecncryption key. The controller API in the data-gathering repository has an encrypt endpoint that is compatible with this expected response. If the URL is an empty string, then searching for persons with encrypted names in the graph is not possible.
  • visualization_url: The URL to the visualization hub. This may include a protocol and domain name, but does not need to in case all the visualizations and the collaboration graph are hosted on the same domain (for example in a development environment). The remainder is a path to the root of the visualizations, where the dashboard is found and every other visualization has sub-paths below it.
  • path: The relative path at which the collaboration graph is made available on the server. This can remain the default . to work just fine.
  • lower_names: An array of strings with parts of person (family) names that should remain lowercased when trying to search a person through its encrypted variant. Common Dutch family name affixes (tussenvoegsels) are kept lowercase by the default value.

Data

The data for the collaboration graph can be analyzed and output through runs of scripts from the data-analysis repository upon a collection of Scrum data in a Grip on Software database. The project_members analysis report in that repository can export the sprint data in the JSON formats that is expected by the sprint report. Using the --interval argument on the report.r script, intervals of project membership data can be collected for the timelapse function of the collaboration graph. The entire data collection must be placed in the public/data directory.

Running

The visualization can be built using Node.js and npm by running npm install and then either npm run watch to start a development server that also refreshes browsers upon code changes, or npm run production to create a minimized bundle. The resulting HTML, CSS and JavaScript is made available in the public directory.

This repository also contains a Dockerfile specification for a Docker image that can perform the installation of the app and dependencies, which allows building the visualization within there. Additionally, a Jenkinsfile contains appropriate steps for a Jenkins CI deployment, including data collection and visualization building.