add ignore keywords

src/lib.rs

@@ -40,6 +40,9 @@ pub enum Strategy {
 }
 
 pub fn process_lines(strategy: Strategy, lines: Vec<String>) -> io::Result<Vec<String>> {
+    if is_ignore_file(&lines) {
+        return Ok(lines);
+    }
     match strategy {
         Strategy::Generic => crate::strategies::generic::process(lines),
         Strategy::Bazel => crate::strategies::bazel::process(lines),
@@ -64,6 +67,14 @@ fn classify(path: &Path, features: Vec<String>) -> Strategy {
     Strategy::Generic
 }
 
+fn is_ignore_file(lines: &[String]) -> bool {
+    lines.iter().any(|line| line.contains("keepsorted:ignore-file"))
+}
+
+fn is_ignore_block(lines: &[String]) -> bool {
+    lines.iter().any(|line| line.contains("keepsorted:ignore-block"))
+}
+
 fn is_bazel(path: &Path) -> bool {
     match path.extension().and_then(|s| s.to_str()) {
         Some(ext) => matches!(ext, "bazel" | "bzl" | "BUILD" | "WORKSPACE"),

src/strategies/bazel.rs

@@ -2,6 +2,8 @@ use regex::Regex;
 use std::cmp::Ordering;
 use std::io;
 
+use crate::is_ignore_block;
+
 pub(crate) fn process(lines: Vec<String>) -> io::Result<Vec<String>> {
     let re = Regex::new(r"^\s*#\s*Keep\s*sorted\.\s*$")
         .map_err(|e| io::Error::new(io::ErrorKind::InvalidInput, e))?;
@@ -58,6 +60,9 @@ struct Item {
 
 /// Sorts a block of lines, keeping associated comments with their items.
 fn sort(block: Vec<String>) -> Vec<String> {
+    if is_ignore_block(&block) {
+        return block;
+    }
     let n = block.len();
     let mut items = Vec::with_capacity(n);
     let mut current_item = Item::default();

src/strategies/cargo_toml.rs

@@ -1,5 +1,7 @@
 use std::io;
 
+use crate::is_ignore_block;
+
 pub(crate) fn process(lines: Vec<String>) -> io::Result<Vec<String>> {
     let mut output_lines = Vec::new();
     let mut block = Vec::new();
@@ -63,6 +65,9 @@ struct Item {
 
 /// Sorts a block of lines, keeping associated comments with their items.
 fn sort(block: Vec<String>) -> Vec<String> {
+    if is_ignore_block(&block) {
+        return block;
+    }
     let n = block.len();
     let mut items = Vec::with_capacity(n);
     let mut current_item = Item::default();

src/strategies/generic.rs

@@ -1,6 +1,8 @@
 use regex::Regex;
 use std::io;
 
+use crate::is_ignore_block;
+
 pub(crate) fn process(lines: Vec<String>) -> io::Result<Vec<String>> {
     let re = Regex::new(r"^\s*#\s*Keep\s*sorted\.\s*$")
         .map_err(|e| io::Error::new(io::ErrorKind::InvalidInput, e))?;
@@ -40,6 +42,9 @@ struct Item {
 
 /// Sorts a block of lines, keeping associated comments with their items.
 fn sort(block: Vec<String>) -> Vec<String> {
+    if is_ignore_block(&block) {
+        return block;
+    }
     let n = block.len();
     let mut items = Vec::with_capacity(n);
     let mut current_item = Item::default();

src/strategies/gitignore.rs

@@ -1,5 +1,7 @@
 use std::io;
 
+use crate::is_ignore_block;
+
 pub(crate) fn process(lines: Vec<String>) -> io::Result<Vec<String>> {
     let mut output_lines = Vec::new();
     let mut block = Vec::new();
@@ -40,6 +42,9 @@ struct Item {
 
 /// Sorts a block of lines, keeping associated comments with their items.
 fn sort(block: Vec<String>) -> Vec<String> {
+    if is_ignore_block(&block) {
+        return block;
+    }
     let n = block.len();
     let mut items = Vec::with_capacity(n);
     let mut current_item = Item::default();

tests/generic.rs

@@ -135,6 +135,111 @@ y
     );
 }
 
+#[test]
+fn generic_ignore_file() {
+    test_inner!(
+        Generic,
+        r#"
+    keepsorted:ignore-file
+# Keep sorted.
+1b
+1a
+
+# Keep sorted.
+2b
+2a
+
+# Keep sorted.
+3b
+3a
+        "#,
+        r#"
+    keepsorted:ignore-file
+# Keep sorted.
+1b
+1a
+
+# Keep sorted.
+2b
+2a
+
+# Keep sorted.
+3b
+3a
+        "#
+    );
+}
+
+#[test]
+fn generic_ignore_block_inside() {
+    test_inner!(
+        Generic,
+        r#"
+# Keep sorted.
+1b
+1a
+
+# Keep sorted.
+    keepsorted:ignore-block
+2b
+2a
+
+# Keep sorted.
+3b
+3a
+        "#,
+        r#"
+# Keep sorted.
+1a
+1b
+
+# Keep sorted.
+    keepsorted:ignore-block
+2b
+2a
+
+# Keep sorted.
+3a
+3b
+        "#
+    );
+}
+
+#[test]
+fn generic_ignore_block_before() {
+    test_inner!(
+        Generic,
+        r#"
+# Keep sorted.
+1b
+1a
+
+    keepsorted:ignore-block
+# Keep sorted.
+2b
+2a
+
+# Keep sorted.
+3b
+3a
+        "#,
+        r#"
+# Keep sorted.
+1a
+1b
+
+    keepsorted:ignore-block
+# Keep sorted.
+2b
+2a
+
+# Keep sorted.
+3a
+3b
+        "#
+    );
+}
+
 // TODO: move to the appropriate place.
 #[test]
 #[ignore]