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

@grnsft/if-eco-ci-plugin

v0.0.2

Published

EcoCI plugin for Impact Framework.

Downloads

58

Readme

Impact Framework Eco CI Plugin

Overview

The EcoCI plugin retrieves the energy and the carbon of the workflow of the given repository using the Green Coding API, if the workflow of the repository is listed in the CI projects.

Implementation

The EcoCI plugin fetches the energy and carbon of the specified workflow from the Green Coding API for each entry in a manifest's input data.

  • The timestamp and duration fields in the input data are used to filter the energy and carbon data. The relevant endpoint is documented here.

Usage

To run the EcoCI plugin, an instance of ExecutePlugin must be created. Then, the plugin's execute() method can be called, passing the required arguments to it.

This is how you could run the model in Typescript:

async function runPlugin() {
  const config = {
    repo: 'Green-Software-Foundation/if',
    branch: 'main',
    workflow: 66389738,
  };
  const parameterMetadata = {inputs: {}, output: {}};
  const ecoCi = EcoCI(config, parameterMetadata, {});
  const usage = await ecoCi.execute([
    {
      timestamp: '2024-07-09T00:00',
      duration: 126000,
    },
  ]);

  console.log(usage);
}

runPlugin();

Config

  • repo: (required) string specifies the name of the organization (or owner) and repository name, combined with /, e.g. Green-Software-Foundation/if
  • branch: (required) string specifies the branch of the repository. You can also use the all option to retrieve data for all branches within the specified time range
  • workflow: (required) number specifies the workflow id of the repository
  • start-date: (optional) string specifies the start of the time range for retrieving data. If not provided, the plugin defaults to using a timestamp from the input.
  • end-date: (optional) string specifies the end of the time range. If not provided, the plugin defaults to using the duration from the input.

Input Parameters

  • timestamp: (required) specifies the start of the time range for retrieving data from the EcoCI API.
  • duration: (required) specifies the end of the time range for retrieving data from the API. It can be either number or string like 24 * 60 * 60.

Mapping

The mapping block is an optional block. It is added in the plugin section and allows the plugin to map the output parameters of the plugin. The structure of the mapping block is:

eco-ci-plugin:
  path: if-eco-ci-plugin
  method: EcoCI
  mapping:
    energy: 'energy-used-in-if-all'
    carbon: 'carbon-used-in-if-all'

Output

  • energy: output the size of the given repository, represented in kWh.
  • carbon: output the clones count of the given repository in the specified time range, represented in gCo2eq.

Error Handling

The plugin can throw the following errors:

  • APIRequestError: caused by a problem retrieving data from the API. The error message returned from the API is echoed in the IF error message.
  • InputValidationError: thrown when some data in the input is incorrect or missing.
  • ConfigError: thrown when some data in the global config is incorrect or missing.

Integration into Impact Framework

Clone this repository to your local machine to play with a local copy. In the project root run npm run build && npm link.

This creates a package with global scope on your local machine that can be installed by your instance of Impact Framework.

Navigate to the Impact Framework root, and run npm link if-eco-ci-plugin.

Now, you can use the plugin by including it in your manifest file as follows:

name: eco-ci demo
description:
tags:
initialize:
  plugins:
    ci/cd:
      method: EcoCI
      path: 'if-eco-ci-plugin'
      config:
        repo: 'Green-Software-Foundation/if'
        branch: all
        workflow: 66389738
        start-date: 2024-07-24T10:30
        end-date: 2024-08-14T10:30
      mapping:
        energy: 'energy-used-in-if-all'
        carbon: 'carbon-used-in-if-all'
tree:
  children:
    child:
      pipeline:
        compute:
          - ci/cd
      inputs:
        - timestamp: 2024-07-09T00:00
          duration: 24 * 60 * 60

Now, when you run the manifest using the IF CLI, it will load the model automatically. Run using:

if-run -m <path-to-your-manifest>

References

The plugin simply grabs data for a given repository from the Green Coding API.

  • To calculate energy and carbon, the plugin uses this endpoint.