@atomist/org-visualizer
Organization Visualizer using Atomist project scanning
Last updated 8 days ago by atomist .
Apache-2.0 · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @atomist/org-visualizer 
SYNC missed versions from official npm registry.

@atomist/org-visualizer

Visualize aspects of your organization. See Rod Johnson's blog for discussion of the motivation.

Extensible, with out of the box support for the following queries:

  • TypeScript
  • Spring Boot (with Maven)
  • Docker
  • Library versions
  • Inclusion of a code of conduct

An example visualization, showing Docker images:

Docker image visualization

Running

Please use Node 10+.

First, install with npm i.

Next, build with npm run build

Next, npm link to create the spider binary.

Database setup

Creating the Database

Data about each repository is stored locally in a Postgres database.

Start Postgres, connect to it, and run the create.ddl script to set up the database. You can do this within the psql shell, or use the Postgres admin tool to create a database named org-viz and run all commands in that script after the line beginning with \connect.

Connecting to the Database

Configure the Postgres database details in client.config.json in your ~/.atomist:

{
  "sdm": {
    "postgres": {
      "user": "<postgres user>",
      "password": "<postgres password",
      "host": "<postgres host>",
      "port": "<postgres port>",
      "database": "org_viz"
    }
  }
}

If ~/.atomist/client.config.json does not exist, create it with the above content.

Other Dependencies

You will need the following installed on your machine for the out of the box visualizations to work:

  • The git binary
  • Java
    • A JDK (not a JRE)
    • Maven - mvn must be on the path.
  • Node
  • npm

All artifacts referenced in Maven or Node projects must be accessible when the spider runs. Check by manually running mvn or npm on the relevant projects.

Analyze your repositories

You can start quickly by loading data from four open source organizations by running the script load-demo-data.sh.

GitHub

To analyze a GitHub organization, run the following command:

spider --owner <github organization> e.g. spider --owner atomist (not the full org URL).

To access private repositories, ensure that your GitHub token is available to Node processes via a GITHUB_TOKEN environment variable. (This will never be sent to Atomist.)

Local directories

To analyze local directories, wherever they were cloned from, use the --l flag and specify the full path of the parent directory of the repositories, as follows:

spider --l /Users/rodjohnson/atomist/projects/spring-team/ --u

General

Run spider with the --u flag to force updates to existing analyses. Do this if you have updated your analyzer code. (See Extending below.)

Now start the server with atomist start --local to expose the visualizations.

Go to http://localhost:2866.

Architecture

There are three architectural layers:

  1. Analysis. This is predominantly done by implementing Features from @atomist/sdm-pack-fingerprints. This also extends to the project analysis framework, from @atomist/sdm-pack-analysis. Scanners extract data
  2. Query functionality.
  3. Simple UI using React and d3 exposing Sunburst charts.

All three layers are extensible and customizable.

Extending

This project includes some well known features but it is intended for you to add your own.

Do this by updating the features constant defined in the features.ts file. Simply add features to this array:

export const features: ManagedFeature[] = [
    DockerFrom,
    new TypeScriptVersionFeature(),
    //... add your features here

After updating your code you will need to rerun existing analyses. Run the spider again with the --u flag to force updates on existing data.

Next Steps

The Atomist service is capable of keeping analyses up to date automatically, across all your repositories. It can also help to achieve consistency and convergence in eligible features by updating projects.

See https://atomist.com/developer.html for further information.


Created by Atomist. Need Help? Join our Slack workspace.

Current Tags

311 Versions

Maintainers (1)
Downloads
Today 1,538
This Week 9,902
This Month 53,830
Last Day 5,559
Last Week 23,315
Last Month 29,232
Dependencies (41)
Dev Dependencies (13)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |