tool: create tool to bump analysis version (#112)

Author: alestiago

CONTRIBUTING.md

@@ -42,9 +42,20 @@ accepted.
 
 Every snapshot of a version is saved on its own yaml file under the name pattern: `lib/analysis_options.<version>.yaml`.
 
-To release a new version:
+### Release a new version
+
+1. Run the `bump_version` script with the desired new version as an argument:
+
+```sh
+dart tool/bump_version/main.dart <version>
+```
+
+Where `<version>` is the new version to be released in the format `x.y.z`.
+
+This script will:
+
+- Copy the most recent yaml to a new one with the new desired version.
+- Include that file on the main yaml file `lib/analysis_options.yaml`.
 
-1. Copy the most recent yaml to a new one with the new desired version.
-1. Include that file on the main yaml file `lib/analysis_options.yaml`.
 1. Update the `README.md` exclusion table, refer to the ["Exclusion Reason Table 🗞️👨‍⚖️"](tool/linter_rules/README.md#exclusion-reason-table-️️) documentation for more information.
 1. Open a pull request with the proposed changes.

tool/bump_version/main.dart

@@ -0,0 +1,51 @@
+/// Bumps the version of the analysis options file.
+///
+/// This script will:
+/// - Copy the most recent yaml to a new one with the new desired version.
+/// - Include that file on the main yaml file `lib/analysis_options.yaml.
+///
+/// ## Usage
+///
+/// Run this script (from project root):
+///
+/// ```sh
+/// dart tool/bump_version/main.dart <new_version>
+/// ```
+///
+/// Where `<new_version>` is the new version to bump to in the format `x.y.z`.
+/// For example: `7.0.0`.
+library;
+
+import 'dart:io';
+
+/// A regular expression to match the latest analysis options version.
+///
+/// Given the following:
+///
+/// ```sh
+/// include: package:very_good_analysis/analysis_options.6.0.0.yaml
+/// ```
+///
+/// It is expected that the first matched group will be `6.0.0`.
+final _latestAnalysisVersionRegExp =
+    RegExp(r'analysis_options\.(\d+\.\d+\.\d+)\.yaml');
+
+void main(List<String> args) {
+  final analysisOptionsFile = File('lib/analysis_options.yaml');
+  final content = analysisOptionsFile.readAsStringSync();
+  final latestVersion =
+      _latestAnalysisVersionRegExp.firstMatch(content)?.group(1);
+
+  final latestAnalysisOptionsFile =
+      File('lib/analysis_options.$latestVersion.yaml');
+
+  final newVersion = args[0];
+  final newAnalysisOptionsFile = File('lib/analysis_options.$newVersion.yaml');
+  latestAnalysisOptionsFile.copySync(newAnalysisOptionsFile.path);
+
+  final newContent = content.replaceFirst(
+    _latestAnalysisVersionRegExp,
+    'analysis_options.$newVersion.yaml',
+  );
+  analysisOptionsFile.writeAsStringSync(newContent);
+}