syntax_tree 3.0.1 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 499aba04c732c3101f3e3ebb7d487a19842781a0a97b67fad047c2cf9bbe2bcb
-  data.tar.gz: dc9e28898951ae74f3a053b261b8d1e752567917bbb8eb34a4aa22af6b49b716
+  metadata.gz: 3364d1c9d427dd3e40d76f2598569399f3099870f247e1fc740d0d5c06d72e36
+  data.tar.gz: 24272efb6a8272b32446a3865425ed74cbb223a64798611012732c102321dfd6
 SHA512:
-  metadata.gz: 3a8cdd3933efaaa8898cfa25bebd3e52d3b6632081319d8ddded59dacb996ebd11232d1060e408eb93bdb4211aa4d2775bfce970ba868264f7846dcb63873e5e
-  data.tar.gz: 673c601ce6a25cc4875b2041710b4a85f5114a24deb1cb5e3bf69a464e072f72f24f2e13cb3aa89d95076a5d7643beb6469ccd669018e75d9ac998aeb0a10ddf
+  metadata.gz: b824e69bf60fbf5c0d4a77cb4981243913cdfd22b09bcfd88c0bdd758b92be9d89462cf106b1bce3098e777b811aa87bc076dc0eac3369f33009719381290135
+  data.tar.gz: 9a5dad257dd35c7a45fbef150c189e01823595ec079df9e09aafe70347a0e41278d9cca3cb5b184b49b789d9460d5332e9c516629122d08f529b0961d42a2284

data/CHANGELOG.md

@@ -6,6 +6,12 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 
 ## [Unreleased]
 
+## [3.1.0] - 2022-07-19
+
+### Added
+
+- [#115](https://github.com/ruby-syntax-tree/syntax_tree/pull/115) - Support the `--print-width` option in the CLI for the actions that support it.
+
 ## [3.0.1] - 2022-07-15
 
 ### Changed
@@ -294,7 +300,8 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 
 - 🎉 Initial release! 🎉
 
-[unreleased]: https://github.com/ruby-syntax-tree/syntax_tree/compare/v3.0.1...HEAD
+[unreleased]: https://github.com/ruby-syntax-tree/syntax_tree/compare/v3.1.0...HEAD
+[3.1.0]: https://github.com/ruby-syntax-tree/syntax_tree/compare/v3.0.1...v3.1.0
 [3.0.1]: https://github.com/ruby-syntax-tree/syntax_tree/compare/v3.0.0...v3.0.1
 [3.0.0]: https://github.com/ruby-syntax-tree/syntax_tree/compare/v2.9.0...v3.0.0
 [2.9.0]: https://github.com/ruby-syntax-tree/syntax_tree/compare/v2.8.0...v2.9.0

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    syntax_tree (3.0.1)
+    syntax_tree (3.1.0)
       prettier_print
 
 GEM

data/README.md

@@ -118,6 +118,12 @@ If there are files with unformatted code, you will receive:
 The listed files did not match the expected format.
 ```
 
+To change the print width that you are checking against, specify the `--print-width` option, as in:
+
+```sh
+stree check --print-width=100 path/to/file.rb
+```
+
 ### format
 
 This command will output the formatted version of each of the listed files. Importantly, it will not write that content back to the source files. It is meant to display the formatted version only.
@@ -132,6 +138,12 @@ For a file that contains `1 + 1`, you will receive:
 1 + 1
 ```
 
+To change the print width that you are formatting with, specify the `--print-width` option, as in:
+
+```sh
+stree format --print-width=100 path/to/file.rb
+```
+
 ### json
 
 This command will output a JSON representation of the syntax tree that is functionally equivalent to the input. This is mostly used in contexts where you need to access the tree from JavaScript or serialize it over a network.
@@ -213,6 +225,12 @@ This will list every file that is being formatted. It will output light gray if
 path/to/file.rb 0ms
 ```
 
+To change the print width that you are writing with, specify the `--print-width` option, as in:
+
+```sh
+stree write --print-width=100 path/to/file.rb
+```
+
 ## Library
 
 Syntax Tree can be used as a library to access the syntax tree underlying Ruby source code.

data/lib/syntax_tree/cli.rb

@@ -91,9 +91,17 @@ module SyntaxTree
       class UnformattedError < StandardError
       end
 
+      attr_reader :print_width
+
+      def initialize(print_width:)
+        @print_width = print_width
+      end
+
       def run(item)
         source = item.source
-        raise UnformattedError if source != item.handler.format(source)
+        if source != item.handler.format(source, print_width)
+          raise UnformattedError
+        end
       rescue StandardError
         warn("[#{Color.yellow("warn")}] #{item.filepath}")
         raise
@@ -114,13 +122,21 @@ module SyntaxTree
       class NonIdempotentFormatError < StandardError
       end
 
+      attr_reader :print_width
+
+      def initialize(print_width:)
+        @print_width = print_width
+      end
+
       def run(item)
         handler = item.handler
 
         warning = "[#{Color.yellow("warn")}] #{item.filepath}"
-        formatted = handler.format(item.source)
+        formatted = handler.format(item.source, print_width)
 
-        raise NonIdempotentFormatError if formatted != handler.format(formatted)
+        if formatted != handler.format(formatted, print_width)
+          raise NonIdempotentFormatError
+        end
       rescue StandardError
         warn(warning)
         raise
@@ -148,8 +164,14 @@ module SyntaxTree
 
     # An action of the CLI that formats the input source and prints it out.
     class Format < Action
+      attr_reader :print_width
+
+      def initialize(print_width:)
+        @print_width = print_width
+      end
+
       def run(item)
-        puts item.handler.format(item.source)
+        puts item.handler.format(item.source, print_width)
       end
     end
 
@@ -173,12 +195,18 @@ module SyntaxTree
     # An action of the CLI that formats the input source and writes the
     # formatted output back to the file.
     class Write < Action
+      attr_reader :print_width
+
+      def initialize(print_width:)
+        @print_width = print_width
+      end
+
       def run(item)
         filepath = item.filepath
         start = Time.now
 
         source = item.source
-        formatted = item.handler.format(source)
+        formatted = item.handler.format(source, print_width)
         File.write(filepath, formatted) if filepath != :stdin
 
         color = source == formatted ? Color.gray(filepath) : filepath
@@ -194,43 +222,44 @@ module SyntaxTree
     # The help message displayed if the input arguments are not correctly
     # ordered or formatted.
     HELP = <<~HELP
-      #{Color.bold("stree ast [OPTIONS] [FILE]")}
+      #{Color.bold("stree ast [--plugins=...] [--print-width=NUMBER] FILE")}
         Print out the AST corresponding to the given files
 
-      #{Color.bold("stree check [OPTIONS] [FILE]")}
+      #{Color.bold("stree check [--plugins=...] [--print-width=NUMBER] FILE")}
         Check that the given files are formatted as syntax tree would format them
 
-      #{Color.bold("stree debug [OPTIONS] [FILE]")}
+      #{Color.bold("stree debug [--plugins=...] [--print-width=NUMBER] FILE")}
         Check that the given files can be formatted idempotently
 
-      #{Color.bold("stree doc [OPTIONS] [FILE]")}
+      #{Color.bold("stree doc [--plugins=...] FILE")}
         Print out the doc tree that would be used to format the given files
 
-      #{Color.bold("stree format [OPTIONS] [FILE]")}
+      #{Color.bold("stree format [--plugins=...] [--print-width=NUMBER] FILE")}
         Print out the formatted version of the given files
 
-      #{Color.bold("stree json [OPTIONS] [FILE]")}
+      #{Color.bold("stree json [--plugins=...] FILE")}
         Print out the JSON representation of the given files
 
-      #{Color.bold("stree match [OPTIONS] [FILE]")}
+      #{Color.bold("stree match [--plugins=...] FILE")}
         Print out a pattern-matching Ruby expression that would match the given files
 
       #{Color.bold("stree help")}
         Display this help message
 
-      #{Color.bold("stree lsp [OPTIONS]")}
+      #{Color.bold("stree lsp [--plugins=...]")}
         Run syntax tree in language server mode
 
       #{Color.bold("stree version")}
         Output the current version of syntax tree
 
-      #{Color.bold("stree write [OPTIONS] [FILE]")}
+      #{Color.bold("stree write [--plugins=...] [--print-width=NUMBER] FILE")}
         Read, format, and write back the source of the given files
 
-      [OPTIONS]
-
       --plugins=...
         A comma-separated list of plugins to load.
+
+      --print-width=NUMBER
+        The maximum line width to use when formatting.
     HELP
 
     class << self
@@ -238,19 +267,31 @@ module SyntaxTree
       # passed to the invocation.
       def run(argv)
         name, *arguments = argv
-
-        # If there are any plugins specified on the command line, then load them
-        # by requiring them here. We do this by transforming something like
-        #
-        #     stree format --plugins=haml template.haml
-        #
-        # into
-        #
-        #     require "syntax_tree/haml"
-        #
-        if arguments.first&.start_with?("--plugins=")
-          plugins = arguments.shift[/^--plugins=(.*)$/, 1]
-          plugins.split(",").each { |plugin| require "syntax_tree/#{plugin}" }
+        print_width = DEFAULT_PRINT_WIDTH
+
+        while arguments.first&.start_with?("--")
+          case (argument = arguments.shift)
+          when /^--plugins=(.+)$/
+            # If there are any plugins specified on the command line, then load
+            # them by requiring them here. We do this by transforming something
+            # like
+            #
+            #     stree format --plugins=haml template.haml
+            #
+            # into
+            #
+            #     require "syntax_tree/haml"
+            #
+            $1.split(",").each { |plugin| require "syntax_tree/#{plugin}" }
+          when /^--print-width=(\d+)$/
+            # If there is a print width specified on the command line, then
+            # parse that out here and use it when formatting.
+            print_width = Integer($1)
+          else
+            warn("Unknown CLI option: #{argument}")
+            warn(HELP)
+            return 1
+          end
         end
 
         case name
@@ -271,9 +312,9 @@ module SyntaxTree
           when "a", "ast"
             AST.new
           when "c", "check"
-            Check.new
+            Check.new(print_width: print_width)
           when "debug"
-            Debug.new
+            Debug.new(print_width: print_width)
           when "doc"
             Doc.new
           when "j", "json"
@@ -281,9 +322,9 @@ module SyntaxTree
           when "m", "match"
             Match.new
           when "f", "format"
-            Format.new
+            Format.new(print_width: print_width)
           when "w", "write"
-            Write.new
+            Write.new(print_width: print_width)
           else
             warn(HELP)
             return 1

data/lib/syntax_tree/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SyntaxTree
-  VERSION = "3.0.1"
+  VERSION = "3.1.0"
 end

data/lib/syntax_tree.rb

@@ -29,6 +29,11 @@ module SyntaxTree
   HANDLERS = {}
   HANDLERS.default = SyntaxTree
 
+  # This is the default print width when formatting. It can be overridden in the
+  # CLI by passing the --print-width option or here in the API by passing the
+  # optional second argument to ::format.
+  DEFAULT_PRINT_WIDTH = 80
+
   # This is a hook provided so that plugins can register themselves as the
   # handler for a particular file type.
   def self.register_handler(extension, handler)
@@ -43,7 +48,7 @@ module SyntaxTree
   end
 
   # Parses the given source and returns the formatted source.
-  def self.format(source, maxwidth = 80)
+  def self.format(source, maxwidth = DEFAULT_PRINT_WIDTH)
     formatter = Formatter.new(source, [], maxwidth)
     parse(source).format(formatter)
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: syntax_tree
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 3.1.0
 platform: ruby
 authors:
 - Kevin Newton
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-07-15 00:00:00.000000000 Z
+date: 2022-07-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: prettier_print