feat: range formatting

Should work the same as vim.lsp.buf.format(). Additionally, range
formatting is supported for *any* formatter. If the formatter doesn't
have native support for ranges, conform will do its best to only apply the
diffs that affect that range.

1 files changed, 7 insertions, 0 deletions

diff --git a/doc/conform.txt b/doc/conform.txt
index f602580..f0b97a0 100644
--- a/doc/conform.txt
+++ b/doc/conform.txt
@@ -44,6 +44,10 @@ OPTIONS                                                          *conform-option
           -- OPTIONAL - all fields below this are optional
           -- A list of strings, or a function that returns a list of strings
           args = { "--stdin-from-filename", "$FILENAME" },
+          -- If the formatter supports range formatting, create the range arguments here
+          range_args = function(ctx)
+            return { "--line-start", ctx.range.start[1], "--line-end", ctx.range["end"][1] }
+          end,
           -- Send file contents to stdin, read new contents from stdout (default true)
           -- When false, will create a temp file (will appear in "$FILENAME" args). The temp
           -- file is assumed to be modified in-place by the format command.
@@ -95,6 +99,9 @@ format({opts}): boolean                                           *conform.forma
                          are available. Defaults to false.
           {quiet}        `nil|boolean` Don't show any notifications for warnings
                          or failures. Defaults to false.
+          {range}        `nil|table` Range to format. Table must contain `start`
+                         and `end` keys with {row, col} tuples using (1,0)
+                         indexing. Defaults to current selection in visual mode
     Returns:
       `boolean` True if any formatters were attempted