Data

Tools

Indexes

Applications

Experiments

Open Source Science

Recent Releases of carbon-aware-sdk

carbon-aware-sdk - v1.8.0 Release

This release consolidates the ElectricityMaps sources, introduces new CO₂-intensity signal support in WattTime, and rounds out the release with documentation improvements and critical bug fixes https://github.com/Green-Software-Foundation/carbon-aware-sdk/labels/v1.8.

Added

And supporting issues:

  • #612 Documentation: Update wording about marginal signal
  • [#440 Feature Contribution]: Remove JSON examples from WebAPI container](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/440)
  • [#396 Feature Contribution]: Better to throw exception when future datetime is specified to endpoints for current/historical data](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/396)

Fixed

For more details, checkout https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/628

- HTML
Published by danuw about 1 year ago

carbon-aware-sdk - v1.7.0 Release

This release mainly introduces new clients libraries for NPM and Java https://github.com/Green-Software-Foundation/carbon-aware-sdk/labels/v1.7

Added

  • [PR #591] Publish WebAPI client library for NPM ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/591)
  • [PR #597] Add Client API documents for WebAPI 1.0.0 ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/597)
  • [PR #588] Add gh cli to devcontainer/codespace ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/588)
  • [PR #471] Add GHA workflow for generating WebAPI client library for Java ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/471)

Fixed

  • [#571] [Bug]: Cannot get the value of a token type 'Null' as a number ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/571)
  • [#570] [Bug]: webapi query on bylocation shows 24 hours worth of data even when smaller range requested ](https://github.com/Green-Software-Foundation/carbon-aware- sdk/issues/570)

For more details, checkout https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/601

- HTML
Published by danuw over 1 year ago

carbon-aware-sdk - v1.6.1 Release

Release addressing minor issues https://github.com/Green-Software-Foundation/carbon-aware-sdk/labels/v1.6.1

Added

  • [PR #531] Add configuration for tracing log](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/531)

Fixed

  • [PR #575] Consider null value in carbonIntensity on EM ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/575)
  • [PR #572] EM datasource didn't filter out-of-range emission data ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/572)

For more details, checkout https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/579

- HTML
Published by danuw over 1 year ago

carbon-aware-sdk - v1.6.0 Release

What's Changed

Release for milestone https://github.com/Green-Software-Foundation/carbon-aware-sdk/milestone/8?closed=1 with general bugs fixes and improvements

Added

  • [PR #555] Add a configuration for disabling to cache JSON emission data ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/555)
  • [PR #544] Add env directive to values.yaml and troubleshooting guide to avoid inotify limitation on Linux ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/544)
  • [PR #524] Add blog article for .NET 8 upgrade ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/524)
  • [PR #523] documentation-change.yml: Created issue template for documentation ch… ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/523)

Removed

Fixed

  • [#528] [Bug]: Avoid inotify limit in WebAPI container on Kubernetes ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/528)
  • [PR #553] Documentation: "it's" is used incorrectly several times ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/553)
  • [PR #551] Docs/blog update for releases 1.3 to1.5 and fix ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/551)

For more details, checkout https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/559

Full Changelog: https://github.com/Green-Software-Foundation/carbon-aware-sdk/compare/v1.5.0...v1.6.0

- HTML
Published by danuw over 1 year ago

carbon-aware-sdk - v1.5.0 Release

[1.5.0] - 2024-05

This is the WattTime v3 update. Most notable changes that may require action are for deployment configuration, and these are minor.

Added

WattTime v3 API support. This is an inplace upgrade for v2.

  • [PR #532] Watt Time v3 Support ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/532)
  • [PR #340] Add example for 'podman play kube' ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/340)
  • [PR #536] Updated azure-regions.json with new regions ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/536)
  • [#519] Remove hackathon sentence from our website banner ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/519)
  • [#510] Gap Analysis for WattTime v3 ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/510)
  • [#262] [Feature Contribution]: Publish the docker file in a docker registry ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/262)

Removed

WattTime v2 API support due to v3 in place replacement.

Fixed

  • [PR #522] Remove Hack mention from the Docs's banner ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/522)
  • [#535] [Bug]: Configuration for locations loads twice ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/535)
  • [PR #516] Update published documentation to .NET 8 ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/516)
  • [PR #515] overview.md: Fixed three broken links Signed-off-by: joecus1 <joecusa… ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/515)
  • [#506] Check our published documentation to identify any references to .NET7 ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/506)
  • [#512] [Bug]: Broken links in overview.md file ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/512)

Changed

Updates for WattTime v3 API endpoint from v2, details in the ADR for WattTime v3 changes.

API

No changes

API Deployment

Due to the change for WattTime v3, there is change to the configuration for WattTime users.

With some of the changes to the code, some of the configuration will also needs to change.

| Config (v2) | Config (v3) | Description | |------------------------------------|----------------------------------|------------------------------| | BalancingAuthorityCacheTTL | RegionCacheTTL | This is the cache for regions data in seconds, and has a default value of 1 day. This only needs updating if you set it | | n/a | AuthenticationBaseUrl | NEW This is the base URL for the WattTime Authentication API and defaults to https://api.watttime.org/ if not set. |

Example below if set (note they do not have to be set) json "wattTime_no-proxy": { "Type": "WattTime", "Username": "the_username", "Password": "super_secret_secret", "BaseURL": "https://api.watttime.org/v3/", "AutenticationBaseURL": "https://api.watttime.org", // This is new but not mandatory in config "RegionCacheTTL": 86400, // This is changed but not mandatory in config "Proxy": { "UseProxy": false }

SDK

No changes

Other

No changes

For more details, checkout https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/503

- HTML
Published by danuw almost 2 years ago

carbon-aware-sdk - v1.4.0 Release

.NET 8 upgrade release of the Carbon Aware SDK. A big thank you for all of those who contributed.

Release notes for 1.4.0 below and in the repo!

Summary

This the .net 8 upgrade release for the Carbon Aware SDK with fixes, quality of life changes, and updated documentation.

Changes

Added

-[#401] [Feature Contribution]: Upgrade .NET version to .NET 8 ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/401) -[#419] [Feature Contribution]: Migrate sample implementation of Azure Function to isolated worker model ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/419) -[PR #500] Up Helm chart version to 1.2.0 ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/500)

-[#397] [Feature Contribution]: Data caching in the SDK ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/397)

Fixed

-[#505] [Bug]: Project Page wiki from GSF website still says it's in incubation ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/505) -[#496] [URGENT] WebAPI container has not built due to segmentation fault ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/496) -[#487] [Bug]: Getting started guide is lost ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/487)

Changed

-[#477] [Bug]: Ensure the readme file shows as the project overview content on the documentation site ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/477) -[PR #485] Docs overview, disclaimer & pipeline updates for graduation ](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/485)

For more details, checkout https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/503

- HTML
Published by danuw about 2 years ago

carbon-aware-sdk - v1.2.0 Release

[1.2.0] - 2024-01

Added

  • #381 Add Helm chart and workflow
  • New package release for Helm charts available at https://github.com/Green-Software-Foundation/carbon-aware-sdk/pkgs/container/charts%2Fcarbon-aware-sdk

Fixed

Changed

Other

  • Improved process leveraging the project boards at https://github.com/orgs/Green-Software-Foundation/projects/15/views/2

Thank You

Once again a big thank you to everyone that has contributed, guided, and given feedback. Much appreciated.

For more details, checkout https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/232

- HTML
Published by danuw over 2 years ago

carbon-aware-sdk - v1.1.0 Release

[1.1.0] - 2023-18-07

Added

  • Added Electricity Maps (paid api) support for forecasting and historical data.
  • Added ElectricityMaps (free api) support for historical data. Note that this API does not support forecast capabilities.

Fixed

  • Fixed generated test data that had time bomb bug that was in test data, which caused integration tests to fail. This is now automatically generated each time.
  • Fixed some bugs that related to underlying data source errors surfacing as HTTP 500 errors from the API. These should now be more consistent.
  • Fixed an issue where UTF-8 passwords were encoded as ASCII for WattTime API, causing integration failure.
  • Fixes some bugs in unit tests with uncaught scenarios, or faulty tests.

Changed

  • No previous API's were changed.
  • Configuration has changed. Refer to upgrading from 1.0.0 to 1.1.0 below.
  • Time is now always in UTC. Previously the API may have returned local time depending on underlying API.

API

  • /locations - Show the list of configured named locations that can be used in the API.
  • /api/v1/swagger.yaml - Provides OpenAPI document now at public endpoint when deployed.

API Deployment

  • Configuration has changed. Refer to upgrading from 1.0.0 to 1.1.0 below.

SDK

  • SDK was abstracted to provide a library for DLL import usage, which now allows users to use the SDK in their projects directly without the need to deploy an API. This is useful in scenarios where the API can not be centralised. Note - we still highly recommend centralising for management of the API and audit capabilities with observability.
  • Functionality for forecast and historical data have been seperated into seperate interfaces. This impacts configuration, see upgrading from 1.0.0 to 1.1.0 for more information.
  • Additional tests across the SDK have been added.
  • Aggregation tier in the SDK was removed, this should not impact users of the SDK, but may impact maintainers who were actively contributing.

Other

  • All contributors need to signoff commits for contribution using git commit -s.
  • Added PR release workflow improvements for the project management of the CA SDK project team.
  • Updated the project to prune stale PR's and issues to help with the management of the CA SDK project.

Upgrading from 1.0.0 to 1.1.0

  • Configuration changes are required due to historical and forecast configuration now being decoupled. Refer to - Configuration for a guide. The following is provided as an example of the new data source configuration format. json { "DataSources": { "EmissionsDataSource": "Json", "ForecastDataSource": "WattTime", "Configurations": { "WattTime": { "Type": "WattTime", "Username": "username", "Password": "password", "BaseURL": "https://api2.watttime.org/v2/", "Proxy": { "useProxy": true, "url": "http://10.10.10.1", "username": "proxyUsername", "password": "proxyPassword" } }, "ElectricityMaps": { "Type": "ElectricityMaps", "APITokenHeader": "auth-token", "APIToken": "myAwesomeToken", "BaseURL": "https://api.electricitymap.org/v3/" }, "Json": { "Type": "Json", "DataFileLocation": "test-data-azure-emissions.json" } } } }

- HTML
Published by vaughanknight almost 3 years ago

carbon-aware-sdk - v1.0.0 First Release

Release 1.0!

Contains CLI and WebApi support for: - Emissions by location and time - Emissions by locations and time - Best emissions by locations and time - Forecast data by location and time - Historical forecast data by location and time - Average carbon intensity by location and time

Data source support includes: - WattTime API - Static JSON support

Also contains client generation support for an extensive array of languages from the Open AI / Swagger specification.

Thank you for all who contributed, from code, discussions and ideas, bug fixes, sharing, and management support.

- HTML
Published by vaughanknight over 3 years ago