green-elephpant/carbon-aware

SDK to help your applications reduce carbon emissions

dev-main 2024-04-29 22:13 UTC

Requires

• php: >=7.4
• ext-json: *
• psr/http-client: ^1.0
• psr/http-factory: ^1.0
• psr/simple-cache: ^1.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.3
• nyholm/psr7: ^1.8
• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^9
• roave/security-advisories: dev-latest

MIT

• Carsten Windler

README

Green ElePHPant - CarbonAware

The Green ElePHPant wants to help you to reduce the carbon emissions of your software.

One way of doing so is to utilize energy when it is the "greenest" - i.e., when it most of it comes from renewable energies rather burning fossil fuels.

GreenElephpant\CarbonAware is a simple wrapper for APIs that provide information about the current or future carbon intensity at many regions worldwide. Currently, we support CO2Signal and Electricity Maps. Hopefully more to come!

Key concept

Building carbon aware applications means that certain activities or jobs will not, or at least in lower frequency, be carried out if the carbon intensity is too high.

For example, if the carbon intensity is low, we can update a dashboard more often than if it is not:

if ($carbonAwareService->isLow()) {
    $schedule
        ->command('dashboard:update')
        ->everyFiveMinutes();
} else {
    $schedule
        ->command('dashboard:update')
        ->everyTenMinutes();
}

Installation

Simply use composer to add GreenElephpant\CarbonAware to your project:

composer require green-elephpant/carbon-aware

Configuration

GreenElephpant\CarbonAware is designed to require as few external dependencies as possible so that it can fit in almost every project. It uses several PSR for e.g. HTTP messages (PSR-17) and clients (PSR-18), so it won't work out of the box but require a bit (but not a lot) of hand wiring.

TODO: Laravel package TODO: remove these 2 from carbonaware? "php-http/message-factory": "^1.0", "php-http/httplug": "^2.3"

use Buzz\Client\Curl;use GreenElephpant\CarbonAware\Connector\Co2Signal;use GreenElephpant\CarbonAware\Service\CarbonAwareService;use Nyholm\Psr7\Factory\Psr17Factory;

// Create HTTP client with HTTP message factory
// E.g. nyholm/psr7 and kriswallsmith/buzz
$psr17Factory = new Psr17Factory();
$psr18Client = new Curl($psr17Factory);

// Create Connector (here: for CO2Signal)
$co2SignalConnector = new Co2Signal(
    'your_apikey',
    $psr18Client,
    $psr17Factory
);

// Setup location (the region of the world you want to get the information for)
$location = new GreenElephpant\CarbonAware\Location\Location('DE');

// Finally create the CarbonAwareService instance, using the connector and the location
$carbonAwareService = new CarbonAwareService($co2SignalConnector, $location);