📝 Add changelog entry

🎉 Added saturation and lightness parameters to ColorRange feature

.github/workflows/badges.yml

@@ -15,7 +15,9 @@ jobs:
           auth: ${{ secrets.GIST_SECRET }}
           gistID: 2ab8f1d386f13aaebccbd87dac94068d
           filename: answer.json
-          label: The Answer is
+          label: The Answer
-          message: ${{ env.ANSWER }}
+          message: is ${{ env.ANSWER }}
-          color: green
+          valColorRange: ${{ env.ANSWER }}
+          maxColorRange: 100
+          minColorRange: 0
 

README.md

@@ -39,7 +39,7 @@ https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/schneegan
 4. Add something like the following to your workflow:
 ```yml
 - name: Create Awesome Badge
-  uses: schneegans/dynamic-badges-action@v1.1.0
+  uses: schneegans/dynamic-badges-action@v1.2.0
   with:
     auth: ${{ secrets.GIST_SECRET }}
     gistID: <gist-ID>
@@ -58,20 +58,26 @@ Embed the badge with:
 ![badge](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/<user>/<gist-ID>/raw/test.json)
 ```
 
-### Input Parameters
+### Required Input Parameters
 
-The **Badge Parameters** are directly passed to [shields.io](https://shields.io). See the [official documentation](https://shields.io/endpoint) for more detailed explanations.
+Parameter | Description
-
+----------|------------
-Gist Parameter | Description
+`auth` | A secret token with the *gist* scope.
+`gistID` | The ID of the target gist. Something like `8f6459c2417de7534f64d98360dde866`.
+`filename` | The target filename - each gist may contain several files. This should have the `.json` extension.
+
+
+### Shields.io Parameters (optional)
+
+All these parameters are optional.
+They are directly passed to [shields.io](https://shields.io). See the [official documentation](https://shields.io/endpoint) for more detailed explanations.
+
+Parameter | Description
 ----------|------------
-`auth` | Required. A secret token with the *gist* scope.
-`gistID` | Required. The ID of the target gist. Something like `8f6459c2417de7534f64d98360dde866`.
-`filename` | Required. The target filename - each gist may contain several files. This should have the `.json` extension.
-**Badge Parameter** | **Description**
 `label` | Required. The left text of the badge.
 `message` | Required. The right text of the badge.
 `labelColor` | The left color of the badge.
-`color` | The right color of the badge. For custom colors wrap color string in quotes `"#bf155b"`
+`color` | The right color of the badge. For custom colors wrap color string in quotes `"#bf155b"`. This parameter is ignored if the `valColorRange`, `maxColorRange`, and `minColorRange` are set.
 `isError` | The color will be red and cannot be overridden.
 `namedLogo` | A logo name from [simpleicons.org](http://simpleicons.org/).
 `logoSvg` | An svg-string to be used as logo.
@@ -81,25 +87,46 @@ Gist Parameter | Description
 `style` | The style like "flat" or "social".
 `cacheSeconds` | The cache lifetime in seconds (must be greater than 300).
 
+### Color Range Parameters (optional)
+
+Starting with version 1.3.0 of this action, the color of the right side of the badge can be computed automatically on a green-to-red color-scale.
+For this, the following parameters can be used.
+
+Parameter | Description
+----------|------------
+`valColorRange` | A numerical value used to define the message color. Usually this should be between `maxColorRange` and `minColorRange`. This is required if you want to use the color range feature.
+`maxColorRange` | If `valColorRange` assumes this value, the badge will be green. This is required if you want to use the color range feature.
+`minColorRange` | If `valColorRange` assumes this value, the badge will be red. This is required if you want to use the color range feature.
+`invertColorRange` | If the range should be inverted, causing a smaller value to have green color. Defaults to `false`.
+`colorRangeSaturation` |  Saturation used by the color range feature. Defaults to 100.
+`colorRangeLightness` |  Lightness used by the color range feature. Defaults to 40.
+
+
 ### Using Environment Variables as Parameters [![badge](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/schneegans/2ab8f1d386f13aaebccbd87dac94068d/raw/answer.json)](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/schneegans/2ab8f1d386f13aaebccbd87dac94068d/raw/answer.json)
 
-A common usage pattern of this action is to create environment variables in previous steps of a job and later use them as message in your badge. This can be achieved like this:
+A common usage pattern of this action is to create environment variables in previous steps of a job and later use them as message in your badge.
+How this can be done, is shown in the following example.
+
+This example also shows how to use the automatic color range feature: If the answer is <= 0, the badge will be red, if it's >= 100 it will be green.
+For all values in between, the color will be interpolated.
 
 ```yml
 - name: Get the Numbers
   run: echo "ANSWER=42" >> $GITHUB_ENV
 - name: Create the Badge
-  uses: schneegans/dynamic-badges-action@v1.1.0
+  uses: schneegans/dynamic-badges-action@v1.2.0
   with:
     auth: ${{ secrets.GIST_SECRET }}
     gistID: <gist-ID>
     filename: answer.json
-    label: The Answer is
+    label: The Answer
-    message: ${{ env.ANSWER }}
+    message: is ${{ env.ANSWER }}
-    color: green
+    valColorRange: ${{ env.ANSWER }}
+    maxColorRange: 100
+    minColorRange: 0
 ```
 
-# Contributing to Dynamic Badges Action
+## Contributing to Dynamic Badges Action
 
 Whenever you encounter a :beetle: **bug** or have :tada: **feature request**, 
 report this via [Github issues](https://github.com/schneegans/dynamic-badges-action/issues).
@@ -107,7 +134,7 @@ report this via [Github issues](https://github.com/schneegans/dynamic-badges-act
 We are happy to receive contributions in the form of **pull requests** via Github.
 Feel free to fork the repository, implement your changes and create a merge request to the `master` branch.
 
-## Git Commit Messages
+### Git Commit Messages
 
 Commits should start with a Capital letter and should be written in present tense (e.g. __:tada: Add cool new feature__ instead of __:tada: Added cool new feature__).
 You should also start your commit message with **one** applicable emoji. This does not only look great but also makes you rethink what to add to a commit. Make many but small commits!
@@ -126,7 +153,7 @@ Emoji | Description
 :fire: `:fire:` | When you removed something.
 :truck: `:truck:` | When you moved / renamed something.
 
-## Version Numbers
+### Version Numbers
 
 Version numbers will be assigned according to the [Semantic Versioning](https://semver.org/) scheme.
 This means, given a version number MAJOR.MINOR.PATCH, we will increment the:

action.yml

@@ -49,6 +49,24 @@ inputs:
   cacheSeconds:
     description: 'The cache lifetime in seconds (must be greater than 300)'
     required: false
+  valColorRange:
+    description: 'A numerical value used to define the message color. Usually this should be between maxColorRange and minColorRange. This is required if you want to use the color range feature.'
+    required: false
+  maxColorRange:
+    description: 'If valColorRange assumes this value, the badge will be green. This is required if you want to use the color range feature.'
+    required: false
+  minColorRange:
+    description: 'If valColorRange assumes this value, the badge will be red. This is required if you want to use the color range feature.'
+    required: false
+  invertColorRange:
+    description: 'If the range should be inverted, causing a smaller value to have green color. Defaults to false.'
+    required: false
+  colorRangeSaturation:
+    description: 'Saturation used by the color range feature. Defaults to 100.'
+    required: false
+  colorRangeLightness:
+    description: 'Lightness used by the color range feature. Defaults to 40.'
+    required: false
 runs:
   using: 'node12'
   main: 'index.js'

changelog.md

@@ -1,5 +1,13 @@
 # Changelog of the Dynamic Badges Action
 
+## [Dynamic Badges Action 1.3.0](https://github.com/Schneegans/dynamic-badges-action/tree/v1.3.0)
+
+**Release Date:** 2022-04-18
+
+#### Changes
+
+* Added the possibility to generate the badge color automatically between red and green based on a numerical value and its bounds. Thanks to [@LucasWolfgang](https://github.com/LucasWolfgang) for this contribution!
+
 ## [Dynamic Badges Action 1.2.0](https://github.com/Schneegans/dynamic-badges-action/tree/v1.2.0)
 
 **Release Date:** 2022-03-26

index.js

@@ -13,9 +13,49 @@ try {
     message: core.getInput('message')
   };
 
+  // Compute the message color based on the given inputs.
+  const color                = core.getInput('color');
+  const valColorRange        = core.getInput('valColorRange');
+  const minColorRange        = core.getInput('minColorRange');
+  const maxColorRange        = core.getInput('maxColorRange');
+  const invertColorRange     = core.getInput('invertColorRange');
+  const colorRangeSaturation = core.getInput('colorRangeSaturation');
+  const colorRangeLightness  = core.getInput('colorRangeLightness');
+
+  if (minColorRange != '' && maxColorRange != '' && valColorRange != '') {
+    const max = parseFloat(maxColorRange);
+    const min = parseFloat(minColorRange);
+    const val = parseFloat(valColorRange);
+
+    if (val < min) val = min;
+    if (val > max) val = max;
+
+    let hue = 0;
+    if (invertColorRange == '') {
+      hue = Math.floor((val - min) / (max - min) * 120);
+    } else {
+      hue = Math.floor((max - val) / (max - min) * 120);
+    }
+
+    let sat = 100;
+    if (colorRangeSaturation != '') {
+      sat = parseFloat(colorRangeSaturation);
+    }
+
+    let lig = 40;
+    if (colorRangeLightness != '') {
+      lig = parseFloat(colorRangeLightness);
+    }
+
+    content.color = 'hsl(' + hue + ', ' + sat + '%, ' + lig + '%)';
+
+  } else if (color != '') {
+
+    content.color = color;
+  }
+
   // Get all optional attributes and add them to the content object if given.
   const labelColor   = core.getInput('labelColor');
-  const color        = core.getInput('color');
   const isError      = core.getInput('isError');
   const namedLogo    = core.getInput('namedLogo');
   const logoSvg      = core.getInput('logoSvg');
@@ -29,10 +69,6 @@ try {
     content.labelColor = labelColor;
   }
 
-  if (color != '') {
-    content.color = color;
-  }
-
   if (isError != '') {
     content.isError = isError;
   }