pdd 0.23.2 → 0.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b31cfabb478220287ba41490879fa0387cf0d08a1f62872119fefa5c69fc71db
-  data.tar.gz: 7022a7f4b8a3777a2ff801cc1c054c73159b678d5f7d176db482204923a05268
+  metadata.gz: 91fcdc9f020a0b464387833136eb5cd9c55c40c995cce419950587a899d6b1a4
+  data.tar.gz: 7638e25104a15816702cc73c797df3fcf6673b85761864d2ae5a1d3749f90b14
 SHA512:
-  metadata.gz: 389bb7338dffb8967201649556f6774dc39e8417233ffaf53c8e1c492aaa0dff53f1419ffb40f31f0737621584b91cd841b19726074a58bd781d80b02f82050b
-  data.tar.gz: cc378cc62f5a3dba820d1c0c10a571ce158ed4b1aff7425756bb596fae9e91784819d8648e69654e4f77a7e8a7ed7f9505e8635aba693f0c577731cfa0906be7
+  metadata.gz: 61502311ce40384236b872397b728a15a9633401376c1ec79718b314d96f9a86e3e3a899f7267d93633c3b9842272ad77bfdbe904cd9133ce49a057a1b548dcb
+  data.tar.gz: 35e1de4d7b2318bd77c662016fbea96619165f309b512c59897ea5270ad5973c681b835638d8d4bcc2a48e83b25b84bc7597e5ddaeda7b27e51b2dc8c6aee714

data/.github/workflows/codecov.yml

@@ -4,17 +4,20 @@ on:
   push:
     branches:
       - master
+  pull_request:
+    branches:
+      - master
 jobs:
   codecov:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-22.04
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-ruby@v1
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 2.7
+          ruby-version: '2.7'
       - run: bundle update
       - run: bundle exec rake
-      - uses: codecov/codecov-action@v1
+      - uses: codecov/codecov-action@v4
         with:
-          file: coverage/.resultset.json
+          token: ${{ secrets.CODECOV_TOKEN }}
           fail_ci_if_error: true

data/.github/workflows/pdd.yml

@@ -1,6 +1,6 @@
 ---
 name: pdd
-"on":
+on:
   push:
     branches:
       - master
@@ -9,7 +9,7 @@ name: pdd
       - master
 jobs:
   pdd:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-22.04
     steps:
-      - uses: actions/checkout@v2
-      - uses: g4s8/pdd-action@master
+      - uses: actions/checkout@v4
+      - uses: volodya-lombrozo/pdd-action@master

data/.github/workflows/rake.yml

@@ -8,16 +8,16 @@ on:
     branches:
       - master
 jobs:
-  test:
-    name: test
+  rake:
+    name: rake
     strategy:
       matrix:
         os: [ubuntu-20.04]
-        ruby: [2.7]
+        ruby: ['2.7', '3.0']
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-ruby@v1
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}
       - run: bundle update

data/.pdd

@@ -12,6 +12,7 @@
 --exclude features/remove.feature
 --exclude features/uses_config.feature
 --exclude features/html_output.feature
+--exclude features/json_output.feature
 --exclude features/avoiding_duplicates.feature
 --exclude features/applies_rules.feature
 --exclude features/unicode.feature

data/.rultor.yml

@@ -1,11 +1,12 @@
 docker:
-  image: yegor256/rultor-image:1.20.0
+  image: yegor256/rultor-image:1.22.0
 assets:
   rubygems.yml: yegor256/home#assets/rubygems.yml
 install: |
   pdd -f /dev/null
-  sudo bundle install --no-color "--gemfile=$(pwd)/Gemfile"
+  bundle install --no-color
 release:
+  pre: false
   script: |-
     [[ "${tag}" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]] || exit -1
     bundle exec rake

data/.simplecov

@@ -1,4 +1,4 @@
-# Copyright (c) 2014-2023 Yegor Bugayenko
+# Copyright (c) 2014-2024 Yegor Bugayenko
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the 'Software'), to deal
@@ -18,21 +18,18 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
-if Gem.win_platform?
-  SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
-    SimpleCov::Formatter::HTMLFormatter
-  ]
-  SimpleCov.start do
-    add_filter '/test/'
-    add_filter '/features/'
-  end
-else
-  SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter.new(
-    SimpleCov::Formatter::HTMLFormatter
-  )
-  SimpleCov.start do
-    add_filter '/test/'
-    add_filter '/features/'
-    minimum_coverage 90
-  end
+SimpleCov.formatter = if Gem.win_platform?
+                        SimpleCov::Formatter::MultiFormatter[
+                          SimpleCov::Formatter::HTMLFormatter
+                        ]
+                      else
+                        SimpleCov::Formatter::MultiFormatter.new(
+                          SimpleCov::Formatter::HTMLFormatter
+                        )
+                      end
+
+SimpleCov.start do
+  add_filter '/test/'
+  add_filter '/features/'
+  minimum_coverage 90
 end

data/Gemfile

@@ -1,4 +1,4 @@
-# Copyright (c) 2014-2023 Yegor Bugayenko
+# Copyright (c) 2014-2024 Yegor Bugayenko
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the 'Software'), to deal
@@ -27,8 +27,9 @@ gem 'minitest', '5.16.2', require: false
 gem 'rake', '13.0.6', require: false
 gem 'rdoc', '6.4.0', require: false
 gem 'rspec-rails', '5.1.2', require: false
-gem 'rubocop', '1.53.1', require: false
+gem 'rubocop', '1.60.2', require: false
 gem 'rubocop-rspec', '2.22.0', require: false
 gem 'simplecov', '0.22.0', require: false
+gem 'simplecov-cobertura', '~> 2.1'
 gem 'slop', '4.9.2', require: false
 gem 'xcop', '0.7.1', require: false

data/LICENSE.txt

@@ -1,6 +1,6 @@
 (The MIT License)
 
-Copyright (c) 2014-2023 Yegor Bugayenko
+Copyright (c) 2014-2024 Yegor Bugayenko
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the 'Software'), to deal

data/README.md

@@ -6,8 +6,7 @@
 
 [![rake](https://github.com/cqfn/pdd/actions/workflows/rake.yml/badge.svg)](https://github.com/cqfn/pdd/actions/workflows/rake.yml)
 [![PDD status](http://www.0pdd.com/svg?name=cqfn/pdd)](http://www.0pdd.com/p?name=cqfn/pdd)
-[![codecov](https://codecov.io/gh/cqfn/pdd/branch/master/graph/badge.svg)](https://codecov.io/gh/cqfn/pdd)
-![Lines of code](https://img.shields.io/tokei/lines/github/cqfn/pdd)
+[![codecov](https://codecov.io/gh/yegor256/pdd/branch/master/graph/badge.svg)](https://codecov.io/gh/yegor/pdd)
 [![Hits-of-Code](https://hitsofcode.com/github/cqfn/pdd)](https://hitsofcode.com/view/github/cqfn/pdd)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/cqfn/pdd/blob/master/LICENSE.txt)
 [![Gem Version](https://badge.fury.io/rb/pdd.svg)](http://badge.fury.io/rb/pdd)
@@ -26,8 +25,7 @@ Read
 [_PDD in Action_](http://www.yegor256.com/2017/04/05/pdd-in-action.html)
 and watch [this webinar](https://www.youtube.com/watch?v=nsYGC2aUwfQ).
 
-You should have [Ruby installed](https://www.ruby-lang.org/en/documentation/installation/).
-Then, install our gem:
+First, make sure Ruby 2.6+ and [`libmagic`](#how-to-install-libmagic) are installed. Then, install our gem:
 
 ```bash
 $ gem install pdd
@@ -39,25 +37,27 @@ Run it locally and read its output:
 $ pdd --help
 ```
 
+## Usage
+
 You can exclude & include certain number of files from the search via these options:
 
-```
-$ pdd --exclude=glob
+```bash
+$ pdd --exclude glob
 ```
 
 You can skip any file(s) with a name suffix that matches the pattern glob, using wildcard matching; 
 a name suffix is either the whole path and name, or reg expr, for example:
 
 ```bash
-$ pdd --exclude=src/**/*.java --exclude=target/**/*
-$ pdd --exclude=src/**/*.java # exclude .java files in src/
-$ pdd --exclude=src/**/* # exclude all files in src/
+$ pdd --exclude src/**/*.java --exclude target/**/*
+$ pdd --exclude src/**/*.java # exclude .java files in src/
+$ pdd --exclude src/**/* # exclude all files in src/
 ```
 
 You can include too:
 
-```
-$ pdd --include=glob
+```bash
+$ pdd --include glob
 ```
 
 Search only files whose name matches glob, using wildcard matching as described under ``--exclude``. 
@@ -65,10 +65,34 @@ If contradictory ``--include`` and ``--exclude`` options are given, the last mat
 If no ``--include`` or ``--exclude`` options are given, all files from working directory are included, example:
 
 ```bash
-$ pdd --include=src/**/*.py # include only .py files in src/
-$ pdd --include=src/**/* # include all files in src/
+$ pdd --include src/**/*.py # include only .py files in src/
+$ pdd --include src/**/* # include all files in src/
 ```
 
+Full command format is (all parameters are optional):
+```bash
+$ pdd [--verbose] [--quiet] [--remove] [--skip-gitignore] [--skip-errors] \
+      [--source <project_dir_path>] [--file puzzles_file.xml] [--include src/**/*.py] \
+      [--format xml|html] [--rule min-words:5] [--exclude src/**/*.java]
+```
+
+| Parameter               | Description                                                                           |
+|-------------------------|---------------------------------------------------------------------------------------|
+| --verbose               | Enable verbose (debug) mode. --file must be used in case of using this option         |
+| --quiet                 | Disable logs                                                                          |
+| --remove                | Remove all found puzzles from the source code                                         |
+| --skip-gitignore        | Don't look into .gitignore for excludes                                               |
+| --skip-errors           | Suppress error as warning and skip badly formatted puzzles (do not skip broken rules) |
+| --source <project-path> | Source directory to parse ("." by default)                                            |
+| --file puzzles.xml      | File to save report into (xml of html) (displayed in console by default)              |
+| --include *.py          | Glob pattern to include (can be used several times)                                   |
+| --exclude *.java        | Glob pattern to exclude (can be used several times)                                   |
+| --format xml            | Format of the report xml or html  (xml is default)                                    |
+| --rule min-words:5      | Rule to apply (can be used several times), described later                            |
+
+:bulb: There is an option to create a .pdd file in your project and save all required parameters in it.
+File example you can see in this project.
+
 ## How to Format?
 
 Every puzzle has to be formatted like this (pay attention
@@ -81,9 +105,9 @@ to the leading space in every consecutive line):
 [related code]
 ```
 
-`[]` - Replace with apropriate data (see text enclosed in brackets)
+`[]` - Replace with appropriate data (see text enclosed in brackets)
 
-`<>` - Omitable (enclosed data can be left out)
+`<>` - Optional (enclosed data can be left out)
 
 Example:
 
@@ -92,6 +116,10 @@ Example:
  * @todo #234:15m/DEV This is something to do later
  *  in one of the next releases. I can't figure out
  *  how to implement it now, that's why the puzzle.
+ *  The text can be so long, as needed, just use 
+ *  the same anount of spaces, as the second line.
+ * This text will be not a part of the puzzle, as 
+ * it has less spaces. 
  */
 void sendEmail() {
   throw new UnsupportedOperationException();
@@ -118,18 +146,16 @@ as long as you have one of the 3 supported keywords right in front
 of the mandatory marker):
 
 ```
-// @todo #224
-/* @todo #TEST-13 */
-# @todo #55:45min
-@todo #67/DES
-;; @todo #678:40m/DEV
-// TODO: #1:30min
-(* TODO #42 *)
+// @todo #224 Puzzle description
+# @todo #55:45min Puzzle description
+@todo #67/DES Puzzle description
+;; @todo #678:40m/DEV Puzzle description
+// TODO: #TEST-21:30min Puzzle description
 ```
 
 Here `DES` and `DEV` are the roles of people who must fix that puzzles;
 `45min` and `40m` is the amount of time the puzzle should take;
-`224`, `TEST-13`, `55`, `67`, `678`, `1`, and `42` are the IDs of the tickets
+`224`, `55`, `67`, `678` and `TEST-21` are the IDs of the tickets
 these puzzles are coming from.
 
 Markers are absolutely necessary for all puzzles, because they allow
@@ -138,13 +164,50 @@ us to build a hierarchical dependency tree of all puzzles, like
 for example. Technically, of course, you can abuse the system
 and put a dummy `#1` marker everywhere.
 
+### Multiline examples
+
+For multiline puzzles there are two important things:
+- **prefix** - any optional text followed by space before puzzle keyword (todo). 
+It should be the same for all lines of puzzle description.
+- \ symbol can be used to logically divide puzzle description.
+prefix should be presented with it.
+
+Examples:
+
+```xml
+<!-- 
+ ~ if comment should be started and closed by special symbols, then place them in
+ ~ a separate lines
+ ~ Any symbol can be used as a prefix, it will be excluded from the text.
+ ~ But do not forget about the space before puzzle keyword.
+ ~
+ ~ @todo #34 Description can be as long as needed.
+ ~  Just use at least the same amount of the spaces, as on the first line. 
+ ~  It will be added to description.
+-->
+```
+
+```java
+/**
+ * @todo #36 Multiline text can use the same prefix in all lines or the same 
+ *  amount of spaces.
+ *  So this will be added to the puzzle description. If you want to divide the 
+ *  puzzle logically by empty line, just add a backspace to that line  
+ *  \
+ *  and continue the text after.
+ *
+ *  This line is not part of the puzzle, because the line before does not contain
+ *  prefix.
+ */
+```
+
 ## How to Configure Rules?
 
 You can specify post-parsing rules for your puzzles, in command line,
 for example:
 
-```
-$ pdd --rule=min-estimate:60 --rule=max-estimate:120
+```bash
+$ pdd --rule min-estimate:60 --rule max-estimate:120
 ```
 
 These two parameters will add two post-parsing rules `min-estimate`
@@ -168,7 +231,7 @@ Here is a list of rules available now:
   This rule is used by default and you can't configure it at the moment,
   it must always be set to `1`.
 
-You can put all command line options into `.pdd` file. The options from the
+:bulb: You can put all command line options into `.pdd` file. The options from the
 file will be used first. Command line options may be added on top of them.
 See, how it is done in [yegor256/0pdd](https://github.com/yegor256/0pdd/blob/master/.pdd).
 
@@ -211,20 +274,38 @@ The most interesting parts of each puzzle are:
 
 - `lines` is where the puzzle is found, inside the file.
 
+## How to install libmagic
+
+For Debian/Ubuntu:
+
+```bash
+$ apt install libmagic-dev
+```
+
+For Mac:
+
+```bash
+$ brew install libmagic
+```
+
+Unfortunately, there is no easy way to install on Windows, try to use 
+[WSL](https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux) or 
+[Docker](https://www.docker.com/).
+
 ## How to contribute
 
 Read [these guidelines](https://www.yegor256.com/2014/04/15/github-guidelines.html).
 Make sure your build is green before you contribute
-your pull request. You will need to have [Ruby](https://www.ruby-lang.org/en/) 2.3+ and
+your pull request. You will need to have [Ruby](https://www.ruby-lang.org/en/) 2.7+ and
 [Bundler](https://bundler.io/) installed. Then:
 
-```
+```bash
 $ bundle install
 $ bundle exec rake
 ```
 
 Next, install and run overcommit to install hooks (required once)
-```
+```bash
 $ gem install overcommit -v '=0.58.0'
 $ overcommit --install
 ```

data/Rakefile

@@ -1,4 +1,4 @@
-# Copyright (c) 2014-2023 Yegor Bugayenko
+# Copyright (c) 2014-2024 Yegor Bugayenko
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the 'Software'), to deal
@@ -74,12 +74,15 @@ end
 
 require 'cucumber/rake/task'
 Cucumber::Rake::Task.new(:features) do |t|
-  t.cucumber_opts = 'features'
+  t.cucumber_opts = %w[features --strict-undefined]
   Rake::Cleaner.cleanup_files(['coverage'])
 end
 Cucumber::Rake::Task.new(:'features:html') do |t|
   t.profile = 'html_report'
 end
+Cucumber::Rake::Task.new(:'features:json') do |t|
+  t.profile = 'json_report'
+end
 
 task :copyright do
   sh "grep -q -r '2014-#{Date.today.strftime('%Y')}' \

data/assets/puzzles.xsd

@@ -2,7 +2,7 @@
 <!--
 (The MIT License)
 
-Copyright (c) 2014-2023 Yegor Bugayenko
+Copyright (c) 2014-2024 Yegor Bugayenko
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the 'Software'), to deal

data/assets/puzzles.xsl

@@ -2,7 +2,7 @@
 <!--
 (The MIT License)
 
-Copyright (c) 2014-2023 Yegor Bugayenko
+Copyright (c) 2014-2024 Yegor Bugayenko
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the 'Software'), to deal

data/assets/puzzles_json.xsl

@@ -0,0 +1,79 @@
+<?xml version="1.0"?>
+<!--
+(The MIT License)
+
+Copyright (c) 2014-2024 Yegor Bugayenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the 'Software'), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+-->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+  <xsl:output method="text" omit-xml-declaration="yes"/>
+  <xsl:template match="/"><xsl:text disable-output-escaping="yes">{</xsl:text><xsl:apply-templates select="puzzles"/>
+    "puzzles": [
+    <xsl:apply-templates select="puzzles/puzzle"/>
+    <xsl:text disable-output-escaping="yes">
+  ]
+}</xsl:text>
+  </xsl:template>
+  <xsl:template match="puzzles">
+    <xsl:text>
+    "version": "</xsl:text>
+    <xsl:value-of select="@version"/>
+    <xsl:text>",</xsl:text>
+    <xsl:text>
+    "date": "</xsl:text>
+    <xsl:value-of select="@date"/>
+    <xsl:text>", </xsl:text>
+  </xsl:template>
+  <xsl:template match="puzzle">
+    <xsl:text disable-output-escaping="no">{</xsl:text>
+    <xsl:text>
+      "id": "</xsl:text>
+    <xsl:value-of select="id"/>
+    <xsl:text>", </xsl:text>
+    <xsl:text>
+      "ticket": "</xsl:text>
+    <xsl:value-of select="ticket"/>
+    <xsl:text>", </xsl:text>
+    <xsl:text>
+      "file": "</xsl:text>
+    <xsl:value-of select="file"/>
+    <xsl:text>", </xsl:text>
+    <xsl:text>
+      "lines": "</xsl:text>
+    <xsl:value-of select="lines"/>
+    <xsl:text>", </xsl:text>
+    <xsl:text>
+      "body": "</xsl:text>
+    <xsl:value-of select="translate(body, '&quot;', '&#x201C;')"/>
+    <xsl:text>", </xsl:text>
+    <xsl:text>
+      "estimate": "</xsl:text>
+    <xsl:value-of select="estimate"/>
+    <xsl:text>", </xsl:text>
+    <xsl:text>
+      "role": "</xsl:text>
+    <xsl:value-of select="role"/>
+    <xsl:text>"</xsl:text>
+    <xsl:text disable-output-escaping="yes">
+    }</xsl:text>
+    <xsl:if test="position() != last()">,
+  </xsl:if>
+  </xsl:template>
+</xsl:stylesheet>

data/bin/pdd

@@ -1,5 +1,5 @@
 #!/usr/bin/env ruby
-# Copyright (c) 2014-2023 Yegor Bugayenko
+# Copyright (c) 2014-2024 Yegor Bugayenko
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the 'Software'), to deal
@@ -59,12 +59,12 @@ begin
         exit
       end
       o.string '-s', '--source', 'Source directory to parse ("." by default)'
-      o.string '-f', '--file', 'File to save XML into'
+      o.string '-f', '--file', 'File to save report into'
       o.array '-e', '--exclude', 'Glob pattern to exclude, e.g. "**/*.jpg"',
               default: []
       o.array '-n', '--include', 'Glob pattern to include, e.g. "**/*.jpg"',
               default: []
-      o.string '-t', '--format', 'Format of the report (xml|html)'
+      o.string '-t', '--format', 'Format of the report (xml|html|json)'
       o.array(
         '-r', '--rule', 'Rule to apply (can be used many times)',
         delimiter: ';'
@@ -87,7 +87,8 @@ https://github.com/cqfn/pdd/blob/master/README.md"
 
   if opts['skip-gitignore'] && File.exist?('.gitignore')
     cfg = File.new('.gitignore')
-    body = File.read(cfg)
+    body = ''
+    File.foreach(cfg) { |line| body << line unless line.start_with?('#') }
     extra = body.split(/\s+/).map(&:strip)
     opts['skip-gitignore'] = extra
     PDD.log.info "Found #{body.split("\n").length} lines in #{File.absolute_path(cfg)}"
@@ -105,8 +106,15 @@ https://github.com/cqfn/pdd/blob/master/README.md"
         'assets', 'puzzles.xsl'
       )
       output = Nokogiri::XSLT(File.read(xslt)).transform(Nokogiri::XML(xml))
+    elsif opts[:format] == 'json'
+      xslt = File.join(
+        File.dirname(File.dirname(__FILE__)),
+        'assets', 'puzzles_json.xsl'
+      )
+      # result is not xml, so use apply
+      output = Nokogiri::XSLT(File.read(xslt)).apply_to(Nokogiri::XML(xml))
     elsif opts[:format] != 'xml'
-      raise 'Invalid format, use html or xml'
+      raise 'Invalid format, use html or xml or json'
     end
   end
   file << output

data/cucumber.yml

@@ -1,3 +1,4 @@
 default: --format pretty
 travis: --format progress
 html_report: --format progress --format html --out=features_report.html
+json_report: --format progress --format json --out=features_report.json