custom_lint 0.3.2

custom_lint: ^0.3.2 copied to clipboard

• Revert "Fixed an issue that caused a "Port already in use" error when trying to start custom_lint". This had the opposite effect of what's expected.

• Update analyzer to >=5.7.0 <5.8.0
• Fixed an issue that caused a "Port already in use" error when trying to start custom_lint

Move json_serializable to dev dependencies

• Improved the error message when there is a version conflict in mono-repos (thanks to @@adsonpleal)
• Bump minimum Dart SDK to sdk: ">=2.19.0 <3.0.0"

Fix custom_lint not correctly killing sub-processes when the IDE stops custom_lint.

Fixes an exception thrown when a project contains images.

Large Breaking change This new version introduces large changes to how lints/fixes/assists are defined.
Long story short, besides the createPlugin method, the entire syntax changed.

See the readme, examples, and docs around how to use the new syntax.

The new syntax has multiple benefits:

• It is now possible to enable/disable lints inside the analysis_options.yaml as followed:

  # optional
  include: path/to/another/analysis_options.yaml
  
  custom_lint:
    rules:
      # enable a lint rule
      - my_lint_rule
      # A lint rule that is explicitly disabled
      - another_lint_rule: false
  

  Enabling/disabling lints is supported by default with the new syntax. Nothing to do~

• Performance improvement when using a large number of lints. The workload of analyzing files is now shared between lints.

• The new syntax makes the code simpler to maintain. Before, the PluginBase.getLints rapidly ended-up doing too much. Now, it is simple to split the implementation in multiple bits

Do some internal refactoring as an attempt to fix #60

• Fix an issue where plugins were hot-reloaded when the file analyzed changed.
• Optimized analysis such that PluginBase.getLints() is theorically not reinvoked unless the file analyzed changed.

• Breaking: The plugin entrypoint has moved.
  Plugins no-longer should define a /bin/custom_lint.dart file. Instead they should define a /lib/<my_package_name>.dart

• Breaking: The plugin entrypoint is modified. Plugins no-longer define a "main", but instead define a createPlugin function:

  Before:

  // /bin/custom_lint.dart
  void main(List<String> args, SendPort sendPort) {
    startPlugin(sendPort, MyPlugin());
  }
  

  After:

  // /lib/<my_package_name.dart
  MyPlugin createPlugin() => MyPlugin();
  

• Add assist support. Inside your plugins, you can now override handleGetAssists:

  import 'package:analyzer_plugin/protocol/protocol_generated.dart'
    as analyzer_plugin;
  
  class MyPlugin extends PluginBase {
    // ...
  
    Future<analyzer_plugin.EditGetAssistsResult> handleGetAssists(
      ResolvedUnitResult resolvedUnitResult, {
      required int offset,
      required int length,
    }) async {
        // TODO return some assists for the given offset
    }
  }
  

Fix expect_lint not working if the file doesn't contain any lint.

• Custom_lint now has a built-in mechanism for testing lints. Simply write a file that should contain lints for your plugin. Then, using a syntax similar to // ignore, write a // expect_lint: code in the line before your lint:

  // expect_lint: riverpod_final_provider
  var provider = Provider(...);
  

  When doing this, there are two possible cases:

  • The line after the expect_lint correctly contains the expected lint.
    In that case, the lint is ignored (similarly to if we used // ignore)
  • The next line does not contain the lint. In that case, the expect_lint comment will have an error.

  This allows testing your plugins by simply running custom_lint on your test/example folder. Then, if any expected lint is missing, the command will fail. But if your plugin correctly emits the lint, the command will succeed.

• Upgrade analyzer/analzer_plugin

• Fix custom_lint not working in the IDE

• Add debugger and hot-reload support (Thanks to @TimWhiting)
• Correctly respect exclude obtains from the analysis_options.yaml
• Fix dart analyze incorrectly failing due to showing the "plugin is starting" lint.

• Fix custom_lint plugins not working in release mode and when using git dependencies (thanks to @TimWhiting)
• Fix command line exit code not being set properly (thansk to @andrzejchm)

Fix custom_lint not showing in the IDE

Update docs

• Upgrade Riverpod to 2.0.0
• Fix deprecation errors with analyzer

Update description and readme

• Lint fixes can now be used when placing the cursor on the last character of a lint
• improve pub score

Allow lints to emit fixes

Fix a bug where the custom_lint command line may not list all lints

feat!: getLints now is expected to return a Stream<Lint> instead of Iterable<Lint>

fix: a bug where the lints shown by the IDE could get out of sync with the actual content of the file

Fixed error reporting if a custom_lint plugin throws but the exception comes from a package instead of the plugin itself.

• Fixed a bug where the command line could show IDE-only meant for debugging

PluginBase.getLints now receive a ResolvedUnitResult instead of a LibraryElement.

• Compilation errors are now visible within the pubspec.yaml of applications that are using the plugin.

• Plugins that are currently loading are now highlighted inside the pubspec.yaml of applications that are using the plugin.

• If a plugin throws when trying to analyze a Dart file, the IDE will now show the exception at the top of the analyzed file.

• Compilation errors, exceptions and prints are now accessible within a log file (custom_lint.log) inside applications using the plugin.

Initial release