chore: Compile the example files into a single file example.dart.

CHANGELOG.md

@@ -1,3 +1,7 @@
+## 2.2.0+1
+
+- Compiled the example files into a single file `example.dart`.
+
 ## 2.2.0
 
 - Added support for the `Crawl-delay` and `Host` fields.

example/parse_example.dart → example/example.dart

@@ -43,6 +43,55 @@ Future<void> main() async {
   print(
     "Can '$userAgent' access /wordcollector/robots_txt/? ${robots.verifyCanAccess('/wordcollector/robots_txt/', userAgent: userAgent)}",
   );
+
+  // Validating an invalid file will throw a `FormatException`.
+  try {
+    Robots.validate('This is an obviously invalid robots.txt file.');
+  } on FormatException {
+    print('As expected, the first file is flagged as invalid.');
+  }
+
+  // Validating an already valid file will not throw anything.
+  try {
+    Robots.validate('''
+User-agent: *
+Crawl-delay: 10
+Disallow: /
+Allow: /file.txt
+
+Host: https://hosting.example.com/
+Sitemap: https://example.com/sitemap.xml
+''');
+    print('As expected also, the second file is not flagged as invalid.');
+  } on FormatException {
+    print('Welp, this was not supposed to happen.');
+  }
+
+  late final String contentsFromBefore;
+
+  // Validating a file with unsupported fields.
+  try {
+    Robots.validate(
+      contentsFromBefore = '''
+User-agent: *
+Some-field: abcd.txt
+''',
+    );
+  } on FormatException {
+    print(
+      'This file is invalid on the grounds that it contains fields we did not '
+      'expect it to have.',
+    );
+    print(
+      "Let's fix that by including the custom field in the call to validate().",
+    );
+    try {
+      Robots.validate(contentsFromBefore, allowedFieldNames: {'Some-field'});
+      print('Aha! Now there are no issues.');
+    } on FormatException {
+      print('Welp, this also was not supposed to happen.');
+    }
+  }
 }
 
 Future<String> fetchFileContents({required String host}) async {

pubspec.yaml

@@ -1,5 +1,5 @@
 name: robots_txt
-version: 2.2.0
+version: 2.2.0+1
 
 description: A complete, dependency-less and fully documented `robots.txt` ruleset parser.