Dart 3.4 requirement and fix linter warnings.

analysis_options.yaml

@@ -17,6 +17,7 @@ linter:
     - comment_references
     - directives_ordering
     - invalid_case_patterns
+    - missing_code_block_language_in_doc_comment
     - no_self_assignments
     - no_wildcard_variable_uses
     - omit_local_variable_types
@@ -33,6 +34,7 @@ linter:
     - unnecessary_await_in_return
     - unnecessary_breaks
     - unnecessary_lambdas
+    - unnecessary_library_name
     - unnecessary_null_aware_operator_on_extension_on_nullable
     - unnecessary_null_checks
     - unnecessary_parenthesis

example/currencies.dart

@@ -1,5 +1,5 @@
 /// Prints currency exchange table using www.floatrates.com.
-library currencies;
+library;
 
 import 'dart:convert';
 import 'dart:io';

example/feeds.dart

@@ -1,5 +1,5 @@
 /// A simple command-line based RSS feed reader.
-library feeds;
+library;
 
 import 'dart:convert';
 import 'dart:io';

example/ip_api.dart

@@ -1,5 +1,5 @@
 /// IP Geolocation API using ip-api.com.
-library ip_api;
+library;
 
 import 'dart:convert';
 import 'dart:io';

example/xml_flatten.dart

@@ -1,5 +1,5 @@
 /// XML flatten.
-library xml_flatten;
+library;
 
 import 'dart:convert';
 import 'dart:io';

example/xml_grep.dart

@@ -1,5 +1,5 @@
 /// XML grep.
-library xml_grep;
+library;
 
 import 'dart:io';
 

example/xml_pos.dart

@@ -1,5 +1,5 @@
 /// XML position printer.
-library xml_pos;
+library;
 
 import 'dart:io';
 import 'dart:math';

example/xml_pp.dart

@@ -1,5 +1,5 @@
 /// XML pretty printer and highlighter.
-library xml_pp;
+library;
 
 import 'dart:io';
 

lib/src/xml/builder.dart

@@ -44,8 +44,9 @@ class XmlBuilder {
   ///
   /// For example, to generate the text `Hello World` one would write:
   ///
-  ///     builder.text('Hello World');
-  ///
+  /// ```dart
+  /// builder.text('Hello World');
+  /// ```
   void text(Object text) {
     final children = _stack.last.children;
     if (children.isNotEmpty) {
@@ -64,8 +65,9 @@ class XmlBuilder {
   /// For example, to generate an XML CDATA element `<![CDATA[Hello World]]>`
   /// one would write:
   ///
-  ///     builder.cdata('Hello World');
-  ///
+  /// ```dart
+  /// builder.cdata('Hello World');
+  /// ```
   void cdata(Object text) {
     _stack.last.children.add(XmlCDATA(text.toString()));
   }
@@ -75,8 +77,9 @@ class XmlBuilder {
   /// For example, to generate an XML declaration `<?xml version="1.0"
   /// encoding="utf-8"?>` one would write:
   ///
-  ///      builder.declaration(encoding: 'UTF-8');
-  ///
+  /// ```dart
+  /// builder.declaration(encoding: 'UTF-8');
+  /// ```
   void declaration(
       {String version = '1.0',
       String? encoding,
@@ -93,8 +96,9 @@ class XmlBuilder {
   /// For example, to generate an XML doctype element `<!DOCTYPE note SYSTEM
   /// "note.dtd">` one would write:
   ///
-  ///     builder.doctype('note', systemId: 'note.dtd');
-  ///
+  /// ```dart
+  /// builder.doctype('note', systemId: 'note.dtd');
+  /// ```
   void doctype(String name,
       {String? publicId, String? systemId, String? internalSubset}) {
     if (publicId != null && systemId == null) {
@@ -115,8 +119,9 @@ class XmlBuilder {
   /// For example, to generate an XML processing element `<?xml-stylesheet
   /// href="/style.css"?>` one would write:
   ///
-  ///     builder.processing('xml-stylesheet', 'href="/style.css"');
-  ///
+  /// ```dart
+  /// builder.processing('xml-stylesheet', 'href="/style.css"');
+  /// ```
   void processing(String target, Object text) {
     _stack.last.children.add(XmlProcessing(target, text.toString()));
   }
@@ -126,8 +131,9 @@ class XmlBuilder {
   /// For example, to generate an XML comment `<!--Hello World-->` one would
   /// write:
   ///
-  ///     builder.comment('Hello World');
-  ///
+  /// ```dart
+  /// builder.comment('Hello World');
+  /// ```
   void comment(Object text) {
     _stack.last.children.add(XmlComment(text.toString()));
   }
@@ -152,15 +158,18 @@ class XmlBuilder {
   /// For example, to generate an XML element with the tag _message_ and the
   /// contained text _Hello World_ one would write:
   ///
-  ///     builder.element('message', nest: 'Hello World');
+  /// ```dart
+  /// builder.element('message', nest: 'Hello World');
+  /// ```
   ///
   /// To add multiple child elements one would use:
   ///
-  ///     builder.element('message', nest: () {
-  ///       builder..text('Hello World')
-  ///              ..element('break');
-  ///     });
-  ///
+  /// ```dart
+  /// builder.element('message', nest: () {
+  ///   builder..text('Hello World')
+  ///          ..element('break');
+  /// });
+  /// ```
   void element(
     String name, {
     String? namespace,
@@ -205,10 +214,11 @@ class XmlBuilder {
   /// To generate an element with the tag _message_ and the
   /// attribute _lang="en"_ one would write:
   ///
-  ///     builder.element('message', nest: () {
-  ///        builder.attribute('lang', 'en');
-  ///     });
-  ///
+  /// ```dart
+  /// builder.element('message', nest: () {
+  ///    builder.attribute('lang', 'en');
+  /// });
+  /// ```
   void attribute(String name, Object? value,
       {String? namespace, XmlAttributeType? attributeType}) {
     final attributes = _stack.last.attributes;
@@ -237,11 +247,12 @@ class XmlBuilder {
   /// To generate a bookshelf element with two predefined book elements, one
   /// would write:
   ///
-  ///     builder.element('bookshelf', nest: () {
-  ///       builder.xml('<book><title>Growing a Language</title></book>');
-  ///       builder.xml('<book><title>Learning XML</title></book>');
-  ///     });
-  ///
+  /// ```dart
+  /// builder.element('bookshelf', nest: () {
+  ///   builder.xml('<book><title>Growing a Language</title></book>');
+  ///   builder.xml('<book><title>Learning XML</title></book>');
+  /// });
+  /// ```
   void xml(String input, {XmlEntityMapping? entityMapping}) {
     final fragment =
         XmlDocumentFragment.parse(input, entityMapping: entityMapping);

lib/src/xml/nodes/document.dart

@@ -16,8 +16,10 @@ class XmlDocument extends XmlNode with XmlHasChildren<XmlNode> {
   ///
   /// For example, the following code prints `Hello World`:
   ///
-  ///    final document = new XmlDocument.parse('<?xml?><root message="Hello World" />');
-  ///    print(document.rootElement.getAttribute('message'));
+  /// ```dart
+  /// final document = new XmlDocument.parse('<?xml?><root message="Hello World" />');
+  /// print(document.rootElement.getAttribute('message'));
+  /// ```
   ///
   /// Note: It is the responsibility of the caller to provide a standard Dart
   /// [String] using the default UTF-16 encoding.
@@ -44,10 +46,11 @@ class XmlDocument extends XmlNode with XmlHasChildren<XmlNode> {
   ///
   /// For example the following code prints `<?xml version="1.0">`:
   ///
-  ///    var xml = '<?xml version="1.0">'
-  ///              '<shelf></shelf>';
-  ///    print(XmlDocument.parse(xml).doctypeElement);
-  ///
+  /// ```dart
+  /// var xml = '<?xml version="1.0">'
+  ///           '<shelf></shelf>';
+  /// print(XmlDocument.parse(xml).doctypeElement);
+  /// ```
   XmlDeclaration? get declaration {
     for (final node in children) {
       if (node is XmlDeclaration) {
@@ -61,10 +64,11 @@ class XmlDocument extends XmlNode with XmlHasChildren<XmlNode> {
   ///
   /// For example, the following code prints `<!DOCTYPE html>`:
   ///
-  ///    var xml = '<!DOCTYPE html>'
-  ///              '<html><body></body></html>';
-  ///    print(XmlDocument.parse(xml).doctypeElement);
-  ///
+  /// ```dart
+  /// var xml = '<!DOCTYPE html>'
+  ///           '<html><body></body></html>';
+  /// print(XmlDocument.parse(xml).doctypeElement);
+  /// ```
   XmlDoctype? get doctypeElement {
     for (final node in children) {
       if (node is XmlDoctype) {
@@ -79,10 +83,11 @@ class XmlDocument extends XmlNode with XmlHasChildren<XmlNode> {
   ///
   /// For example, the following code prints `<books />`:
   ///
-  ///     var xml = '<?xml version="1.0"?>'
-  ///               '<books />';
-  ///     print(XmlDocument.parse(xml).rootElement);
-  ///
+  /// ```dart
+  /// var xml = '<?xml version="1.0"?>'
+  ///           '<books />';
+  /// print(XmlDocument.parse(xml).rootElement);
+  /// ```
   XmlElement get rootElement {
     for (final node in children) {
       if (node is XmlElement) {

lib/xml.dart

@@ -1,6 +1,6 @@
 /// Dart XML is a lightweight library for parsing, traversing, querying and
 /// building XML documents.
-library xml;
+library;
 
 export 'src/xml/builder.dart' show XmlBuilder;
 export 'src/xml/entities/default_mapping.dart'

lib/xml_events.dart

@@ -1,6 +1,6 @@
 /// Dart XML Events is an event based library to asynchronously parse XML
 /// documents and to convert them to other representations.
-library xml_events;
+library;
 
 import 'src/xml/entities/default_mapping.dart';
 import 'src/xml/entities/entity_mapping.dart';
@@ -74,12 +74,13 @@ export 'src/xml_events/visitor.dart' show XmlEventVisitor;
 ///
 /// For example, to print all trimmed non-empty text elements one would write:
 ///
-///    parseEvents(bookstoreXml)
-///        .whereType<XmlTextEvent>()
-///        .map((event) => event.text.trim())
-///        .where((text) => text.isNotEmpty)
-///        .forEach(print);
-///
+/// ```dart
+/// parseEvents(bookstoreXml)
+///     .whereType<XmlTextEvent>()
+///     .map((event) => event.text.trim())
+///     .where((text) => text.isNotEmpty)
+///     .forEach(print);
+/// ```
 Iterable<XmlEvent> parseEvents(
   String input, {
   XmlEntityMapping? entityMapping,

lib/xpath.dart

@@ -1,5 +1,5 @@
 /// Dart XPath adds support of XPath 1.0 expressions to the XML library.
-library xpath;
+library;
 
 import 'package:meta/meta.dart' show experimental;
 import 'package:petitparser/core.dart' show Failure;

pubspec.yaml

@@ -10,12 +10,12 @@ topics:
   - xpath
 
 environment:
-  sdk: ^3.3.0
+  sdk: ^3.4.0
 dependencies:
   collection: ^1.18.0
   meta: ^1.9.0
   petitparser: ^6.0.0
 dev_dependencies:
   args: ^2.4.0
-  lints: ^3.0.0
+  lints: ^4.0.0
   test: ^1.24.0