pdd 0.24.0 → 0.24.1

data/README.md

@@ -1,79 +1,88 @@
-<img alt="pdd logo" src="https://avatars2.githubusercontent.com/u/24456188" width="92px" height="92px"/>
+# Collector of TODO Puzzles in Source Code
 
 [![EO principles respected here](https://www.elegantobjects.org/badge.svg)](https://www.elegantobjects.org)
-[![DevOps By Rultor.com](http://www.rultor.com/b/cqfn/pdd)](http://www.rultor.com/p/cqfn/pdd)
+[![DevOps By Rultor.com](https://www.rultor.com/b/cqfn/pdd)](https://www.rultor.com/p/cqfn/pdd)
 [![We recommend RubyMine](https://www.elegantobjects.org/rubymine.svg)](https://www.jetbrains.com/ruby/)
 
 [![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)
+[![PDD status](https://www.0pdd.com/svg?name=cqfn/pdd)](https://www.0pdd.com/p?name=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)
+[![Gem Version](https://badge.fury.io/rb/pdd.svg)](https://badge.fury.io/rb/pdd)
 [![Maintainability](https://api.codeclimate.com/v1/badges/c8e46256fdd8ddc817e5/maintainability)](https://codeclimate.com/github/cqfn/pdd/maintainability)
-[![Yard Docs](http://img.shields.io/badge/yard-docs-blue.svg)](http://rubydoc.info/github/cqfn/pdd/master/frames)
+[![Yard Docs](https://img.shields.io/badge/yard-docs-blue.svg)](https://rubydoc.info/github/cqfn/pdd/master/frames)
 [![Codacy Badge](https://app.codacy.com/project/badge/Grade/1792d42f96fb45448e8d495ebc4348aa)](https://www.codacy.com/gh/cqfn/pdd/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=cqfn/pdd&amp;utm_campaign=Badge_Grade)
 
 Read this article about
 [_Puzzle Driven Development_](http://www.yegor256.com/2009/03/04/pdd.html).
-Check also patent application [US 12/840,306](http://www.google.com/patents/US20120023476)
+Check also patent application
+[US 12/840,306](http://www.google.com/patents/US20120023476)
 
-Also, check [0pdd.com](http://www.0pdd.com): a hosted service,
+Also, check [0pdd.com](https://www.0pdd.com): a hosted service,
 where this command line tool works for you.
 
 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).
 
-First, make sure Ruby 2.6+ and [`libmagic`](#how-to-install-libmagic) are installed. 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
+gem install pdd
 ```
 
 Run it locally and read its output:
 
 ```bash
-$ pdd --help
+pdd --help
 ```
 
 ## Usage
 
-You can exclude & include certain number of files from the search via these options:
+You can exclude & include certain number of files from the search
+via these options:
 
 ```bash
-$ pdd --exclude glob
+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:
+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:
 
 ```bash
-$ pdd --include glob
+pdd --include glob
 ```
 
-Search only files whose name matches glob, using wildcard matching as described under ``--exclude``. 
-If contradictory ``--include`` and ``--exclude`` options are given, the last matching one wins. 
-If no ``--include`` or ``--exclude`` options are given, all files from working directory are included, example:
+Search only files whose name matches glob, using wildcard matching
+as described under ``--exclude``.
+If contradictory ``--include`` and ``--exclude`` options are given,
+the last matching one wins.
+If no ``--include`` or ``--exclude`` options are given, all files
+from the 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]
+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                                                                           |
@@ -83,15 +92,15 @@ $ pdd [--verbose] [--quiet] [--remove] [--skip-gitignore] [--skip-errors] \
 | --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)              |
+| --source project-path   | Source directory to parse ("." by default)                                            |
+| --file puzzles.xml      | File to save report into (xml or 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.
+You can see a file example in this project.
 
 ## How to Format?
 
@@ -116,17 +125,17 @@ 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. 
+ *  The text can be so long, as needed, just use
+ *  the same amount of spaces, as the second line.
+ * This text will not be a part of the puzzle, as
+ * it has less spaces.
  */
 void sendEmail() {
   throw new UnsupportedOperationException();
 }
 ```
 
-If you use it in combination with [0pdd](http://www.0pdd.com),
+If you use it in combination with [0pdd](https://www.0pdd.com),
 after processing this text, the issue titled
 "File.java:10-13: This is something to do later in one of ..." will be created.
 The specified markers will be included in the issues body
@@ -140,34 +149,35 @@ There are 3 supported keywords, one of which must precede the mandatory
 puzzle marker. They are `@todo`, `TODO` and `TODO:`.
 
 As an example, it starts with `@todo`, followed by a space and a mandatory
-puzzle **marker**. Possible formats of puzzle markers (it doesn't matter what the
-line starts with and where it is located,
+puzzle **marker**. Possible formats of puzzle markers
+(it doesn't matter what the line starts with and where it is located,
 as long as you have one of the 3 supported keywords right in front
 of the mandatory marker):
 
-```
+```text
 // @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
+// TODO #TEST-21:30min Puzzle description
 ```
 
-Here `DES` and `DEV` are the roles of people who must fix that puzzles;
+Here `DES` and `DEV` are the roles of people who must fix these puzzles;
 `45min` and `40m` is the amount of time the puzzle should take;
 `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
 us to build a hierarchical dependency tree of all puzzles, like
-[this one](http://www.0pdd.com/p?name=yegor256/takes),
+[this one](https://www.0pdd.com/p?name=yegor256/takes),
 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). 
+
+- **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.
@@ -175,24 +185,24 @@ prefix should be presented with it.
 Examples:
 
 ```xml
-<!-- 
- ~ if comment should be started and closed by special symbols, then place them in
+<!--
+ ~ if comments 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. 
+ ~  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 
+ * @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  
+ *  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.
  *
@@ -207,7 +217,7 @@ You can specify post-parsing rules for your puzzles, in command line,
 for example:
 
 ```bash
-$ pdd --rule min-estimate:60 --rule max-estimate:120
+pdd --rule min-estimate:60 --rule max-estimate:120
 ```
 
 These two parameters will add two post-parsing rules `min-estimate`
@@ -233,12 +243,13 @@ Here is a list of rules available now:
 
 :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).
+See, how it is done in
+[yegor256/0pdd](https://github.com/yegor256/0pdd/blob/master/.pdd).
 
 ## How to read XML
 
 The XML produced will look approximately like this (here is a
-[real example](http://www.0pdd.com/snapshot?name=yegor256/takes)):
+[real example](https://www.0pdd.com/snapshot?name=yegor256/takes)):
 
 ```xml
 <puzzles>
@@ -256,6 +267,7 @@ The XML produced will look approximately like this (here is a
   </puzzle>
 </puzzles>
 ```
+
 NOTE: puzzles are saved with utf-8 encoding
 
 [XSD Schema](http://pdd-xsd.teamed.io/0.19.4.xsd) is here.
@@ -279,35 +291,37 @@ The most interesting parts of each puzzle are:
 For Debian/Ubuntu:
 
 ```bash
-$ apt install libmagic-dev
+apt install libmagic-dev
 ```
 
-For Mac:
+For macOS:
 
 ```bash
-$ brew install libmagic
+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 
+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.7+ 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
+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
+gem install overcommit -v '=0.58.0'
+overcommit --install
 ```
 
 If it's clean and you don't see any error messages, submit your pull request.
@@ -315,11 +329,11 @@ If it's clean and you don't see any error messages, submit your pull request.
 This is how you run the tool locally to test how it works:
 
 ```bash
-$ ./bin/pdd --help
+./bin/pdd --help
 ```
 
 To run a single unit test:
 
 ```bash
-$ bundle exec ruby test/test_many.rb
+bundle exec ruby test/test_many.rb
 ```

data/REUSE.toml

@@ -0,0 +1,43 @@
+# SPDX-FileCopyrightText: Copyright (c) 2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+
+version = 1
+[[annotations]]
+path = [
+    ".DS_Store",
+    ".gitattributes",
+    ".gitignore",
+    ".overcommit.yml",
+    ".pdd",
+    "**.ico",
+    "**.jpg",
+    "**.json",
+    "**.md",
+    "**.pdf",
+    "**.png",
+    "**.txt",
+    "**.woff",
+    "**/.DS_Store",
+    "**/.gitignore",
+    "**/.pdd",
+    "**/*.csv",
+    "**/*.jpg",
+    "**/*.json",
+    "**/*.md",
+    "**/*.pdf",
+    "**/*.png",
+    "**/*.svg",
+    "**/*.txt",
+    "**/*.vm",
+    "**/CITATION.cff",
+    "**/CNAME",
+    "**/Gemfile.lock",
+    "CITATION.cff",
+    "Gemfile.lock",
+    "README.md",
+    "renovate.json",
+    "test_assets/puzzles/**",
+]
+precedence = "override"
+SPDX-FileCopyrightText = "Copyright (c) 2025 Yegor Bugayenko"
+SPDX-License-Identifier = "MIT"

data/Rakefile

@@ -1,22 +1,5 @@
-# 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.
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 require 'rubygems'
 require 'rake'
@@ -31,7 +14,7 @@ def version
   Gem::Specification.load(Dir['*.gemspec'].first).version
 end
 
-task default: %i[clean test features rubocop xcop copyright]
+task default: %i[clean test features rubocop xcop]
 
 require 'rake/testtask'
 desc 'Run all unit tests'
@@ -55,15 +38,13 @@ require 'rubocop/rake_task'
 desc 'Run RuboCop on all directories'
 RuboCop::RakeTask.new(:rubocop) do |task|
   task.fail_on_error = true
-  task.requires << 'rubocop-rspec'
 end
 
 require 'xcop/rake_task'
 desc 'Validate all XML/XSL/XSD/HTML files for formatting'
 Xcop::RakeTask.new :xcop do |task|
-  task.license = 'LICENSE.txt'
   task.includes = ['**/*.xml', '**/*.xsl', '**/*.xsd', '**/*.html']
-  task.excludes = ['target/**/*', 'coverage/**/*']
+  task.excludes = ['target/**/*', 'coverage/**/*', 'vendor/**/*']
 end
 
 require 'pdd/rake_task'
@@ -83,11 +64,3 @@ 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')}' \
-    --include '*.rb' \
-    --include '*.txt' \
-    --include 'Rakefile' \
-    ."
-end

data/assets/puzzles.xsd

@@ -1,26 +1,7 @@
-<?xml version="1.0"?>
+<?xml version="1.0" encoding="UTF-8"?>
 <!--
-(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.
+ * SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+ * SPDX-License-Identifier: MIT
 -->
 <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
   <xs:complexType name="puzzle">

data/assets/puzzles.xsl

@@ -1,26 +1,7 @@
-<?xml version="1.0"?>
+<?xml version="1.0" encoding="UTF-8"?>
 <!--
-(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.
+ * SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+ * SPDX-License-Identifier: MIT
 -->
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns="http://www.w3.org/1999/xhtml" version="1.0">
   <xsl:template match="/">

data/assets/puzzles_json.xsl

@@ -1,26 +1,7 @@
-<?xml version="1.0"?>
+<?xml version="1.0" encoding="UTF-8"?>
 <!--
-(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.
+ * SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+ * SPDX-License-Identifier: MIT
 -->
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
   <xsl:output method="text" omit-xml-declaration="yes"/>
@@ -61,7 +42,7 @@ SOFTWARE.
     <xsl:text>", </xsl:text>
     <xsl:text>
       "body": "</xsl:text>
-    <xsl:value-of select="translate(body, '&quot;', '&#x201C;')"/>
+    <xsl:value-of select="translate(body, '&quot;', '“')"/>
     <xsl:text>", </xsl:text>
     <xsl:text>
       "estimate": "</xsl:text>

data/bin/pdd

@@ -1,26 +1,10 @@
 #!/usr/bin/env ruby
-# 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 NONINFINGEMENT. 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.
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 
 $stdout.sync = true
 
+require 'backtrace'
 require 'shellwords'
 require 'English'
 require 'find'
@@ -132,7 +116,7 @@ https://github.com/cqfn/pdd/blob/master/README.md"
       File.write(
         f,
         File.readlines(f).reject.each_with_index do |_t, i|
-          all.any? { |pair| i + 1 >= pair[0] && i + 1 <= pair[1] }
+          all.any? { |pair| i + (1.between?(pair[0], pair[1]) ? 1 : 0) }
         end.join
       )
       PDD.log.info "#{all.count} puzzles removed from #{src}"
@@ -153,6 +137,7 @@ more documentation: https://github.com/cqfn/pdd/blob/master/README.md."
   exit(1)
 rescue StandardError => e
   PDD.log.error "#{Rainbow('ERROR').red} (#{e.class.name}): #{e.message}"
+  PDD.log.error Backtrace.new(e).to_s
   PDD.log.info 'Exit code is 255'
   exit(255)
 end

data/cucumber.yml

@@ -1,3 +1,6 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
+---
 default: --format pretty
 travis: --format progress
 html_report: --format progress --format html --out=features_report.html

data/features/applies_rules.feature

@@ -1,3 +1,5 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 Feature: Applies Post-Parsing Rules
   As a source code writer I want to be sure that
   certain post-parsing rules are applied

data/features/avoiding_duplicates.feature

@@ -1,3 +1,5 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 Feature: Avoiding Duplicate Puzzles
   As a source code writer I want to be sure that
   XML output doesn't contain any duplicates

data/features/catches_broken_puzzles.feature

@@ -1,3 +1,5 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 Feature: Catches Broken Puzzles
   As a source code writer I want to be sure that
   broken puzzles won't be processed and will

data/features/cli.feature

@@ -1,3 +1,5 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 Feature: Command Line Processing
   As a source code writer I want to be able to
   call PDD as a command line tool

data/features/gem_package.feature

@@ -1,3 +1,5 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 Feature: Gem Package
   As a source code writer I want to be able to
   package the Gem into .gem file

data/features/html_output.feature

@@ -1,3 +1,5 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 Feature: HTML output
   As a source code writer I want to be able to
   call PDD as a command line tool, and retrieve an

data/features/json_output.feature

@@ -1,3 +1,5 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 Feature: JSON output
   As a source code writer I want to be able to
   call PDD as a command line tool, and retrieve an

data/features/parsing.feature

@@ -1,3 +1,5 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 Feature: Parsing
   As a source code writer I want to be able to
   collect all puzzles from all my text files and

data/features/rake.feature

@@ -1,3 +1,5 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 Feature: Rake Task
   As a source code writer I want to be able to
   run PDD from Rakefile
@@ -17,5 +19,3 @@ Feature: Rake Task
 
     When I run bash with "rake pdd"
     Then Exit code is zero
-
-

data/features/remove.feature

@@ -1,3 +1,5 @@
+# SPDX-FileCopyrightText: Copyright (c) 2014-2025 Yegor Bugayenko
+# SPDX-License-Identifier: MIT
 Feature: Removing Puzzles
   As a source code writer I want to be able to
   remove PDD puzzles from source code