Output Granularity for Easier Integration

[Terre8055]

Issue Description:
Hello,

I have been using the DeveloperMetrics/deployment-frequency GitHub Action to track deployment frequency metrics. While the Action works well, I have encountered some challenges when trying to integrate the results with other applications, such as Slack or visualization tools

Current Situation:

The Action currently outputs the metrics in a markdown file. To extract specific values, such as deployment frequency results, I need to use additional commands like sed to parse the file. For example:

DEPLOYMENT_FREQUENCY_RESULTS=$(cat "${{ steps.deployment-frequency.outputs.markdown-file }}" | sed -n '/Results:/p' | sed 's/\*\*/\*/g')

Could the outputs be made like this

outputs:
  deployment-frequency: "3.33 per day"
  deployment-frequency-rating: "Elite"
  deployment-period: "30 days"
  active-deployment-days: "4 days"

[Creatur3245]

Ok, so I made several versions of your request (above:Output Granularity for Easier Integration, issue #60). This is Version 1 of proposed changes to the action.yml file.

name: 'DORA deployment frequency'
description: 'A GitHub Action to roughly calculate DORA deployment frequency'
author: developermetrics.org 
branding:
  icon: activity
  color: gray-dark
inputs:
  workflows: # required. string array of the name of the workflows to process
    description: the workflow name that is being scanned. Separate multiple workflows with commas
    required: true
  owner-repo: # optional, defaults to current owner/repo
    description: target org/repo to run the calculation on
    required: true
    default: "${{ github.repository }}"
  default-branch:  # optional, defaults to main
    description: branch that is deploying to production
    required: true
    default: 'main'
  number-of-days: # optional, defaults to 30
    description: number of days to scan
    required: true
    default: "30"
  pat-token: # optional, defaults to an empty string ("")
    description: GitHub PAT Token
    default: ""
  actions-token: # optional, defaults to an empty string ("")
    description: GitHub Actions Token, commonly passed in as a variable (secrets.GITHUB_TOKEN)
    default: ""
  app-id:
    description: 'application id of the registered GitHub app'
    default: ""
  app-install-id:
    description: 'id of the installed instance of the GitHub app'
    default: ""
  app-private-key:
    description: 'private key which has been generated for the installed instance of the GitHub app'
    default: ""
outputs:
  markdown-file:
    description: "The markdown that will be posted to the job summary, so that the markdown can saved and used other places (e.g.: README.md)"
    value: ${{ steps.deployment-frequency.outputs.markdown-file }}
  deployment-frequency:
    description: "Deployment frequency value"
    value: ${{ steps.deployment-frequency.outputs.deployment-frequency }}
  deployment-frequency-rating:
    description: "Deployment frequency rating"
    value: ${{ steps.deployment-frequency.outputs.deployment-frequency-rating }}
  deployment-period:
    description: "Deployment period"
    value: ${{ steps.deployment-frequency.outputs.deployment-period }}
  active-deployment-days:
    description: "Number of active deployment days"
    value: ${{ steps.deployment-frequency.outputs.active-deployment-days }}
runs:
  using: "composite"
  steps:
    - name: Run DORA deployment frequency
      id: deployment-frequency
      shell: pwsh
      run: |
          $result = ${{ github.action_path }}/src/deploymentfrequency.ps1 -ownerRepo "${{ inputs.owner-repo }}" -workflows "${{ inputs.workflows }}" -branch "${{ inputs.default-branch }}" -numberOfDays "${{ inputs.number-of-days }}"
          $filePath="dora-deployment-frequency-markdown.md"
          Set-Content -Path $filePath -Value $result
          "markdown-file=$filePath" | Out-File -FilePath $env:GITHUB_OUTPUT -Append
          
          # Extract and set additional outputs
          $deployment_frequency = "3.33 per day" # Example value, replace with actual extraction logic
          $deployment_frequency_rating = "Elite" # Example value, replace with actual extraction logic
          $deployment_period = "30 days" # Example value, replace with actual extraction logic
          $active_deployment_days = "4 days" # Example value, replace with actual extraction logic
          
          "deployment-frequency=$deployment_frequency" | Out-File -FilePath $env:GITHUB_OUTPUT -Append
          "deployment-frequency-rating=$deployment_frequency_rating" | Out-File -FilePath $env:GITHUB_OUTPUT -Append
          "deployment-period=$deployment_period" | Out-File -FilePath $env:GITHUB_OUTPUT -Append
          "active-deployment-days=$active_deployment_days" | Out-File -FilePath $env:GITHUB_OUTPUT -Append
          
          Write-Output $result >> $env:GITHUB_STEP_SUMMARY

Would you like to continue these changes now, or is there anything efor other Versions? Please let me know about these modifications and/or after you check?