Dart/Flutter package analyzer
This action uses the pana (Package ANAlysis) package to compute the score that your Dart or Flutter package will have on the Pub site.
This package, amongst other things:
- validates the code by performing static analysis with dartanalyzer,
- checks code formatting with
dartfmtorflutter format(detected automatically), - checks for outdated dependencies,
- validates the
pubspec.yamlfile (dependencies, description's length...), - checks for required files (
CHANGELOG,README,examplefolder...) - ...
The pana package gives scores in five categories and sum them up to get your total score.
Usage
You must include the actions/checkout step in your workflow. You don't need to run pub get or build a Dart container before.
This action uses its own Dart container. I recommend you to run it in a separate job, as jobs run in parallel.
Inputs
githubToken
Required to post a report on GitHub. Note: the secretGITHUB_TOKENis already provided by GitHub and you don't have to set it up yourself.relativePath
If your package isn't at the root of the repository, set this input to indicate its location.
Example:
name: Example workflow
on: [push, pull_request]
jobs:
package-analysis:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2 # required
- uses: axel-op/dart-package-analyzer@v3
with:
# Required:
githubToken: ${{ secrets.GITHUB_TOKEN }}
# Optional:
relativePath: packages/mypackage/
Outputs
There is an output for each of the six categories that are evaluated by the pana package, whose value is the score obtained by your package, plus an output for the total score of your package.
For each of these outputs, there is also a ..._max output corresponding to the maximum score that a package can have in the category.
There is also an output containing the full pana output in JSON format if you need to parse it yourself.
You can use the outputs in the next steps of your workfow by associating an id to this action. In the following steps, you can retrieve an output with ${{ steps.the_id.outputs.name_of_output }} (see the example below).
-
total&total_max
The total score of your package, and the maximum score that it can get. -
conventions&conventions_max
Score for the category Follow Dart file conventions. -
documentation&documentation_max
Score for the category Provide documentation. -
platforms&platforms_max
Score for the category Support multiple platforms. -
analysis&analysis_max
Score for the category Pass static analysis. -
dependencies&dependencies_max
Score for the category Support up-to-date dependencies. -
null_safety&null_safety_max
Score for the category Support null-safety. -
json_outputThepanaoutput in JSON format.
Usage example
name: Example workflow
on: [push, pull_request]
jobs:
package-analysis:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: axel-op/dart-package-analyzer@v3
# set an id for the current step
id: analysis
with:
githubToken: ${{ secrets.GITHUB_TOKEN }}
# You can then use this id to retrieve the outputs in the next steps.
# The following step shows how to exit the workflow with an error if the total score in percentage is below 50:
- name: Check scores
env:
# NB: "analysis" is the id set above. Replace it with the one you used if different.
TOTAL: ${{ steps.analysis.outputs.total }}
TOTAL_MAX: ${{ steps.analysis.outputs.total_max }}
run: |
PERCENTAGE=$(( $TOTAL * 100 / $TOTAL_MAX ))
if (( $PERCENTAGE < 50 ))
then
echo Score too low!
exit 1
fi
Example
2 Nov 11, 2022
3 Sep 13, 2022
18 Apr 14, 2022
7 Dec 21, 2022
5 Dec 12, 2022
6 Nov 10, 2022
30 Nov 11, 2022
0 Jan 7, 2022
0 Jan 1, 2022
3 Apr 15, 2022
3 May 22, 2022
3 Jun 22, 2022
110 Dec 23, 2022
401 Jan 4, 2023
261 Jan 7, 2023
198 Jan 5, 2023
11 Oct 10, 2022
0 Dec 27, 2021
17 Sep 16, 2022