From b9a510c70742dd902dc93d0a4110c168b18ca272 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Thu, 7 Jan 2021 21:02:51 +0000
Subject: [PATCH 01/64] Switch to GitHub Actions

---
 .github/workflows/ci.yml   | 53 ++++++++++++++++++++++++++++++++++++++
 .github/workflows/lint.yml | 21 +++++++++++++++
 .travis.yml => travis.yml  |  0
 3 files changed, 74 insertions(+)
 create mode 100644 .github/workflows/ci.yml
 create mode 100644 .github/workflows/lint.yml
 rename .travis.yml => travis.yml (100%)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 00000000..43a70494
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,53 @@
+name: Ruby CI
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+  push:
+    branches:
+      - main
+
+jobs:
+  test:
+    env:
+      NOKOGIRI_USE_SYSTEM_LIBRARIES: true
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: true
+      matrix:
+        gemfile:
+          - gemfiles/rails_6.gemfile
+          - gemfiles/rails_5.gemfile
+          - gemfiles/rails_4.gemfile
+          - gemfiles/rails_3.gemfile
+        ruby-version:
+          - 3.0.0
+          - 2.7.2
+          - 2.6.6
+          - 2.5.8
+        experimental: [false]
+        include:
+          - ruby-version: head
+            experimental: true
+          - ruby-version: truffleruby-head
+            experimental: true
+
+    continue-on-error: ${{ matrix.experimental }}
+
+    env:
+      BUNDLE_GEMFILE: gemfiles/${{ matrix.gemfile }}.gemfile
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Install libxslt and libxml2
+        run: sudo apt-get install libxslt-dev libxml2-dev
+      - name: Set up Ruby ${{ matrix.ruby-version }}
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true
+      - name: Install dependencies
+        run: bundle install
+      - name: Run tests
+        run: bundle exec rake
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
new file mode 100644
index 00000000..fa9e7c11
--- /dev/null
+++ b/.github/workflows/lint.yml
@@ -0,0 +1,21 @@
+name: Linting
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+  push:
+    branches:
+      - main
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.0
+          bundler-cache: true
+      - run: bundle install
+      - name: Rubocop
+        run: bundle exec rake rubocop
diff --git a/.travis.yml b/travis.yml
similarity index 100%
rename from .travis.yml
rename to travis.yml

From 553eecea36c17067eeab4ddd971ca607d97e2c73 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Thu, 7 Jan 2021 21:09:26 +0000
Subject: [PATCH 02/64] Drop double env

---
 .github/workflows/ci.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 43a70494..da9be7ea 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -9,8 +9,6 @@ on:
 
 jobs:
   test:
-    env:
-      NOKOGIRI_USE_SYSTEM_LIBRARIES: true
     runs-on: ubuntu-latest
 
     strategy:

From 30b49fdac356e4c18574da4dfde5d4826126d3aa Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Thu, 7 Jan 2021 21:11:32 +0000
Subject: [PATCH 03/64] Let it fail

---
 .github/workflows/lint.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index fa9e7c11..b8a5c0ed 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -10,6 +10,7 @@ on:
 jobs:
   test:
     runs-on: ubuntu-latest
+    continue-on-error: true
     steps:
       - uses: actions/checkout@v2
       - uses: ruby/setup-ruby@v1

From 1d31f832030fd95e7f9cbd036722be7e3e9a0391 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Thu, 7 Jan 2021 21:11:38 +0000
Subject: [PATCH 04/64] Drop extension

---
 .github/workflows/ci.yml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index da9be7ea..a33c6db4 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -15,10 +15,10 @@ jobs:
       fail-fast: true
       matrix:
         gemfile:
-          - gemfiles/rails_6.gemfile
-          - gemfiles/rails_5.gemfile
-          - gemfiles/rails_4.gemfile
-          - gemfiles/rails_3.gemfile
+          - rails_6
+          - rails_5
+          - rails_4
+          - rails_3
         ruby-version:
           - 3.0.0
           - 2.7.2

From 10415172dd16e982da9683cd46dc8fa5afa19bf6 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Thu, 7 Jan 2021 21:33:59 +0000
Subject: [PATCH 05/64] Add bundler args

---
 .github/workflows/ci.yml | 2 +-
 html-pipeline.gemspec    | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index a33c6db4..be95382c 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -46,6 +46,6 @@ jobs:
           ruby-version: ${{ matrix.ruby-version }}
           bundler-cache: true
       - name: Install dependencies
-        run: bundle install
+        run: bundle install --path ../../vendor/bundle
       - name: Run tests
         run: bundle exec rake
diff --git a/html-pipeline.gemspec b/html-pipeline.gemspec
index ec88cfe2..e87e5263 100644
--- a/html-pipeline.gemspec
+++ b/html-pipeline.gemspec
@@ -8,7 +8,7 @@ Gem::Specification.new do |gem|
   gem.license       = 'MIT'
   gem.authors       = ['Ryan Tomayko', 'Jerry Cheung', 'Garen J. Torikian']
   gem.email         = ['ryan@github.com', 'jerry@github.com', 'gjtorikian@gmail.com']
-  gem.description   = 'GitHub HTML processing filters and utilities'
+  gem.description   = 'HTML processing filters and utilities'
   gem.summary       = 'Helpers for processing content through a chain of filters'
   gem.homepage      = 'https://github.com/jch/html-pipeline'
 

From f49a5573ccf1b0999c8e08186b922bac9694bfbd Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Thu, 7 Jan 2021 21:35:13 +0000
Subject: [PATCH 06/64] Remove copy-paste

---
 .github/workflows/ci.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index be95382c..8b8bae85 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -38,8 +38,6 @@ jobs:
 
     steps:
       - uses: actions/checkout@v2
-      - name: Install libxslt and libxml2
-        run: sudo apt-get install libxslt-dev libxml2-dev
       - name: Set up Ruby ${{ matrix.ruby-version }}
         uses: ruby/setup-ruby@v1
         with:

From 818af6bc72c9bb2cbd87ea392e2fddcf0207fc51 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 8 Jan 2021 09:53:59 +0000
Subject: [PATCH 07/64] Drop old Rails and unnecessary active_support

---
 .github/workflows/ci.yml          |  8 ------
 Appraisals                        | 19 --------------
 Gemfile                           |  7 +++--
 gemfiles/rails_3.gemfile          | 27 -------------------
 gemfiles/rails_4.gemfile          | 27 -------------------
 gemfiles/rails_5.gemfile          | 26 -------------------
 gemfiles/rails_6.gemfile          | 26 -------------------
 html-pipeline.gemspec             |  6 +++--
 lib/html/pipeline.rb              |  1 -
 lib/html/pipeline/emoji_filter.rb | 13 ++++++----
 test/test_helper.rb               |  6 ++---
 travis.yml                        | 43 -------------------------------
 12 files changed, 19 insertions(+), 190 deletions(-)
 delete mode 100644 Appraisals
 delete mode 100644 gemfiles/rails_3.gemfile
 delete mode 100644 gemfiles/rails_4.gemfile
 delete mode 100644 gemfiles/rails_5.gemfile
 delete mode 100644 gemfiles/rails_6.gemfile
 delete mode 100644 travis.yml

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 8b8bae85..9658b3dc 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -14,11 +14,6 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        gemfile:
-          - rails_6
-          - rails_5
-          - rails_4
-          - rails_3
         ruby-version:
           - 3.0.0
           - 2.7.2
@@ -33,9 +28,6 @@ jobs:
 
     continue-on-error: ${{ matrix.experimental }}
 
-    env:
-      BUNDLE_GEMFILE: gemfiles/${{ matrix.gemfile }}.gemfile
-
     steps:
       - uses: actions/checkout@v2
       - name: Set up Ruby ${{ matrix.ruby-version }}
diff --git a/Appraisals b/Appraisals
deleted file mode 100644
index 6037fd68..00000000
--- a/Appraisals
+++ /dev/null
@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-appraise 'rails-3' do
-  gem 'rack', '< 2'
-  gem 'rails', '3.2.22.2'
-end
-
-appraise 'rails-4' do
-  gem 'rack', '< 2'
-  gem 'rails', '~> 4.2.6'
-end
-
-appraise 'rails-5' do
-  gem 'rails', '~> 5.0.0'
-end
-
-appraise 'rails-6' do
-  gem 'rails', '~> 6.0.0'
-end
diff --git a/Gemfile b/Gemfile
index adc923bd..89e7c6fa 100644
--- a/Gemfile
+++ b/Gemfile
@@ -5,8 +5,11 @@ source 'https://rubygems.org'
 # Specify your gem's dependencies in html-pipeline.gemspec
 gemspec
 
+group :development, :test do
+  gem 'awesome_print'
+end
+
 group :development do
-  gem 'appraisal'
   gem 'bundler'
   gem 'rake'
 end
@@ -21,6 +24,6 @@ group :test do
   gem 'sanitize',           '~> 4.6', require: false
 
   gem 'escape_utils', '~> 1.0', require: false
-  gem 'rouge', '~> 3.1', require: false
   gem 'minitest-focus', '~> 1.1'
+  gem 'rouge', '~> 3.1', require: false
 end
diff --git a/gemfiles/rails_3.gemfile b/gemfiles/rails_3.gemfile
deleted file mode 100644
index d3497431..00000000
--- a/gemfiles/rails_3.gemfile
+++ /dev/null
@@ -1,27 +0,0 @@
-# This file was generated by Appraisal
-
-source "https://rubygems.org"
-
-gem "rack", "< 2"
-gem "rails", "3.2.22.2"
-
-group :development do
-  gem "appraisal"
-  gem "bundler"
-  gem "rake"
-end
-
-group :test do
-  gem "commonmarker", "~> 0.16", require: false
-  gem "email_reply_parser", "~> 0.5", require: false
-  gem "gemoji", "~> 2.0", require: false
-  gem "minitest"
-  gem "RedCloth", "~> 4.2.9", require: false
-  gem "rinku", "~> 1.7", require: false
-  gem "sanitize", "~> 4.6", require: false
-  gem "escape_utils", "~> 1.0", require: false
-  gem "rouge", "~> 3.1", require: false
-  gem "minitest-focus", "~> 1.1"
-end
-
-gemspec path: "../"
diff --git a/gemfiles/rails_4.gemfile b/gemfiles/rails_4.gemfile
deleted file mode 100644
index a00d20ad..00000000
--- a/gemfiles/rails_4.gemfile
+++ /dev/null
@@ -1,27 +0,0 @@
-# This file was generated by Appraisal
-
-source "https://rubygems.org"
-
-gem "rack", "< 2"
-gem "rails", "~> 4.2.6"
-
-group :development do
-  gem "appraisal"
-  gem "bundler"
-  gem "rake"
-end
-
-group :test do
-  gem "commonmarker", "~> 0.16", require: false
-  gem "email_reply_parser", "~> 0.5", require: false
-  gem "gemoji", "~> 2.0", require: false
-  gem "minitest"
-  gem "RedCloth", "~> 4.2.9", require: false
-  gem "rinku", "~> 1.7", require: false
-  gem "sanitize", "~> 4.6", require: false
-  gem "escape_utils", "~> 1.0", require: false
-  gem "rouge", "~> 3.1", require: false
-  gem "minitest-focus", "~> 1.1"
-end
-
-gemspec path: "../"
diff --git a/gemfiles/rails_5.gemfile b/gemfiles/rails_5.gemfile
deleted file mode 100644
index 1f64a4f9..00000000
--- a/gemfiles/rails_5.gemfile
+++ /dev/null
@@ -1,26 +0,0 @@
-# This file was generated by Appraisal
-
-source "https://rubygems.org"
-
-gem "rails", "~> 5.0.0"
-
-group :development do
-  gem "appraisal"
-  gem "bundler"
-  gem "rake"
-end
-
-group :test do
-  gem "commonmarker", "~> 0.16", require: false
-  gem "email_reply_parser", "~> 0.5", require: false
-  gem "gemoji", "~> 2.0", require: false
-  gem "minitest"
-  gem "RedCloth", "~> 4.2.9", require: false
-  gem "rinku", "~> 1.7", require: false
-  gem "sanitize", "~> 4.6", require: false
-  gem "escape_utils", "~> 1.0", require: false
-  gem "rouge", "~> 3.1", require: false
-  gem "minitest-focus", "~> 1.1"
-end
-
-gemspec path: "../"
diff --git a/gemfiles/rails_6.gemfile b/gemfiles/rails_6.gemfile
deleted file mode 100644
index 134e8425..00000000
--- a/gemfiles/rails_6.gemfile
+++ /dev/null
@@ -1,26 +0,0 @@
-# This file was generated by Appraisal
-
-source "https://rubygems.org"
-
-gem "rails", "~> 6.0.0"
-
-group :development do
-  gem "appraisal"
-  gem "bundler"
-  gem "rake"
-end
-
-group :test do
-  gem "commonmarker", "~> 0.16", require: false
-  gem "email_reply_parser", "~> 0.5", require: false
-  gem "gemoji", "~> 2.0", require: false
-  gem "minitest"
-  gem "RedCloth", "~> 4.2.9", require: false
-  gem "rinku", "~> 1.7", require: false
-  gem "sanitize", "~> 4.6", require: false
-  gem "escape_utils", "~> 1.0", require: false
-  gem "rouge", "~> 3.1", require: false
-  gem "minitest-focus", "~> 1.1"
-end
-
-gemspec path: "../"
diff --git a/html-pipeline.gemspec b/html-pipeline.gemspec
index e87e5263..5a1c7552 100644
--- a/html-pipeline.gemspec
+++ b/html-pipeline.gemspec
@@ -15,8 +15,10 @@ Gem::Specification.new do |gem|
   gem.files         = `git ls-files -z`.split("\x0").reject { |f| f =~ %r{^(test|gemfiles|script)/} }
   gem.require_paths = ['lib']
 
-  gem.add_dependency 'activesupport', '>= 2'
-  gem.add_dependency 'nokogiri', '>= 1.4'
+  gem.required_ruby_version = ['>= 2.5.8', '< 4.0']
+
+  gem.add_dependency 'activesupport', '~> 4'
+  gem.add_dependency 'nokogiri', '~> 1.11'
 
   gem.post_install_message = <<msg
 -------------------------------------------------
diff --git a/lib/html/pipeline.rb b/lib/html/pipeline.rb
index 8f5cf8db..f1277b46 100644
--- a/lib/html/pipeline.rb
+++ b/lib/html/pipeline.rb
@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require 'nokogiri'
-require 'active_support/xml_mini/nokogiri' # convert Documents to hashes
 
 module HTML
   # GitHub HTML processing filters and utilities. This module includes a small
diff --git a/lib/html/pipeline/emoji_filter.rb b/lib/html/pipeline/emoji_filter.rb
index d22bb479..161b4093 100644
--- a/lib/html/pipeline/emoji_filter.rb
+++ b/lib/html/pipeline/emoji_filter.rb
@@ -68,12 +68,15 @@ def asset_path(name)
 
       # Build an emoji image tag
       def emoji_image_tag(name)
-        require 'active_support/core_ext/hash/indifferent_access'
         html_attrs =
-          default_img_attrs(name)
-          .merge!((context[:img_attrs] || {}).with_indifferent_access)
-          .map { |attr, value| !value.nil? && %(#{attr}="#{value.respond_to?(:call) && value.call(name) || value}") }
-          .reject(&:blank?).join(' '.freeze)
+          default_img_attrs(name).transform_keys(&:to_sym)
+          .merge!(context[:img_attrs] || {}).transform_keys(&:to_sym)
+          .each_with_object([]) do |(attr, value), arr|
+            next if value.nil?
+
+            value = value.respond_to?(:call) && value.call(name) || value
+            arr << %(#{attr}="#{value}")
+          end.compact.join(' '.freeze)
 
         "<img #{html_attrs}>"
       end
diff --git a/test/test_helper.rb b/test/test_helper.rb
index ddb78e80..530e272d 100644
--- a/test/test_helper.rb
+++ b/test/test_helper.rb
@@ -6,14 +6,12 @@
 require 'minitest/pride'
 require 'minitest/focus'
 
-require 'active_support/core_ext/string'
-
 module TestHelpers
   # Asserts that two html fragments are equivalent. Attribute order
   # will be ignored.
   def assert_equal_html(expected, actual)
-    assert_equal Nokogiri::HTML::DocumentFragment.parse(expected).to_hash,
-                 Nokogiri::HTML::DocumentFragment.parse(actual).to_hash
+    assert_equal Nokogiri::HTML::DocumentFragment.parse(expected).to_h,
+                 Nokogiri::HTML::DocumentFragment.parse(actual).to_h
   end
 end
 
diff --git a/travis.yml b/travis.yml
deleted file mode 100644
index ff321ccd..00000000
--- a/travis.yml
+++ /dev/null
@@ -1,43 +0,0 @@
-language: ruby
-cache: bundler
-bundler_args: --path ../../vendor/bundle
-
-addons:
-  apt:
-    sources:
-      - libicu-dev
-      - kalakris-cmake
-    packages:
-      - cmake
-
-script: bundle exec rake
-
-gemfile:
-  - gemfiles/rails_6.gemfile
-  - gemfiles/rails_5.gemfile
-  - gemfiles/rails_4.gemfile
-  - gemfiles/rails_3.gemfile
-
-rvm:
-  - 2.4.6
-  - 2.3.8
-  - 2.5.7
-  - ruby-head
-
-matrix:
-  fast_finish: true
-  allow_failures:
-    - rvm: ruby-head
-  exclude:
-    - gemfile: gemfiles/rails_6.gemfile
-      rvm: 2.4.6
-    - gemfile: gemfiles/rails_6.gemfile
-      rvm: 2.3.8
-    - gemfile: gemfiles/rails_4.gemfile
-      rvm: 2.5.7
-    - gemfile: gemfiles/rails_4.gemfile
-      rvm: 2.4.6
-    - gemfile: gemfiles/rails_3.gemfile
-      rvm: 2.5.7
-    - gemfile: gemfiles/rails_3.gemfile
-      rvm: 2.4.6

From 428ec51652b2f2390b4ab8d82b9405d02a2f1cfa Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 8 Jan 2021 10:04:59 +0000
Subject: [PATCH 08/64] Start linting

---
 .rubocop.yml          |  4 ++++
 Gemfile               |  4 ++++
 Rakefile              |  4 ++++
 html-pipeline.gemspec | 18 +++++++++---------
 4 files changed, 21 insertions(+), 9 deletions(-)
 create mode 100644 .rubocop.yml

diff --git a/.rubocop.yml b/.rubocop.yml
new file mode 100644
index 00000000..81748ee8
--- /dev/null
+++ b/.rubocop.yml
@@ -0,0 +1,4 @@
+inherit_gem:
+  rubocop-standard:
+    - config/default.yml
+    - config/minitest.yml
diff --git a/Gemfile b/Gemfile
index 89e7c6fa..0fd8711c 100644
--- a/Gemfile
+++ b/Gemfile
@@ -7,6 +7,10 @@ gemspec
 
 group :development, :test do
   gem 'awesome_print'
+
+  gem 'rubocop'
+  gem 'rubocop-performance'
+  gem 'rubocop-standard'
 end
 
 group :development do
diff --git a/Rakefile b/Rakefile
index f26f9adc..cc4508a3 100755
--- a/Rakefile
+++ b/Rakefile
@@ -15,3 +15,7 @@ Rake::TestTask.new do |t|
 end
 
 task default: :test
+
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new(:rubocop)
diff --git a/html-pipeline.gemspec b/html-pipeline.gemspec
index 5a1c7552..a8cd1d09 100644
--- a/html-pipeline.gemspec
+++ b/html-pipeline.gemspec
@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require File.expand_path('../lib/html/pipeline/version', __FILE__)
+require File.expand_path('lib/html/pipeline/version', __dir__)
 
 Gem::Specification.new do |gem|
   gem.name          = 'html-pipeline'
@@ -20,12 +20,12 @@ Gem::Specification.new do |gem|
   gem.add_dependency 'activesupport', '~> 4'
   gem.add_dependency 'nokogiri', '~> 1.11'
 
-  gem.post_install_message = <<msg
--------------------------------------------------
-Thank you for installing html-pipeline!
-You must bundle Filter gem dependencies.
-See html-pipeline README.md for more details.
-https://github.com/jch/html-pipeline#dependencies
--------------------------------------------------
-msg
+  gem.post_install_message = <<~MSG
+    -------------------------------------------------
+    Thank you for installing html-pipeline!
+    You must bundle Filter gem dependencies.
+    See html-pipeline README.md for more details.
+    https://github.com/jch/html-pipeline#dependencies
+    -------------------------------------------------
+  MSG
 end

From 17a06aa28902432b57c8a5bd3c185157c2de979e Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 8 Jan 2021 10:05:31 +0000
Subject: [PATCH 09/64] Drop truffle-ruby

---
 .github/workflows/ci.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 9658b3dc..e13625e7 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -23,8 +23,6 @@ jobs:
         include:
           - ruby-version: head
             experimental: true
-          - ruby-version: truffleruby-head
-            experimental: true
 
     continue-on-error: ${{ matrix.experimental }}
 

From f042ca9041443a16eeabb686f6ffbd70b2f5ab9a Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 8 Jan 2021 10:07:41 +0000
Subject: [PATCH 10/64] Obey the bundler

---
 .github/workflows/ci.yml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index e13625e7..a8d3b334 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -34,6 +34,8 @@ jobs:
           ruby-version: ${{ matrix.ruby-version }}
           bundler-cache: true
       - name: Install dependencies
-        run: bundle install --path ../../vendor/bundle
+        run: |
+          bundle config set --local path '../../vendor/bundle'
+          bundle install
       - name: Run tests
         run: bundle exec rake

From db3d990fc92538f7abec3a8349e7a8accd5e06f1 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 8 Jan 2021 10:10:14 +0000
Subject: [PATCH 11/64] Update deps

---
 Gemfile | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Gemfile b/Gemfile
index 0fd8711c..d4890b59 100644
--- a/Gemfile
+++ b/Gemfile
@@ -23,9 +23,9 @@ group :test do
   gem 'email_reply_parser', '~> 0.5', require: false
   gem 'gemoji', '~> 2.0', require: false
   gem 'minitest'
-  gem 'RedCloth',           '~> 4.2.9', require: false
-  gem 'rinku',              '~> 1.7',   require: false
-  gem 'sanitize',           '~> 4.6', require: false
+  gem 'RedCloth',           '~> 4.3', require: false
+  gem 'rinku',              '~> 1.7', require: false
+  gem 'sanitize',           '~> 5.2', require: false
 
   gem 'escape_utils', '~> 1.0', require: false
   gem 'minitest-focus', '~> 1.1'

From c904e2b2df427c1d3fb43c13f66b9172c79abc6f Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 8 Jan 2021 10:12:22 +0000
Subject: [PATCH 12/64] Drop activesupport dependency

---
 html-pipeline.gemspec | 1 -
 1 file changed, 1 deletion(-)

diff --git a/html-pipeline.gemspec b/html-pipeline.gemspec
index a8cd1d09..cf8dccb6 100644
--- a/html-pipeline.gemspec
+++ b/html-pipeline.gemspec
@@ -17,7 +17,6 @@ Gem::Specification.new do |gem|
 
   gem.required_ruby_version = ['>= 2.5.8', '< 4.0']
 
-  gem.add_dependency 'activesupport', '~> 4'
   gem.add_dependency 'nokogiri', '~> 1.11'
 
   gem.post_install_message = <<~MSG

From 18ace65286b7d5c3b638eee927732778d96749d3 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 8 Jan 2021 10:17:46 +0000
Subject: [PATCH 13/64] Lint first pass

---
 lib/html/pipeline.rb                          | 15 ++--
 lib/html/pipeline/@mention_filter.rb          | 15 ++--
 lib/html/pipeline/@team_mention_filter.rb     | 16 ++--
 lib/html/pipeline/absolute_source_filter.rb   |  2 +
 lib/html/pipeline/camo_filter.rb              |  2 +-
 lib/html/pipeline/email_reply_filter.rb       | 14 ++--
 lib/html/pipeline/emoji_filter.rb             | 16 ++--
 lib/html/pipeline/filter.rb                   |  1 +
 lib/html/pipeline/image_filter.rb             |  2 +-
 lib/html/pipeline/image_max_width_filter.rb   |  2 +-
 lib/html/pipeline/markdown_filter.rb          | 31 ++++----
 lib/html/pipeline/sanitization_filter.rb      | 37 ++++-----
 lib/html/pipeline/syntax_highlight_filter.rb  |  6 +-
 lib/html/pipeline/text_filter.rb              |  1 +
 lib/html/pipeline/toc_filter.rb               |  4 +-
 .../helpers/mocked_instrumentation_service.rb |  1 +
 .../pipeline/absolute_source_filter_test.rb   |  4 +-
 test/html/pipeline/camo_filter_test.rb        |  8 +-
 test/html/pipeline/email_reply_filter_test.rb | 78 +++++++++----------
 test/html/pipeline/emoji_filter_test.rb       |  2 +-
 test/html/pipeline/https_filter_test.rb       |  2 +-
 test/html/pipeline/image_filter_test.rb       |  2 +-
 .../pipeline/image_max_width_filter_test.rb   |  2 +-
 test/html/pipeline/markdown_filter_test.rb    | 22 +++---
 test/html/pipeline/mention_filter_test.rb     |  4 +-
 .../html/pipeline/sanitization_filter_test.rb | 18 ++---
 .../pipeline/syntax_highlight_filter_test.rb  | 14 ++--
 .../html/pipeline/team_mention_filter_test.rb |  8 +-
 test/html/pipeline/toc_filter_test.rb         |  2 +-
 test/html/pipeline_test.rb                    |  2 +-
 test/test_helper.rb                           |  2 +-
 31 files changed, 172 insertions(+), 163 deletions(-)

diff --git a/lib/html/pipeline.rb b/lib/html/pipeline.rb
index f1277b46..f68fbeac 100644
--- a/lib/html/pipeline.rb
+++ b/lib/html/pipeline.rb
@@ -46,6 +46,7 @@ class Pipeline
     autoload :TextFilter,            'html/pipeline/text_filter'
 
     class MissingDependencyError < RuntimeError; end
+
     def self.require_dependency(name, requirer)
       require name
     rescue LoadError => e
@@ -76,8 +77,10 @@ def self.parse(document_or_html)
 
     # Public: String name for this Pipeline. Defaults to Class name.
     attr_writer :instrumentation_name
+
     def instrumentation_name
       return @instrumentation_name if defined?(@instrumentation_name)
+
       @instrumentation_name = self.class.name
     end
 
@@ -88,6 +91,7 @@ class << self
 
     def initialize(filters, default_context = {}, result_class = nil)
       raise ArgumentError, 'default_context cannot be nil' if default_context.nil?
+
       @filters = filters.flatten.freeze
       @default_context = default_context.freeze
       @result_class = result_class || Hash
@@ -166,12 +170,11 @@ def setup_instrumentation(name = nil, service = nil)
     # block, otherwise the block is ran without instrumentation.
     #
     # Returns the result of the provided block.
-    def instrument(event, payload = nil)
+    def instrument(event, payload = nil, &block)
       payload ||= default_payload
       return yield(payload) unless instrumentation_service
-      instrumentation_service.instrument event, payload do |payload|
-        yield payload
-      end
+
+      instrumentation_service.instrument event, payload, &block
     end
 
     # Internal: Default payload for instrumentation.
@@ -192,9 +195,7 @@ class Nokogiri::XML::Node
     # ... some other shit when replacing text nodes. See 'utf-8 output 2' in
     # user_content_test.rb for details.
     def replace_with_encoding_fix(replacement)
-      if replacement.respond_to?(:to_str)
-        replacement = document.fragment("<div>#{replacement}</div>").children.first.children
-      end
+      replacement = document.fragment("<div>#{replacement}</div>").children.first.children if replacement.respond_to?(:to_str)
       replace_without_encoding_fix(replacement)
     end
 
diff --git a/lib/html/pipeline/@mention_filter.rb b/lib/html/pipeline/@mention_filter.rb
index 415a78c7..dcbc8144 100644
--- a/lib/html/pipeline/@mention_filter.rb
+++ b/lib/html/pipeline/@mention_filter.rb
@@ -40,22 +40,22 @@ def self.mentioned_logins_in(text, username_pattern = UsernamePattern)
 
       # Hash that contains all of the mention patterns used by the pipeline
       MentionPatterns = Hash.new do |hash, key|
-        hash[key] = /
+        hash[key] = %r{
           (?:^|\W)                    # beginning of string or non-word char
           @((?>#{key}))  # @username
-          (?!\/)                      # without a trailing slash
+          (?!/)                      # without a trailing slash
           (?=
             \.+[ \t\W]|               # dots followed by space or non-word character
             \.+$|                     # dots at end of line
             [^0-9a-zA-Z_.]|           # non-word character except dot
             $                         # end of line
           )
-        /ix
+        }ix
       end
 
       # Default pattern used to extract usernames from text. The value can be
       # overriden by providing the username_pattern variable in the context.
-      UsernamePattern = /[a-z0-9][a-z0-9-]*/
+      UsernamePattern = /[a-z0-9][a-z0-9-]*/.freeze
 
       # List of username logins that, when mentioned, link to the blog post
       # about @mentions instead of triggering a real mention.
@@ -67,7 +67,7 @@ def self.mentioned_logins_in(text, username_pattern = UsernamePattern)
       ].freeze
 
       # Don't look for mentions in text nodes that are children of these elements
-      IGNORE_PARENTS = %w(pre code a style script).to_set
+      IGNORE_PARENTS = %w[pre code a style script].to_set
 
       def call
         result[:mentioned_usernames] ||= []
@@ -76,8 +76,10 @@ def call
           content = node.to_html
           next unless content.include?('@')
           next if has_ancestor?(node, IGNORE_PARENTS)
+
           html = mention_link_filter(content, base_url, info_url, username_pattern)
           next if html == content
+
           node.replace(html)
         end
         doc
@@ -120,6 +122,7 @@ def mention_link_filter(text, _base_url = '/', info_url = nil, username_pattern
 
       def link_to_mention_info(text, info_url = nil)
         return "@#{text}" if info_url.nil?
+
         "<a href='#{info_url}' class='user-mention'>" \
           "@#{text}" \
           '</a>'
@@ -129,7 +132,7 @@ def link_to_mentioned_user(login)
         result[:mentioned_usernames] |= [login]
 
         url = base_url.dup
-        url << '/' unless url =~ /[\/~]\z/
+        url << '/' unless %r{[/~]\z}.match?(url)
 
         "<a href='#{url << login}' class='user-mention'>" \
           "@#{login}" \
diff --git a/lib/html/pipeline/@team_mention_filter.rb b/lib/html/pipeline/@team_mention_filter.rb
index 562ef344..0529ea82 100644
--- a/lib/html/pipeline/@team_mention_filter.rb
+++ b/lib/html/pipeline/@team_mention_filter.rb
@@ -29,8 +29,8 @@ class TeamMentionFilter < Filter
       # Returns a String replaced with the return of the block.
       def self.mentioned_teams_in(text, team_pattern = TeamPattern)
         text.gsub team_pattern do |match|
-          org = $1
-          team = $2
+          org = Regexp.last_match(1)
+          team = Regexp.last_match(2)
           yield match, org, team
         end
       end
@@ -38,13 +38,13 @@ def self.mentioned_teams_in(text, team_pattern = TeamPattern)
       # Default pattern used to extract team names from text. The value can be
       # overridden by providing the team_pattern variable in the context. To
       # properly link the mention, should be in the format of /@(1)\/(2)/.
-      TeamPattern = /
+      TeamPattern = %r{
         (?<=^|\W)                  # beginning of string or non-word char
         @([a-z0-9][a-z0-9-]*)      # @organization
-          \/                       # dividing slash
+          /                       # dividing slash
           ([a-z0-9][a-z0-9\-_]*)   # team
           \b
-      /ix
+      }ix.freeze
 
       # Don't look for mentions in text nodes that are children of these elements
       IGNORE_PARENTS = %w[pre code a style script].to_set
@@ -56,8 +56,10 @@ def call
           content = node.to_html
           next unless content.include?('@')
           next if has_ancestor?(node, IGNORE_PARENTS)
+
           html = mention_link_filter(content, base_url, team_pattern)
           next if html == content
+
           node.replace(html)
         end
         doc
@@ -88,8 +90,8 @@ def link_to_mentioned_team(org, team)
         result[:mentioned_teams] |= [team]
 
         url = base_url.dup
-        url << '/' unless url =~ /[\/~]\z/
-        
+        url << '/' unless %r{[/~]\z}.match?(url)
+
         "<a href='#{url << org}/#{team}' class='team-mention'>" \
           "@#{org}/#{team}" \
           '</a>'
diff --git a/lib/html/pipeline/absolute_source_filter.rb b/lib/html/pipeline/absolute_source_filter.rb
index 533491ac..7385d03a 100644
--- a/lib/html/pipeline/absolute_source_filter.rb
+++ b/lib/html/pipeline/absolute_source_filter.rb
@@ -21,8 +21,10 @@ class AbsoluteSourceFilter < Filter
       def call
         doc.search('img').each do |element|
           next if element['src'].nil? || element['src'].empty?
+
           src = element['src'].strip
           next if src.start_with? 'http'
+
           base = if src.start_with? '/'
                    image_base_url
                  else
diff --git a/lib/html/pipeline/camo_filter.rb b/lib/html/pipeline/camo_filter.rb
index 065b6ebc..6a2fda5a 100644
--- a/lib/html/pipeline/camo_filter.rb
+++ b/lib/html/pipeline/camo_filter.rb
@@ -98,7 +98,7 @@ def asset_host_allowed?(host)
       # Private: helper to hexencode a string. Each byte ends up encoded into
       # two characters, zero padded value in the range [0-9a-f].
       def hexencode(str)
-        str.unpack('H*').first
+        str.unpack1('H*')
       end
     end
   end
diff --git a/lib/html/pipeline/email_reply_filter.rb b/lib/html/pipeline/email_reply_filter.rb
index fef61949..3af74d41 100644
--- a/lib/html/pipeline/email_reply_filter.rb
+++ b/lib/html/pipeline/email_reply_filter.rb
@@ -15,13 +15,13 @@ class Pipeline
     class EmailReplyFilter < TextFilter
       include EscapeUtils
 
-      EMAIL_HIDDEN_HEADER    = %(<span class="email-hidden-toggle"><a href="#">&hellip;</a></span><div class="email-hidden-reply" style="display:none">).freeze
-      EMAIL_QUOTED_HEADER    = %(<div class="email-quoted-reply">).freeze
-      EMAIL_SIGNATURE_HEADER = %(<div class="email-signature-reply">).freeze
-      EMAIL_FRAGMENT_HEADER  = %(<div class="email-fragment">).freeze
-      EMAIL_HEADER_END       = '</div>'.freeze
-      EMAIL_REGEX            = /[^@\s.][^@\s]*@\[?[a-z0-9.-]+\]?/
-      HIDDEN_EMAIL_PATTERN   = '***@***.***'.freeze
+      EMAIL_HIDDEN_HEADER    = %(<span class="email-hidden-toggle"><a href="#">&hellip;</a></span><div class="email-hidden-reply" style="display:none">)
+      EMAIL_QUOTED_HEADER    = %(<div class="email-quoted-reply">)
+      EMAIL_SIGNATURE_HEADER = %(<div class="email-signature-reply">)
+      EMAIL_FRAGMENT_HEADER  = %(<div class="email-fragment">)
+      EMAIL_HEADER_END       = '</div>'
+      EMAIL_REGEX            = /[^@\s.][^@\s]*@\[?[a-z0-9.-]+\]?/.freeze
+      HIDDEN_EMAIL_PATTERN   = '***@***.***'
 
       # Scans an email body to determine which bits are quoted and which should
       # be hidden. EmailReplyParser is used to split the comment into an Array
diff --git a/lib/html/pipeline/emoji_filter.rb b/lib/html/pipeline/emoji_filter.rb
index 161b4093..5893b1a5 100644
--- a/lib/html/pipeline/emoji_filter.rb
+++ b/lib/html/pipeline/emoji_filter.rb
@@ -20,8 +20,10 @@ def call
           content = node.text
           next unless content.include?(':')
           next if has_ancestor?(node, ignored_ancestor_tags)
+
           html = emoji_image_filter(content)
           next if html == content
+
           node.replace(html)
         end
         doc
@@ -70,13 +72,13 @@ def asset_path(name)
       def emoji_image_tag(name)
         html_attrs =
           default_img_attrs(name).transform_keys(&:to_sym)
-          .merge!(context[:img_attrs] || {}).transform_keys(&:to_sym)
-          .each_with_object([]) do |(attr, value), arr|
+                                 .merge!(context[:img_attrs] || {}).transform_keys(&:to_sym)
+                                 .each_with_object([]) do |(attr, value), arr|
             next if value.nil?
 
             value = value.respond_to?(:call) && value.call(name) || value
             arr << %(#{attr}="#{value}")
-          end.compact.join(' '.freeze)
+          end.compact.join(' ')
 
         "<img #{html_attrs}>"
       end
@@ -84,13 +86,13 @@ def emoji_image_tag(name)
       # Default attributes for img tag
       def default_img_attrs(name)
         {
-          'class' => 'emoji'.freeze,
+          'class' => 'emoji',
           'title' => ":#{name}:",
           'alt' => ":#{name}:",
           'src' => emoji_url(name).to_s,
-          'height' => '20'.freeze,
-          'width' => '20'.freeze,
-          'align' => 'absmiddle'.freeze
+          'height' => '20',
+          'width' => '20',
+          'align' => 'absmiddle'
         }
       end
 
diff --git a/lib/html/pipeline/filter.rb b/lib/html/pipeline/filter.rb
index d4c9d4c2..edeef17b 100644
--- a/lib/html/pipeline/filter.rb
+++ b/lib/html/pipeline/filter.rb
@@ -66,6 +66,7 @@ def doc
       # called.
       def html
         raise InvalidDocumentException if @html.nil? && @doc.nil?
+
         @html || doc.to_html
       end
 
diff --git a/lib/html/pipeline/image_filter.rb b/lib/html/pipeline/image_filter.rb
index cd14d363..418dfd95 100644
--- a/lib/html/pipeline/image_filter.rb
+++ b/lib/html/pipeline/image_filter.rb
@@ -10,7 +10,7 @@ class Pipeline
 
     class ImageFilter < TextFilter
       def call
-        @text.gsub(/(https|http)?:\/\/.+\.(jpg|jpeg|bmp|gif|png)(\?\S+)?/i) do |match|
+        @text.gsub(%r{(https|http)?://.+\.(jpg|jpeg|bmp|gif|png)(\?\S+)?}i) do |match|
           %(<img src="#{match}" alt=""/>)
         end
       end
diff --git a/lib/html/pipeline/image_max_width_filter.rb b/lib/html/pipeline/image_max_width_filter.rb
index 1af301d4..8f076ad5 100644
--- a/lib/html/pipeline/image_max_width_filter.rb
+++ b/lib/html/pipeline/image_max_width_filter.rb
@@ -17,7 +17,7 @@ def call
 
           # Bail out if src doesn't look like a valid http url. trying to avoid weird
           # js injection via javascript: urls.
-          next if element['src'].to_s.strip =~ /\Ajavascript/i
+          next if /\Ajavascript/i.match?(element['src'].to_s.strip)
 
           element['style'] = 'max-width:100%;'
 
diff --git a/lib/html/pipeline/markdown_filter.rb b/lib/html/pipeline/markdown_filter.rb
index 2f899b3b..a6ae5f75 100644
--- a/lib/html/pipeline/markdown_filter.rb
+++ b/lib/html/pipeline/markdown_filter.rb
@@ -30,24 +30,23 @@ def call
           DEFAULT_COMMONMARKER_EXTENSIONS
         )
         html = if (renderer = context[:commonmarker_renderer])
-          unless renderer < CommonMarker::HtmlRenderer
-            raise ArgumentError, "`commonmark_renderer` must be derived from `CommonMarker::HtmlRenderer`"
-          end
-          parse_options = :DEFAULT
-          parse_options = [:UNSAFE] if context[:unsafe]
+                 raise ArgumentError, '`commonmark_renderer` must be derived from `CommonMarker::HtmlRenderer`' unless renderer < CommonMarker::HtmlRenderer
 
-          render_options = [:GITHUB_PRE_LANG]
-          render_options << :HARDBREAKS if context[:gfm] != false
-          render_options << :UNSAFE if context[:unsafe]
+                 parse_options = :DEFAULT
+                 parse_options = [:UNSAFE] if context[:unsafe]
 
-          doc = CommonMarker.render_doc(@text, parse_options, extensions)
-          renderer.new(options: render_options, extensions: extensions).render(doc)
-        else
-          options = [:GITHUB_PRE_LANG]
-          options << :HARDBREAKS if context[:gfm] != false
-          options << :UNSAFE if context[:unsafe]
-          CommonMarker.render_html(@text, options, extensions)
-        end
+                 render_options = [:GITHUB_PRE_LANG]
+                 render_options << :HARDBREAKS if context[:gfm] != false
+                 render_options << :UNSAFE if context[:unsafe]
+
+                 doc = CommonMarker.render_doc(@text, parse_options, extensions)
+                 renderer.new(options: render_options, extensions: extensions).render(doc)
+               else
+                 options = [:GITHUB_PRE_LANG]
+                 options << :HARDBREAKS if context[:gfm] != false
+                 options << :UNSAFE if context[:unsafe]
+                 CommonMarker.render_html(@text, options, extensions)
+               end
         html.rstrip!
         html
       end
diff --git a/lib/html/pipeline/sanitization_filter.rb b/lib/html/pipeline/sanitization_filter.rb
index 14037ef6..aac02d69 100644
--- a/lib/html/pipeline/sanitization_filter.rb
+++ b/lib/html/pipeline/sanitization_filter.rb
@@ -24,14 +24,14 @@ class Pipeline
     # This filter does not write additional information to the context.
     class SanitizationFilter < Filter
       LISTS     = Set.new(%w[ul ol].freeze)
-      LIST_ITEM = 'li'.freeze
+      LIST_ITEM = 'li'
 
       # List of table child elements. These must be contained by a <table> element
       # or they are not allowed through. Otherwise they can be used to break out
       # of places we're using tables to contain formatted user content (like pull
       # request review comments).
       TABLE_ITEMS = Set.new(%w[tr td th].freeze)
-      TABLE = 'table'.freeze
+      TABLE = 'table'
       TABLE_SECTIONS = Set.new(%w[thead tbody tfoot].freeze)
 
       # These schemes are the only ones allowed in <a href> attributes by default.
@@ -49,13 +49,13 @@ class SanitizationFilter < Filter
         ].freeze,
         remove_contents: ['script'].freeze,
         attributes: {
-          'a'          => ['href'].freeze,
-          'img'        => %w[src longdesc].freeze,
-          'div'        => %w[itemscope itemtype].freeze,
+          'a' => ['href'].freeze,
+          'img' => %w[src longdesc].freeze,
+          'div' => %w[itemscope itemtype].freeze,
           'blockquote' => ['cite'].freeze,
-          'del'        => ['cite'].freeze,
-          'ins'        => ['cite'].freeze,
-          'q'          => ['cite'].freeze,
+          'del' => ['cite'].freeze,
+          'ins' => ['cite'].freeze,
+          'q' => ['cite'].freeze,
           all: %w[abbr accept accept-charset
                   accesskey action align alt
                   aria-describedby aria-hidden aria-label aria-labelledby
@@ -76,13 +76,13 @@ class SanitizationFilter < Filter
                   vspace width itemprop].freeze
         }.freeze,
         protocols: {
-          'a'          => { 'href' => ANCHOR_SCHEMES }.freeze,
+          'a' => { 'href' => ANCHOR_SCHEMES }.freeze,
           'blockquote' => { 'cite' => ['http', 'https', :relative].freeze },
-          'del'        => { 'cite' => ['http', 'https', :relative].freeze },
-          'ins'        => { 'cite' => ['http', 'https', :relative].freeze },
-          'q'          => { 'cite' => ['http', 'https', :relative].freeze },
-          'img'        => {
-            'src'      => ['http', 'https', :relative].freeze,
+          'del' => { 'cite' => ['http', 'https', :relative].freeze },
+          'ins' => { 'cite' => ['http', 'https', :relative].freeze },
+          'q' => { 'cite' => ['http', 'https', :relative].freeze },
+          'img' => {
+            'src' => ['http', 'https', :relative].freeze,
             'longdesc' => ['http', 'https', :relative].freeze
           }.freeze
         },
@@ -92,18 +92,14 @@ class SanitizationFilter < Filter
           lambda { |env|
             name = env[:node_name]
             node = env[:node]
-            if name == LIST_ITEM && node.ancestors.none? { |n| LISTS.include?(n.name) }
-              node.replace(node.children)
-            end
+            node.replace(node.children) if name == LIST_ITEM && node.ancestors.none? { |n| LISTS.include?(n.name) }
           },
 
           # Table child elements that are not contained by a <table> are removed.
           lambda { |env|
             name = env[:node_name]
             node = env[:node]
-            if (TABLE_SECTIONS.include?(name) || TABLE_ITEMS.include?(name)) && node.ancestors.none? { |n| n.name == TABLE }
-              node.replace(node.children)
-            end
+            node.replace(node.children) if (TABLE_SECTIONS.include?(name) || TABLE_ITEMS.include?(name)) && node.ancestors.none? { |n| n.name == TABLE }
           }
         ].freeze
       }.freeze
@@ -134,6 +130,7 @@ def allowlist
         allowlist = context[:allowlist] || context[:whitelist] || ALLOWLIST
         anchor_schemes = context[:anchor_schemes]
         return allowlist unless anchor_schemes
+
         allowlist = allowlist.dup
         allowlist[:protocols] = (allowlist[:protocols] || {}).dup
         allowlist[:protocols]['a'] = (allowlist[:protocols]['a'] || {}).merge('href' => anchor_schemes)
diff --git a/lib/html/pipeline/syntax_highlight_filter.rb b/lib/html/pipeline/syntax_highlight_filter.rb
index 5f695f8c..9c8f5f25 100644
--- a/lib/html/pipeline/syntax_highlight_filter.rb
+++ b/lib/html/pipeline/syntax_highlight_filter.rb
@@ -21,7 +21,7 @@ def initialize(*args)
 
       def call
         doc.search('pre').each do |node|
-          default = context[:highlight] && context[:highlight].to_s
+          default = context[:highlight]&.to_s
           next unless lang = node['lang'] || default
           next unless lexer = lexer_for(lang)
 
@@ -30,7 +30,7 @@ def call
           next if html.nil?
 
           node.inner_html = html
-          scope = context.fetch(:scope) { 'highlight' }
+          scope = context.fetch(:scope, 'highlight')
           node['class'] = "#{scope} #{scope}-#{lang}"
         end
         doc
@@ -38,7 +38,7 @@ def call
 
       def highlight_with_timeout_handling(text, lexer)
         Rouge.highlight(text, lexer, @formatter)
-      rescue Timeout::Error => _
+      rescue Timeout::Error => _e
         nil
       end
 
diff --git a/lib/html/pipeline/text_filter.rb b/lib/html/pipeline/text_filter.rb
index 13a8f048..2609f523 100644
--- a/lib/html/pipeline/text_filter.rb
+++ b/lib/html/pipeline/text_filter.rb
@@ -7,6 +7,7 @@ class TextFilter < Filter
 
       def initialize(text, context = nil, result = nil)
         raise TypeError, 'text cannot be HTML' if text.is_a?(DocumentFragment)
+
         # Ensure that this is always a string
         @text = text.respond_to?(:to_str) ? text.to_str : text.to_s
         super nil, context, result
diff --git a/lib/html/pipeline/toc_filter.rb b/lib/html/pipeline/toc_filter.rb
index 6cc592c6..dd4b4a52 100644
--- a/lib/html/pipeline/toc_filter.rb
+++ b/lib/html/pipeline/toc_filter.rb
@@ -35,7 +35,7 @@ def anchor_icon
       end
 
       def call
-        result[:toc] = String.new('')
+        result[:toc] = +''
 
         headers = Hash.new(0)
         doc.css('h1, h2, h3, h4, h5, h6').each do |node|
@@ -44,7 +44,7 @@ def call
           id.gsub!(PUNCTUATION_REGEXP, '') # remove punctuation
           id.tr!(' ', '-') # replace spaces with dash
 
-          uniq = headers[id] > 0 ? "-#{headers[id]}" : ''
+          uniq = (headers[id]).positive? ? "-#{headers[id]}" : ''
           headers[id] += 1
           if header_content = node.children.first
             result[:toc] << %(<li><a href="##{id}#{uniq}">#{EscapeUtils.escape_html(text)}</a></li>\n)
diff --git a/test/helpers/mocked_instrumentation_service.rb b/test/helpers/mocked_instrumentation_service.rb
index f0ae1d38..947e177d 100644
--- a/test/helpers/mocked_instrumentation_service.rb
+++ b/test/helpers/mocked_instrumentation_service.rb
@@ -2,6 +2,7 @@
 
 class MockedInstrumentationService
   attr_reader :events
+
   def initialize(event = nil, events = [])
     @events = events
     subscribe event
diff --git a/test/html/pipeline/absolute_source_filter_test.rb b/test/html/pipeline/absolute_source_filter_test.rb
index e5c618f4..917f2417 100644
--- a/test/html/pipeline/absolute_source_filter_test.rb
+++ b/test/html/pipeline/absolute_source_filter_test.rb
@@ -29,8 +29,8 @@ def test_rewrites_relative_urls
   def test_does_not_rewrite_absolute_urls
     orig = %(<p><img src="http://other.example.com/img.png"></p>)
     result = AbsoluteSourceFilter.call(orig, @options).to_s
-    refute_match /@image_base_url/, result
-    refute_match /@image_subpage_url/, result
+    refute_match(/@image_base_url/, result)
+    refute_match(/@image_subpage_url/, result)
   end
 
   def test_fails_when_context_is_missing
diff --git a/test/html/pipeline/camo_filter_test.rb b/test/html/pipeline/camo_filter_test.rb
index d1be55c1..57aada68 100644
--- a/test/html/pipeline/camo_filter_test.rb
+++ b/test/html/pipeline/camo_filter_test.rb
@@ -73,8 +73,8 @@ def test_required_context_validation
     exception = assert_raises(ArgumentError) do
       CamoFilter.call('', {})
     end
-    assert_match /:asset_proxy[^_]/, exception.message
-    assert_match /:asset_proxy_secret_key/, exception.message
+    assert_match(/:asset_proxy[^_]/, exception.message)
+    assert_match(/:asset_proxy_secret_key/, exception.message)
   end
 
   def test_deprecated_asset_proxy_whitelist_context
@@ -89,7 +89,7 @@ def test_deprecated_asset_proxy_whitelist_context
 
   def test_deprecation_warning_asset_proxy_whitelist
     orig = %(<p><img></p>)
-    _stdout, stderror  = capture_io do
+    _stdout, stderror = capture_io do
       CamoFilter.new(orig, @options).asset_proxy_whitelist
     end
     assert_match "[DEPRECATION] 'asset_proxy_whitelist' is deprecated. Please use 'asset_proxy_allowlist' instead.", stderror
@@ -98,7 +98,7 @@ def test_deprecation_warning_asset_proxy_whitelist
   def test_deprecation_warning_asset_host_whitelisted
     orig = %(<p><img></p>)
     host = 'https://facebook.com'
-    _stdout, stderror  = capture_io do
+    _stdout, stderror = capture_io do
       CamoFilter.new(orig, @options).asset_host_whitelisted?(host)
     end
     assert_match "[DEPRECATION] 'asset_host_whitelisted?' is deprecated. Please use 'asset_host_allowed?' instead.", stderror
diff --git a/test/html/pipeline/email_reply_filter_test.rb b/test/html/pipeline/email_reply_filter_test.rb
index 1b27d905..0868d52b 100644
--- a/test/html/pipeline/email_reply_filter_test.rb
+++ b/test/html/pipeline/email_reply_filter_test.rb
@@ -6,62 +6,62 @@
 
 class HTML::Pipeline::EmailReplyFilterTest < Minitest::Test
   def setup
-    @body = <<-EMAIL
-Hey, don't send email addresses in comments. They aren't filtered.
-
-> On Mar 5, 2016, at 08:05, Boaty McBoatface <boatymcboatface@example.com> wrote:
->
-> Sup. alreadyleaked@example.com
->
-> —
-> Reply to this email directly or view it on GitHub.
-EMAIL
+    @body = <<~EMAIL
+            Hey, don't send email addresses in comments. They aren't filtered.
+      #{'      '}
+            > On Mar 5, 2016, at 08:05, Boaty McBoatface <boatymcboatface@example.com> wrote:
+            >
+            > Sup. alreadyleaked@example.com
+            >
+            > —
+            > Reply to this email directly or view it on GitHub.
+    EMAIL
   end
 
   def test_doesnt_hide_by_default
     filter = EmailReplyFilter.new(@body)
     doc = filter.call.to_s
-    assert_match /alreadyleaked@example.com/, doc
-    assert_match /boatymcboatface@example.com/, doc
+    assert_match(/alreadyleaked@example.com/, doc)
+    assert_match(/boatymcboatface@example.com/, doc)
   end
 
   def test_hides_email_addresses_when_configured
     filter = EmailReplyFilter.new(@body, hide_quoted_email_addresses: true)
     doc = filter.call.to_s
-    refute_match /boatymcboatface@example.com/, doc
-    refute_match /alreadyleaked@example.com/, doc
+    refute_match(/boatymcboatface@example.com/, doc)
+    refute_match(/alreadyleaked@example.com/, doc)
   end
 
   def test_preserves_non_email_content_while_filtering
-    str = <<-EMAIL
-> Thank you! I have some thoughts on this pull request.
->
->  *  acme provides cmake and a wrapper for it. Please use '$(TARGET)-cmake' instead of cmake -DCMAKE_TOOLCHAIN_FILE='$(CMAKE_TOOLCHAIN_FILE)' -DCMAKE_BUILD_TYPE=Release.
-
-Okay -- I'm afraid I just blindly copied the eigen3.mk file, since that's a library I'm familiar with :-)
-
->  *  Do you need -DCMAKE_SYSTEM_PROCESSOR=x86?
-
-Yes, this is a bit dumb, but vc checks for that (or amd) to determine that it's not being built on ARM.
-
---
-Boaty McBoatface | http://example.org
-EMAIL
+    str = <<~EMAIL
+            > Thank you! I have some thoughts on this pull request.
+            >
+            >  *  acme provides cmake and a wrapper for it. Please use '$(TARGET)-cmake' instead of cmake -DCMAKE_TOOLCHAIN_FILE='$(CMAKE_TOOLCHAIN_FILE)' -DCMAKE_BUILD_TYPE=Release.
+      #{'      '}
+            Okay -- I'm afraid I just blindly copied the eigen3.mk file, since that's a library I'm familiar with :-)
+      #{'      '}
+            >  *  Do you need -DCMAKE_SYSTEM_PROCESSOR=x86?
+      #{'      '}
+            Yes, this is a bit dumb, but vc checks for that (or amd) to determine that it's not being built on ARM.
+      #{'      '}
+            --
+            Boaty McBoatface | http://example.org
+    EMAIL
 
     filter = EmailReplyFilter.new(str, hide_quoted_email_addresses: true)
     doc = filter.call.to_s
 
-    expected = <<-EXPECTED
-<div class="email-quoted-reply"> Thank you! I have some thoughts on this pull request.
-
-  *  acme provides cmake and a wrapper for it. Please use &#39;$(TARGET)-cmake&#39; instead of cmake -DCMAKE_TOOLCHAIN_FILE=&#39;$(CMAKE_TOOLCHAIN_FILE)&#39; -DCMAKE_BUILD_TYPE=Release.</div>
-<div class="email-fragment">Okay -- I&#39;m afraid I just blindly copied the eigen3.mk file, since that&#39;s a library I&#39;m familiar with :-)</div>
-<div class="email-quoted-reply">  *  Do you need -DCMAKE_SYSTEM_PROCESSOR=x86?</div>
-<div class="email-fragment">Yes, this is a bit dumb, but vc checks for that (or amd) to determine that it&#39;s not being built on ARM.</div>
-<span class="email-hidden-toggle"><a href="#">&hellip;</a></span><div class="email-hidden-reply" style="display:none"><div class="email-signature-reply">--
-Boaty McBoatface | http:&#47;&#47;example.org</div>
-</div>
-EXPECTED
+    expected = <<~EXPECTED
+            <div class="email-quoted-reply"> Thank you! I have some thoughts on this pull request.
+      #{'      '}
+              *  acme provides cmake and a wrapper for it. Please use &#39;$(TARGET)-cmake&#39; instead of cmake -DCMAKE_TOOLCHAIN_FILE=&#39;$(CMAKE_TOOLCHAIN_FILE)&#39; -DCMAKE_BUILD_TYPE=Release.</div>
+            <div class="email-fragment">Okay -- I&#39;m afraid I just blindly copied the eigen3.mk file, since that&#39;s a library I&#39;m familiar with :-)</div>
+            <div class="email-quoted-reply">  *  Do you need -DCMAKE_SYSTEM_PROCESSOR=x86?</div>
+            <div class="email-fragment">Yes, this is a bit dumb, but vc checks for that (or amd) to determine that it&#39;s not being built on ARM.</div>
+            <span class="email-hidden-toggle"><a href="#">&hellip;</a></span><div class="email-hidden-reply" style="display:none"><div class="email-signature-reply">--
+            Boaty McBoatface | http:&#47;&#47;example.org</div>
+            </div>
+    EXPECTED
 
     assert_equal(expected.chomp, doc)
   end
diff --git a/test/html/pipeline/emoji_filter_test.rb b/test/html/pipeline/emoji_filter_test.rb
index 55403871..cacd1ef7 100644
--- a/test/html/pipeline/emoji_filter_test.rb
+++ b/test/html/pipeline/emoji_filter_test.rb
@@ -21,7 +21,7 @@ def test_required_context_validation
     exception = assert_raises(ArgumentError) do
       EmojiFilter.call('', {})
     end
-    assert_match /:asset_root/, exception.message
+    assert_match(/:asset_root/, exception.message)
   end
 
   def test_custom_asset_path
diff --git a/test/html/pipeline/https_filter_test.rb b/test/html/pipeline/https_filter_test.rb
index 12ec9b3e..7bae175a 100644
--- a/test/html/pipeline/https_filter_test.rb
+++ b/test/html/pipeline/https_filter_test.rb
@@ -5,7 +5,7 @@
 HttpsFilter = HTML::Pipeline::HttpsFilter
 
 class HTML::Pipeline::AutolinkFilterTest < Minitest::Test
-  def filter(html)
+  def test_filter(html)
     HttpsFilter.to_html(html, @options)
   end
 
diff --git a/test/html/pipeline/image_filter_test.rb b/test/html/pipeline/image_filter_test.rb
index efb6e2cd..7f29c01f 100644
--- a/test/html/pipeline/image_filter_test.rb
+++ b/test/html/pipeline/image_filter_test.rb
@@ -5,7 +5,7 @@
 ImageFilter = HTML::Pipeline::ImageFilter
 
 class HTML::Pipeline::ImageFilterTest < Minitest::Test
-  def filter(html)
+  def test_filter(html)
     ImageFilter.to_html(html)
   end
 
diff --git a/test/html/pipeline/image_max_width_filter_test.rb b/test/html/pipeline/image_max_width_filter_test.rb
index ec2d34e8..5abe567a 100644
--- a/test/html/pipeline/image_max_width_filter_test.rb
+++ b/test/html/pipeline/image_max_width_filter_test.rb
@@ -3,7 +3,7 @@
 require 'test_helper'
 
 class HTML::Pipeline::ImageMaxWidthFilterTest < Minitest::Test
-  def filter(html)
+  def test_filter(html)
     HTML::Pipeline::ImageMaxWidthFilter.call(html)
   end
 
diff --git a/test/html/pipeline/markdown_filter_test.rb b/test/html/pipeline/markdown_filter_test.rb
index 14267b7e..9e7cc3c3 100644
--- a/test/html/pipeline/markdown_filter_test.rb
+++ b/test/html/pipeline/markdown_filter_test.rb
@@ -30,13 +30,13 @@ def setup
       'end' \
       '```'
     @header = <<~DOC
-    # Words
+      # Words
 
-    Some words
+      Some words
 
-    ## Words
+      ## Words
 
-    More words?
+      More words?
     DOC
   end
 
@@ -93,12 +93,12 @@ def test_bogus_renderer
   def test_legitimate_renderer
     results = MarkdownFilter.new(@header, commonmarker_renderer: CustomRenderer).call
     expected = <<~DOC
-    {level: 1, text: Words}
-    <h1>Words</h1>
-    <p>Some words</p>
-    {level: 2, text: Words}
-    <h2>Words</h2>
-    <p>More words?</p>
+      {level: 1, text: Words}
+      <h1>Words</h1>
+      <p>Some words</p>
+      {level: 2, text: Words}
+      <h2>Words</h2>
+      <p>More words?</p>
     DOC
 
     assert_equal results, expected.chomp
@@ -127,7 +127,7 @@ def test_unsafe_custom_renderer_fenced_code_blocks_with_language
 end
 
 class GFMTest < Minitest::Test
-  def gfm(text)
+  def test_gfm(text)
     MarkdownFilter.call(text, gfm: true, unsafe: true)
   end
 
diff --git a/test/html/pipeline/mention_filter_test.rb b/test/html/pipeline/mention_filter_test.rb
index e674f23c..35e6613d 100644
--- a/test/html/pipeline/mention_filter_test.rb
+++ b/test/html/pipeline/mention_filter_test.rb
@@ -3,7 +3,7 @@
 require 'test_helper'
 
 class HTML::Pipeline::MentionFilterTest < Minitest::Test
-  def filter(html, base_url = '/', info_url = nil, username_pattern = nil)
+  def test_filter(html, base_url = '/', info_url = nil, username_pattern = nil)
     HTML::Pipeline::MentionFilter.call(html, base_url: base_url, info_url: info_url, username_pattern: username_pattern)
   end
 
@@ -101,7 +101,7 @@ def test_base_url_slash_with_tilde
       HTML::Pipeline::MentionFilter
     ]
 
-  def mentioned_usernames
+  def test_mentioned_usernames
     result = {}
     MarkdownPipeline.call(@body, {}, result)
     result[:mentioned_usernames]
diff --git a/test/html/pipeline/sanitization_filter_test.rb b/test/html/pipeline/sanitization_filter_test.rb
index 52d35ea2..a7059212 100644
--- a/test/html/pipeline/sanitization_filter_test.rb
+++ b/test/html/pipeline/sanitization_filter_test.rb
@@ -8,27 +8,27 @@ class HTML::Pipeline::SanitizationFilterTest < Minitest::Test
   def test_removing_script_tags
     orig = %(<p><img src="http://github.com/img.png" /><script></script></p>)
     html = SanitizationFilter.call(orig).to_s
-    refute_match /script/, html
+    refute_match(/script/, html)
   end
 
   def test_removing_style_tags
     orig = %(<p><style>hey now</style></p>)
     html = SanitizationFilter.call(orig).to_s
-    refute_match /style/, html
+    refute_match(/style/, html)
   end
 
   def test_removing_style_attributes
     orig = %(<p style='font-size:1000%'>YO DAWG</p>)
     html = SanitizationFilter.call(orig).to_s
-    refute_match /font-size/, html
-    refute_match /style/, html
+    refute_match(/font-size/, html)
+    refute_match(/style/, html)
   end
 
   def test_removing_script_event_handler_attributes
     orig = %(<a onclick='javascript:alert(0)'>YO DAWG</a>)
     html = SanitizationFilter.call(orig).to_s
-    refute_match /javscript/, html
-    refute_match /onclick/, html
+    refute_match(/javscript/, html)
+    refute_match(/onclick/, html)
   end
 
   def test_sanitizes_li_elements_not_contained_in_ul_or_ol
@@ -104,7 +104,7 @@ def test_uses_anchor_schemes_from_allowlist_when_not_separately_specified
   end
 
   def test_allowlist_contains_default_anchor_schemes
-    assert_equal SanitizationFilter::ALLOWLIST[:protocols]['a']['href'], ['http', 'https', 'mailto', 'xmpp', :relative, 'github-windows', 'github-mac', 'irc', 'ircs']
+    assert_equal(['http', 'https', 'mailto', 'xmpp', :relative, 'github-windows', 'github-mac', 'irc', 'ircs'], SanitizationFilter::ALLOWLIST[:protocols]['a']['href'])
   end
 
   def test_allowlist_from_full_constant
@@ -115,7 +115,7 @@ def test_allowlist_from_full_constant
   end
 
   def test_exports_default_anchor_schemes
-    assert_equal SanitizationFilter::ANCHOR_SCHEMES, ['http', 'https', 'mailto', 'xmpp', :relative, 'github-windows', 'github-mac', 'irc', 'ircs']
+    assert_equal(['http', 'https', 'mailto', 'xmpp', :relative, 'github-windows', 'github-mac', 'irc', 'ircs'], SanitizationFilter::ANCHOR_SCHEMES)
   end
 
   def test_script_contents_are_removed
@@ -175,7 +175,7 @@ def test_deprecated_whitelist_context
 
   def test_deprecation_warning_whitelist
     orig = %(<p><style>hey now</style></p>)
-    _stdout, stderror  = capture_io do
+    _stdout, stderror = capture_io do
       SanitizationFilter.new(orig).whitelist
     end
     assert_match "[DEPRECATION] 'whitelist' is deprecated. Please use 'allowlist' instead.", stderror
diff --git a/test/html/pipeline/syntax_highlight_filter_test.rb b/test/html/pipeline/syntax_highlight_filter_test.rb
index 46973604..2f91b7a1 100644
--- a/test/html/pipeline/syntax_highlight_filter_test.rb
+++ b/test/html/pipeline/syntax_highlight_filter_test.rb
@@ -11,8 +11,8 @@ def test_highlight_default
       '<pre>hello</pre>', highlight: 'coffeescript'
 
     doc = filter.call
-    assert !doc.css('.highlight').empty?
-    assert !doc.css('.highlight-coffeescript').empty?
+    refute_empty doc.css('.highlight')
+    refute_empty doc.css('.highlight-coffeescript')
   end
 
   def test_highlight_default_will_not_override
@@ -20,8 +20,8 @@ def test_highlight_default_will_not_override
       "<pre lang='c'>hello</pre>", highlight: 'coffeescript'
 
     doc = filter.call
-    assert doc.css('.highlight-coffeescript').empty?
-    assert !doc.css('.highlight-c').empty?
+    assert_empty doc.css('.highlight-coffeescript')
+    refute_empty doc.css('.highlight-c')
   end
 
   def test_highlight_does_not_remove_pre_tag
@@ -30,7 +30,7 @@ def test_highlight_does_not_remove_pre_tag
 
     doc = filter.call
 
-    assert !doc.css('pre').empty?
+    refute_empty doc.css('pre')
   end
 
   def test_highlight_allows_optional_scope
@@ -39,7 +39,7 @@ def test_highlight_allows_optional_scope
 
     doc = filter.call
 
-    assert !doc.css('pre.test-scope').empty?
+    refute_empty doc.css('pre.test-scope')
   end
 
   def test_highlight_keeps_the_pre_tags_lang
@@ -48,7 +48,7 @@ def test_highlight_keeps_the_pre_tags_lang
 
     doc = filter.call
 
-    assert !doc.css('pre[lang=c]').empty?
+    refute_empty doc.css('pre[lang=c]')
   end
 
   def test_highlight_handles_nested_pre_tags
diff --git a/test/html/pipeline/team_mention_filter_test.rb b/test/html/pipeline/team_mention_filter_test.rb
index 127c2c19..fa30557e 100644
--- a/test/html/pipeline/team_mention_filter_test.rb
+++ b/test/html/pipeline/team_mention_filter_test.rb
@@ -3,7 +3,7 @@
 require 'test_helper'
 
 class HTML::Pipeline::TeamMentionFilterTest < Minitest::Test
-  def filter(html, base_url = '/', team_pattern = nil)
+  def test_filter(html, base_url = '/', team_pattern = nil)
     HTML::Pipeline::TeamMentionFilter.call(html, base_url: base_url, team_pattern: team_pattern)
   end
 
@@ -78,7 +78,7 @@ def test_base_url_under_custom_route
     body = '<p>Hi, @org/team!</p>'
     link = '<a href="www.github.com/org/team" class="team-mention">@org/team</a>'
     assert_equal "<p>Hi, #{link}!</p>",
-      filter(body, 'www.github.com').to_html
+                 filter(body, 'www.github.com').to_html
   end
 
   def test_base_url_slash_with_tilde
@@ -102,7 +102,7 @@ def test_multiple_team_mentions
       HTML::Pipeline::TeamMentionFilter
     ]
 
-  def mentioned_teams
+  def test_mentioned_teams
     result = {}
     MarkdownPipeline.call(@body, {}, result)
     result[:mentioned_teams]
@@ -187,7 +187,7 @@ def test_team_pattern_can_be_customized
     body = '<p>@_abc/XYZ: test</p>'
     doc  = Nokogiri::HTML::DocumentFragment.parse(body)
 
-    res  = filter(doc, '/', /@(_[a-z]{3})\/([A-Z]{3})/)
+    res  = filter(doc, '/', %r{@(_[a-z]{3})/([A-Z]{3})})
 
     link = '<a href="/_abc/XYZ" class="team-mention">@_abc/XYZ</a>'
     assert_equal "<p>#{link}: test</p>",
diff --git a/test/html/pipeline/toc_filter_test.rb b/test/html/pipeline/toc_filter_test.rb
index b79ea238..5a6a13ec 100644
--- a/test/html/pipeline/toc_filter_test.rb
+++ b/test/html/pipeline/toc_filter_test.rb
@@ -10,7 +10,7 @@ class HTML::Pipeline::TableOfContentsFilterTest < Minitest::Test
       HTML::Pipeline::TableOfContentsFilter
     ]
 
-  def toc
+  def test_toc
     result = {}
     TocPipeline.call(@orig, {}, result)
     result[:toc]
diff --git a/test/html/pipeline_test.rb b/test/html/pipeline_test.rb
index 28be8bbb..1209bbdb 100644
--- a/test/html/pipeline_test.rb
+++ b/test/html/pipeline_test.rb
@@ -70,7 +70,7 @@ def test_setup_instrumentation
     assert_equal body.reverse, payload[:result][:output]
   end
 
-  def filter(input)
+  def test_filter(input)
     @pipeline.call(input)
   end
 end
diff --git a/test/test_helper.rb b/test/test_helper.rb
index 530e272d..0012e181 100644
--- a/test/test_helper.rb
+++ b/test/test_helper.rb
@@ -15,4 +15,4 @@ def assert_equal_html(expected, actual)
   end
 end
 
-Minitest::Test.send(:include, TestHelpers)
+Minitest::Test.include TestHelpers

From 76e27310f57358ed543c784699064dd6d96a35b5 Mon Sep 17 00:00:00 2001
From: Igor Victor <gogainda@yandex.ru>
Date: Fri, 8 Jan 2021 11:51:24 +0100
Subject: [PATCH 14/64] add truffleruby-head

---
 .github/workflows/ci.yml | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index a8d3b334..bbb0c2fc 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -19,6 +19,7 @@ jobs:
           - 2.7.2
           - 2.6.6
           - 2.5.8
+          - truffleruby-head
         experimental: [false]
         include:
           - ruby-version: head
@@ -28,14 +29,12 @@ jobs:
 
     steps:
       - uses: actions/checkout@v2
+      - run: sudo apt-get -yqq install libxml2-dev libxslt-dev
+        if: startsWith(matrix.ruby-version, 'truffleruby')
       - name: Set up Ruby ${{ matrix.ruby-version }}
         uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby-version }}
           bundler-cache: true
-      - name: Install dependencies
-        run: |
-          bundle config set --local path '../../vendor/bundle'
-          bundle install
       - name: Run tests
         run: bundle exec rake

From 89c48dc58d8ce14d136f8f4f30e2ad36144b6c35 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 8 Jan 2021 10:28:24 +0000
Subject: [PATCH 15/64] Drop CamoFilter, TextileFilter, EmailReplyFilter

---
 Gemfile                                       |   1 -
 README.md                                     |   7 --
 lib/html/pipeline/camo_filter.rb              | 105 -----------------
 lib/html/pipeline/email_reply_filter.rb       |  68 -----------
 lib/html/pipeline/textile_filter.rb           |  25 -----
 test/html/pipeline/camo_filter_test.rb        | 106 ------------------
 test/html/pipeline/email_reply_filter_test.rb |  68 -----------
 7 files changed, 380 deletions(-)
 delete mode 100644 lib/html/pipeline/camo_filter.rb
 delete mode 100644 lib/html/pipeline/email_reply_filter.rb
 delete mode 100644 lib/html/pipeline/textile_filter.rb
 delete mode 100644 test/html/pipeline/camo_filter_test.rb
 delete mode 100644 test/html/pipeline/email_reply_filter_test.rb

diff --git a/Gemfile b/Gemfile
index d4890b59..310f90b0 100644
--- a/Gemfile
+++ b/Gemfile
@@ -23,7 +23,6 @@ group :test do
   gem 'email_reply_parser', '~> 0.5', require: false
   gem 'gemoji', '~> 2.0', require: false
   gem 'minitest'
-  gem 'RedCloth',           '~> 4.3', require: false
   gem 'rinku',              '~> 1.7', require: false
   gem 'sanitize',           '~> 5.2', require: false
 
diff --git a/README.md b/README.md
index e852842b..e2df0455 100644
--- a/README.md
+++ b/README.md
@@ -113,7 +113,6 @@ context = {
 SimplePipeline = Pipeline.new [
   SanitizationFilter,
   TableOfContentsFilter, # add 'name' anchors to all headers and generate toc list
-  CamoFilter,
   ImageMaxWidthFilter,
   SyntaxHighlightFilter,
   EmojiFilter,
@@ -124,7 +123,6 @@ SimplePipeline = Pipeline.new [
 MarkdownPipeline = Pipeline.new [
   MarkdownFilter,
   SanitizationFilter,
-  CamoFilter,
   ImageMaxWidthFilter,
   HttpsFilter,
   MentionFilter,
@@ -157,8 +155,6 @@ EmojiPipeline = Pipeline.new [
 * `TeamMentionFilter` - replace `@org/team` mentions with links
 * `AbsoluteSourceFilter` - replace relative image urls with fully qualified versions
 * `AutolinkFilter` - auto_linking urls in HTML
-* `CamoFilter` - replace http image urls with [camo-fied](https://github.com/atmos/camo) https versions
-* `EmailReplyFilter` - util filter for working with emails
 * `EmojiFilter` - everyone loves [emoji](http://www.emoji-cheat-sheet.com/)!
 * `HttpsFilter` - HTML Filter for replacing http github urls with https versions.
 * `ImageMaxWidthFilter` - link to full size image for large images
@@ -166,7 +162,6 @@ EmojiPipeline = Pipeline.new [
 * `PlainTextInputFilter` - html escape text and wrap the result in a div
 * `SanitizationFilter` - allow sanitize user markup
 * `SyntaxHighlightFilter` - code syntax highlighter
-* `TextileFilter` - convert textile to html
 * `TableOfContentsFilter` - anchor headings with name attributes and generate Table of Contents html unordered list linking headings
 
 ## Dependencies
@@ -182,14 +177,12 @@ gem 'rouge'
 ```
 
 * `AutolinkFilter` - `rinku`
-* `EmailReplyFilter` - `escape_utils`, `email_reply_parser`
 * `EmojiFilter` - `gemoji`
 * `MarkdownFilter` - `commonmarker`
 * `PlainTextInputFilter` - `escape_utils`
 * `SanitizationFilter` - `sanitize`
 * `SyntaxHighlightFilter` - `rouge`
 * `TableOfContentsFilter` - `escape_utils`
-* `TextileFilter` - `RedCloth`
 
 _Note:_ See [Gemfile](/Gemfile) `:test` block for version requirements.
 
diff --git a/lib/html/pipeline/camo_filter.rb b/lib/html/pipeline/camo_filter.rb
deleted file mode 100644
index 6a2fda5a..00000000
--- a/lib/html/pipeline/camo_filter.rb
+++ /dev/null
@@ -1,105 +0,0 @@
-# frozen_string_literal: true
-
-require 'openssl'
-require 'uri'
-
-module HTML
-  class Pipeline
-    # HTML Filter for replacing http image URLs with camo versions. See:
-    #
-    # https://github.com/atmos/camo
-    #
-    # All images provided in user content should be run through this
-    # filter so that http image sources do not cause mixed-content warnings
-    # in browser clients.
-    #
-    # Context options:
-    #   :asset_proxy (required) - Base URL for constructed asset proxy URLs.
-    #   :asset_proxy_secret_key (required) - The shared secret used to encode URLs.
-    #   :asset_proxy_allowlist - Array of host Strings or Regexps to skip
-    #                            src rewriting.
-    #
-    # This filter does not write additional information to the context.
-    class CamoFilter < Filter
-      # Hijacks images in the markup provided, replacing them with URLs that
-      # go through the github asset proxy.
-      def call
-        return doc unless asset_proxy_enabled?
-
-        doc.search('img').each do |element|
-          original_src = element['src']
-          next unless original_src
-
-          begin
-            uri = URI.parse(original_src)
-          rescue Exception
-            next
-          end
-
-          next if uri.host.nil?
-          next if asset_host_allowed?(uri.host)
-
-          element['src'] = asset_proxy_url(original_src)
-          element['data-canonical-src'] = original_src
-        end
-        doc
-      end
-
-      # Implementation of validate hook.
-      # Errors should raise exceptions or use an existing validator.
-      def validate
-        needs :asset_proxy, :asset_proxy_secret_key
-      end
-
-      # The camouflaged URL for a given image URL.
-      def asset_proxy_url(url)
-        "#{asset_proxy_host}/#{asset_url_hash(url)}/#{hexencode(url)}"
-      end
-
-      # Private: calculate the HMAC digest for a image source URL.
-      def asset_url_hash(url)
-        OpenSSL::HMAC.hexdigest('sha1', asset_proxy_secret_key, url)
-      end
-
-      # Private: Return true if asset proxy filter should be enabled
-      def asset_proxy_enabled?
-        !context[:disable_asset_proxy]
-      end
-
-      # Private: the host to use for generated asset proxied URLs.
-      def asset_proxy_host
-        context[:asset_proxy]
-      end
-
-      def asset_proxy_secret_key
-        context[:asset_proxy_secret_key]
-      end
-
-      def asset_proxy_whitelist
-        warn "[DEPRECATION] 'asset_proxy_whitelist' is deprecated. Please use 'asset_proxy_allowlist' instead."
-        asset_proxy_allowlist
-      end
-
-      def asset_proxy_allowlist
-        context[:asset_proxy_allowlist] || context[:asset_proxy_whitelist] || []
-      end
-
-      def asset_host_whitelisted?(host)
-        warn "[DEPRECATION] 'asset_host_whitelisted?' is deprecated. Please use 'asset_host_allowed?' instead."
-        asset_host_allowed?(host)
-      end
-
-      def asset_host_allowed?(host)
-        asset_proxy_allowlist.any? do |test|
-          test.is_a?(String) ? host == test : test.match(host)
-        end
-      end
-
-      # Private: helper to hexencode a string. Each byte ends up encoded into
-      # two characters, zero padded value in the range [0-9a-f].
-      def hexencode(str)
-        str.unpack1('H*')
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/email_reply_filter.rb b/lib/html/pipeline/email_reply_filter.rb
deleted file mode 100644
index 3af74d41..00000000
--- a/lib/html/pipeline/email_reply_filter.rb
+++ /dev/null
@@ -1,68 +0,0 @@
-# frozen_string_literal: true
-
-HTML::Pipeline.require_dependency('escape_utils', 'EmailReplyFilter')
-HTML::Pipeline.require_dependency('email_reply_parser', 'EmailReplyFilter')
-
-module HTML
-  class Pipeline
-    # HTML Filter that converts email reply text into an HTML DocumentFragment.
-    # It must be used as the first filter in a pipeline.
-    #
-    # Context options:
-    #   None
-    #
-    # This filter does not write any additional information to the context hash.
-    class EmailReplyFilter < TextFilter
-      include EscapeUtils
-
-      EMAIL_HIDDEN_HEADER    = %(<span class="email-hidden-toggle"><a href="#">&hellip;</a></span><div class="email-hidden-reply" style="display:none">)
-      EMAIL_QUOTED_HEADER    = %(<div class="email-quoted-reply">)
-      EMAIL_SIGNATURE_HEADER = %(<div class="email-signature-reply">)
-      EMAIL_FRAGMENT_HEADER  = %(<div class="email-fragment">)
-      EMAIL_HEADER_END       = '</div>'
-      EMAIL_REGEX            = /[^@\s.][^@\s]*@\[?[a-z0-9.-]+\]?/.freeze
-      HIDDEN_EMAIL_PATTERN   = '***@***.***'
-
-      # Scans an email body to determine which bits are quoted and which should
-      # be hidden. EmailReplyParser is used to split the comment into an Array
-      # of quoted or unquoted Blocks. Now, we loop through them and attempt to
-      # add <div> tags around them so we can hide the hidden blocks, and style
-      # the quoted blocks differently. Since multiple blocks may be hidden, be
-      # sure to keep the "email-hidden-reply" <div>s around "email-quoted-reply"
-      # <div> tags. Call this on each comment of a visible thread in the order
-      # that they are displayed. Note: all comments are processed so we can
-      # maintain a Set of SHAs of paragraphs. Only plaintext comments skip the
-      # markdown step.
-      #
-      # Returns the email comment HTML as a String
-      def call
-        found_hidden = nil
-        paragraphs = EmailReplyParser.read(text.dup).fragments.map do |fragment|
-          pieces = [escape_html(fragment.to_s.strip).gsub(/^\s*(>|&gt;)/, '')]
-          if fragment.quoted?
-            if context[:hide_quoted_email_addresses]
-              pieces.map! do |piece|
-                piece.gsub(EMAIL_REGEX, HIDDEN_EMAIL_PATTERN)
-              end
-            end
-            pieces.unshift EMAIL_QUOTED_HEADER
-            pieces << EMAIL_HEADER_END
-          elsif fragment.signature?
-            pieces.unshift EMAIL_SIGNATURE_HEADER
-            pieces << EMAIL_HEADER_END
-          else
-            pieces.unshift EMAIL_FRAGMENT_HEADER
-            pieces << EMAIL_HEADER_END
-          end
-          if fragment.hidden? && !found_hidden
-            found_hidden = true
-            pieces.unshift EMAIL_HIDDEN_HEADER
-          end
-          pieces.join
-        end
-        paragraphs << EMAIL_HEADER_END if found_hidden
-        paragraphs.join("\n")
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/textile_filter.rb b/lib/html/pipeline/textile_filter.rb
deleted file mode 100644
index 5b8fcd1d..00000000
--- a/lib/html/pipeline/textile_filter.rb
+++ /dev/null
@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-HTML::Pipeline.require_dependency('redcloth', 'RedCloth')
-
-module HTML
-  class Pipeline
-    # HTML Filter that converts Textile text into HTML and converts into a
-    # DocumentFragment. This is different from most filters in that it can take a
-    # non-HTML as input. It must be used as the first filter in a pipeline.
-    #
-    # Context options:
-    #   :autolink => false    Disable autolinking URLs
-    #
-    # This filter does not write any additional information to the context hash.
-    #
-    # NOTE This filter is provided for really old comments only. It probably
-    # shouldn't be used for anything new.
-    class TextileFilter < TextFilter
-      # Convert Textile to HTML and convert into a DocumentFragment.
-      def call
-        RedCloth.new(@text).to_html
-      end
-    end
-  end
-end
diff --git a/test/html/pipeline/camo_filter_test.rb b/test/html/pipeline/camo_filter_test.rb
deleted file mode 100644
index 57aada68..00000000
--- a/test/html/pipeline/camo_filter_test.rb
+++ /dev/null
@@ -1,106 +0,0 @@
-# frozen_string_literal: true
-
-require 'test_helper'
-
-class HTML::Pipeline::CamoFilterTest < Minitest::Test
-  CamoFilter = HTML::Pipeline::CamoFilter
-
-  def setup
-    @asset_proxy_url        = 'https//assets.example.org'
-    @asset_proxy_secret_key = 'ssssh-secret'
-    @options = {
-      asset_proxy: @asset_proxy_url,
-      asset_proxy_secret_key: @asset_proxy_secret_key,
-      asset_proxy_allowlist: [/(^|\.)github\.com$/]
-    }
-  end
-
-  def test_asset_proxy_disabled
-    orig = %(<p><img src="http://twitter.com/img.png"></p>)
-    assert_equal orig,
-                 CamoFilter.call(orig, @options.merge(disable_asset_proxy: true)).to_s
-  end
-
-  def test_camouflaging_http_image_urls
-    orig = %(<p><img src="http://twitter.com/img.png"></p>)
-    assert_equal %(<p><img src="https//assets.example.org/a5ad43494e343b20d745586282be61ff530e6fa0/687474703a2f2f747769747465722e636f6d2f696d672e706e67" data-canonical-src="http://twitter.com/img.png"></p>),
-                 CamoFilter.call(orig, @options).to_s
-  end
-
-  def test_doesnt_rewrite_dotcom_image_urls
-    orig = %(<p><img src="https://github.com/img.png"></p>)
-    assert_equal orig, CamoFilter.call(orig, @options).to_s
-  end
-
-  def test_doesnt_rewrite_dotcom_subdomain_image_urls
-    orig = %(<p><img src="https://raw.github.com/img.png"></p>)
-    assert_equal orig, CamoFilter.call(orig, @options).to_s
-  end
-
-  def test_doesnt_rewrite_dotcom_subsubdomain_image_urls
-    orig = %(<p><img src="https://f.assets.github.com/img.png"></p>)
-    assert_equal orig, CamoFilter.call(orig, @options).to_s
-  end
-
-  def test_camouflaging_github_prefixed_image_urls
-    orig = %(<p><img src="https://notgithub.com/img.png"></p>)
-    assert_equal %(<p><img src="https//assets.example.org/5d4a96c69713f850520538e04cb9661035cfb534/68747470733a2f2f6e6f746769746875622e636f6d2f696d672e706e67" data-canonical-src="https://notgithub.com/img.png"></p>),
-                 CamoFilter.call(orig, @options).to_s
-  end
-
-  def test_doesnt_rewrite_absolute_image_urls
-    orig = %(<p><img src="/img.png"></p>)
-    assert_equal orig, CamoFilter.call(orig, @options).to_s
-  end
-
-  def test_doesnt_rewrite_relative_image_urls
-    orig = %(<p><img src="img.png"></p>)
-    assert_equal orig, CamoFilter.call(orig, @options).to_s
-  end
-
-  def test_camouflaging_https_image_urls
-    orig = %(<p><img src="https://foo.com/img.png"></p>)
-    assert_equal %(<p><img src="https//assets.example.org/3c5c6dc74fd6592d2596209dfcb8b7e5461383c8/68747470733a2f2f666f6f2e636f6d2f696d672e706e67" data-canonical-src="https://foo.com/img.png"></p>),
-                 CamoFilter.call(orig, @options).to_s
-  end
-
-  def test_handling_images_with_no_src_attribute
-    orig = %(<p><img></p>)
-    assert_equal orig, CamoFilter.call(orig, @options).to_s
-  end
-
-  def test_required_context_validation
-    exception = assert_raises(ArgumentError) do
-      CamoFilter.call('', {})
-    end
-    assert_match(/:asset_proxy[^_]/, exception.message)
-    assert_match(/:asset_proxy_secret_key/, exception.message)
-  end
-
-  def test_deprecated_asset_proxy_whitelist_context
-    orig = %(<p><img></p>)
-    deprecated_options = {
-      asset_proxy: @asset_proxy_url,
-      asset_proxy_secret_key: @asset_proxy_secret_key,
-      asset_proxy_whitelist: [/(^|\.)github\.com$/]
-    }
-    assert_equal [/(^|\.)github\.com$/], CamoFilter.new(orig, deprecated_options).asset_proxy_allowlist
-  end
-
-  def test_deprecation_warning_asset_proxy_whitelist
-    orig = %(<p><img></p>)
-    _stdout, stderror = capture_io do
-      CamoFilter.new(orig, @options).asset_proxy_whitelist
-    end
-    assert_match "[DEPRECATION] 'asset_proxy_whitelist' is deprecated. Please use 'asset_proxy_allowlist' instead.", stderror
-  end
-
-  def test_deprecation_warning_asset_host_whitelisted
-    orig = %(<p><img></p>)
-    host = 'https://facebook.com'
-    _stdout, stderror = capture_io do
-      CamoFilter.new(orig, @options).asset_host_whitelisted?(host)
-    end
-    assert_match "[DEPRECATION] 'asset_host_whitelisted?' is deprecated. Please use 'asset_host_allowed?' instead.", stderror
-  end
-end
diff --git a/test/html/pipeline/email_reply_filter_test.rb b/test/html/pipeline/email_reply_filter_test.rb
deleted file mode 100644
index 0868d52b..00000000
--- a/test/html/pipeline/email_reply_filter_test.rb
+++ /dev/null
@@ -1,68 +0,0 @@
-# frozen_string_literal: true
-
-require 'test_helper'
-
-EmailReplyFilter = HTML::Pipeline::EmailReplyFilter
-
-class HTML::Pipeline::EmailReplyFilterTest < Minitest::Test
-  def setup
-    @body = <<~EMAIL
-            Hey, don't send email addresses in comments. They aren't filtered.
-      #{'      '}
-            > On Mar 5, 2016, at 08:05, Boaty McBoatface <boatymcboatface@example.com> wrote:
-            >
-            > Sup. alreadyleaked@example.com
-            >
-            > —
-            > Reply to this email directly or view it on GitHub.
-    EMAIL
-  end
-
-  def test_doesnt_hide_by_default
-    filter = EmailReplyFilter.new(@body)
-    doc = filter.call.to_s
-    assert_match(/alreadyleaked@example.com/, doc)
-    assert_match(/boatymcboatface@example.com/, doc)
-  end
-
-  def test_hides_email_addresses_when_configured
-    filter = EmailReplyFilter.new(@body, hide_quoted_email_addresses: true)
-    doc = filter.call.to_s
-    refute_match(/boatymcboatface@example.com/, doc)
-    refute_match(/alreadyleaked@example.com/, doc)
-  end
-
-  def test_preserves_non_email_content_while_filtering
-    str = <<~EMAIL
-            > Thank you! I have some thoughts on this pull request.
-            >
-            >  *  acme provides cmake and a wrapper for it. Please use '$(TARGET)-cmake' instead of cmake -DCMAKE_TOOLCHAIN_FILE='$(CMAKE_TOOLCHAIN_FILE)' -DCMAKE_BUILD_TYPE=Release.
-      #{'      '}
-            Okay -- I'm afraid I just blindly copied the eigen3.mk file, since that's a library I'm familiar with :-)
-      #{'      '}
-            >  *  Do you need -DCMAKE_SYSTEM_PROCESSOR=x86?
-      #{'      '}
-            Yes, this is a bit dumb, but vc checks for that (or amd) to determine that it's not being built on ARM.
-      #{'      '}
-            --
-            Boaty McBoatface | http://example.org
-    EMAIL
-
-    filter = EmailReplyFilter.new(str, hide_quoted_email_addresses: true)
-    doc = filter.call.to_s
-
-    expected = <<~EXPECTED
-            <div class="email-quoted-reply"> Thank you! I have some thoughts on this pull request.
-      #{'      '}
-              *  acme provides cmake and a wrapper for it. Please use &#39;$(TARGET)-cmake&#39; instead of cmake -DCMAKE_TOOLCHAIN_FILE=&#39;$(CMAKE_TOOLCHAIN_FILE)&#39; -DCMAKE_BUILD_TYPE=Release.</div>
-            <div class="email-fragment">Okay -- I&#39;m afraid I just blindly copied the eigen3.mk file, since that&#39;s a library I&#39;m familiar with :-)</div>
-            <div class="email-quoted-reply">  *  Do you need -DCMAKE_SYSTEM_PROCESSOR=x86?</div>
-            <div class="email-fragment">Yes, this is a bit dumb, but vc checks for that (or amd) to determine that it&#39;s not being built on ARM.</div>
-            <span class="email-hidden-toggle"><a href="#">&hellip;</a></span><div class="email-hidden-reply" style="display:none"><div class="email-signature-reply">--
-            Boaty McBoatface | http:&#47;&#47;example.org</div>
-            </div>
-    EXPECTED
-
-    assert_equal(expected.chomp, doc)
-  end
-end

From 19b35897f25aeb3c31d04e1b89be8248e393fc8f Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 8 Jan 2021 11:58:27 +0000
Subject: [PATCH 16/64] Massive kwargs rewrite

---
 lib/html/pipeline.rb                          |  53 ++-----
 lib/html/pipeline/@mention_filter.rb          |  44 ++----
 lib/html/pipeline/@team_mention_filter.rb     |  14 +-
 lib/html/pipeline/filter.rb                   |  18 +--
 lib/html/pipeline/markdown_filter.rb          |   4 +-
 lib/html/pipeline/text_filter.rb              |   4 +-
 .../pipeline/absolute_source_filter_test.rb   |  14 +-
 test/html/pipeline/autolink_filter_test.rb    |  14 +-
 test/html/pipeline/emoji_filter_test.rb       |  24 +--
 test/html/pipeline/https_filter_test.rb       |  26 ++--
 test/html/pipeline/image_filter_test.rb       |  16 +-
 .../pipeline/image_max_width_filter_test.rb   |  14 +-
 test/html/pipeline/markdown_filter_test.rb    |  43 +++---
 test/html/pipeline/mention_filter_test.rb     | 137 ++++++++----------
 .../html/pipeline/sanitization_filter_test.rb |  12 +-
 .../pipeline/syntax_highlight_filter_test.rb  |  12 +-
 .../html/pipeline/team_mention_filter_test.rb | 116 +++++++--------
 test/html/pipeline/toc_filter_test.rb         |  31 ++--
 test/html/pipeline_test.rb                    |  24 +--
 19 files changed, 281 insertions(+), 339 deletions(-)

diff --git a/lib/html/pipeline.rb b/lib/html/pipeline.rb
index f68fbeac..f416ad42 100644
--- a/lib/html/pipeline.rb
+++ b/lib/html/pipeline.rb
@@ -89,12 +89,12 @@ class << self
       attr_accessor :default_instrumentation_service
     end
 
-    def initialize(filters, default_context = {}, result_class = nil)
+    def initialize(filters, default_context: {}, result_class: Hash)
       raise ArgumentError, 'default_context cannot be nil' if default_context.nil?
 
       @filters = filters.flatten.freeze
       @default_context = default_context.freeze
-      @result_class = result_class || Hash
+      @result_class = result_class
       @instrumentation_service = self.class.default_instrumentation_service
     end
 
@@ -110,16 +110,16 @@ def initialize(filters, default_context = {}, result_class = nil)
     # Returns the result Hash after being filtered by this Pipeline.  Contains an
     # :output key with the DocumentFragment or String HTML markup based on the
     # output of the last filter in the pipeline.
-    def call(html, context = {}, result = nil)
+    def call(html, context: {}, result: {})
       context = @default_context.merge(context)
       context = context.freeze
       result ||= @result_class.new
-      payload = default_payload filters: @filters.map(&:name),
-                                context: context, result: result
+      payload = default_payload ({filters: @filters.map(&:name),
+                                context: context, result: result})
       instrument 'call_pipeline.html_pipeline', payload do
         result[:output] =
           @filters.inject(html) do |doc, filter|
-            perform_filter(filter, doc, context, result)
+            perform_filter(filter, doc, context: context, result: result)
           end
       end
       result
@@ -130,25 +130,25 @@ def call(html, context = {}, result = nil)
     # The filter is instrumented.
     #
     # Returns the result of the filter.
-    def perform_filter(filter, doc, context, result)
-      payload = default_payload filter: filter.name,
-                                context: context, result: result
+    def perform_filter(filter, doc, context: {}, result: {})
+      payload = default_payload({ filter: filter.name,
+                                  context: context, result: result })
       instrument 'call_filter.html_pipeline', payload do
-        filter.call(doc, context, result)
+        filter.call(doc, context: context, result: result)
       end
     end
 
     # Like call but guarantee the value returned is a DocumentFragment.
     # Pipelines may return a DocumentFragment or a String. Callers that need a
     # DocumentFragment should use this method.
-    def to_document(input, context = {}, result = nil)
-      result = call(input, context, result)
+    def to_document(input, context: {}, result: {})
+      result = call(input, context: context, result: result)
       HTML::Pipeline.parse(result[:output])
     end
 
     # Like call but guarantee the value returned is a string of HTML markup.
-    def to_html(input, context = {}, result = nil)
-      result = call(input, context, result = nil)
+    def to_html(input, context: {}, result: {})
+      result = call(input, context: context, result: result)
       output = result[:output]
       if output.respond_to?(:to_html)
         output.to_html
@@ -160,7 +160,7 @@ def to_html(input, context = {}, result = nil)
     # Public: setup instrumentation for this pipeline.
     #
     # Returns nothing.
-    def setup_instrumentation(name = nil, service = nil)
+    def setup_instrumentation(name, service: nil)
       self.instrumentation_name = name
       self.instrumentation_service =
         service || self.class.default_instrumentation_service
@@ -170,7 +170,7 @@ def setup_instrumentation(name = nil, service = nil)
     # block, otherwise the block is ran without instrumentation.
     #
     # Returns the result of the provided block.
-    def instrument(event, payload = nil, &block)
+    def instrument(event, payload = {}, &block)
       payload ||= default_payload
       return yield(payload) unless instrumentation_service
 
@@ -187,24 +187,3 @@ def default_payload(payload = {})
     end
   end
 end
-
-# XXX nokogiri monkey patches for 1.8
-unless ''.respond_to?(:force_encoding)
-  class Nokogiri::XML::Node
-    # Work around an issue with utf-8 encoded data being erroneously converted to
-    # ... some other shit when replacing text nodes. See 'utf-8 output 2' in
-    # user_content_test.rb for details.
-    def replace_with_encoding_fix(replacement)
-      replacement = document.fragment("<div>#{replacement}</div>").children.first.children if replacement.respond_to?(:to_str)
-      replace_without_encoding_fix(replacement)
-    end
-
-    alias replace_without_encoding_fix replace
-    alias replace replace_with_encoding_fix
-
-    def swap(replacement)
-      replace(replacement)
-      self
-    end
-  end
-end
diff --git a/lib/html/pipeline/@mention_filter.rb b/lib/html/pipeline/@mention_filter.rb
index dcbc8144..b46a071c 100644
--- a/lib/html/pipeline/@mention_filter.rb
+++ b/lib/html/pipeline/@mention_filter.rb
@@ -31,15 +31,15 @@ class MentionFilter < Filter
       # the original text.
       #
       # Returns a String replaced with the return of the block.
-      def self.mentioned_logins_in(text, username_pattern = UsernamePattern)
-        text.gsub MentionPatterns[username_pattern] do |match|
+      def self.mentioned_logins_in(text, username_pattern = USERNAME_PATTERN)
+        text.gsub MENTION_PATTERNS[username_pattern] do |match|
           login = Regexp.last_match(1)
-          yield match, login, MentionLogins.include?(login.downcase)
+          yield match, login
         end
       end
 
       # Hash that contains all of the mention patterns used by the pipeline
-      MentionPatterns = Hash.new do |hash, key|
+      MENTION_PATTERNS = Hash.new do |hash, key|
         hash[key] = %r{
           (?:^|\W)                    # beginning of string or non-word char
           @((?>#{key}))  # @username
@@ -55,16 +55,7 @@ def self.mentioned_logins_in(text, username_pattern = UsernamePattern)
 
       # Default pattern used to extract usernames from text. The value can be
       # overriden by providing the username_pattern variable in the context.
-      UsernamePattern = /[a-z0-9][a-z0-9-]*/.freeze
-
-      # List of username logins that, when mentioned, link to the blog post
-      # about @mentions instead of triggering a real mention.
-      MentionLogins = %w[
-        mention
-        mentions
-        mentioned
-        mentioning
-      ].freeze
+      USERNAME_PATTERN = /[a-z0-9][a-z0-9-]*/.freeze
 
       # Don't look for mentions in text nodes that are children of these elements
       IGNORE_PARENTS = %w[pre code a style script].to_set
@@ -77,7 +68,7 @@ def call
           next unless content.include?('@')
           next if has_ancestor?(node, IGNORE_PARENTS)
 
-          html = mention_link_filter(content, base_url, info_url, username_pattern)
+          html = mention_link_filter(content, base_url: base_url, username_pattern: username_pattern)
           next if html == content
 
           node.replace(html)
@@ -92,7 +83,7 @@ def info_url
       end
 
       def username_pattern
-        context[:username_pattern] || UsernamePattern
+        context[:username_pattern] || USERNAME_PATTERN
       end
 
       # Replace user @mentions in text with links to the mentioned user's
@@ -107,28 +98,15 @@ def username_pattern
       #
       # Returns a string with @mentions replaced with links. All links have a
       # 'user-mention' class name attached for styling.
-      def mention_link_filter(text, _base_url = '/', info_url = nil, username_pattern = UsernamePattern)
-        self.class.mentioned_logins_in(text, username_pattern) do |match, login, is_mentioned|
-          link =
-            if is_mentioned
-              link_to_mention_info(login, info_url)
-            else
-              link_to_mentioned_user(login)
-            end
+      def mention_link_filter(text, base_url: '/', username_pattern: USERNAME_PATTERN)
+        self.class.mentioned_logins_in(text, username_pattern) do |match, login|
+          link = link_to_mentioned_user(base_url, login)
 
           link ? match.sub("@#{login}", link) : match
         end
       end
 
-      def link_to_mention_info(text, info_url = nil)
-        return "@#{text}" if info_url.nil?
-
-        "<a href='#{info_url}' class='user-mention'>" \
-          "@#{text}" \
-          '</a>'
-      end
-
-      def link_to_mentioned_user(login)
+      def link_to_mentioned_user(base_url, login)
         result[:mentioned_usernames] |= [login]
 
         url = base_url.dup
diff --git a/lib/html/pipeline/@team_mention_filter.rb b/lib/html/pipeline/@team_mention_filter.rb
index 0529ea82..7dbd73f7 100644
--- a/lib/html/pipeline/@team_mention_filter.rb
+++ b/lib/html/pipeline/@team_mention_filter.rb
@@ -27,7 +27,7 @@ class TeamMentionFilter < Filter
       # return replaces the match in the original text.
       #
       # Returns a String replaced with the return of the block.
-      def self.mentioned_teams_in(text, team_pattern = TeamPattern)
+      def self.mentioned_teams_in(text, team_pattern = TEAM_PATTERN)
         text.gsub team_pattern do |match|
           org = Regexp.last_match(1)
           team = Regexp.last_match(2)
@@ -38,7 +38,7 @@ def self.mentioned_teams_in(text, team_pattern = TeamPattern)
       # Default pattern used to extract team names from text. The value can be
       # overridden by providing the team_pattern variable in the context. To
       # properly link the mention, should be in the format of /@(1)\/(2)/.
-      TeamPattern = %r{
+      TEAM_PATTERN = %r{
         (?<=^|\W)                  # beginning of string or non-word char
         @([a-z0-9][a-z0-9-]*)      # @organization
           /                       # dividing slash
@@ -57,7 +57,7 @@ def call
           next unless content.include?('@')
           next if has_ancestor?(node, IGNORE_PARENTS)
 
-          html = mention_link_filter(content, base_url, team_pattern)
+          html = mention_link_filter(content, base_url: base_url, team_pattern: team_pattern)
           next if html == content
 
           node.replace(html)
@@ -66,7 +66,7 @@ def call
       end
 
       def team_pattern
-        context[:team_pattern] || TeamPattern
+        context[:team_pattern] || TEAM_PATTERN
       end
 
       # Replace @org/team mentions in text with links to the mentioned team's
@@ -78,15 +78,15 @@ def team_pattern
       #
       # Returns a string with @team mentions replaced with links. All links have a
       # 'team-mention' class name attached for styling.
-      def mention_link_filter(text, _base_url = '/', team_pattern = TeamPattern)
+      def mention_link_filter(text, base_url: '/', team_pattern: TEAM_PATTERN)
         self.class.mentioned_teams_in(text, team_pattern) do |match, org, team|
-          link = link_to_mentioned_team(org, team)
+          link = link_to_mentioned_team(base_url, org, team)
 
           link ? match.sub("@#{org}/#{team}", link) : match
         end
       end
 
-      def link_to_mentioned_team(org, team)
+      def link_to_mentioned_team(base_url, org, team)
         result[:mentioned_teams] |= [team]
 
         url = base_url.dup
diff --git a/lib/html/pipeline/filter.rb b/lib/html/pipeline/filter.rb
index edeef17b..ed2fa228 100644
--- a/lib/html/pipeline/filter.rb
+++ b/lib/html/pipeline/filter.rb
@@ -31,7 +31,7 @@ class Pipeline
     class Filter
       class InvalidDocumentException < StandardError; end
 
-      def initialize(doc, context = nil, result = nil)
+      def initialize(doc, context: {}, result: {})
         if doc.is_a?(String)
           @html = doc.to_str
           @doc = nil
@@ -39,8 +39,8 @@ def initialize(doc, context = nil, result = nil)
           @doc = doc
           @html = nil
         end
-        @context = context || {}
-        @result = result || {}
+        @context = context
+        @result = result
         validate
       end
 
@@ -126,20 +126,20 @@ def has_ancestor?(node, tags)
       #
       # Returns a HTML::Pipeline::DocumentFragment or a String containing HTML
       # markup.
-      def self.call(doc, context = nil, result = nil)
-        new(doc, context, result).call
+      def self.call(doc, context: {}, result: {})
+        new(doc, context: context, result: result).call
       end
 
       # Like call but guarantees that a DocumentFragment is returned, even when
       # the last filter returns a String.
-      def self.to_document(input, context = nil)
-        html = call(input, context)
+      def self.to_document(input, context: {})
+        html = call(input, context: context)
         HTML::Pipeline.parse(html)
       end
 
       # Like call but guarantees that a string of HTML markup is returned.
-      def self.to_html(input, context = nil)
-        output = call(input, context)
+      def self.to_html(input, context: {})
+        output = call(input, context: context)
         if output.respond_to?(:to_html)
           output.to_html
         else
diff --git a/lib/html/pipeline/markdown_filter.rb b/lib/html/pipeline/markdown_filter.rb
index a6ae5f75..5f961aca 100644
--- a/lib/html/pipeline/markdown_filter.rb
+++ b/lib/html/pipeline/markdown_filter.rb
@@ -17,8 +17,8 @@ class Pipeline
     class MarkdownFilter < TextFilter
       DEFAULT_COMMONMARKER_EXTENSIONS = %i[table strikethrough tagfilter autolink].freeze
 
-      def initialize(text, context = nil, result = nil)
-        super text, context, result
+      def initialize(text, context: {}, result: {})
+        super text, context: context, result: result
         @text = @text.delete "\r"
       end
 
diff --git a/lib/html/pipeline/text_filter.rb b/lib/html/pipeline/text_filter.rb
index 2609f523..2d5e5f01 100644
--- a/lib/html/pipeline/text_filter.rb
+++ b/lib/html/pipeline/text_filter.rb
@@ -5,12 +5,12 @@ class Pipeline
     class TextFilter < Filter
       attr_reader :text
 
-      def initialize(text, context = nil, result = nil)
+      def initialize(text, context: {}, result: {})
         raise TypeError, 'text cannot be HTML' if text.is_a?(DocumentFragment)
 
         # Ensure that this is always a string
         @text = text.respond_to?(:to_str) ? text.to_str : text.to_s
-        super nil, context, result
+        super nil, context: context, result: result
       end
     end
   end
diff --git a/test/html/pipeline/absolute_source_filter_test.rb b/test/html/pipeline/absolute_source_filter_test.rb
index 917f2417..9ac4a7f9 100644
--- a/test/html/pipeline/absolute_source_filter_test.rb
+++ b/test/html/pipeline/absolute_source_filter_test.rb
@@ -17,39 +17,39 @@ def setup
   def test_rewrites_root_urls
     orig = %(<p><img src="/img.png"></p>)
     assert_equal "<p><img src=\"#{@image_base_url}/img.png\"></p>",
-                 AbsoluteSourceFilter.call(orig, @options).to_s
+                 AbsoluteSourceFilter.call(orig, context: @options).to_s
   end
 
   def test_rewrites_relative_urls
     orig = %(<p><img src="post/img.png"></p>)
     assert_equal "<p><img src=\"#{@image_subpage_url}/img.png\"></p>",
-                 AbsoluteSourceFilter.call(orig, @options).to_s
+                 AbsoluteSourceFilter.call(orig, context: @options).to_s
   end
 
   def test_does_not_rewrite_absolute_urls
     orig = %(<p><img src="http://other.example.com/img.png"></p>)
-    result = AbsoluteSourceFilter.call(orig, @options).to_s
+    result = AbsoluteSourceFilter.call(orig, context: @options).to_s
     refute_match(/@image_base_url/, result)
     refute_match(/@image_subpage_url/, result)
   end
 
   def test_fails_when_context_is_missing
     assert_raises RuntimeError do
-      AbsoluteSourceFilter.call('<img src="img.png">', {})
+      AbsoluteSourceFilter.call('<img src="img.png">', context: {})
     end
     assert_raises RuntimeError do
-      AbsoluteSourceFilter.call('<img src="/img.png">', {})
+      AbsoluteSourceFilter.call('<img src="/img.png">', context: {})
     end
   end
 
   def test_tells_you_where_context_is_required
     exception = assert_raises(RuntimeError) do
-      AbsoluteSourceFilter.call('<img src="img.png">', {})
+      AbsoluteSourceFilter.call('<img src="img.png">', context: {})
     end
     assert_match 'HTML::Pipeline::AbsoluteSourceFilter', exception.message
 
     exception = assert_raises(RuntimeError) do
-      AbsoluteSourceFilter.call('<img src="/img.png">', {})
+      AbsoluteSourceFilter.call('<img src="/img.png">', context: {})
     end
     assert_match 'HTML::Pipeline::AbsoluteSourceFilter', exception.message
   end
diff --git a/test/html/pipeline/autolink_filter_test.rb b/test/html/pipeline/autolink_filter_test.rb
index cc3255fc..086e3bc1 100644
--- a/test/html/pipeline/autolink_filter_test.rb
+++ b/test/html/pipeline/autolink_filter_test.rb
@@ -14,17 +14,17 @@ def test_uses_rinku_for_autolinking
 
   def test_autolink_option
     assert_equal '<p>"http://www.github.com"</p>',
-                 AutolinkFilter.to_html('<p>"http://www.github.com"</p>', autolink: false)
+                 AutolinkFilter.to_html('<p>"http://www.github.com"</p>', context: { autolink: false })
   end
 
   def test_autolink_link_attr
     assert_equal '<p>"<a href="http://www.github.com" target="_blank">http://www.github.com</a>"</p>',
-                 AutolinkFilter.to_html('<p>"http://www.github.com"</p>', link_attr: 'target="_blank"')
+                 AutolinkFilter.to_html('<p>"http://www.github.com"</p>', context: { link_attr: 'target="_blank"' })
   end
 
   def test_autolink_flags
     assert_equal '<p>"<a href="http://github">http://github</a>"</p>',
-                 AutolinkFilter.to_html('<p>"http://github"</p>', flags: Rinku::AUTOLINK_SHORT_DOMAINS)
+                 AutolinkFilter.to_html('<p>"http://github"</p>', context: { flags: Rinku::AUTOLINK_SHORT_DOMAINS })
   end
 
   def test_autolink_skip_tags
@@ -32,7 +32,7 @@ def test_autolink_skip_tags
                  AutolinkFilter.to_html('<code>"http://github.com"</code>')
 
     assert_equal '<code>"<a href="http://github.com">http://github.com</a>"</code>',
-                 AutolinkFilter.to_html('<code>"http://github.com"</code>', skip_tags: %w[kbd script])
+                 AutolinkFilter.to_html('<code>"http://github.com"</code>', context: { skip_tags: %w[kbd script] })
   end
 
   def test_link_mode_default
@@ -42,16 +42,16 @@ def test_link_mode_default
 
   def test_link_mode_urls
     assert_equal '<p>"<a href="http://www.github.com">http://www.github.com</a>"</p><p>"user@example.com"</p>',
-                 AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>', link_mode: :urls)
+                 AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :urls })
   end
 
   def test_link_mode_all
     assert_equal '<p>"<a href="http://www.github.com">http://www.github.com</a>"</p><p>"<a href="mailto:user@example.com">user@example.com</a>"</p>',
-                 AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>', link_mode: :all)
+                 AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :all })
   end
 
   def test_link_mode_email_addresses
     assert_equal '<p>"http://www.github.com"</p><p>"<a href="mailto:user@example.com">user@example.com</a>"</p>',
-                 AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>', link_mode: :email_addresses)
+                 AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :email_addresses })
   end
 end
diff --git a/test/html/pipeline/emoji_filter_test.rb b/test/html/pipeline/emoji_filter_test.rb
index cacd1ef7..d6e86722 100644
--- a/test/html/pipeline/emoji_filter_test.rb
+++ b/test/html/pipeline/emoji_filter_test.rb
@@ -6,13 +6,13 @@ class HTML::Pipeline::EmojiFilterTest < Minitest::Test
   EmojiFilter = HTML::Pipeline::EmojiFilter
 
   def test_emojify
-    filter = EmojiFilter.new('<p>:shipit:</p>', asset_root: 'https://foo.com')
+    filter = EmojiFilter.new('<p>:shipit:</p>', context: { asset_root: 'https://foo.com' })
     doc = filter.call
     assert_match 'https://foo.com/emoji/shipit.png', doc.search('img').attr('src').value
   end
 
   def test_uri_encoding
-    filter = EmojiFilter.new('<p>:+1:</p>', asset_root: 'https://foo.com')
+    filter = EmojiFilter.new('<p>:+1:</p>', context: { asset_root: 'https://foo.com' })
     doc = filter.call
     assert_match 'https://foo.com/emoji/unicode/1f44d.png', doc.search('img').attr('src').value
   end
@@ -25,56 +25,56 @@ def test_required_context_validation
   end
 
   def test_custom_asset_path
-    filter = EmojiFilter.new('<p>:+1:</p>', asset_path: ':file_name', asset_root: 'https://foo.com')
+    filter = EmojiFilter.new('<p>:+1:</p>', context: { asset_path: ':file_name', asset_root: 'https://foo.com' })
     doc = filter.call
     assert_match 'https://foo.com/unicode/1f44d.png', doc.search('img').attr('src').value
   end
 
   def test_not_emojify_in_code_tags
     body = '<code>:shipit:</code>'
-    filter = EmojiFilter.new(body, asset_root: 'https://foo.com')
+    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com' })
     doc = filter.call
     assert_equal body, doc.to_html
   end
 
   def test_not_emojify_in_tt_tags
     body = '<tt>:shipit:</tt>'
-    filter = EmojiFilter.new(body, asset_root: 'https://foo.com')
+    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com' })
     doc = filter.call
     assert_equal body, doc.to_html
   end
 
   def test_not_emojify_in_pre_tags
     body = '<pre>:shipit:</pre>'
-    filter = EmojiFilter.new(body, asset_root: 'https://foo.com')
+    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com' })
     doc = filter.call
     assert_equal body, doc.to_html
   end
 
   def test_not_emojify_in_custom_single_tag_foo
     body = '<foo>:shipit:</foo>'
-    filter = EmojiFilter.new(body, asset_root: 'https://foo.com', ignored_ancestor_tags: %w[foo])
+    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com', ignored_ancestor_tags: %w[foo] })
     doc = filter.call
     assert_equal body, doc.to_html
   end
 
   def test_not_emojify_in_custom_multiple_tags_foo_and_bar
     body = '<bar>:shipit:</bar>'
-    filter = EmojiFilter.new(body, asset_root: 'https://foo.com', ignored_ancestor_tags: %w[foo bar])
+    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com', ignored_ancestor_tags: %w[foo bar] })
     doc = filter.call
     assert_equal body, doc.to_html
   end
 
   def test_img_tag_attributes
     body = ':shipit:'
-    filter = EmojiFilter.new(body, asset_root: 'https://foo.com')
+    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com' })
     doc = filter.call
     assert_equal %(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" height="20" width="20" align="absmiddle">), doc.to_html
   end
 
   def test_img_tag_attributes_can_be_customized
     body = ':shipit:'
-    filter = EmojiFilter.new(body, asset_root: 'https://foo.com', img_attrs: Hash('draggable' => 'false', 'height' => nil, 'width' => nil, 'align' => nil))
+    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com', img_attrs: Hash('draggable' => 'false', 'height' => nil, 'width' => nil, 'align' => nil) })
     doc = filter.call
     assert_equal %(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" draggable="false">), doc.to_html
   end
@@ -82,14 +82,14 @@ def test_img_tag_attributes_can_be_customized
   def test_img_attrs_value_can_accept_proclike_object
     remove_colons = ->(name) { name.delete(':') }
     body = ':shipit:'
-    filter = EmojiFilter.new(body, asset_root: 'https://foo.com', img_attrs: Hash('title' => remove_colons))
+    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com', img_attrs: Hash('title' => remove_colons) })
     doc = filter.call
     assert_equal %(<img class="emoji" title="shipit" alt=":shipit:" src="https://foo.com/emoji/shipit.png" height="20" width="20" align="absmiddle">), doc.to_html
   end
 
   def test_img_attrs_can_accept_symbolized_keys
     body = ':shipit:'
-    filter = EmojiFilter.new(body, asset_root: 'https://foo.com', img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil))
+    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com', img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
     doc = filter.call
     assert_equal %(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" draggable="false">), doc.to_html
   end
diff --git a/test/html/pipeline/https_filter_test.rb b/test/html/pipeline/https_filter_test.rb
index 7bae175a..298cf314 100644
--- a/test/html/pipeline/https_filter_test.rb
+++ b/test/html/pipeline/https_filter_test.rb
@@ -4,52 +4,48 @@
 
 HttpsFilter = HTML::Pipeline::HttpsFilter
 
-class HTML::Pipeline::AutolinkFilterTest < Minitest::Test
-  def test_filter(html)
-    HttpsFilter.to_html(html, @options)
-  end
-
+class HTML::Pipeline::HttpsFilterTest < Minitest::Test
   def setup
+    @filter = HttpsFilter
     @options = { base_url: 'http://github.com' }
   end
 
   def test_http
     assert_equal %(<a href="https://github.com">github.com</a>),
-                 filter(%(<a href="http://github.com">github.com</a>))
+                 @filter.to_html(%(<a href="http://github.com">github.com</a>), context: @options)
   end
 
   def test_https
     assert_equal %(<a href="https://github.com">github.com</a>),
-                 filter(%(<a href="https://github.com">github.com</a>))
+                 @filter.to_html(%(<a href="https://github.com">github.com</a>), context: @options)
   end
 
   def test_subdomain
     assert_equal %(<a href="http://help.github.com">github.com</a>),
-                 filter(%(<a href="http://help.github.com">github.com</a>))
+                 @filter.to_html(%(<a href="http://help.github.com">github.com</a>), context: @options)
   end
 
   def test_other
     assert_equal %(<a href="http://github.io">github.io</a>),
-                 filter(%(<a href="http://github.io">github.io</a>))
+                 @filter.to_html(%(<a href="http://github.io">github.io</a>), context: @options)
   end
 
   def test_uses_http_url_over_base_url
-    @options = { http_url: 'http://github.com', base_url: 'https://github.com' }
+    options = { http_url: 'http://github.com', base_url: 'https://github.com' }
 
     assert_equal %(<a href="https://github.com">github.com</a>),
-                 filter(%(<a href="http://github.com">github.com</a>))
+                 @filter.to_html(%(<a href="http://github.com">github.com</a>), context: options)
   end
 
   def test_only_http_url
-    @options = { http_url: 'http://github.com' }
+    options = { http_url: 'http://github.com' }
 
     assert_equal %(<a href="https://github.com">github.com</a>),
-                 filter(%(<a href="http://github.com">github.com</a>))
+                 @filter.to_html(%(<a href="http://github.com">github.com</a>), context: options)
   end
 
   def test_validates_http_url
-    @options.clear
-    exception = assert_raises(ArgumentError) { filter('') }
+    exception = assert_raises(ArgumentError) { @filter.to_html('') }
     assert_match 'HTML::Pipeline::HttpsFilter: :http_url', exception.message
   end
 end
diff --git a/test/html/pipeline/image_filter_test.rb b/test/html/pipeline/image_filter_test.rb
index 7f29c01f..e0e8e095 100644
--- a/test/html/pipeline/image_filter_test.rb
+++ b/test/html/pipeline/image_filter_test.rb
@@ -5,37 +5,37 @@
 ImageFilter = HTML::Pipeline::ImageFilter
 
 class HTML::Pipeline::ImageFilterTest < Minitest::Test
-  def test_filter(html)
-    ImageFilter.to_html(html)
+  def setup
+    @filter = ImageFilter
   end
 
   def test_jpg
     assert_equal %(<img src="http://example.com/test.jpg" alt=""/>),
-                 filter(%(http://example.com/test.jpg))
+                 @filter.to_html(%(http://example.com/test.jpg))
   end
 
   def test_jpeg
     assert_equal %(<img src="http://example.com/test.jpeg" alt=""/>),
-                 filter(%(http://example.com/test.jpeg))
+                 @filter.to_html(%(http://example.com/test.jpeg))
   end
 
   def test_bmp
     assert_equal %(<img src="http://example.com/test.bmp" alt=""/>),
-                 filter(%(http://example.com/test.bmp))
+                 @filter.to_html(%(http://example.com/test.bmp))
   end
 
   def test_gif
     assert_equal %(<img src="http://example.com/test.gif" alt=""/>),
-                 filter(%(http://example.com/test.gif))
+                 @filter.to_html(%(http://example.com/test.gif))
   end
 
   def test_png
     assert_equal %(<img src="http://example.com/test.png" alt=""/>),
-                 filter(%(http://example.com/test.png))
+                 @filter.to_html(%(http://example.com/test.png))
   end
 
   def test_https_url
     assert_equal %(<img src="https://example.com/test.png" alt=""/>),
-                 filter(%(https://example.com/test.png))
+                 @filter.to_html(%(https://example.com/test.png))
   end
 end
diff --git a/test/html/pipeline/image_max_width_filter_test.rb b/test/html/pipeline/image_max_width_filter_test.rb
index 5abe567a..02306937 100644
--- a/test/html/pipeline/image_max_width_filter_test.rb
+++ b/test/html/pipeline/image_max_width_filter_test.rb
@@ -3,15 +3,15 @@
 require 'test_helper'
 
 class HTML::Pipeline::ImageMaxWidthFilterTest < Minitest::Test
-  def test_filter(html)
-    HTML::Pipeline::ImageMaxWidthFilter.call(html)
+  def setup
+    @filter = HTML::Pipeline::ImageMaxWidthFilter
   end
 
   def test_rewrites_image_style_tags
     body = "<p>Screenshot: <img src='screenshot.png'></p>"
     doc  = Nokogiri::HTML::DocumentFragment.parse(body)
 
-    res = filter(doc)
+    res = @filter.call(doc)
     assert_equal_html '<p>Screenshot: <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
                       res.to_html
   end
@@ -20,7 +20,7 @@ def test_leaves_existing_image_style_tags_alone
     body = "<p><img src='screenshot.png' style='width:100px;'></p>"
     doc  = Nokogiri::HTML::DocumentFragment.parse(body)
 
-    res = filter(doc)
+    res = @filter.call(doc)
     assert_equal_html '<p><img src="screenshot.png" style="width:100px;"></p>',
                       res.to_html
   end
@@ -29,7 +29,7 @@ def test_links_to_image
     body = "<p>Screenshot: <img src='screenshot.png'></p>"
     doc  = Nokogiri::HTML::DocumentFragment.parse(body)
 
-    res = filter(doc)
+    res = @filter.call(doc)
     assert_equal_html '<p>Screenshot: <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
                       res.to_html
   end
@@ -38,7 +38,7 @@ def test_doesnt_link_to_image_when_already_linked
     body = "<p>Screenshot: <a href='blah.png'><img src='screenshot.png'></a></p>"
     doc  = Nokogiri::HTML::DocumentFragment.parse(body)
 
-    res = filter(doc)
+    res = @filter.call(doc)
     assert_equal_html '<p>Screenshot: <a href="blah.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
                       res.to_html
   end
@@ -47,6 +47,6 @@ def test_doesnt_screw_up_inlined_images
     body = "<p>Screenshot <img src='screenshot.png'>, yes, this is a <b>screenshot</b> indeed.</p>"
     doc  = Nokogiri::HTML::DocumentFragment.parse(body)
 
-    assert_equal_html '<p>Screenshot <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a>, yes, this is a <b>screenshot</b> indeed.</p>', filter(doc).to_html
+    assert_equal_html '<p>Screenshot <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a>, yes, this is a <b>screenshot</b> indeed.</p>', @filter.call(doc).to_html
   end
 end
diff --git a/test/html/pipeline/markdown_filter_test.rb b/test/html/pipeline/markdown_filter_test.rb
index 9e7cc3c3..81757497 100644
--- a/test/html/pipeline/markdown_filter_test.rb
+++ b/test/html/pipeline/markdown_filter_test.rb
@@ -43,17 +43,17 @@ def setup
   def test_fails_when_given_a_documentfragment
     body = '<p>heyo</p>'
     doc  = HTML::Pipeline.parse(body)
-    assert_raises(TypeError) { MarkdownFilter.call(doc, {}) }
+    assert_raises(TypeError) { MarkdownFilter.call(doc, context: {}) }
   end
 
   def test_gfm_enabled_by_default
-    doc = MarkdownFilter.to_document(@haiku, {})
+    doc = MarkdownFilter.to_document(@haiku)
     assert doc.is_a?(HTML::Pipeline::DocumentFragment)
     assert_equal 2, doc.search('br').size
   end
 
   def test_disabling_gfm
-    doc = MarkdownFilter.to_document(@haiku, gfm: false)
+    doc = MarkdownFilter.to_document(@haiku, context: { gfm: false })
     assert doc.is_a?(HTML::Pipeline::DocumentFragment)
     assert_equal 0, doc.search('br').size
   end
@@ -74,24 +74,24 @@ def test_fenced_code_blocks_with_language
   def test_standard_extensions
     iframe = "<iframe src='http://www.google.com'></iframe>"
     iframe_escaped = "&lt;iframe src='http://www.google.com'>&lt;/iframe>"
-    doc = MarkdownFilter.new(iframe, unsafe: true).call
+    doc = MarkdownFilter.new(iframe, context: { unsafe: true }).call
     assert_equal(doc, iframe_escaped)
   end
 
   def test_changing_extensions
     iframe = "<iframe src='http://www.google.com'></iframe>"
-    doc = MarkdownFilter.new(iframe, commonmarker_extensions: [], unsafe: true).call
+    doc = MarkdownFilter.new(iframe, context: { commonmarker_extensions: [], unsafe: true }).call
     assert_equal(doc, iframe)
   end
 
   def test_bogus_renderer
     assert_raises ArgumentError do
-      MarkdownFilter.to_document(@haiku, commonmarker_renderer: 23)
+      MarkdownFilter.to_document(@haiku, context: { commonmarker_renderer: 23 })
     end
   end
 
   def test_legitimate_renderer
-    results = MarkdownFilter.new(@header, commonmarker_renderer: CustomRenderer).call
+    results = MarkdownFilter.new(@header, context: { commonmarker_renderer: CustomRenderer }).call
     expected = <<~DOC
       {level: 1, text: Words}
       <h1>Words</h1>
@@ -107,7 +107,7 @@ def test_legitimate_renderer
   def test_without_tagfilter
     extensions = HTML::Pipeline::MarkdownFilter::DEFAULT_COMMONMARKER_EXTENSIONS - [:tagfilter]
     script = '<script>foobar</script>'
-    results = MarkdownFilter.new(script, unsafe: true, commonmarker_extensions: extensions).call
+    results = MarkdownFilter.new(script, context: { unsafe: true, commonmarker_extensions: extensions }).call
 
     assert_equal results, script
   end
@@ -115,63 +115,64 @@ def test_without_tagfilter
   def test_legitimate_custom_renderer_without_tagfilter
     extensions = HTML::Pipeline::MarkdownFilter::DEFAULT_COMMONMARKER_EXTENSIONS - [:tagfilter]
     script = '<script>foobar</script>'
-    results = MarkdownFilter.new(script, unsafe: true, commonmarker_extensions: extensions, commonmarker_renderer: CustomRenderer).call
+    results = MarkdownFilter.new(script, context: { unsafe: true, commonmarker_extensions: extensions, commonmarker_renderer: CustomRenderer }).call
 
     assert_equal results, script
   end
 
   def test_unsafe_custom_renderer_fenced_code_blocks_with_language
-    doc = MarkdownFilter.to_document(@code.sub('```', '``` ruby'), unsafe: true, commonmarker_renderer: CustomRenderer)
+    doc = MarkdownFilter.to_document(@code.sub('```', '``` ruby'), context: { unsafe: true, commonmarker_renderer: CustomRenderer })
     assert_equal 'ruby', doc.search('pre').first['lang']
   end
 end
 
 class GFMTest < Minitest::Test
-  def test_gfm(text)
-    MarkdownFilter.call(text, gfm: true, unsafe: true)
+  def setup
+    @gfm = MarkdownFilter
+    @context = { gfm: true, unsafe: true }
   end
 
   def test_not_touch_single_underscores_inside_words
     assert_equal '<p>foo_bar</p>',
-                 gfm('foo_bar')
+                 @gfm.call('foo_bar', context: @context)
   end
 
   def test_not_touch_underscores_in_code_blocks
     assert_equal "<pre><code>foo_bar_baz\n</code></pre>",
-                 gfm('    foo_bar_baz')
+                 @gfm.call('    foo_bar_baz', context: @context)
   end
 
   def test_not_touch_underscores_in_pre_blocks
     assert_equal "<pre>\nfoo_bar_baz\n</pre>",
-                 gfm("<pre>\nfoo_bar_baz\n</pre>")
+                 @gfm.call("<pre>\nfoo_bar_baz\n</pre>", context: @context)
   end
 
   def test_not_touch_two_or_more_underscores_inside_words
     assert_equal '<p>foo_bar_baz</p>',
-                 gfm('foo_bar_baz')
+                 @gfm.call('foo_bar_baz', context: @context)
   end
 
   def test_turn_newlines_into_br_tags_in_simple_cases
     assert_equal "<p>foo<br />\nbar</p>",
-                 gfm("foo\nbar")
+                 @gfm.call("foo\nbar", context: @context)
   end
 
   def test_convert_newlines_in_all_groups
     assert_equal "<p>apple<br />\npear<br />\norange</p>\n" \
                  "<p>ruby<br />\npython<br />\nerlang</p>",
-                 gfm("apple\npear\norange\n\nruby\npython\nerlang")
+                 @gfm.call("apple\npear\norange\n\nruby\npython\nerlang", context: @context)
   end
 
   def test_convert_newlines_in_even_long_groups
     assert_equal "<p>apple<br />\npear<br />\norange<br />\nbanana</p>\n" \
                  "<p>ruby<br />\npython<br />\nerlang</p>",
-                 gfm("apple\npear\norange\nbanana\n\nruby\npython\nerlang")
+                 @gfm.call("apple\npear\norange\nbanana\n\nruby\npython\nerlang", context: @context)
   end
 
   def test_not_convert_newlines_in_lists
     assert_equal "<h1>foo</h1>\n<h1>bar</h1>",
-                 gfm("# foo\n# bar")
+                 @gfm.call("# foo\n# bar", context: @context)
     assert_equal "<ul>\n<li>foo</li>\n<li>bar</li>\n</ul>",
-                 gfm("* foo\n* bar")
+                 @gfm.call("* foo\n* bar", context: @context)
   end
 end
diff --git a/test/html/pipeline/mention_filter_test.rb b/test/html/pipeline/mention_filter_test.rb
index 35e6613d..9dae998e 100644
--- a/test/html/pipeline/mention_filter_test.rb
+++ b/test/html/pipeline/mention_filter_test.rb
@@ -3,15 +3,27 @@
 require 'test_helper'
 
 class HTML::Pipeline::MentionFilterTest < Minitest::Test
-  def test_filter(html, base_url = '/', info_url = nil, username_pattern = nil)
-    HTML::Pipeline::MentionFilter.call(html, base_url: base_url, info_url: info_url, username_pattern: username_pattern)
+  def setup
+    @filter = HTML::Pipeline::MentionFilter
+    @context = { base_url: '/', info_url: nil, username_pattern: nil }
+
+    @pipeline = HTML::Pipeline.new([
+                                              HTML::Pipeline::MarkdownFilter,
+                                              HTML::Pipeline::MentionFilter
+                                            ])
+  end
+
+  def mentioned_usernames(body) # rubocop:disable Minitest/TestMethodName
+    result = {}
+    @pipeline.call(body, result: result)
+    result[:mentioned_usernames]
   end
 
   def test_filtering_a_documentfragment
     body = '<p>@kneath: check it out.</p>'
     doc  = Nokogiri::HTML::DocumentFragment.parse(body)
 
-    res  = filter(doc, '/')
+    res  = @filter.call(doc, context: @context)
     assert_same doc, res
 
     link = '<a href="/kneath" class="user-mention">@kneath</a>'
@@ -21,7 +33,7 @@ def test_filtering_a_documentfragment
 
   def test_filtering_plain_text
     body = '<p>@kneath: check it out.</p>'
-    res  = filter(body, '/')
+    res  = @filter.call(body, context: @context)
 
     link = '<a href="/kneath" class="user-mention">@kneath</a>'
     assert_equal "<p>#{link}: check it out.</p>",
@@ -30,163 +42,138 @@ def test_filtering_plain_text
 
   def test_not_replacing_mentions_in_pre_tags
     body = '<pre>@kneath: okay</pre>'
-    assert_equal body, filter(body).to_html
+    assert_equal body, @filter.call(body, context: @context).to_html
   end
 
   def test_not_replacing_mentions_in_code_tags
     body = '<p><code>@kneath:</code> okay</p>'
-    assert_equal body, filter(body).to_html
+    assert_equal body, @filter.call(body, context: @context).to_html
   end
 
   def test_not_replacing_mentions_in_style_tags
     body = '<style>@media (min-width: 768px) { color: red; }</style>'
-    assert_equal body, filter(body).to_html
+    assert_equal body, @filter.call(body, context: @context).to_html
   end
 
   def test_not_replacing_mentions_in_links
     body = '<p><a>@kneath</a> okay</p>'
-    assert_equal body, filter(body).to_html
+    assert_equal body, @filter.call(body, context: @context).to_html
   end
 
   def test_entity_encoding_and_whatnot
     body = "<p>@&#x6b;neath what's up</p>"
     link = '<a href="/kneath" class="user-mention">@kneath</a>'
-    assert_equal "<p>#{link} what's up</p>", filter(body, '/').to_html
+    assert_equal "<p>#{link} what's up</p>", @filter.call(body, context: @context).to_html
   end
 
   def test_html_injection
     body = '<p>@kneath &lt;script>alert(0)&lt;/script></p>'
     link = '<a href="/kneath" class="user-mention">@kneath</a>'
     assert_equal "<p>#{link} &lt;script&gt;alert(0)&lt;/script&gt;</p>",
-                 filter(body, '/').to_html
-  end
-
-  def test_links_to_nothing_when_no_info_url_given
-    body = '<p>How do I @mention someone?</p>'
-    assert_equal '<p>How do I @mention someone?</p>',
-                 filter(body, '/').to_html
-  end
-
-  def test_links_to_more_info_when_info_url_given
-    body = '<p>How do I @mention someone?</p>'
-    link = '<a href="https://github.com/blog/821" class="user-mention">@mention</a>'
-    assert_equal "<p>How do I #{link} someone?</p>",
-                 filter(body, '/', 'https://github.com/blog/821').to_html
+                 @filter.call(body, context: @context).to_html
   end
 
   def test_base_url_slash
     body = '<p>Hi, @jch!</p>'
     link = '<a href="/jch" class="user-mention">@jch</a>'
     assert_equal "<p>Hi, #{link}!</p>",
-                 filter(body, '/').to_html
+                 @filter.call(body, context: { base_url: '/'}).to_html
   end
 
   def test_base_url_under_custom_route
     body = '<p>Hi, @jch!</p>'
     link = '<a href="/userprofile/jch" class="user-mention">@jch</a>'
     assert_equal "<p>Hi, #{link}!</p>",
-                 filter(body, '/userprofile').to_html
+                 @filter.call(body, context: @context.merge({ base_url: '/userprofile' })).to_html
   end
 
   def test_base_url_slash_with_tilde
     body = '<p>Hi, @jch!</p>'
     link = '<a href="/~jch" class="user-mention">@jch</a>'
     assert_equal "<p>Hi, #{link}!</p>",
-                 filter(body, '/~').to_html
-  end
-
-  MarkdownPipeline =
-    HTML::Pipeline.new [
-      HTML::Pipeline::MarkdownFilter,
-      HTML::Pipeline::MentionFilter
-    ]
-
-  def test_mentioned_usernames
-    result = {}
-    MarkdownPipeline.call(@body, {}, result)
-    result[:mentioned_usernames]
+                 @filter.call(body, context: @context.merge({ base_url: '/~' })).to_html
   end
 
   def test_matches_usernames_in_body
-    @body = '@test how are you?'
-    assert_equal %w[test], mentioned_usernames
+    body = '@test how are you?'
+    assert_equal %w[test], mentioned_usernames(body)
   end
 
   def test_matches_usernames_with_dashes
-    @body = 'hi @some-user'
-    assert_equal %w[some-user], mentioned_usernames
+    body = 'hi @some-user'
+    assert_equal %w[some-user], mentioned_usernames(body)
   end
 
   def test_matches_usernames_followed_by_a_single_dot
-    @body = 'okay @some-user.'
-    assert_equal %w[some-user], mentioned_usernames
+    body = 'okay @some-user.'
+    assert_equal %w[some-user], mentioned_usernames(body)
   end
 
   def test_matches_usernames_followed_by_multiple_dots
-    @body = 'okay @some-user...'
-    assert_equal %w[some-user], mentioned_usernames
+    body = 'okay @some-user...'
+    assert_equal %w[some-user], mentioned_usernames(body)
   end
 
   def test_does_not_match_email_addresses
-    @body = 'aman@tmm1.net'
-    assert_equal [], mentioned_usernames
+    body = 'aman@tmm1.net'
+    assert_equal [], mentioned_usernames(body)
   end
 
   def test_does_not_match_domain_name_looking_things
-    @body = 'we need a @github.com email'
-    assert_equal [], mentioned_usernames
+    body = 'we need a @github.com email'
+    assert_equal [], mentioned_usernames(body)
   end
 
   def test_does_not_match_organization_team_mentions
-    @body = 'we need to @github/enterprise know'
-    assert_equal [], mentioned_usernames
+    body = 'we need to @github/enterprise know'
+    assert_equal [], mentioned_usernames(body)
   end
 
   def test_matches_colon_suffixed_names
-    @body = '@tmm1: what do you think?'
-    assert_equal %w[tmm1], mentioned_usernames
+    body = '@tmm1: what do you think?'
+    assert_equal %w[tmm1], mentioned_usernames(body)
   end
 
   def test_matches_list_of_names
-    @body = '@defunkt @atmos @kneath'
-    assert_equal %w[defunkt atmos kneath], mentioned_usernames
+    body = '@defunkt @atmos @kneath'
+    assert_equal %w[defunkt atmos kneath], mentioned_usernames(body)
   end
 
   def test_matches_list_of_names_with_commas
-    @body = '/cc @defunkt, @atmos, @kneath'
-    assert_equal %w[defunkt atmos kneath], mentioned_usernames
+    body = '/cc @defunkt, @atmos, @kneath'
+    assert_equal %w[defunkt atmos kneath], mentioned_usernames(body)
   end
 
   def test_matches_inside_brackets
-    @body = '(@mislav) and [@rtomayko]'
-    assert_equal %w[mislav rtomayko], mentioned_usernames
+    body = '(@mislav) and [@rtomayko]'
+    assert_equal %w[mislav rtomayko], mentioned_usernames(body)
   end
 
   def test_doesnt_ignore_invalid_users
-    @body = '@defunkt @mojombo and @somedude'
-    assert_equal %w[defunkt mojombo somedude], mentioned_usernames
+    body = '@defunkt @mojombo and @somedude'
+    assert_equal %w[defunkt mojombo somedude], mentioned_usernames(body)
   end
 
   def test_returns_distinct_set
-    @body = '/cc @defunkt, @atmos, @kneath, @defunkt, @defunkt'
-    assert_equal %w[defunkt atmos kneath], mentioned_usernames
+    body = '/cc @defunkt, @atmos, @kneath, @defunkt, @defunkt'
+    assert_equal %w[defunkt atmos kneath], mentioned_usernames(body)
   end
 
   def test_does_not_match_inline_code_block_with_multiple_code_blocks
-    @body = "something\n\n`/cc @defunkt @atmos @kneath` `/cc @atmos/atmos`"
-    assert_equal %w[], mentioned_usernames
+    body = "something\n\n`/cc @defunkt @atmos @kneath` `/cc @atmos/atmos`"
+    assert_equal %w[], mentioned_usernames(body)
   end
 
   def test_mention_at_end_of_parenthetical_sentence
-    @body = "(We're talking 'bout @ymendel.)"
-    assert_equal %w[ymendel], mentioned_usernames
+    body = "(We're talking 'bout @ymendel.)"
+    assert_equal %w[ymendel], mentioned_usernames(body)
   end
 
   def test_username_pattern_can_be_customized
     body = '<p>@_abc: test.</p>'
     doc  = Nokogiri::HTML::DocumentFragment.parse(body)
 
-    res  = filter(doc, '/', nil, /(_[a-z]{3})/)
+    res  = @filter.call(doc, context: { base_url: '/', username_pattern: /(_[a-z]{3})/})
 
     link = '<a href="/_abc" class="user-mention">@_abc</a>'
     assert_equal "<p>#{link}: test.</p>",
@@ -197,13 +184,13 @@ def test_filter_does_not_create_a_new_object_for_default_username_pattern
     body = '<div>@test</div>'
     doc = Nokogiri::HTML::DocumentFragment.parse(body)
 
-    filter(doc.clone, '/', nil)
-    pattern_count = HTML::Pipeline::MentionFilter::MentionPatterns.length
-    filter(doc.clone, '/', nil)
+    @filter.call(doc.clone)
+    pattern_count = HTML::Pipeline::MentionFilter::MENTION_PATTERNS.length
+    @filter.call(doc.clone)
 
-    assert_equal pattern_count, HTML::Pipeline::MentionFilter::MentionPatterns.length
-    filter(doc.clone, '/', nil, /test/)
-    assert_equal pattern_count + 1, HTML::Pipeline::MentionFilter::MentionPatterns.length
+    assert_equal pattern_count, HTML::Pipeline::MentionFilter::MENTION_PATTERNS.length
+    @filter.call(doc.clone, context: {username_pattern: /test/})
+    assert_equal pattern_count + 1, HTML::Pipeline::MentionFilter::MENTION_PATTERNS.length
   end
 
   def test_mention_link_filter
diff --git a/test/html/pipeline/sanitization_filter_test.rb b/test/html/pipeline/sanitization_filter_test.rb
index a7059212..e16f75b1 100644
--- a/test/html/pipeline/sanitization_filter_test.rb
+++ b/test/html/pipeline/sanitization_filter_test.rb
@@ -67,14 +67,14 @@ def test_weird_longdesc_schemes_are_removed
 
   def test_standard_schemes_are_removed_if_not_specified_in_anchor_schemes
     stuff  = '<a href="http://www.example.com/">No href for you</a>'
-    filter = SanitizationFilter.new(stuff, anchor_schemes: [])
+    filter = SanitizationFilter.new(stuff, context: { anchor_schemes: [] })
     html   = filter.call.to_s
     assert_equal '<a>No href for you</a>', html
   end
 
   def test_custom_anchor_schemes_are_not_removed
     stuff  = '<a href="something-weird://heyyy">Wat</a> is this'
-    filter = SanitizationFilter.new(stuff, anchor_schemes: ['something-weird'])
+    filter = SanitizationFilter.new(stuff, context: { anchor_schemes: ['something-weird'] })
     html   = filter.call.to_s
     assert_equal stuff, html
   end
@@ -86,7 +86,7 @@ def test_anchor_schemes_are_merged_with_other_anchor_restrictions
       attributes: { 'a' => %w[href ping] },
       protocols: { 'a' => { 'ping' => ['http'] } }
     }
-    filter = SanitizationFilter.new(stuff, allowlist: allowlist, anchor_schemes: ['something-weird'])
+    filter = SanitizationFilter.new(stuff, context: { allowlist: allowlist, anchor_schemes: ['something-weird'] })
     html   = filter.call.to_s
     assert_equal '<a href="something-weird://heyyy">Wat</a> is this', html
   end
@@ -98,7 +98,7 @@ def test_uses_anchor_schemes_from_allowlist_when_not_separately_specified
       attributes: { 'a' => ['href'] },
       protocols: { 'a' => { 'href' => ['something-weird'] } }
     }
-    filter = SanitizationFilter.new(stuff, allowlist: allowlist)
+    filter = SanitizationFilter.new(stuff, context: { allowlist: allowlist })
     html   = filter.call.to_s
     assert_equal stuff, html
   end
@@ -109,7 +109,7 @@ def test_allowlist_contains_default_anchor_schemes
 
   def test_allowlist_from_full_constant
     stuff  = '<a href="something-weird://heyyy" ping="more-weird://hiii">Wat</a> is this'
-    filter = SanitizationFilter.new(stuff, allowlist: SanitizationFilter::FULL)
+    filter = SanitizationFilter.new(stuff, context: { allowlist: SanitizationFilter::FULL })
     html   = filter.call.to_s
     assert_equal 'Wat is this', html
   end
@@ -170,7 +170,7 @@ def test_deprecated_whitelist_context
     orig = %(<p><style>hey now</style></p>)
     context = { whitelist: ['table'] }
 
-    assert_equal ['table'], SanitizationFilter.new(orig, context).allowlist
+    assert_equal ['table'], SanitizationFilter.new(orig, context: context).allowlist
   end
 
   def test_deprecation_warning_whitelist
diff --git a/test/html/pipeline/syntax_highlight_filter_test.rb b/test/html/pipeline/syntax_highlight_filter_test.rb
index 2f91b7a1..09fd94bf 100644
--- a/test/html/pipeline/syntax_highlight_filter_test.rb
+++ b/test/html/pipeline/syntax_highlight_filter_test.rb
@@ -8,7 +8,7 @@
 class HTML::Pipeline::SyntaxHighlightFilterTest < Minitest::Test
   def test_highlight_default
     filter = SyntaxHighlightFilter.new \
-      '<pre>hello</pre>', highlight: 'coffeescript'
+      '<pre>hello</pre>', context: { highlight: 'coffeescript' }
 
     doc = filter.call
     refute_empty doc.css('.highlight')
@@ -17,7 +17,7 @@ def test_highlight_default
 
   def test_highlight_default_will_not_override
     filter = SyntaxHighlightFilter.new \
-      "<pre lang='c'>hello</pre>", highlight: 'coffeescript'
+      "<pre lang='c'>hello</pre>",  context: { highlight: 'coffeescript' }
 
     doc = filter.call
     assert_empty doc.css('.highlight-coffeescript')
@@ -26,7 +26,7 @@ def test_highlight_default_will_not_override
 
   def test_highlight_does_not_remove_pre_tag
     filter = SyntaxHighlightFilter.new \
-      "<pre lang='c'>hello</pre>", highlight: 'coffeescript'
+      "<pre lang='c'>hello</pre>",  context: { highlight: 'coffeescript' }
 
     doc = filter.call
 
@@ -35,7 +35,7 @@ def test_highlight_does_not_remove_pre_tag
 
   def test_highlight_allows_optional_scope
     filter = SyntaxHighlightFilter.new \
-      "<pre lang='c'>hello</pre>", highlight: 'coffeescript', scope: 'test-scope'
+      "<pre lang='c'>hello</pre>",  context: { highlight: 'coffeescript', scope: 'test-scope' }
 
     doc = filter.call
 
@@ -44,7 +44,7 @@ def test_highlight_allows_optional_scope
 
   def test_highlight_keeps_the_pre_tags_lang
     filter = SyntaxHighlightFilter.new \
-      "<pre lang='c'>hello</pre>", highlight: 'coffeescript'
+      "<pre lang='c'>hello</pre>",  context: { highlight: 'coffeescript' }
 
     doc = filter.call
 
@@ -55,7 +55,7 @@ def test_highlight_handles_nested_pre_tags
     inner_code = "<pre>console.log('i am nested!')</pre>"
     escaped = EscapeUtils.escape_html(inner_code)
     html = "<pre lang='html'>#{escaped}</pre>"
-    filter = SyntaxHighlightFilter.new html, highlight: 'html'
+    filter = SyntaxHighlightFilter.new html, context: { highlight: 'html' }
 
     doc = filter.call
 
diff --git a/test/html/pipeline/team_mention_filter_test.rb b/test/html/pipeline/team_mention_filter_test.rb
index fa30557e..ff396c0d 100644
--- a/test/html/pipeline/team_mention_filter_test.rb
+++ b/test/html/pipeline/team_mention_filter_test.rb
@@ -3,13 +3,25 @@
 require 'test_helper'
 
 class HTML::Pipeline::TeamMentionFilterTest < Minitest::Test
-  def test_filter(html, base_url = '/', team_pattern = nil)
-    HTML::Pipeline::TeamMentionFilter.call(html, base_url: base_url, team_pattern: team_pattern)
+  def setup
+    @filter = HTML::Pipeline::TeamMentionFilter
+
+    @pipeline =
+      HTML::Pipeline.new [
+        HTML::Pipeline::MarkdownFilter,
+        HTML::Pipeline::TeamMentionFilter
+      ]
+  end
+
+  def mentioned_teams(body) # rubocop:disable Minitest/TestMethodName
+    result = {}
+    @pipeline.call(body, result: result)
+    result[:mentioned_teams]
   end
 
   def test_filtering_plain_text
     body = '<p>@github/team: check it out.</p>'
-    res  = filter(body, '/')
+    res  = @filter.call(body, context: { base_url: '/' })
 
     link = '<a href="/github/team" class="team-mention">@github/team</a>'
     assert_equal "<p>#{link}: check it out.</p>",
@@ -20,7 +32,7 @@ def test_filtering_a_documentfragment
     body = '<p>@github/team: check it out.</p>'
     doc  = Nokogiri::HTML::DocumentFragment.parse(body)
 
-    res  = filter(doc, '/')
+    res  = @filter.call(doc, context: { base_url: '/' })
     assert_same doc, res
 
     link = '<a href="/github/team" class="team-mention">@github/team</a>'
@@ -30,62 +42,62 @@ def test_filtering_a_documentfragment
 
   def test_not_replacing_mentions_in_pre_tags
     body = '<pre>@github/team: okay</pre>'
-    assert_equal body, filter(body).to_html
+    assert_equal body, @filter.call(body).to_html
   end
 
   def test_not_replacing_mentions_in_code_tags
     body = '<p><code>@github/team:</code> okay</p>'
-    assert_equal body, filter(body).to_html
+    assert_equal body,@filter.call(body).to_html
   end
 
   def test_not_replacing_mentions_in_style_tags
     body = '<style>@github/team (min-width: 768px) { color: red; }</style>'
-    assert_equal body, filter(body).to_html
+    assert_equal body, @filter.call(body).to_html
   end
 
   def test_not_replacing_mentions_in_links
     body = '<p><a>@github/team</a> okay</p>'
-    assert_equal body, filter(body).to_html
+    assert_equal body, @filter.call(body).to_html
   end
 
   def test_entity_encoding_and_whatnot
     body = "<p>@github&#47team what's up</p>"
     link = '<a href="/github/team" class="team-mention">@github/team</a>'
-    assert_equal "<p>#{link} what's up</p>", filter(body, '/').to_html
+    assert_equal "<p>#{link} what's up</p>", @filter.call(body, context: { base_url: '/' }).to_html
   end
 
   def test_html_injection
     body = '<p>@github/team &lt;script>alert(0)&lt;/script></p>'
     link = '<a href="/github/team" class="team-mention">@github/team</a>'
     assert_equal "<p>#{link} &lt;script&gt;alert(0)&lt;/script&gt;</p>",
-                 filter(body, '/').to_html
+                 @filter.call(body, context: { base_url: '/' }).to_html
   end
 
   def test_links_to_nothing_with_user_mention
     body = '<p>Hi, @kneath</p>'
     assert_equal '<p>Hi, @kneath</p>',
-                 filter(body, '/').to_html
+                 @filter.call(body, context: { base_url: '/' }).to_html
   end
 
   def test_base_url_slash
     body = '<p>Hi, @github/team!</p>'
     link = '<a href="/github/team" class="team-mention">@github/team</a>'
     assert_equal "<p>Hi, #{link}!</p>",
-                 filter(body, '/').to_html
+                 @filter.call(body, context: { base_url: '/' }).to_html
   end
 
   def test_base_url_under_custom_route
     body = '<p>Hi, @org/team!</p>'
     link = '<a href="www.github.com/org/team" class="team-mention">@org/team</a>'
     assert_equal "<p>Hi, #{link}!</p>",
-                 filter(body, 'www.github.com').to_html
+                 @filter.call(body, context: { base_url: 'www.github.com' }).to_html
   end
 
   def test_base_url_slash_with_tilde
     body = '<p>Hi, @github/team!</p>'
     link = '<a href="/~github/team" class="team-mention">@github/team</a>'
     assert_equal "<p>Hi, #{link}!</p>",
-                 filter(body, '/~').to_html
+                 @filter.call(body, context: { base_url: '/~' }).to_html
   end
 
   def test_multiple_team_mentions
@@ -93,101 +105,89 @@ def test_multiple_team_mentions
     link_whale = '<a href="/github/whale" class="team-mention">@github/whale</a>'
     link_donut = '<a href="/github/donut" class="team-mention">@github/donut</a>'
     assert_equal "<p>Hi, #{link_whale} and #{link_donut}!</p>",
-                 filter(body).to_html
-  end
-
-  MarkdownPipeline =
-    HTML::Pipeline.new [
-      HTML::Pipeline::MarkdownFilter,
-      HTML::Pipeline::TeamMentionFilter
-    ]
-
-  def test_mentioned_teams
-    result = {}
-    MarkdownPipeline.call(@body, {}, result)
-    result[:mentioned_teams]
+                 @filter.call(body).to_html
   end
 
   def test_matches_teams_in_body
-    @body = '@test/team how are you?'
-    assert_equal %w[team], mentioned_teams
+    body = '@test/team how are you?'
+    assert_equal %w[team], mentioned_teams(body)
   end
 
   def test_matches_orgs_with_dashes
-    @body = 'hi @some-org/team'
-    assert_equal %w[team], mentioned_teams
+    body = 'hi @some-org/team'
+    assert_equal %w[team], mentioned_teams(body)
   end
 
   def test_matches_teams_with_dashes
-    @body = 'hi @github/some-team'
-    assert_equal %w[some-team], mentioned_teams
+    body = 'hi @github/some-team'
+    assert_equal %w[some-team], mentioned_teams(body)
   end
 
   def test_matches_teams_followed_by_a_single_dot
-    @body = 'okay @github/team.'
-    assert_equal %w[team], mentioned_teams
+    body = 'okay @github/team.'
+    assert_equal %w[team], mentioned_teams(body)
   end
 
   def test_matches_teams_followed_by_multiple_dots
-    @body = 'okay @github/team...'
-    assert_equal %w[team], mentioned_teams
+    body = 'okay @github/team...'
+    assert_equal %w[team], mentioned_teams(body)
   end
 
   def test_does_not_match_email_addresses
-    @body = 'aman@tmm1.net'
-    assert_equal [], mentioned_teams
+    body = 'aman@tmm1.net'
+    assert_equal [], mentioned_teams(body)
   end
 
   def test_does_not_match_domain_name_looking_things
-    @body = 'we need a @github.com email'
-    assert_equal [], mentioned_teams
+    body = 'we need a @github.com email'
+    assert_equal [], mentioned_teams(body)
   end
 
   def test_does_not_match_user_mentions
-    @body = 'we need to @enterprise know'
-    assert_equal [], mentioned_teams
+    body = 'we need to @enterprise know'
+    assert_equal [], mentioned_teams(body)
   end
 
   def test_matches_colon_suffixed_team_names
-    @body = '@github/team: what do you think?'
-    assert_equal %w[team], mentioned_teams
+    body = '@github/team: what do you think?'
+    assert_equal %w[team], mentioned_teams(body)
   end
 
   def test_matches_list_of_teams
-    @body = '@github/whale @github/donut @github/green'
-    assert_equal %w[whale donut green], mentioned_teams
+    body = '@github/whale @github/donut @github/green'
+    assert_equal %w[whale donut green], mentioned_teams(body)
   end
 
   def test_matches_list_of_teams_with_commas
-    @body = '/cc @github/whale, @github/donut, @github/green'
-    assert_equal %w[whale donut green], mentioned_teams
+    body = '/cc @github/whale, @github/donut, @github/green'
+    assert_equal %w[whale donut green], mentioned_teams(body)
   end
 
   def test_matches_inside_brackets
-    @body = '(@github/whale) and [@github/donut]'
-    assert_equal %w[whale donut], mentioned_teams
+    body = '(@github/whale) and [@github/donut]'
+    assert_equal %w[whale donut], mentioned_teams(body)
   end
 
   def test_returns_distinct_set
-    @body = '/cc @github/whale, @github/donut, @github/whale, @github/whale'
-    assert_equal %w[whale donut], mentioned_teams
+    body = '/cc @github/whale, @github/donut, @github/whale, @github/whale'
+    assert_equal %w[whale donut], mentioned_teams(body)
   end
 
   def test_does_not_match_inline_code_block_with_multiple_code_blocks
-    @body = "something\n\n`/cc @github/whale @github/donut @github/green` `/cc @donut/donut`"
-    assert_equal %w[], mentioned_teams
+    body = "something\n\n`/cc @github/whale @github/donut @github/green` `/cc @donut/donut`"
+    assert_equal %w[], mentioned_teams(body)
   end
 
   def test_mention_at_end_of_parenthetical_sentence
-    @body = "(We're talking 'bout @some-org/some-team.)"
-    assert_equal %w[some-team], mentioned_teams
+    body = "(We're talking 'bout @some-org/some-team.)"
+    assert_equal %w[some-team], mentioned_teams(body)
   end
 
   def test_team_pattern_can_be_customized
     body = '<p>@_abc/XYZ: test</p>'
     doc  = Nokogiri::HTML::DocumentFragment.parse(body)
 
-    res  = filter(doc, '/', %r{@(_[a-z]{3})/([A-Z]{3})})
+    res  = @filter.call(doc,context: {team_pattern: %r{@(_[a-z]{3})/([A-Z]{3})}})
 
     link = '<a href="/_abc/XYZ" class="team-mention">@_abc/XYZ</a>'
     assert_equal "<p>#{link}: test</p>",
diff --git a/test/html/pipeline/toc_filter_test.rb b/test/html/pipeline/toc_filter_test.rb
index 5a6a13ec..ab56db2a 100644
--- a/test/html/pipeline/toc_filter_test.rb
+++ b/test/html/pipeline/toc_filter_test.rb
@@ -10,9 +10,9 @@ class HTML::Pipeline::TableOfContentsFilterTest < Minitest::Test
       HTML::Pipeline::TableOfContentsFilter
     ]
 
-  def test_toc
+  def toc(content) # rubocop:disable Minitest/TestMethodName
     result = {}
-    TocPipeline.call(@orig, {}, result)
+    TocPipeline.call(content, context: {}, result: result)
     result[:toc]
   end
 
@@ -25,12 +25,12 @@ def test_custom_anchor_icons_added_properly
     orig = %(<h1>Ice cube</h1>)
     expected = %(<h1>\n<a id="ice-cube" class="anchor" href="#ice-cube" aria-hidden="true">#</a>Ice cube</h1>)
 
-    assert_equal expected, TocFilter.call(orig, anchor_icon: '#').to_s
+    assert_equal expected, TocFilter.call(orig, context: {anchor_icon: '#'}).to_s
   end
 
   def test_toc_list_added_properly
-    @orig = %(<h1>Ice cube</h1><p>Will swarm on any motherfucker in a blue uniform</p>)
-    assert_includes toc, %(<ul class="section-nav">\n<li><a href=")
+    orig = %(<h1>Ice cube</h1><p>Will swarm on any motherfucker in a blue uniform</p>)
+    assert_includes toc(orig), %(<ul class="section-nav">\n<li><a href=")
   end
 
   def test_anchors_have_sane_names
@@ -50,7 +50,8 @@ def test_anchors_have_aria_hidden
   end
 
   def test_toc_hrefs_have_sane_values
-    @orig = %(<h1>Dr Dre</h1><h1>Ice Cube</h1><h1>Eazy-E</h1><h1>MC Ren</h1>)
+    orig = %(<h1>Dr Dre</h1><h1>Ice Cube</h1><h1>Eazy-E</h1><h1>MC Ren</h1>)
+    toc = TocFilter.call(orig).to_s
     assert_includes toc, '"#dr-dre"'
     assert_includes toc, '"#ice-cube"'
     assert_includes toc, '"#eazy-e"'
@@ -70,13 +71,13 @@ def test_dupe_headers_have_unique_trailing_identifiers
   end
 
   def test_dupe_headers_have_unique_toc_anchors
-    @orig = %(<h1>Straight Outta Compton</h1>
+    orig = %(<h1>Straight Outta Compton</h1>
               <h2>Dopeman</h2>
               <h3>Express Yourself</h3>
               <h1>Dopeman</h1>)
 
-    assert_includes toc, '"#dopeman"'
-    assert_includes toc, '"#dopeman-1"'
+    assert_includes toc(orig), '"#dopeman"'
+    assert_includes toc(orig), '"#dopeman-1"'
   end
 
   def test_all_header_tags_are_found_when_adding_anchors
@@ -94,13 +95,13 @@ def test_all_header_tags_are_found_when_adding_anchors
   end
 
   def test_toc_outputs_escaped_html
-    @orig = %(<h1>&lt;img src="x" onerror="alert(42)"&gt;</h1>)
+    orig = %(<h1>&lt;img src="x" onerror="alert(42)"&gt;</h1>)
 
-    refute_includes toc, %(<img src="x" onerror="alert(42)">)
+    refute_includes toc(orig), %(<img src="x" onerror="alert(42)">)
   end
 
   def test_toc_is_complete
-    @orig = %(<h1>"Funky President" by James Brown</h1>
+    orig = %(<h1>"Funky President" by James Brown</h1>
               <h2>"It's My Thing" by Marva Whitney</h2>
               <h3>"Boogie Back" by Roy Ayers</h3>
               <h4>"Feel Good" by Fancy</h4>
@@ -110,7 +111,7 @@ def test_toc_is_complete
 
     expected = %(<ul class="section-nav">\n<li><a href="#funky-president-by-james-brown">&quot;Funky President&quot; by James Brown</a></li>\n<li><a href="#its-my-thing-by-marva-whitney">&quot;It&#39;s My Thing&quot; by Marva Whitney</a></li>\n<li><a href="#boogie-back-by-roy-ayers">&quot;Boogie Back&quot; by Roy Ayers</a></li>\n<li><a href="#feel-good-by-fancy">&quot;Feel Good&quot; by Fancy</a></li>\n<li><a href="#funky-drummer-by-james-brown">&quot;Funky Drummer&quot; by James Brown</a></li>\n<li><a href="#ruthless-villain-by-eazy-e">&quot;Ruthless Villain&quot; by Eazy-E</a></li>\n</ul>)
 
-    assert_equal expected, toc
+    assert_equal expected, toc(orig)
   end
 
   if RUBY_VERSION > '1.9' # not sure how to make this work on 1.8.7
@@ -128,10 +129,10 @@ def test_anchors_with_utf8_characters
     end
 
     def test_toc_with_utf8_characters
-      @orig = %(<h1>日本語</h1>
+      orig = %(<h1>日本語</h1>
                 <h1>Русский</h1)
 
-      rendered_toc = Nokogiri::HTML::DocumentFragment.parse(toc).to_s
+      rendered_toc = Nokogiri::HTML::DocumentFragment.parse(toc(orig)).to_s
 
       expected = %(<ul class="section-nav">\n<li><a href="#%E6%97%A5%E6%9C%AC%E8%AA%9E">日本語</a></li>\n<li><a href="#%D0%A0%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9">Русский</a></li>\n</ul>)
 
diff --git a/test/html/pipeline_test.rb b/test/html/pipeline_test.rb
index 1209bbdb..33917e35 100644
--- a/test/html/pipeline_test.rb
+++ b/test/html/pipeline_test.rb
@@ -6,22 +6,23 @@
 class HTML::PipelineTest < Minitest::Test
   Pipeline = HTML::Pipeline
   class TestFilter
-    def self.call(input, _context, _result)
+    def self.call(input, context: {}, result: {})
       input.reverse
     end
   end
 
   def setup
-    @context = {}
+    @default_context = {}
     @result_class = Hash
-    @pipeline = Pipeline.new [TestFilter], @context, @result_class
+    @pipeline = Pipeline.new [TestFilter], default_context: @default_context, result_class: @result_class
   end
 
   def test_filter_instrumentation
     service = MockedInstrumentationService.new
     events = service.subscribe 'call_filter.html_pipeline'
     @pipeline.instrumentation_service = service
-    filter(body = 'hello')
+    body = 'hello'
+    @pipeline.call(body)
     event, payload, res = events.pop
     assert event, 'event expected'
     assert_equal 'call_filter.html_pipeline', event
@@ -34,7 +35,8 @@ def test_pipeline_instrumentation
     service = MockedInstrumentationService.new
     events = service.subscribe 'call_pipeline.html_pipeline'
     @pipeline.instrumentation_service = service
-    filter(body = 'hello')
+    body = 'hello'
+    @pipeline.call(body)
     event, payload, res = events.pop
     assert event, 'event expected'
     assert_equal 'call_pipeline.html_pipeline', event
@@ -46,7 +48,7 @@ def test_pipeline_instrumentation
   def test_default_instrumentation_service
     service = 'default'
     Pipeline.default_instrumentation_service = service
-    pipeline = Pipeline.new [], @context, @result_class
+    pipeline = Pipeline.new [], default_context: @default_context, result_class: @result_class
     assert_equal service, pipeline.instrumentation_service
   ensure
     Pipeline.default_instrumentation_service = nil
@@ -57,20 +59,18 @@ def test_setup_instrumentation
 
     service = MockedInstrumentationService.new
     events = service.subscribe 'call_pipeline.html_pipeline'
-    @pipeline.setup_instrumentation name = 'foo', service
+    name = 'foo'
+    @pipeline.setup_instrumentation name, service: service
 
     assert_equal service, @pipeline.instrumentation_service
     assert_equal name, @pipeline.instrumentation_name
 
-    filter(body = 'foo')
+    body = 'foo'
+    @pipeline.call(body)
 
     event, payload, res = events.pop
     assert event, 'expected event'
     assert_equal name, payload[:pipeline]
     assert_equal body.reverse, payload[:result][:output]
   end
-
-  def test_filter(input)
-    @pipeline.call(input)
-  end
 end

From 7c7fad1f82f81ebf15dd81d59eed28d979b8e441 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 8 Jan 2021 12:07:51 +0000
Subject: [PATCH 17/64] Complete linting

---
 lib/html/pipeline.rb                          |  8 ++---
 lib/html/pipeline/body_content.rb             |  2 --
 lib/html/pipeline/emoji_filter.rb             | 32 +++++++++----------
 lib/html/pipeline/filter.rb                   | 12 +++----
 .../{@mention_filter.rb => mention_filter.rb} |  0
 lib/html/pipeline/sanitization_filter.rb      |  7 +---
 lib/html/pipeline/syntax_highlight_filter.rb  |  4 +--
 ...ntion_filter.rb => team_mention_filter.rb} |  0
 lib/html/pipeline/toc_filter.rb               |  2 +-
 test/html/pipeline/mention_filter_test.rb     | 12 +++----
 .../html/pipeline/sanitization_filter_test.rb | 12 ++-----
 .../html/pipeline/team_mention_filter_test.rb |  4 +--
 test/html/pipeline/toc_filter_test.rb         |  2 +-
 test/html/pipeline_test.rb                    |  8 ++---
 14 files changed, 44 insertions(+), 61 deletions(-)
 rename lib/html/pipeline/{@mention_filter.rb => mention_filter.rb} (100%)
 rename lib/html/pipeline/{@team_mention_filter.rb => team_mention_filter.rb} (100%)

diff --git a/lib/html/pipeline.rb b/lib/html/pipeline.rb
index f416ad42..bc1bf85c 100644
--- a/lib/html/pipeline.rb
+++ b/lib/html/pipeline.rb
@@ -36,8 +36,8 @@ class Pipeline
     autoload :ImageFilter,           'html/pipeline/image_filter'
     autoload :ImageMaxWidthFilter,   'html/pipeline/image_max_width_filter'
     autoload :MarkdownFilter,        'html/pipeline/markdown_filter'
-    autoload :MentionFilter,         'html/pipeline/@mention_filter'
-    autoload :TeamMentionFilter,     'html/pipeline/@team_mention_filter'
+    autoload :MentionFilter,         'html/pipeline/mention_filter'
+    autoload :TeamMentionFilter,     'html/pipeline/team_mention_filter'
     autoload :PlainTextInputFilter,  'html/pipeline/plain_text_input_filter'
     autoload :SanitizationFilter,    'html/pipeline/sanitization_filter'
     autoload :SyntaxHighlightFilter, 'html/pipeline/syntax_highlight_filter'
@@ -114,8 +114,8 @@ def call(html, context: {}, result: {})
       context = @default_context.merge(context)
       context = context.freeze
       result ||= @result_class.new
-      payload = default_payload ({filters: @filters.map(&:name),
-                                context: context, result: result})
+      payload = default_payload({ filters: @filters.map(&:name),
+                                  context: context, result: result })
       instrument 'call_pipeline.html_pipeline', payload do
         result[:output] =
           @filters.inject(html) do |doc, filter|
diff --git a/lib/html/pipeline/body_content.rb b/lib/html/pipeline/body_content.rb
index 84f70f84..ead3f5ea 100644
--- a/lib/html/pipeline/body_content.rb
+++ b/lib/html/pipeline/body_content.rb
@@ -5,8 +5,6 @@ class Pipeline
     # Public: Runs a String of content through an HTML processing pipeline,
     # providing easy access to a generated DocumentFragment.
     class BodyContent
-      attr_reader :result
-
       # Public: Initialize a BodyContent.
       #
       # body     - A String body.
diff --git a/lib/html/pipeline/emoji_filter.rb b/lib/html/pipeline/emoji_filter.rb
index 5893b1a5..15a2910c 100644
--- a/lib/html/pipeline/emoji_filter.rb
+++ b/lib/html/pipeline/emoji_filter.rb
@@ -66,10 +66,8 @@ def asset_path(name)
         end
       end
 
-      private
-
       # Build an emoji image tag
-      def emoji_image_tag(name)
+      private def emoji_image_tag(name)
         html_attrs =
           default_img_attrs(name).transform_keys(&:to_sym)
                                  .merge!(context[:img_attrs] || {}).transform_keys(&:to_sym)
@@ -83,8 +81,17 @@ def emoji_image_tag(name)
         "<img #{html_attrs}>"
       end
 
+      # Build a regexp that matches all valid :emoji: names.
+      def self.emoji_pattern
+        @emoji_pattern ||= /:(#{emoji_names.map { |name| Regexp.escape(name) }.join('|')}):/
+      end
+
+      def self.emoji_names
+        Emoji.all.map(&:aliases).flatten.sort
+      end
+
       # Default attributes for img tag
-      def default_img_attrs(name)
+      private def default_img_attrs(name)
         {
           'class' => 'emoji',
           'title' => ":#{name}:",
@@ -96,31 +103,22 @@ def default_img_attrs(name)
         }
       end
 
-      def emoji_url(name)
+      private def emoji_url(name)
         File.join(asset_root, asset_path(name))
       end
 
-      # Build a regexp that matches all valid :emoji: names.
-      def self.emoji_pattern
-        @emoji_pattern ||= /:(#{emoji_names.map { |name| Regexp.escape(name) }.join('|')}):/
-      end
-
-      def emoji_pattern
+      private def emoji_pattern
         self.class.emoji_pattern
       end
 
-      def self.emoji_names
-        Emoji.all.map(&:aliases).flatten.sort
-      end
-
-      def emoji_filename(name)
+      private def emoji_filename(name)
         Emoji.find_by_alias(name).image_filename
       end
 
       # Return ancestor tags to stop the emojification.
       #
       # @return [Array<String>] Ancestor tags.
-      def ignored_ancestor_tags
+      private def ignored_ancestor_tags
         if context[:ignored_ancestor_tags]
           DEFAULT_IGNORED_ANCESTOR_TAGS | context[:ignored_ancestor_tags]
         else
diff --git a/lib/html/pipeline/filter.rb b/lib/html/pipeline/filter.rb
index ed2fa228..fb0f6747 100644
--- a/lib/html/pipeline/filter.rb
+++ b/lib/html/pipeline/filter.rb
@@ -116,8 +116,8 @@ def parse_html(html)
       # tags - An array of tag name strings to check. These should be downcase.
       #
       # Returns true when the node has a matching ancestor.
-      def has_ancestor?(node, tags)
-        while node = node.parent
+      def has_ancestor?(node, tags) # rubocop:disable Naming/PredicateName
+        while (node = node.parent)
           break true if tags.include?(node.name.downcase)
         end
       end
@@ -156,10 +156,10 @@ def self.to_html(input, context: {})
       def needs(*keys)
         missing = keys.reject { |key| context.include? key }
 
-        if missing.any?
-          raise ArgumentError,
-                "Missing context keys for #{self.class.name}: #{missing.map(&:inspect).join ', '}"
-        end
+        return unless missing.any?
+
+        raise ArgumentError,
+              "Missing context keys for #{self.class.name}: #{missing.map(&:inspect).join ', '}"
       end
     end
   end
diff --git a/lib/html/pipeline/@mention_filter.rb b/lib/html/pipeline/mention_filter.rb
similarity index 100%
rename from lib/html/pipeline/@mention_filter.rb
rename to lib/html/pipeline/mention_filter.rb
diff --git a/lib/html/pipeline/sanitization_filter.rb b/lib/html/pipeline/sanitization_filter.rb
index aac02d69..77b25eca 100644
--- a/lib/html/pipeline/sanitization_filter.rb
+++ b/lib/html/pipeline/sanitization_filter.rb
@@ -119,15 +119,10 @@ def call
         Sanitize.clean_node!(doc, allowlist)
       end
 
-      def whitelist
-        warn "[DEPRECATION] 'whitelist' is deprecated. Please use 'allowlist' instead."
-        allowlist
-      end
-
       # The allowlist to use when sanitizing. This can be passed in the context
       # hash to the filter but defaults to ALLOWLIST constant value above.
       def allowlist
-        allowlist = context[:allowlist] || context[:whitelist] || ALLOWLIST
+        allowlist = context[:allowlist] || ALLOWLIST
         anchor_schemes = context[:anchor_schemes]
         return allowlist unless anchor_schemes
 
diff --git a/lib/html/pipeline/syntax_highlight_filter.rb b/lib/html/pipeline/syntax_highlight_filter.rb
index 9c8f5f25..b8fb74ad 100644
--- a/lib/html/pipeline/syntax_highlight_filter.rb
+++ b/lib/html/pipeline/syntax_highlight_filter.rb
@@ -22,8 +22,8 @@ def initialize(*args)
       def call
         doc.search('pre').each do |node|
           default = context[:highlight]&.to_s
-          next unless lang = node['lang'] || default
-          next unless lexer = lexer_for(lang)
+          next unless (lang = node['lang'] || default)
+          next unless (lexer = lexer_for(lang))
 
           text = node.inner_text
           html = highlight_with_timeout_handling(text, lexer)
diff --git a/lib/html/pipeline/@team_mention_filter.rb b/lib/html/pipeline/team_mention_filter.rb
similarity index 100%
rename from lib/html/pipeline/@team_mention_filter.rb
rename to lib/html/pipeline/team_mention_filter.rb
diff --git a/lib/html/pipeline/toc_filter.rb b/lib/html/pipeline/toc_filter.rb
index dd4b4a52..c310eb26 100644
--- a/lib/html/pipeline/toc_filter.rb
+++ b/lib/html/pipeline/toc_filter.rb
@@ -46,7 +46,7 @@ def call
 
           uniq = (headers[id]).positive? ? "-#{headers[id]}" : ''
           headers[id] += 1
-          if header_content = node.children.first
+          if (header_content = node.children.first)
             result[:toc] << %(<li><a href="##{id}#{uniq}">#{EscapeUtils.escape_html(text)}</a></li>\n)
             header_content.add_previous_sibling(%(<a id="#{id}#{uniq}" class="anchor" href="##{id}#{uniq}" aria-hidden="true">#{anchor_icon}</a>))
           end
diff --git a/test/html/pipeline/mention_filter_test.rb b/test/html/pipeline/mention_filter_test.rb
index 9dae998e..725de371 100644
--- a/test/html/pipeline/mention_filter_test.rb
+++ b/test/html/pipeline/mention_filter_test.rb
@@ -8,9 +8,9 @@ def setup
     @context = { base_url: '/', info_url: nil, username_pattern: nil }
 
     @pipeline = HTML::Pipeline.new([
-                                              HTML::Pipeline::MarkdownFilter,
-                                              HTML::Pipeline::MentionFilter
-                                            ])
+                                     HTML::Pipeline::MarkdownFilter,
+                                     HTML::Pipeline::MentionFilter
+                                   ])
   end
 
   def mentioned_usernames(body) # rubocop:disable Minitest/TestMethodName
@@ -77,7 +77,7 @@ def test_base_url_slash
     body = '<p>Hi, @jch!</p>'
     link = '<a href="/jch" class="user-mention">@jch</a>'
     assert_equal "<p>Hi, #{link}!</p>",
-                 @filter.call(body, context: { base_url: '/'}).to_html
+                 @filter.call(body, context: { base_url: '/' }).to_html
   end
 
   def test_base_url_under_custom_route
@@ -173,7 +173,7 @@ def test_username_pattern_can_be_customized
     body = '<p>@_abc: test.</p>'
     doc  = Nokogiri::HTML::DocumentFragment.parse(body)
 
-    res  = @filter.call(doc, context: { base_url: '/', username_pattern: /(_[a-z]{3})/})
+    res  = @filter.call(doc, context: { base_url: '/', username_pattern: /(_[a-z]{3})/ })
 
     link = '<a href="/_abc" class="user-mention">@_abc</a>'
     assert_equal "<p>#{link}: test.</p>",
@@ -189,7 +189,7 @@ def test_filter_does_not_create_a_new_object_for_default_username_pattern
     @filter.call(doc.clone)
 
     assert_equal pattern_count, HTML::Pipeline::MentionFilter::MENTION_PATTERNS.length
-    @filter.call(doc.clone, context: {username_pattern: /test/})
+    @filter.call(doc.clone, context: { username_pattern: /test/ })
     assert_equal pattern_count + 1, HTML::Pipeline::MentionFilter::MENTION_PATTERNS.length
   end
 
diff --git a/test/html/pipeline/sanitization_filter_test.rb b/test/html/pipeline/sanitization_filter_test.rb
index e16f75b1..643e8c5f 100644
--- a/test/html/pipeline/sanitization_filter_test.rb
+++ b/test/html/pipeline/sanitization_filter_test.rb
@@ -166,18 +166,10 @@ def test_nested_details_tag_are_not_removed
     assert_equal orig, SanitizationFilter.call(orig).to_s
   end
 
-  def test_deprecated_whitelist_context
+  def test_allowlist_context
     orig = %(<p><style>hey now</style></p>)
-    context = { whitelist: ['table'] }
+    context = { allowlist: ['table'] }
 
     assert_equal ['table'], SanitizationFilter.new(orig, context: context).allowlist
   end
-
-  def test_deprecation_warning_whitelist
-    orig = %(<p><style>hey now</style></p>)
-    _stdout, stderror = capture_io do
-      SanitizationFilter.new(orig).whitelist
-    end
-    assert_match "[DEPRECATION] 'whitelist' is deprecated. Please use 'allowlist' instead.", stderror
-  end
 end
diff --git a/test/html/pipeline/team_mention_filter_test.rb b/test/html/pipeline/team_mention_filter_test.rb
index ff396c0d..b034cdd7 100644
--- a/test/html/pipeline/team_mention_filter_test.rb
+++ b/test/html/pipeline/team_mention_filter_test.rb
@@ -47,7 +47,7 @@ def test_not_replacing_mentions_in_pre_tags
 
   def test_not_replacing_mentions_in_code_tags
     body = '<p><code>@github/team:</code> okay</p>'
-    assert_equal body,@filter.call(body).to_html
+    assert_equal body, @filter.call(body).to_html
   end
 
   def test_not_replacing_mentions_in_style_tags
@@ -187,7 +187,7 @@ def test_team_pattern_can_be_customized
     body = '<p>@_abc/XYZ: test</p>'
     doc  = Nokogiri::HTML::DocumentFragment.parse(body)
 
-    res  = @filter.call(doc,context: {team_pattern: %r{@(_[a-z]{3})/([A-Z]{3})}})
+    res  = @filter.call(doc, context: { team_pattern: %r{@(_[a-z]{3})/([A-Z]{3})} })
 
     link = '<a href="/_abc/XYZ" class="team-mention">@_abc/XYZ</a>'
     assert_equal "<p>#{link}: test</p>",
diff --git a/test/html/pipeline/toc_filter_test.rb b/test/html/pipeline/toc_filter_test.rb
index ab56db2a..331a60d4 100644
--- a/test/html/pipeline/toc_filter_test.rb
+++ b/test/html/pipeline/toc_filter_test.rb
@@ -25,7 +25,7 @@ def test_custom_anchor_icons_added_properly
     orig = %(<h1>Ice cube</h1>)
     expected = %(<h1>\n<a id="ice-cube" class="anchor" href="#ice-cube" aria-hidden="true">#</a>Ice cube</h1>)
 
-    assert_equal expected, TocFilter.call(orig, context: {anchor_icon: '#'}).to_s
+    assert_equal expected, TocFilter.call(orig, context: { anchor_icon: '#' }).to_s
   end
 
   def test_toc_list_added_properly
diff --git a/test/html/pipeline_test.rb b/test/html/pipeline_test.rb
index 33917e35..5e7ab535 100644
--- a/test/html/pipeline_test.rb
+++ b/test/html/pipeline_test.rb
@@ -6,7 +6,7 @@
 class HTML::PipelineTest < Minitest::Test
   Pipeline = HTML::Pipeline
   class TestFilter
-    def self.call(input, context: {}, result: {})
+    def self.call(input, context: {}, result: {}) # rubocop:disable Lint/UnusedMethodArgument
       input.reverse
     end
   end
@@ -23,7 +23,7 @@ def test_filter_instrumentation
     @pipeline.instrumentation_service = service
     body = 'hello'
     @pipeline.call(body)
-    event, payload, res = events.pop
+    event, payload, = events.pop
     assert event, 'event expected'
     assert_equal 'call_filter.html_pipeline', event
     assert_equal TestFilter.name, payload[:filter]
@@ -37,7 +37,7 @@ def test_pipeline_instrumentation
     @pipeline.instrumentation_service = service
     body = 'hello'
     @pipeline.call(body)
-    event, payload, res = events.pop
+    event, payload, = events.pop
     assert event, 'event expected'
     assert_equal 'call_pipeline.html_pipeline', event
     assert_equal @pipeline.filters.map(&:name), payload[:filters]
@@ -68,7 +68,7 @@ def test_setup_instrumentation
     body = 'foo'
     @pipeline.call(body)
 
-    event, payload, res = events.pop
+    event, payload, = events.pop
     assert event, 'expected event'
     assert_equal name, payload[:pipeline]
     assert_equal body.reverse, payload[:result][:output]

From 5605e0119ff12bb3e33a2beb40270918935085a9 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 8 Jan 2021 12:26:24 +0000
Subject: [PATCH 18/64] Correct splats/kwargs

---
 lib/html/pipeline/syntax_highlight_filter.rb       | 4 ++--
 test/html/pipeline/emoji_filter_test.rb            | 2 +-
 test/html/pipeline/plain_text_input_filter_test.rb | 6 +++---
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/lib/html/pipeline/syntax_highlight_filter.rb b/lib/html/pipeline/syntax_highlight_filter.rb
index b8fb74ad..7b62ead4 100644
--- a/lib/html/pipeline/syntax_highlight_filter.rb
+++ b/lib/html/pipeline/syntax_highlight_filter.rb
@@ -14,8 +14,8 @@ class Pipeline
     #
     # This filter does not write any additional information to the context hash.
     class SyntaxHighlightFilter < Filter
-      def initialize(*args)
-        super(*args)
+      def initialize(doc, context: {}, result: {})
+        super(doc, context: context, result: result)
         @formatter = Rouge::Formatters::HTML.new
       end
 
diff --git a/test/html/pipeline/emoji_filter_test.rb b/test/html/pipeline/emoji_filter_test.rb
index d6e86722..a893cc1b 100644
--- a/test/html/pipeline/emoji_filter_test.rb
+++ b/test/html/pipeline/emoji_filter_test.rb
@@ -19,7 +19,7 @@ def test_uri_encoding
 
   def test_required_context_validation
     exception = assert_raises(ArgumentError) do
-      EmojiFilter.call('', {})
+      EmojiFilter.call('', context: {})
     end
     assert_match(/:asset_root/, exception.message)
   end
diff --git a/test/html/pipeline/plain_text_input_filter_test.rb b/test/html/pipeline/plain_text_input_filter_test.rb
index c5a8c148..95ac95f8 100644
--- a/test/html/pipeline/plain_text_input_filter_test.rb
+++ b/test/html/pipeline/plain_text_input_filter_test.rb
@@ -8,16 +8,16 @@ class HTML::Pipeline::PlainTextInputFilterTest < Minitest::Test
   def test_fails_when_given_a_documentfragment
     body = '<p>heyo</p>'
     doc  = Nokogiri::HTML::DocumentFragment.parse(body)
-    assert_raises(TypeError) { PlainTextInputFilter.call(doc, {}) }
+    assert_raises(TypeError) { PlainTextInputFilter.call(doc, context: {}) }
   end
 
   def test_wraps_input_in_a_div_element
-    doc = PlainTextInputFilter.call('howdy pahtner', {})
+    doc = PlainTextInputFilter.call('howdy pahtner', context: {})
     assert_equal '<div>howdy pahtner</div>', doc.to_s
   end
 
   def test_html_escapes_plain_text_input
-    doc = PlainTextInputFilter.call('See: <http://example.org>', {})
+    doc = PlainTextInputFilter.call('See: <http://example.org>', context: {})
     assert_equal '<div>See: &lt;http://example.org&gt;</div>',
                  doc.to_s
   end

From c03967a7c41649acef18eb70377f647cae6972e3 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 8 Jan 2021 12:51:31 +0000
Subject: [PATCH 19/64] Allow for multiple dependencies

---
 Gemfile                                   |  3 +--
 lib/html/pipeline.rb                      | 23 +++++++++++++++++++++++
 lib/html/pipeline/emoji_filter.rb         |  2 +-
 test/html/pipeline/require_helper_test.rb | 21 +++++++++++++++++++--
 4 files changed, 44 insertions(+), 5 deletions(-)

diff --git a/Gemfile b/Gemfile
index 310f90b0..a7630ebf 100644
--- a/Gemfile
+++ b/Gemfile
@@ -20,8 +20,7 @@ end
 
 group :test do
   gem 'commonmarker', '~> 0.16', require: false
-  gem 'email_reply_parser', '~> 0.5', require: false
-  gem 'gemoji', '~> 2.0', require: false
+  gem 'gemoji', '~> 3.0', require: false
   gem 'minitest'
   gem 'rinku',              '~> 1.7', require: false
   gem 'sanitize',           '~> 5.2', require: false
diff --git a/lib/html/pipeline.rb b/lib/html/pipeline.rb
index bc1bf85c..72f77d32 100644
--- a/lib/html/pipeline.rb
+++ b/lib/html/pipeline.rb
@@ -54,6 +54,29 @@ def self.require_dependency(name, requirer)
             "Missing dependency '#{name}' for #{requirer}. See README.md for details.\n#{e.class.name}: #{e}"
     end
 
+    def self.require_dependencies(names, requirer)
+      dependency_list = names.dup
+      loaded = false
+      while !loaded && names.length > 1
+        name = names.shift
+        begin
+          require_dependency(name, requirer)
+          loaded = true # we got a dependency
+        # try the next dependency
+        rescue MissingDependencyError # rubocop:disable Lint/SuppressedException
+        end
+      end
+
+      return if loaded
+
+      begin
+        require names.shift
+      rescue LoadError => e
+        raise MissingDependencyError,
+              "Missing all dependencies '#{dependency_list.join(', ')}' for #{requirer}. See README.md for details.\n#{e.class.name}: #{e}"
+      end
+    end
+
     # Our DOM implementation.
     DocumentFragment = Nokogiri::HTML::DocumentFragment
 
diff --git a/lib/html/pipeline/emoji_filter.rb b/lib/html/pipeline/emoji_filter.rb
index 15a2910c..a1828781 100644
--- a/lib/html/pipeline/emoji_filter.rb
+++ b/lib/html/pipeline/emoji_filter.rb
@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require 'cgi'
-HTML::Pipeline.require_dependency('gemoji', 'EmojiFilter')
+HTML::Pipeline.require_dependencies(%w[gemoji gemojione], 'EmojiFilter')
 
 module HTML
   class Pipeline
diff --git a/test/html/pipeline/require_helper_test.rb b/test/html/pipeline/require_helper_test.rb
index e4aeafbc..efada305 100644
--- a/test/html/pipeline/require_helper_test.rb
+++ b/test/html/pipeline/require_helper_test.rb
@@ -3,23 +3,40 @@
 require 'test_helper'
 
 class HTML::Pipeline::RequireHelperTest < Minitest::Test
-  def test_works_with_existing
+  def test_works_with_existing_dependency
     HTML::Pipeline.require_dependency('rake', 'SomeClass')
   end
 
+  def test_works_with_existing_dependencies
+    HTML::Pipeline.require_dependencies(%w[old_sql rake], 'SomeClass')
+  end
+
   def test_raises_mising_dependency_error
     assert_raises HTML::Pipeline::MissingDependencyError do
       HTML::Pipeline.require_dependency('non-existant', 'SomeClass')
     end
   end
 
-  def test_raises_error_including_message
+  def test_raises_mising_dependenccies_error
+    assert_raises HTML::Pipeline::MissingDependencyError do
+      HTML::Pipeline.require_dependencies(%w[non-existant something], 'SomeClass')
+    end
+  end
+
+  def test_raises_dependency_error_including_message
     error = assert_raises(HTML::Pipeline::MissingDependencyError) do
       HTML::Pipeline.require_dependency('non-existant', 'SomeClass')
     end
     assert_includes(error.message, "Missing dependency 'non-existant' for SomeClass. See README.md for details.")
   end
 
+  def test_raises_dependencies_error_including_message
+    error = assert_raises(HTML::Pipeline::MissingDependencyError) do
+      HTML::Pipeline.require_dependencies(%w[non-existant something], 'SomeClass')
+    end
+    assert_includes(error.message, "Missing all dependencies 'non-existant, something' for SomeClass. See README.md for details.")
+  end
+
   def test_raises_error_includes_underlying_message
     error = assert_raises HTML::Pipeline::MissingDependencyError do
       HTML::Pipeline.require_dependency('non-existant', 'SomeClass')

From d0479101adfe3f6c989377c0033faed0b7a599a5 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 8 Jan 2021 15:12:01 +0000
Subject: [PATCH 20/64] Support gemojione

---
 Gemfile                                   |  1 +
 lib/html/pipeline.rb                      | 14 ++++++++++++--
 lib/html/pipeline/emoji_filter.rb         | 15 ++++++++++++---
 test/html/pipeline/emoji_filter_test.rb   | 22 ++++++++++++++++++++++
 test/html/pipeline/require_helper_test.rb |  4 +++-
 5 files changed, 50 insertions(+), 6 deletions(-)

diff --git a/Gemfile b/Gemfile
index a7630ebf..fd497217 100644
--- a/Gemfile
+++ b/Gemfile
@@ -21,6 +21,7 @@ end
 group :test do
   gem 'commonmarker', '~> 0.16', require: false
   gem 'gemoji', '~> 3.0', require: false
+  gem 'gemojione', '~> 4.3', require: false
   gem 'minitest'
   gem 'rinku',              '~> 1.7', require: false
   gem 'sanitize',           '~> 5.2', require: false
diff --git a/lib/html/pipeline.rb b/lib/html/pipeline.rb
index 72f77d32..29345b89 100644
--- a/lib/html/pipeline.rb
+++ b/lib/html/pipeline.rb
@@ -57,26 +57,36 @@ def self.require_dependency(name, requirer)
     def self.require_dependencies(names, requirer)
       dependency_list = names.dup
       loaded = false
+
       while !loaded && names.length > 1
         name = names.shift
+
         begin
           require_dependency(name, requirer)
           loaded = true # we got a dependency
+          define_dependency_loaded_method(name, true)
         # try the next dependency
-        rescue MissingDependencyError # rubocop:disable Lint/SuppressedException
+        rescue MissingDependencyError
+          define_dependency_loaded_method(name, false)
         end
       end
 
       return if loaded
 
       begin
-        require names.shift
+        name = names.shift
+        require name
+        define_dependency_loaded_method(name, true)
       rescue LoadError => e
         raise MissingDependencyError,
               "Missing all dependencies '#{dependency_list.join(', ')}' for #{requirer}. See README.md for details.\n#{e.class.name}: #{e}"
       end
     end
 
+    def self.define_dependency_loaded_method(name, value)
+      self.class.define_method :"#{name}_loaded?", -> { value }
+    end
+
     # Our DOM implementation.
     DocumentFragment = Nokogiri::HTML::DocumentFragment
 
diff --git a/lib/html/pipeline/emoji_filter.rb b/lib/html/pipeline/emoji_filter.rb
index a1828781..24ddefe0 100644
--- a/lib/html/pipeline/emoji_filter.rb
+++ b/lib/html/pipeline/emoji_filter.rb
@@ -41,7 +41,7 @@ def validate
       #
       # Returns a String with :emoji: replaced with images.
       def emoji_image_filter(text)
-        text.gsub(emoji_pattern) do |_match|
+        text.gsub(emoji_pattern) do
           emoji_image_tag(Regexp.last_match(1))
         end
       end
@@ -87,7 +87,11 @@ def self.emoji_pattern
       end
 
       def self.emoji_names
-        Emoji.all.map(&:aliases).flatten.sort
+        if gemoji_loaded?
+          Emoji.all.map(&:aliases)
+        else
+          Gemojione::Index.new.all.map { |i| i[1]['name'] }
+        end.flatten.sort
       end
 
       # Default attributes for img tag
@@ -112,7 +116,12 @@ def self.emoji_names
       end
 
       private def emoji_filename(name)
-        Emoji.find_by_alias(name).image_filename
+        if self.class.gemoji_loaded?
+          Emoji.find_by_alias(name).image_filename
+        else
+          # replace their asset_host with ours
+          Gemojione.image_url_for_name(name).sub(Gemojione.asset_host, '')
+        end
       end
 
       # Return ancestor tags to stop the emojification.
diff --git a/test/html/pipeline/emoji_filter_test.rb b/test/html/pipeline/emoji_filter_test.rb
index a893cc1b..245c4778 100644
--- a/test/html/pipeline/emoji_filter_test.rb
+++ b/test/html/pipeline/emoji_filter_test.rb
@@ -93,4 +93,26 @@ def test_img_attrs_can_accept_symbolized_keys
     doc = filter.call
     assert_equal %(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" draggable="false">), doc.to_html
   end
+
+  def test_works_with_gemoji
+    require 'gemojione'
+
+    EmojiFilter.stub :gemoji_loaded?, false do
+      body = ':flag_ar:'
+      filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com' })
+      doc = filter.call
+      assert_equal %(<img class="emoji" title=":flag_ar:" alt=":flag_ar:" src="https://foo.com/emoji/1f1e6-1f1f7.png" height="20" width="20" align="absmiddle">), doc.to_html
+    end
+  end
+
+  def test_gemoji_can_accept_symbolized_keys
+    require 'gemojione'
+
+    EmojiFilter.stub :gemoji_loaded?, false do
+      body = ':flag_ar:'
+      filter = EmojiFilter.new(body, context: { asset_root: 'https://coolwebsite.com', img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
+      doc = filter.call
+      assert_equal %(<img class="emoji" title=":flag_ar:" alt=":flag_ar:" src="https://coolwebsite.com/emoji/1f1e6-1f1f7.png" draggable="false">), doc.to_html
+    end
+  end
 end
diff --git a/test/html/pipeline/require_helper_test.rb b/test/html/pipeline/require_helper_test.rb
index efada305..2aeaf5f6 100644
--- a/test/html/pipeline/require_helper_test.rb
+++ b/test/html/pipeline/require_helper_test.rb
@@ -8,7 +8,9 @@ def test_works_with_existing_dependency
   end
 
   def test_works_with_existing_dependencies
-    HTML::Pipeline.require_dependencies(%w[old_sql rake], 'SomeClass')
+    HTML::Pipeline.require_dependencies(%w[old_sql nokogiri], 'SomeClass')
+    assert HTML::Pipeline.nokogiri_loaded?
+    refute HTML::Pipeline.old_sql_loaded?
   end
 
   def test_raises_mising_dependency_error

From f13a1534cb650ba17af400d1acd3a22c28004c09 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 8 Jan 2021 15:50:59 +0000
Subject: [PATCH 21/64] Fix instance construction

---
 Gemfile                                 | 11 ++++---
 lib/html/pipeline/emoji_filter.rb       | 10 ++-----
 test/html/pipeline/emoji_filter_test.rb | 39 +++++++++++++------------
 test/test_helper.rb                     |  4 +++
 4 files changed, 32 insertions(+), 32 deletions(-)

diff --git a/Gemfile b/Gemfile
index fd497217..a84e035e 100644
--- a/Gemfile
+++ b/Gemfile
@@ -5,13 +5,11 @@ source 'https://rubygems.org'
 # Specify your gem's dependencies in html-pipeline.gemspec
 gemspec
 
-group :development, :test do
-  gem 'awesome_print'
+gem 'awesome_print'
 
-  gem 'rubocop'
-  gem 'rubocop-performance'
-  gem 'rubocop-standard'
-end
+gem 'rubocop'
+gem 'rubocop-performance'
+gem 'rubocop-standard'
 
 group :development do
   gem 'bundler'
@@ -23,6 +21,7 @@ group :test do
   gem 'gemoji', '~> 3.0', require: false
   gem 'gemojione', '~> 4.3', require: false
   gem 'minitest'
+  gem 'minitest-stub_any_instance'
   gem 'rinku',              '~> 1.7', require: false
   gem 'sanitize',           '~> 5.2', require: false
 
diff --git a/lib/html/pipeline/emoji_filter.rb b/lib/html/pipeline/emoji_filter.rb
index 24ddefe0..8efd080f 100644
--- a/lib/html/pipeline/emoji_filter.rb
+++ b/lib/html/pipeline/emoji_filter.rb
@@ -82,12 +82,12 @@ def asset_path(name)
       end
 
       # Build a regexp that matches all valid :emoji: names.
-      def self.emoji_pattern
+      def emoji_pattern
         @emoji_pattern ||= /:(#{emoji_names.map { |name| Regexp.escape(name) }.join('|')}):/
       end
 
-      def self.emoji_names
-        if gemoji_loaded?
+      def emoji_names
+        if self.class.gemoji_loaded?
           Emoji.all.map(&:aliases)
         else
           Gemojione::Index.new.all.map { |i| i[1]['name'] }
@@ -111,10 +111,6 @@ def self.emoji_names
         File.join(asset_root, asset_path(name))
       end
 
-      private def emoji_pattern
-        self.class.emoji_pattern
-      end
-
       private def emoji_filename(name)
         if self.class.gemoji_loaded?
           Emoji.find_by_alias(name).image_filename
diff --git a/test/html/pipeline/emoji_filter_test.rb b/test/html/pipeline/emoji_filter_test.rb
index 245c4778..3dc4b5c7 100644
--- a/test/html/pipeline/emoji_filter_test.rb
+++ b/test/html/pipeline/emoji_filter_test.rb
@@ -3,78 +3,80 @@
 require 'test_helper'
 
 class HTML::Pipeline::EmojiFilterTest < Minitest::Test
-  EmojiFilter = HTML::Pipeline::EmojiFilter
+  def setup
+    @emoji_filter = HTML::Pipeline::EmojiFilter
+  end
 
   def test_emojify
-    filter = EmojiFilter.new('<p>:shipit:</p>', context: { asset_root: 'https://foo.com' })
+    filter = @emoji_filter.new('<p>:shipit:</p>', context: { asset_root: 'https://foo.com' })
     doc = filter.call
     assert_match 'https://foo.com/emoji/shipit.png', doc.search('img').attr('src').value
   end
 
   def test_uri_encoding
-    filter = EmojiFilter.new('<p>:+1:</p>', context: { asset_root: 'https://foo.com' })
+    filter = @emoji_filter.new('<p>:+1:</p>', context: { asset_root: 'https://foo.com' })
     doc = filter.call
     assert_match 'https://foo.com/emoji/unicode/1f44d.png', doc.search('img').attr('src').value
   end
 
   def test_required_context_validation
     exception = assert_raises(ArgumentError) do
-      EmojiFilter.call('', context: {})
+      @emoji_filter.call('', context: {})
     end
     assert_match(/:asset_root/, exception.message)
   end
 
   def test_custom_asset_path
-    filter = EmojiFilter.new('<p>:+1:</p>', context: { asset_path: ':file_name', asset_root: 'https://foo.com' })
+    filter = @emoji_filter.new('<p>:+1:</p>', context: { asset_path: ':file_name', asset_root: 'https://foo.com' })
     doc = filter.call
     assert_match 'https://foo.com/unicode/1f44d.png', doc.search('img').attr('src').value
   end
 
   def test_not_emojify_in_code_tags
     body = '<code>:shipit:</code>'
-    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com' })
+    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com' })
     doc = filter.call
     assert_equal body, doc.to_html
   end
 
   def test_not_emojify_in_tt_tags
     body = '<tt>:shipit:</tt>'
-    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com' })
+    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com' })
     doc = filter.call
     assert_equal body, doc.to_html
   end
 
   def test_not_emojify_in_pre_tags
     body = '<pre>:shipit:</pre>'
-    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com' })
+    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com' })
     doc = filter.call
     assert_equal body, doc.to_html
   end
 
   def test_not_emojify_in_custom_single_tag_foo
     body = '<foo>:shipit:</foo>'
-    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com', ignored_ancestor_tags: %w[foo] })
+    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com', ignored_ancestor_tags: %w[foo] })
     doc = filter.call
     assert_equal body, doc.to_html
   end
 
   def test_not_emojify_in_custom_multiple_tags_foo_and_bar
     body = '<bar>:shipit:</bar>'
-    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com', ignored_ancestor_tags: %w[foo bar] })
+    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com', ignored_ancestor_tags: %w[foo bar] })
     doc = filter.call
     assert_equal body, doc.to_html
   end
 
   def test_img_tag_attributes
     body = ':shipit:'
-    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com' })
+    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com' })
     doc = filter.call
     assert_equal %(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" height="20" width="20" align="absmiddle">), doc.to_html
   end
 
   def test_img_tag_attributes_can_be_customized
     body = ':shipit:'
-    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com', img_attrs: Hash('draggable' => 'false', 'height' => nil, 'width' => nil, 'align' => nil) })
+    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com', img_attrs: Hash('draggable' => 'false', 'height' => nil, 'width' => nil, 'align' => nil) })
     doc = filter.call
     assert_equal %(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" draggable="false">), doc.to_html
   end
@@ -82,14 +84,14 @@ def test_img_tag_attributes_can_be_customized
   def test_img_attrs_value_can_accept_proclike_object
     remove_colons = ->(name) { name.delete(':') }
     body = ':shipit:'
-    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com', img_attrs: Hash('title' => remove_colons) })
+    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com', img_attrs: Hash('title' => remove_colons) })
     doc = filter.call
     assert_equal %(<img class="emoji" title="shipit" alt=":shipit:" src="https://foo.com/emoji/shipit.png" height="20" width="20" align="absmiddle">), doc.to_html
   end
 
   def test_img_attrs_can_accept_symbolized_keys
     body = ':shipit:'
-    filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com', img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
+    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com', img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
     doc = filter.call
     assert_equal %(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" draggable="false">), doc.to_html
   end
@@ -97,9 +99,9 @@ def test_img_attrs_can_accept_symbolized_keys
   def test_works_with_gemoji
     require 'gemojione'
 
-    EmojiFilter.stub :gemoji_loaded?, false do
+    HTML::Pipeline::EmojiFilter.stub :gemoji_loaded?, false do
       body = ':flag_ar:'
-      filter = EmojiFilter.new(body, context: { asset_root: 'https://foo.com' })
+      filter = HTML::Pipeline::EmojiFilter.new(body, context: { asset_root: 'https://foo.com' })
       doc = filter.call
       assert_equal %(<img class="emoji" title=":flag_ar:" alt=":flag_ar:" src="https://foo.com/emoji/1f1e6-1f1f7.png" height="20" width="20" align="absmiddle">), doc.to_html
     end
@@ -107,10 +109,9 @@ def test_works_with_gemoji
 
   def test_gemoji_can_accept_symbolized_keys
     require 'gemojione'
-
-    EmojiFilter.stub :gemoji_loaded?, false do
+    HTML::Pipeline::EmojiFilter.stub :gemoji_loaded?, false do
       body = ':flag_ar:'
-      filter = EmojiFilter.new(body, context: { asset_root: 'https://coolwebsite.com', img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
+      filter = HTML::Pipeline::EmojiFilter.new(body, context: { asset_root: 'https://coolwebsite.com', img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
       doc = filter.call
       assert_equal %(<img class="emoji" title=":flag_ar:" alt=":flag_ar:" src="https://coolwebsite.com/emoji/1f1e6-1f1f7.png" draggable="false">), doc.to_html
     end
diff --git a/test/test_helper.rb b/test/test_helper.rb
index 0012e181..8abf3639 100644
--- a/test/test_helper.rb
+++ b/test/test_helper.rb
@@ -2,9 +2,13 @@
 
 require 'bundler/setup'
 require 'html/pipeline'
+
 require 'minitest/autorun'
 require 'minitest/pride'
 require 'minitest/focus'
+require 'minitest/stub_any_instance'
+
+require 'awesome_print'
 
 module TestHelpers
   # Asserts that two html fragments are equivalent. Attribute order

From 79b0e21dd6b3df4204966f4af2fe7d1d86103bbb Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 8 Jan 2021 15:55:07 +0000
Subject: [PATCH 22/64] no need

---
 Gemfile             | 1 -
 test/test_helper.rb | 1 -
 2 files changed, 2 deletions(-)

diff --git a/Gemfile b/Gemfile
index a84e035e..6a7df679 100644
--- a/Gemfile
+++ b/Gemfile
@@ -21,7 +21,6 @@ group :test do
   gem 'gemoji', '~> 3.0', require: false
   gem 'gemojione', '~> 4.3', require: false
   gem 'minitest'
-  gem 'minitest-stub_any_instance'
   gem 'rinku',              '~> 1.7', require: false
   gem 'sanitize',           '~> 5.2', require: false
 
diff --git a/test/test_helper.rb b/test/test_helper.rb
index 8abf3639..bea83dea 100644
--- a/test/test_helper.rb
+++ b/test/test_helper.rb
@@ -6,7 +6,6 @@
 require 'minitest/autorun'
 require 'minitest/pride'
 require 'minitest/focus'
-require 'minitest/stub_any_instance'
 
 require 'awesome_print'
 

From ac082b20001f94fdef78365a8153b0c1e38e4d85 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Sat, 4 Jun 2022 08:04:17 -0700
Subject: [PATCH 23/64] Zeitwerk it up

---
 CHANGELOG.md                                  |   2 +-
 CONTRIBUTING.md                               |  16 +-
 Gemfile                                       |  32 +--
 README.md                                     |  40 +--
 Rakefile                                      |  14 +-
 bin/html-pipeline                             |  20 +-
 html-pipeline.gemspec                         |  28 ++-
 lib/html-pipeline.rb                          |   3 +
 lib/html/pipeline.rb                          | 222 -----------------
 lib/html/pipeline/absolute_source_filter.rb   |  49 ----
 lib/html/pipeline/autolink_filter.rb          |  34 ---
 lib/html/pipeline/body_content.rb             |  42 ----
 lib/html/pipeline/emoji_filter.rb             | 135 -----------
 lib/html/pipeline/filter.rb                   | 166 -------------
 lib/html/pipeline/https_filter.rb             |  29 ---
 lib/html/pipeline/image_filter.rb             |  19 --
 lib/html/pipeline/image_max_width_filter.rb   |  37 ---
 lib/html/pipeline/markdown_filter.rb          |  55 -----
 lib/html/pipeline/mention_filter.rb           | 121 ---------
 lib/html/pipeline/plain_text_input_filter.rb  |  15 --
 lib/html/pipeline/sanitization_filter.rb      | 136 -----------
 lib/html/pipeline/syntax_highlight_filter.rb  |  50 ----
 lib/html/pipeline/team_mention_filter.rb      | 101 --------
 lib/html/pipeline/text_filter.rb              |  17 --
 lib/html/pipeline/toc_filter.rb               |  69 ------
 lib/html/pipeline/version.rb                  |   7 -
 lib/html_pipeline.rb                          | 229 ++++++++++++++++++
 lib/html_pipeline/absolute_source_filter.rb   |  47 ++++
 lib/html_pipeline/autolink_filter.rb          |  32 +++
 lib/html_pipeline/body_content.rb             |  40 +++
 lib/html_pipeline/emoji_filter.rb             | 133 ++++++++++
 lib/html_pipeline/filter.rb                   | 164 +++++++++++++
 lib/html_pipeline/https_filter.rb             |  27 +++
 lib/html_pipeline/image_filter.rb             |  17 ++
 lib/html_pipeline/image_max_width_filter.rb   |  35 +++
 lib/html_pipeline/markdown_filter.rb          |  53 ++++
 lib/html_pipeline/mention_filter.rb           | 119 +++++++++
 lib/html_pipeline/plain_text_input_filter.rb  |  13 +
 lib/html_pipeline/sanitization_filter.rb      | 111 +++++++++
 lib/html_pipeline/syntax_highlight_filter.rb  |  48 ++++
 lib/html_pipeline/table_of_contents_filter.rb |  67 +++++
 lib/html_pipeline/team_mention_filter.rb      |  99 ++++++++
 lib/html_pipeline/text_filter.rb              |  15 ++
 lib/html_pipeline/version.rb                  |   5 +
 .../helpers/mocked_instrumentation_service.rb |   2 +-
 .../pipeline/absolute_source_filter_test.rb   |  56 -----
 test/html/pipeline/autolink_filter_test.rb    |  57 -----
 test/html/pipeline/emoji_filter_test.rb       | 119 ---------
 test/html/pipeline/https_filter_test.rb       |  51 ----
 test/html/pipeline/image_filter_test.rb       |  41 ----
 .../pipeline/image_max_width_filter_test.rb   |  52 ----
 test/html/pipeline/markdown_filter_test.rb    | 178 --------------
 test/html/pipeline/mention_filter_test.rb     | 201 ---------------
 .../pipeline/plain_text_input_filter_test.rb  |  24 --
 test/html/pipeline/require_helper_test.rb     |  48 ----
 .../html/pipeline/sanitization_filter_test.rb | 175 -------------
 .../pipeline/syntax_highlight_filter_test.rb  |  65 -----
 .../html/pipeline/team_mention_filter_test.rb | 202 ---------------
 test/html/pipeline/toc_filter_test.rb         | 142 -----------
 test/html/pipeline_test.rb                    |  76 ------
 .../absolute_source_filter_test.rb            |  58 +++++
 test/html_pipeline/autolink_filter_test.rb    |  59 +++++
 test/html_pipeline/emoji_filter_test.rb       | 121 +++++++++
 test/html_pipeline/https_filter_test.rb       |  53 ++++
 test/html_pipeline/image_filter_test.rb       |  43 ++++
 .../image_max_width_filter_test.rb            |  54 +++++
 test/html_pipeline/markdown_filter_test.rb    | 180 ++++++++++++++
 test/html_pipeline/mention_filter_test.rb     | 203 ++++++++++++++++
 .../plain_text_input_filter_test.rb           |  26 ++
 test/html_pipeline/require_helper_test.rb     |  50 ++++
 .../html_pipeline/sanitization_filter_test.rb | 177 ++++++++++++++
 .../syntax_highlight_filter_test.rb           |  72 ++++++
 .../html_pipeline/team_mention_filter_test.rb | 204 ++++++++++++++++
 test/html_pipeline/toc_filter_test.rb         | 144 +++++++++++
 test/html_pipeline_test.rb                    |  76 ++++++
 test/test_helper.rb                           |  18 +-
 76 files changed, 2864 insertions(+), 2876 deletions(-)
 create mode 100644 lib/html-pipeline.rb
 delete mode 100644 lib/html/pipeline.rb
 delete mode 100644 lib/html/pipeline/absolute_source_filter.rb
 delete mode 100644 lib/html/pipeline/autolink_filter.rb
 delete mode 100644 lib/html/pipeline/body_content.rb
 delete mode 100644 lib/html/pipeline/emoji_filter.rb
 delete mode 100644 lib/html/pipeline/filter.rb
 delete mode 100644 lib/html/pipeline/https_filter.rb
 delete mode 100644 lib/html/pipeline/image_filter.rb
 delete mode 100644 lib/html/pipeline/image_max_width_filter.rb
 delete mode 100644 lib/html/pipeline/markdown_filter.rb
 delete mode 100644 lib/html/pipeline/mention_filter.rb
 delete mode 100644 lib/html/pipeline/plain_text_input_filter.rb
 delete mode 100644 lib/html/pipeline/sanitization_filter.rb
 delete mode 100644 lib/html/pipeline/syntax_highlight_filter.rb
 delete mode 100644 lib/html/pipeline/team_mention_filter.rb
 delete mode 100644 lib/html/pipeline/text_filter.rb
 delete mode 100644 lib/html/pipeline/toc_filter.rb
 delete mode 100644 lib/html/pipeline/version.rb
 create mode 100644 lib/html_pipeline.rb
 create mode 100644 lib/html_pipeline/absolute_source_filter.rb
 create mode 100644 lib/html_pipeline/autolink_filter.rb
 create mode 100644 lib/html_pipeline/body_content.rb
 create mode 100644 lib/html_pipeline/emoji_filter.rb
 create mode 100644 lib/html_pipeline/filter.rb
 create mode 100644 lib/html_pipeline/https_filter.rb
 create mode 100644 lib/html_pipeline/image_filter.rb
 create mode 100644 lib/html_pipeline/image_max_width_filter.rb
 create mode 100644 lib/html_pipeline/markdown_filter.rb
 create mode 100644 lib/html_pipeline/mention_filter.rb
 create mode 100644 lib/html_pipeline/plain_text_input_filter.rb
 create mode 100644 lib/html_pipeline/sanitization_filter.rb
 create mode 100644 lib/html_pipeline/syntax_highlight_filter.rb
 create mode 100644 lib/html_pipeline/table_of_contents_filter.rb
 create mode 100644 lib/html_pipeline/team_mention_filter.rb
 create mode 100644 lib/html_pipeline/text_filter.rb
 create mode 100644 lib/html_pipeline/version.rb
 delete mode 100644 test/html/pipeline/absolute_source_filter_test.rb
 delete mode 100644 test/html/pipeline/autolink_filter_test.rb
 delete mode 100644 test/html/pipeline/emoji_filter_test.rb
 delete mode 100644 test/html/pipeline/https_filter_test.rb
 delete mode 100644 test/html/pipeline/image_filter_test.rb
 delete mode 100644 test/html/pipeline/image_max_width_filter_test.rb
 delete mode 100644 test/html/pipeline/markdown_filter_test.rb
 delete mode 100644 test/html/pipeline/mention_filter_test.rb
 delete mode 100644 test/html/pipeline/plain_text_input_filter_test.rb
 delete mode 100644 test/html/pipeline/require_helper_test.rb
 delete mode 100644 test/html/pipeline/sanitization_filter_test.rb
 delete mode 100644 test/html/pipeline/syntax_highlight_filter_test.rb
 delete mode 100644 test/html/pipeline/team_mention_filter_test.rb
 delete mode 100644 test/html/pipeline/toc_filter_test.rb
 delete mode 100644 test/html/pipeline_test.rb
 create mode 100644 test/html_pipeline/absolute_source_filter_test.rb
 create mode 100644 test/html_pipeline/autolink_filter_test.rb
 create mode 100644 test/html_pipeline/emoji_filter_test.rb
 create mode 100644 test/html_pipeline/https_filter_test.rb
 create mode 100644 test/html_pipeline/image_filter_test.rb
 create mode 100644 test/html_pipeline/image_max_width_filter_test.rb
 create mode 100644 test/html_pipeline/markdown_filter_test.rb
 create mode 100644 test/html_pipeline/mention_filter_test.rb
 create mode 100644 test/html_pipeline/plain_text_input_filter_test.rb
 create mode 100644 test/html_pipeline/require_helper_test.rb
 create mode 100644 test/html_pipeline/sanitization_filter_test.rb
 create mode 100644 test/html_pipeline/syntax_highlight_filter_test.rb
 create mode 100644 test/html_pipeline/team_mention_filter_test.rb
 create mode 100644 test/html_pipeline/toc_filter_test.rb
 create mode 100644 test/html_pipeline_test.rb

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 50017db1..ae7dfdd6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -48,7 +48,7 @@
 
 ## 2.8.4
 
-  * Freeze all elements in HTML::Pipeline::SanitizationFilter [#299](https://github.com/jch/html-pipeline/pull/299)
+  * Freeze all elements in HTMLPipeline::SanitizationFilter [#299](https://github.com/jch/html-pipeline/pull/299)
 
 ## 2.8.3
 
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 5f66206d..fb3a8e60 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,19 +1,19 @@
 # Contributing
 
-Thanks for using and improving `HTML::Pipeline`!
+Thanks for using and improving `HTMLPipeline`!
 
 - [Submitting a New Issue](#submitting-a-new-issue)
 - [Sending a Pull Request](#sending-a-pull-request)
 
 ## Submitting a New Issue
 
-If there's an idea you'd like to propose, or a design change, feel free to file a new issue. 
+If there's an idea you'd like to propose, or a design change, feel free to file a new issue.
 
 If you have an implementation question or believe you've found a bug, please provide as many details as possible:
 
 - Input document
 - Output HTML document
-- the exact `HTML::Pipeline` code you are using
+- the exact `HTMLPipeline` code you are using
 - output of the following from your project
 
 ```
@@ -41,17 +41,17 @@ To run a specific test file:
 
 To run a specific test:
 
-  `bundle exec ruby -Itest test/html/pipeline/markdown_filter_test.rb -n test_disabling_gfm`  
+  `bundle exec ruby -Itest test/html/pipeline/markdown_filter_test.rb -n test_disabling_gfm`
 
 To run the full suite with all [supported rubies][travisyaml] in bash:
 
 ```bash
 rubies=(ree-1.8.7-2011.03 1.9.2-p290 1.9.3-p429 2.0.0-p247)
-for r in ${rubies[*]} 
-do 
+for r in ${rubies[*]}
+do
   rbenv local $r # switch to your version manager of choice
-  bundle install 
-  bundle exec rake 
+  bundle install
+  bundle exec rake
 done
 ```
 
diff --git a/Gemfile b/Gemfile
index 6a7df679..4ac968e3 100644
--- a/Gemfile
+++ b/Gemfile
@@ -1,30 +1,30 @@
 # frozen_string_literal: true
 
-source 'https://rubygems.org'
+source "https://rubygems.org"
 
 # Specify your gem's dependencies in html-pipeline.gemspec
 gemspec
 
-gem 'awesome_print'
+gem "awesome_print"
 
-gem 'rubocop'
-gem 'rubocop-performance'
-gem 'rubocop-standard'
+gem "rubocop"
+gem "rubocop-performance"
+gem "rubocop-standard"
 
 group :development do
-  gem 'bundler'
-  gem 'rake'
+  gem "bundler"
+  gem "rake"
 end
 
 group :test do
-  gem 'commonmarker', '~> 0.16', require: false
-  gem 'gemoji', '~> 3.0', require: false
-  gem 'gemojione', '~> 4.3', require: false
-  gem 'minitest'
-  gem 'rinku',              '~> 1.7', require: false
-  gem 'sanitize',           '~> 5.2', require: false
+  gem "commonmarker", "~> 0.16", require: false
+  gem "gemoji", "~> 3.0", require: false
+  gem "gemojione", "~> 4.3", require: false
+  gem "minitest"
+  gem "rinku",              "~> 1.7", require: false
+  gem "sanitize",           "~> 5.2", require: false
 
-  gem 'escape_utils', '~> 1.0', require: false
-  gem 'minitest-focus', '~> 1.1'
-  gem 'rouge', '~> 3.1', require: false
+  gem "escape_utils", "~> 1.0", require: false
+  gem "minitest-focus", "~> 1.1"
+  gem "rouge", "~> 3.1", require: false
 end
diff --git a/README.md b/README.md
index e2df0455..f4fce739 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# HTML::Pipeline [![Build Status](https://travis-ci.org/jch/html-pipeline.svg?branch=master)](https://travis-ci.org/jch/html-pipeline)
+# HTMLPipeline [![Build Status](https://travis-ci.org/jch/html-pipeline.svg?branch=master)](https://travis-ci.org/jch/html-pipeline)
 
 HTML processing filters and utilities. This module includes a small
 framework for defining DOM based content filters and applying them to user
@@ -51,7 +51,7 @@ For example, to transform Markdown source into Markdown HTML:
 ```ruby
 require 'html/pipeline'
 
-filter = HTML::Pipeline::MarkdownFilter.new("Hi **world**!")
+filter = HTMLPipeline::MarkdownFilter.new("Hi **world**!")
 filter.call
 ```
 
@@ -61,9 +61,9 @@ filtered through Markdown and be syntax highlighted, you can create the
 following pipeline:
 
 ```ruby
-pipeline = HTML::Pipeline.new [
-  HTML::Pipeline::MarkdownFilter,
-  HTML::Pipeline::SyntaxHighlightFilter
+pipeline = HTMLPipeline.new [
+  HTMLPipeline::MarkdownFilter,
+  HTMLPipeline::SyntaxHighlightFilter
 ]
 result = pipeline.call <<-CODE
 This is *great*:
@@ -91,7 +91,7 @@ example, if you don't want to use GitHub formatted Markdown, you can pass an
 option in the context hash:
 
 ```ruby
-filter = HTML::Pipeline::MarkdownFilter.new("Hi **world**!", :gfm => false)
+filter = HTMLPipeline::MarkdownFilter.new("Hi **world**!", :gfm => false)
 filter.call
 ```
 
@@ -192,14 +192,14 @@ Full reference documentation can be [found here](http://rubydoc.info/gems/html-p
 
 ## Extending
 To write a custom filter, you need a class with a `call` method that inherits
-from `HTML::Pipeline::Filter`.
+from `HTMLPipeline::Filter`.
 
 For example this filter adds a base url to images that are root relative:
 
 ```ruby
 require 'uri'
 
-class RootRelativeFilter < HTML::Pipeline::Filter
+class RootRelativeFilter < HTMLPipeline::Filter
 
   def call
     doc.search("img").each do |img|
@@ -238,16 +238,16 @@ Here are some extensions people have built:
 * [tilt-html-pipeline](https://github.com/bradgessler/tilt-html-pipeline)
 * [html-pipeline-wiki-link'](https://github.com/lifted-studios/html-pipeline-wiki-link) - WikiMedia-style wiki links
 * [task_list](https://github.com/github/task_list) - GitHub flavor Markdown Task List
-* [html-pipeline-nico_link](https://github.com/rutan/html-pipeline-nico_link) - An HTML::Pipeline filter for [niconico](http://www.nicovideo.jp) description links
+* [html-pipeline-nico_link](https://github.com/rutan/html-pipeline-nico_link) - An HTMLPipeline filter for [niconico](http://www.nicovideo.jp) description links
 * [html-pipeline-gitlab](https://gitlab.com/gitlab-org/html-pipeline-gitlab) - This gem implements various filters for html-pipeline used by GitLab
-* [html-pipeline-youtube](https://github.com/st0012/html-pipeline-youtube) - An HTML::Pipeline filter for YouTube links
-* [html-pipeline-flickr](https://github.com/st0012/html-pipeline-flickr) - An HTML::Pipeline filter for Flickr links
-* [html-pipeline-vimeo](https://github.com/dlackty/html-pipeline-vimeo) - An HTML::Pipeline filter for Vimeo links
-* [html-pipeline-hashtag](https://github.com/mr-dxdy/html-pipeline-hashtag) - An HTML::Pipeline filter for hashtags
-* [html-pipeline-linkify_github](https://github.com/jollygoodcode/html-pipeline-linkify_github) - An HTML::Pipeline filter to autolink GitHub urls
+* [html-pipeline-youtube](https://github.com/st0012/html-pipeline-youtube) - An HTMLPipeline filter for YouTube links
+* [html-pipeline-flickr](https://github.com/st0012/html-pipeline-flickr) - An HTMLPipeline filter for Flickr links
+* [html-pipeline-vimeo](https://github.com/dlackty/html-pipeline-vimeo) - An HTMLPipeline filter for Vimeo links
+* [html-pipeline-hashtag](https://github.com/mr-dxdy/html-pipeline-hashtag) - An HTMLPipeline filter for hashtags
+* [html-pipeline-linkify_github](https://github.com/jollygoodcode/html-pipeline-linkify_github) - An HTMLPipeline filter to autolink GitHub urls
 * [html-pipeline-redcarpet_filter](https://github.com/bmikol/html-pipeline-redcarpet_filter) - Render Markdown source text into Markdown HTML using Redcarpet
-* [html-pipeline-typogruby_filter](https://github.com/bmikol/html-pipeline-typogruby_filter) - Add Typogruby text filters to your HTML::Pipeline
-* [korgi](https://github.com/jodeci/korgi) - HTML::Pipeline filters for links to Rails resources
+* [html-pipeline-typogruby_filter](https://github.com/bmikol/html-pipeline-typogruby_filter) - Add Typogruby text filters to your HTMLPipeline
+* [korgi](https://github.com/jodeci/korgi) - HTMLPipeline filters for links to Rails resources
 
 
 ## Instrumenting
@@ -256,19 +256,19 @@ Filters and Pipelines can be set up to be instrumented when called. The pipeline
 must be setup with an
 [ActiveSupport::Notifications](http://api.rubyonrails.org/classes/ActiveSupport/Notifications.html)
 compatible service object and a name. New pipeline objects will default to the
-`HTML::Pipeline.default_instrumentation_service` object.
+`HTMLPipeline.default_instrumentation_service` object.
 
 ``` ruby
 # the AS::Notifications-compatible service object
 service = ActiveSupport::Notifications
 
 # instrument a specific pipeline
-pipeline = HTML::Pipeline.new [MarkdownFilter], context
+pipeline = HTMLPipeline.new [MarkdownFilter], context
 pipeline.setup_instrumentation "MarkdownPipeline", service
 
 # or set default instrumentation service for all new pipelines
-HTML::Pipeline.default_instrumentation_service = service
-pipeline = HTML::Pipeline.new [MarkdownFilter], context
+HTMLPipeline.default_instrumentation_service = service
+pipeline = HTMLPipeline.new [MarkdownFilter], context
 pipeline.setup_instrumentation "MarkdownPipeline"
 ```
 
diff --git a/Rakefile b/Rakefile
index cc4508a3..fe0a93cc 100755
--- a/Rakefile
+++ b/Rakefile
@@ -1,21 +1,21 @@
 #!/usr/bin/env rake
 # frozen_string_literal: true
 
-require 'rubygems'
-require 'bundler/setup'
+require "rubygems"
+require "bundler/setup"
 
-require 'bundler/gem_tasks'
-require 'rake/testtask'
+require "bundler/gem_tasks"
+require "rake/testtask"
 
 Rake::TestTask.new do |t|
-  t.libs << 'test'
-  t.test_files = FileList['test/**/*_test.rb']
+  t.libs << "test"
+  t.test_files = FileList["test/**/*_test.rb"]
   t.verbose = true
   t.warning = false
 end
 
 task default: :test
 
-require 'rubocop/rake_task'
+require "rubocop/rake_task"
 
 RuboCop::RakeTask.new(:rubocop)
diff --git a/bin/html-pipeline b/bin/html-pipeline
index f262ac6b..536f84a3 100755
--- a/bin/html-pipeline
+++ b/bin/html-pipeline
@@ -16,7 +16,7 @@ onParser.new do |opts|
  opts.separator 'Options:'
 
   opts.on('-f', '--filters', 'List the available filters') do
-    filters = HTML::Pipeline.constants.grep(/\w+Filter$/)
+    filters = HTMLPipeline.constants.grep(/\w+Filter$/)
                             .map { |f| f.to_s.gsub(/Filter$/, '') }
 
     # Text filter doesn't work, no call method
@@ -33,18 +33,18 @@ end.parse!
 if ARGV.empty?
 
   filters = [
-    HTML::Pipeline::MarkdownFilter,
-    HTML::Pipeline::SanitizationFilter,
-    HTML::Pipeline::ImageMaxWidthFilter,
-    HTML::Pipeline::EmojiFilter,
-    HTML::Pipeline::AutolinkFilter,
-    HTML::Pipeline::TableOfContentsFilter
+    HTMLPipeline::MarkdownFilter,
+    HTMLPipeline::SanitizationFilter,
+    HTMLPipeline::ImageMaxWidthFilter,
+    HTMLPipeline::EmojiFilter,
+    HTMLPipeline::AutolinkFilter,
+    HTMLPipeline::TableOfContentsFilter
   ]
 
   # Add syntax highlighting if rouge is present
   begin
     require 'rouge'
-    filters << HTML::Pipeline::SyntaxHighlightFilter
+    filters << HTMLPipeline::SyntaxHighlightFilter
   rescue LoadError
   end
 
@@ -56,7 +56,7 @@ else
       raise NameError # Text filter doesn't work, no call method
     end
 
-    HTML::Pipeline.const_get("#{name}Filter")
+    HTMLPipeline.const_get("#{name}Filter")
   rescue NameError => e
     abort "Unknown filter '#{name}'. List filters with the -f option."
   end
@@ -75,4 +75,4 @@ context = {
   gfm: true
 }
 
-puts HTML::Pipeline.new(filters, context).call(ARGF.read)[:output]
+puts HTMLPipeline.new(filters, context).call(ARGF.read)[:output]
diff --git a/html-pipeline.gemspec b/html-pipeline.gemspec
index cf8dccb6..028db6bd 100644
--- a/html-pipeline.gemspec
+++ b/html-pipeline.gemspec
@@ -1,23 +1,25 @@
 # frozen_string_literal: true
 
-require File.expand_path('lib/html/pipeline/version', __dir__)
+$LOAD_PATH.push(File.expand_path("lib", __dir__))
+require "html_pipeline/version"
 
 Gem::Specification.new do |gem|
-  gem.name          = 'html-pipeline'
-  gem.version       = HTML::Pipeline::VERSION
-  gem.license       = 'MIT'
-  gem.authors       = ['Ryan Tomayko', 'Jerry Cheung', 'Garen J. Torikian']
-  gem.email         = ['ryan@github.com', 'jerry@github.com', 'gjtorikian@gmail.com']
-  gem.description   = 'HTML processing filters and utilities'
-  gem.summary       = 'Helpers for processing content through a chain of filters'
-  gem.homepage      = 'https://github.com/jch/html-pipeline'
+  gem.name          = "html-pipeline"
+  gem.version       = HTMLPipeline::VERSION
+  gem.license       = "MIT"
+  gem.authors       = ["Garen J. Torikian"]
+  gem.email         = ["gjtorikian@gmail.com"]
+  gem.description   = "HTML processing filters and utilities"
+  gem.summary       = "Helpers for processing content through a chain of filters"
+  gem.homepage      = "https://github.com/jch/html-pipeline"
 
-  gem.files         = `git ls-files -z`.split("\x0").reject { |f| f =~ %r{^(test|gemfiles|script)/} }
-  gem.require_paths = ['lib']
+  gem.files         = %x(git ls-files -z).split("\x0").reject { |f| f =~ %r{^(test|gemfiles|script)/} }
+  gem.require_paths = ["lib"]
 
-  gem.required_ruby_version = ['>= 2.5.8', '< 4.0']
+  gem.required_ruby_version = [">= 2.5.8", "< 4.0"]
 
-  gem.add_dependency 'nokogiri', '~> 1.11'
+  gem.add_dependency("nokogiri", "~> 1.11")
+  gem.add_dependency("zeitwerk", "~> 2.5")
 
   gem.post_install_message = <<~MSG
     -------------------------------------------------
diff --git a/lib/html-pipeline.rb b/lib/html-pipeline.rb
new file mode 100644
index 00000000..75ee89e4
--- /dev/null
+++ b/lib/html-pipeline.rb
@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "html_proofer"
diff --git a/lib/html/pipeline.rb b/lib/html/pipeline.rb
deleted file mode 100644
index 29345b89..00000000
--- a/lib/html/pipeline.rb
+++ /dev/null
@@ -1,222 +0,0 @@
-# frozen_string_literal: true
-
-require 'nokogiri'
-
-module HTML
-  # GitHub HTML processing filters and utilities. This module includes a small
-  # framework for defining DOM based content filters and applying them to user
-  # provided content.
-  #
-  # See HTML::Pipeline::Filter for information on building filters.
-  #
-  # Construct a Pipeline for running multiple HTML filters.  A pipeline is created once
-  # with one to many filters, and it then can be `call`ed many times over the course
-  # of its lifetime with input.
-  #
-  # filters         - Array of Filter objects. Each must respond to call(doc,
-  #                   context) and return the modified DocumentFragment or a
-  #                   String containing HTML markup. Filters are performed in the
-  #                   order provided.
-  # default_context - The default context hash. Values specified here will be merged
-  #                   into values from the each individual pipeline run.  Can NOT be
-  #                   nil.  Default: empty Hash.
-  # result_class    - The default Class of the result object for individual
-  #                   calls.  Default: Hash.  Protip:  Pass in a Struct to get
-  #                   some semblance of type safety.
-  class Pipeline
-    autoload :VERSION,               'html/pipeline/version'
-    autoload :Filter,                'html/pipeline/filter'
-    autoload :AbsoluteSourceFilter,  'html/pipeline/absolute_source_filter'
-    autoload :BodyContent,           'html/pipeline/body_content'
-    autoload :AutolinkFilter,        'html/pipeline/autolink_filter'
-    autoload :CamoFilter,            'html/pipeline/camo_filter'
-    autoload :EmailReplyFilter,      'html/pipeline/email_reply_filter'
-    autoload :EmojiFilter,           'html/pipeline/emoji_filter'
-    autoload :HttpsFilter,           'html/pipeline/https_filter'
-    autoload :ImageFilter,           'html/pipeline/image_filter'
-    autoload :ImageMaxWidthFilter,   'html/pipeline/image_max_width_filter'
-    autoload :MarkdownFilter,        'html/pipeline/markdown_filter'
-    autoload :MentionFilter,         'html/pipeline/mention_filter'
-    autoload :TeamMentionFilter,     'html/pipeline/team_mention_filter'
-    autoload :PlainTextInputFilter,  'html/pipeline/plain_text_input_filter'
-    autoload :SanitizationFilter,    'html/pipeline/sanitization_filter'
-    autoload :SyntaxHighlightFilter, 'html/pipeline/syntax_highlight_filter'
-    autoload :TextileFilter,         'html/pipeline/textile_filter'
-    autoload :TableOfContentsFilter, 'html/pipeline/toc_filter'
-    autoload :TextFilter,            'html/pipeline/text_filter'
-
-    class MissingDependencyError < RuntimeError; end
-
-    def self.require_dependency(name, requirer)
-      require name
-    rescue LoadError => e
-      raise MissingDependencyError,
-            "Missing dependency '#{name}' for #{requirer}. See README.md for details.\n#{e.class.name}: #{e}"
-    end
-
-    def self.require_dependencies(names, requirer)
-      dependency_list = names.dup
-      loaded = false
-
-      while !loaded && names.length > 1
-        name = names.shift
-
-        begin
-          require_dependency(name, requirer)
-          loaded = true # we got a dependency
-          define_dependency_loaded_method(name, true)
-        # try the next dependency
-        rescue MissingDependencyError
-          define_dependency_loaded_method(name, false)
-        end
-      end
-
-      return if loaded
-
-      begin
-        name = names.shift
-        require name
-        define_dependency_loaded_method(name, true)
-      rescue LoadError => e
-        raise MissingDependencyError,
-              "Missing all dependencies '#{dependency_list.join(', ')}' for #{requirer}. See README.md for details.\n#{e.class.name}: #{e}"
-      end
-    end
-
-    def self.define_dependency_loaded_method(name, value)
-      self.class.define_method :"#{name}_loaded?", -> { value }
-    end
-
-    # Our DOM implementation.
-    DocumentFragment = Nokogiri::HTML::DocumentFragment
-
-    # Parse a String into a DocumentFragment object. When a DocumentFragment is
-    # provided, return it verbatim.
-    def self.parse(document_or_html)
-      document_or_html ||= ''
-      if document_or_html.is_a?(String)
-        DocumentFragment.parse(document_or_html)
-      else
-        document_or_html
-      end
-    end
-
-    # Public: Returns an Array of Filter objects for this Pipeline.
-    attr_reader :filters
-
-    # Public: Instrumentation service for the pipeline.
-    # Set an ActiveSupport::Notifications compatible object to enable.
-    attr_accessor :instrumentation_service
-
-    # Public: String name for this Pipeline. Defaults to Class name.
-    attr_writer :instrumentation_name
-
-    def instrumentation_name
-      return @instrumentation_name if defined?(@instrumentation_name)
-
-      @instrumentation_name = self.class.name
-    end
-
-    class << self
-      # Public: Default instrumentation service for new pipeline objects.
-      attr_accessor :default_instrumentation_service
-    end
-
-    def initialize(filters, default_context: {}, result_class: Hash)
-      raise ArgumentError, 'default_context cannot be nil' if default_context.nil?
-
-      @filters = filters.flatten.freeze
-      @default_context = default_context.freeze
-      @result_class = result_class
-      @instrumentation_service = self.class.default_instrumentation_service
-    end
-
-    # Apply all filters in the pipeline to the given HTML.
-    #
-    # html    - A String containing HTML or a DocumentFragment object.
-    # context - The context hash passed to each filter. See the Filter docs
-    #           for more info on possible values. This object MUST NOT be modified
-    #           in place by filters.  Use the Result for passing state back.
-    # result  - The result Hash passed to each filter for modification.  This
-    #           is where Filters store extracted information from the content.
-    #
-    # Returns the result Hash after being filtered by this Pipeline.  Contains an
-    # :output key with the DocumentFragment or String HTML markup based on the
-    # output of the last filter in the pipeline.
-    def call(html, context: {}, result: {})
-      context = @default_context.merge(context)
-      context = context.freeze
-      result ||= @result_class.new
-      payload = default_payload({ filters: @filters.map(&:name),
-                                  context: context, result: result })
-      instrument 'call_pipeline.html_pipeline', payload do
-        result[:output] =
-          @filters.inject(html) do |doc, filter|
-            perform_filter(filter, doc, context: context, result: result)
-          end
-      end
-      result
-    end
-
-    # Internal: Applies a specific filter to the supplied doc.
-    #
-    # The filter is instrumented.
-    #
-    # Returns the result of the filter.
-    def perform_filter(filter, doc, context: {}, result: {})
-      payload = default_payload({ filter: filter.name,
-                                  context: context, result: result })
-      instrument 'call_filter.html_pipeline', payload do
-        filter.call(doc, context: context, result: result)
-      end
-    end
-
-    # Like call but guarantee the value returned is a DocumentFragment.
-    # Pipelines may return a DocumentFragment or a String. Callers that need a
-    # DocumentFragment should use this method.
-    def to_document(input, context: {}, result: {})
-      result = call(input, context: context, result: result)
-      HTML::Pipeline.parse(result[:output])
-    end
-
-    # Like call but guarantee the value returned is a string of HTML markup.
-    def to_html(input, context: {}, result: {})
-      result = call(input, context: context, result: result)
-      output = result[:output]
-      if output.respond_to?(:to_html)
-        output.to_html
-      else
-        output.to_s
-      end
-    end
-
-    # Public: setup instrumentation for this pipeline.
-    #
-    # Returns nothing.
-    def setup_instrumentation(name, service: nil)
-      self.instrumentation_name = name
-      self.instrumentation_service =
-        service || self.class.default_instrumentation_service
-    end
-
-    # Internal: if the `instrumentation_service` object is set, instruments the
-    # block, otherwise the block is ran without instrumentation.
-    #
-    # Returns the result of the provided block.
-    def instrument(event, payload = {}, &block)
-      payload ||= default_payload
-      return yield(payload) unless instrumentation_service
-
-      instrumentation_service.instrument event, payload, &block
-    end
-
-    # Internal: Default payload for instrumentation.
-    #
-    # Accepts a Hash of additional payload data to be merged.
-    #
-    # Returns a Hash.
-    def default_payload(payload = {})
-      { pipeline: instrumentation_name }.merge(payload)
-    end
-  end
-end
diff --git a/lib/html/pipeline/absolute_source_filter.rb b/lib/html/pipeline/absolute_source_filter.rb
deleted file mode 100644
index 7385d03a..00000000
--- a/lib/html/pipeline/absolute_source_filter.rb
+++ /dev/null
@@ -1,49 +0,0 @@
-# frozen_string_literal: true
-
-require 'uri'
-
-module HTML
-  class Pipeline
-    class AbsoluteSourceFilter < Filter
-      # HTML Filter for replacing relative and root relative image URLs with
-      # fully qualified URLs
-      #
-      # This is useful if an image is root relative but should really be going
-      # through a cdn, or if the content for the page assumes the host is known
-      # i.e. scraped webpages and some RSS feeds.
-      #
-      # Context options:
-      #   :image_base_url - Base URL for image host for root relative src.
-      #   :image_subpage_url - For relative src.
-      #
-      # This filter does not write additional information to the context.
-      # This filter would need to be run before CamoFilter.
-      def call
-        doc.search('img').each do |element|
-          next if element['src'].nil? || element['src'].empty?
-
-          src = element['src'].strip
-          next if src.start_with? 'http'
-
-          base = if src.start_with? '/'
-                   image_base_url
-                 else
-                   image_subpage_url
-                 end
-          element['src'] = URI.join(base, src).to_s
-        end
-        doc
-      end
-
-      # Private: the base url you want to use
-      def image_base_url
-        context[:image_base_url] || raise("Missing context :image_base_url for #{self.class.name}")
-      end
-
-      # Private: the relative url you want to use
-      def image_subpage_url
-        context[:image_subpage_url] || raise("Missing context :image_subpage_url for #{self.class.name}")
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/autolink_filter.rb b/lib/html/pipeline/autolink_filter.rb
deleted file mode 100644
index f2facdfd..00000000
--- a/lib/html/pipeline/autolink_filter.rb
+++ /dev/null
@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-HTML::Pipeline.require_dependency('rinku', 'AutolinkFilter')
-
-module HTML
-  class Pipeline
-    # HTML Filter for auto_linking urls in HTML.
-    #
-    # Context options:
-    #   :autolink  - boolean whether to autolink urls
-    #   :link_mode - :all, :urls or :email_addresses
-    #   :link_attr - HTML attributes for the link that will be generated
-    #   :skip_tags - HTML tags inside which autolinking will be skipped.
-    #                See Rinku.skip_tags
-    #   :flags     - additional Rinku flags. See https://github.com/vmg/rinku
-    #
-    # This filter does not write additional information to the context.
-    class AutolinkFilter < Filter
-      def call
-        return html if context[:autolink] == false
-
-        skip_tags = context[:skip_tags]
-        flags = 0
-        flags |= context[:flags] if context[:flags]
-
-        Rinku.auto_link(html, link_mode, context[:link_attr], skip_tags, flags)
-      end
-
-      def link_mode
-        context[:link_mode] || :urls
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/body_content.rb b/lib/html/pipeline/body_content.rb
deleted file mode 100644
index ead3f5ea..00000000
--- a/lib/html/pipeline/body_content.rb
+++ /dev/null
@@ -1,42 +0,0 @@
-# frozen_string_literal: true
-
-module HTML
-  class Pipeline
-    # Public: Runs a String of content through an HTML processing pipeline,
-    # providing easy access to a generated DocumentFragment.
-    class BodyContent
-      # Public: Initialize a BodyContent.
-      #
-      # body     - A String body.
-      # context  - A Hash of context options for the filters.
-      # pipeline - A HTML::Pipeline object with one or more Filters.
-      def initialize(body, context, pipeline)
-        @body = body
-        @context = context
-        @pipeline = pipeline
-      end
-
-      # Public: Gets the memoized result of the body content as it passed through
-      # the Pipeline.
-      #
-      # Returns a Hash, or something similar as defined by @pipeline.result_class.
-      def result
-        @result ||= @pipeline.call @body, @context
-      end
-
-      # Public: Gets the updated body from the Pipeline result.
-      #
-      # Returns a String or DocumentFragment.
-      def output
-        @output ||= result[:output]
-      end
-
-      # Public: Parses the output into a DocumentFragment.
-      #
-      # Returns a DocumentFragment.
-      def document
-        @document ||= HTML::Pipeline.parse output
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/emoji_filter.rb b/lib/html/pipeline/emoji_filter.rb
deleted file mode 100644
index 8efd080f..00000000
--- a/lib/html/pipeline/emoji_filter.rb
+++ /dev/null
@@ -1,135 +0,0 @@
-# frozen_string_literal: true
-
-require 'cgi'
-HTML::Pipeline.require_dependencies(%w[gemoji gemojione], 'EmojiFilter')
-
-module HTML
-  class Pipeline
-    # HTML filter that replaces :emoji: with images.
-    #
-    # Context:
-    #   :asset_root (required) - base url to link to emoji sprite
-    #   :asset_path (optional) - url path to link to emoji sprite. :file_name can be used as a placeholder for the sprite file name. If no asset_path is set "emoji/:file_name" is used.
-    #   :ignored_ancestor_tags (optional) - Tags to stop the emojification. Node has matched ancestor HTML tags will not be emojified. Default to pre, code, and tt tags. Extra tags please pass in the form of array, e.g., %w(blockquote summary).
-    #   :img_attrs (optional) - Attributes for generated img tag. E.g. Pass { "draggble" => true, "height" => nil } to set draggable attribute to "true" and clear height attribute of generated img tag.
-    class EmojiFilter < Filter
-      DEFAULT_IGNORED_ANCESTOR_TAGS = %w[pre code tt].freeze
-
-      def call
-        doc.search('.//text()').each do |node|
-          content = node.text
-          next unless content.include?(':')
-          next if has_ancestor?(node, ignored_ancestor_tags)
-
-          html = emoji_image_filter(content)
-          next if html == content
-
-          node.replace(html)
-        end
-        doc
-      end
-
-      # Implementation of validate hook.
-      # Errors should raise exceptions or use an existing validator.
-      def validate
-        needs :asset_root
-      end
-
-      # Replace :emoji: with corresponding images.
-      #
-      # text - String text to replace :emoji: in.
-      #
-      # Returns a String with :emoji: replaced with images.
-      def emoji_image_filter(text)
-        text.gsub(emoji_pattern) do
-          emoji_image_tag(Regexp.last_match(1))
-        end
-      end
-
-      # The base url to link emoji sprites
-      #
-      # Raises ArgumentError if context option has not been provided.
-      # Returns the context's asset_root.
-      def asset_root
-        context[:asset_root]
-      end
-
-      # The url path to link emoji sprites
-      #
-      # :file_name can be used in the asset_path as a placeholder for the sprite file name. If no asset_path is set in the context "emoji/:file_name" is used.
-      # Returns the context's asset_path or the default path if no context asset_path is given.
-      def asset_path(name)
-        if context[:asset_path]
-          context[:asset_path].gsub(':file_name', emoji_filename(name))
-        else
-          File.join('emoji', emoji_filename(name))
-        end
-      end
-
-      # Build an emoji image tag
-      private def emoji_image_tag(name)
-        html_attrs =
-          default_img_attrs(name).transform_keys(&:to_sym)
-                                 .merge!(context[:img_attrs] || {}).transform_keys(&:to_sym)
-                                 .each_with_object([]) do |(attr, value), arr|
-            next if value.nil?
-
-            value = value.respond_to?(:call) && value.call(name) || value
-            arr << %(#{attr}="#{value}")
-          end.compact.join(' ')
-
-        "<img #{html_attrs}>"
-      end
-
-      # Build a regexp that matches all valid :emoji: names.
-      def emoji_pattern
-        @emoji_pattern ||= /:(#{emoji_names.map { |name| Regexp.escape(name) }.join('|')}):/
-      end
-
-      def emoji_names
-        if self.class.gemoji_loaded?
-          Emoji.all.map(&:aliases)
-        else
-          Gemojione::Index.new.all.map { |i| i[1]['name'] }
-        end.flatten.sort
-      end
-
-      # Default attributes for img tag
-      private def default_img_attrs(name)
-        {
-          'class' => 'emoji',
-          'title' => ":#{name}:",
-          'alt' => ":#{name}:",
-          'src' => emoji_url(name).to_s,
-          'height' => '20',
-          'width' => '20',
-          'align' => 'absmiddle'
-        }
-      end
-
-      private def emoji_url(name)
-        File.join(asset_root, asset_path(name))
-      end
-
-      private def emoji_filename(name)
-        if self.class.gemoji_loaded?
-          Emoji.find_by_alias(name).image_filename
-        else
-          # replace their asset_host with ours
-          Gemojione.image_url_for_name(name).sub(Gemojione.asset_host, '')
-        end
-      end
-
-      # Return ancestor tags to stop the emojification.
-      #
-      # @return [Array<String>] Ancestor tags.
-      private def ignored_ancestor_tags
-        if context[:ignored_ancestor_tags]
-          DEFAULT_IGNORED_ANCESTOR_TAGS | context[:ignored_ancestor_tags]
-        else
-          DEFAULT_IGNORED_ANCESTOR_TAGS
-        end
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/filter.rb b/lib/html/pipeline/filter.rb
deleted file mode 100644
index fb0f6747..00000000
--- a/lib/html/pipeline/filter.rb
+++ /dev/null
@@ -1,166 +0,0 @@
-# frozen_string_literal: true
-
-module HTML
-  class Pipeline
-    # Base class for user content HTML filters. Each filter takes an
-    # HTML string or Nokogiri::HTML::DocumentFragment, performs
-    # modifications and/or writes information to the result hash. Filters must
-    # return a DocumentFragment (typically the same instance provided to the call
-    # method) or a String with HTML markup.
-    #
-    # Example filter that replaces all images with trollface:
-    #
-    #   class FuuuFilter < HTML::Pipeline::Filter
-    #     def call
-    #       doc.search('img').each do |img|
-    #         img['src'] = "http://paradoxdgn.com/junk/avatars/trollface.jpg"
-    #       end
-    #     end
-    #   end
-    #
-    # The context Hash passes options to filters and should not be changed in
-    # place.  A Result Hash allows filters to make extracted information
-    # available to the caller and is mutable.
-    #
-    # Common context options:
-    #   :base_url   - The site's base URL
-    #   :repository - A Repository providing context for the HTML being processed
-    #
-    # Each filter may define additional options and output values. See the class
-    # docs for more info.
-    class Filter
-      class InvalidDocumentException < StandardError; end
-
-      def initialize(doc, context: {}, result: {})
-        if doc.is_a?(String)
-          @html = doc.to_str
-          @doc = nil
-        else
-          @doc = doc
-          @html = nil
-        end
-        @context = context
-        @result = result
-        validate
-      end
-
-      # Public: Returns a simple Hash used to pass extra information into filters
-      # and also to allow filters to make extracted information available to the
-      # caller.
-      attr_reader :context
-
-      # Public: Returns a Hash used to allow filters to pass back information
-      # to callers of the various Pipelines.  This can be used for
-      # #mentioned_users, for example.
-      attr_reader :result
-
-      # The Nokogiri::HTML::DocumentFragment to be manipulated. If the filter was
-      # provided a String, parse into a DocumentFragment the first time this
-      # method is called.
-      def doc
-        @doc ||= parse_html(html)
-      end
-
-      # The String representation of the document. If a DocumentFragment was
-      # provided to the Filter, it is serialized into a String when this method is
-      # called.
-      def html
-        raise InvalidDocumentException if @html.nil? && @doc.nil?
-
-        @html || doc.to_html
-      end
-
-      # The main filter entry point. The doc attribute is guaranteed to be a
-      # Nokogiri::HTML::DocumentFragment when invoked. Subclasses should modify
-      # this document in place or extract information and add it to the context
-      # hash.
-      def call
-        raise NotImplementedError
-      end
-
-      # Make sure the context has everything we need. Noop: Subclasses can override.
-      def validate; end
-
-      # The Repository object provided in the context hash, or nil when no
-      # :repository was specified.
-      #
-      # It's assumed that the repository context has already been checked
-      # for permissions
-      def repository
-        context[:repository]
-      end
-
-      # The User object provided in the context hash, or nil when no user
-      # was specified
-      def current_user
-        context[:current_user]
-      end
-
-      # The site's base URL provided in the context hash, or '/' when no
-      # base URL was specified.
-      def base_url
-        context[:base_url] || '/'
-      end
-
-      # Ensure the passed argument is a DocumentFragment. When a string is
-      # provided, it is parsed and returned; otherwise, the DocumentFragment is
-      # returned unmodified.
-      def parse_html(html)
-        HTML::Pipeline.parse(html)
-      end
-
-      # Helper method for filter subclasses used to determine if any of a node's
-      # ancestors have one of the tag names specified.
-      #
-      # node - The Node object to check.
-      # tags - An array of tag name strings to check. These should be downcase.
-      #
-      # Returns true when the node has a matching ancestor.
-      def has_ancestor?(node, tags) # rubocop:disable Naming/PredicateName
-        while (node = node.parent)
-          break true if tags.include?(node.name.downcase)
-        end
-      end
-
-      # Perform a filter on doc with the given context.
-      #
-      # Returns a HTML::Pipeline::DocumentFragment or a String containing HTML
-      # markup.
-      def self.call(doc, context: {}, result: {})
-        new(doc, context: context, result: result).call
-      end
-
-      # Like call but guarantees that a DocumentFragment is returned, even when
-      # the last filter returns a String.
-      def self.to_document(input, context: {})
-        html = call(input, context: context)
-        HTML::Pipeline.parse(html)
-      end
-
-      # Like call but guarantees that a string of HTML markup is returned.
-      def self.to_html(input, context: {})
-        output = call(input, context: context)
-        if output.respond_to?(:to_html)
-          output.to_html
-        else
-          output.to_s
-        end
-      end
-
-      # Validator for required context. This will check that anything passed in
-      # contexts exists in @contexts
-      #
-      # If any errors are found an ArgumentError will be raised with a
-      # message listing all the missing contexts and the filters that
-      # require them.
-      def needs(*keys)
-        missing = keys.reject { |key| context.include? key }
-
-        return unless missing.any?
-
-        raise ArgumentError,
-              "Missing context keys for #{self.class.name}: #{missing.map(&:inspect).join ', '}"
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/https_filter.rb b/lib/html/pipeline/https_filter.rb
deleted file mode 100644
index 4196faa0..00000000
--- a/lib/html/pipeline/https_filter.rb
+++ /dev/null
@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-module HTML
-  class Pipeline
-    # HTML Filter for replacing http references to :http_url with https versions.
-    # Subdomain references are not rewritten.
-    #
-    # Context options:
-    #   :http_url - The HTTP url to force HTTPS. Falls back to :base_url
-    class HttpsFilter < Filter
-      def call
-        doc.css(%(a[href^="#{http_url}"])).each do |element|
-          element['href'] = element['href'].sub(/^http:/, 'https:')
-        end
-        doc
-      end
-
-      # HTTP url to replace. Falls back to :base_url
-      def http_url
-        context[:http_url] || context[:base_url]
-      end
-
-      # Raise error if :http_url undefined
-      def validate
-        needs :http_url unless http_url
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/image_filter.rb b/lib/html/pipeline/image_filter.rb
deleted file mode 100644
index 418dfd95..00000000
--- a/lib/html/pipeline/image_filter.rb
+++ /dev/null
@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-module HTML
-  class Pipeline
-    # HTML Filter that converts image's url into <img> tag.
-    # For example, it will convert
-    #   http://example.com/test.jpg
-    # into
-    #   <img src="http://example.com/test.jpg" alt=""/>.
-
-    class ImageFilter < TextFilter
-      def call
-        @text.gsub(%r{(https|http)?://.+\.(jpg|jpeg|bmp|gif|png)(\?\S+)?}i) do |match|
-          %(<img src="#{match}" alt=""/>)
-        end
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/image_max_width_filter.rb b/lib/html/pipeline/image_max_width_filter.rb
deleted file mode 100644
index 8f076ad5..00000000
--- a/lib/html/pipeline/image_max_width_filter.rb
+++ /dev/null
@@ -1,37 +0,0 @@
-# frozen_string_literal: true
-
-module HTML
-  class Pipeline
-    # This filter rewrites image tags with a max-width inline style and also wraps
-    # the image in an <a> tag that causes the full size image to be opened in a
-    # new tab.
-    #
-    # The max-width inline styles are especially useful in HTML email which
-    # don't use a global stylesheets.
-    class ImageMaxWidthFilter < Filter
-      def call
-        doc.search('img').each do |element|
-          # Skip if there's already a style attribute. Not sure how this
-          # would happen but we can reconsider it in the future.
-          next if element['style']
-
-          # Bail out if src doesn't look like a valid http url. trying to avoid weird
-          # js injection via javascript: urls.
-          next if /\Ajavascript/i.match?(element['src'].to_s.strip)
-
-          element['style'] = 'max-width:100%;'
-
-          link_image element unless has_ancestor?(element, %w[a])
-        end
-
-        doc
-      end
-
-      def link_image(element)
-        link = doc.document.create_element('a', href: element['src'], target: '_blank')
-        link.add_child(element.dup)
-        element.replace(link)
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/markdown_filter.rb b/lib/html/pipeline/markdown_filter.rb
deleted file mode 100644
index 5f961aca..00000000
--- a/lib/html/pipeline/markdown_filter.rb
+++ /dev/null
@@ -1,55 +0,0 @@
-# frozen_string_literal: true
-
-HTML::Pipeline.require_dependency('commonmarker', 'MarkdownFilter')
-
-module HTML
-  class Pipeline
-    # HTML Filter that converts Markdown text into HTML and converts into a
-    # DocumentFragment. This is different from most filters in that it can take a
-    # non-HTML as input. It must be used as the first filter in a pipeline.
-    #
-    # Context options:
-    #   :gfm      => false    Disable GFM line-end processing
-    #   :commonmarker_extensions => [ :table, :strikethrough,
-    #      :tagfilter, :autolink ] Commonmarker extensions to include
-    #
-    # This filter does not write any additional information to the context hash.
-    class MarkdownFilter < TextFilter
-      DEFAULT_COMMONMARKER_EXTENSIONS = %i[table strikethrough tagfilter autolink].freeze
-
-      def initialize(text, context: {}, result: {})
-        super text, context: context, result: result
-        @text = @text.delete "\r"
-      end
-
-      # Convert Markdown to HTML using the best available implementation
-      # and convert into a DocumentFragment.
-      def call
-        extensions = context.fetch(
-          :commonmarker_extensions,
-          DEFAULT_COMMONMARKER_EXTENSIONS
-        )
-        html = if (renderer = context[:commonmarker_renderer])
-                 raise ArgumentError, '`commonmark_renderer` must be derived from `CommonMarker::HtmlRenderer`' unless renderer < CommonMarker::HtmlRenderer
-
-                 parse_options = :DEFAULT
-                 parse_options = [:UNSAFE] if context[:unsafe]
-
-                 render_options = [:GITHUB_PRE_LANG]
-                 render_options << :HARDBREAKS if context[:gfm] != false
-                 render_options << :UNSAFE if context[:unsafe]
-
-                 doc = CommonMarker.render_doc(@text, parse_options, extensions)
-                 renderer.new(options: render_options, extensions: extensions).render(doc)
-               else
-                 options = [:GITHUB_PRE_LANG]
-                 options << :HARDBREAKS if context[:gfm] != false
-                 options << :UNSAFE if context[:unsafe]
-                 CommonMarker.render_html(@text, options, extensions)
-               end
-        html.rstrip!
-        html
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/mention_filter.rb b/lib/html/pipeline/mention_filter.rb
deleted file mode 100644
index b46a071c..00000000
--- a/lib/html/pipeline/mention_filter.rb
+++ /dev/null
@@ -1,121 +0,0 @@
-# frozen_string_literal: true
-
-require 'set'
-
-module HTML
-  class Pipeline
-    # HTML filter that replaces @user mentions with links. Mentions within <pre>,
-    # <code>, and <a> elements are ignored. Mentions that reference users that do
-    # not exist are ignored.
-    #
-    # Context options:
-    #   :base_url - Used to construct links to user profile pages for each
-    #               mention.
-    #   :info_url - Used to link to "more info" when someone mentions @mention
-    #               or @mentioned.
-    #   :username_pattern - Used to provide a custom regular expression to
-    #                       identify usernames
-    #
-    class MentionFilter < Filter
-      # Public: Find user @mentions in text.  See
-      # MentionFilter#mention_link_filter.
-      #
-      #   MentionFilter.mentioned_logins_in(text) do |match, login, is_mentioned|
-      #     "<a href=...>#{login}</a>"
-      #   end
-      #
-      # text - String text to search.
-      #
-      # Yields the String match, the String login name, and a Boolean determining
-      # if the match = "@mention[ed]".  The yield's return replaces the match in
-      # the original text.
-      #
-      # Returns a String replaced with the return of the block.
-      def self.mentioned_logins_in(text, username_pattern = USERNAME_PATTERN)
-        text.gsub MENTION_PATTERNS[username_pattern] do |match|
-          login = Regexp.last_match(1)
-          yield match, login
-        end
-      end
-
-      # Hash that contains all of the mention patterns used by the pipeline
-      MENTION_PATTERNS = Hash.new do |hash, key|
-        hash[key] = %r{
-          (?:^|\W)                    # beginning of string or non-word char
-          @((?>#{key}))  # @username
-          (?!/)                      # without a trailing slash
-          (?=
-            \.+[ \t\W]|               # dots followed by space or non-word character
-            \.+$|                     # dots at end of line
-            [^0-9a-zA-Z_.]|           # non-word character except dot
-            $                         # end of line
-          )
-        }ix
-      end
-
-      # Default pattern used to extract usernames from text. The value can be
-      # overriden by providing the username_pattern variable in the context.
-      USERNAME_PATTERN = /[a-z0-9][a-z0-9-]*/.freeze
-
-      # Don't look for mentions in text nodes that are children of these elements
-      IGNORE_PARENTS = %w[pre code a style script].to_set
-
-      def call
-        result[:mentioned_usernames] ||= []
-
-        doc.search('.//text()').each do |node|
-          content = node.to_html
-          next unless content.include?('@')
-          next if has_ancestor?(node, IGNORE_PARENTS)
-
-          html = mention_link_filter(content, base_url: base_url, username_pattern: username_pattern)
-          next if html == content
-
-          node.replace(html)
-        end
-        doc
-      end
-
-      # The URL to provide when someone @mentions a "mention" name, such
-      # as @mention or @mentioned, that will give them more info on mentions.
-      def info_url
-        context[:info_url] || nil
-      end
-
-      def username_pattern
-        context[:username_pattern] || USERNAME_PATTERN
-      end
-
-      # Replace user @mentions in text with links to the mentioned user's
-      # profile page.
-      #
-      # text      - String text to replace @mention usernames in.
-      # base_url  - The base URL used to construct user profile URLs.
-      # info_url  - The "more info" URL used to link to more info on @mentions.
-      #             If nil we don't link @mention or @mentioned.
-      # username_pattern  - Regular expression used to identify usernames in
-      #                     text
-      #
-      # Returns a string with @mentions replaced with links. All links have a
-      # 'user-mention' class name attached for styling.
-      def mention_link_filter(text, base_url: '/', username_pattern: USERNAME_PATTERN)
-        self.class.mentioned_logins_in(text, username_pattern) do |match, login|
-          link = link_to_mentioned_user(base_url, login)
-
-          link ? match.sub("@#{login}", link) : match
-        end
-      end
-
-      def link_to_mentioned_user(base_url, login)
-        result[:mentioned_usernames] |= [login]
-
-        url = base_url.dup
-        url << '/' unless %r{[/~]\z}.match?(url)
-
-        "<a href='#{url << login}' class='user-mention'>" \
-          "@#{login}" \
-          '</a>'
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/plain_text_input_filter.rb b/lib/html/pipeline/plain_text_input_filter.rb
deleted file mode 100644
index 0f2f2493..00000000
--- a/lib/html/pipeline/plain_text_input_filter.rb
+++ /dev/null
@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-HTML::Pipeline.require_dependency('escape_utils', 'PlainTextInputFilter')
-
-module HTML
-  class Pipeline
-    # Simple filter for plain text input. HTML escapes the text input and wraps it
-    # in a div.
-    class PlainTextInputFilter < TextFilter
-      def call
-        "<div>#{EscapeUtils.escape_html(@text, false)}</div>"
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/sanitization_filter.rb b/lib/html/pipeline/sanitization_filter.rb
deleted file mode 100644
index 77b25eca..00000000
--- a/lib/html/pipeline/sanitization_filter.rb
+++ /dev/null
@@ -1,136 +0,0 @@
-# frozen_string_literal: true
-
-HTML::Pipeline.require_dependency('sanitize', 'SanitizationFilter')
-
-module HTML
-  class Pipeline
-    # HTML filter with sanization routines and allowlists. This module defines
-    # what HTML is allowed in user provided content and fixes up issues with
-    # unbalanced tags and whatnot.
-    #
-    # See the Sanitize docs for more information on the underlying library:
-    #
-    # https://github.com/rgrove/sanitize/#readme
-    #
-    # Context options:
-    #   :allowlist      - The sanitizer allowlist configuration to use. This
-    #                     can be one of the options constants defined in this
-    #                     class or a custom sanitize options hash.
-    #   :anchor_schemes - The URL schemes to allow in <a href> attributes. The
-    #                     default set is provided in the ANCHOR_SCHEMES
-    #                     constant in this class. If passed, this overrides any
-    #                     schemes specified in the allowlist configuration.
-    #
-    # This filter does not write additional information to the context.
-    class SanitizationFilter < Filter
-      LISTS     = Set.new(%w[ul ol].freeze)
-      LIST_ITEM = 'li'
-
-      # List of table child elements. These must be contained by a <table> element
-      # or they are not allowed through. Otherwise they can be used to break out
-      # of places we're using tables to contain formatted user content (like pull
-      # request review comments).
-      TABLE_ITEMS = Set.new(%w[tr td th].freeze)
-      TABLE = 'table'
-      TABLE_SECTIONS = Set.new(%w[thead tbody tfoot].freeze)
-
-      # These schemes are the only ones allowed in <a href> attributes by default.
-      ANCHOR_SCHEMES = ['http', 'https', 'mailto', 'xmpp', :relative, 'github-windows', 'github-mac', 'irc', 'ircs'].freeze
-
-      # The main sanitization allowlist. Only these elements and attributes are
-      # allowed through by default.
-      ALLOWLIST = {
-        elements: %w[
-          h1 h2 h3 h4 h5 h6 h7 h8 br b i strong em a pre code img tt
-          div ins del sup sub p ol ul table thead tbody tfoot blockquote
-          dl dt dd kbd q samp var hr ruby rt rp li tr td th s strike summary
-          details caption figure figcaption
-          abbr bdo cite dfn mark small span time wbr
-        ].freeze,
-        remove_contents: ['script'].freeze,
-        attributes: {
-          'a' => ['href'].freeze,
-          'img' => %w[src longdesc].freeze,
-          'div' => %w[itemscope itemtype].freeze,
-          'blockquote' => ['cite'].freeze,
-          'del' => ['cite'].freeze,
-          'ins' => ['cite'].freeze,
-          'q' => ['cite'].freeze,
-          all: %w[abbr accept accept-charset
-                  accesskey action align alt
-                  aria-describedby aria-hidden aria-label aria-labelledby
-                  axis border cellpadding cellspacing char
-                  charoff charset checked
-                  clear cols colspan color
-                  compact coords datetime dir
-                  disabled enctype for frame
-                  headers height hreflang
-                  hspace ismap label lang
-                  maxlength media method
-                  multiple name nohref noshade
-                  nowrap open progress prompt readonly rel rev
-                  role rows rowspan rules scope
-                  selected shape size span
-                  start summary tabindex target
-                  title type usemap valign value
-                  vspace width itemprop].freeze
-        }.freeze,
-        protocols: {
-          'a' => { 'href' => ANCHOR_SCHEMES }.freeze,
-          'blockquote' => { 'cite' => ['http', 'https', :relative].freeze },
-          'del' => { 'cite' => ['http', 'https', :relative].freeze },
-          'ins' => { 'cite' => ['http', 'https', :relative].freeze },
-          'q' => { 'cite' => ['http', 'https', :relative].freeze },
-          'img' => {
-            'src' => ['http', 'https', :relative].freeze,
-            'longdesc' => ['http', 'https', :relative].freeze
-          }.freeze
-        },
-        transformers: [
-          # Top-level <li> elements are removed because they can break out of
-          # containing markup.
-          lambda { |env|
-            name = env[:node_name]
-            node = env[:node]
-            node.replace(node.children) if name == LIST_ITEM && node.ancestors.none? { |n| LISTS.include?(n.name) }
-          },
-
-          # Table child elements that are not contained by a <table> are removed.
-          lambda { |env|
-            name = env[:node_name]
-            node = env[:node]
-            node.replace(node.children) if (TABLE_SECTIONS.include?(name) || TABLE_ITEMS.include?(name)) && node.ancestors.none? { |n| n.name == TABLE }
-          }
-        ].freeze
-      }.freeze
-
-      # A more limited sanitization allowlist. This includes all attributes,
-      # protocols, and transformers from ALLOWLIST but with a more locked down
-      # set of allowed elements.
-      LIMITED = ALLOWLIST.merge(
-        elements: %w[b i strong em a pre code img ins del sup sub mark abbr p ol ul li]
-      )
-
-      # Strip all HTML tags from the document.
-      FULL = { elements: [] }.freeze
-
-      # Sanitize markup using the Sanitize library.
-      def call
-        Sanitize.clean_node!(doc, allowlist)
-      end
-
-      # The allowlist to use when sanitizing. This can be passed in the context
-      # hash to the filter but defaults to ALLOWLIST constant value above.
-      def allowlist
-        allowlist = context[:allowlist] || ALLOWLIST
-        anchor_schemes = context[:anchor_schemes]
-        return allowlist unless anchor_schemes
-
-        allowlist = allowlist.dup
-        allowlist[:protocols] = (allowlist[:protocols] || {}).dup
-        allowlist[:protocols]['a'] = (allowlist[:protocols]['a'] || {}).merge('href' => anchor_schemes)
-        allowlist
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/syntax_highlight_filter.rb b/lib/html/pipeline/syntax_highlight_filter.rb
deleted file mode 100644
index 7b62ead4..00000000
--- a/lib/html/pipeline/syntax_highlight_filter.rb
+++ /dev/null
@@ -1,50 +0,0 @@
-# frozen_string_literal: true
-
-HTML::Pipeline.require_dependency('rouge', 'SyntaxHighlightFilter')
-
-module HTML
-  class Pipeline
-    # HTML Filter that syntax highlights text inside code blocks.
-    #
-    # Context options:
-    #
-    #   :highlight => String represents the language to pick lexer. Defaults to empty string.
-    #   :scope => String represents the class attribute adds to pre element after.
-    #             Defaults to "highlight highlight-css" if highlights a css code block.
-    #
-    # This filter does not write any additional information to the context hash.
-    class SyntaxHighlightFilter < Filter
-      def initialize(doc, context: {}, result: {})
-        super(doc, context: context, result: result)
-        @formatter = Rouge::Formatters::HTML.new
-      end
-
-      def call
-        doc.search('pre').each do |node|
-          default = context[:highlight]&.to_s
-          next unless (lang = node['lang'] || default)
-          next unless (lexer = lexer_for(lang))
-
-          text = node.inner_text
-          html = highlight_with_timeout_handling(text, lexer)
-          next if html.nil?
-
-          node.inner_html = html
-          scope = context.fetch(:scope, 'highlight')
-          node['class'] = "#{scope} #{scope}-#{lang}"
-        end
-        doc
-      end
-
-      def highlight_with_timeout_handling(text, lexer)
-        Rouge.highlight(text, lexer, @formatter)
-      rescue Timeout::Error => _e
-        nil
-      end
-
-      def lexer_for(lang)
-        Rouge::Lexer.find(lang)
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/team_mention_filter.rb b/lib/html/pipeline/team_mention_filter.rb
deleted file mode 100644
index 7dbd73f7..00000000
--- a/lib/html/pipeline/team_mention_filter.rb
+++ /dev/null
@@ -1,101 +0,0 @@
-# frozen_string_literal: true
-
-require 'set'
-
-module HTML
-  class Pipeline
-    # HTML filter that replaces @org/team mentions with links. Mentions within
-    # <pre>, <code>, <a>, <style>, and <script> elements are ignored.
-    #
-    # Context options:
-    #   :base_url - Used to construct links to team profile pages for each
-    #               mention.
-    #   :team_pattern - Used to provide a custom regular expression to
-    #                       identify team names
-    #
-    class TeamMentionFilter < Filter
-      # Public: Find @org/team mentions in text.  See
-      # TeamMentionFilter#team_mention_link_filter.
-      #
-      #   TeamMentionFilter.mentioned_teams_in(text) do |match, org, team|
-      #     "<a href=...>#{team}</a>"
-      #   end
-      #
-      # text - String text to search.
-      #
-      # Yields the String match, org name, and team name.  The yield's
-      # return replaces the match in the original text.
-      #
-      # Returns a String replaced with the return of the block.
-      def self.mentioned_teams_in(text, team_pattern = TEAM_PATTERN)
-        text.gsub team_pattern do |match|
-          org = Regexp.last_match(1)
-          team = Regexp.last_match(2)
-          yield match, org, team
-        end
-      end
-
-      # Default pattern used to extract team names from text. The value can be
-      # overridden by providing the team_pattern variable in the context. To
-      # properly link the mention, should be in the format of /@(1)\/(2)/.
-      TEAM_PATTERN = %r{
-        (?<=^|\W)                  # beginning of string or non-word char
-        @([a-z0-9][a-z0-9-]*)      # @organization
-          /                       # dividing slash
-          ([a-z0-9][a-z0-9\-_]*)   # team
-          \b
-      }ix.freeze
-
-      # Don't look for mentions in text nodes that are children of these elements
-      IGNORE_PARENTS = %w[pre code a style script].to_set
-
-      def call
-        result[:mentioned_teams] ||= []
-
-        doc.search('.//text()').each do |node|
-          content = node.to_html
-          next unless content.include?('@')
-          next if has_ancestor?(node, IGNORE_PARENTS)
-
-          html = mention_link_filter(content, base_url: base_url, team_pattern: team_pattern)
-          next if html == content
-
-          node.replace(html)
-        end
-        doc
-      end
-
-      def team_pattern
-        context[:team_pattern] || TEAM_PATTERN
-      end
-
-      # Replace @org/team mentions in text with links to the mentioned team's
-      # page.
-      #
-      # text      - String text to replace @mention team names in.
-      # base_url  - The base URL used to construct team page URLs.
-      # team_pattern  - Regular expression used to identify teams in text
-      #
-      # Returns a string with @team mentions replaced with links. All links have a
-      # 'team-mention' class name attached for styling.
-      def mention_link_filter(text, base_url: '/', team_pattern: TEAM_PATTERN)
-        self.class.mentioned_teams_in(text, team_pattern) do |match, org, team|
-          link = link_to_mentioned_team(base_url, org, team)
-
-          link ? match.sub("@#{org}/#{team}", link) : match
-        end
-      end
-
-      def link_to_mentioned_team(base_url, org, team)
-        result[:mentioned_teams] |= [team]
-
-        url = base_url.dup
-        url << '/' unless %r{[/~]\z}.match?(url)
-
-        "<a href='#{url << org}/#{team}' class='team-mention'>" \
-          "@#{org}/#{team}" \
-          '</a>'
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/text_filter.rb b/lib/html/pipeline/text_filter.rb
deleted file mode 100644
index 2d5e5f01..00000000
--- a/lib/html/pipeline/text_filter.rb
+++ /dev/null
@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-module HTML
-  class Pipeline
-    class TextFilter < Filter
-      attr_reader :text
-
-      def initialize(text, context: {}, result: {})
-        raise TypeError, 'text cannot be HTML' if text.is_a?(DocumentFragment)
-
-        # Ensure that this is always a string
-        @text = text.respond_to?(:to_str) ? text.to_str : text.to_s
-        super nil, context: context, result: result
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/toc_filter.rb b/lib/html/pipeline/toc_filter.rb
deleted file mode 100644
index c310eb26..00000000
--- a/lib/html/pipeline/toc_filter.rb
+++ /dev/null
@@ -1,69 +0,0 @@
-# frozen_string_literal: true
-
-HTML::Pipeline.require_dependency('escape_utils', 'TableOfContentsFilter')
-
-module HTML
-  class Pipeline
-    # HTML filter that adds an 'id' attribute to all headers
-    # in a document, so they can be accessed from a table of contents.
-    #
-    # Generates the Table of Contents, with links to each header.
-    #
-    # Examples
-    #
-    #  TocPipeline =
-    #    HTML::Pipeline.new [
-    #      HTML::Pipeline::TableOfContentsFilter
-    #    ]
-    #  # => #<HTML::Pipeline:0x007fc13c4528d8...>
-    #  orig = %(<h1>Ice cube</h1><p>is not for the pop chart</p>)
-    #  # => "<h1>Ice cube</h1><p>is not for the pop chart</p>"
-    #  result = {}
-    #  # => {}
-    #  TocPipeline.call(orig, {}, result)
-    #  # => {:toc=> ...}
-    #  result[:toc]
-    #  # => "<ul class=\"section-nav\">\n<li><a href=\"#ice-cube\">...</li><ul>"
-    #  result[:output].to_s
-    #  # => "<h1>\n<a id=\"ice-cube\" class=\"anchor\" href=\"#ice-cube\">..."
-    class TableOfContentsFilter < Filter
-      PUNCTUATION_REGEXP = RUBY_VERSION > '1.9' ? /[^\p{Word}\- ]/u : /[^\w\- ]/
-
-      # The icon that will be placed next to an anchored rendered markdown header
-      def anchor_icon
-        context[:anchor_icon] || '<span aria-hidden="true" class="octicon octicon-link"></span>'
-      end
-
-      def call
-        result[:toc] = +''
-
-        headers = Hash.new(0)
-        doc.css('h1, h2, h3, h4, h5, h6').each do |node|
-          text = node.text
-          id = ascii_downcase(text)
-          id.gsub!(PUNCTUATION_REGEXP, '') # remove punctuation
-          id.tr!(' ', '-') # replace spaces with dash
-
-          uniq = (headers[id]).positive? ? "-#{headers[id]}" : ''
-          headers[id] += 1
-          if (header_content = node.children.first)
-            result[:toc] << %(<li><a href="##{id}#{uniq}">#{EscapeUtils.escape_html(text)}</a></li>\n)
-            header_content.add_previous_sibling(%(<a id="#{id}#{uniq}" class="anchor" href="##{id}#{uniq}" aria-hidden="true">#{anchor_icon}</a>))
-          end
-        end
-        result[:toc] = %(<ul class="section-nav">\n#{result[:toc]}</ul>) unless result[:toc].empty?
-        doc
-      end
-
-      if RUBY_VERSION >= '2.4'
-        def ascii_downcase(str)
-          str.downcase(:ascii)
-        end
-      else
-        def ascii_downcase(str)
-          str.downcase
-        end
-      end
-    end
-  end
-end
diff --git a/lib/html/pipeline/version.rb b/lib/html/pipeline/version.rb
deleted file mode 100644
index 0df1992c..00000000
--- a/lib/html/pipeline/version.rb
+++ /dev/null
@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-module HTML
-  class Pipeline
-    VERSION = '2.13.2'
-  end
-end
diff --git a/lib/html_pipeline.rb b/lib/html_pipeline.rb
new file mode 100644
index 00000000..47723911
--- /dev/null
+++ b/lib/html_pipeline.rb
@@ -0,0 +1,229 @@
+# frozen_string_literal: true
+
+require "nokogiri"
+
+require "zeitwerk"
+lib_dir = File.join(File.dirname(__dir__), "lib")
+gem_loader = Zeitwerk::Loader.for_gem
+gem_loader.inflector.inflect(
+  "html_pipeline" => "HTMLPipeline"
+)
+gem_loader.ignore(File.join(lib_dir, "html-pipeline.rb"))
+gem_loader.setup
+
+class HTMLPipeline
+  # HTML processing filters and utilities. This module includes a small
+  # framework for defining DOM based content filters and applying them to user
+  # provided content.
+  #
+  # See HTMLPipeline::Filter for information on building filters.
+  #
+  # Construct a Pipeline for running multiple HTML filters.  A pipeline is created once
+  # with one to many filters, and it then can be `call`ed many times over the course
+  # of its lifetime with input.
+  #
+  # filters         - Array of Filter objects. Each must respond to call(doc,
+  #                   context) and return the modified DocumentFragment or a
+  #                   String containing HTML markup. Filters are performed in the
+  #                   order provided.
+  # default_context - The default context hash. Values specified here will be merged
+  #                   into values from the each individual pipeline run.  Can NOT be
+  #                   nil.  Default: empty Hash.
+  # result_class    - The default Class of the result object for individual
+  #                   calls.  Default: Hash.  Protip:  Pass in a Struct to get
+  #                   some semblance of type safety.
+  # autoload :VERSION,               'html/pipeline/version'
+  # autoload :Filter,                'html/pipeline/filter'
+  # autoload :AbsoluteSourceFilter,  'html/pipeline/absolute_source_filter'
+  # autoload :BodyContent,           'html/pipeline/body_content'
+  # autoload :AutolinkFilter,        'html/pipeline/autolink_filter'
+  # autoload :CamoFilter,            'html/pipeline/camo_filter'
+  # autoload :EmailReplyFilter,      'html/pipeline/email_reply_filter'
+  # autoload :EmojiFilter,           'html/pipeline/emoji_filter'
+  # autoload :HttpsFilter,           'html/pipeline/https_filter'
+  # autoload :ImageFilter,           'html/pipeline/image_filter'
+  # autoload :ImageMaxWidthFilter,   'html/pipeline/image_max_width_filter'
+  # autoload :MarkdownFilter,        'html/pipeline/markdown_filter'
+  # autoload :MentionFilter,         'html/pipeline/mention_filter'
+  # autoload :TeamMentionFilter,     'html/pipeline/team_mention_filter'
+  # autoload :PlainTextInputFilter,  'html/pipeline/plain_text_input_filter'
+  # autoload :SanitizationFilter,    'html/pipeline/sanitization_filter'
+  # autoload :SyntaxHighlightFilter, 'html/pipeline/syntax_highlight_filter'
+  # autoload :TextileFilter,         'html/pipeline/textile_filter'
+  # autoload :TableOfContentsFilter, 'html/pipeline/toc_filter'
+  # autoload :TextFilter,            'html/pipeline/text_filter'
+
+  class MissingDependencyError < RuntimeError; end
+
+  def self.require_dependency(name, requirer)
+    require name
+  rescue LoadError => e
+    raise MissingDependencyError,
+      "Missing dependency '#{name}' for #{requirer}. See README.md for details.\n#{e.class.name}: #{e}"
+  end
+
+  def self.require_dependencies(names, requirer)
+    dependency_list = names.dup
+    loaded = false
+
+    while !loaded && names.length > 1
+      name = names.shift
+
+      begin
+        require_dependency(name, requirer)
+        loaded = true # we got a dependency
+        define_dependency_loaded_method(name, true)
+      # try the next dependency
+      rescue MissingDependencyError
+        define_dependency_loaded_method(name, false)
+      end
+    end
+
+    return if loaded
+
+    begin
+      name = names.shift
+      require name
+      define_dependency_loaded_method(name, true)
+    rescue LoadError => e
+      raise MissingDependencyError,
+        "Missing all dependencies '#{dependency_list.join(", ")}' for #{requirer}. See README.md for details.\n#{e.class.name}: #{e}"
+    end
+  end
+
+  def self.define_dependency_loaded_method(name, value)
+    self.class.define_method(:"#{name}_loaded?", -> { value })
+  end
+
+  # Our DOM implementation.
+  DocumentFragment = Nokogiri::HTML::DocumentFragment
+
+  # Parse a String into a DocumentFragment object. When a DocumentFragment is
+  # provided, return it verbatim.
+  def self.parse(document_or_html)
+    document_or_html ||= ""
+    if document_or_html.is_a?(String)
+      DocumentFragment.parse(document_or_html)
+    else
+      document_or_html
+    end
+  end
+
+  # Public: Returns an Array of Filter objects for this Pipeline.
+  attr_reader :filters
+
+  # Public: Instrumentation service for the pipeline.
+  # Set an ActiveSupport::Notifications compatible object to enable.
+  attr_accessor :instrumentation_service
+
+  # Public: String name for this Pipeline. Defaults to Class name.
+  attr_writer :instrumentation_name
+
+  def instrumentation_name
+    return @instrumentation_name if defined?(@instrumentation_name)
+
+    @instrumentation_name = self.class.name
+  end
+
+  class << self
+    # Public: Default instrumentation service for new pipeline objects.
+    attr_accessor :default_instrumentation_service
+  end
+
+  def initialize(filters, default_context: {}, result_class: Hash)
+    raise ArgumentError, "default_context cannot be nil" if default_context.nil?
+
+    @filters = filters.flatten.freeze
+    @default_context = default_context.freeze
+    @result_class = result_class
+    @instrumentation_service = self.class.default_instrumentation_service
+  end
+
+  # Apply all filters in the pipeline to the given HTML.
+  #
+  # html    - A String containing HTML or a DocumentFragment object.
+  # context - The context hash passed to each filter. See the Filter docs
+  #           for more info on possible values. This object MUST NOT be modified
+  #           in place by filters.  Use the Result for passing state back.
+  # result  - The result Hash passed to each filter for modification.  This
+  #           is where Filters store extracted information from the content.
+  #
+  # Returns the result Hash after being filtered by this Pipeline.  Contains an
+  # :output key with the DocumentFragment or String HTML markup based on the
+  # output of the last filter in the pipeline.
+  def call(html, context: {}, result: {})
+    context = @default_context.merge(context)
+    context = context.freeze
+    result ||= @result_class.new
+    payload = default_payload({ filters: @filters.map(&:name),
+                                context: context, result: result, })
+    instrument("call_pipeline.html_pipeline", payload) do
+      result[:output] =
+        @filters.inject(html) do |doc, filter|
+          perform_filter(filter, doc, context: context, result: result)
+        end
+    end
+    result
+  end
+
+  # Internal: Applies a specific filter to the supplied doc.
+  #
+  # The filter is instrumented.
+  #
+  # Returns the result of the filter.
+  def perform_filter(filter, doc, context: {}, result: {})
+    payload = default_payload({ filter: filter.name,
+                                context: context, result: result, })
+    instrument("call_filter.html_pipeline", payload) do
+      filter.call(doc, context: context, result: result)
+    end
+  end
+
+  # Like call but guarantee the value returned is a DocumentFragment.
+  # Pipelines may return a DocumentFragment or a String. Callers that need a
+  # DocumentFragment should use this method.
+  def to_document(input, context: {}, result: {})
+    result = call(input, context: context, result: result)
+    HTMLPipeline.parse(result[:output])
+  end
+
+  # Like call but guarantee the value returned is a string of HTML markup.
+  def to_html(input, context: {}, result: {})
+    result = call(input, context: context, result: result)
+    output = result[:output]
+    if output.respond_to?(:to_html)
+      output.to_html
+    else
+      output.to_s
+    end
+  end
+
+  # Public: setup instrumentation for this pipeline.
+  #
+  # Returns nothing.
+  def setup_instrumentation(name, service: nil)
+    self.instrumentation_name = name
+    self.instrumentation_service =
+      service || self.class.default_instrumentation_service
+  end
+
+  # Internal: if the `instrumentation_service` object is set, instruments the
+  # block, otherwise the block is ran without instrumentation.
+  #
+  # Returns the result of the provided block.
+  def instrument(event, payload = {}, &block)
+    payload ||= default_payload
+    return yield(payload) unless instrumentation_service
+
+    instrumentation_service.instrument(event, payload, &block)
+  end
+
+  # Internal: Default payload for instrumentation.
+  #
+  # Accepts a Hash of additional payload data to be merged.
+  #
+  # Returns a Hash.
+  def default_payload(payload = {})
+    { pipeline: instrumentation_name }.merge(payload)
+  end
+end
diff --git a/lib/html_pipeline/absolute_source_filter.rb b/lib/html_pipeline/absolute_source_filter.rb
new file mode 100644
index 00000000..83e5d157
--- /dev/null
+++ b/lib/html_pipeline/absolute_source_filter.rb
@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require "uri"
+
+class HTMLPipeline
+  class AbsoluteSourceFilter < Filter
+    # HTML Filter for replacing relative and root relative image URLs with
+    # fully qualified URLs
+    #
+    # This is useful if an image is root relative but should really be going
+    # through a cdn, or if the content for the page assumes the host is known
+    # i.e. scraped webpages and some RSS feeds.
+    #
+    # Context options:
+    #   :image_base_url - Base URL for image host for root relative src.
+    #   :image_subpage_url - For relative src.
+    #
+    # This filter does not write additional information to the context.
+    # This filter would need to be run before CamoFilter.
+    def call
+      doc.search("img").each do |element|
+        next if element["src"].nil? || element["src"].empty?
+
+        src = element["src"].strip
+        next if src.start_with?("http")
+
+        base = if src.start_with?("/")
+          image_base_url
+        else
+          image_subpage_url
+        end
+        element["src"] = URI.join(base, src).to_s
+      end
+      doc
+    end
+
+    # Private: the base url you want to use
+    def image_base_url
+      context[:image_base_url] || raise("Missing context :image_base_url for #{self.class.name}")
+    end
+
+    # Private: the relative url you want to use
+    def image_subpage_url
+      context[:image_subpage_url] || raise("Missing context :image_subpage_url for #{self.class.name}")
+    end
+  end
+end
diff --git a/lib/html_pipeline/autolink_filter.rb b/lib/html_pipeline/autolink_filter.rb
new file mode 100644
index 00000000..61229f40
--- /dev/null
+++ b/lib/html_pipeline/autolink_filter.rb
@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+HTMLPipeline.require_dependency("rinku", "AutolinkFilter")
+
+class HTMLPipeline
+  # HTML Filter for auto_linking urls in HTML.
+  #
+  # Context options:
+  #   :autolink  - boolean whether to autolink urls
+  #   :link_mode - :all, :urls or :email_addresses
+  #   :link_attr - HTML attributes for the link that will be generated
+  #   :skip_tags - HTML tags inside which autolinking will be skipped.
+  #                See Rinku.skip_tags
+  #   :flags     - additional Rinku flags. See https://github.com/vmg/rinku
+  #
+  # This filter does not write additional information to the context.
+  class AutolinkFilter < Filter
+    def call
+      return html if context[:autolink] == false
+
+      skip_tags = context[:skip_tags]
+      flags = 0
+      flags |= context[:flags] if context[:flags]
+
+      Rinku.auto_link(html, link_mode, context[:link_attr], skip_tags, flags)
+    end
+
+    def link_mode
+      context[:link_mode] || :urls
+    end
+  end
+end
diff --git a/lib/html_pipeline/body_content.rb b/lib/html_pipeline/body_content.rb
new file mode 100644
index 00000000..877b7721
--- /dev/null
+++ b/lib/html_pipeline/body_content.rb
@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+class HTMLPipeline
+  # Public: Runs a String of content through an HTML processing pipeline,
+  # providing easy access to a generated DocumentFragment.
+  class BodyContent
+    # Public: Initialize a BodyContent.
+    #
+    # body     - A String body.
+    # context  - A Hash of context options for the filters.
+    # pipeline - A HTMLPipeline object with one or more Filters.
+    def initialize(body, context, pipeline)
+      @body = body
+      @context = context
+      @pipeline = pipeline
+    end
+
+    # Public: Gets the memoized result of the body content as it passed through
+    # the Pipeline.
+    #
+    # Returns a Hash, or something similar as defined by @pipeline.result_class.
+    def result
+      @result ||= @pipeline.call(@body, @context)
+    end
+
+    # Public: Gets the updated body from the Pipeline result.
+    #
+    # Returns a String or DocumentFragment.
+    def output
+      @output ||= result[:output]
+    end
+
+    # Public: Parses the output into a DocumentFragment.
+    #
+    # Returns a DocumentFragment.
+    def document
+      @document ||= HTMLPipeline.parse(output)
+    end
+  end
+end
diff --git a/lib/html_pipeline/emoji_filter.rb b/lib/html_pipeline/emoji_filter.rb
new file mode 100644
index 00000000..dc10acc3
--- /dev/null
+++ b/lib/html_pipeline/emoji_filter.rb
@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+require "cgi"
+HTMLPipeline.require_dependencies(["gemoji", "gemojione"], "EmojiFilter")
+
+class HTMLPipeline
+  # HTML filter that replaces :emoji: with images.
+  #
+  # Context:
+  #   :asset_root (required) - base url to link to emoji sprite
+  #   :asset_path (optional) - url path to link to emoji sprite. :file_name can be used as a placeholder for the sprite file name. If no asset_path is set "emoji/:file_name" is used.
+  #   :ignored_ancestor_tags (optional) - Tags to stop the emojification. Node has matched ancestor HTML tags will not be emojified. Default to pre, code, and tt tags. Extra tags please pass in the form of array, e.g., %w(blockquote summary).
+  #   :img_attrs (optional) - Attributes for generated img tag. E.g. Pass { "draggble" => true, "height" => nil } to set draggable attribute to "true" and clear height attribute of generated img tag.
+  class EmojiFilter < Filter
+    DEFAULT_IGNORED_ANCESTOR_TAGS = ["pre", "code", "tt"].freeze
+
+    def call
+      doc.search(".//text()").each do |node|
+        content = node.text
+        next unless content.include?(":")
+        next if has_ancestor?(node, ignored_ancestor_tags)
+
+        html = emoji_image_filter(content)
+        next if html == content
+
+        node.replace(html)
+      end
+      doc
+    end
+
+    # Implementation of validate hook.
+    # Errors should raise exceptions or use an existing validator.
+    def validate
+      needs(:asset_root)
+    end
+
+    # Replace :emoji: with corresponding images.
+    #
+    # text - String text to replace :emoji: in.
+    #
+    # Returns a String with :emoji: replaced with images.
+    def emoji_image_filter(text)
+      text.gsub(emoji_pattern) do
+        emoji_image_tag(Regexp.last_match(1))
+      end
+    end
+
+    # The base url to link emoji sprites
+    #
+    # Raises ArgumentError if context option has not been provided.
+    # Returns the context's asset_root.
+    def asset_root
+      context[:asset_root]
+    end
+
+    # The url path to link emoji sprites
+    #
+    # :file_name can be used in the asset_path as a placeholder for the sprite file name. If no asset_path is set in the context "emoji/:file_name" is used.
+    # Returns the context's asset_path or the default path if no context asset_path is given.
+    def asset_path(name)
+      if context[:asset_path]
+        context[:asset_path].gsub(":file_name", emoji_filename(name))
+      else
+        File.join("emoji", emoji_filename(name))
+      end
+    end
+
+    # Build an emoji image tag
+    private def emoji_image_tag(name)
+      html_attrs =
+        default_img_attrs(name).transform_keys(&:to_sym)
+          .merge!(context[:img_attrs] || {}).transform_keys(&:to_sym)
+          .each_with_object([]) do |(attr, value), arr|
+          next if value.nil?
+
+          value = value.respond_to?(:call) && value.call(name) || value
+          arr << %(#{attr}="#{value}")
+        end.compact.join(" ")
+
+      "<img #{html_attrs}>"
+    end
+
+    # Build a regexp that matches all valid :emoji: names.
+    def emoji_pattern
+      @emoji_pattern ||= /:(#{emoji_names.map { |name| Regexp.escape(name) }.join('|')}):/
+    end
+
+    def emoji_names
+      if self.class.gemoji_loaded?
+        Emoji.all.map(&:aliases)
+      else
+        Gemojione::Index.new.all.map { |i| i[1]["name"] }
+      end.flatten.sort
+    end
+
+    # Default attributes for img tag
+    private def default_img_attrs(name)
+      {
+        "class" => "emoji",
+        "title" => ":#{name}:",
+        "alt" => ":#{name}:",
+        "src" => emoji_url(name).to_s,
+        "height" => "20",
+        "width" => "20",
+        "align" => "absmiddle",
+      }
+    end
+
+    private def emoji_url(name)
+      File.join(asset_root, asset_path(name))
+    end
+
+    private def emoji_filename(name)
+      if self.class.gemoji_loaded?
+        Emoji.find_by_alias(name).image_filename
+      else
+        # replace their asset_host with ours
+        Gemojione.image_url_for_name(name).sub(Gemojione.asset_host, "")
+      end
+    end
+
+    # Return ancestor tags to stop the emojification.
+    #
+    # @return [Array<String>] Ancestor tags.
+    private def ignored_ancestor_tags
+      if context[:ignored_ancestor_tags]
+        DEFAULT_IGNORED_ANCESTOR_TAGS | context[:ignored_ancestor_tags]
+      else
+        DEFAULT_IGNORED_ANCESTOR_TAGS
+      end
+    end
+  end
+end
diff --git a/lib/html_pipeline/filter.rb b/lib/html_pipeline/filter.rb
new file mode 100644
index 00000000..7775ac13
--- /dev/null
+++ b/lib/html_pipeline/filter.rb
@@ -0,0 +1,164 @@
+# frozen_string_literal: true
+
+class HTMLPipeline
+  # Base class for user content HTML filters. Each filter takes an
+  # HTML string or Nokogiri::HTML::DocumentFragment, performs
+  # modifications and/or writes information to the result hash. Filters must
+  # return a DocumentFragment (typically the same instance provided to the call
+  # method) or a String with HTML markup.
+  #
+  # Example filter that replaces all images with trollface:
+  #
+  #   class FuuuFilter < HTMLPipeline::Filter
+  #     def call
+  #       doc.search('img').each do |img|
+  #         img['src'] = "http://paradoxdgn.com/junk/avatars/trollface.jpg"
+  #       end
+  #     end
+  #   end
+  #
+  # The context Hash passes options to filters and should not be changed in
+  # place.  A Result Hash allows filters to make extracted information
+  # available to the caller and is mutable.
+  #
+  # Common context options:
+  #   :base_url   - The site's base URL
+  #   :repository - A Repository providing context for the HTML being processed
+  #
+  # Each filter may define additional options and output values. See the class
+  # docs for more info.
+  class Filter
+    class InvalidDocumentException < StandardError; end
+
+    def initialize(doc, context: {}, result: {})
+      if doc.is_a?(String)
+        @html = doc.to_str
+        @doc = nil
+      else
+        @doc = doc
+        @html = nil
+      end
+      @context = context
+      @result = result
+      validate
+    end
+
+    # Public: Returns a simple Hash used to pass extra information into filters
+    # and also to allow filters to make extracted information available to the
+    # caller.
+    attr_reader :context
+
+    # Public: Returns a Hash used to allow filters to pass back information
+    # to callers of the various Pipelines.  This can be used for
+    # #mentioned_users, for example.
+    attr_reader :result
+
+    # The Nokogiri::HTML::DocumentFragment to be manipulated. If the filter was
+    # provided a String, parse into a DocumentFragment the first time this
+    # method is called.
+    def doc
+      @doc ||= parse_html(html)
+    end
+
+    # The String representation of the document. If a DocumentFragment was
+    # provided to the Filter, it is serialized into a String when this method is
+    # called.
+    def html
+      raise InvalidDocumentException if @html.nil? && @doc.nil?
+
+      @html || doc.to_html
+    end
+
+    # The main filter entry point. The doc attribute is guaranteed to be a
+    # Nokogiri::HTML::DocumentFragment when invoked. Subclasses should modify
+    # this document in place or extract information and add it to the context
+    # hash.
+    def call
+      raise NotImplementedError
+    end
+
+    # Make sure the context has everything we need. Noop: Subclasses can override.
+    def validate; end
+
+    # The Repository object provided in the context hash, or nil when no
+    # :repository was specified.
+    #
+    # It's assumed that the repository context has already been checked
+    # for permissions
+    def repository
+      context[:repository]
+    end
+
+    # The User object provided in the context hash, or nil when no user
+    # was specified
+    def current_user
+      context[:current_user]
+    end
+
+    # The site's base URL provided in the context hash, or '/' when no
+    # base URL was specified.
+    def base_url
+      context[:base_url] || "/"
+    end
+
+    # Ensure the passed argument is a DocumentFragment. When a string is
+    # provided, it is parsed and returned; otherwise, the DocumentFragment is
+    # returned unmodified.
+    def parse_html(html)
+      HTMLPipeline.parse(html)
+    end
+
+    # Helper method for filter subclasses used to determine if any of a node's
+    # ancestors have one of the tag names specified.
+    #
+    # node - The Node object to check.
+    # tags - An array of tag name strings to check. These should be downcase.
+    #
+    # Returns true when the node has a matching ancestor.
+    def has_ancestor?(node, tags)
+      while (node = node.parent)
+        break true if tags.include?(node.name.downcase)
+      end
+    end
+
+    # Perform a filter on doc with the given context.
+    #
+    # Returns a HTMLPipeline::DocumentFragment or a String containing HTML
+    # markup.
+    def self.call(doc, context: {}, result: {})
+      new(doc, context: context, result: result).call
+    end
+
+    # Like call but guarantees that a DocumentFragment is returned, even when
+    # the last filter returns a String.
+    def self.to_document(input, context: {})
+      html = call(input, context: context)
+      HTMLPipeline.parse(html)
+    end
+
+    # Like call but guarantees that a string of HTML markup is returned.
+    def self.to_html(input, context: {})
+      output = call(input, context: context)
+      if output.respond_to?(:to_html)
+        output.to_html
+      else
+        output.to_s
+      end
+    end
+
+    # Validator for required context. This will check that anything passed in
+    # contexts exists in @contexts
+    #
+    # If any errors are found an ArgumentError will be raised with a
+    # message listing all the missing contexts and the filters that
+    # require them.
+    def needs(*keys)
+      missing = keys.reject { |key| context.include?(key) }
+
+      return unless missing.any?
+
+      raise ArgumentError,
+        "Missing context keys for #{self.class.name}: #{missing.map(&:inspect).join(", ")}"
+    end
+  end
+end
diff --git a/lib/html_pipeline/https_filter.rb b/lib/html_pipeline/https_filter.rb
new file mode 100644
index 00000000..8ae1f910
--- /dev/null
+++ b/lib/html_pipeline/https_filter.rb
@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+class HTMLPipeline
+  # HTML Filter for replacing http references to :http_url with https versions.
+  # Subdomain references are not rewritten.
+  #
+  # Context options:
+  #   :http_url - The HTTP url to force HTTPS. Falls back to :base_url
+  class HttpsFilter < Filter
+    def call
+      doc.css(%(a[href^="#{http_url}"])).each do |element|
+        element["href"] = element["href"].sub(/^http:/, "https:")
+      end
+      doc
+    end
+
+    # HTTP url to replace. Falls back to :base_url
+    def http_url
+      context[:http_url] || context[:base_url]
+    end
+
+    # Raise error if :http_url undefined
+    def validate
+      needs(:http_url) unless http_url
+    end
+  end
+end
diff --git a/lib/html_pipeline/image_filter.rb b/lib/html_pipeline/image_filter.rb
new file mode 100644
index 00000000..10b7fe46
--- /dev/null
+++ b/lib/html_pipeline/image_filter.rb
@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+class HTMLPipeline
+  # HTML Filter that converts image's url into <img> tag.
+  # For example, it will convert
+  #   http://example.com/test.jpg
+  # into
+  #   <img src="http://example.com/test.jpg" alt=""/>.
+
+  class ImageFilter < TextFilter
+    def call
+      @text.gsub(%r{(https|http)?://.+\.(jpg|jpeg|bmp|gif|png)(\?\S+)?}i) do |match|
+        %(<img src="#{match}" alt=""/>)
+      end
+    end
+  end
+end
diff --git a/lib/html_pipeline/image_max_width_filter.rb b/lib/html_pipeline/image_max_width_filter.rb
new file mode 100644
index 00000000..8d2d6b47
--- /dev/null
+++ b/lib/html_pipeline/image_max_width_filter.rb
@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+class HTMLPipeline
+  # This filter rewrites image tags with a max-width inline style and also wraps
+  # the image in an <a> tag that causes the full size image to be opened in a
+  # new tab.
+  #
+  # The max-width inline styles are especially useful in HTML email which
+  # don't use a global stylesheets.
+  class ImageMaxWidthFilter < Filter
+    def call
+      doc.search("img").each do |element|
+        # Skip if there's already a style attribute. Not sure how this
+        # would happen but we can reconsider it in the future.
+        next if element["style"]
+
+        # Bail out if src doesn't look like a valid http url. trying to avoid weird
+        # js injection via javascript: urls.
+        next if /\Ajavascript/i.match?(element["src"].to_s.strip)
+
+        element["style"] = "max-width:100%;"
+
+        link_image(element) unless has_ancestor?(element, ["a"])
+      end
+
+      doc
+    end
+
+    def link_image(element)
+      link = doc.document.create_element("a", href: element["src"], target: "_blank")
+      link.add_child(element.dup)
+      element.replace(link)
+    end
+  end
+end
diff --git a/lib/html_pipeline/markdown_filter.rb b/lib/html_pipeline/markdown_filter.rb
new file mode 100644
index 00000000..d1323fbf
--- /dev/null
+++ b/lib/html_pipeline/markdown_filter.rb
@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+HTMLPipeline.require_dependency("commonmarker", "MarkdownFilter")
+
+class HTMLPipeline
+  # HTML Filter that converts Markdown text into HTML and converts into a
+  # DocumentFragment. This is different from most filters in that it can take a
+  # non-HTML as input. It must be used as the first filter in a pipeline.
+  #
+  # Context options:
+  #   :gfm      => false    Disable GFM line-end processing
+  #   :commonmarker_extensions => [ :table, :strikethrough,
+  #      :tagfilter, :autolink ] Commonmarker extensions to include
+  #
+  # This filter does not write any additional information to the context hash.
+  class MarkdownFilter < TextFilter
+    DEFAULT_COMMONMARKER_EXTENSIONS = [:table, :strikethrough, :tagfilter, :autolink].freeze
+
+    def initialize(text, context: {}, result: {})
+      super(text, context: context, result: result)
+      @text = @text.delete("\r")
+    end
+
+    # Convert Markdown to HTML using the best available implementation
+    # and convert into a DocumentFragment.
+    def call
+      extensions = context.fetch(
+        :commonmarker_extensions,
+        DEFAULT_COMMONMARKER_EXTENSIONS
+      )
+      html = if (renderer = context[:commonmarker_renderer])
+        raise ArgumentError, "`commonmark_renderer` must be derived from `CommonMarker::HtmlRenderer`" unless renderer < CommonMarker::HtmlRenderer
+
+        parse_options = :DEFAULT
+        parse_options = [:UNSAFE] if context[:unsafe]
+
+        render_options = [:GITHUB_PRE_LANG]
+        render_options << :HARDBREAKS if context[:gfm] != false
+        render_options << :UNSAFE if context[:unsafe]
+
+        doc = CommonMarker.render_doc(@text, parse_options, extensions)
+        renderer.new(options: render_options, extensions: extensions).render(doc)
+      else
+        options = [:GITHUB_PRE_LANG]
+        options << :HARDBREAKS if context[:gfm] != false
+        options << :UNSAFE if context[:unsafe]
+        CommonMarker.render_html(@text, options, extensions)
+      end
+      html.rstrip!
+      html
+    end
+  end
+end
diff --git a/lib/html_pipeline/mention_filter.rb b/lib/html_pipeline/mention_filter.rb
new file mode 100644
index 00000000..519a5425
--- /dev/null
+++ b/lib/html_pipeline/mention_filter.rb
@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+require "set"
+
+class HTMLPipeline
+  # HTML filter that replaces @user mentions with links. Mentions within <pre>,
+  # <code>, and <a> elements are ignored. Mentions that reference users that do
+  # not exist are ignored.
+  #
+  # Context options:
+  #   :base_url - Used to construct links to user profile pages for each
+  #               mention.
+  #   :info_url - Used to link to "more info" when someone mentions @mention
+  #               or @mentioned.
+  #   :username_pattern - Used to provide a custom regular expression to
+  #                       identify usernames
+  #
+  class MentionFilter < Filter
+    # Public: Find user @mentions in text.  See
+    # MentionFilter#mention_link_filter.
+    #
+    #   MentionFilter.mentioned_logins_in(text) do |match, login, is_mentioned|
+    #     "<a href=...>#{login}</a>"
+    #   end
+    #
+    # text - String text to search.
+    #
+    # Yields the String match, the String login name, and a Boolean determining
+    # if the match = "@mention[ed]".  The yield's return replaces the match in
+    # the original text.
+    #
+    # Returns a String replaced with the return of the block.
+    def self.mentioned_logins_in(text, username_pattern = USERNAME_PATTERN)
+      text.gsub(MENTION_PATTERNS[username_pattern]) do |match|
+        login = Regexp.last_match(1)
+        yield match, login
+      end
+    end
+
+    # Hash that contains all of the mention patterns used by the pipeline
+    MENTION_PATTERNS = Hash.new do |hash, key|
+      hash[key] = %r{
+        (?:^|\W)                    # beginning of string or non-word char
+        @((?>#{key}))  # @username
+        (?!/)                      # without a trailing slash
+        (?=
+          \.+[ \t\W]|               # dots followed by space or non-word character
+          \.+$|                     # dots at end of line
+          [^0-9a-zA-Z_.]|           # non-word character except dot
+          $                         # end of line
+        )
+      }ix
+    end
+
+    # Default pattern used to extract usernames from text. The value can be
+    # overriden by providing the username_pattern variable in the context.
+    USERNAME_PATTERN = /[a-z0-9][a-z0-9-]*/.freeze
+
+    # Don't look for mentions in text nodes that are children of these elements
+    IGNORE_PARENTS = ["pre", "code", "a", "style", "script"].to_set
+
+    def call
+      result[:mentioned_usernames] ||= []
+
+      doc.search(".//text()").each do |node|
+        content = node.to_html
+        next unless content.include?("@")
+        next if has_ancestor?(node, IGNORE_PARENTS)
+
+        html = mention_link_filter(content, base_url: base_url, username_pattern: username_pattern)
+        next if html == content
+
+        node.replace(html)
+      end
+      doc
+    end
+
+    # The URL to provide when someone @mentions a "mention" name, such
+    # as @mention or @mentioned, that will give them more info on mentions.
+    def info_url
+      context[:info_url] || nil
+    end
+
+    def username_pattern
+      context[:username_pattern] || USERNAME_PATTERN
+    end
+
+    # Replace user @mentions in text with links to the mentioned user's
+    # profile page.
+    #
+    # text      - String text to replace @mention usernames in.
+    # base_url  - The base URL used to construct user profile URLs.
+    # info_url  - The "more info" URL used to link to more info on @mentions.
+    #             If nil we don't link @mention or @mentioned.
+    # username_pattern  - Regular expression used to identify usernames in
+    #                     text
+    #
+    # Returns a string with @mentions replaced with links. All links have a
+    # 'user-mention' class name attached for styling.
+    def mention_link_filter(text, base_url: "/", username_pattern: USERNAME_PATTERN)
+      self.class.mentioned_logins_in(text, username_pattern) do |match, login|
+        link = link_to_mentioned_user(base_url, login)
+
+        link ? match.sub("@#{login}", link) : match
+      end
+    end
+
+    def link_to_mentioned_user(base_url, login)
+      result[:mentioned_usernames] |= [login]
+
+      url = base_url.dup
+      url << "/" unless %r{[/~]\z}.match?(url)
+
+      "<a href='#{url << login}' class='user-mention'>" \
+        "@#{login}" \
+        "</a>"
+    end
+  end
+end
diff --git a/lib/html_pipeline/plain_text_input_filter.rb b/lib/html_pipeline/plain_text_input_filter.rb
new file mode 100644
index 00000000..53d7b3ca
--- /dev/null
+++ b/lib/html_pipeline/plain_text_input_filter.rb
@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+HTMLPipeline.require_dependency("escape_utils", "PlainTextInputFilter")
+
+class HTMLPipeline
+  # Simple filter for plain text input. HTML escapes the text input and wraps it
+  # in a div.
+  class PlainTextInputFilter < TextFilter
+    def call
+      "<div>#{EscapeUtils.escape_html(@text, false)}</div>"
+    end
+  end
+end
diff --git a/lib/html_pipeline/sanitization_filter.rb b/lib/html_pipeline/sanitization_filter.rb
new file mode 100644
index 00000000..a8605b8a
--- /dev/null
+++ b/lib/html_pipeline/sanitization_filter.rb
@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+HTMLPipeline.require_dependency("sanitize", "SanitizationFilter")
+
+class HTMLPipeline
+  # HTML filter with sanization routines and allowlists. This module defines
+  # what HTML is allowed in user provided content and fixes up issues with
+  # unbalanced tags and whatnot.
+  #
+  # See the Sanitize docs for more information on the underlying library:
+  #
+  # https://github.com/rgrove/sanitize/#readme
+  #
+  # Context options:
+  #   :allowlist      - The sanitizer allowlist configuration to use. This
+  #                     can be one of the options constants defined in this
+  #                     class or a custom sanitize options hash.
+  #   :anchor_schemes - The URL schemes to allow in <a href> attributes. The
+  #                     default set is provided in the ANCHOR_SCHEMES
+  #                     constant in this class. If passed, this overrides any
+  #                     schemes specified in the allowlist configuration.
+  #
+  # This filter does not write additional information to the context.
+  class SanitizationFilter < Filter
+    LISTS     = Set.new(["ul", "ol"].freeze)
+    LIST_ITEM = "li"
+
+    # List of table child elements. These must be contained by a <table> element
+    # or they are not allowed through. Otherwise they can be used to break out
+    # of places we're using tables to contain formatted user content (like pull
+    # request review comments).
+    TABLE_ITEMS = Set.new(["tr", "td", "th"].freeze)
+    TABLE = "table"
+    TABLE_SECTIONS = Set.new(["thead", "tbody", "tfoot"].freeze)
+
+    # These schemes are the only ones allowed in <a href> attributes by default.
+    ANCHOR_SCHEMES = ["http", "https", "mailto", "xmpp", :relative, "github-windows", "github-mac", "irc", "ircs"].freeze
+
+    # The main sanitization allowlist. Only these elements and attributes are
+    # allowed through by default.
+    ALLOWLIST = {
+      elements: ["h1", "h2", "h3", "h4", "h5", "h6", "h7", "h8", "br", "b", "i", "strong", "em", "a", "pre", "code", "img", "tt", "div", "ins", "del", "sup", "sub", "p", "ol", "ul", "table", "thead", "tbody", "tfoot", "blockquote", "dl", "dt", "dd", "kbd", "q", "samp", "var", "hr", "ruby", "rt", "rp", "li", "tr", "td", "th", "s", "strike", "summary", "details", "caption", "figure", "figcaption", "abbr", "bdo", "cite", "dfn", "mark", "small", "span", "time", "wbr"].freeze,
+      remove_contents: ["script"].freeze,
+      attributes: {
+        "a" => ["href"].freeze,
+        "img" => ["src", "longdesc"].freeze,
+        "div" => ["itemscope", "itemtype"].freeze,
+        "blockquote" => ["cite"].freeze,
+        "del" => ["cite"].freeze,
+        "ins" => ["cite"].freeze,
+        "q" => ["cite"].freeze,
+        all: ["abbr", "accept", "accept-charset", "accesskey", "action", "align", "alt", "aria-describedby", "aria-hidden", "aria-label", "aria-labelledby", "axis", "border", "cellpadding", "cellspacing", "char", "charoff", "charset", "checked", "clear", "cols", "colspan", "color", "compact", "coords", "datetime", "dir", "disabled", "enctype", "for", "frame", "headers", "height", "hreflang", "hspace", "ismap", "label", "lang", "maxlength", "media", "method", "multiple", "name", "nohref", "noshade", "nowrap", "open", "progress", "prompt", "readonly", "rel", "rev", "role", "rows", "rowspan", "rules", "scope", "selected", "shape", "size", "span", "start", "summary", "tabindex", "target", "title", "type", "usemap", "valign", "value", "vspace", "width", "itemprop"].freeze,
+      }.freeze,
+      protocols: {
+        "a" => { "href" => ANCHOR_SCHEMES }.freeze,
+        "blockquote" => { "cite" => ["http", "https", :relative].freeze },
+        "del" => { "cite" => ["http", "https", :relative].freeze },
+        "ins" => { "cite" => ["http", "https", :relative].freeze },
+        "q" => { "cite" => ["http", "https", :relative].freeze },
+        "img" => {
+          "src" => ["http", "https", :relative].freeze,
+          "longdesc" => ["http", "https", :relative].freeze,
+        }.freeze,
+      },
+      transformers: [
+        # Top-level <li> elements are removed because they can break out of
+        # containing markup.
+        lambda { |env|
+          name = env[:node_name]
+          node = env[:node]
+          node.replace(node.children) if name == LIST_ITEM && node.ancestors.none? { |n| LISTS.include?(n.name) }
+        },
+
+        # Table child elements that are not contained by a <table> are removed.
+        lambda { |env|
+          name = env[:node_name]
+          node = env[:node]
+          node.replace(node.children) if (TABLE_SECTIONS.include?(name) || TABLE_ITEMS.include?(name)) && node.ancestors.none? { |n| n.name == TABLE }
+        },
+      ].freeze,
+    }.freeze
+
+    # A more limited sanitization allowlist. This includes all attributes,
+    # protocols, and transformers from ALLOWLIST but with a more locked down
+    # set of allowed elements.
+    LIMITED = ALLOWLIST.merge(
+      elements: ["b", "i", "strong", "em", "a", "pre", "code", "img", "ins", "del", "sup", "sub", "mark", "abbr", "p", "ol", "ul", "li"]
+    )
+
+    # Strip all HTML tags from the document.
+    FULL = { elements: [] }.freeze
+
+    # Sanitize markup using the Sanitize library.
+    def call
+      Sanitize.clean_node!(doc, allowlist)
+    end
+
+    # The allowlist to use when sanitizing. This can be passed in the context
+    # hash to the filter but defaults to ALLOWLIST constant value above.
+    def allowlist
+      allowlist = context[:allowlist] || ALLOWLIST
+      anchor_schemes = context[:anchor_schemes]
+      return allowlist unless anchor_schemes
+
+      allowlist = allowlist.dup
+      allowlist[:protocols] = (allowlist[:protocols] || {}).dup
+      allowlist[:protocols]["a"] = (allowlist[:protocols]["a"] || {}).merge("href" => anchor_schemes)
+      allowlist
+    end
+  end
+end
diff --git a/lib/html_pipeline/syntax_highlight_filter.rb b/lib/html_pipeline/syntax_highlight_filter.rb
new file mode 100644
index 00000000..03b28ad3
--- /dev/null
+++ b/lib/html_pipeline/syntax_highlight_filter.rb
@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+HTMLPipeline.require_dependency("rouge", "SyntaxHighlightFilter")
+
+class HTMLPipeline
+  # HTML Filter that syntax highlights text inside code blocks.
+  #
+  # Context options:
+  #
+  #   :highlight => String represents the language to pick lexer. Defaults to empty string.
+  #   :scope => String represents the class attribute adds to pre element after.
+  #             Defaults to "highlight highlight-css" if highlights a css code block.
+  #
+  # This filter does not write any additional information to the context hash.
+  class SyntaxHighlightFilter < Filter
+    def initialize(doc, context: {}, result: {})
+      super(doc, context: context, result: result)
+      @formatter = Rouge::Formatters::HTML.new
+    end
+
+    def call
+      doc.search("pre").each do |node|
+        default = context[:highlight]&.to_s
+        next unless (lang = node["lang"] || default)
+        next unless (lexer = lexer_for(lang))
+
+        text = node.inner_text
+        html = highlight_with_timeout_handling(text, lexer)
+        next if html.nil?
+
+        node.inner_html = html
+        scope = context.fetch(:scope, "highlight")
+        node["class"] = "#{scope} #{scope}-#{lang}"
+      end
+      doc
+    end
+
+    def highlight_with_timeout_handling(text, lexer)
+      Rouge.highlight(text, lexer, @formatter)
+    rescue Timeout::Error => _e
+      nil
+    end
+
+    def lexer_for(lang)
+      Rouge::Lexer.find(lang)
+    end
+  end
+end
diff --git a/lib/html_pipeline/table_of_contents_filter.rb b/lib/html_pipeline/table_of_contents_filter.rb
new file mode 100644
index 00000000..75f75318
--- /dev/null
+++ b/lib/html_pipeline/table_of_contents_filter.rb
@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+HTMLPipeline.require_dependency("escape_utils", "TableOfContentsFilter")
+
+class HTMLPipeline
+  # HTML filter that adds an 'id' attribute to all headers
+  # in a document, so they can be accessed from a table of contents.
+  #
+  # Generates the Table of Contents, with links to each header.
+  #
+  # Examples
+  #
+  #  TocPipeline =
+  #    HTMLPipeline.new [
+  #      HTMLPipeline::TableOfContentsFilter
+  #    ]
+  #  # => #<HTMLPipeline:0x007fc13c4528d8...>
+  #  orig = %(<h1>Ice cube</h1><p>is not for the pop chart</p>)
+  #  # => "<h1>Ice cube</h1><p>is not for the pop chart</p>"
+  #  result = {}
+  #  # => {}
+  #  TocPipeline.call(orig, {}, result)
+  #  # => {:toc=> ...}
+  #  result[:toc]
+  #  # => "<ul class=\"section-nav\">\n<li><a href=\"#ice-cube\">...</li><ul>"
+  #  result[:output].to_s
+  #  # => "<h1>\n<a id=\"ice-cube\" class=\"anchor\" href=\"#ice-cube\">..."
+  class TableOfContentsFilter < Filter
+    PUNCTUATION_REGEXP = RUBY_VERSION > "1.9" ? /[^\p{Word}\- ]/u : /[^\w\- ]/
+
+    # The icon that will be placed next to an anchored rendered markdown header
+    def anchor_icon
+      context[:anchor_icon] || '<span aria-hidden="true" class="octicon octicon-link"></span>'
+    end
+
+    def call
+      result[:toc] = +""
+
+      headers = Hash.new(0)
+      doc.css("h1, h2, h3, h4, h5, h6").each do |node|
+        text = node.text
+        id = ascii_downcase(text)
+        id.gsub!(PUNCTUATION_REGEXP, "") # remove punctuation
+        id.tr!(" ", "-") # replace spaces with dash
+
+        uniq = (headers[id]).positive? ? "-#{headers[id]}" : ""
+        headers[id] += 1
+        if (header_content = node.children.first)
+          result[:toc] << %(<li><a href="##{id}#{uniq}">#{EscapeUtils.escape_html(text)}</a></li>\n)
+          header_content.add_previous_sibling(%(<a id="#{id}#{uniq}" class="anchor" href="##{id}#{uniq}" aria-hidden="true">#{anchor_icon}</a>))
+        end
+      end
+      result[:toc] = %(<ul class="section-nav">\n#{result[:toc]}</ul>) unless result[:toc].empty?
+      doc
+    end
+
+    if RUBY_VERSION >= "2.4"
+      def ascii_downcase(str)
+        str.downcase(:ascii)
+      end
+    else
+      def ascii_downcase(str)
+        str.downcase
+      end
+    end
+  end
+end
diff --git a/lib/html_pipeline/team_mention_filter.rb b/lib/html_pipeline/team_mention_filter.rb
new file mode 100644
index 00000000..e387c3a8
--- /dev/null
+++ b/lib/html_pipeline/team_mention_filter.rb
@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+require "set"
+
+class HTMLPipeline
+  # HTML filter that replaces @org/team mentions with links. Mentions within
+  # <pre>, <code>, <a>, <style>, and <script> elements are ignored.
+  #
+  # Context options:
+  #   :base_url - Used to construct links to team profile pages for each
+  #               mention.
+  #   :team_pattern - Used to provide a custom regular expression to
+  #                       identify team names
+  #
+  class TeamMentionFilter < Filter
+    # Public: Find @org/team mentions in text.  See
+    # TeamMentionFilter#team_mention_link_filter.
+    #
+    #   TeamMentionFilter.mentioned_teams_in(text) do |match, org, team|
+    #     "<a href=...>#{team}</a>"
+    #   end
+    #
+    # text - String text to search.
+    #
+    # Yields the String match, org name, and team name.  The yield's
+    # return replaces the match in the original text.
+    #
+    # Returns a String replaced with the return of the block.
+    def self.mentioned_teams_in(text, team_pattern = TEAM_PATTERN)
+      text.gsub(team_pattern) do |match|
+        org = Regexp.last_match(1)
+        team = Regexp.last_match(2)
+        yield match, org, team
+      end
+    end
+
+    # Default pattern used to extract team names from text. The value can be
+    # overridden by providing the team_pattern variable in the context. To
+    # properly link the mention, should be in the format of /@(1)\/(2)/.
+    TEAM_PATTERN = %r{
+      (?<=^|\W)                  # beginning of string or non-word char
+      @([a-z0-9][a-z0-9-]*)      # @organization
+        /                       # dividing slash
+        ([a-z0-9][a-z0-9\-_]*)   # team
+        \b
+    }ix.freeze
+
+    # Don't look for mentions in text nodes that are children of these elements
+    IGNORE_PARENTS = ["pre", "code", "a", "style", "script"].to_set
+
+    def call
+      result[:mentioned_teams] ||= []
+
+      doc.search(".//text()").each do |node|
+        content = node.to_html
+        next unless content.include?("@")
+        next if has_ancestor?(node, IGNORE_PARENTS)
+
+        html = mention_link_filter(content, base_url: base_url, team_pattern: team_pattern)
+        next if html == content
+
+        node.replace(html)
+      end
+      doc
+    end
+
+    def team_pattern
+      context[:team_pattern] || TEAM_PATTERN
+    end
+
+    # Replace @org/team mentions in text with links to the mentioned team's
+    # page.
+    #
+    # text      - String text to replace @mention team names in.
+    # base_url  - The base URL used to construct team page URLs.
+    # team_pattern  - Regular expression used to identify teams in text
+    #
+    # Returns a string with @team mentions replaced with links. All links have a
+    # 'team-mention' class name attached for styling.
+    def mention_link_filter(text, base_url: "/", team_pattern: TEAM_PATTERN)
+      self.class.mentioned_teams_in(text, team_pattern) do |match, org, team|
+        link = link_to_mentioned_team(base_url, org, team)
+
+        link ? match.sub("@#{org}/#{team}", link) : match
+      end
+    end
+
+    def link_to_mentioned_team(base_url, org, team)
+      result[:mentioned_teams] |= [team]
+
+      url = base_url.dup
+      url << "/" unless %r{[/~]\z}.match?(url)
+
+      "<a href='#{url << org}/#{team}' class='team-mention'>" \
+        "@#{org}/#{team}" \
+        "</a>"
+    end
+  end
+end
diff --git a/lib/html_pipeline/text_filter.rb b/lib/html_pipeline/text_filter.rb
new file mode 100644
index 00000000..a01ec874
--- /dev/null
+++ b/lib/html_pipeline/text_filter.rb
@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class HTMLPipeline
+  class TextFilter < Filter
+    attr_reader :text
+
+    def initialize(text, context: {}, result: {})
+      raise TypeError, "text cannot be HTML" if text.is_a?(DocumentFragment)
+
+      # Ensure that this is always a string
+      @text = text.respond_to?(:to_str) ? text.to_str : text.to_s
+      super(nil, context: context, result: result)
+    end
+  end
+end
diff --git a/lib/html_pipeline/version.rb b/lib/html_pipeline/version.rb
new file mode 100644
index 00000000..f727e736
--- /dev/null
+++ b/lib/html_pipeline/version.rb
@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+class HTMLPipeline
+  VERSION = "2.13.2"
+end
diff --git a/test/helpers/mocked_instrumentation_service.rb b/test/helpers/mocked_instrumentation_service.rb
index 947e177d..0e344bae 100644
--- a/test/helpers/mocked_instrumentation_service.rb
+++ b/test/helpers/mocked_instrumentation_service.rb
@@ -5,7 +5,7 @@ class MockedInstrumentationService
 
   def initialize(event = nil, events = [])
     @events = events
-    subscribe event
+    subscribe(event)
   end
 
   def instrument(event, payload = nil)
diff --git a/test/html/pipeline/absolute_source_filter_test.rb b/test/html/pipeline/absolute_source_filter_test.rb
deleted file mode 100644
index 9ac4a7f9..00000000
--- a/test/html/pipeline/absolute_source_filter_test.rb
+++ /dev/null
@@ -1,56 +0,0 @@
-# frozen_string_literal: true
-
-require 'test_helper'
-
-class HTML::Pipeline::AbsoluteSourceFilterTest < Minitest::Test
-  AbsoluteSourceFilter = HTML::Pipeline::AbsoluteSourceFilter
-
-  def setup
-    @image_base_url = 'http://assets.example.com'
-    @image_subpage_url = 'http://blog.example.com/a/post'
-    @options = {
-      image_base_url: @image_base_url,
-      image_subpage_url: @image_subpage_url
-    }
-  end
-
-  def test_rewrites_root_urls
-    orig = %(<p><img src="/img.png"></p>)
-    assert_equal "<p><img src=\"#{@image_base_url}/img.png\"></p>",
-                 AbsoluteSourceFilter.call(orig, context: @options).to_s
-  end
-
-  def test_rewrites_relative_urls
-    orig = %(<p><img src="post/img.png"></p>)
-    assert_equal "<p><img src=\"#{@image_subpage_url}/img.png\"></p>",
-                 AbsoluteSourceFilter.call(orig, context: @options).to_s
-  end
-
-  def test_does_not_rewrite_absolute_urls
-    orig = %(<p><img src="http://other.example.com/img.png"></p>)
-    result = AbsoluteSourceFilter.call(orig, context: @options).to_s
-    refute_match(/@image_base_url/, result)
-    refute_match(/@image_subpage_url/, result)
-  end
-
-  def test_fails_when_context_is_missing
-    assert_raises RuntimeError do
-      AbsoluteSourceFilter.call('<img src="img.png">', context: {})
-    end
-    assert_raises RuntimeError do
-      AbsoluteSourceFilter.call('<img src="/img.png">', context: {})
-    end
-  end
-
-  def test_tells_you_where_context_is_required
-    exception = assert_raises(RuntimeError) do
-      AbsoluteSourceFilter.call('<img src="img.png">', context: {})
-    end
-    assert_match 'HTML::Pipeline::AbsoluteSourceFilter', exception.message
-
-    exception = assert_raises(RuntimeError) do
-      AbsoluteSourceFilter.call('<img src="/img.png">', context: {})
-    end
-    assert_match 'HTML::Pipeline::AbsoluteSourceFilter', exception.message
-  end
-end
diff --git a/test/html/pipeline/autolink_filter_test.rb b/test/html/pipeline/autolink_filter_test.rb
deleted file mode 100644
index 086e3bc1..00000000
--- a/test/html/pipeline/autolink_filter_test.rb
+++ /dev/null
@@ -1,57 +0,0 @@
-# frozen_string_literal: true
-
-require 'test_helper'
-
-AutolinkFilter = HTML::Pipeline::AutolinkFilter
-
-class HTML::Pipeline::AutolinkFilterTest < Minitest::Test
-  def test_uses_rinku_for_autolinking
-    # just try to parse a complicated piece of HTML
-    # that Rails auto_link cannot handle
-    assert_equal '<p>"<a href="http://www.github.com">http://www.github.com</a>"</p>',
-                 AutolinkFilter.to_html('<p>"http://www.github.com"</p>')
-  end
-
-  def test_autolink_option
-    assert_equal '<p>"http://www.github.com"</p>',
-                 AutolinkFilter.to_html('<p>"http://www.github.com"</p>', context: { autolink: false })
-  end
-
-  def test_autolink_link_attr
-    assert_equal '<p>"<a href="http://www.github.com" target="_blank">http://www.github.com</a>"</p>',
-                 AutolinkFilter.to_html('<p>"http://www.github.com"</p>', context: { link_attr: 'target="_blank"' })
-  end
-
-  def test_autolink_flags
-    assert_equal '<p>"<a href="http://github">http://github</a>"</p>',
-                 AutolinkFilter.to_html('<p>"http://github"</p>', context: { flags: Rinku::AUTOLINK_SHORT_DOMAINS })
-  end
-
-  def test_autolink_skip_tags
-    assert_equal '<code>"http://github.com"</code>',
-                 AutolinkFilter.to_html('<code>"http://github.com"</code>')
-
-    assert_equal '<code>"<a href="http://github.com">http://github.com</a>"</code>',
-                 AutolinkFilter.to_html('<code>"http://github.com"</code>', context: { skip_tags: %w[kbd script] })
-  end
-
-  def test_link_mode_default
-    assert_equal '<p>"<a href="http://www.github.com">http://www.github.com</a>"</p><p>"user@example.com"</p>',
-                 AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>')
-  end
-
-  def test_link_mode_urls
-    assert_equal '<p>"<a href="http://www.github.com">http://www.github.com</a>"</p><p>"user@example.com"</p>',
-                 AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :urls })
-  end
-
-  def test_link_mode_all
-    assert_equal '<p>"<a href="http://www.github.com">http://www.github.com</a>"</p><p>"<a href="mailto:user@example.com">user@example.com</a>"</p>',
-                 AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :all })
-  end
-
-  def test_link_mode_email_addresses
-    assert_equal '<p>"http://www.github.com"</p><p>"<a href="mailto:user@example.com">user@example.com</a>"</p>',
-                 AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :email_addresses })
-  end
-end
diff --git a/test/html/pipeline/emoji_filter_test.rb b/test/html/pipeline/emoji_filter_test.rb
deleted file mode 100644
index 3dc4b5c7..00000000
--- a/test/html/pipeline/emoji_filter_test.rb
+++ /dev/null
@@ -1,119 +0,0 @@
-# frozen_string_literal: true
-
-require 'test_helper'
-
-class HTML::Pipeline::EmojiFilterTest < Minitest::Test
-  def setup
-    @emoji_filter = HTML::Pipeline::EmojiFilter
-  end
-
-  def test_emojify
-    filter = @emoji_filter.new('<p>:shipit:</p>', context: { asset_root: 'https://foo.com' })
-    doc = filter.call
-    assert_match 'https://foo.com/emoji/shipit.png', doc.search('img').attr('src').value
-  end
-
-  def test_uri_encoding
-    filter = @emoji_filter.new('<p>:+1:</p>', context: { asset_root: 'https://foo.com' })
-    doc = filter.call
-    assert_match 'https://foo.com/emoji/unicode/1f44d.png', doc.search('img').attr('src').value
-  end
-
-  def test_required_context_validation
-    exception = assert_raises(ArgumentError) do
-      @emoji_filter.call('', context: {})
-    end
-    assert_match(/:asset_root/, exception.message)
-  end
-
-  def test_custom_asset_path
-    filter = @emoji_filter.new('<p>:+1:</p>', context: { asset_path: ':file_name', asset_root: 'https://foo.com' })
-    doc = filter.call
-    assert_match 'https://foo.com/unicode/1f44d.png', doc.search('img').attr('src').value
-  end
-
-  def test_not_emojify_in_code_tags
-    body = '<code>:shipit:</code>'
-    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com' })
-    doc = filter.call
-    assert_equal body, doc.to_html
-  end
-
-  def test_not_emojify_in_tt_tags
-    body = '<tt>:shipit:</tt>'
-    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com' })
-    doc = filter.call
-    assert_equal body, doc.to_html
-  end
-
-  def test_not_emojify_in_pre_tags
-    body = '<pre>:shipit:</pre>'
-    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com' })
-    doc = filter.call
-    assert_equal body, doc.to_html
-  end
-
-  def test_not_emojify_in_custom_single_tag_foo
-    body = '<foo>:shipit:</foo>'
-    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com', ignored_ancestor_tags: %w[foo] })
-    doc = filter.call
-    assert_equal body, doc.to_html
-  end
-
-  def test_not_emojify_in_custom_multiple_tags_foo_and_bar
-    body = '<bar>:shipit:</bar>'
-    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com', ignored_ancestor_tags: %w[foo bar] })
-    doc = filter.call
-    assert_equal body, doc.to_html
-  end
-
-  def test_img_tag_attributes
-    body = ':shipit:'
-    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com' })
-    doc = filter.call
-    assert_equal %(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" height="20" width="20" align="absmiddle">), doc.to_html
-  end
-
-  def test_img_tag_attributes_can_be_customized
-    body = ':shipit:'
-    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com', img_attrs: Hash('draggable' => 'false', 'height' => nil, 'width' => nil, 'align' => nil) })
-    doc = filter.call
-    assert_equal %(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" draggable="false">), doc.to_html
-  end
-
-  def test_img_attrs_value_can_accept_proclike_object
-    remove_colons = ->(name) { name.delete(':') }
-    body = ':shipit:'
-    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com', img_attrs: Hash('title' => remove_colons) })
-    doc = filter.call
-    assert_equal %(<img class="emoji" title="shipit" alt=":shipit:" src="https://foo.com/emoji/shipit.png" height="20" width="20" align="absmiddle">), doc.to_html
-  end
-
-  def test_img_attrs_can_accept_symbolized_keys
-    body = ':shipit:'
-    filter = @emoji_filter.new(body, context: { asset_root: 'https://foo.com', img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
-    doc = filter.call
-    assert_equal %(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" draggable="false">), doc.to_html
-  end
-
-  def test_works_with_gemoji
-    require 'gemojione'
-
-    HTML::Pipeline::EmojiFilter.stub :gemoji_loaded?, false do
-      body = ':flag_ar:'
-      filter = HTML::Pipeline::EmojiFilter.new(body, context: { asset_root: 'https://foo.com' })
-      doc = filter.call
-      assert_equal %(<img class="emoji" title=":flag_ar:" alt=":flag_ar:" src="https://foo.com/emoji/1f1e6-1f1f7.png" height="20" width="20" align="absmiddle">), doc.to_html
-    end
-  end
-
-  def test_gemoji_can_accept_symbolized_keys
-    require 'gemojione'
-    HTML::Pipeline::EmojiFilter.stub :gemoji_loaded?, false do
-      body = ':flag_ar:'
-      filter = HTML::Pipeline::EmojiFilter.new(body, context: { asset_root: 'https://coolwebsite.com', img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
-      doc = filter.call
-      assert_equal %(<img class="emoji" title=":flag_ar:" alt=":flag_ar:" src="https://coolwebsite.com/emoji/1f1e6-1f1f7.png" draggable="false">), doc.to_html
-    end
-  end
-end
diff --git a/test/html/pipeline/https_filter_test.rb b/test/html/pipeline/https_filter_test.rb
deleted file mode 100644
index 298cf314..00000000
--- a/test/html/pipeline/https_filter_test.rb
+++ /dev/null
@@ -1,51 +0,0 @@
-# frozen_string_literal: true
-
-require 'test_helper'
-
-HttpsFilter = HTML::Pipeline::HttpsFilter
-
-class HTML::Pipeline::HttpsFilterTest < Minitest::Test
-  def setup
-    @filter = HttpsFilter
-    @options = { base_url: 'http://github.com' }
-  end
-
-  def test_http
-    assert_equal %(<a href="https://github.com">github.com</a>),
-                 @filter.to_html(%(<a href="http://github.com">github.com</a>), context: @options)
-  end
-
-  def test_https
-    assert_equal %(<a href="https://github.com">github.com</a>),
-                 @filter.to_html(%(<a href="https://github.com">github.com</a>), context: @options)
-  end
-
-  def test_subdomain
-    assert_equal %(<a href="http://help.github.com">github.com</a>),
-                 @filter.to_html(%(<a href="http://help.github.com">github.com</a>), context: @options)
-  end
-
-  def test_other
-    assert_equal %(<a href="http://github.io">github.io</a>),
-                 @filter.to_html(%(<a href="http://github.io">github.io</a>), context: @options)
-  end
-
-  def test_uses_http_url_over_base_url
-    options = { http_url: 'http://github.com', base_url: 'https://github.com' }
-
-    assert_equal %(<a href="https://github.com">github.com</a>),
-                 @filter.to_html(%(<a href="http://github.com">github.com</a>), context: options)
-  end
-
-  def test_only_http_url
-    options = { http_url: 'http://github.com' }
-
-    assert_equal %(<a href="https://github.com">github.com</a>),
-                 @filter.to_html(%(<a href="http://github.com">github.com</a>), context: options)
-  end
-
-  def test_validates_http_url
-    exception = assert_raises(ArgumentError) { @filter.to_html('') }
-    assert_match 'HTML::Pipeline::HttpsFilter: :http_url', exception.message
-  end
-end
diff --git a/test/html/pipeline/image_filter_test.rb b/test/html/pipeline/image_filter_test.rb
deleted file mode 100644
index e0e8e095..00000000
--- a/test/html/pipeline/image_filter_test.rb
+++ /dev/null
@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-require 'test_helper'
-
-ImageFilter = HTML::Pipeline::ImageFilter
-
-class HTML::Pipeline::ImageFilterTest < Minitest::Test
-  def setup
-    @filter = ImageFilter
-  end
-
-  def test_jpg
-    assert_equal %(<img src="http://example.com/test.jpg" alt=""/>),
-                 @filter.to_html(%(http://example.com/test.jpg))
-  end
-
-  def test_jpeg
-    assert_equal %(<img src="http://example.com/test.jpeg" alt=""/>),
-                 @filter.to_html(%(http://example.com/test.jpeg))
-  end
-
-  def test_bmp
-    assert_equal %(<img src="http://example.com/test.bmp" alt=""/>),
-                 @filter.to_html(%(http://example.com/test.bmp))
-  end
-
-  def test_gif
-    assert_equal %(<img src="http://example.com/test.gif" alt=""/>),
-                 @filter.to_html(%(http://example.com/test.gif))
-  end
-
-  def test_png
-    assert_equal %(<img src="http://example.com/test.png" alt=""/>),
-                 @filter.to_html(%(http://example.com/test.png))
-  end
-
-  def test_https_url
-    assert_equal %(<img src="https://example.com/test.png" alt=""/>),
-                 @filter.to_html(%(https://example.com/test.png))
-  end
-end
diff --git a/test/html/pipeline/image_max_width_filter_test.rb b/test/html/pipeline/image_max_width_filter_test.rb
deleted file mode 100644
index 02306937..00000000
--- a/test/html/pipeline/image_max_width_filter_test.rb
+++ /dev/null
@@ -1,52 +0,0 @@
-# frozen_string_literal: true
-
-require 'test_helper'
-
-class HTML::Pipeline::ImageMaxWidthFilterTest < Minitest::Test
-  def setup
-    @filter = HTML::Pipeline::ImageMaxWidthFilter
-  end
-
-  def test_rewrites_image_style_tags
-    body = "<p>Screenshot: <img src='screenshot.png'></p>"
-    doc  = Nokogiri::HTML::DocumentFragment.parse(body)
-
-    res = @filter.call(doc)
-    assert_equal_html '<p>Screenshot: <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
-                      res.to_html
-  end
-
-  def test_leaves_existing_image_style_tags_alone
-    body = "<p><img src='screenshot.png' style='width:100px;'></p>"
-    doc  = Nokogiri::HTML::DocumentFragment.parse(body)
-
-    res = @filter.call(doc)
-    assert_equal_html '<p><img src="screenshot.png" style="width:100px;"></p>',
-                      res.to_html
-  end
-
-  def test_links_to_image
-    body = "<p>Screenshot: <img src='screenshot.png'></p>"
-    doc  = Nokogiri::HTML::DocumentFragment.parse(body)
-
-    res = @filter.call(doc)
-    assert_equal_html '<p>Screenshot: <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
-                      res.to_html
-  end
-
-  def test_doesnt_link_to_image_when_already_linked
-    body = "<p>Screenshot: <a href='blah.png'><img src='screenshot.png'></a></p>"
-    doc  = Nokogiri::HTML::DocumentFragment.parse(body)
-
-    res = @filter.call(doc)
-    assert_equal_html '<p>Screenshot: <a href="blah.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
-                      res.to_html
-  end
-
-  def test_doesnt_screw_up_inlined_images
-    body = "<p>Screenshot <img src='screenshot.png'>, yes, this is a <b>screenshot</b> indeed.</p>"
-    doc  = Nokogiri::HTML::DocumentFragment.parse(body)
-
-    assert_equal_html '<p>Screenshot <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a>, yes, this is a <b>screenshot</b> indeed.</p>', @filter.call(doc).to_html
-  end
-end
diff --git a/test/html/pipeline/markdown_filter_test.rb b/test/html/pipeline/markdown_filter_test.rb
deleted file mode 100644
index 81757497..00000000
--- a/test/html/pipeline/markdown_filter_test.rb
+++ /dev/null
@@ -1,178 +0,0 @@
-# frozen_string_literal: true
-
-require 'test_helper'
-
-MarkdownFilter = HTML::Pipeline::MarkdownFilter
-
-class HTML::Pipeline::MarkdownFilterTest < Minitest::Test
-  class CustomRenderer < CommonMarker::HtmlRenderer
-    def header(node)
-      block do
-        text = node.first_child.string_content
-        level = node.header_level
-        out("{level: #{level}, text: #{text}}")
-        super
-      end
-    end
-  end
-
-  def setup
-    @haiku =
-      "Pointing at the moon\n" \
-      "Reminded of simple things\n" \
-      'Moments matter most'
-    @links =
-      'See http://example.org/ for more info'
-    @code =
-      "```\n" \
-      'def hello()' \
-      "  'world'" \
-      'end' \
-      '```'
-    @header = <<~DOC
-      # Words
-
-      Some words
-
-      ## Words
-
-      More words?
-    DOC
-  end
-
-  def test_fails_when_given_a_documentfragment
-    body = '<p>heyo</p>'
-    doc  = HTML::Pipeline.parse(body)
-    assert_raises(TypeError) { MarkdownFilter.call(doc, context: {}) }
-  end
-
-  def test_gfm_enabled_by_default
-    doc = MarkdownFilter.to_document(@haiku)
-    assert doc.is_a?(HTML::Pipeline::DocumentFragment)
-    assert_equal 2, doc.search('br').size
-  end
-
-  def test_disabling_gfm
-    doc = MarkdownFilter.to_document(@haiku, context: { gfm: false })
-    assert doc.is_a?(HTML::Pipeline::DocumentFragment)
-    assert_equal 0, doc.search('br').size
-  end
-
-  def test_fenced_code_blocks
-    doc = MarkdownFilter.to_document(@code)
-    assert doc.is_a?(HTML::Pipeline::DocumentFragment)
-    assert_equal 1, doc.search('pre').size
-  end
-
-  def test_fenced_code_blocks_with_language
-    doc = MarkdownFilter.to_document(@code.sub('```', '``` ruby'))
-    assert doc.is_a?(HTML::Pipeline::DocumentFragment)
-    assert_equal 1, doc.search('pre').size
-    assert_equal 'ruby', doc.search('pre').first['lang']
-  end
-
-  def test_standard_extensions
-    iframe = "<iframe src='http://www.google.com'></iframe>"
-    iframe_escaped = "&lt;iframe src='http://www.google.com'>&lt;/iframe>"
-    doc = MarkdownFilter.new(iframe, context: { unsafe: true }).call
-    assert_equal(doc, iframe_escaped)
-  end
-
-  def test_changing_extensions
-    iframe = "<iframe src='http://www.google.com'></iframe>"
-    doc = MarkdownFilter.new(iframe, context: { commonmarker_extensions: [], unsafe: true }).call
-    assert_equal(doc, iframe)
-  end
-
-  def test_bogus_renderer
-    assert_raises ArgumentError do
-      MarkdownFilter.to_document(@haiku, context: { commonmarker_renderer: 23 })
-    end
-  end
-
-  def test_legitimate_renderer
-    results = MarkdownFilter.new(@header, context: { commonmarker_renderer: CustomRenderer }).call
-    expected = <<~DOC
-      {level: 1, text: Words}
-      <h1>Words</h1>
-      <p>Some words</p>
-      {level: 2, text: Words}
-      <h2>Words</h2>
-      <p>More words?</p>
-    DOC
-
-    assert_equal results, expected.chomp
-  end
-
-  def test_without_tagfilter
-    extensions = HTML::Pipeline::MarkdownFilter::DEFAULT_COMMONMARKER_EXTENSIONS - [:tagfilter]
-    script = '<script>foobar</script>'
-    results = MarkdownFilter.new(script, context: { unsafe: true, commonmarker_extensions: extensions }).call
-
-    assert_equal results, script
-  end
-
-  def test_legitimate_custom_renderer_without_tagfilter
-    extensions = HTML::Pipeline::MarkdownFilter::DEFAULT_COMMONMARKER_EXTENSIONS - [:tagfilter]
-    script = '<script>foobar</script>'
-    results = MarkdownFilter.new(script, context: { unsafe: true, commonmarker_extensions: extensions, commonmarker_renderer: CustomRenderer }).call
-
-    assert_equal results, script
-  end
-
-  def test_unsafe_custom_renderer_fenced_code_blocks_with_language
-    doc = MarkdownFilter.to_document(@code.sub('```', '``` ruby'), context: { unsafe: true, commonmarker_renderer: CustomRenderer })
-    assert_equal 'ruby', doc.search('pre').first['lang']
-  end
-end
-
-class GFMTest < Minitest::Test
-  def setup
-    @gfm = MarkdownFilter
-    @context = { gfm: true, unsafe: true }
-  end
-
-  def test_not_touch_single_underscores_inside_words
-    assert_equal '<p>foo_bar</p>',
-                 @gfm.call('foo_bar', context: @context)
-  end
-
-  def test_not_touch_underscores_in_code_blocks
-    assert_equal "<pre><code>foo_bar_baz\n</code></pre>",
-                 @gfm.call('    foo_bar_baz', context: @context)
-  end
-
-  def test_not_touch_underscores_in_pre_blocks
-    assert_equal "<pre>\nfoo_bar_baz\n</pre>",
-                 @gfm.call("<pre>\nfoo_bar_baz\n</pre>", context: @context)
-  end
-
-  def test_not_touch_two_or_more_underscores_inside_words
-    assert_equal '<p>foo_bar_baz</p>',
-                 @gfm.call('foo_bar_baz', context: @context)
-  end
-
-  def test_turn_newlines_into_br_tags_in_simple_cases
-    assert_equal "<p>foo<br />\nbar</p>",
-                 @gfm.call("foo\nbar", context: @context)
-  end
-
-  def test_convert_newlines_in_all_groups
-    assert_equal "<p>apple<br />\npear<br />\norange</p>\n" \
-                 "<p>ruby<br />\npython<br />\nerlang</p>",
-                 @gfm.call("apple\npear\norange\n\nruby\npython\nerlang", context: @context)
-  end
-
-  def test_convert_newlines_in_even_long_groups
-    assert_equal "<p>apple<br />\npear<br />\norange<br />\nbanana</p>\n" \
-                 "<p>ruby<br />\npython<br />\nerlang</p>",
-                 @gfm.call("apple\npear\norange\nbanana\n\nruby\npython\nerlang", context: @context)
-  end
-
-  def test_not_convert_newlines_in_lists
-    assert_equal "<h1>foo</h1>\n<h1>bar</h1>",
-                 @gfm.call("# foo\n# bar", context: @context)
-    assert_equal "<ul>\n<li>foo</li>\n<li>bar</li>\n</ul>",
-                 @gfm.call("* foo\n* bar", context: @context)
-  end
-end
diff --git a/test/html/pipeline/mention_filter_test.rb b/test/html/pipeline/mention_filter_test.rb
deleted file mode 100644
index 725de371..00000000
--- a/test/html/pipeline/mention_filter_test.rb
+++ /dev/null
@@ -1,201 +0,0 @@
-# frozen_string_literal: true
-
-require 'test_helper'
-
-class HTML::Pipeline::MentionFilterTest < Minitest::Test
-  def setup
-    @filter = HTML::Pipeline::MentionFilter
-    @context = { base_url: '/', info_url: nil, username_pattern: nil }
-
-    @pipeline = HTML::Pipeline.new([
-                                     HTML::Pipeline::MarkdownFilter,
-                                     HTML::Pipeline::MentionFilter
-                                   ])
-  end
-
-  def mentioned_usernames(body) # rubocop:disable Minitest/TestMethodName
-    result = {}
-    @pipeline.call(body, result: result)
-    result[:mentioned_usernames]
-  end
-
-  def test_filtering_a_documentfragment
-    body = '<p>@kneath: check it out.</p>'
-    doc  = Nokogiri::HTML::DocumentFragment.parse(body)
-
-    res  = @filter.call(doc, context: @context)
-    assert_same doc, res
-
-    link = '<a href="/kneath" class="user-mention">@kneath</a>'
-    assert_equal "<p>#{link}: check it out.</p>",
-                 res.to_html
-  end
-
-  def test_filtering_plain_text
-    body = '<p>@kneath: check it out.</p>'
-    res  = @filter.call(body, context: @context)
-
-    link = '<a href="/kneath" class="user-mention">@kneath</a>'
-    assert_equal "<p>#{link}: check it out.</p>",
-                 res.to_html
-  end
-
-  def test_not_replacing_mentions_in_pre_tags
-    body = '<pre>@kneath: okay</pre>'
-    assert_equal body, @filter.call(body, context: @context).to_html
-  end
-
-  def test_not_replacing_mentions_in_code_tags
-    body = '<p><code>@kneath:</code> okay</p>'
-    assert_equal body, @filter.call(body, context: @context).to_html
-  end
-
-  def test_not_replacing_mentions_in_style_tags
-    body = '<style>@media (min-width: 768px) { color: red; }</style>'
-    assert_equal body, @filter.call(body, context: @context).to_html
-  end
-
-  def test_not_replacing_mentions_in_links
-    body = '<p><a>@kneath</a> okay</p>'
-    assert_equal body, @filter.call(body, context: @context).to_html
-  end
-
-  def test_entity_encoding_and_whatnot
-    body = "<p>@&#x6b;neath what's up</p>"
-    link = '<a href="/kneath" class="user-mention">@kneath</a>'
-    assert_equal "<p>#{link} what's up</p>", @filter.call(body, context: @context).to_html
-  end
-
-  def test_html_injection
-    body = '<p>@kneath &lt;script>alert(0)&lt;/script></p>'
-    link = '<a href="/kneath" class="user-mention">@kneath</a>'
-    assert_equal "<p>#{link} &lt;script&gt;alert(0)&lt;/script&gt;</p>",
-                 @filter.call(body, context: @context).to_html
-  end
-
-  def test_base_url_slash
-    body = '<p>Hi, @jch!</p>'
-    link = '<a href="/jch" class="user-mention">@jch</a>'
-    assert_equal "<p>Hi, #{link}!</p>",
-                 @filter.call(body, context: { base_url: '/' }).to_html
-  end
-
-  def test_base_url_under_custom_route
-    body = '<p>Hi, @jch!</p>'
-    link = '<a href="/userprofile/jch" class="user-mention">@jch</a>'
-    assert_equal "<p>Hi, #{link}!</p>",
-                 @filter.call(body, context: @context.merge({ base_url: '/userprofile' })).to_html
-  end
-
-  def test_base_url_slash_with_tilde
-    body = '<p>Hi, @jch!</p>'
-    link = '<a href="/~jch" class="user-mention">@jch</a>'
-    assert_equal "<p>Hi, #{link}!</p>",
-                 @filter.call(body, context: @context.merge({ base_url: '/~' })).to_html
-  end
-
-  def test_matches_usernames_in_body
-    body = '@test how are you?'
-    assert_equal %w[test], mentioned_usernames(body)
-  end
-
-  def test_matches_usernames_with_dashes
-    body = 'hi @some-user'
-    assert_equal %w[some-user], mentioned_usernames(body)
-  end
-
-  def test_matches_usernames_followed_by_a_single_dot
-    body = 'okay @some-user.'
-    assert_equal %w[some-user], mentioned_usernames(body)
-  end
-
-  def test_matches_usernames_followed_by_multiple_dots
-    body = 'okay @some-user...'
-    assert_equal %w[some-user], mentioned_usernames(body)
-  end
-
-  def test_does_not_match_email_addresses
-    body = 'aman@tmm1.net'
-    assert_equal [], mentioned_usernames(body)
-  end
-
-  def test_does_not_match_domain_name_looking_things
-    body = 'we need a @github.com email'
-    assert_equal [], mentioned_usernames(body)
-  end
-
-  def test_does_not_match_organization_team_mentions
-    body = 'we need to @github/enterprise know'
-    assert_equal [], mentioned_usernames(body)
-  end
-
-  def test_matches_colon_suffixed_names
-    body = '@tmm1: what do you think?'
-    assert_equal %w[tmm1], mentioned_usernames(body)
-  end
-
-  def test_matches_list_of_names
-    body = '@defunkt @atmos @kneath'
-    assert_equal %w[defunkt atmos kneath], mentioned_usernames(body)
-  end
-
-  def test_matches_list_of_names_with_commas
-    body = '/cc @defunkt, @atmos, @kneath'
-    assert_equal %w[defunkt atmos kneath], mentioned_usernames(body)
-  end
-
-  def test_matches_inside_brackets
-    body = '(@mislav) and [@rtomayko]'
-    assert_equal %w[mislav rtomayko], mentioned_usernames(body)
-  end
-
-  def test_doesnt_ignore_invalid_users
-    body = '@defunkt @mojombo and @somedude'
-    assert_equal %w[defunkt mojombo somedude], mentioned_usernames(body)
-  end
-
-  def test_returns_distinct_set
-    body = '/cc @defunkt, @atmos, @kneath, @defunkt, @defunkt'
-    assert_equal %w[defunkt atmos kneath], mentioned_usernames(body)
-  end
-
-  def test_does_not_match_inline_code_block_with_multiple_code_blocks
-    body = "something\n\n`/cc @defunkt @atmos @kneath` `/cc @atmos/atmos`"
-    assert_equal %w[], mentioned_usernames(body)
-  end
-
-  def test_mention_at_end_of_parenthetical_sentence
-    body = "(We're talking 'bout @ymendel.)"
-    assert_equal %w[ymendel], mentioned_usernames(body)
-  end
-
-  def test_username_pattern_can_be_customized
-    body = '<p>@_abc: test.</p>'
-    doc  = Nokogiri::HTML::DocumentFragment.parse(body)
-
-    res  = @filter.call(doc, context: { base_url: '/', username_pattern: /(_[a-z]{3})/ })
-
-    link = '<a href="/_abc" class="user-mention">@_abc</a>'
-    assert_equal "<p>#{link}: test.</p>",
-                 res.to_html
-  end
-
-  def test_filter_does_not_create_a_new_object_for_default_username_pattern
-    body = '<div>@test</div>'
-    doc = Nokogiri::HTML::DocumentFragment.parse(body)
-
-    @filter.call(doc.clone)
-    pattern_count = HTML::Pipeline::MentionFilter::MENTION_PATTERNS.length
-    @filter.call(doc.clone)
-
-    assert_equal pattern_count, HTML::Pipeline::MentionFilter::MENTION_PATTERNS.length
-    @filter.call(doc.clone, context: { username_pattern: /test/ })
-    assert_equal pattern_count + 1, HTML::Pipeline::MentionFilter::MENTION_PATTERNS.length
-  end
-
-  def test_mention_link_filter
-    filter = HTML::Pipeline::MentionFilter.new nil
-    expected = "<a href='/hubot' class='user-mention'>@hubot</a>"
-    assert_equal expected, filter.mention_link_filter('@hubot')
-  end
-end
diff --git a/test/html/pipeline/plain_text_input_filter_test.rb b/test/html/pipeline/plain_text_input_filter_test.rb
deleted file mode 100644
index 95ac95f8..00000000
--- a/test/html/pipeline/plain_text_input_filter_test.rb
+++ /dev/null
@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-require 'test_helper'
-
-class HTML::Pipeline::PlainTextInputFilterTest < Minitest::Test
-  PlainTextInputFilter = HTML::Pipeline::PlainTextInputFilter
-
-  def test_fails_when_given_a_documentfragment
-    body = '<p>heyo</p>'
-    doc  = Nokogiri::HTML::DocumentFragment.parse(body)
-    assert_raises(TypeError) { PlainTextInputFilter.call(doc, context: {}) }
-  end
-
-  def test_wraps_input_in_a_div_element
-    doc = PlainTextInputFilter.call('howdy pahtner', context: {})
-    assert_equal '<div>howdy pahtner</div>', doc.to_s
-  end
-
-  def test_html_escapes_plain_text_input
-    doc = PlainTextInputFilter.call('See: <http://example.org>', context: {})
-    assert_equal '<div>See: &lt;http://example.org&gt;</div>',
-                 doc.to_s
-  end
-end
diff --git a/test/html/pipeline/require_helper_test.rb b/test/html/pipeline/require_helper_test.rb
deleted file mode 100644
index 2aeaf5f6..00000000
--- a/test/html/pipeline/require_helper_test.rb
+++ /dev/null
@@ -1,48 +0,0 @@
-# frozen_string_literal: true
-
-require 'test_helper'
-
-class HTML::Pipeline::RequireHelperTest < Minitest::Test
-  def test_works_with_existing_dependency
-    HTML::Pipeline.require_dependency('rake', 'SomeClass')
-  end
-
-  def test_works_with_existing_dependencies
-    HTML::Pipeline.require_dependencies(%w[old_sql nokogiri], 'SomeClass')
-    assert HTML::Pipeline.nokogiri_loaded?
-    refute HTML::Pipeline.old_sql_loaded?
-  end
-
-  def test_raises_mising_dependency_error
-    assert_raises HTML::Pipeline::MissingDependencyError do
-      HTML::Pipeline.require_dependency('non-existant', 'SomeClass')
-    end
-  end
-
-  def test_raises_mising_dependenccies_error
-    assert_raises HTML::Pipeline::MissingDependencyError do
-      HTML::Pipeline.require_dependencies(%w[non-existant something], 'SomeClass')
-    end
-  end
-
-  def test_raises_dependency_error_including_message
-    error = assert_raises(HTML::Pipeline::MissingDependencyError) do
-      HTML::Pipeline.require_dependency('non-existant', 'SomeClass')
-    end
-    assert_includes(error.message, "Missing dependency 'non-existant' for SomeClass. See README.md for details.")
-  end
-
-  def test_raises_dependencies_error_including_message
-    error = assert_raises(HTML::Pipeline::MissingDependencyError) do
-      HTML::Pipeline.require_dependencies(%w[non-existant something], 'SomeClass')
-    end
-    assert_includes(error.message, "Missing all dependencies 'non-existant, something' for SomeClass. See README.md for details.")
-  end
-
-  def test_raises_error_includes_underlying_message
-    error = assert_raises HTML::Pipeline::MissingDependencyError do
-      HTML::Pipeline.require_dependency('non-existant', 'SomeClass')
-    end
-    assert_includes(error.message, 'LoadError: cannot load such file')
-  end
-end
diff --git a/test/html/pipeline/sanitization_filter_test.rb b/test/html/pipeline/sanitization_filter_test.rb
deleted file mode 100644
index 643e8c5f..00000000
--- a/test/html/pipeline/sanitization_filter_test.rb
+++ /dev/null
@@ -1,175 +0,0 @@
-# frozen_string_literal: true
-
-require 'test_helper'
-
-class HTML::Pipeline::SanitizationFilterTest < Minitest::Test
-  SanitizationFilter = HTML::Pipeline::SanitizationFilter
-
-  def test_removing_script_tags
-    orig = %(<p><img src="http://github.com/img.png" /><script></script></p>)
-    html = SanitizationFilter.call(orig).to_s
-    refute_match(/script/, html)
-  end
-
-  def test_removing_style_tags
-    orig = %(<p><style>hey now</style></p>)
-    html = SanitizationFilter.call(orig).to_s
-    refute_match(/style/, html)
-  end
-
-  def test_removing_style_attributes
-    orig = %(<p style='font-size:1000%'>YO DAWG</p>)
-    html = SanitizationFilter.call(orig).to_s
-    refute_match(/font-size/, html)
-    refute_match(/style/, html)
-  end
-
-  def test_removing_script_event_handler_attributes
-    orig = %(<a onclick='javascript:alert(0)'>YO DAWG</a>)
-    html = SanitizationFilter.call(orig).to_s
-    refute_match(/javscript/, html)
-    refute_match(/onclick/, html)
-  end
-
-  def test_sanitizes_li_elements_not_contained_in_ul_or_ol
-    stuff = "a\n<li>b</li>\nc"
-    html  = SanitizationFilter.call(stuff).to_s
-    assert_equal "a\nb\nc", html
-  end
-
-  def test_does_not_sanitize_li_elements_contained_in_ul_or_ol
-    stuff = "a\n<ul><li>b</li></ul>\nc"
-    assert_equal stuff, SanitizationFilter.call(stuff).to_s
-  end
-
-  def test_github_specific_protocols_are_not_removed
-    stuff = '<a href="github-windows://spillthelog">Spill this yo</a> and so on'
-    assert_equal stuff, SanitizationFilter.call(stuff).to_s
-  end
-
-  def test_unknown_schemes_are_removed
-    stuff = '<a href="something-weird://heyyy">Wat</a> is this'
-    html  = SanitizationFilter.call(stuff).to_s
-    assert_equal '<a>Wat</a> is this', html
-  end
-
-  def test_allowlisted_longdesc_schemes_are_allowed
-    stuff = '<img src="./foo.jpg" longdesc="http://longdesc.com">'
-    html  = SanitizationFilter.call(stuff).to_s
-    assert_equal '<img src="./foo.jpg" longdesc="http://longdesc.com">', html
-  end
-
-  def test_weird_longdesc_schemes_are_removed
-    stuff = '<img src="./foo.jpg" longdesc="javascript:alert(1)">'
-    html  = SanitizationFilter.call(stuff).to_s
-    assert_equal '<img src="./foo.jpg">', html
-  end
-
-  def test_standard_schemes_are_removed_if_not_specified_in_anchor_schemes
-    stuff  = '<a href="http://www.example.com/">No href for you</a>'
-    filter = SanitizationFilter.new(stuff, context: { anchor_schemes: [] })
-    html   = filter.call.to_s
-    assert_equal '<a>No href for you</a>', html
-  end
-
-  def test_custom_anchor_schemes_are_not_removed
-    stuff  = '<a href="something-weird://heyyy">Wat</a> is this'
-    filter = SanitizationFilter.new(stuff, context: { anchor_schemes: ['something-weird'] })
-    html   = filter.call.to_s
-    assert_equal stuff, html
-  end
-
-  def test_anchor_schemes_are_merged_with_other_anchor_restrictions
-    stuff = '<a href="something-weird://heyyy" ping="more-weird://hiii">Wat</a> is this'
-    allowlist = {
-      elements: ['a'],
-      attributes: { 'a' => %w[href ping] },
-      protocols: { 'a' => { 'ping' => ['http'] } }
-    }
-    filter = SanitizationFilter.new(stuff, context: { allowlist: allowlist, anchor_schemes: ['something-weird'] })
-    html   = filter.call.to_s
-    assert_equal '<a href="something-weird://heyyy">Wat</a> is this', html
-  end
-
-  def test_uses_anchor_schemes_from_allowlist_when_not_separately_specified
-    stuff = '<a href="something-weird://heyyy">Wat</a> is this'
-    allowlist = {
-      elements: ['a'],
-      attributes: { 'a' => ['href'] },
-      protocols: { 'a' => { 'href' => ['something-weird'] } }
-    }
-    filter = SanitizationFilter.new(stuff, context: { allowlist: allowlist })
-    html   = filter.call.to_s
-    assert_equal stuff, html
-  end
-
-  def test_allowlist_contains_default_anchor_schemes
-    assert_equal(['http', 'https', 'mailto', 'xmpp', :relative, 'github-windows', 'github-mac', 'irc', 'ircs'], SanitizationFilter::ALLOWLIST[:protocols]['a']['href'])
-  end
-
-  def test_allowlist_from_full_constant
-    stuff  = '<a href="something-weird://heyyy" ping="more-weird://hiii">Wat</a> is this'
-    filter = SanitizationFilter.new(stuff, context: { allowlist: SanitizationFilter::FULL })
-    html   = filter.call.to_s
-    assert_equal 'Wat is this', html
-  end
-
-  def test_exports_default_anchor_schemes
-    assert_equal(['http', 'https', 'mailto', 'xmpp', :relative, 'github-windows', 'github-mac', 'irc', 'ircs'], SanitizationFilter::ANCHOR_SCHEMES)
-  end
-
-  def test_script_contents_are_removed
-    orig = '<script>JavaScript!</script>'
-    assert_equal '', SanitizationFilter.call(orig).to_s
-  end
-
-  def test_table_rows_and_cells_removed_if_not_in_table
-    orig = %(<tr><td>Foo</td></tr><td>Bar</td>)
-    assert_equal 'FooBar', SanitizationFilter.call(orig).to_s
-  end
-
-  def test_table_sections_removed_if_not_in_table
-    orig = %(<thead><tr><td>Foo</td></tr></thead>)
-    assert_equal 'Foo', SanitizationFilter.call(orig).to_s
-  end
-
-  def test_table_sections_are_not_removed
-    orig = %(<table>
-<thead><tr><th>Column 1</th></tr></thead>
-<tfoot><tr><td>Sum</td></tr></tfoot>
-<tbody><tr><td>1</td></tr></tbody>
-</table>)
-    assert_equal orig, SanitizationFilter.call(orig).to_s
-  end
-
-  def test_summary_tag_are_not_removed
-    orig = %(<summary>Foo</summary>)
-    assert_equal orig, SanitizationFilter.call(orig).to_s
-  end
-
-  def test_details_tag_and_open_attribute_are_not_removed
-    orig = %(<details open>Foo</details>)
-    assert_equal orig, SanitizationFilter.call(orig).to_s
-  end
-
-  def test_nested_details_tag_are_not_removed
-    orig = <<-NESTED
-      <details>
-        <summary>Foo</summary>
-        <details>
-          Bar
-          <summary>Baz</summary>
-        </details>
-        Qux
-      </details>
-    NESTED
-    assert_equal orig, SanitizationFilter.call(orig).to_s
-  end
-
-  def test_allowlist_context
-    orig = %(<p><style>hey now</style></p>)
-    context = { allowlist: ['table'] }
-
-    assert_equal ['table'], SanitizationFilter.new(orig, context: context).allowlist
-  end
-end
diff --git a/test/html/pipeline/syntax_highlight_filter_test.rb b/test/html/pipeline/syntax_highlight_filter_test.rb
deleted file mode 100644
index 09fd94bf..00000000
--- a/test/html/pipeline/syntax_highlight_filter_test.rb
+++ /dev/null
@@ -1,65 +0,0 @@
-# frozen_string_literal: true
-
-require 'test_helper'
-require 'escape_utils'
-
-SyntaxHighlightFilter = HTML::Pipeline::SyntaxHighlightFilter
-
-class HTML::Pipeline::SyntaxHighlightFilterTest < Minitest::Test
-  def test_highlight_default
-    filter = SyntaxHighlightFilter.new \
-      '<pre>hello</pre>', context: { highlight: 'coffeescript' }
-
-    doc = filter.call
-    refute_empty doc.css('.highlight')
-    refute_empty doc.css('.highlight-coffeescript')
-  end
-
-  def test_highlight_default_will_not_override
-    filter = SyntaxHighlightFilter.new \
-      "<pre lang='c'>hello</pre>",  context: { highlight: 'coffeescript' }
-
-    doc = filter.call
-    assert_empty doc.css('.highlight-coffeescript')
-    refute_empty doc.css('.highlight-c')
-  end
-
-  def test_highlight_does_not_remove_pre_tag
-    filter = SyntaxHighlightFilter.new \
-      "<pre lang='c'>hello</pre>",  context: { highlight: 'coffeescript' }
-
-    doc = filter.call
-
-    refute_empty doc.css('pre')
-  end
-
-  def test_highlight_allows_optional_scope
-    filter = SyntaxHighlightFilter.new \
-      "<pre lang='c'>hello</pre>",  context: { highlight: 'coffeescript', scope: 'test-scope' }
-
-    doc = filter.call
-
-    refute_empty doc.css('pre.test-scope')
-  end
-
-  def test_highlight_keeps_the_pre_tags_lang
-    filter = SyntaxHighlightFilter.new \
-      "<pre lang='c'>hello</pre>",  context: { highlight: 'coffeescript' }
-
-    doc = filter.call
-
-    refute_empty doc.css('pre[lang=c]')
-  end
-
-  def test_highlight_handles_nested_pre_tags
-    inner_code = "<pre>console.log('i am nested!')</pre>"
-    escaped = EscapeUtils.escape_html(inner_code)
-    html = "<pre lang='html'>#{escaped}</pre>"
-    filter = SyntaxHighlightFilter.new html, context: { highlight: 'html' }
-
-    doc = filter.call
-
-    assert_equal 2, doc.css('span[class=nt]').length
-    assert_equal EscapeUtils.unescape_html(escaped), doc.inner_text
-  end
-end
diff --git a/test/html/pipeline/team_mention_filter_test.rb b/test/html/pipeline/team_mention_filter_test.rb
deleted file mode 100644
index b034cdd7..00000000
--- a/test/html/pipeline/team_mention_filter_test.rb
+++ /dev/null
@@ -1,202 +0,0 @@
-# frozen_string_literal: true
-
-require 'test_helper'
-
-class HTML::Pipeline::TeamMentionFilterTest < Minitest::Test
-  def setup
-    @filter = HTML::Pipeline::TeamMentionFilter
-
-    @pipeline =
-      HTML::Pipeline.new [
-        HTML::Pipeline::MarkdownFilter,
-        HTML::Pipeline::TeamMentionFilter
-      ]
-  end
-
-  def mentioned_teams(body) # rubocop:disable Minitest/TestMethodName
-    result = {}
-    @pipeline.call(body, result: result)
-    result[:mentioned_teams]
-  end
-
-  def test_filtering_plain_text
-    body = '<p>@github/team: check it out.</p>'
-    res  = @filter.call(body, context: { base_url: '/' })
-
-    link = '<a href="/github/team" class="team-mention">@github/team</a>'
-    assert_equal "<p>#{link}: check it out.</p>",
-                 res.to_html
-  end
-
-  def test_filtering_a_documentfragment
-    body = '<p>@github/team: check it out.</p>'
-    doc  = Nokogiri::HTML::DocumentFragment.parse(body)
-
-    res  = @filter.call(doc, context: { base_url: '/' })
-    assert_same doc, res
-
-    link = '<a href="/github/team" class="team-mention">@github/team</a>'
-    assert_equal "<p>#{link}: check it out.</p>",
-                 res.to_html
-  end
-
-  def test_not_replacing_mentions_in_pre_tags
-    body = '<pre>@github/team: okay</pre>'
-    assert_equal body, @filter.call(body).to_html
-  end
-
-  def test_not_replacing_mentions_in_code_tags
-    body = '<p><code>@github/team:</code> okay</p>'
-    assert_equal body, @filter.call(body).to_html
-  end
-
-  def test_not_replacing_mentions_in_style_tags
-    body = '<style>@github/team (min-width: 768px) { color: red; }</style>'
-    assert_equal body, @filter.call(body).to_html
-  end
-
-  def test_not_replacing_mentions_in_links
-    body = '<p><a>@github/team</a> okay</p>'
-    assert_equal body, @filter.call(body).to_html
-  end
-
-  def test_entity_encoding_and_whatnot
-    body = "<p>@github&#47team what's up</p>"
-    link = '<a href="/github/team" class="team-mention">@github/team</a>'
-    assert_equal "<p>#{link} what's up</p>", @filter.call(body, context: { base_url: '/' }).to_html
-  end
-
-  def test_html_injection
-    body = '<p>@github/team &lt;script>alert(0)&lt;/script></p>'
-    link = '<a href="/github/team" class="team-mention">@github/team</a>'
-    assert_equal "<p>#{link} &lt;script&gt;alert(0)&lt;/script&gt;</p>",
-                 @filter.call(body, context: { base_url: '/' }).to_html
-  end
-
-  def test_links_to_nothing_with_user_mention
-    body = '<p>Hi, @kneath</p>'
-    assert_equal '<p>Hi, @kneath</p>',
-                 @filter.call(body, context: { base_url: '/' }).to_html
-  end
-
-  def test_base_url_slash
-    body = '<p>Hi, @github/team!</p>'
-    link = '<a href="/github/team" class="team-mention">@github/team</a>'
-    assert_equal "<p>Hi, #{link}!</p>",
-                 @filter.call(body, context: { base_url: '/' }).to_html
-  end
-
-  def test_base_url_under_custom_route
-    body = '<p>Hi, @org/team!</p>'
-    link = '<a href="www.github.com/org/team" class="team-mention">@org/team</a>'
-    assert_equal "<p>Hi, #{link}!</p>",
-                 @filter.call(body, context: { base_url: 'www.github.com' }).to_html
-  end
-
-  def test_base_url_slash_with_tilde
-    body = '<p>Hi, @github/team!</p>'
-    link = '<a href="/~github/team" class="team-mention">@github/team</a>'
-    assert_equal "<p>Hi, #{link}!</p>",
-                 @filter.call(body, context: { base_url: '/~' }).to_html
-  end
-
-  def test_multiple_team_mentions
-    body = '<p>Hi, @github/whale and @github/donut!</p>'
-    link_whale = '<a href="/github/whale" class="team-mention">@github/whale</a>'
-    link_donut = '<a href="/github/donut" class="team-mention">@github/donut</a>'
-    assert_equal "<p>Hi, #{link_whale} and #{link_donut}!</p>",
-                 @filter.call(body).to_html
-  end
-
-  def test_matches_teams_in_body
-    body = '@test/team how are you?'
-    assert_equal %w[team], mentioned_teams(body)
-  end
-
-  def test_matches_orgs_with_dashes
-    body = 'hi @some-org/team'
-    assert_equal %w[team], mentioned_teams(body)
-  end
-
-  def test_matches_teams_with_dashes
-    body = 'hi @github/some-team'
-    assert_equal %w[some-team], mentioned_teams(body)
-  end
-
-  def test_matches_teams_followed_by_a_single_dot
-    body = 'okay @github/team.'
-    assert_equal %w[team], mentioned_teams(body)
-  end
-
-  def test_matches_teams_followed_by_multiple_dots
-    body = 'okay @github/team...'
-    assert_equal %w[team], mentioned_teams(body)
-  end
-
-  def test_does_not_match_email_addresses
-    body = 'aman@tmm1.net'
-    assert_equal [], mentioned_teams(body)
-  end
-
-  def test_does_not_match_domain_name_looking_things
-    body = 'we need a @github.com email'
-    assert_equal [], mentioned_teams(body)
-  end
-
-  def test_does_not_match_user_mentions
-    body = 'we need to @enterprise know'
-    assert_equal [], mentioned_teams(body)
-  end
-
-  def test_matches_colon_suffixed_team_names
-    body = '@github/team: what do you think?'
-    assert_equal %w[team], mentioned_teams(body)
-  end
-
-  def test_matches_list_of_teams
-    body = '@github/whale @github/donut @github/green'
-    assert_equal %w[whale donut green], mentioned_teams(body)
-  end
-
-  def test_matches_list_of_teams_with_commas
-    body = '/cc @github/whale, @github/donut, @github/green'
-    assert_equal %w[whale donut green], mentioned_teams(body)
-  end
-
-  def test_matches_inside_brackets
-    body = '(@github/whale) and [@github/donut]'
-    assert_equal %w[whale donut], mentioned_teams(body)
-  end
-
-  def test_returns_distinct_set
-    body = '/cc @github/whale, @github/donut, @github/whale, @github/whale'
-    assert_equal %w[whale donut], mentioned_teams(body)
-  end
-
-  def test_does_not_match_inline_code_block_with_multiple_code_blocks
-    body = "something\n\n`/cc @github/whale @github/donut @github/green` `/cc @donut/donut`"
-    assert_equal %w[], mentioned_teams(body)
-  end
-
-  def test_mention_at_end_of_parenthetical_sentence
-    body = "(We're talking 'bout @some-org/some-team.)"
-    assert_equal %w[some-team], mentioned_teams(body)
-  end
-
-  def test_team_pattern_can_be_customized
-    body = '<p>@_abc/XYZ: test</p>'
-    doc  = Nokogiri::HTML::DocumentFragment.parse(body)
-
-    res  = @filter.call(doc, context: { team_pattern: %r{@(_[a-z]{3})/([A-Z]{3})} })
-
-    link = '<a href="/_abc/XYZ" class="team-mention">@_abc/XYZ</a>'
-    assert_equal "<p>#{link}: test</p>",
-                 res.to_html
-  end
-
-  def test_mention_link_filter
-    filter = HTML::Pipeline::TeamMentionFilter.new nil
-    expected = "<a href='/bot/hubot' class='team-mention'>@bot/hubot</a>"
-    assert_equal expected, filter.mention_link_filter('@bot/hubot')
-  end
-end
diff --git a/test/html/pipeline/toc_filter_test.rb b/test/html/pipeline/toc_filter_test.rb
deleted file mode 100644
index 331a60d4..00000000
--- a/test/html/pipeline/toc_filter_test.rb
+++ /dev/null
@@ -1,142 +0,0 @@
-# frozen_string_literal: true
-
-require 'test_helper'
-
-class HTML::Pipeline::TableOfContentsFilterTest < Minitest::Test
-  TocFilter = HTML::Pipeline::TableOfContentsFilter
-
-  TocPipeline =
-    HTML::Pipeline.new [
-      HTML::Pipeline::TableOfContentsFilter
-    ]
-
-  def toc(content) # rubocop:disable Minitest/TestMethodName
-    result = {}
-    TocPipeline.call(content, context: {}, result: result)
-    result[:toc]
-  end
-
-  def test_anchors_are_added_properly
-    orig = %(<h1>Ice cube</h1><p>Will swarm on any motherfucker in a blue uniform</p>)
-    assert_includes TocFilter.call(orig).to_s, '<a id='
-  end
-
-  def test_custom_anchor_icons_added_properly
-    orig = %(<h1>Ice cube</h1>)
-    expected = %(<h1>\n<a id="ice-cube" class="anchor" href="#ice-cube" aria-hidden="true">#</a>Ice cube</h1>)
-
-    assert_equal expected, TocFilter.call(orig, context: { anchor_icon: '#' }).to_s
-  end
-
-  def test_toc_list_added_properly
-    orig = %(<h1>Ice cube</h1><p>Will swarm on any motherfucker in a blue uniform</p>)
-    assert_includes toc(orig), %(<ul class="section-nav">\n<li><a href=")
-  end
-
-  def test_anchors_have_sane_names
-    orig = %(<h1>Dr Dre</h1><h1>Ice Cube</h1><h1>Eazy-E</h1><h1>MC Ren</h1>)
-    result = TocFilter.call(orig).to_s
-
-    assert_includes result, '"dr-dre"'
-    assert_includes result, '"ice-cube"'
-    assert_includes result, '"eazy-e"'
-    assert_includes result, '"mc-ren"'
-  end
-
-  def test_anchors_have_aria_hidden
-    orig = '<h1>Straight Outta Compton</h1>'
-    result = TocFilter.call(orig).to_s
-    assert_includes result, 'aria-hidden="true"'
-  end
-
-  def test_toc_hrefs_have_sane_values
-    orig = %(<h1>Dr Dre</h1><h1>Ice Cube</h1><h1>Eazy-E</h1><h1>MC Ren</h1>)
-    toc = TocFilter.call(orig).to_s
-    assert_includes toc, '"#dr-dre"'
-    assert_includes toc, '"#ice-cube"'
-    assert_includes toc, '"#eazy-e"'
-    assert_includes toc, '"#mc-ren"'
-  end
-
-  def test_dupe_headers_have_unique_trailing_identifiers
-    orig = %(<h1>Straight Outta Compton</h1>
-             <h2>Dopeman</h2>
-             <h3>Express Yourself</h3>
-             <h1>Dopeman</h1>)
-
-    result = TocFilter.call(orig).to_s
-
-    assert_includes result, '"dopeman"'
-    assert_includes result, '"dopeman-1"'
-  end
-
-  def test_dupe_headers_have_unique_toc_anchors
-    orig = %(<h1>Straight Outta Compton</h1>
-              <h2>Dopeman</h2>
-              <h3>Express Yourself</h3>
-              <h1>Dopeman</h1>)
-
-    assert_includes toc(orig), '"#dopeman"'
-    assert_includes toc(orig), '"#dopeman-1"'
-  end
-
-  def test_all_header_tags_are_found_when_adding_anchors
-    orig = %(<h1>"Funky President" by James Brown</h1>
-             <h2>"It's My Thing" by Marva Whitney</h2>
-             <h3>"Boogie Back" by Roy Ayers</h3>
-             <h4>"Feel Good" by Fancy</h4>
-             <h5>"Funky Drummer" by James Brown</h5>
-             <h6>"Ruthless Villain" by Eazy-E</h6>
-             <h7>"Be Thankful for What You Got" by William DeVaughn</h7>)
-
-    doc = TocFilter.call(orig)
-
-    assert_equal 6, doc.search('a').size
-  end
-
-  def test_toc_outputs_escaped_html
-    orig = %(<h1>&lt;img src="x" onerror="alert(42)"&gt;</h1>)
-
-    refute_includes toc(orig), %(<img src="x" onerror="alert(42)">)
-  end
-
-  def test_toc_is_complete
-    orig = %(<h1>"Funky President" by James Brown</h1>
-              <h2>"It's My Thing" by Marva Whitney</h2>
-              <h3>"Boogie Back" by Roy Ayers</h3>
-              <h4>"Feel Good" by Fancy</h4>
-              <h5>"Funky Drummer" by James Brown</h5>
-              <h6>"Ruthless Villain" by Eazy-E</h6>
-              <h7>"Be Thankful for What You Got" by William DeVaughn</h7>)
-
-    expected = %(<ul class="section-nav">\n<li><a href="#funky-president-by-james-brown">&quot;Funky President&quot; by James Brown</a></li>\n<li><a href="#its-my-thing-by-marva-whitney">&quot;It&#39;s My Thing&quot; by Marva Whitney</a></li>\n<li><a href="#boogie-back-by-roy-ayers">&quot;Boogie Back&quot; by Roy Ayers</a></li>\n<li><a href="#feel-good-by-fancy">&quot;Feel Good&quot; by Fancy</a></li>\n<li><a href="#funky-drummer-by-james-brown">&quot;Funky Drummer&quot; by James Brown</a></li>\n<li><a href="#ruthless-villain-by-eazy-e">&quot;Ruthless Villain&quot; by Eazy-E</a></li>\n</ul>)
-
-    assert_equal expected, toc(orig)
-  end
-
-  if RUBY_VERSION > '1.9' # not sure how to make this work on 1.8.7
-
-    def test_anchors_with_utf8_characters
-      orig = %(<h1>日本語</h1>
-               <h1>Русский</h1)
-
-      rendered_h1s = TocFilter.call(orig).search('h1').map(&:to_s)
-
-      assert_equal "<h1>\n<a id=\"日本語\" class=\"anchor\" href=\"#%E6%97%A5%E6%9C%AC%E8%AA%9E\" aria-hidden=\"true\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"></span></a>日本語</h1>",
-                   rendered_h1s[0]
-      assert_equal "<h1>\n<a id=\"Русский\" class=\"anchor\" href=\"#%D0%A0%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9\" aria-hidden=\"true\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"></span></a>Русский</h1>",
-                   rendered_h1s[1]
-    end
-
-    def test_toc_with_utf8_characters
-      orig = %(<h1>日本語</h1>
-                <h1>Русский</h1)
-
-      rendered_toc = Nokogiri::HTML::DocumentFragment.parse(toc(orig)).to_s
-
-      expected = %(<ul class="section-nav">\n<li><a href="#%E6%97%A5%E6%9C%AC%E8%AA%9E">日本語</a></li>\n<li><a href="#%D0%A0%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9">Русский</a></li>\n</ul>)
-
-      assert_equal expected, rendered_toc
-    end
-  end
-end
diff --git a/test/html/pipeline_test.rb b/test/html/pipeline_test.rb
deleted file mode 100644
index 5e7ab535..00000000
--- a/test/html/pipeline_test.rb
+++ /dev/null
@@ -1,76 +0,0 @@
-# frozen_string_literal: true
-
-require 'test_helper'
-require 'helpers/mocked_instrumentation_service'
-
-class HTML::PipelineTest < Minitest::Test
-  Pipeline = HTML::Pipeline
-  class TestFilter
-    def self.call(input, context: {}, result: {}) # rubocop:disable Lint/UnusedMethodArgument
-      input.reverse
-    end
-  end
-
-  def setup
-    @default_context = {}
-    @result_class = Hash
-    @pipeline = Pipeline.new [TestFilter], default_context: @default_context, result_class: @result_class
-  end
-
-  def test_filter_instrumentation
-    service = MockedInstrumentationService.new
-    events = service.subscribe 'call_filter.html_pipeline'
-    @pipeline.instrumentation_service = service
-    body = 'hello'
-    @pipeline.call(body)
-    event, payload, = events.pop
-    assert event, 'event expected'
-    assert_equal 'call_filter.html_pipeline', event
-    assert_equal TestFilter.name, payload[:filter]
-    assert_equal @pipeline.class.name, payload[:pipeline]
-    assert_equal body.reverse, payload[:result][:output]
-  end
-
-  def test_pipeline_instrumentation
-    service = MockedInstrumentationService.new
-    events = service.subscribe 'call_pipeline.html_pipeline'
-    @pipeline.instrumentation_service = service
-    body = 'hello'
-    @pipeline.call(body)
-    event, payload, = events.pop
-    assert event, 'event expected'
-    assert_equal 'call_pipeline.html_pipeline', event
-    assert_equal @pipeline.filters.map(&:name), payload[:filters]
-    assert_equal @pipeline.class.name, payload[:pipeline]
-    assert_equal body.reverse, payload[:result][:output]
-  end
-
-  def test_default_instrumentation_service
-    service = 'default'
-    Pipeline.default_instrumentation_service = service
-    pipeline = Pipeline.new [], default_context: @default_context, result_class: @result_class
-    assert_equal service, pipeline.instrumentation_service
-  ensure
-    Pipeline.default_instrumentation_service = nil
-  end
-
-  def test_setup_instrumentation
-    assert_nil @pipeline.instrumentation_service
-
-    service = MockedInstrumentationService.new
-    events = service.subscribe 'call_pipeline.html_pipeline'
-    name = 'foo'
-    @pipeline.setup_instrumentation name, service: service
-
-    assert_equal service, @pipeline.instrumentation_service
-    assert_equal name, @pipeline.instrumentation_name
-
-    body = 'foo'
-    @pipeline.call(body)
-
-    event, payload, = events.pop
-    assert event, 'expected event'
-    assert_equal name, payload[:pipeline]
-    assert_equal body.reverse, payload[:result][:output]
-  end
-end
diff --git a/test/html_pipeline/absolute_source_filter_test.rb b/test/html_pipeline/absolute_source_filter_test.rb
new file mode 100644
index 00000000..7e8d44d9
--- /dev/null
+++ b/test/html_pipeline/absolute_source_filter_test.rb
@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+class HTMLPipeline
+  class AbsoluteSourceFilterTest < Minitest::Test
+    AbsoluteSourceFilter = HTMLPipeline::AbsoluteSourceFilter
+
+    def setup
+      @image_base_url = "http://assets.example.com"
+      @image_subpage_url = "http://blog.example.com/a/post"
+      @options = {
+        image_base_url: @image_base_url,
+        image_subpage_url: @image_subpage_url,
+      }
+    end
+
+    def test_rewrites_root_urls
+      orig = %(<p><img src="/img.png"></p>)
+      assert_equal("<p><img src=\"#{@image_base_url}/img.png\"></p>",
+        AbsoluteSourceFilter.call(orig, context: @options).to_s)
+    end
+
+    def test_rewrites_relative_urls
+      orig = %(<p><img src="post/img.png"></p>)
+      assert_equal("<p><img src=\"#{@image_subpage_url}/img.png\"></p>",
+        AbsoluteSourceFilter.call(orig, context: @options).to_s)
+    end
+
+    def test_does_not_rewrite_absolute_urls
+      orig = %(<p><img src="http://other.example.com/img.png"></p>)
+      result = AbsoluteSourceFilter.call(orig, context: @options).to_s
+      refute_match(/@image_base_url/, result)
+      refute_match(/@image_subpage_url/, result)
+    end
+
+    def test_fails_when_context_is_missing
+      assert_raises(RuntimeError) do
+        AbsoluteSourceFilter.call('<img src="img.png">', context: {})
+      end
+      assert_raises(RuntimeError) do
+        AbsoluteSourceFilter.call('<img src="/img.png">', context: {})
+      end
+    end
+
+    def test_tells_you_where_context_is_required
+      exception = assert_raises(RuntimeError) do
+        AbsoluteSourceFilter.call('<img src="img.png">', context: {})
+      end
+      assert_match("HTMLPipeline::AbsoluteSourceFilter", exception.message)
+
+      exception = assert_raises(RuntimeError) do
+        AbsoluteSourceFilter.call('<img src="/img.png">', context: {})
+      end
+      assert_match("HTMLPipeline::AbsoluteSourceFilter", exception.message)
+    end
+  end
+end
diff --git a/test/html_pipeline/autolink_filter_test.rb b/test/html_pipeline/autolink_filter_test.rb
new file mode 100644
index 00000000..f6143f15
--- /dev/null
+++ b/test/html_pipeline/autolink_filter_test.rb
@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+AutolinkFilter = HTMLPipeline::AutolinkFilter
+
+class HTMLPipeline
+  class AutolinkFilterTest < Minitest::Test
+    def test_uses_rinku_for_autolinking
+      # just try to parse a complicated piece of HTML
+      # that Rails auto_link cannot handle
+      assert_equal('<p>"<a href="http://www.github.com">http://www.github.com</a>"</p>',
+        AutolinkFilter.to_html('<p>"http://www.github.com"</p>'))
+    end
+
+    def test_autolink_option
+      assert_equal('<p>"http://www.github.com"</p>',
+        AutolinkFilter.to_html('<p>"http://www.github.com"</p>', context: { autolink: false }))
+    end
+
+    def test_autolink_link_attr
+      assert_equal('<p>"<a href="http://www.github.com" target="_blank">http://www.github.com</a>"</p>',
+        AutolinkFilter.to_html('<p>"http://www.github.com"</p>', context: { link_attr: 'target="_blank"' }))
+    end
+
+    def test_autolink_flags
+      assert_equal('<p>"<a href="http://github">http://github</a>"</p>',
+        AutolinkFilter.to_html('<p>"http://github"</p>', context: { flags: Rinku::AUTOLINK_SHORT_DOMAINS }))
+    end
+
+    def test_autolink_skip_tags
+      assert_equal('<code>"http://github.com"</code>',
+        AutolinkFilter.to_html('<code>"http://github.com"</code>'))
+
+      assert_equal('<code>"<a href="http://github.com">http://github.com</a>"</code>',
+        AutolinkFilter.to_html('<code>"http://github.com"</code>', context: { skip_tags: ["kbd", "script"] }))
+    end
+
+    def test_link_mode_default
+      assert_equal('<p>"<a href="http://www.github.com">http://www.github.com</a>"</p><p>"user@example.com"</p>',
+        AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>'))
+    end
+
+    def test_link_mode_urls
+      assert_equal('<p>"<a href="http://www.github.com">http://www.github.com</a>"</p><p>"user@example.com"</p>',
+        AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :urls }))
+    end
+
+    def test_link_mode_all
+      assert_equal('<p>"<a href="http://www.github.com">http://www.github.com</a>"</p><p>"<a href="mailto:user@example.com">user@example.com</a>"</p>',
+        AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :all }))
+    end
+
+    def test_link_mode_email_addresses
+      assert_equal('<p>"http://www.github.com"</p><p>"<a href="mailto:user@example.com">user@example.com</a>"</p>',
+        AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :email_addresses }))
+    end
+  end
+end
diff --git a/test/html_pipeline/emoji_filter_test.rb b/test/html_pipeline/emoji_filter_test.rb
new file mode 100644
index 00000000..59ab1ec4
--- /dev/null
+++ b/test/html_pipeline/emoji_filter_test.rb
@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+class HTMLPipeline
+  class EmojiFilterTest < Minitest::Test
+    def setup
+      @emoji_filter = HTMLPipeline::EmojiFilter
+    end
+
+    def test_emojify
+      filter = @emoji_filter.new("<p>:shipit:</p>", context: { asset_root: "https://foo.com" })
+      doc = filter.call
+      assert_match("https://foo.com/emoji/shipit.png", doc.search("img").attr("src").value)
+    end
+
+    def test_uri_encoding
+      filter = @emoji_filter.new("<p>:+1:</p>", context: { asset_root: "https://foo.com" })
+      doc = filter.call
+      assert_match("https://foo.com/emoji/unicode/1f44d.png", doc.search("img").attr("src").value)
+    end
+
+    def test_required_context_validation
+      exception = assert_raises(ArgumentError) do
+        @emoji_filter.call("", context: {})
+      end
+      assert_match(/:asset_root/, exception.message)
+    end
+
+    def test_custom_asset_path
+      filter = @emoji_filter.new("<p>:+1:</p>", context: { asset_path: ":file_name", asset_root: "https://foo.com" })
+      doc = filter.call
+      assert_match("https://foo.com/unicode/1f44d.png", doc.search("img").attr("src").value)
+    end
+
+    def test_not_emojify_in_code_tags
+      body = "<code>:shipit:</code>"
+      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com" })
+      doc = filter.call
+      assert_equal(body, doc.to_html)
+    end
+
+    def test_not_emojify_in_tt_tags
+      body = "<tt>:shipit:</tt>"
+      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com" })
+      doc = filter.call
+      assert_equal(body, doc.to_html)
+    end
+
+    def test_not_emojify_in_pre_tags
+      body = "<pre>:shipit:</pre>"
+      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com" })
+      doc = filter.call
+      assert_equal(body, doc.to_html)
+    end
+
+    def test_not_emojify_in_custom_single_tag_foo
+      body = "<foo>:shipit:</foo>"
+      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com", ignored_ancestor_tags: ["foo"] })
+      doc = filter.call
+      assert_equal(body, doc.to_html)
+    end
+
+    def test_not_emojify_in_custom_multiple_tags_foo_and_bar
+      body = "<bar>:shipit:</bar>"
+      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com", ignored_ancestor_tags: ["foo", "bar"] })
+      doc = filter.call
+      assert_equal(body, doc.to_html)
+    end
+
+    def test_img_tag_attributes
+      body = ":shipit:"
+      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com" })
+      doc = filter.call
+      assert_equal(%(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" height="20" width="20" align="absmiddle">), doc.to_html)
+    end
+
+    def test_img_tag_attributes_can_be_customized
+      body = ":shipit:"
+      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com", img_attrs: Hash("draggable" => "false", "height" => nil, "width" => nil, "align" => nil) })
+      doc = filter.call
+      assert_equal(%(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" draggable="false">), doc.to_html)
+    end
+
+    def test_img_attrs_value_can_accept_proclike_object
+      remove_colons = ->(name) { name.delete(":") }
+      body = ":shipit:"
+      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com", img_attrs: Hash("title" => remove_colons) })
+      doc = filter.call
+      assert_equal(%(<img class="emoji" title="shipit" alt=":shipit:" src="https://foo.com/emoji/shipit.png" height="20" width="20" align="absmiddle">), doc.to_html)
+    end
+
+    def test_img_attrs_can_accept_symbolized_keys
+      body = ":shipit:"
+      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com", img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
+      doc = filter.call
+      assert_equal(%(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" draggable="false">), doc.to_html)
+    end
+
+    def test_works_with_gemoji
+      require "gemojione"
+
+      HTMLPipeline::EmojiFilter.stub(:gemoji_loaded?, false) do
+        body = ":flag_ar:"
+        filter = HTMLPipeline::EmojiFilter.new(body, context: { asset_root: "https://foo.com" })
+        doc = filter.call
+        assert_equal(%(<img class="emoji" title=":flag_ar:" alt=":flag_ar:" src="https://foo.com/emoji/1f1e6-1f1f7.png" height="20" width="20" align="absmiddle">), doc.to_html)
+      end
+    end
+
+    def test_gemoji_can_accept_symbolized_keys
+      require "gemojione"
+      HTMLPipeline::EmojiFilter.stub(:gemoji_loaded?, false) do
+        body = ":flag_ar:"
+        filter = HTMLPipeline::EmojiFilter.new(body, context: { asset_root: "https://coolwebsite.com", img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
+        doc = filter.call
+        assert_equal(%(<img class="emoji" title=":flag_ar:" alt=":flag_ar:" src="https://coolwebsite.com/emoji/1f1e6-1f1f7.png" draggable="false">), doc.to_html)
+      end
+    end
+  end
+end
diff --git a/test/html_pipeline/https_filter_test.rb b/test/html_pipeline/https_filter_test.rb
new file mode 100644
index 00000000..6016f3a1
--- /dev/null
+++ b/test/html_pipeline/https_filter_test.rb
@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+HttpsFilter = HTMLPipeline::HttpsFilter
+
+class HTMLPipeline
+  class HttpsFilterTest < Minitest::Test
+    def setup
+      @filter = HttpsFilter
+      @options = { base_url: "http://github.com" }
+    end
+
+    def test_http
+      assert_equal(%(<a href="https://github.com">github.com</a>),
+        @filter.to_html(%(<a href="http://github.com">github.com</a>), context: @options))
+    end
+
+    def test_https
+      assert_equal(%(<a href="https://github.com">github.com</a>),
+        @filter.to_html(%(<a href="https://github.com">github.com</a>), context: @options))
+    end
+
+    def test_subdomain
+      assert_equal(%(<a href="http://help.github.com">github.com</a>),
+        @filter.to_html(%(<a href="http://help.github.com">github.com</a>), context: @options))
+    end
+
+    def test_other
+      assert_equal(%(<a href="http://github.io">github.io</a>),
+        @filter.to_html(%(<a href="http://github.io">github.io</a>), context: @options))
+    end
+
+    def test_uses_http_url_over_base_url
+      options = { http_url: "http://github.com", base_url: "https://github.com" }
+
+      assert_equal(%(<a href="https://github.com">github.com</a>),
+        @filter.to_html(%(<a href="http://github.com">github.com</a>), context: options))
+    end
+
+    def test_only_http_url
+      options = { http_url: "http://github.com" }
+
+      assert_equal(%(<a href="https://github.com">github.com</a>),
+        @filter.to_html(%(<a href="http://github.com">github.com</a>), context: options))
+    end
+
+    def test_validates_http_url
+      exception = assert_raises(ArgumentError) { @filter.to_html("") }
+      assert_match("HTMLPipeline::HttpsFilter: :http_url", exception.message)
+    end
+  end
+end
diff --git a/test/html_pipeline/image_filter_test.rb b/test/html_pipeline/image_filter_test.rb
new file mode 100644
index 00000000..fbf0f280
--- /dev/null
+++ b/test/html_pipeline/image_filter_test.rb
@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+ImageFilter = HTMLPipeline::ImageFilter
+
+class HTMLPipeline
+  class ImageFilterTest < Minitest::Test
+    def setup
+      @filter = ImageFilter
+    end
+
+    def test_jpg
+      assert_equal(%(<img src="http://example.com/test.jpg" alt=""/>),
+        @filter.to_html(%(http://example.com/test.jpg)))
+    end
+
+    def test_jpeg
+      assert_equal(%(<img src="http://example.com/test.jpeg" alt=""/>),
+        @filter.to_html(%(http://example.com/test.jpeg)))
+    end
+
+    def test_bmp
+      assert_equal(%(<img src="http://example.com/test.bmp" alt=""/>),
+        @filter.to_html(%(http://example.com/test.bmp)))
+    end
+
+    def test_gif
+      assert_equal(%(<img src="http://example.com/test.gif" alt=""/>),
+        @filter.to_html(%(http://example.com/test.gif)))
+    end
+
+    def test_png
+      assert_equal(%(<img src="http://example.com/test.png" alt=""/>),
+        @filter.to_html(%(http://example.com/test.png)))
+    end
+
+    def test_https_url
+      assert_equal(%(<img src="https://example.com/test.png" alt=""/>),
+        @filter.to_html(%(https://example.com/test.png)))
+    end
+  end
+end
diff --git a/test/html_pipeline/image_max_width_filter_test.rb b/test/html_pipeline/image_max_width_filter_test.rb
new file mode 100644
index 00000000..3a99232b
--- /dev/null
+++ b/test/html_pipeline/image_max_width_filter_test.rb
@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+class HTMLPipeline
+  class ImageMaxWidthFilterTest < Minitest::Test
+    def setup
+      @filter = HTMLPipeline::ImageMaxWidthFilter
+    end
+
+    def test_rewrites_image_style_tags
+      body = "<p>Screenshot: <img src='screenshot.png'></p>"
+      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
+
+      res = @filter.call(doc)
+      assert_equal_html('<p>Screenshot: <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
+        res.to_html)
+    end
+
+    def test_leaves_existing_image_style_tags_alone
+      body = "<p><img src='screenshot.png' style='width:100px;'></p>"
+      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
+
+      res = @filter.call(doc)
+      assert_equal_html('<p><img src="screenshot.png" style="width:100px;"></p>',
+        res.to_html)
+    end
+
+    def test_links_to_image
+      body = "<p>Screenshot: <img src='screenshot.png'></p>"
+      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
+
+      res = @filter.call(doc)
+      assert_equal_html('<p>Screenshot: <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
+        res.to_html)
+    end
+
+    def test_doesnt_link_to_image_when_already_linked
+      body = "<p>Screenshot: <a href='blah.png'><img src='screenshot.png'></a></p>"
+      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
+
+      res = @filter.call(doc)
+      assert_equal_html('<p>Screenshot: <a href="blah.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
+        res.to_html)
+    end
+
+    def test_doesnt_screw_up_inlined_images
+      body = "<p>Screenshot <img src='screenshot.png'>, yes, this is a <b>screenshot</b> indeed.</p>"
+      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
+
+      assert_equal_html('<p>Screenshot <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a>, yes, this is a <b>screenshot</b> indeed.</p>', @filter.call(doc).to_html)
+    end
+  end
+end
diff --git a/test/html_pipeline/markdown_filter_test.rb b/test/html_pipeline/markdown_filter_test.rb
new file mode 100644
index 00000000..ea6d85cb
--- /dev/null
+++ b/test/html_pipeline/markdown_filter_test.rb
@@ -0,0 +1,180 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+MarkdownFilter = HTMLPipeline::MarkdownFilter
+
+class HTMLPipeline
+  class MarkdownFilterTest < Minitest::Test
+    class CustomRenderer < CommonMarker::HtmlRenderer
+      def header(node)
+        block do
+          text = node.first_child.string_content
+          level = node.header_level
+          out("{level: #{level}, text: #{text}}")
+          super
+        end
+      end
+    end
+
+    def setup
+      @haiku =
+        "Pointing at the moon\n" \
+          "Reminded of simple things\n" \
+          "Moments matter most"
+      @links =
+        "See http://example.org/ for more info"
+      @code =
+        "```\n" \
+          "def hello()" \
+          "  'world'" \
+          "end" \
+          "```"
+      @header = <<~DOC
+        # Words
+
+        Some words
+
+        ## Words
+
+        More words?
+      DOC
+    end
+
+    def test_fails_when_given_a_documentfragment
+      body = "<p>heyo</p>"
+      doc  = HTMLPipeline.parse(body)
+      assert_raises(TypeError) { MarkdownFilter.call(doc, context: {}) }
+    end
+
+    def test_gfm_enabled_by_default
+      doc = MarkdownFilter.to_document(@haiku)
+      assert(doc.is_a?(HTMLPipeline::DocumentFragment))
+      assert_equal(2, doc.search("br").size)
+    end
+
+    def test_disabling_gfm
+      doc = MarkdownFilter.to_document(@haiku, context: { gfm: false })
+      assert(doc.is_a?(HTMLPipeline::DocumentFragment))
+      assert_equal(0, doc.search("br").size)
+    end
+
+    def test_fenced_code_blocks
+      doc = MarkdownFilter.to_document(@code)
+      assert(doc.is_a?(HTMLPipeline::DocumentFragment))
+      assert_equal(1, doc.search("pre").size)
+    end
+
+    def test_fenced_code_blocks_with_language
+      doc = MarkdownFilter.to_document(@code.sub("```", "``` ruby"))
+      assert(doc.is_a?(HTMLPipeline::DocumentFragment))
+      assert_equal(1, doc.search("pre").size)
+      assert_equal("ruby", doc.search("pre").first["lang"])
+    end
+
+    def test_standard_extensions
+      iframe = "<iframe src='http://www.google.com'></iframe>"
+      iframe_escaped = "&lt;iframe src='http://www.google.com'>&lt;/iframe>"
+      doc = MarkdownFilter.new(iframe, context: { unsafe: true }).call
+      assert_equal(doc, iframe_escaped)
+    end
+
+    def test_changing_extensions
+      iframe = "<iframe src='http://www.google.com'></iframe>"
+      doc = MarkdownFilter.new(iframe, context: { commonmarker_extensions: [], unsafe: true }).call
+      assert_equal(doc, iframe)
+    end
+
+    def test_bogus_renderer
+      assert_raises(ArgumentError) do
+        MarkdownFilter.to_document(@haiku, context: { commonmarker_renderer: 23 })
+      end
+    end
+
+    def test_legitimate_renderer
+      results = MarkdownFilter.new(@header, context: { commonmarker_renderer: CustomRenderer }).call
+      expected = <<~DOC
+        {level: 1, text: Words}
+        <h1>Words</h1>
+        <p>Some words</p>
+        {level: 2, text: Words}
+        <h2>Words</h2>
+        <p>More words?</p>
+      DOC
+
+      assert_equal(results, expected.chomp)
+    end
+
+    def test_without_tagfilter
+      extensions = HTMLPipeline::MarkdownFilter::DEFAULT_COMMONMARKER_EXTENSIONS - [:tagfilter]
+      script = "<script>foobar</script>"
+      results = MarkdownFilter.new(script, context: { unsafe: true, commonmarker_extensions: extensions }).call
+
+      assert_equal(results, script)
+    end
+
+    def test_legitimate_custom_renderer_without_tagfilter
+      extensions = HTMLPipeline::MarkdownFilter::DEFAULT_COMMONMARKER_EXTENSIONS - [:tagfilter]
+      script = "<script>foobar</script>"
+      results = MarkdownFilter.new(script, context: { unsafe: true, commonmarker_extensions: extensions, commonmarker_renderer: CustomRenderer }).call
+
+      assert_equal(results, script)
+    end
+
+    def test_unsafe_custom_renderer_fenced_code_blocks_with_language
+      doc = MarkdownFilter.to_document(@code.sub("```", "``` ruby"), context: { unsafe: true, commonmarker_renderer: CustomRenderer })
+      assert_equal("ruby", doc.search("pre").first["lang"])
+    end
+  end
+end
+
+class GFMTest < Minitest::Test
+  def setup
+    @gfm = MarkdownFilter
+    @context = { gfm: true, unsafe: true }
+  end
+
+  def test_not_touch_single_underscores_inside_words
+    assert_equal("<p>foo_bar</p>",
+      @gfm.call("foo_bar", context: @context))
+  end
+
+  def test_not_touch_underscores_in_code_blocks
+    assert_equal("<pre><code>foo_bar_baz\n</code></pre>",
+      @gfm.call("    foo_bar_baz", context: @context))
+  end
+
+  def test_not_touch_underscores_in_pre_blocks
+    assert_equal("<pre>\nfoo_bar_baz\n</pre>",
+      @gfm.call("<pre>\nfoo_bar_baz\n</pre>", context: @context))
+  end
+
+  def test_not_touch_two_or_more_underscores_inside_words
+    assert_equal("<p>foo_bar_baz</p>",
+      @gfm.call("foo_bar_baz", context: @context))
+  end
+
+  def test_turn_newlines_into_br_tags_in_simple_cases
+    assert_equal("<p>foo<br />\nbar</p>",
+      @gfm.call("foo\nbar", context: @context))
+  end
+
+  def test_convert_newlines_in_all_groups
+    assert_equal("<p>apple<br />\npear<br />\norange</p>\n" \
+      "<p>ruby<br />\npython<br />\nerlang</p>",
+      @gfm.call("apple\npear\norange\n\nruby\npython\nerlang", context: @context))
+  end
+
+  def test_convert_newlines_in_even_long_groups
+    assert_equal("<p>apple<br />\npear<br />\norange<br />\nbanana</p>\n" \
+      "<p>ruby<br />\npython<br />\nerlang</p>",
+      @gfm.call("apple\npear\norange\nbanana\n\nruby\npython\nerlang", context: @context))
+  end
+
+  def test_not_convert_newlines_in_lists
+    assert_equal("<h1>foo</h1>\n<h1>bar</h1>",
+      @gfm.call("# foo\n# bar", context: @context))
+    assert_equal("<ul>\n<li>foo</li>\n<li>bar</li>\n</ul>",
+      @gfm.call("* foo\n* bar", context: @context))
+  end
+end
diff --git a/test/html_pipeline/mention_filter_test.rb b/test/html_pipeline/mention_filter_test.rb
new file mode 100644
index 00000000..7ee42be4
--- /dev/null
+++ b/test/html_pipeline/mention_filter_test.rb
@@ -0,0 +1,203 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+class HTMLPipeline
+  class MentionFilterTest < Minitest::Test
+    def setup
+      @filter = HTMLPipeline::MentionFilter
+      @context = { base_url: "/", info_url: nil, username_pattern: nil }
+
+      @pipeline = HTMLPipeline.new([
+        HTMLPipeline::MarkdownFilter,
+        HTMLPipeline::MentionFilter,
+      ])
+    end
+
+    def mentioned_usernames(body)
+      result = {}
+      @pipeline.call(body, result: result)
+      result[:mentioned_usernames]
+    end
+
+    def test_filtering_a_documentfragment
+      body = "<p>@kneath: check it out.</p>"
+      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
+
+      res  = @filter.call(doc, context: @context)
+      assert_same(doc, res)
+
+      link = '<a href="/kneath" class="user-mention">@kneath</a>'
+      assert_equal("<p>#{link}: check it out.</p>",
+        res.to_html)
+    end
+
+    def test_filtering_plain_text
+      body = "<p>@kneath: check it out.</p>"
+      res  = @filter.call(body, context: @context)
+
+      link = '<a href="/kneath" class="user-mention">@kneath</a>'
+      assert_equal("<p>#{link}: check it out.</p>",
+        res.to_html)
+    end
+
+    def test_not_replacing_mentions_in_pre_tags
+      body = "<pre>@kneath: okay</pre>"
+      assert_equal(body, @filter.call(body, context: @context).to_html)
+    end
+
+    def test_not_replacing_mentions_in_code_tags
+      body = "<p><code>@kneath:</code> okay</p>"
+      assert_equal(body, @filter.call(body, context: @context).to_html)
+    end
+
+    def test_not_replacing_mentions_in_style_tags
+      body = "<style>@media (min-width: 768px) { color: red; }</style>"
+      assert_equal(body, @filter.call(body, context: @context).to_html)
+    end
+
+    def test_not_replacing_mentions_in_links
+      body = "<p><a>@kneath</a> okay</p>"
+      assert_equal(body, @filter.call(body, context: @context).to_html)
+    end
+
+    def test_entity_encoding_and_whatnot
+      body = "<p>@&#x6b;neath what's up</p>"
+      link = '<a href="/kneath" class="user-mention">@kneath</a>'
+      assert_equal("<p>#{link} what's up</p>", @filter.call(body, context: @context).to_html)
+    end
+
+    def test_html_injection
+      body = "<p>@kneath &lt;script>alert(0)&lt;/script></p>"
+      link = '<a href="/kneath" class="user-mention">@kneath</a>'
+      assert_equal("<p>#{link} &lt;script&gt;alert(0)&lt;/script&gt;</p>",
+        @filter.call(body, context: @context).to_html)
+    end
+
+    def test_base_url_slash
+      body = "<p>Hi, @jch!</p>"
+      link = '<a href="/jch" class="user-mention">@jch</a>'
+      assert_equal("<p>Hi, #{link}!</p>",
+        @filter.call(body, context: { base_url: "/" }).to_html)
+    end
+
+    def test_base_url_under_custom_route
+      body = "<p>Hi, @jch!</p>"
+      link = '<a href="/userprofile/jch" class="user-mention">@jch</a>'
+      assert_equal("<p>Hi, #{link}!</p>",
+        @filter.call(body, context: @context.merge({ base_url: "/userprofile" })).to_html)
+    end
+
+    def test_base_url_slash_with_tilde
+      body = "<p>Hi, @jch!</p>"
+      link = '<a href="/~jch" class="user-mention">@jch</a>'
+      assert_equal("<p>Hi, #{link}!</p>",
+        @filter.call(body, context: @context.merge({ base_url: "/~" })).to_html)
+    end
+
+    def test_matches_usernames_in_body
+      body = "@test how are you?"
+      assert_equal(["test"], mentioned_usernames(body))
+    end
+
+    def test_matches_usernames_with_dashes
+      body = "hi @some-user"
+      assert_equal(["some-user"], mentioned_usernames(body))
+    end
+
+    def test_matches_usernames_followed_by_a_single_dot
+      body = "okay @some-user."
+      assert_equal(["some-user"], mentioned_usernames(body))
+    end
+
+    def test_matches_usernames_followed_by_multiple_dots
+      body = "okay @some-user..."
+      assert_equal(["some-user"], mentioned_usernames(body))
+    end
+
+    def test_does_not_match_email_addresses
+      body = "aman@tmm1.net"
+      assert_empty(mentioned_usernames(body))
+    end
+
+    def test_does_not_match_domain_name_looking_things
+      body = "we need a @github.com email"
+      assert_empty(mentioned_usernames(body))
+    end
+
+    def test_does_not_match_organization_team_mentions
+      body = "we need to @github/enterprise know"
+      assert_empty(mentioned_usernames(body))
+    end
+
+    def test_matches_colon_suffixed_names
+      body = "@tmm1: what do you think?"
+      assert_equal(["tmm1"], mentioned_usernames(body))
+    end
+
+    def test_matches_list_of_names
+      body = "@defunkt @atmos @kneath"
+      assert_equal(["defunkt", "atmos", "kneath"], mentioned_usernames(body))
+    end
+
+    def test_matches_list_of_names_with_commas
+      body = "/cc @defunkt, @atmos, @kneath"
+      assert_equal(["defunkt", "atmos", "kneath"], mentioned_usernames(body))
+    end
+
+    def test_matches_inside_brackets
+      body = "(@mislav) and [@rtomayko]"
+      assert_equal(["mislav", "rtomayko"], mentioned_usernames(body))
+    end
+
+    def test_doesnt_ignore_invalid_users
+      body = "@defunkt @mojombo and @somedude"
+      assert_equal(["defunkt", "mojombo", "somedude"], mentioned_usernames(body))
+    end
+
+    def test_returns_distinct_set
+      body = "/cc @defunkt, @atmos, @kneath, @defunkt, @defunkt"
+      assert_equal(["defunkt", "atmos", "kneath"], mentioned_usernames(body))
+    end
+
+    def test_does_not_match_inline_code_block_with_multiple_code_blocks
+      body = "something\n\n`/cc @defunkt @atmos @kneath` `/cc @atmos/atmos`"
+      assert_empty(mentioned_usernames(body))
+    end
+
+    def test_mention_at_end_of_parenthetical_sentence
+      body = "(We're talking 'bout @ymendel.)"
+      assert_equal(["ymendel"], mentioned_usernames(body))
+    end
+
+    def test_username_pattern_can_be_customized
+      body = "<p>@_abc: test.</p>"
+      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
+
+      res  = @filter.call(doc, context: { base_url: "/", username_pattern: /(_[a-z]{3})/ })
+
+      link = '<a href="/_abc" class="user-mention">@_abc</a>'
+      assert_equal("<p>#{link}: test.</p>",
+        res.to_html)
+    end
+
+    def test_filter_does_not_create_a_new_object_for_default_username_pattern
+      body = "<div>@test</div>"
+      doc = Nokogiri::HTML::DocumentFragment.parse(body)
+
+      @filter.call(doc.clone)
+      pattern_count = HTMLPipeline::MentionFilter::MENTION_PATTERNS.length
+      @filter.call(doc.clone)
+
+      assert_equal(pattern_count, HTMLPipeline::MentionFilter::MENTION_PATTERNS.length)
+      @filter.call(doc.clone, context: { username_pattern: /test/ })
+      assert_equal(pattern_count + 1, HTMLPipeline::MentionFilter::MENTION_PATTERNS.length)
+    end
+
+    def test_mention_link_filter
+      filter = HTMLPipeline::MentionFilter.new(nil)
+      expected = "<a href='/hubot' class='user-mention'>@hubot</a>"
+      assert_equal(expected, filter.mention_link_filter("@hubot"))
+    end
+  end
+end
diff --git a/test/html_pipeline/plain_text_input_filter_test.rb b/test/html_pipeline/plain_text_input_filter_test.rb
new file mode 100644
index 00000000..e3816277
--- /dev/null
+++ b/test/html_pipeline/plain_text_input_filter_test.rb
@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+class HTMLPipeline
+  class PlainTextInputFilterTest < Minitest::Test
+    PlainTextInputFilter = HTMLPipeline::PlainTextInputFilter
+
+    def test_fails_when_given_a_documentfragment
+      body = "<p>heyo</p>"
+      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
+      assert_raises(TypeError) { PlainTextInputFilter.call(doc, context: {}) }
+    end
+
+    def test_wraps_input_in_a_div_element
+      doc = PlainTextInputFilter.call("howdy pahtner", context: {})
+      assert_equal("<div>howdy pahtner</div>", doc.to_s)
+    end
+
+    def test_html_escapes_plain_text_input
+      doc = PlainTextInputFilter.call("See: <http://example.org>", context: {})
+      assert_equal("<div>See: &lt;http://example.org&gt;</div>",
+        doc.to_s)
+    end
+  end
+end
diff --git a/test/html_pipeline/require_helper_test.rb b/test/html_pipeline/require_helper_test.rb
new file mode 100644
index 00000000..31ac5b50
--- /dev/null
+++ b/test/html_pipeline/require_helper_test.rb
@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+class HTMLPipeline
+  class RequireHelperTest < Minitest::Test
+    def test_works_with_existing_dependency
+      HTMLPipeline.require_dependency("rake", "SomeClass")
+    end
+
+    def test_works_with_existing_dependencies
+      HTMLPipeline.require_dependencies(["old_sql", "nokogiri"], "SomeClass")
+      assert_predicate(HTMLPipeline, :nokogiri_loaded?)
+      refute_predicate(HTMLPipeline, :old_sql_loaded?)
+    end
+
+    def test_raises_mising_dependency_error
+      assert_raises(HTMLPipeline::MissingDependencyError) do
+        HTMLPipeline.require_dependency("non-existant", "SomeClass")
+      end
+    end
+
+    def test_raises_mising_dependenccies_error
+      assert_raises(HTMLPipeline::MissingDependencyError) do
+        HTMLPipeline.require_dependencies(["non-existant", "something"], "SomeClass")
+      end
+    end
+
+    def test_raises_dependency_error_including_message
+      error = assert_raises(HTMLPipeline::MissingDependencyError) do
+        HTMLPipeline.require_dependency("non-existant", "SomeClass")
+      end
+      assert_includes(error.message, "Missing dependency 'non-existant' for SomeClass. See README.md for details.")
+    end
+
+    def test_raises_dependencies_error_including_message
+      error = assert_raises(HTMLPipeline::MissingDependencyError) do
+        HTMLPipeline.require_dependencies(["non-existant", "something"], "SomeClass")
+      end
+      assert_includes(error.message, "Missing all dependencies 'non-existant, something' for SomeClass. See README.md for details.")
+    end
+
+    def test_raises_error_includes_underlying_message
+      error = assert_raises(HTMLPipeline::MissingDependencyError) do
+        HTMLPipeline.require_dependency("non-existant", "SomeClass")
+      end
+      assert_includes(error.message, "LoadError: cannot load such file")
+    end
+  end
+end
diff --git a/test/html_pipeline/sanitization_filter_test.rb b/test/html_pipeline/sanitization_filter_test.rb
new file mode 100644
index 00000000..fab25587
--- /dev/null
+++ b/test/html_pipeline/sanitization_filter_test.rb
@@ -0,0 +1,177 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+class HTMLPipeline
+  class SanitizationFilterTest < Minitest::Test
+    SanitizationFilter = HTMLPipeline::SanitizationFilter
+
+    def test_removing_script_tags
+      orig = %(<p><img src="http://github.com/img.png" /><script></script></p>)
+      html = SanitizationFilter.call(orig).to_s
+      refute_match(/script/, html)
+    end
+
+    def test_removing_style_tags
+      orig = %(<p><style>hey now</style></p>)
+      html = SanitizationFilter.call(orig).to_s
+      refute_match(/style/, html)
+    end
+
+    def test_removing_style_attributes
+      orig = %(<p style='font-size:1000%'>YO DAWG</p>)
+      html = SanitizationFilter.call(orig).to_s
+      refute_match(/font-size/, html)
+      refute_match(/style/, html)
+    end
+
+    def test_removing_script_event_handler_attributes
+      orig = %(<a onclick='javascript:alert(0)'>YO DAWG</a>)
+      html = SanitizationFilter.call(orig).to_s
+      refute_match(/javscript/, html)
+      refute_match(/onclick/, html)
+    end
+
+    def test_sanitizes_li_elements_not_contained_in_ul_or_ol
+      stuff = "a\n<li>b</li>\nc"
+      html  = SanitizationFilter.call(stuff).to_s
+      assert_equal("a\nb\nc", html)
+    end
+
+    def test_does_not_sanitize_li_elements_contained_in_ul_or_ol
+      stuff = "a\n<ul><li>b</li></ul>\nc"
+      assert_equal(stuff, SanitizationFilter.call(stuff).to_s)
+    end
+
+    def test_github_specific_protocols_are_not_removed
+      stuff = '<a href="github-windows://spillthelog">Spill this yo</a> and so on'
+      assert_equal(stuff, SanitizationFilter.call(stuff).to_s)
+    end
+
+    def test_unknown_schemes_are_removed
+      stuff = '<a href="something-weird://heyyy">Wat</a> is this'
+      html  = SanitizationFilter.call(stuff).to_s
+      assert_equal("<a>Wat</a> is this", html)
+    end
+
+    def test_allowlisted_longdesc_schemes_are_allowed
+      stuff = '<img src="./foo.jpg" longdesc="http://longdesc.com">'
+      html  = SanitizationFilter.call(stuff).to_s
+      assert_equal('<img src="./foo.jpg" longdesc="http://longdesc.com">', html)
+    end
+
+    def test_weird_longdesc_schemes_are_removed
+      stuff = '<img src="./foo.jpg" longdesc="javascript:alert(1)">'
+      html  = SanitizationFilter.call(stuff).to_s
+      assert_equal('<img src="./foo.jpg">', html)
+    end
+
+    def test_standard_schemes_are_removed_if_not_specified_in_anchor_schemes
+      stuff  = '<a href="http://www.example.com/">No href for you</a>'
+      filter = SanitizationFilter.new(stuff, context: { anchor_schemes: [] })
+      html   = filter.call.to_s
+      assert_equal("<a>No href for you</a>", html)
+    end
+
+    def test_custom_anchor_schemes_are_not_removed
+      stuff  = '<a href="something-weird://heyyy">Wat</a> is this'
+      filter = SanitizationFilter.new(stuff, context: { anchor_schemes: ["something-weird"] })
+      html   = filter.call.to_s
+      assert_equal(stuff, html)
+    end
+
+    def test_anchor_schemes_are_merged_with_other_anchor_restrictions
+      stuff = '<a href="something-weird://heyyy" ping="more-weird://hiii">Wat</a> is this'
+      allowlist = {
+        elements: ["a"],
+        attributes: { "a" => ["href", "ping"] },
+        protocols: { "a" => { "ping" => ["http"] } },
+      }
+      filter = SanitizationFilter.new(stuff, context: { allowlist: allowlist, anchor_schemes: ["something-weird"] })
+      html   = filter.call.to_s
+      assert_equal('<a href="something-weird://heyyy">Wat</a> is this', html)
+    end
+
+    def test_uses_anchor_schemes_from_allowlist_when_not_separately_specified
+      stuff = '<a href="something-weird://heyyy">Wat</a> is this'
+      allowlist = {
+        elements: ["a"],
+        attributes: { "a" => ["href"] },
+        protocols: { "a" => { "href" => ["something-weird"] } },
+      }
+      filter = SanitizationFilter.new(stuff, context: { allowlist: allowlist })
+      html   = filter.call.to_s
+      assert_equal(stuff, html)
+    end
+
+    def test_allowlist_contains_default_anchor_schemes
+      assert_equal(["http", "https", "mailto", "xmpp", :relative, "github-windows", "github-mac", "irc", "ircs"], SanitizationFilter::ALLOWLIST[:protocols]["a"]["href"])
+    end
+
+    def test_allowlist_from_full_constant
+      stuff  = '<a href="something-weird://heyyy" ping="more-weird://hiii">Wat</a> is this'
+      filter = SanitizationFilter.new(stuff, context: { allowlist: SanitizationFilter::FULL })
+      html   = filter.call.to_s
+      assert_equal("Wat is this", html)
+    end
+
+    def test_exports_default_anchor_schemes
+      assert_equal(["http", "https", "mailto", "xmpp", :relative, "github-windows", "github-mac", "irc", "ircs"], SanitizationFilter::ANCHOR_SCHEMES)
+    end
+
+    def test_script_contents_are_removed
+      orig = "<script>JavaScript!</script>"
+      assert_equal("", SanitizationFilter.call(orig).to_s)
+    end
+
+    def test_table_rows_and_cells_removed_if_not_in_table
+      orig = %(<tr><td>Foo</td></tr><td>Bar</td>)
+      assert_equal("FooBar", SanitizationFilter.call(orig).to_s)
+    end
+
+    def test_table_sections_removed_if_not_in_table
+      orig = %(<thead><tr><td>Foo</td></tr></thead>)
+      assert_equal("Foo", SanitizationFilter.call(orig).to_s)
+    end
+
+    def test_table_sections_are_not_removed
+      orig = %(<table>
+<thead><tr><th>Column 1</th></tr></thead>
+<tfoot><tr><td>Sum</td></tr></tfoot>
+<tbody><tr><td>1</td></tr></tbody>
+</table>)
+      assert_equal(orig, SanitizationFilter.call(orig).to_s)
+    end
+
+    def test_summary_tag_are_not_removed
+      orig = %(<summary>Foo</summary>)
+      assert_equal(orig, SanitizationFilter.call(orig).to_s)
+    end
+
+    def test_details_tag_and_open_attribute_are_not_removed
+      orig = %(<details open>Foo</details>)
+      assert_equal(orig, SanitizationFilter.call(orig).to_s)
+    end
+
+    def test_nested_details_tag_are_not_removed
+      orig = <<-NESTED
+      <details>
+        <summary>Foo</summary>
+        <details>
+          Bar
+          <summary>Baz</summary>
+        </details>
+        Qux
+      </details>
+      NESTED
+      assert_equal(orig, SanitizationFilter.call(orig).to_s)
+    end
+
+    def test_allowlist_context
+      orig = %(<p><style>hey now</style></p>)
+      context = { allowlist: ["table"] }
+
+      assert_equal(["table"], SanitizationFilter.new(orig, context: context).allowlist)
+    end
+  end
+end
diff --git a/test/html_pipeline/syntax_highlight_filter_test.rb b/test/html_pipeline/syntax_highlight_filter_test.rb
new file mode 100644
index 00000000..0cf6c272
--- /dev/null
+++ b/test/html_pipeline/syntax_highlight_filter_test.rb
@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require "test_helper"
+require "escape_utils"
+
+SyntaxHighlightFilter = HTMLPipeline::SyntaxHighlightFilter
+
+class HTMLPipeline
+  class SyntaxHighlightFilterTest < Minitest::Test
+    def test_highlight_default
+      filter = SyntaxHighlightFilter.new(\
+        "<pre>hello</pre>", context: { highlight: "coffeescript" }
+      )
+
+      doc = filter.call
+      refute_empty(doc.css(".highlight"))
+      refute_empty(doc.css(".highlight-coffeescript"))
+    end
+
+    def test_highlight_default_will_not_override
+      filter = SyntaxHighlightFilter.new(\
+        "<pre lang='c'>hello</pre>",  context: { highlight: "coffeescript" }
+      )
+
+      doc = filter.call
+      assert_empty(doc.css(".highlight-coffeescript"))
+      refute_empty(doc.css(".highlight-c"))
+    end
+
+    def test_highlight_does_not_remove_pre_tag
+      filter = SyntaxHighlightFilter.new(\
+        "<pre lang='c'>hello</pre>",  context: { highlight: "coffeescript" }
+      )
+
+      doc = filter.call
+
+      refute_empty(doc.css("pre"))
+    end
+
+    def test_highlight_allows_optional_scope
+      filter = SyntaxHighlightFilter.new(\
+        "<pre lang='c'>hello</pre>",  context: { highlight: "coffeescript", scope: "test-scope" }
+      )
+
+      doc = filter.call
+
+      refute_empty(doc.css("pre.test-scope"))
+    end
+
+    def test_highlight_keeps_the_pre_tags_lang
+      filter = SyntaxHighlightFilter.new(\
+        "<pre lang='c'>hello</pre>",  context: { highlight: "coffeescript" }
+      )
+
+      doc = filter.call
+
+      refute_empty(doc.css("pre[lang=c]"))
+    end
+
+    def test_highlight_handles_nested_pre_tags
+      inner_code = "<pre>console.log('i am nested!')</pre>"
+      escaped = EscapeUtils.escape_html(inner_code)
+      html = "<pre lang='html'>#{escaped}</pre>"
+      filter = SyntaxHighlightFilter.new(html, context: { highlight: "html" })
+
+      doc = filter.call
+
+      assert_equal(2, doc.css("span[class=nt]").length)
+      assert_equal(EscapeUtils.unescape_html(escaped), doc.inner_text)
+    end
+  end
+end
diff --git a/test/html_pipeline/team_mention_filter_test.rb b/test/html_pipeline/team_mention_filter_test.rb
new file mode 100644
index 00000000..5eeb98af
--- /dev/null
+++ b/test/html_pipeline/team_mention_filter_test.rb
@@ -0,0 +1,204 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+class HTMLPipeline
+  class TeamMentionFilterTest < Minitest::Test
+    def setup
+      @filter = HTMLPipeline::TeamMentionFilter
+
+      @pipeline =
+        HTMLPipeline.new([
+          HTMLPipeline::MarkdownFilter,
+          HTMLPipeline::TeamMentionFilter,
+        ])
+    end
+
+    def mentioned_teams(body)
+      result = {}
+      @pipeline.call(body, result: result)
+      result[:mentioned_teams]
+    end
+
+    def test_filtering_plain_text
+      body = "<p>@github/team: check it out.</p>"
+      res  = @filter.call(body, context: { base_url: "/" })
+
+      link = '<a href="/github/team" class="team-mention">@github/team</a>'
+      assert_equal("<p>#{link}: check it out.</p>",
+        res.to_html)
+    end
+
+    def test_filtering_a_documentfragment
+      body = "<p>@github/team: check it out.</p>"
+      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
+
+      res  = @filter.call(doc, context: { base_url: "/" })
+      assert_same(doc, res)
+
+      link = '<a href="/github/team" class="team-mention">@github/team</a>'
+      assert_equal("<p>#{link}: check it out.</p>",
+        res.to_html)
+    end
+
+    def test_not_replacing_mentions_in_pre_tags
+      body = "<pre>@github/team: okay</pre>"
+      assert_equal(body, @filter.call(body).to_html)
+    end
+
+    def test_not_replacing_mentions_in_code_tags
+      body = "<p><code>@github/team:</code> okay</p>"
+      assert_equal(body, @filter.call(body).to_html)
+    end
+
+    def test_not_replacing_mentions_in_style_tags
+      body = "<style>@github/team (min-width: 768px) { color: red; }</style>"
+      assert_equal(body, @filter.call(body).to_html)
+    end
+
+    def test_not_replacing_mentions_in_links
+      body = "<p><a>@github/team</a> okay</p>"
+      assert_equal(body, @filter.call(body).to_html)
+    end
+
+    def test_entity_encoding_and_whatnot
+      body = "<p>@github&#47team what's up</p>"
+      link = '<a href="/github/team" class="team-mention">@github/team</a>'
+      assert_equal("<p>#{link} what's up</p>", @filter.call(body, context: { base_url: "/" }).to_html)
+    end
+
+    def test_html_injection
+      body = "<p>@github/team &lt;script>alert(0)&lt;/script></p>"
+      link = '<a href="/github/team" class="team-mention">@github/team</a>'
+      assert_equal("<p>#{link} &lt;script&gt;alert(0)&lt;/script&gt;</p>",
+        @filter.call(body, context: { base_url: "/" }).to_html)
+    end
+
+    def test_links_to_nothing_with_user_mention
+      body = "<p>Hi, @kneath</p>"
+      assert_equal("<p>Hi, @kneath</p>",
+        @filter.call(body, context: { base_url: "/" }).to_html)
+    end
+
+    def test_base_url_slash
+      body = "<p>Hi, @github/team!</p>"
+      link = '<a href="/github/team" class="team-mention">@github/team</a>'
+      assert_equal("<p>Hi, #{link}!</p>",
+        @filter.call(body, context: { base_url: "/" }).to_html)
+    end
+
+    def test_base_url_under_custom_route
+      body = "<p>Hi, @org/team!</p>"
+      link = '<a href="www.github.com/org/team" class="team-mention">@org/team</a>'
+      assert_equal("<p>Hi, #{link}!</p>",
+        @filter.call(body, context: { base_url: "www.github.com" }).to_html)
+    end
+
+    def test_base_url_slash_with_tilde
+      body = "<p>Hi, @github/team!</p>"
+      link = '<a href="/~github/team" class="team-mention">@github/team</a>'
+      assert_equal("<p>Hi, #{link}!</p>",
+        @filter.call(body, context: { base_url: "/~" }).to_html)
+    end
+
+    def test_multiple_team_mentions
+      body = "<p>Hi, @github/whale and @github/donut!</p>"
+      link_whale = '<a href="/github/whale" class="team-mention">@github/whale</a>'
+      link_donut = '<a href="/github/donut" class="team-mention">@github/donut</a>'
+      assert_equal("<p>Hi, #{link_whale} and #{link_donut}!</p>",
+        @filter.call(body).to_html)
+    end
+
+    def test_matches_teams_in_body
+      body = "@test/team how are you?"
+      assert_equal(["team"], mentioned_teams(body))
+    end
+
+    def test_matches_orgs_with_dashes
+      body = "hi @some-org/team"
+      assert_equal(["team"], mentioned_teams(body))
+    end
+
+    def test_matches_teams_with_dashes
+      body = "hi @github/some-team"
+      assert_equal(["some-team"], mentioned_teams(body))
+    end
+
+    def test_matches_teams_followed_by_a_single_dot
+      body = "okay @github/team."
+      assert_equal(["team"], mentioned_teams(body))
+    end
+
+    def test_matches_teams_followed_by_multiple_dots
+      body = "okay @github/team..."
+      assert_equal(["team"], mentioned_teams(body))
+    end
+
+    def test_does_not_match_email_addresses
+      body = "aman@tmm1.net"
+      assert_empty(mentioned_teams(body))
+    end
+
+    def test_does_not_match_domain_name_looking_things
+      body = "we need a @github.com email"
+      assert_empty(mentioned_teams(body))
+    end
+
+    def test_does_not_match_user_mentions
+      body = "we need to @enterprise know"
+      assert_empty(mentioned_teams(body))
+    end
+
+    def test_matches_colon_suffixed_team_names
+      body = "@github/team: what do you think?"
+      assert_equal(["team"], mentioned_teams(body))
+    end
+
+    def test_matches_list_of_teams
+      body = "@github/whale @github/donut @github/green"
+      assert_equal(["whale", "donut", "green"], mentioned_teams(body))
+    end
+
+    def test_matches_list_of_teams_with_commas
+      body = "/cc @github/whale, @github/donut, @github/green"
+      assert_equal(["whale", "donut", "green"], mentioned_teams(body))
+    end
+
+    def test_matches_inside_brackets
+      body = "(@github/whale) and [@github/donut]"
+      assert_equal(["whale", "donut"], mentioned_teams(body))
+    end
+
+    def test_returns_distinct_set
+      body = "/cc @github/whale, @github/donut, @github/whale, @github/whale"
+      assert_equal(["whale", "donut"], mentioned_teams(body))
+    end
+
+    def test_does_not_match_inline_code_block_with_multiple_code_blocks
+      body = "something\n\n`/cc @github/whale @github/donut @github/green` `/cc @donut/donut`"
+      assert_empty(mentioned_teams(body))
+    end
+
+    def test_mention_at_end_of_parenthetical_sentence
+      body = "(We're talking 'bout @some-org/some-team.)"
+      assert_equal(["some-team"], mentioned_teams(body))
+    end
+
+    def test_team_pattern_can_be_customized
+      body = "<p>@_abc/XYZ: test</p>"
+      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
+
+      res  = @filter.call(doc, context: { team_pattern: %r{@(_[a-z]{3})/([A-Z]{3})} })
+
+      link = '<a href="/_abc/XYZ" class="team-mention">@_abc/XYZ</a>'
+      assert_equal("<p>#{link}: test</p>",
+        res.to_html)
+    end
+
+    def test_mention_link_filter
+      filter = HTMLPipeline::TeamMentionFilter.new(nil)
+      expected = "<a href='/bot/hubot' class='team-mention'>@bot/hubot</a>"
+      assert_equal(expected, filter.mention_link_filter("@bot/hubot"))
+    end
+  end
+end
diff --git a/test/html_pipeline/toc_filter_test.rb b/test/html_pipeline/toc_filter_test.rb
new file mode 100644
index 00000000..5a0b14b8
--- /dev/null
+++ b/test/html_pipeline/toc_filter_test.rb
@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+class HTMLPipeline
+  class TableOfContentsFilterTest < Minitest::Test
+    TocFilter = HTMLPipeline::TableOfContentsFilter
+
+    TocPipeline =
+      HTMLPipeline.new([
+        HTMLPipeline::TableOfContentsFilter,
+      ])
+
+    def toc(content)
+      result = {}
+      TocPipeline.call(content, context: {}, result: result)
+      result[:toc]
+    end
+
+    def test_anchors_are_added_properly
+      orig = %(<h1>Ice cube</h1><p>Will swarm on any motherfucker in a blue uniform</p>)
+      assert_includes(TocFilter.call(orig).to_s, "<a id=")
+    end
+
+    def test_custom_anchor_icons_added_properly
+      orig = %(<h1>Ice cube</h1>)
+      expected = %(<h1>\n<a id="ice-cube" class="anchor" href="#ice-cube" aria-hidden="true">#</a>Ice cube</h1>)
+
+      assert_equal(expected, TocFilter.call(orig, context: { anchor_icon: "#" }).to_s)
+    end
+
+    def test_toc_list_added_properly
+      orig = %(<h1>Ice cube</h1><p>Will swarm on any motherfucker in a blue uniform</p>)
+      assert_includes(toc(orig), %(<ul class="section-nav">\n<li><a href="))
+    end
+
+    def test_anchors_have_sane_names
+      orig = %(<h1>Dr Dre</h1><h1>Ice Cube</h1><h1>Eazy-E</h1><h1>MC Ren</h1>)
+      result = TocFilter.call(orig).to_s
+
+      assert_includes(result, '"dr-dre"')
+      assert_includes(result, '"ice-cube"')
+      assert_includes(result, '"eazy-e"')
+      assert_includes(result, '"mc-ren"')
+    end
+
+    def test_anchors_have_aria_hidden
+      orig = "<h1>Straight Outta Compton</h1>"
+      result = TocFilter.call(orig).to_s
+      assert_includes(result, 'aria-hidden="true"')
+    end
+
+    def test_toc_hrefs_have_sane_values
+      orig = %(<h1>Dr Dre</h1><h1>Ice Cube</h1><h1>Eazy-E</h1><h1>MC Ren</h1>)
+      toc = TocFilter.call(orig).to_s
+      assert_includes(toc, '"#dr-dre"')
+      assert_includes(toc, '"#ice-cube"')
+      assert_includes(toc, '"#eazy-e"')
+      assert_includes(toc, '"#mc-ren"')
+    end
+
+    def test_dupe_headers_have_unique_trailing_identifiers
+      orig = %(<h1>Straight Outta Compton</h1>
+             <h2>Dopeman</h2>
+             <h3>Express Yourself</h3>
+             <h1>Dopeman</h1>)
+
+      result = TocFilter.call(orig).to_s
+
+      assert_includes(result, '"dopeman"')
+      assert_includes(result, '"dopeman-1"')
+    end
+
+    def test_dupe_headers_have_unique_toc_anchors
+      orig = %(<h1>Straight Outta Compton</h1>
+              <h2>Dopeman</h2>
+              <h3>Express Yourself</h3>
+              <h1>Dopeman</h1>)
+
+      assert_includes(toc(orig), '"#dopeman"')
+      assert_includes(toc(orig), '"#dopeman-1"')
+    end
+
+    def test_all_header_tags_are_found_when_adding_anchors
+      orig = %(<h1>"Funky President" by James Brown</h1>
+             <h2>"It's My Thing" by Marva Whitney</h2>
+             <h3>"Boogie Back" by Roy Ayers</h3>
+             <h4>"Feel Good" by Fancy</h4>
+             <h5>"Funky Drummer" by James Brown</h5>
+             <h6>"Ruthless Villain" by Eazy-E</h6>
+             <h7>"Be Thankful for What You Got" by William DeVaughn</h7>)
+
+      doc = TocFilter.call(orig)
+
+      assert_equal(6, doc.search("a").size)
+    end
+
+    def test_toc_outputs_escaped_html
+      orig = %(<h1>&lt;img src="x" onerror="alert(42)"&gt;</h1>)
+
+      refute_includes(toc(orig), %(<img src="x" onerror="alert(42)">))
+    end
+
+    def test_toc_is_complete
+      orig = %(<h1>"Funky President" by James Brown</h1>
+              <h2>"It's My Thing" by Marva Whitney</h2>
+              <h3>"Boogie Back" by Roy Ayers</h3>
+              <h4>"Feel Good" by Fancy</h4>
+              <h5>"Funky Drummer" by James Brown</h5>
+              <h6>"Ruthless Villain" by Eazy-E</h6>
+              <h7>"Be Thankful for What You Got" by William DeVaughn</h7>)
+
+      expected = %(<ul class="section-nav">\n<li><a href="#funky-president-by-james-brown">&quot;Funky President&quot; by James Brown</a></li>\n<li><a href="#its-my-thing-by-marva-whitney">&quot;It&#39;s My Thing&quot; by Marva Whitney</a></li>\n<li><a href="#boogie-back-by-roy-ayers">&quot;Boogie Back&quot; by Roy Ayers</a></li>\n<li><a href="#feel-good-by-fancy">&quot;Feel Good&quot; by Fancy</a></li>\n<li><a href="#funky-drummer-by-james-brown">&quot;Funky Drummer&quot; by James Brown</a></li>\n<li><a href="#ruthless-villain-by-eazy-e">&quot;Ruthless Villain&quot; by Eazy-E</a></li>\n</ul>)
+
+      assert_equal(expected, toc(orig))
+    end
+
+    if RUBY_VERSION > "1.9" # not sure how to make this work on 1.8.7
+
+      def test_anchors_with_utf8_characters
+        orig = %(<h1>日本語</h1>
+               <h1>Русский</h1)
+
+        rendered_h1s = TocFilter.call(orig).search("h1").map(&:to_s)
+
+        assert_equal("<h1>\n<a id=\"日本語\" class=\"anchor\" href=\"#%E6%97%A5%E6%9C%AC%E8%AA%9E\" aria-hidden=\"true\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"></span></a>日本語</h1>",
+          rendered_h1s[0])
+        assert_equal("<h1>\n<a id=\"Русский\" class=\"anchor\" href=\"#%D0%A0%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9\" aria-hidden=\"true\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"></span></a>Русский</h1>",
+          rendered_h1s[1])
+      end
+
+      def test_toc_with_utf8_characters
+        orig = %(<h1>日本語</h1>
+                <h1>Русский</h1)
+
+        rendered_toc = Nokogiri::HTML::DocumentFragment.parse(toc(orig)).to_s
+
+        expected = %(<ul class="section-nav">\n<li><a href="#%E6%97%A5%E6%9C%AC%E8%AA%9E">日本語</a></li>\n<li><a href="#%D0%A0%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9">Русский</a></li>\n</ul>)
+
+        assert_equal(expected, rendered_toc)
+      end
+    end
+  end
+end
diff --git a/test/html_pipeline_test.rb b/test/html_pipeline_test.rb
new file mode 100644
index 00000000..1e74a23c
--- /dev/null
+++ b/test/html_pipeline_test.rb
@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require "test_helper"
+require "helpers/mocked_instrumentation_service"
+
+class HTMLPipelineTest < Minitest::Test
+  Pipeline = HTMLPipeline
+  class TestFilter
+    def self.call(input, context: {}, result: {})
+      input.reverse
+    end
+  end
+
+  def setup
+    @default_context = {}
+    @result_class = Hash
+    @pipeline = Pipeline.new([TestFilter], default_context: @default_context, result_class: @result_class)
+  end
+
+  def test_filter_instrumentation
+    service = MockedInstrumentationService.new
+    events = service.subscribe("call_filter.html_pipeline")
+    @pipeline.instrumentation_service = service
+    body = "hello"
+    @pipeline.call(body)
+    event, payload, = events.pop
+    assert(event, "event expected")
+    assert_equal("call_filter.html_pipeline", event)
+    assert_equal(TestFilter.name, payload[:filter])
+    assert_equal(@pipeline.class.name, payload[:pipeline])
+    assert_equal(body.reverse, payload[:result][:output])
+  end
+
+  def test_pipeline_instrumentation
+    service = MockedInstrumentationService.new
+    events = service.subscribe("call_pipeline.html_pipeline")
+    @pipeline.instrumentation_service = service
+    body = "hello"
+    @pipeline.call(body)
+    event, payload, = events.pop
+    assert(event, "event expected")
+    assert_equal("call_pipeline.html_pipeline", event)
+    assert_equal(@pipeline.filters.map(&:name), payload[:filters])
+    assert_equal(@pipeline.class.name, payload[:pipeline])
+    assert_equal(body.reverse, payload[:result][:output])
+  end
+
+  def test_default_instrumentation_service
+    service = "default"
+    Pipeline.default_instrumentation_service = service
+    pipeline = Pipeline.new([], default_context: @default_context, result_class: @result_class)
+    assert_equal(service, pipeline.instrumentation_service)
+  ensure
+    Pipeline.default_instrumentation_service = nil
+  end
+
+  def test_setup_instrumentation
+    assert_nil(@pipeline.instrumentation_service)
+
+    service = MockedInstrumentationService.new
+    events = service.subscribe("call_pipeline.html_pipeline")
+    name = "foo"
+    @pipeline.setup_instrumentation(name, service: service)
+
+    assert_equal(service, @pipeline.instrumentation_service)
+    assert_equal(name, @pipeline.instrumentation_name)
+
+    body = "foo"
+    @pipeline.call(body)
+
+    event, payload, = events.pop
+    assert(event, "expected event")
+    assert_equal(name, payload[:pipeline])
+    assert_equal(body.reverse, payload[:result][:output])
+  end
+end
diff --git a/test/test_helper.rb b/test/test_helper.rb
index bea83dea..9db81b7f 100644
--- a/test/test_helper.rb
+++ b/test/test_helper.rb
@@ -1,21 +1,21 @@
 # frozen_string_literal: true
 
-require 'bundler/setup'
-require 'html/pipeline'
+require "bundler/setup"
+require "html_pipeline"
 
-require 'minitest/autorun'
-require 'minitest/pride'
-require 'minitest/focus'
+require "minitest/autorun"
+require "minitest/pride"
+require "minitest/focus"
 
-require 'awesome_print'
+require "awesome_print"
 
 module TestHelpers
   # Asserts that two html fragments are equivalent. Attribute order
   # will be ignored.
   def assert_equal_html(expected, actual)
-    assert_equal Nokogiri::HTML::DocumentFragment.parse(expected).to_h,
-                 Nokogiri::HTML::DocumentFragment.parse(actual).to_h
+    assert_equal(Nokogiri::HTML::DocumentFragment.parse(expected).to_h,
+      Nokogiri::HTML::DocumentFragment.parse(actual).to_h)
   end
 end
 
-Minitest::Test.include TestHelpers
+Minitest::Test.include(TestHelpers)

From 32185aa04f4a52c246a0b8b1260ed2083bbfba52 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Sat, 4 Jun 2022 09:00:05 -0700
Subject: [PATCH 24/64] gotta keep 'em seperated

---
 lib/html_pipeline/absolute_source_filter.rb   |  47 ------
 lib/html_pipeline/autolink_filter.rb          |  32 ----
 lib/html_pipeline/emoji_filter.rb             | 133 ----------------
 lib/html_pipeline/filter.rb                   |  85 ++--------
 lib/html_pipeline/https_filter.rb             |  27 ----
 lib/html_pipeline/image_filter.rb             |  17 --
 lib/html_pipeline/image_max_width_filter.rb   |  35 -----
 lib/html_pipeline/markdown_filter.rb          |  53 -------
 lib/html_pipeline/mention_filter.rb           | 119 --------------
 lib/html_pipeline/node_filter.rb              |  53 +++++++
 .../node_filter/absolute_source_filter.rb     |  49 ++++++
 lib/html_pipeline/node_filter/emoji_filter.rb | 135 ++++++++++++++++
 lib/html_pipeline/node_filter/https_filter.rb |  29 ++++
 .../node_filter/image_max_width_filter.rb     |  37 +++++
 .../node_filter/mention_filter.rb             | 121 +++++++++++++++
 .../node_filter/sanitization_filter.rb        | 113 ++++++++++++++
 .../node_filter/syntax_highlight_filter.rb    |  50 ++++++
 .../node_filter/table_of_contents_filter.rb   |  69 +++++++++
 .../node_filter/team_mention_filter.rb        | 101 ++++++++++++
 lib/html_pipeline/plain_text_input_filter.rb  |  13 --
 lib/html_pipeline/sanitization_filter.rb      | 111 -------------
 lib/html_pipeline/syntax_highlight_filter.rb  |  48 ------
 lib/html_pipeline/table_of_contents_filter.rb |  67 --------
 lib/html_pipeline/team_mention_filter.rb      |  99 ------------
 lib/html_pipeline/text_filter.rb              |  12 +-
 .../text_filter/autolink_filter.rb            |  34 ++++
 lib/html_pipeline/text_filter/image_filter.rb |  19 +++
 .../text_filter/markdown_filter.rb            |  55 +++++++
 .../text_filter/plain_text_input_filter.rb    |  15 ++
 .../absolute_source_filter_test.rb            |  58 -------
 test/html_pipeline/autolink_filter_test.rb    |  59 -------
 .../absolute_source_filter_test.rb            |  59 +++++++
 .../node_filter}/emoji_filter_test.rb         |  10 +-
 .../node_filter}/https_filter_test.rb         |   4 +-
 .../image_max_width_filter_test.rb            |   2 +-
 .../node_filter}/mention_filter_test.rb       |  14 +-
 .../node_filter}/sanitization_filter_test.rb  |   2 +-
 .../syntax_highlight_filter_test.rb           |   2 +-
 .../table_of_contents_filter_test.rb          | 146 ++++++++++++++++++
 .../node_filter}/team_mention_filter_test.rb  |   8 +-
 .../text_filter/autolink_filter_test.rb       |  61 ++++++++
 .../text_filter}/image_filter_test.rb         |  14 +-
 .../text_filter}/markdown_filter_test.rb      |   6 +-
 .../plain_text_input_filter_test.rb           |   2 +-
 test/html_pipeline/toc_filter_test.rb         | 144 -----------------
 45 files changed, 1204 insertions(+), 1165 deletions(-)
 delete mode 100644 lib/html_pipeline/absolute_source_filter.rb
 delete mode 100644 lib/html_pipeline/autolink_filter.rb
 delete mode 100644 lib/html_pipeline/emoji_filter.rb
 delete mode 100644 lib/html_pipeline/https_filter.rb
 delete mode 100644 lib/html_pipeline/image_filter.rb
 delete mode 100644 lib/html_pipeline/image_max_width_filter.rb
 delete mode 100644 lib/html_pipeline/markdown_filter.rb
 delete mode 100644 lib/html_pipeline/mention_filter.rb
 create mode 100644 lib/html_pipeline/node_filter.rb
 create mode 100644 lib/html_pipeline/node_filter/absolute_source_filter.rb
 create mode 100644 lib/html_pipeline/node_filter/emoji_filter.rb
 create mode 100644 lib/html_pipeline/node_filter/https_filter.rb
 create mode 100644 lib/html_pipeline/node_filter/image_max_width_filter.rb
 create mode 100644 lib/html_pipeline/node_filter/mention_filter.rb
 create mode 100644 lib/html_pipeline/node_filter/sanitization_filter.rb
 create mode 100644 lib/html_pipeline/node_filter/syntax_highlight_filter.rb
 create mode 100644 lib/html_pipeline/node_filter/table_of_contents_filter.rb
 create mode 100644 lib/html_pipeline/node_filter/team_mention_filter.rb
 delete mode 100644 lib/html_pipeline/plain_text_input_filter.rb
 delete mode 100644 lib/html_pipeline/sanitization_filter.rb
 delete mode 100644 lib/html_pipeline/syntax_highlight_filter.rb
 delete mode 100644 lib/html_pipeline/table_of_contents_filter.rb
 delete mode 100644 lib/html_pipeline/team_mention_filter.rb
 create mode 100644 lib/html_pipeline/text_filter/autolink_filter.rb
 create mode 100644 lib/html_pipeline/text_filter/image_filter.rb
 create mode 100644 lib/html_pipeline/text_filter/markdown_filter.rb
 create mode 100644 lib/html_pipeline/text_filter/plain_text_input_filter.rb
 delete mode 100644 test/html_pipeline/absolute_source_filter_test.rb
 delete mode 100644 test/html_pipeline/autolink_filter_test.rb
 create mode 100644 test/html_pipeline/filter/node_filter/absolute_source_filter_test.rb
 rename test/html_pipeline/{ => filter/node_filter}/emoji_filter_test.rb (90%)
 rename test/html_pipeline/{ => filter/node_filter}/https_filter_test.rb (91%)
 rename test/html_pipeline/{ => filter/node_filter}/image_max_width_filter_test.rb (96%)
 rename test/html_pipeline/{ => filter/node_filter}/mention_filter_test.rb (92%)
 rename test/html_pipeline/{ => filter/node_filter}/sanitization_filter_test.rb (98%)
 rename test/html_pipeline/{ => filter/node_filter}/syntax_highlight_filter_test.rb (96%)
 create mode 100644 test/html_pipeline/filter/node_filter/table_of_contents_filter_test.rb
 rename test/html_pipeline/{ => filter/node_filter}/team_mention_filter_test.rb (96%)
 create mode 100644 test/html_pipeline/filter/text_filter/autolink_filter_test.rb
 rename test/html_pipeline/{ => filter/text_filter}/image_filter_test.rb (66%)
 rename test/html_pipeline/{ => filter/text_filter}/markdown_filter_test.rb (95%)
 rename test/html_pipeline/{ => filter/text_filter}/plain_text_input_filter_test.rb (90%)
 delete mode 100644 test/html_pipeline/toc_filter_test.rb

diff --git a/lib/html_pipeline/absolute_source_filter.rb b/lib/html_pipeline/absolute_source_filter.rb
deleted file mode 100644
index 83e5d157..00000000
--- a/lib/html_pipeline/absolute_source_filter.rb
+++ /dev/null
@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-require "uri"
-
-class HTMLPipeline
-  class AbsoluteSourceFilter < Filter
-    # HTML Filter for replacing relative and root relative image URLs with
-    # fully qualified URLs
-    #
-    # This is useful if an image is root relative but should really be going
-    # through a cdn, or if the content for the page assumes the host is known
-    # i.e. scraped webpages and some RSS feeds.
-    #
-    # Context options:
-    #   :image_base_url - Base URL for image host for root relative src.
-    #   :image_subpage_url - For relative src.
-    #
-    # This filter does not write additional information to the context.
-    # This filter would need to be run before CamoFilter.
-    def call
-      doc.search("img").each do |element|
-        next if element["src"].nil? || element["src"].empty?
-
-        src = element["src"].strip
-        next if src.start_with?("http")
-
-        base = if src.start_with?("/")
-          image_base_url
-        else
-          image_subpage_url
-        end
-        element["src"] = URI.join(base, src).to_s
-      end
-      doc
-    end
-
-    # Private: the base url you want to use
-    def image_base_url
-      context[:image_base_url] || raise("Missing context :image_base_url for #{self.class.name}")
-    end
-
-    # Private: the relative url you want to use
-    def image_subpage_url
-      context[:image_subpage_url] || raise("Missing context :image_subpage_url for #{self.class.name}")
-    end
-  end
-end
diff --git a/lib/html_pipeline/autolink_filter.rb b/lib/html_pipeline/autolink_filter.rb
deleted file mode 100644
index 61229f40..00000000
--- a/lib/html_pipeline/autolink_filter.rb
+++ /dev/null
@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-HTMLPipeline.require_dependency("rinku", "AutolinkFilter")
-
-class HTMLPipeline
-  # HTML Filter for auto_linking urls in HTML.
-  #
-  # Context options:
-  #   :autolink  - boolean whether to autolink urls
-  #   :link_mode - :all, :urls or :email_addresses
-  #   :link_attr - HTML attributes for the link that will be generated
-  #   :skip_tags - HTML tags inside which autolinking will be skipped.
-  #                See Rinku.skip_tags
-  #   :flags     - additional Rinku flags. See https://github.com/vmg/rinku
-  #
-  # This filter does not write additional information to the context.
-  class AutolinkFilter < Filter
-    def call
-      return html if context[:autolink] == false
-
-      skip_tags = context[:skip_tags]
-      flags = 0
-      flags |= context[:flags] if context[:flags]
-
-      Rinku.auto_link(html, link_mode, context[:link_attr], skip_tags, flags)
-    end
-
-    def link_mode
-      context[:link_mode] || :urls
-    end
-  end
-end
diff --git a/lib/html_pipeline/emoji_filter.rb b/lib/html_pipeline/emoji_filter.rb
deleted file mode 100644
index dc10acc3..00000000
--- a/lib/html_pipeline/emoji_filter.rb
+++ /dev/null
@@ -1,133 +0,0 @@
-# frozen_string_literal: true
-
-require "cgi"
-HTMLPipeline.require_dependencies(["gemoji", "gemojione"], "EmojiFilter")
-
-class HTMLPipeline
-  # HTML filter that replaces :emoji: with images.
-  #
-  # Context:
-  #   :asset_root (required) - base url to link to emoji sprite
-  #   :asset_path (optional) - url path to link to emoji sprite. :file_name can be used as a placeholder for the sprite file name. If no asset_path is set "emoji/:file_name" is used.
-  #   :ignored_ancestor_tags (optional) - Tags to stop the emojification. Node has matched ancestor HTML tags will not be emojified. Default to pre, code, and tt tags. Extra tags please pass in the form of array, e.g., %w(blockquote summary).
-  #   :img_attrs (optional) - Attributes for generated img tag. E.g. Pass { "draggble" => true, "height" => nil } to set draggable attribute to "true" and clear height attribute of generated img tag.
-  class EmojiFilter < Filter
-    DEFAULT_IGNORED_ANCESTOR_TAGS = ["pre", "code", "tt"].freeze
-
-    def call
-      doc.search(".//text()").each do |node|
-        content = node.text
-        next unless content.include?(":")
-        next if has_ancestor?(node, ignored_ancestor_tags)
-
-        html = emoji_image_filter(content)
-        next if html == content
-
-        node.replace(html)
-      end
-      doc
-    end
-
-    # Implementation of validate hook.
-    # Errors should raise exceptions or use an existing validator.
-    def validate
-      needs(:asset_root)
-    end
-
-    # Replace :emoji: with corresponding images.
-    #
-    # text - String text to replace :emoji: in.
-    #
-    # Returns a String with :emoji: replaced with images.
-    def emoji_image_filter(text)
-      text.gsub(emoji_pattern) do
-        emoji_image_tag(Regexp.last_match(1))
-      end
-    end
-
-    # The base url to link emoji sprites
-    #
-    # Raises ArgumentError if context option has not been provided.
-    # Returns the context's asset_root.
-    def asset_root
-      context[:asset_root]
-    end
-
-    # The url path to link emoji sprites
-    #
-    # :file_name can be used in the asset_path as a placeholder for the sprite file name. If no asset_path is set in the context "emoji/:file_name" is used.
-    # Returns the context's asset_path or the default path if no context asset_path is given.
-    def asset_path(name)
-      if context[:asset_path]
-        context[:asset_path].gsub(":file_name", emoji_filename(name))
-      else
-        File.join("emoji", emoji_filename(name))
-      end
-    end
-
-    # Build an emoji image tag
-    private def emoji_image_tag(name)
-      html_attrs =
-        default_img_attrs(name).transform_keys(&:to_sym)
-          .merge!(context[:img_attrs] || {}).transform_keys(&:to_sym)
-          .each_with_object([]) do |(attr, value), arr|
-          next if value.nil?
-
-          value = value.respond_to?(:call) && value.call(name) || value
-          arr << %(#{attr}="#{value}")
-        end.compact.join(" ")
-
-      "<img #{html_attrs}>"
-    end
-
-    # Build a regexp that matches all valid :emoji: names.
-    def emoji_pattern
-      @emoji_pattern ||= /:(#{emoji_names.map { |name| Regexp.escape(name) }.join('|')}):/
-    end
-
-    def emoji_names
-      if self.class.gemoji_loaded?
-        Emoji.all.map(&:aliases)
-      else
-        Gemojione::Index.new.all.map { |i| i[1]["name"] }
-      end.flatten.sort
-    end
-
-    # Default attributes for img tag
-    private def default_img_attrs(name)
-      {
-        "class" => "emoji",
-        "title" => ":#{name}:",
-        "alt" => ":#{name}:",
-        "src" => emoji_url(name).to_s,
-        "height" => "20",
-        "width" => "20",
-        "align" => "absmiddle",
-      }
-    end
-
-    private def emoji_url(name)
-      File.join(asset_root, asset_path(name))
-    end
-
-    private def emoji_filename(name)
-      if self.class.gemoji_loaded?
-        Emoji.find_by_alias(name).image_filename
-      else
-        # replace their asset_host with ours
-        Gemojione.image_url_for_name(name).sub(Gemojione.asset_host, "")
-      end
-    end
-
-    # Return ancestor tags to stop the emojification.
-    #
-    # @return [Array<String>] Ancestor tags.
-    private def ignored_ancestor_tags
-      if context[:ignored_ancestor_tags]
-        DEFAULT_IGNORED_ANCESTOR_TAGS | context[:ignored_ancestor_tags]
-      else
-        DEFAULT_IGNORED_ANCESTOR_TAGS
-      end
-    end
-  end
-end
diff --git a/lib/html_pipeline/filter.rb b/lib/html_pipeline/filter.rb
index 7775ac13..b686b4c3 100644
--- a/lib/html_pipeline/filter.rb
+++ b/lib/html_pipeline/filter.rb
@@ -9,7 +9,7 @@ class HTMLPipeline
   #
   # Example filter that replaces all images with trollface:
   #
-  #   class FuuuFilter < HTMLPipeline::Filter
+  #   class TrollFilter < HTMLPipeline::Filter
   #     def call
   #       doc.search('img').each do |img|
   #         img['src'] = "http://paradoxdgn.com/junk/avatars/trollface.jpg"
@@ -30,14 +30,7 @@ class HTMLPipeline
   class Filter
     class InvalidDocumentException < StandardError; end
 
-    def initialize(doc, context: {}, result: {})
-      if doc.is_a?(String)
-        @html = doc.to_str
-        @doc = nil
-      else
-        @doc = doc
-        @html = nil
-      end
+    def initialize(context: {}, result: {})
       @context = context
       @result = result
       validate
@@ -53,22 +46,6 @@ def initialize(doc, context: {}, result: {})
     # #mentioned_users, for example.
     attr_reader :result
 
-    # The Nokogiri::HTML::DocumentFragment to be manipulated. If the filter was
-    # provided a String, parse into a DocumentFragment the first time this
-    # method is called.
-    def doc
-      @doc ||= parse_html(html)
-    end
-
-    # The String representation of the document. If a DocumentFragment was
-    # provided to the Filter, it is serialized into a String when this method is
-    # called.
-    def html
-      raise InvalidDocumentException if @html.nil? && @doc.nil?
-
-      @html || doc.to_html
-    end
-
     # The main filter entry point. The doc attribute is guaranteed to be a
     # Nokogiri::HTML::DocumentFragment when invoked. Subclasses should modify
     # this document in place or extract information and add it to the context
@@ -77,37 +54,30 @@ def call
       raise NotImplementedError
     end
 
-    # Make sure the context has everything we need. Noop: Subclasses can override.
-    def validate; end
-
-    # The Repository object provided in the context hash, or nil when no
-    # :repository was specified.
+    # Perform a filter on doc with the given context.
     #
-    # It's assumed that the repository context has already been checked
-    # for permissions
-    def repository
-      context[:repository]
+    # Returns a HTMLPipeline::DocumentFragment or a String containing HTML
+    # markup.
+    def self.call(input, context: {}, result: {})
+      new(input, context: context, result: result).call
     end
 
-    # The User object provided in the context hash, or nil when no user
-    # was specified
-    def current_user
-      context[:current_user]
+    # Like call but guarantees that a DocumentFragment is returned, even when
+    # the last filter returns a String.
+    def self.to_document(input, context: {})
+      html = call(input, context: context)
+      HTMLPipeline.parse(html)
     end
 
+    # Make sure the context has everything we need. Noop: Subclasses can override.
+    def validate; end
+
     # The site's base URL provided in the context hash, or '/' when no
     # base URL was specified.
     def base_url
       context[:base_url] || "/"
     end
 
-    # Ensure the passed argument is a DocumentFragment. When a string is
-    # provided, it is parsed and returned; otherwise, the DocumentFragment is
-    # returned unmodified.
-    def parse_html(html)
-      HTMLPipeline.parse(html)
-    end
-
     # Helper method for filter subclasses used to determine if any of a node's
     # ancestors have one of the tag names specified.
     #
@@ -121,31 +91,6 @@ def has_ancestor?(node, tags)
       end
     end
 
-    # Perform a filter on doc with the given context.
-    #
-    # Returns a HTMLPipeline::DocumentFragment or a String containing HTML
-    # markup.
-    def self.call(doc, context: {}, result: {})
-      new(doc, context: context, result: result).call
-    end
-
-    # Like call but guarantees that a DocumentFragment is returned, even when
-    # the last filter returns a String.
-    def self.to_document(input, context: {})
-      html = call(input, context: context)
-      HTMLPipeline.parse(html)
-    end
-
-    # Like call but guarantees that a string of HTML markup is returned.
-    def self.to_html(input, context: {})
-      output = call(input, context: context)
-      if output.respond_to?(:to_html)
-        output.to_html
-      else
-        output.to_s
-      end
-    end
-
     # Validator for required context. This will check that anything passed in
     # contexts exists in @contexts
     #
diff --git a/lib/html_pipeline/https_filter.rb b/lib/html_pipeline/https_filter.rb
deleted file mode 100644
index 8ae1f910..00000000
--- a/lib/html_pipeline/https_filter.rb
+++ /dev/null
@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-class HTMLPipeline
-  # HTML Filter for replacing http references to :http_url with https versions.
-  # Subdomain references are not rewritten.
-  #
-  # Context options:
-  #   :http_url - The HTTP url to force HTTPS. Falls back to :base_url
-  class HttpsFilter < Filter
-    def call
-      doc.css(%(a[href^="#{http_url}"])).each do |element|
-        element["href"] = element["href"].sub(/^http:/, "https:")
-      end
-      doc
-    end
-
-    # HTTP url to replace. Falls back to :base_url
-    def http_url
-      context[:http_url] || context[:base_url]
-    end
-
-    # Raise error if :http_url undefined
-    def validate
-      needs(:http_url) unless http_url
-    end
-  end
-end
diff --git a/lib/html_pipeline/image_filter.rb b/lib/html_pipeline/image_filter.rb
deleted file mode 100644
index 10b7fe46..00000000
--- a/lib/html_pipeline/image_filter.rb
+++ /dev/null
@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-class HTMLPipeline
-  # HTML Filter that converts image's url into <img> tag.
-  # For example, it will convert
-  #   http://example.com/test.jpg
-  # into
-  #   <img src="http://example.com/test.jpg" alt=""/>.
-
-  class ImageFilter < TextFilter
-    def call
-      @text.gsub(%r{(https|http)?://.+\.(jpg|jpeg|bmp|gif|png)(\?\S+)?}i) do |match|
-        %(<img src="#{match}" alt=""/>)
-      end
-    end
-  end
-end
diff --git a/lib/html_pipeline/image_max_width_filter.rb b/lib/html_pipeline/image_max_width_filter.rb
deleted file mode 100644
index 8d2d6b47..00000000
--- a/lib/html_pipeline/image_max_width_filter.rb
+++ /dev/null
@@ -1,35 +0,0 @@
-# frozen_string_literal: true
-
-class HTMLPipeline
-  # This filter rewrites image tags with a max-width inline style and also wraps
-  # the image in an <a> tag that causes the full size image to be opened in a
-  # new tab.
-  #
-  # The max-width inline styles are especially useful in HTML email which
-  # don't use a global stylesheets.
-  class ImageMaxWidthFilter < Filter
-    def call
-      doc.search("img").each do |element|
-        # Skip if there's already a style attribute. Not sure how this
-        # would happen but we can reconsider it in the future.
-        next if element["style"]
-
-        # Bail out if src doesn't look like a valid http url. trying to avoid weird
-        # js injection via javascript: urls.
-        next if /\Ajavascript/i.match?(element["src"].to_s.strip)
-
-        element["style"] = "max-width:100%;"
-
-        link_image(element) unless has_ancestor?(element, ["a"])
-      end
-
-      doc
-    end
-
-    def link_image(element)
-      link = doc.document.create_element("a", href: element["src"], target: "_blank")
-      link.add_child(element.dup)
-      element.replace(link)
-    end
-  end
-end
diff --git a/lib/html_pipeline/markdown_filter.rb b/lib/html_pipeline/markdown_filter.rb
deleted file mode 100644
index d1323fbf..00000000
--- a/lib/html_pipeline/markdown_filter.rb
+++ /dev/null
@@ -1,53 +0,0 @@
-# frozen_string_literal: true
-
-HTMLPipeline.require_dependency("commonmarker", "MarkdownFilter")
-
-class HTMLPipeline
-  # HTML Filter that converts Markdown text into HTML and converts into a
-  # DocumentFragment. This is different from most filters in that it can take a
-  # non-HTML as input. It must be used as the first filter in a pipeline.
-  #
-  # Context options:
-  #   :gfm      => false    Disable GFM line-end processing
-  #   :commonmarker_extensions => [ :table, :strikethrough,
-  #      :tagfilter, :autolink ] Commonmarker extensions to include
-  #
-  # This filter does not write any additional information to the context hash.
-  class MarkdownFilter < TextFilter
-    DEFAULT_COMMONMARKER_EXTENSIONS = [:table, :strikethrough, :tagfilter, :autolink].freeze
-
-    def initialize(text, context: {}, result: {})
-      super(text, context: context, result: result)
-      @text = @text.delete("\r")
-    end
-
-    # Convert Markdown to HTML using the best available implementation
-    # and convert into a DocumentFragment.
-    def call
-      extensions = context.fetch(
-        :commonmarker_extensions,
-        DEFAULT_COMMONMARKER_EXTENSIONS
-      )
-      html = if (renderer = context[:commonmarker_renderer])
-        raise ArgumentError, "`commonmark_renderer` must be derived from `CommonMarker::HtmlRenderer`" unless renderer < CommonMarker::HtmlRenderer
-
-        parse_options = :DEFAULT
-        parse_options = [:UNSAFE] if context[:unsafe]
-
-        render_options = [:GITHUB_PRE_LANG]
-        render_options << :HARDBREAKS if context[:gfm] != false
-        render_options << :UNSAFE if context[:unsafe]
-
-        doc = CommonMarker.render_doc(@text, parse_options, extensions)
-        renderer.new(options: render_options, extensions: extensions).render(doc)
-      else
-        options = [:GITHUB_PRE_LANG]
-        options << :HARDBREAKS if context[:gfm] != false
-        options << :UNSAFE if context[:unsafe]
-        CommonMarker.render_html(@text, options, extensions)
-      end
-      html.rstrip!
-      html
-    end
-  end
-end
diff --git a/lib/html_pipeline/mention_filter.rb b/lib/html_pipeline/mention_filter.rb
deleted file mode 100644
index 519a5425..00000000
--- a/lib/html_pipeline/mention_filter.rb
+++ /dev/null
@@ -1,119 +0,0 @@
-# frozen_string_literal: true
-
-require "set"
-
-class HTMLPipeline
-  # HTML filter that replaces @user mentions with links. Mentions within <pre>,
-  # <code>, and <a> elements are ignored. Mentions that reference users that do
-  # not exist are ignored.
-  #
-  # Context options:
-  #   :base_url - Used to construct links to user profile pages for each
-  #               mention.
-  #   :info_url - Used to link to "more info" when someone mentions @mention
-  #               or @mentioned.
-  #   :username_pattern - Used to provide a custom regular expression to
-  #                       identify usernames
-  #
-  class MentionFilter < Filter
-    # Public: Find user @mentions in text.  See
-    # MentionFilter#mention_link_filter.
-    #
-    #   MentionFilter.mentioned_logins_in(text) do |match, login, is_mentioned|
-    #     "<a href=...>#{login}</a>"
-    #   end
-    #
-    # text - String text to search.
-    #
-    # Yields the String match, the String login name, and a Boolean determining
-    # if the match = "@mention[ed]".  The yield's return replaces the match in
-    # the original text.
-    #
-    # Returns a String replaced with the return of the block.
-    def self.mentioned_logins_in(text, username_pattern = USERNAME_PATTERN)
-      text.gsub(MENTION_PATTERNS[username_pattern]) do |match|
-        login = Regexp.last_match(1)
-        yield match, login
-      end
-    end
-
-    # Hash that contains all of the mention patterns used by the pipeline
-    MENTION_PATTERNS = Hash.new do |hash, key|
-      hash[key] = %r{
-        (?:^|\W)                    # beginning of string or non-word char
-        @((?>#{key}))  # @username
-        (?!/)                      # without a trailing slash
-        (?=
-          \.+[ \t\W]|               # dots followed by space or non-word character
-          \.+$|                     # dots at end of line
-          [^0-9a-zA-Z_.]|           # non-word character except dot
-          $                         # end of line
-        )
-      }ix
-    end
-
-    # Default pattern used to extract usernames from text. The value can be
-    # overriden by providing the username_pattern variable in the context.
-    USERNAME_PATTERN = /[a-z0-9][a-z0-9-]*/.freeze
-
-    # Don't look for mentions in text nodes that are children of these elements
-    IGNORE_PARENTS = ["pre", "code", "a", "style", "script"].to_set
-
-    def call
-      result[:mentioned_usernames] ||= []
-
-      doc.search(".//text()").each do |node|
-        content = node.to_html
-        next unless content.include?("@")
-        next if has_ancestor?(node, IGNORE_PARENTS)
-
-        html = mention_link_filter(content, base_url: base_url, username_pattern: username_pattern)
-        next if html == content
-
-        node.replace(html)
-      end
-      doc
-    end
-
-    # The URL to provide when someone @mentions a "mention" name, such
-    # as @mention or @mentioned, that will give them more info on mentions.
-    def info_url
-      context[:info_url] || nil
-    end
-
-    def username_pattern
-      context[:username_pattern] || USERNAME_PATTERN
-    end
-
-    # Replace user @mentions in text with links to the mentioned user's
-    # profile page.
-    #
-    # text      - String text to replace @mention usernames in.
-    # base_url  - The base URL used to construct user profile URLs.
-    # info_url  - The "more info" URL used to link to more info on @mentions.
-    #             If nil we don't link @mention or @mentioned.
-    # username_pattern  - Regular expression used to identify usernames in
-    #                     text
-    #
-    # Returns a string with @mentions replaced with links. All links have a
-    # 'user-mention' class name attached for styling.
-    def mention_link_filter(text, base_url: "/", username_pattern: USERNAME_PATTERN)
-      self.class.mentioned_logins_in(text, username_pattern) do |match, login|
-        link = link_to_mentioned_user(base_url, login)
-
-        link ? match.sub("@#{login}", link) : match
-      end
-    end
-
-    def link_to_mentioned_user(base_url, login)
-      result[:mentioned_usernames] |= [login]
-
-      url = base_url.dup
-      url << "/" unless %r{[/~]\z}.match?(url)
-
-      "<a href='#{url << login}' class='user-mention'>" \
-        "@#{login}" \
-        "</a>"
-    end
-  end
-end
diff --git a/lib/html_pipeline/node_filter.rb b/lib/html_pipeline/node_filter.rb
new file mode 100644
index 00000000..c81045e5
--- /dev/null
+++ b/lib/html_pipeline/node_filter.rb
@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+class HTMLPipeline
+  class NodeFilter < Filter
+    def initialize(html, context: {}, result: {})
+      typecheck_input(html)
+      super(context: context, result: result)
+    end
+
+    # Like call but guarantees that a string of HTML markup is returned.
+    def self.to_html(input, context: {})
+      output = call(input, context: context)
+      if output.respond_to?(:to_html)
+        output.to_html
+      else
+        output.to_s
+      end
+    end
+
+    # The Nokogiri::HTML::DocumentFragment to be manipulated. If the filter was
+    # provided a String, parse into a DocumentFragment the first time this
+    # method is called.
+    def doc
+      @doc ||= parse_html(html)
+    end
+
+    # The String representation of the document. If a DocumentFragment was
+    # provided to the Filter, it is serialized into a String when this method is
+    # called.
+    def html
+      raise InvalidDocumentException if @html.nil? && @doc.nil?
+
+      @html || doc.to_html
+    end
+
+    # Ensure the passed argument is a DocumentFragment. When a string is
+    # provided, it is parsed and returned; otherwise, the DocumentFragment is
+    # returned unmodified.
+    private def parse_html(html)
+      HTMLPipeline.parse(html)
+    end
+
+    private def typecheck_input(doc)
+      if doc.is_a?(String)
+        @html = doc.to_str
+        @doc = nil
+      else
+        @doc = doc
+        @html = nil
+      end
+    end
+  end
+end
diff --git a/lib/html_pipeline/node_filter/absolute_source_filter.rb b/lib/html_pipeline/node_filter/absolute_source_filter.rb
new file mode 100644
index 00000000..f390f10b
--- /dev/null
+++ b/lib/html_pipeline/node_filter/absolute_source_filter.rb
@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require "uri"
+
+class HTMLPipeline
+  class NodeFilter
+    class AbsoluteSourceFilter < NodeFilter
+      # HTML Filter for replacing relative and root relative image URLs with
+      # fully qualified URLs
+      #
+      # This is useful if an image is root relative but should really be going
+      # through a cdn, or if the content for the page assumes the host is known
+      # i.e. scraped webpages and some RSS feeds.
+      #
+      # Context options:
+      #   :image_base_url - Base URL for image host for root relative src.
+      #   :image_subpage_url - For relative src.
+      #
+      # This filter does not write additional information to the context.
+      # This filter would need to be run before CamoFilter.
+      def call
+        doc.search("img").each do |element|
+          next if element["src"].nil? || element["src"].empty?
+
+          src = element["src"].strip
+          next if src.start_with?("http")
+
+          base = if src.start_with?("/")
+            image_base_url
+          else
+            image_subpage_url
+          end
+          element["src"] = URI.join(base, src).to_s
+        end
+        doc
+      end
+
+      # Private: the base url you want to use
+      def image_base_url
+        context[:image_base_url] || raise("Missing context :image_base_url for #{self.class.name}")
+      end
+
+      # Private: the relative url you want to use
+      def image_subpage_url
+        context[:image_subpage_url] || raise("Missing context :image_subpage_url for #{self.class.name}")
+      end
+    end
+  end
+end
diff --git a/lib/html_pipeline/node_filter/emoji_filter.rb b/lib/html_pipeline/node_filter/emoji_filter.rb
new file mode 100644
index 00000000..123e8dde
--- /dev/null
+++ b/lib/html_pipeline/node_filter/emoji_filter.rb
@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+require "cgi"
+HTMLPipeline.require_dependencies(["gemoji", "gemojione"], "EmojiFilter")
+
+class HTMLPipeline
+  class NodeFilter
+    # HTML filter that replaces :emoji: with images.
+    #
+    # Context:
+    #   :asset_root (required) - base url to link to emoji sprite
+    #   :asset_path (optional) - url path to link to emoji sprite. :file_name can be used as a placeholder for the sprite file name. If no asset_path is set "emoji/:file_name" is used.
+    #   :ignored_ancestor_tags (optional) - Tags to stop the emojification. Node has matched ancestor HTML tags will not be emojified. Default to pre, code, and tt tags. Extra tags please pass in the form of array, e.g., %w(blockquote summary).
+    #   :img_attrs (optional) - Attributes for generated img tag. E.g. Pass { "draggble" => true, "height" => nil } to set draggable attribute to "true" and clear height attribute of generated img tag.
+    class EmojiFilter < NodeFilter
+      DEFAULT_IGNORED_ANCESTOR_TAGS = ["pre", "code", "tt"].freeze
+
+      def call
+        doc.search(".//text()").each do |node|
+          content = node.text
+          next unless content.include?(":")
+          next if has_ancestor?(node, ignored_ancestor_tags)
+
+          html = emoji_image_filter(content)
+          next if html == content
+
+          node.replace(html)
+        end
+        doc
+      end
+
+      # Implementation of validate hook.
+      # Errors should raise exceptions or use an existing validator.
+      def validate
+        needs(:asset_root)
+      end
+
+      # Replace :emoji: with corresponding images.
+      #
+      # text - String text to replace :emoji: in.
+      #
+      # Returns a String with :emoji: replaced with images.
+      def emoji_image_filter(text)
+        text.gsub(emoji_pattern) do
+          emoji_image_tag(Regexp.last_match(1))
+        end
+      end
+
+      # The base url to link emoji sprites
+      #
+      # Raises ArgumentError if context option has not been provided.
+      # Returns the context's asset_root.
+      def asset_root
+        context[:asset_root]
+      end
+
+      # The url path to link emoji sprites
+      #
+      # :file_name can be used in the asset_path as a placeholder for the sprite file name. If no asset_path is set in the context "emoji/:file_name" is used.
+      # Returns the context's asset_path or the default path if no context asset_path is given.
+      def asset_path(name)
+        if context[:asset_path]
+          context[:asset_path].gsub(":file_name", emoji_filename(name))
+        else
+          File.join("emoji", emoji_filename(name))
+        end
+      end
+
+      # Build an emoji image tag
+      private def emoji_image_tag(name)
+        html_attrs =
+          default_img_attrs(name).transform_keys(&:to_sym)
+            .merge!(context[:img_attrs] || {}).transform_keys(&:to_sym)
+            .each_with_object([]) do |(attr, value), arr|
+            next if value.nil?
+
+            value = value.respond_to?(:call) && value.call(name) || value
+            arr << %(#{attr}="#{value}")
+          end.compact.join(" ")
+
+        "<img #{html_attrs}>"
+      end
+
+      # Build a regexp that matches all valid :emoji: names.
+      def emoji_pattern
+        @emoji_pattern ||= /:(#{emoji_names.map { |name| Regexp.escape(name) }.join('|')}):/
+      end
+
+      def emoji_names
+        if self.class.gemoji_loaded?
+          Emoji.all.map(&:aliases)
+        else
+          Gemojione::Index.new.all.map { |i| i[1]["name"] }
+        end.flatten.sort
+      end
+
+      # Default attributes for img tag
+      private def default_img_attrs(name)
+        {
+          "class" => "emoji",
+          "title" => ":#{name}:",
+          "alt" => ":#{name}:",
+          "src" => emoji_url(name).to_s,
+          "height" => "20",
+          "width" => "20",
+          "align" => "absmiddle",
+        }
+      end
+
+      private def emoji_url(name)
+        File.join(asset_root, asset_path(name))
+      end
+
+      private def emoji_filename(name)
+        if self.class.gemoji_loaded?
+          Emoji.find_by_alias(name).image_filename
+        else
+          # replace their asset_host with ours
+          Gemojione.image_url_for_name(name).sub(Gemojione.asset_host, "")
+        end
+      end
+
+      # Return ancestor tags to stop the emojification.
+      #
+      # @return [Array<String>] Ancestor tags.
+      private def ignored_ancestor_tags
+        if context[:ignored_ancestor_tags]
+          DEFAULT_IGNORED_ANCESTOR_TAGS | context[:ignored_ancestor_tags]
+        else
+          DEFAULT_IGNORED_ANCESTOR_TAGS
+        end
+      end
+    end
+  end
+end
diff --git a/lib/html_pipeline/node_filter/https_filter.rb b/lib/html_pipeline/node_filter/https_filter.rb
new file mode 100644
index 00000000..1f11c770
--- /dev/null
+++ b/lib/html_pipeline/node_filter/https_filter.rb
@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+class HTMLPipeline
+  class NodeFilter
+    # HTML Filter for replacing http references to :http_url with https versions.
+    # Subdomain references are not rewritten.
+    #
+    # Context options:
+    #   :http_url - The HTTP url to force HTTPS. Falls back to :base_url
+    class HttpsFilter < NodeFilter
+      def call
+        doc.css(%(a[href^="#{http_url}"])).each do |element|
+          element["href"] = element["href"].sub(/^http:/, "https:")
+        end
+        doc
+      end
+
+      # HTTP url to replace. Falls back to :base_url
+      def http_url
+        context[:http_url] || context[:base_url]
+      end
+
+      # Raise error if :http_url undefined
+      def validate
+        needs(:http_url) unless http_url
+      end
+    end
+  end
+end
diff --git a/lib/html_pipeline/node_filter/image_max_width_filter.rb b/lib/html_pipeline/node_filter/image_max_width_filter.rb
new file mode 100644
index 00000000..659dcf9e
--- /dev/null
+++ b/lib/html_pipeline/node_filter/image_max_width_filter.rb
@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+class HTMLPipeline
+  class NodeFilter
+    # This filter rewrites image tags with a max-width inline style and also wraps
+    # the image in an <a> tag that causes the full size image to be opened in a
+    # new tab.
+    #
+    # The max-width inline styles are especially useful in HTML email which
+    # don't use a global stylesheets.
+    class ImageMaxWidthFilter < NodeFilter
+      def call
+        doc.search("img").each do |element|
+          # Skip if there's already a style attribute. Not sure how this
+          # would happen but we can reconsider it in the future.
+          next if element["style"]
+
+          # Bail out if src doesn't look like a valid http url. trying to avoid weird
+          # js injection via javascript: urls.
+          next if /\Ajavascript/i.match?(element["src"].to_s.strip)
+
+          element["style"] = "max-width:100%;"
+
+          link_image(element) unless has_ancestor?(element, ["a"])
+        end
+
+        doc
+      end
+
+      def link_image(element)
+        link = doc.document.create_element("a", href: element["src"], target: "_blank")
+        link.add_child(element.dup)
+        element.replace(link)
+      end
+    end
+  end
+end
diff --git a/lib/html_pipeline/node_filter/mention_filter.rb b/lib/html_pipeline/node_filter/mention_filter.rb
new file mode 100644
index 00000000..ee935d1c
--- /dev/null
+++ b/lib/html_pipeline/node_filter/mention_filter.rb
@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require "set"
+
+class HTMLPipeline
+  class NodeFilter
+    # HTML filter that replaces @user mentions with links. Mentions within <pre>,
+    # <code>, and <a> elements are ignored. Mentions that reference users that do
+    # not exist are ignored.
+    #
+    # Context options:
+    #   :base_url - Used to construct links to user profile pages for each
+    #               mention.
+    #   :info_url - Used to link to "more info" when someone mentions @mention
+    #               or @mentioned.
+    #   :username_pattern - Used to provide a custom regular expression to
+    #                       identify usernames
+    #
+    class MentionFilter < NodeFilter
+      # Public: Find user @mentions in text.  See
+      # MentionFilter#mention_link_filter.
+      #
+      #   MentionFilter.mentioned_logins_in(text) do |match, login, is_mentioned|
+      #     "<a href=...>#{login}</a>"
+      #   end
+      #
+      # text - String text to search.
+      #
+      # Yields the String match, the String login name, and a Boolean determining
+      # if the match = "@mention[ed]".  The yield's return replaces the match in
+      # the original text.
+      #
+      # Returns a String replaced with the return of the block.
+      def self.mentioned_logins_in(text, username_pattern = USERNAME_PATTERN)
+        text.gsub(MENTION_PATTERNS[username_pattern]) do |match|
+          login = Regexp.last_match(1)
+          yield match, login
+        end
+      end
+
+      # Hash that contains all of the mention patterns used by the pipeline
+      MENTION_PATTERNS = Hash.new do |hash, key|
+        hash[key] = %r{
+          (?:^|\W)                    # beginning of string or non-word char
+          @((?>#{key}))  # @username
+          (?!/)                      # without a trailing slash
+          (?=
+            \.+[ \t\W]|               # dots followed by space or non-word character
+            \.+$|                     # dots at end of line
+            [^0-9a-zA-Z_.]|           # non-word character except dot
+            $                         # end of line
+          )
+        }ix
+      end
+
+      # Default pattern used to extract usernames from text. The value can be
+      # overriden by providing the username_pattern variable in the context.
+      USERNAME_PATTERN = /[a-z0-9][a-z0-9-]*/.freeze
+
+      # Don't look for mentions in text nodes that are children of these elements
+      IGNORE_PARENTS = ["pre", "code", "a", "style", "script"].to_set
+
+      def call
+        result[:mentioned_usernames] ||= []
+
+        doc.search(".//text()").each do |node|
+          content = node.to_html
+          next unless content.include?("@")
+          next if has_ancestor?(node, IGNORE_PARENTS)
+
+          html = mention_link_filter(content, base_url: base_url, username_pattern: username_pattern)
+          next if html == content
+
+          node.replace(html)
+        end
+        doc
+      end
+
+      # The URL to provide when someone @mentions a "mention" name, such
+      # as @mention or @mentioned, that will give them more info on mentions.
+      def info_url
+        context[:info_url] || nil
+      end
+
+      def username_pattern
+        context[:username_pattern] || USERNAME_PATTERN
+      end
+
+      # Replace user @mentions in text with links to the mentioned user's
+      # profile page.
+      #
+      # text      - String text to replace @mention usernames in.
+      # base_url  - The base URL used to construct user profile URLs.
+      # info_url  - The "more info" URL used to link to more info on @mentions.
+      #             If nil we don't link @mention or @mentioned.
+      # username_pattern  - Regular expression used to identify usernames in
+      #                     text
+      #
+      # Returns a string with @mentions replaced with links. All links have a
+      # 'user-mention' class name attached for styling.
+      def mention_link_filter(text, base_url: "/", username_pattern: USERNAME_PATTERN)
+        self.class.mentioned_logins_in(text, username_pattern) do |match, login|
+          link = link_to_mentioned_user(base_url, login)
+
+          link ? match.sub("@#{login}", link) : match
+        end
+      end
+
+      def link_to_mentioned_user(base_url, login)
+        result[:mentioned_usernames] |= [login]
+
+        url = base_url.dup
+        url << "/" unless %r{[/~]\z}.match?(url)
+
+        "<a href='#{url << login}' class='user-mention'>" \
+          "@#{login}" \
+          "</a>"
+      end
+    end
+  end
+end
diff --git a/lib/html_pipeline/node_filter/sanitization_filter.rb b/lib/html_pipeline/node_filter/sanitization_filter.rb
new file mode 100644
index 00000000..cf60b131
--- /dev/null
+++ b/lib/html_pipeline/node_filter/sanitization_filter.rb
@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+HTMLPipeline.require_dependency("sanitize", "SanitizationFilter")
+
+class HTMLPipeline
+  class NodeFilter
+    # HTML filter with sanization routines and allowlists. This module defines
+    # what HTML is allowed in user provided content and fixes up issues with
+    # unbalanced tags and whatnot.
+    #
+    # See the Sanitize docs for more information on the underlying library:
+    #
+    # https://github.com/rgrove/sanitize/#readme
+    #
+    # Context options:
+    #   :allowlist      - The sanitizer allowlist configuration to use. This
+    #                     can be one of the options constants defined in this
+    #                     class or a custom sanitize options hash.
+    #   :anchor_schemes - The URL schemes to allow in <a href> attributes. The
+    #                     default set is provided in the ANCHOR_SCHEMES
+    #                     constant in this class. If passed, this overrides any
+    #                     schemes specified in the allowlist configuration.
+    #
+    # This filter does not write additional information to the context.
+    class SanitizationFilter < NodeFilter
+      LISTS     = Set.new(["ul", "ol"].freeze)
+      LIST_ITEM = "li"
+
+      # List of table child elements. These must be contained by a <table> element
+      # or they are not allowed through. Otherwise they can be used to break out
+      # of places we're using tables to contain formatted user content (like pull
+      # request review comments).
+      TABLE_ITEMS = Set.new(["tr", "td", "th"].freeze)
+      TABLE = "table"
+      TABLE_SECTIONS = Set.new(["thead", "tbody", "tfoot"].freeze)
+
+      # These schemes are the only ones allowed in <a href> attributes by default.
+      ANCHOR_SCHEMES = ["http", "https", "mailto", "xmpp", :relative, "github-windows", "github-mac", "irc", "ircs"].freeze
+
+      # The main sanitization allowlist. Only these elements and attributes are
+      # allowed through by default.
+      ALLOWLIST = {
+        elements: ["h1", "h2", "h3", "h4", "h5", "h6", "h7", "h8", "br", "b", "i", "strong", "em", "a", "pre", "code", "img", "tt", "div", "ins", "del", "sup", "sub", "p", "ol", "ul", "table", "thead", "tbody", "tfoot", "blockquote", "dl", "dt", "dd", "kbd", "q", "samp", "var", "hr", "ruby", "rt", "rp", "li", "tr", "td", "th", "s", "strike", "summary", "details", "caption", "figure", "figcaption", "abbr", "bdo", "cite", "dfn", "mark", "small", "span", "time", "wbr"].freeze,
+        remove_contents: ["script"].freeze,
+        attributes: {
+          "a" => ["href"].freeze,
+          "img" => ["src", "longdesc"].freeze,
+          "div" => ["itemscope", "itemtype"].freeze,
+          "blockquote" => ["cite"].freeze,
+          "del" => ["cite"].freeze,
+          "ins" => ["cite"].freeze,
+          "q" => ["cite"].freeze,
+          all: ["abbr", "accept", "accept-charset", "accesskey", "action", "align", "alt", "aria-describedby", "aria-hidden", "aria-label", "aria-labelledby", "axis", "border", "cellpadding", "cellspacing", "char", "charoff", "charset", "checked", "clear", "cols", "colspan", "color", "compact", "coords", "datetime", "dir", "disabled", "enctype", "for", "frame", "headers", "height", "hreflang", "hspace", "ismap", "label", "lang", "maxlength", "media", "method", "multiple", "name", "nohref", "noshade", "nowrap", "open", "progress", "prompt", "readonly", "rel", "rev", "role", "rows", "rowspan", "rules", "scope", "selected", "shape", "size", "span", "start", "summary", "tabindex", "target", "title", "type", "usemap", "valign", "value", "vspace", "width", "itemprop"].freeze,
+        }.freeze,
+        protocols: {
+          "a" => { "href" => ANCHOR_SCHEMES }.freeze,
+          "blockquote" => { "cite" => ["http", "https", :relative].freeze },
+          "del" => { "cite" => ["http", "https", :relative].freeze },
+          "ins" => { "cite" => ["http", "https", :relative].freeze },
+          "q" => { "cite" => ["http", "https", :relative].freeze },
+          "img" => {
+            "src" => ["http", "https", :relative].freeze,
+            "longdesc" => ["http", "https", :relative].freeze,
+          }.freeze,
+        },
+        transformers: [
+          # Top-level <li> elements are removed because they can break out of
+          # containing markup.
+          lambda { |env|
+            name = env[:node_name]
+            node = env[:node]
+            node.replace(node.children) if name == LIST_ITEM && node.ancestors.none? { |n| LISTS.include?(n.name) }
+          },
+
+          # Table child elements that are not contained by a <table> are removed.
+          lambda { |env|
+            name = env[:node_name]
+            node = env[:node]
+            node.replace(node.children) if (TABLE_SECTIONS.include?(name) || TABLE_ITEMS.include?(name)) && node.ancestors.none? { |n| n.name == TABLE }
+          },
+        ].freeze,
+      }.freeze
+
+      # A more limited sanitization allowlist. This includes all attributes,
+      # protocols, and transformers from ALLOWLIST but with a more locked down
+      # set of allowed elements.
+      LIMITED = ALLOWLIST.merge(
+        elements: ["b", "i", "strong", "em", "a", "pre", "code", "img", "ins", "del", "sup", "sub", "mark", "abbr", "p", "ol", "ul", "li"]
+      )
+
+      # Strip all HTML tags from the document.
+      FULL = { elements: [] }.freeze
+
+      # Sanitize markup using the Sanitize library.
+      def call
+        Sanitize.clean_node!(doc, allowlist)
+      end
+
+      # The allowlist to use when sanitizing. This can be passed in the context
+      # hash to the filter but defaults to ALLOWLIST constant value above.
+      def allowlist
+        allowlist = context[:allowlist] || ALLOWLIST
+        anchor_schemes = context[:anchor_schemes]
+        return allowlist unless anchor_schemes
+
+        allowlist = allowlist.dup
+        allowlist[:protocols] = (allowlist[:protocols] || {}).dup
+        allowlist[:protocols]["a"] = (allowlist[:protocols]["a"] || {}).merge("href" => anchor_schemes)
+        allowlist
+      end
+    end
+  end
+end
diff --git a/lib/html_pipeline/node_filter/syntax_highlight_filter.rb b/lib/html_pipeline/node_filter/syntax_highlight_filter.rb
new file mode 100644
index 00000000..bdc51810
--- /dev/null
+++ b/lib/html_pipeline/node_filter/syntax_highlight_filter.rb
@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+HTMLPipeline.require_dependency("rouge", "SyntaxHighlightFilter")
+
+class HTMLPipeline
+  class NodeFilter
+    # HTML Filter that syntax highlights text inside code blocks.
+    #
+    # Context options:
+    #
+    #   :highlight => String represents the language to pick lexer. Defaults to empty string.
+    #   :scope => String represents the class attribute adds to pre element after.
+    #             Defaults to "highlight highlight-css" if highlights a css code block.
+    #
+    # This filter does not write any additional information to the context hash.
+    class SyntaxHighlightFilter < NodeFilter
+      def initialize(doc, context: {}, result: {})
+        super(doc, context: context, result: result)
+        @formatter = Rouge::Formatters::HTML.new
+      end
+
+      def call
+        doc.search("pre").each do |node|
+          default = context[:highlight]&.to_s
+          next unless (lang = node["lang"] || default)
+          next unless (lexer = lexer_for(lang))
+
+          text = node.inner_text
+          html = highlight_with_timeout_handling(text, lexer)
+          next if html.nil?
+
+          node.inner_html = html
+          scope = context.fetch(:scope, "highlight")
+          node["class"] = "#{scope} #{scope}-#{lang}"
+        end
+        doc
+      end
+
+      def highlight_with_timeout_handling(text, lexer)
+        Rouge.highlight(text, lexer, @formatter)
+      rescue Timeout::Error => _e
+        nil
+      end
+
+      def lexer_for(lang)
+        Rouge::Lexer.find(lang)
+      end
+    end
+  end
+end
diff --git a/lib/html_pipeline/node_filter/table_of_contents_filter.rb b/lib/html_pipeline/node_filter/table_of_contents_filter.rb
new file mode 100644
index 00000000..bd0fd2cc
--- /dev/null
+++ b/lib/html_pipeline/node_filter/table_of_contents_filter.rb
@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+HTMLPipeline.require_dependency("escape_utils", "TableOfContentsFilter")
+
+class HTMLPipeline
+  class NodeFilter
+    # HTML filter that adds an 'id' attribute to all headers
+    # in a document, so they can be accessed from a table of contents.
+    #
+    # Generates the Table of Contents, with links to each header.
+    #
+    # Examples
+    #
+    #  TocPipeline =
+    #    HTMLPipeline.new [
+    #      HTMLPipeline::TableOfContentsFilter
+    #    ]
+    #  # => #<HTMLPipeline:0x007fc13c4528d8...>
+    #  orig = %(<h1>Ice cube</h1><p>is not for the pop chart</p>)
+    #  # => "<h1>Ice cube</h1><p>is not for the pop chart</p>"
+    #  result = {}
+    #  # => {}
+    #  TocPipeline.call(orig, {}, result)
+    #  # => {:toc=> ...}
+    #  result[:toc]
+    #  # => "<ul class=\"section-nav\">\n<li><a href=\"#ice-cube\">...</li><ul>"
+    #  result[:output].to_s
+    #  # => "<h1>\n<a id=\"ice-cube\" class=\"anchor\" href=\"#ice-cube\">..."
+    class TableOfContentsFilter < NodeFilter
+      PUNCTUATION_REGEXP = /[^\p{Word}\- ]/u
+
+      # The icon that will be placed next to an anchored rendered markdown header
+      def anchor_icon
+        context[:anchor_icon] || '<span aria-hidden="true" class="octicon octicon-link"></span>'
+      end
+
+      def call
+        result[:toc] = +""
+
+        headers = Hash.new(0)
+        doc.css("h1, h2, h3, h4, h5, h6").each do |node|
+          text = node.text
+          id = ascii_downcase(text)
+          id.gsub!(PUNCTUATION_REGEXP, "") # remove punctuation
+          id.tr!(" ", "-") # replace spaces with dash
+
+          uniq = (headers[id]).positive? ? "-#{headers[id]}" : ""
+          headers[id] += 1
+          if (header_content = node.children.first)
+            result[:toc] << %(<li><a href="##{id}#{uniq}">#{EscapeUtils.escape_html(text)}</a></li>\n)
+            header_content.add_previous_sibling(%(<a id="#{id}#{uniq}" class="anchor" href="##{id}#{uniq}" aria-hidden="true">#{anchor_icon}</a>))
+          end
+        end
+        result[:toc] = %(<ul class="section-nav">\n#{result[:toc]}</ul>) unless result[:toc].empty?
+        doc
+      end
+
+      if RUBY_VERSION >= "2.4"
+        def ascii_downcase(str)
+          str.downcase(:ascii)
+        end
+      else
+        def ascii_downcase(str)
+          str.downcase
+        end
+      end
+    end
+  end
+end
diff --git a/lib/html_pipeline/node_filter/team_mention_filter.rb b/lib/html_pipeline/node_filter/team_mention_filter.rb
new file mode 100644
index 00000000..1f3e1d06
--- /dev/null
+++ b/lib/html_pipeline/node_filter/team_mention_filter.rb
@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require "set"
+
+class HTMLPipeline
+  class NodeFilter
+    # HTML filter that replaces @org/team mentions with links. Mentions within
+    # <pre>, <code>, <a>, <style>, and <script> elements are ignored.
+    #
+    # Context options:
+    #   :base_url - Used to construct links to team profile pages for each
+    #               mention.
+    #   :team_pattern - Used to provide a custom regular expression to
+    #                       identify team names
+    #
+    class TeamMentionFilter < NodeFilter
+      # Public: Find @org/team mentions in text.  See
+      # TeamMentionFilter#team_mention_link_filter.
+      #
+      #   TeamMentionFilter.mentioned_teams_in(text) do |match, org, team|
+      #     "<a href=...>#{team}</a>"
+      #   end
+      #
+      # text - String text to search.
+      #
+      # Yields the String match, org name, and team name.  The yield's
+      # return replaces the match in the original text.
+      #
+      # Returns a String replaced with the return of the block.
+      def self.mentioned_teams_in(text, team_pattern = TEAM_PATTERN)
+        text.gsub(team_pattern) do |match|
+          org = Regexp.last_match(1)
+          team = Regexp.last_match(2)
+          yield match, org, team
+        end
+      end
+
+      # Default pattern used to extract team names from text. The value can be
+      # overridden by providing the team_pattern variable in the context. To
+      # properly link the mention, should be in the format of /@(1)\/(2)/.
+      TEAM_PATTERN = %r{
+        (?<=^|\W)                  # beginning of string or non-word char
+        @([a-z0-9][a-z0-9-]*)      # @organization
+          /                       # dividing slash
+          ([a-z0-9][a-z0-9\-_]*)   # team
+          \b
+      }ix.freeze
+
+      # Don't look for mentions in text nodes that are children of these elements
+      IGNORE_PARENTS = ["pre", "code", "a", "style", "script"].to_set
+
+      def call
+        result[:mentioned_teams] ||= []
+
+        doc.search(".//text()").each do |node|
+          content = node.to_html
+          next unless content.include?("@")
+          next if has_ancestor?(node, IGNORE_PARENTS)
+
+          html = mention_link_filter(content, base_url: base_url, team_pattern: team_pattern)
+          next if html == content
+
+          node.replace(html)
+        end
+        doc
+      end
+
+      def team_pattern
+        context[:team_pattern] || TEAM_PATTERN
+      end
+
+      # Replace @org/team mentions in text with links to the mentioned team's
+      # page.
+      #
+      # text      - String text to replace @mention team names in.
+      # base_url  - The base URL used to construct team page URLs.
+      # team_pattern  - Regular expression used to identify teams in text
+      #
+      # Returns a string with @team mentions replaced with links. All links have a
+      # 'team-mention' class name attached for styling.
+      def mention_link_filter(text, base_url: "/", team_pattern: TEAM_PATTERN)
+        self.class.mentioned_teams_in(text, team_pattern) do |match, org, team|
+          link = link_to_mentioned_team(base_url, org, team)
+
+          link ? match.sub("@#{org}/#{team}", link) : match
+        end
+      end
+
+      def link_to_mentioned_team(base_url, org, team)
+        result[:mentioned_teams] |= [team]
+
+        url = base_url.dup
+        url << "/" unless %r{[/~]\z}.match?(url)
+
+        "<a href='#{url << org}/#{team}' class='team-mention'>" \
+          "@#{org}/#{team}" \
+          "</a>"
+      end
+    end
+  end
+end
diff --git a/lib/html_pipeline/plain_text_input_filter.rb b/lib/html_pipeline/plain_text_input_filter.rb
deleted file mode 100644
index 53d7b3ca..00000000
--- a/lib/html_pipeline/plain_text_input_filter.rb
+++ /dev/null
@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-HTMLPipeline.require_dependency("escape_utils", "PlainTextInputFilter")
-
-class HTMLPipeline
-  # Simple filter for plain text input. HTML escapes the text input and wraps it
-  # in a div.
-  class PlainTextInputFilter < TextFilter
-    def call
-      "<div>#{EscapeUtils.escape_html(@text, false)}</div>"
-    end
-  end
-end
diff --git a/lib/html_pipeline/sanitization_filter.rb b/lib/html_pipeline/sanitization_filter.rb
deleted file mode 100644
index a8605b8a..00000000
--- a/lib/html_pipeline/sanitization_filter.rb
+++ /dev/null
@@ -1,111 +0,0 @@
-# frozen_string_literal: true
-
-HTMLPipeline.require_dependency("sanitize", "SanitizationFilter")
-
-class HTMLPipeline
-  # HTML filter with sanization routines and allowlists. This module defines
-  # what HTML is allowed in user provided content and fixes up issues with
-  # unbalanced tags and whatnot.
-  #
-  # See the Sanitize docs for more information on the underlying library:
-  #
-  # https://github.com/rgrove/sanitize/#readme
-  #
-  # Context options:
-  #   :allowlist      - The sanitizer allowlist configuration to use. This
-  #                     can be one of the options constants defined in this
-  #                     class or a custom sanitize options hash.
-  #   :anchor_schemes - The URL schemes to allow in <a href> attributes. The
-  #                     default set is provided in the ANCHOR_SCHEMES
-  #                     constant in this class. If passed, this overrides any
-  #                     schemes specified in the allowlist configuration.
-  #
-  # This filter does not write additional information to the context.
-  class SanitizationFilter < Filter
-    LISTS     = Set.new(["ul", "ol"].freeze)
-    LIST_ITEM = "li"
-
-    # List of table child elements. These must be contained by a <table> element
-    # or they are not allowed through. Otherwise they can be used to break out
-    # of places we're using tables to contain formatted user content (like pull
-    # request review comments).
-    TABLE_ITEMS = Set.new(["tr", "td", "th"].freeze)
-    TABLE = "table"
-    TABLE_SECTIONS = Set.new(["thead", "tbody", "tfoot"].freeze)
-
-    # These schemes are the only ones allowed in <a href> attributes by default.
-    ANCHOR_SCHEMES = ["http", "https", "mailto", "xmpp", :relative, "github-windows", "github-mac", "irc", "ircs"].freeze
-
-    # The main sanitization allowlist. Only these elements and attributes are
-    # allowed through by default.
-    ALLOWLIST = {
-      elements: ["h1", "h2", "h3", "h4", "h5", "h6", "h7", "h8", "br", "b", "i", "strong", "em", "a", "pre", "code", "img", "tt", "div", "ins", "del", "sup", "sub", "p", "ol", "ul", "table", "thead", "tbody", "tfoot", "blockquote", "dl", "dt", "dd", "kbd", "q", "samp", "var", "hr", "ruby", "rt", "rp", "li", "tr", "td", "th", "s", "strike", "summary", "details", "caption", "figure", "figcaption", "abbr", "bdo", "cite", "dfn", "mark", "small", "span", "time", "wbr"].freeze,
-      remove_contents: ["script"].freeze,
-      attributes: {
-        "a" => ["href"].freeze,
-        "img" => ["src", "longdesc"].freeze,
-        "div" => ["itemscope", "itemtype"].freeze,
-        "blockquote" => ["cite"].freeze,
-        "del" => ["cite"].freeze,
-        "ins" => ["cite"].freeze,
-        "q" => ["cite"].freeze,
-        all: ["abbr", "accept", "accept-charset", "accesskey", "action", "align", "alt", "aria-describedby", "aria-hidden", "aria-label", "aria-labelledby", "axis", "border", "cellpadding", "cellspacing", "char", "charoff", "charset", "checked", "clear", "cols", "colspan", "color", "compact", "coords", "datetime", "dir", "disabled", "enctype", "for", "frame", "headers", "height", "hreflang", "hspace", "ismap", "label", "lang", "maxlength", "media", "method", "multiple", "name", "nohref", "noshade", "nowrap", "open", "progress", "prompt", "readonly", "rel", "rev", "role", "rows", "rowspan", "rules", "scope", "selected", "shape", "size", "span", "start", "summary", "tabindex", "target", "title", "type", "usemap", "valign", "value", "vspace", "width", "itemprop"].freeze,
-      }.freeze,
-      protocols: {
-        "a" => { "href" => ANCHOR_SCHEMES }.freeze,
-        "blockquote" => { "cite" => ["http", "https", :relative].freeze },
-        "del" => { "cite" => ["http", "https", :relative].freeze },
-        "ins" => { "cite" => ["http", "https", :relative].freeze },
-        "q" => { "cite" => ["http", "https", :relative].freeze },
-        "img" => {
-          "src" => ["http", "https", :relative].freeze,
-          "longdesc" => ["http", "https", :relative].freeze,
-        }.freeze,
-      },
-      transformers: [
-        # Top-level <li> elements are removed because they can break out of
-        # containing markup.
-        lambda { |env|
-          name = env[:node_name]
-          node = env[:node]
-          node.replace(node.children) if name == LIST_ITEM && node.ancestors.none? { |n| LISTS.include?(n.name) }
-        },
-
-        # Table child elements that are not contained by a <table> are removed.
-        lambda { |env|
-          name = env[:node_name]
-          node = env[:node]
-          node.replace(node.children) if (TABLE_SECTIONS.include?(name) || TABLE_ITEMS.include?(name)) && node.ancestors.none? { |n| n.name == TABLE }
-        },
-      ].freeze,
-    }.freeze
-
-    # A more limited sanitization allowlist. This includes all attributes,
-    # protocols, and transformers from ALLOWLIST but with a more locked down
-    # set of allowed elements.
-    LIMITED = ALLOWLIST.merge(
-      elements: ["b", "i", "strong", "em", "a", "pre", "code", "img", "ins", "del", "sup", "sub", "mark", "abbr", "p", "ol", "ul", "li"]
-    )
-
-    # Strip all HTML tags from the document.
-    FULL = { elements: [] }.freeze
-
-    # Sanitize markup using the Sanitize library.
-    def call
-      Sanitize.clean_node!(doc, allowlist)
-    end
-
-    # The allowlist to use when sanitizing. This can be passed in the context
-    # hash to the filter but defaults to ALLOWLIST constant value above.
-    def allowlist
-      allowlist = context[:allowlist] || ALLOWLIST
-      anchor_schemes = context[:anchor_schemes]
-      return allowlist unless anchor_schemes
-
-      allowlist = allowlist.dup
-      allowlist[:protocols] = (allowlist[:protocols] || {}).dup
-      allowlist[:protocols]["a"] = (allowlist[:protocols]["a"] || {}).merge("href" => anchor_schemes)
-      allowlist
-    end
-  end
-end
diff --git a/lib/html_pipeline/syntax_highlight_filter.rb b/lib/html_pipeline/syntax_highlight_filter.rb
deleted file mode 100644
index 03b28ad3..00000000
--- a/lib/html_pipeline/syntax_highlight_filter.rb
+++ /dev/null
@@ -1,48 +0,0 @@
-# frozen_string_literal: true
-
-HTMLPipeline.require_dependency("rouge", "SyntaxHighlightFilter")
-
-class HTMLPipeline
-  # HTML Filter that syntax highlights text inside code blocks.
-  #
-  # Context options:
-  #
-  #   :highlight => String represents the language to pick lexer. Defaults to empty string.
-  #   :scope => String represents the class attribute adds to pre element after.
-  #             Defaults to "highlight highlight-css" if highlights a css code block.
-  #
-  # This filter does not write any additional information to the context hash.
-  class SyntaxHighlightFilter < Filter
-    def initialize(doc, context: {}, result: {})
-      super(doc, context: context, result: result)
-      @formatter = Rouge::Formatters::HTML.new
-    end
-
-    def call
-      doc.search("pre").each do |node|
-        default = context[:highlight]&.to_s
-        next unless (lang = node["lang"] || default)
-        next unless (lexer = lexer_for(lang))
-
-        text = node.inner_text
-        html = highlight_with_timeout_handling(text, lexer)
-        next if html.nil?
-
-        node.inner_html = html
-        scope = context.fetch(:scope, "highlight")
-        node["class"] = "#{scope} #{scope}-#{lang}"
-      end
-      doc
-    end
-
-    def highlight_with_timeout_handling(text, lexer)
-      Rouge.highlight(text, lexer, @formatter)
-    rescue Timeout::Error => _e
-      nil
-    end
-
-    def lexer_for(lang)
-      Rouge::Lexer.find(lang)
-    end
-  end
-end
diff --git a/lib/html_pipeline/table_of_contents_filter.rb b/lib/html_pipeline/table_of_contents_filter.rb
deleted file mode 100644
index 75f75318..00000000
--- a/lib/html_pipeline/table_of_contents_filter.rb
+++ /dev/null
@@ -1,67 +0,0 @@
-# frozen_string_literal: true
-
-HTMLPipeline.require_dependency("escape_utils", "TableOfContentsFilter")
-
-class HTMLPipeline
-  # HTML filter that adds an 'id' attribute to all headers
-  # in a document, so they can be accessed from a table of contents.
-  #
-  # Generates the Table of Contents, with links to each header.
-  #
-  # Examples
-  #
-  #  TocPipeline =
-  #    HTMLPipeline.new [
-  #      HTMLPipeline::TableOfContentsFilter
-  #    ]
-  #  # => #<HTMLPipeline:0x007fc13c4528d8...>
-  #  orig = %(<h1>Ice cube</h1><p>is not for the pop chart</p>)
-  #  # => "<h1>Ice cube</h1><p>is not for the pop chart</p>"
-  #  result = {}
-  #  # => {}
-  #  TocPipeline.call(orig, {}, result)
-  #  # => {:toc=> ...}
-  #  result[:toc]
-  #  # => "<ul class=\"section-nav\">\n<li><a href=\"#ice-cube\">...</li><ul>"
-  #  result[:output].to_s
-  #  # => "<h1>\n<a id=\"ice-cube\" class=\"anchor\" href=\"#ice-cube\">..."
-  class TableOfContentsFilter < Filter
-    PUNCTUATION_REGEXP = RUBY_VERSION > "1.9" ? /[^\p{Word}\- ]/u : /[^\w\- ]/
-
-    # The icon that will be placed next to an anchored rendered markdown header
-    def anchor_icon
-      context[:anchor_icon] || '<span aria-hidden="true" class="octicon octicon-link"></span>'
-    end
-
-    def call
-      result[:toc] = +""
-
-      headers = Hash.new(0)
-      doc.css("h1, h2, h3, h4, h5, h6").each do |node|
-        text = node.text
-        id = ascii_downcase(text)
-        id.gsub!(PUNCTUATION_REGEXP, "") # remove punctuation
-        id.tr!(" ", "-") # replace spaces with dash
-
-        uniq = (headers[id]).positive? ? "-#{headers[id]}" : ""
-        headers[id] += 1
-        if (header_content = node.children.first)
-          result[:toc] << %(<li><a href="##{id}#{uniq}">#{EscapeUtils.escape_html(text)}</a></li>\n)
-          header_content.add_previous_sibling(%(<a id="#{id}#{uniq}" class="anchor" href="##{id}#{uniq}" aria-hidden="true">#{anchor_icon}</a>))
-        end
-      end
-      result[:toc] = %(<ul class="section-nav">\n#{result[:toc]}</ul>) unless result[:toc].empty?
-      doc
-    end
-
-    if RUBY_VERSION >= "2.4"
-      def ascii_downcase(str)
-        str.downcase(:ascii)
-      end
-    else
-      def ascii_downcase(str)
-        str.downcase
-      end
-    end
-  end
-end
diff --git a/lib/html_pipeline/team_mention_filter.rb b/lib/html_pipeline/team_mention_filter.rb
deleted file mode 100644
index e387c3a8..00000000
--- a/lib/html_pipeline/team_mention_filter.rb
+++ /dev/null
@@ -1,99 +0,0 @@
-# frozen_string_literal: true
-
-require "set"
-
-class HTMLPipeline
-  # HTML filter that replaces @org/team mentions with links. Mentions within
-  # <pre>, <code>, <a>, <style>, and <script> elements are ignored.
-  #
-  # Context options:
-  #   :base_url - Used to construct links to team profile pages for each
-  #               mention.
-  #   :team_pattern - Used to provide a custom regular expression to
-  #                       identify team names
-  #
-  class TeamMentionFilter < Filter
-    # Public: Find @org/team mentions in text.  See
-    # TeamMentionFilter#team_mention_link_filter.
-    #
-    #   TeamMentionFilter.mentioned_teams_in(text) do |match, org, team|
-    #     "<a href=...>#{team}</a>"
-    #   end
-    #
-    # text - String text to search.
-    #
-    # Yields the String match, org name, and team name.  The yield's
-    # return replaces the match in the original text.
-    #
-    # Returns a String replaced with the return of the block.
-    def self.mentioned_teams_in(text, team_pattern = TEAM_PATTERN)
-      text.gsub(team_pattern) do |match|
-        org = Regexp.last_match(1)
-        team = Regexp.last_match(2)
-        yield match, org, team
-      end
-    end
-
-    # Default pattern used to extract team names from text. The value can be
-    # overridden by providing the team_pattern variable in the context. To
-    # properly link the mention, should be in the format of /@(1)\/(2)/.
-    TEAM_PATTERN = %r{
-      (?<=^|\W)                  # beginning of string or non-word char
-      @([a-z0-9][a-z0-9-]*)      # @organization
-        /                       # dividing slash
-        ([a-z0-9][a-z0-9\-_]*)   # team
-        \b
-    }ix.freeze
-
-    # Don't look for mentions in text nodes that are children of these elements
-    IGNORE_PARENTS = ["pre", "code", "a", "style", "script"].to_set
-
-    def call
-      result[:mentioned_teams] ||= []
-
-      doc.search(".//text()").each do |node|
-        content = node.to_html
-        next unless content.include?("@")
-        next if has_ancestor?(node, IGNORE_PARENTS)
-
-        html = mention_link_filter(content, base_url: base_url, team_pattern: team_pattern)
-        next if html == content
-
-        node.replace(html)
-      end
-      doc
-    end
-
-    def team_pattern
-      context[:team_pattern] || TEAM_PATTERN
-    end
-
-    # Replace @org/team mentions in text with links to the mentioned team's
-    # page.
-    #
-    # text      - String text to replace @mention team names in.
-    # base_url  - The base URL used to construct team page URLs.
-    # team_pattern  - Regular expression used to identify teams in text
-    #
-    # Returns a string with @team mentions replaced with links. All links have a
-    # 'team-mention' class name attached for styling.
-    def mention_link_filter(text, base_url: "/", team_pattern: TEAM_PATTERN)
-      self.class.mentioned_teams_in(text, team_pattern) do |match, org, team|
-        link = link_to_mentioned_team(base_url, org, team)
-
-        link ? match.sub("@#{org}/#{team}", link) : match
-      end
-    end
-
-    def link_to_mentioned_team(base_url, org, team)
-      result[:mentioned_teams] |= [team]
-
-      url = base_url.dup
-      url << "/" unless %r{[/~]\z}.match?(url)
-
-      "<a href='#{url << org}/#{team}' class='team-mention'>" \
-        "@#{org}/#{team}" \
-        "</a>"
-    end
-  end
-end
diff --git a/lib/html_pipeline/text_filter.rb b/lib/html_pipeline/text_filter.rb
index a01ec874..d12efebd 100644
--- a/lib/html_pipeline/text_filter.rb
+++ b/lib/html_pipeline/text_filter.rb
@@ -9,7 +9,17 @@ def initialize(text, context: {}, result: {})
 
       # Ensure that this is always a string
       @text = text.respond_to?(:to_str) ? text.to_str : text.to_s
-      super(nil, context: context, result: result)
+      super(context: context, result: result)
+    end
+
+    # Like call but guarantees that a string of HTML markup is returned.
+    def self.process(input, context: {})
+      output = call(input, context: context)
+      if output.respond_to?(:to_html)
+        output.to_html
+      else
+        output.to_s
+      end
     end
   end
 end
diff --git a/lib/html_pipeline/text_filter/autolink_filter.rb b/lib/html_pipeline/text_filter/autolink_filter.rb
new file mode 100644
index 00000000..655ff40b
--- /dev/null
+++ b/lib/html_pipeline/text_filter/autolink_filter.rb
@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+HTMLPipeline.require_dependency("rinku", "AutolinkFilter")
+
+class HTMLPipeline
+  class TextFilter
+    # Text Filter for auto_linking urls in HTML.
+    #
+    # Context options:
+    #   :autolink  - boolean whether to autolink urls
+    #   :link_mode - :all, :urls or :email_addresses
+    #   :link_attr - HTML attributes for the link that will be generated
+    #   :skip_tags - HTML tags inside which autolinking will be skipped.
+    #                See Rinku.skip_tags
+    #   :flags     - additional Rinku flags. See https://github.com/vmg/rinku
+    #
+    # This filter does not write additional information to the context.
+    class AutolinkFilter < TextFilter
+      def call
+        return text if context[:autolink] == false
+
+        skip_tags = context[:skip_tags]
+        flags = 0
+        flags |= context[:flags] if context[:flags]
+
+        Rinku.auto_link(text, link_mode, context[:link_attr], skip_tags, flags)
+      end
+
+      def link_mode
+        context[:link_mode] || :urls
+      end
+    end
+  end
+end
diff --git a/lib/html_pipeline/text_filter/image_filter.rb b/lib/html_pipeline/text_filter/image_filter.rb
new file mode 100644
index 00000000..f3f8e780
--- /dev/null
+++ b/lib/html_pipeline/text_filter/image_filter.rb
@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+class HTMLPipeline
+  class TextFilter
+    # HTML Filter that converts image's url into <img> tag.
+    # For example, it will convert
+    #   http://example.com/test.jpg
+    # into
+    #   <img src="http://example.com/test.jpg" alt=""/>.
+
+    class ImageFilter < TextFilter
+      def call
+        @text.gsub(%r{(https|http)?://.+\.(jpg|jpeg|bmp|gif|png)(\?\S+)?}i) do |match|
+          %(<img src="#{match}" alt=""/>)
+        end
+      end
+    end
+  end
+end
diff --git a/lib/html_pipeline/text_filter/markdown_filter.rb b/lib/html_pipeline/text_filter/markdown_filter.rb
new file mode 100644
index 00000000..85ac9c2b
--- /dev/null
+++ b/lib/html_pipeline/text_filter/markdown_filter.rb
@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+HTMLPipeline.require_dependency("commonmarker", "MarkdownFilter")
+
+class HTMLPipeline
+  class TextFilter
+    # HTML Filter that converts Markdown text into HTML and converts into a
+    # DocumentFragment. This is different from most filters in that it can take a
+    # non-HTML as input. It must be used as the first filter in a pipeline.
+    #
+    # Context options:
+    #   :gfm      => false    Disable GFM line-end processing
+    #   :commonmarker_extensions => [ :table, :strikethrough,
+    #      :tagfilter, :autolink ] Commonmarker extensions to include
+    #
+    # This filter does not write any additional information to the context hash.
+    class MarkdownFilter < TextFilter
+      DEFAULT_COMMONMARKER_EXTENSIONS = [:table, :strikethrough, :tagfilter, :autolink].freeze
+
+      def initialize(text, context: {}, result: {})
+        super(text, context: context, result: result)
+        @text = @text.delete("\r")
+      end
+
+      # Convert Markdown to HTML using the best available implementation
+      # and convert into a DocumentFragment.
+      def call
+        extensions = context.fetch(
+          :commonmarker_extensions,
+          DEFAULT_COMMONMARKER_EXTENSIONS
+        )
+        html = if (renderer = context[:commonmarker_renderer])
+          raise ArgumentError, "`commonmark_renderer` must be derived from `CommonMarker::HtmlRenderer`" unless renderer < CommonMarker::HtmlRenderer
+
+          parse_options = :DEFAULT
+          parse_options = [:UNSAFE] if context[:unsafe]
+
+          render_options = [:GITHUB_PRE_LANG]
+          render_options << :HARDBREAKS if context[:gfm] != false
+          render_options << :UNSAFE if context[:unsafe]
+
+          doc = CommonMarker.render_doc(@text, parse_options, extensions)
+          renderer.new(options: render_options, extensions: extensions).render(doc)
+        else
+          options = [:GITHUB_PRE_LANG]
+          options << :HARDBREAKS if context[:gfm] != false
+          options << :UNSAFE if context[:unsafe]
+          CommonMarker.render_html(@text, options, extensions)
+        end
+        html.rstrip!
+        html
+      end
+    end
+  end
+end
diff --git a/lib/html_pipeline/text_filter/plain_text_input_filter.rb b/lib/html_pipeline/text_filter/plain_text_input_filter.rb
new file mode 100644
index 00000000..6c10cbe2
--- /dev/null
+++ b/lib/html_pipeline/text_filter/plain_text_input_filter.rb
@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+HTMLPipeline.require_dependency("escape_utils", "PlainTextInputFilter")
+
+class HTMLPipeline
+  class TextFilter
+    # Simple filter for plain text input. HTML escapes the text input and wraps it
+    # in a div.
+    class PlainTextInputFilter < TextFilter
+      def call
+        "<div>#{EscapeUtils.escape_html(@text, false)}</div>"
+      end
+    end
+  end
+end
diff --git a/test/html_pipeline/absolute_source_filter_test.rb b/test/html_pipeline/absolute_source_filter_test.rb
deleted file mode 100644
index 7e8d44d9..00000000
--- a/test/html_pipeline/absolute_source_filter_test.rb
+++ /dev/null
@@ -1,58 +0,0 @@
-# frozen_string_literal: true
-
-require "test_helper"
-
-class HTMLPipeline
-  class AbsoluteSourceFilterTest < Minitest::Test
-    AbsoluteSourceFilter = HTMLPipeline::AbsoluteSourceFilter
-
-    def setup
-      @image_base_url = "http://assets.example.com"
-      @image_subpage_url = "http://blog.example.com/a/post"
-      @options = {
-        image_base_url: @image_base_url,
-        image_subpage_url: @image_subpage_url,
-      }
-    end
-
-    def test_rewrites_root_urls
-      orig = %(<p><img src="/img.png"></p>)
-      assert_equal("<p><img src=\"#{@image_base_url}/img.png\"></p>",
-        AbsoluteSourceFilter.call(orig, context: @options).to_s)
-    end
-
-    def test_rewrites_relative_urls
-      orig = %(<p><img src="post/img.png"></p>)
-      assert_equal("<p><img src=\"#{@image_subpage_url}/img.png\"></p>",
-        AbsoluteSourceFilter.call(orig, context: @options).to_s)
-    end
-
-    def test_does_not_rewrite_absolute_urls
-      orig = %(<p><img src="http://other.example.com/img.png"></p>)
-      result = AbsoluteSourceFilter.call(orig, context: @options).to_s
-      refute_match(/@image_base_url/, result)
-      refute_match(/@image_subpage_url/, result)
-    end
-
-    def test_fails_when_context_is_missing
-      assert_raises(RuntimeError) do
-        AbsoluteSourceFilter.call('<img src="img.png">', context: {})
-      end
-      assert_raises(RuntimeError) do
-        AbsoluteSourceFilter.call('<img src="/img.png">', context: {})
-      end
-    end
-
-    def test_tells_you_where_context_is_required
-      exception = assert_raises(RuntimeError) do
-        AbsoluteSourceFilter.call('<img src="img.png">', context: {})
-      end
-      assert_match("HTMLPipeline::AbsoluteSourceFilter", exception.message)
-
-      exception = assert_raises(RuntimeError) do
-        AbsoluteSourceFilter.call('<img src="/img.png">', context: {})
-      end
-      assert_match("HTMLPipeline::AbsoluteSourceFilter", exception.message)
-    end
-  end
-end
diff --git a/test/html_pipeline/autolink_filter_test.rb b/test/html_pipeline/autolink_filter_test.rb
deleted file mode 100644
index f6143f15..00000000
--- a/test/html_pipeline/autolink_filter_test.rb
+++ /dev/null
@@ -1,59 +0,0 @@
-# frozen_string_literal: true
-
-require "test_helper"
-
-AutolinkFilter = HTMLPipeline::AutolinkFilter
-
-class HTMLPipeline
-  class AutolinkFilterTest < Minitest::Test
-    def test_uses_rinku_for_autolinking
-      # just try to parse a complicated piece of HTML
-      # that Rails auto_link cannot handle
-      assert_equal('<p>"<a href="http://www.github.com">http://www.github.com</a>"</p>',
-        AutolinkFilter.to_html('<p>"http://www.github.com"</p>'))
-    end
-
-    def test_autolink_option
-      assert_equal('<p>"http://www.github.com"</p>',
-        AutolinkFilter.to_html('<p>"http://www.github.com"</p>', context: { autolink: false }))
-    end
-
-    def test_autolink_link_attr
-      assert_equal('<p>"<a href="http://www.github.com" target="_blank">http://www.github.com</a>"</p>',
-        AutolinkFilter.to_html('<p>"http://www.github.com"</p>', context: { link_attr: 'target="_blank"' }))
-    end
-
-    def test_autolink_flags
-      assert_equal('<p>"<a href="http://github">http://github</a>"</p>',
-        AutolinkFilter.to_html('<p>"http://github"</p>', context: { flags: Rinku::AUTOLINK_SHORT_DOMAINS }))
-    end
-
-    def test_autolink_skip_tags
-      assert_equal('<code>"http://github.com"</code>',
-        AutolinkFilter.to_html('<code>"http://github.com"</code>'))
-
-      assert_equal('<code>"<a href="http://github.com">http://github.com</a>"</code>',
-        AutolinkFilter.to_html('<code>"http://github.com"</code>', context: { skip_tags: ["kbd", "script"] }))
-    end
-
-    def test_link_mode_default
-      assert_equal('<p>"<a href="http://www.github.com">http://www.github.com</a>"</p><p>"user@example.com"</p>',
-        AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>'))
-    end
-
-    def test_link_mode_urls
-      assert_equal('<p>"<a href="http://www.github.com">http://www.github.com</a>"</p><p>"user@example.com"</p>',
-        AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :urls }))
-    end
-
-    def test_link_mode_all
-      assert_equal('<p>"<a href="http://www.github.com">http://www.github.com</a>"</p><p>"<a href="mailto:user@example.com">user@example.com</a>"</p>',
-        AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :all }))
-    end
-
-    def test_link_mode_email_addresses
-      assert_equal('<p>"http://www.github.com"</p><p>"<a href="mailto:user@example.com">user@example.com</a>"</p>',
-        AutolinkFilter.to_html('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :email_addresses }))
-    end
-  end
-end
diff --git a/test/html_pipeline/filter/node_filter/absolute_source_filter_test.rb b/test/html_pipeline/filter/node_filter/absolute_source_filter_test.rb
new file mode 100644
index 00000000..2e75c129
--- /dev/null
+++ b/test/html_pipeline/filter/node_filter/absolute_source_filter_test.rb
@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+AbsoluteSourceFilter = HTMLPipeline::NodeFilter::AbsoluteSourceFilter
+class HTMLPipeline
+  class NodeFilter
+    class AbsoluteSourceFilterTest < Minitest::Test
+      def setup
+        @image_base_url = "http://assets.example.com"
+        @image_subpage_url = "http://blog.example.com/a/post"
+        @options = {
+          image_base_url: @image_base_url,
+          image_subpage_url: @image_subpage_url,
+        }
+      end
+
+      def test_rewrites_root_urls
+        orig = %(<p><img src="/img.png"></p>)
+        assert_equal("<p><img src=\"#{@image_base_url}/img.png\"></p>",
+          AbsoluteSourceFilter.call(orig, context: @options).to_s)
+      end
+
+      def test_rewrites_relative_urls
+        orig = %(<p><img src="post/img.png"></p>)
+        assert_equal("<p><img src=\"#{@image_subpage_url}/img.png\"></p>",
+          AbsoluteSourceFilter.call(orig, context: @options).to_s)
+      end
+
+      def test_does_not_rewrite_absolute_urls
+        orig = %(<p><img src="http://other.example.com/img.png"></p>)
+        result = AbsoluteSourceFilter.call(orig, context: @options).to_s
+        refute_match(/@image_base_url/, result)
+        refute_match(/@image_subpage_url/, result)
+      end
+
+      def test_fails_when_context_is_missing
+        assert_raises(RuntimeError) do
+          AbsoluteSourceFilter.call('<img src="img.png">', context: {})
+        end
+        assert_raises(RuntimeError) do
+          AbsoluteSourceFilter.call('<img src="/img.png">', context: {})
+        end
+      end
+
+      def test_tells_you_where_context_is_required
+        exception = assert_raises(RuntimeError) do
+          AbsoluteSourceFilter.call('<img src="img.png">', context: {})
+        end
+        assert_match("HTMLPipeline::NodeFilter::AbsoluteSourceFilter", exception.message)
+
+        exception = assert_raises(RuntimeError) do
+          AbsoluteSourceFilter.call('<img src="/img.png">', context: {})
+        end
+        assert_match("HTMLPipeline::NodeFilter::AbsoluteSourceFilter", exception.message)
+      end
+    end
+  end
+end
diff --git a/test/html_pipeline/emoji_filter_test.rb b/test/html_pipeline/filter/node_filter/emoji_filter_test.rb
similarity index 90%
rename from test/html_pipeline/emoji_filter_test.rb
rename to test/html_pipeline/filter/node_filter/emoji_filter_test.rb
index 59ab1ec4..c34013de 100644
--- a/test/html_pipeline/emoji_filter_test.rb
+++ b/test/html_pipeline/filter/node_filter/emoji_filter_test.rb
@@ -5,7 +5,7 @@
 class HTMLPipeline
   class EmojiFilterTest < Minitest::Test
     def setup
-      @emoji_filter = HTMLPipeline::EmojiFilter
+      @emoji_filter = HTMLPipeline::NodeFilter::EmojiFilter
     end
 
     def test_emojify
@@ -100,9 +100,9 @@ def test_img_attrs_can_accept_symbolized_keys
     def test_works_with_gemoji
       require "gemojione"
 
-      HTMLPipeline::EmojiFilter.stub(:gemoji_loaded?, false) do
+      HTMLPipeline::NodeFilter::EmojiFilter.stub(:gemoji_loaded?, false) do
         body = ":flag_ar:"
-        filter = HTMLPipeline::EmojiFilter.new(body, context: { asset_root: "https://foo.com" })
+        filter = HTMLPipeline::NodeFilter::EmojiFilter.new(body, context: { asset_root: "https://foo.com" })
         doc = filter.call
         assert_equal(%(<img class="emoji" title=":flag_ar:" alt=":flag_ar:" src="https://foo.com/emoji/1f1e6-1f1f7.png" height="20" width="20" align="absmiddle">), doc.to_html)
       end
@@ -110,9 +110,9 @@ def test_works_with_gemoji
 
     def test_gemoji_can_accept_symbolized_keys
       require "gemojione"
-      HTMLPipeline::EmojiFilter.stub(:gemoji_loaded?, false) do
+      HTMLPipeline::NodeFilter::EmojiFilter.stub(:gemoji_loaded?, false) do
         body = ":flag_ar:"
-        filter = HTMLPipeline::EmojiFilter.new(body, context: { asset_root: "https://coolwebsite.com", img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
+        filter = HTMLPipeline::NodeFilter::EmojiFilter.new(body, context: { asset_root: "https://coolwebsite.com", img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
         doc = filter.call
         assert_equal(%(<img class="emoji" title=":flag_ar:" alt=":flag_ar:" src="https://coolwebsite.com/emoji/1f1e6-1f1f7.png" draggable="false">), doc.to_html)
       end
diff --git a/test/html_pipeline/https_filter_test.rb b/test/html_pipeline/filter/node_filter/https_filter_test.rb
similarity index 91%
rename from test/html_pipeline/https_filter_test.rb
rename to test/html_pipeline/filter/node_filter/https_filter_test.rb
index 6016f3a1..5a98ed30 100644
--- a/test/html_pipeline/https_filter_test.rb
+++ b/test/html_pipeline/filter/node_filter/https_filter_test.rb
@@ -2,7 +2,7 @@
 
 require "test_helper"
 
-HttpsFilter = HTMLPipeline::HttpsFilter
+HttpsFilter = HTMLPipeline::NodeFilter::HttpsFilter
 
 class HTMLPipeline
   class HttpsFilterTest < Minitest::Test
@@ -47,7 +47,7 @@ def test_only_http_url
 
     def test_validates_http_url
       exception = assert_raises(ArgumentError) { @filter.to_html("") }
-      assert_match("HTMLPipeline::HttpsFilter: :http_url", exception.message)
+      assert_match("HTMLPipeline::NodeFilter::HttpsFilter: :http_url", exception.message)
     end
   end
 end
diff --git a/test/html_pipeline/image_max_width_filter_test.rb b/test/html_pipeline/filter/node_filter/image_max_width_filter_test.rb
similarity index 96%
rename from test/html_pipeline/image_max_width_filter_test.rb
rename to test/html_pipeline/filter/node_filter/image_max_width_filter_test.rb
index 3a99232b..6d67173c 100644
--- a/test/html_pipeline/image_max_width_filter_test.rb
+++ b/test/html_pipeline/filter/node_filter/image_max_width_filter_test.rb
@@ -5,7 +5,7 @@
 class HTMLPipeline
   class ImageMaxWidthFilterTest < Minitest::Test
     def setup
-      @filter = HTMLPipeline::ImageMaxWidthFilter
+      @filter = HTMLPipeline::NodeFilter::ImageMaxWidthFilter
     end
 
     def test_rewrites_image_style_tags
diff --git a/test/html_pipeline/mention_filter_test.rb b/test/html_pipeline/filter/node_filter/mention_filter_test.rb
similarity index 92%
rename from test/html_pipeline/mention_filter_test.rb
rename to test/html_pipeline/filter/node_filter/mention_filter_test.rb
index 7ee42be4..fa5fa4d7 100644
--- a/test/html_pipeline/mention_filter_test.rb
+++ b/test/html_pipeline/filter/node_filter/mention_filter_test.rb
@@ -5,12 +5,12 @@
 class HTMLPipeline
   class MentionFilterTest < Minitest::Test
     def setup
-      @filter = HTMLPipeline::MentionFilter
+      @filter = HTMLPipeline::NodeFilter::MentionFilter
       @context = { base_url: "/", info_url: nil, username_pattern: nil }
 
       @pipeline = HTMLPipeline.new([
-        HTMLPipeline::MarkdownFilter,
-        HTMLPipeline::MentionFilter,
+        HTMLPipeline::TextFilter::MarkdownFilter,
+        HTMLPipeline::NodeFilter::MentionFilter,
       ])
     end
 
@@ -186,16 +186,16 @@ def test_filter_does_not_create_a_new_object_for_default_username_pattern
       doc = Nokogiri::HTML::DocumentFragment.parse(body)
 
       @filter.call(doc.clone)
-      pattern_count = HTMLPipeline::MentionFilter::MENTION_PATTERNS.length
+      pattern_count = HTMLPipeline::NodeFilter::MentionFilter::MENTION_PATTERNS.length
       @filter.call(doc.clone)
 
-      assert_equal(pattern_count, HTMLPipeline::MentionFilter::MENTION_PATTERNS.length)
+      assert_equal(pattern_count, HTMLPipeline::NodeFilter::MentionFilter::MENTION_PATTERNS.length)
       @filter.call(doc.clone, context: { username_pattern: /test/ })
-      assert_equal(pattern_count + 1, HTMLPipeline::MentionFilter::MENTION_PATTERNS.length)
+      assert_equal(pattern_count + 1, HTMLPipeline::NodeFilter::MentionFilter::MENTION_PATTERNS.length)
     end
 
     def test_mention_link_filter
-      filter = HTMLPipeline::MentionFilter.new(nil)
+      filter = HTMLPipeline::NodeFilter::MentionFilter.new(nil)
       expected = "<a href='/hubot' class='user-mention'>@hubot</a>"
       assert_equal(expected, filter.mention_link_filter("@hubot"))
     end
diff --git a/test/html_pipeline/sanitization_filter_test.rb b/test/html_pipeline/filter/node_filter/sanitization_filter_test.rb
similarity index 98%
rename from test/html_pipeline/sanitization_filter_test.rb
rename to test/html_pipeline/filter/node_filter/sanitization_filter_test.rb
index fab25587..06424fd6 100644
--- a/test/html_pipeline/sanitization_filter_test.rb
+++ b/test/html_pipeline/filter/node_filter/sanitization_filter_test.rb
@@ -4,7 +4,7 @@
 
 class HTMLPipeline
   class SanitizationFilterTest < Minitest::Test
-    SanitizationFilter = HTMLPipeline::SanitizationFilter
+    SanitizationFilter = HTMLPipeline::NodeFilter::SanitizationFilter
 
     def test_removing_script_tags
       orig = %(<p><img src="http://github.com/img.png" /><script></script></p>)
diff --git a/test/html_pipeline/syntax_highlight_filter_test.rb b/test/html_pipeline/filter/node_filter/syntax_highlight_filter_test.rb
similarity index 96%
rename from test/html_pipeline/syntax_highlight_filter_test.rb
rename to test/html_pipeline/filter/node_filter/syntax_highlight_filter_test.rb
index 0cf6c272..adae8fbe 100644
--- a/test/html_pipeline/syntax_highlight_filter_test.rb
+++ b/test/html_pipeline/filter/node_filter/syntax_highlight_filter_test.rb
@@ -3,7 +3,7 @@
 require "test_helper"
 require "escape_utils"
 
-SyntaxHighlightFilter = HTMLPipeline::SyntaxHighlightFilter
+SyntaxHighlightFilter = HTMLPipeline::NodeFilter::SyntaxHighlightFilter
 
 class HTMLPipeline
   class SyntaxHighlightFilterTest < Minitest::Test
diff --git a/test/html_pipeline/filter/node_filter/table_of_contents_filter_test.rb b/test/html_pipeline/filter/node_filter/table_of_contents_filter_test.rb
new file mode 100644
index 00000000..f5c36d44
--- /dev/null
+++ b/test/html_pipeline/filter/node_filter/table_of_contents_filter_test.rb
@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+class HTMLPipeline
+  class NodeFilter
+    class TableOfContentsFilterTest < Minitest::Test
+      TocFilter = HTMLPipeline::NodeFilter::TableOfContentsFilter
+
+      TocPipeline =
+        HTMLPipeline.new([
+          TocFilter,
+        ])
+
+      def toc(content)
+        result = {}
+        TocPipeline.call(content, context: {}, result: result)
+        result[:toc]
+      end
+
+      def test_anchors_are_added_properly
+        orig = %(<h1>Ice cube</h1><p>Will swarm on any motherfucker in a blue uniform</p>)
+        assert_includes(TocFilter.call(orig).to_s, "<a id=")
+      end
+
+      def test_custom_anchor_icons_added_properly
+        orig = %(<h1>Ice cube</h1>)
+        expected = %(<h1>\n<a id="ice-cube" class="anchor" href="#ice-cube" aria-hidden="true">#</a>Ice cube</h1>)
+
+        assert_equal(expected, TocFilter.call(orig, context: { anchor_icon: "#" }).to_s)
+      end
+
+      def test_toc_list_added_properly
+        orig = %(<h1>Ice cube</h1><p>Will swarm on any motherfucker in a blue uniform</p>)
+        assert_includes(toc(orig), %(<ul class="section-nav">\n<li><a href="))
+      end
+
+      def test_anchors_have_sane_names
+        orig = %(<h1>Dr Dre</h1><h1>Ice Cube</h1><h1>Eazy-E</h1><h1>MC Ren</h1>)
+        result = TocFilter.call(orig).to_s
+
+        assert_includes(result, '"dr-dre"')
+        assert_includes(result, '"ice-cube"')
+        assert_includes(result, '"eazy-e"')
+        assert_includes(result, '"mc-ren"')
+      end
+
+      def test_anchors_have_aria_hidden
+        orig = "<h1>Straight Outta Compton</h1>"
+        result = TocFilter.call(orig).to_s
+        assert_includes(result, 'aria-hidden="true"')
+      end
+
+      def test_toc_hrefs_have_sane_values
+        orig = %(<h1>Dr Dre</h1><h1>Ice Cube</h1><h1>Eazy-E</h1><h1>MC Ren</h1>)
+        toc = TocFilter.call(orig).to_s
+        assert_includes(toc, '"#dr-dre"')
+        assert_includes(toc, '"#ice-cube"')
+        assert_includes(toc, '"#eazy-e"')
+        assert_includes(toc, '"#mc-ren"')
+      end
+
+      def test_dupe_headers_have_unique_trailing_identifiers
+        orig = %(<h1>Straight Outta Compton</h1>
+             <h2>Dopeman</h2>
+             <h3>Express Yourself</h3>
+             <h1>Dopeman</h1>)
+
+        result = TocFilter.call(orig).to_s
+
+        assert_includes(result, '"dopeman"')
+        assert_includes(result, '"dopeman-1"')
+      end
+
+      def test_dupe_headers_have_unique_toc_anchors
+        orig = %(<h1>Straight Outta Compton</h1>
+              <h2>Dopeman</h2>
+              <h3>Express Yourself</h3>
+              <h1>Dopeman</h1>)
+
+        assert_includes(toc(orig), '"#dopeman"')
+        assert_includes(toc(orig), '"#dopeman-1"')
+      end
+
+      def test_all_header_tags_are_found_when_adding_anchors
+        orig = %(<h1>"Funky President" by James Brown</h1>
+             <h2>"It's My Thing" by Marva Whitney</h2>
+             <h3>"Boogie Back" by Roy Ayers</h3>
+             <h4>"Feel Good" by Fancy</h4>
+             <h5>"Funky Drummer" by James Brown</h5>
+             <h6>"Ruthless Villain" by Eazy-E</h6>
+             <h7>"Be Thankful for What You Got" by William DeVaughn</h7>)
+
+        doc = TocFilter.call(orig)
+
+        assert_equal(6, doc.search("a").size)
+      end
+
+      def test_toc_outputs_escaped_html
+        orig = %(<h1>&lt;img src="x" onerror="alert(42)"&gt;</h1>)
+
+        refute_includes(toc(orig), %(<img src="x" onerror="alert(42)">))
+      end
+
+      def test_toc_is_complete
+        orig = %(<h1>"Funky President" by James Brown</h1>
+              <h2>"It's My Thing" by Marva Whitney</h2>
+              <h3>"Boogie Back" by Roy Ayers</h3>
+              <h4>"Feel Good" by Fancy</h4>
+              <h5>"Funky Drummer" by James Brown</h5>
+              <h6>"Ruthless Villain" by Eazy-E</h6>
+              <h7>"Be Thankful for What You Got" by William DeVaughn</h7>)
+
+        expected = %(<ul class="section-nav">\n<li><a href="#funky-president-by-james-brown">&quot;Funky President&quot; by James Brown</a></li>\n<li><a href="#its-my-thing-by-marva-whitney">&quot;It&#39;s My Thing&quot; by Marva Whitney</a></li>\n<li><a href="#boogie-back-by-roy-ayers">&quot;Boogie Back&quot; by Roy Ayers</a></li>\n<li><a href="#feel-good-by-fancy">&quot;Feel Good&quot; by Fancy</a></li>\n<li><a href="#funky-drummer-by-james-brown">&quot;Funky Drummer&quot; by James Brown</a></li>\n<li><a href="#ruthless-villain-by-eazy-e">&quot;Ruthless Villain&quot; by Eazy-E</a></li>\n</ul>)
+
+        assert_equal(expected, toc(orig))
+      end
+
+      if RUBY_VERSION > "1.9" # not sure how to make this work on 1.8.7
+
+        def test_anchors_with_utf8_characters
+          orig = %(<h1>日本語</h1>
+               <h1>Русский</h1)
+
+          rendered_h1s = TocFilter.call(orig).search("h1").map(&:to_s)
+
+          assert_equal("<h1>\n<a id=\"日本語\" class=\"anchor\" href=\"#%E6%97%A5%E6%9C%AC%E8%AA%9E\" aria-hidden=\"true\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"></span></a>日本語</h1>",
+            rendered_h1s[0])
+          assert_equal("<h1>\n<a id=\"Русский\" class=\"anchor\" href=\"#%D0%A0%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9\" aria-hidden=\"true\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"></span></a>Русский</h1>",
+            rendered_h1s[1])
+        end
+
+        def test_toc_with_utf8_characters
+          orig = %(<h1>日本語</h1>
+                <h1>Русский</h1)
+
+          rendered_toc = Nokogiri::HTML::DocumentFragment.parse(toc(orig)).to_s
+
+          expected = %(<ul class="section-nav">\n<li><a href="#%E6%97%A5%E6%9C%AC%E8%AA%9E">日本語</a></li>\n<li><a href="#%D0%A0%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9">Русский</a></li>\n</ul>)
+
+          assert_equal(expected, rendered_toc)
+        end
+      end
+    end
+  end
+end
diff --git a/test/html_pipeline/team_mention_filter_test.rb b/test/html_pipeline/filter/node_filter/team_mention_filter_test.rb
similarity index 96%
rename from test/html_pipeline/team_mention_filter_test.rb
rename to test/html_pipeline/filter/node_filter/team_mention_filter_test.rb
index 5eeb98af..349eebdc 100644
--- a/test/html_pipeline/team_mention_filter_test.rb
+++ b/test/html_pipeline/filter/node_filter/team_mention_filter_test.rb
@@ -5,12 +5,12 @@
 class HTMLPipeline
   class TeamMentionFilterTest < Minitest::Test
     def setup
-      @filter = HTMLPipeline::TeamMentionFilter
+      @filter = HTMLPipeline::NodeFilter::TeamMentionFilter
 
       @pipeline =
         HTMLPipeline.new([
-          HTMLPipeline::MarkdownFilter,
-          HTMLPipeline::TeamMentionFilter,
+          HTMLPipeline::TextFilter::MarkdownFilter,
+          HTMLPipeline::NodeFilter::TeamMentionFilter,
         ])
     end
 
@@ -196,7 +196,7 @@ def test_team_pattern_can_be_customized
     end
 
     def test_mention_link_filter
-      filter = HTMLPipeline::TeamMentionFilter.new(nil)
+      filter = HTMLPipeline::NodeFilter::TeamMentionFilter.new(nil)
       expected = "<a href='/bot/hubot' class='team-mention'>@bot/hubot</a>"
       assert_equal(expected, filter.mention_link_filter("@bot/hubot"))
     end
diff --git a/test/html_pipeline/filter/text_filter/autolink_filter_test.rb b/test/html_pipeline/filter/text_filter/autolink_filter_test.rb
new file mode 100644
index 00000000..65c45d01
--- /dev/null
+++ b/test/html_pipeline/filter/text_filter/autolink_filter_test.rb
@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+AutolinkFilter = HTMLPipeline::TextFilter::AutolinkFilter
+
+class HTMLPipeline
+  class TextFilter
+    class AutolinkFilterTest < Minitest::Test
+      def test_uses_rinku_for_autolinking
+        # just try to parse a complicated piece of HTML
+        # that Rails auto_link cannot handle
+        assert_equal('<p>"<a href="http://www.github.com">http://www.github.com</a>"</p>',
+          AutolinkFilter.call('<p>"http://www.github.com"</p>'))
+      end
+
+      def test_autolink_option
+        assert_equal('<p>"http://www.github.com"</p>',
+          AutolinkFilter.call('<p>"http://www.github.com"</p>', context: { autolink: false }))
+      end
+
+      def test_autolink_link_attr
+        assert_equal('<p>"<a href="http://www.github.com" target="_blank">http://www.github.com</a>"</p>',
+          AutolinkFilter.call('<p>"http://www.github.com"</p>', context: { link_attr: 'target="_blank"' }))
+      end
+
+      def test_autolink_flags
+        assert_equal('<p>"<a href="http://github">http://github</a>"</p>',
+          AutolinkFilter.call('<p>"http://github"</p>', context: { flags: Rinku::AUTOLINK_SHORT_DOMAINS }))
+      end
+
+      def test_autolink_skip_tags
+        assert_equal('<code>"http://github.com"</code>',
+          AutolinkFilter.call('<code>"http://github.com"</code>'))
+
+        assert_equal('<code>"<a href="http://github.com">http://github.com</a>"</code>',
+          AutolinkFilter.call('<code>"http://github.com"</code>', context: { skip_tags: ["kbd", "script"] }))
+      end
+
+      def test_link_mode_default
+        assert_equal('<p>"<a href="http://www.github.com">http://www.github.com</a>"</p><p>"user@example.com"</p>',
+          AutolinkFilter.call('<p>"http://www.github.com"</p><p>"user@example.com"</p>'))
+      end
+
+      def test_link_mode_urls
+        assert_equal('<p>"<a href="http://www.github.com">http://www.github.com</a>"</p><p>"user@example.com"</p>',
+          AutolinkFilter.call('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :urls }))
+      end
+
+      def test_link_mode_all
+        assert_equal('<p>"<a href="http://www.github.com">http://www.github.com</a>"</p><p>"<a href="mailto:user@example.com">user@example.com</a>"</p>',
+          AutolinkFilter.call('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :all }))
+      end
+
+      def test_link_mode_email_addresses
+        assert_equal('<p>"http://www.github.com"</p><p>"<a href="mailto:user@example.com">user@example.com</a>"</p>',
+          AutolinkFilter.call('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :email_addresses }))
+      end
+    end
+  end
+end
diff --git a/test/html_pipeline/image_filter_test.rb b/test/html_pipeline/filter/text_filter/image_filter_test.rb
similarity index 66%
rename from test/html_pipeline/image_filter_test.rb
rename to test/html_pipeline/filter/text_filter/image_filter_test.rb
index fbf0f280..be67c278 100644
--- a/test/html_pipeline/image_filter_test.rb
+++ b/test/html_pipeline/filter/text_filter/image_filter_test.rb
@@ -2,7 +2,7 @@
 
 require "test_helper"
 
-ImageFilter = HTMLPipeline::ImageFilter
+ImageFilter = HTMLPipeline::TextFilter::ImageFilter
 
 class HTMLPipeline
   class ImageFilterTest < Minitest::Test
@@ -12,32 +12,32 @@ def setup
 
     def test_jpg
       assert_equal(%(<img src="http://example.com/test.jpg" alt=""/>),
-        @filter.to_html(%(http://example.com/test.jpg)))
+        @filter.call(%(http://example.com/test.jpg)))
     end
 
     def test_jpeg
       assert_equal(%(<img src="http://example.com/test.jpeg" alt=""/>),
-        @filter.to_html(%(http://example.com/test.jpeg)))
+        @filter.call(%(http://example.com/test.jpeg)))
     end
 
     def test_bmp
       assert_equal(%(<img src="http://example.com/test.bmp" alt=""/>),
-        @filter.to_html(%(http://example.com/test.bmp)))
+        @filter.call(%(http://example.com/test.bmp)))
     end
 
     def test_gif
       assert_equal(%(<img src="http://example.com/test.gif" alt=""/>),
-        @filter.to_html(%(http://example.com/test.gif)))
+        @filter.call(%(http://example.com/test.gif)))
     end
 
     def test_png
       assert_equal(%(<img src="http://example.com/test.png" alt=""/>),
-        @filter.to_html(%(http://example.com/test.png)))
+        @filter.call(%(http://example.com/test.png)))
     end
 
     def test_https_url
       assert_equal(%(<img src="https://example.com/test.png" alt=""/>),
-        @filter.to_html(%(https://example.com/test.png)))
+        @filter.call(%(https://example.com/test.png)))
     end
   end
 end
diff --git a/test/html_pipeline/markdown_filter_test.rb b/test/html_pipeline/filter/text_filter/markdown_filter_test.rb
similarity index 95%
rename from test/html_pipeline/markdown_filter_test.rb
rename to test/html_pipeline/filter/text_filter/markdown_filter_test.rb
index ea6d85cb..64dba8cf 100644
--- a/test/html_pipeline/markdown_filter_test.rb
+++ b/test/html_pipeline/filter/text_filter/markdown_filter_test.rb
@@ -2,7 +2,7 @@
 
 require "test_helper"
 
-MarkdownFilter = HTMLPipeline::MarkdownFilter
+MarkdownFilter = HTMLPipeline::TextFilter::MarkdownFilter
 
 class HTMLPipeline
   class MarkdownFilterTest < Minitest::Test
@@ -106,7 +106,7 @@ def test_legitimate_renderer
     end
 
     def test_without_tagfilter
-      extensions = HTMLPipeline::MarkdownFilter::DEFAULT_COMMONMARKER_EXTENSIONS - [:tagfilter]
+      extensions = HTMLPipeline::TextFilter::MarkdownFilter::DEFAULT_COMMONMARKER_EXTENSIONS - [:tagfilter]
       script = "<script>foobar</script>"
       results = MarkdownFilter.new(script, context: { unsafe: true, commonmarker_extensions: extensions }).call
 
@@ -114,7 +114,7 @@ def test_without_tagfilter
     end
 
     def test_legitimate_custom_renderer_without_tagfilter
-      extensions = HTMLPipeline::MarkdownFilter::DEFAULT_COMMONMARKER_EXTENSIONS - [:tagfilter]
+      extensions = HTMLPipeline::TextFilter::MarkdownFilter::DEFAULT_COMMONMARKER_EXTENSIONS - [:tagfilter]
       script = "<script>foobar</script>"
       results = MarkdownFilter.new(script, context: { unsafe: true, commonmarker_extensions: extensions, commonmarker_renderer: CustomRenderer }).call
 
diff --git a/test/html_pipeline/plain_text_input_filter_test.rb b/test/html_pipeline/filter/text_filter/plain_text_input_filter_test.rb
similarity index 90%
rename from test/html_pipeline/plain_text_input_filter_test.rb
rename to test/html_pipeline/filter/text_filter/plain_text_input_filter_test.rb
index e3816277..a0af12cc 100644
--- a/test/html_pipeline/plain_text_input_filter_test.rb
+++ b/test/html_pipeline/filter/text_filter/plain_text_input_filter_test.rb
@@ -4,7 +4,7 @@
 
 class HTMLPipeline
   class PlainTextInputFilterTest < Minitest::Test
-    PlainTextInputFilter = HTMLPipeline::PlainTextInputFilter
+    PlainTextInputFilter = HTMLPipeline::TextFilter::PlainTextInputFilter
 
     def test_fails_when_given_a_documentfragment
       body = "<p>heyo</p>"
diff --git a/test/html_pipeline/toc_filter_test.rb b/test/html_pipeline/toc_filter_test.rb
deleted file mode 100644
index 5a0b14b8..00000000
--- a/test/html_pipeline/toc_filter_test.rb
+++ /dev/null
@@ -1,144 +0,0 @@
-# frozen_string_literal: true
-
-require "test_helper"
-
-class HTMLPipeline
-  class TableOfContentsFilterTest < Minitest::Test
-    TocFilter = HTMLPipeline::TableOfContentsFilter
-
-    TocPipeline =
-      HTMLPipeline.new([
-        HTMLPipeline::TableOfContentsFilter,
-      ])
-
-    def toc(content)
-      result = {}
-      TocPipeline.call(content, context: {}, result: result)
-      result[:toc]
-    end
-
-    def test_anchors_are_added_properly
-      orig = %(<h1>Ice cube</h1><p>Will swarm on any motherfucker in a blue uniform</p>)
-      assert_includes(TocFilter.call(orig).to_s, "<a id=")
-    end
-
-    def test_custom_anchor_icons_added_properly
-      orig = %(<h1>Ice cube</h1>)
-      expected = %(<h1>\n<a id="ice-cube" class="anchor" href="#ice-cube" aria-hidden="true">#</a>Ice cube</h1>)
-
-      assert_equal(expected, TocFilter.call(orig, context: { anchor_icon: "#" }).to_s)
-    end
-
-    def test_toc_list_added_properly
-      orig = %(<h1>Ice cube</h1><p>Will swarm on any motherfucker in a blue uniform</p>)
-      assert_includes(toc(orig), %(<ul class="section-nav">\n<li><a href="))
-    end
-
-    def test_anchors_have_sane_names
-      orig = %(<h1>Dr Dre</h1><h1>Ice Cube</h1><h1>Eazy-E</h1><h1>MC Ren</h1>)
-      result = TocFilter.call(orig).to_s
-
-      assert_includes(result, '"dr-dre"')
-      assert_includes(result, '"ice-cube"')
-      assert_includes(result, '"eazy-e"')
-      assert_includes(result, '"mc-ren"')
-    end
-
-    def test_anchors_have_aria_hidden
-      orig = "<h1>Straight Outta Compton</h1>"
-      result = TocFilter.call(orig).to_s
-      assert_includes(result, 'aria-hidden="true"')
-    end
-
-    def test_toc_hrefs_have_sane_values
-      orig = %(<h1>Dr Dre</h1><h1>Ice Cube</h1><h1>Eazy-E</h1><h1>MC Ren</h1>)
-      toc = TocFilter.call(orig).to_s
-      assert_includes(toc, '"#dr-dre"')
-      assert_includes(toc, '"#ice-cube"')
-      assert_includes(toc, '"#eazy-e"')
-      assert_includes(toc, '"#mc-ren"')
-    end
-
-    def test_dupe_headers_have_unique_trailing_identifiers
-      orig = %(<h1>Straight Outta Compton</h1>
-             <h2>Dopeman</h2>
-             <h3>Express Yourself</h3>
-             <h1>Dopeman</h1>)
-
-      result = TocFilter.call(orig).to_s
-
-      assert_includes(result, '"dopeman"')
-      assert_includes(result, '"dopeman-1"')
-    end
-
-    def test_dupe_headers_have_unique_toc_anchors
-      orig = %(<h1>Straight Outta Compton</h1>
-              <h2>Dopeman</h2>
-              <h3>Express Yourself</h3>
-              <h1>Dopeman</h1>)
-
-      assert_includes(toc(orig), '"#dopeman"')
-      assert_includes(toc(orig), '"#dopeman-1"')
-    end
-
-    def test_all_header_tags_are_found_when_adding_anchors
-      orig = %(<h1>"Funky President" by James Brown</h1>
-             <h2>"It's My Thing" by Marva Whitney</h2>
-             <h3>"Boogie Back" by Roy Ayers</h3>
-             <h4>"Feel Good" by Fancy</h4>
-             <h5>"Funky Drummer" by James Brown</h5>
-             <h6>"Ruthless Villain" by Eazy-E</h6>
-             <h7>"Be Thankful for What You Got" by William DeVaughn</h7>)
-
-      doc = TocFilter.call(orig)
-
-      assert_equal(6, doc.search("a").size)
-    end
-
-    def test_toc_outputs_escaped_html
-      orig = %(<h1>&lt;img src="x" onerror="alert(42)"&gt;</h1>)
-
-      refute_includes(toc(orig), %(<img src="x" onerror="alert(42)">))
-    end
-
-    def test_toc_is_complete
-      orig = %(<h1>"Funky President" by James Brown</h1>
-              <h2>"It's My Thing" by Marva Whitney</h2>
-              <h3>"Boogie Back" by Roy Ayers</h3>
-              <h4>"Feel Good" by Fancy</h4>
-              <h5>"Funky Drummer" by James Brown</h5>
-              <h6>"Ruthless Villain" by Eazy-E</h6>
-              <h7>"Be Thankful for What You Got" by William DeVaughn</h7>)
-
-      expected = %(<ul class="section-nav">\n<li><a href="#funky-president-by-james-brown">&quot;Funky President&quot; by James Brown</a></li>\n<li><a href="#its-my-thing-by-marva-whitney">&quot;It&#39;s My Thing&quot; by Marva Whitney</a></li>\n<li><a href="#boogie-back-by-roy-ayers">&quot;Boogie Back&quot; by Roy Ayers</a></li>\n<li><a href="#feel-good-by-fancy">&quot;Feel Good&quot; by Fancy</a></li>\n<li><a href="#funky-drummer-by-james-brown">&quot;Funky Drummer&quot; by James Brown</a></li>\n<li><a href="#ruthless-villain-by-eazy-e">&quot;Ruthless Villain&quot; by Eazy-E</a></li>\n</ul>)
-
-      assert_equal(expected, toc(orig))
-    end
-
-    if RUBY_VERSION > "1.9" # not sure how to make this work on 1.8.7
-
-      def test_anchors_with_utf8_characters
-        orig = %(<h1>日本語</h1>
-               <h1>Русский</h1)
-
-        rendered_h1s = TocFilter.call(orig).search("h1").map(&:to_s)
-
-        assert_equal("<h1>\n<a id=\"日本語\" class=\"anchor\" href=\"#%E6%97%A5%E6%9C%AC%E8%AA%9E\" aria-hidden=\"true\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"></span></a>日本語</h1>",
-          rendered_h1s[0])
-        assert_equal("<h1>\n<a id=\"Русский\" class=\"anchor\" href=\"#%D0%A0%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9\" aria-hidden=\"true\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"></span></a>Русский</h1>",
-          rendered_h1s[1])
-      end
-
-      def test_toc_with_utf8_characters
-        orig = %(<h1>日本語</h1>
-                <h1>Русский</h1)
-
-        rendered_toc = Nokogiri::HTML::DocumentFragment.parse(toc(orig)).to_s
-
-        expected = %(<ul class="section-nav">\n<li><a href="#%E6%97%A5%E6%9C%AC%E8%AA%9E">日本語</a></li>\n<li><a href="#%D0%A0%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9">Русский</a></li>\n</ul>)
-
-        assert_equal(expected, rendered_toc)
-      end
-    end
-  end
-end

From a63230f21d24c1edc64ab18a76d44925c1c2c6e2 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Sat, 4 Jun 2022 09:01:12 -0700
Subject: [PATCH 25/64] license update

---
 LICENSE => LICENSE.txt | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
 rename LICENSE => LICENSE.txt (89%)

diff --git a/LICENSE b/LICENSE.txt
similarity index 89%
rename from LICENSE
rename to LICENSE.txt
index c972fc6b..7c5020a1 100644
--- a/LICENSE
+++ b/LICENSE.txt
@@ -1,4 +1,4 @@
-Copyright (c) 2012 GitHub Inc. and Jerry Cheung
+Copyright (c) 2022 Garen Torikian
 
 MIT License
 
@@ -19,4 +19,4 @@ 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.
\ No newline at end of file
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

From 0773ba0cff6b04b713b565f53ecfe67c59c927bf Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Sat, 4 Jun 2022 09:04:27 -0700
Subject: [PATCH 26/64] update gems

---
 Gemfile               | 1 -
 html-pipeline.gemspec | 9 +++++++--
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/Gemfile b/Gemfile
index 4ac968e3..fa2bc56d 100644
--- a/Gemfile
+++ b/Gemfile
@@ -8,7 +8,6 @@ gemspec
 gem "awesome_print"
 
 gem "rubocop"
-gem "rubocop-performance"
 gem "rubocop-standard"
 
 group :development do
diff --git a/html-pipeline.gemspec b/html-pipeline.gemspec
index 028db6bd..28a8ba4a 100644
--- a/html-pipeline.gemspec
+++ b/html-pipeline.gemspec
@@ -11,12 +11,17 @@ Gem::Specification.new do |gem|
   gem.email         = ["gjtorikian@gmail.com"]
   gem.description   = "HTML processing filters and utilities"
   gem.summary       = "Helpers for processing content through a chain of filters"
-  gem.homepage      = "https://github.com/jch/html-pipeline"
+  gem.homepage      = "https://github.com/gjtorikian/html-pipeline"
 
   gem.files         = %x(git ls-files -z).split("\x0").reject { |f| f =~ %r{^(test|gemfiles|script)/} }
   gem.require_paths = ["lib"]
 
-  gem.required_ruby_version = [">= 2.5.8", "< 4.0"]
+  gem.required_ruby_version = "~> 3.0"
+
+  gem.metadata = {
+    "funding_uri" => "https://github.com/sponsors/gjtorikian/",
+    "rubygems_mfa_required" => "true",
+  }
 
   gem.add_dependency("nokogiri", "~> 1.11")
   gem.add_dependency("zeitwerk", "~> 2.5")

From 0d48f037985825aa99d342f3956e9104f196ebe5 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Sat, 4 Jun 2022 09:06:31 -0700
Subject: [PATCH 27/64] rearrange

---
 lib/html_pipeline.rb                          | 21 -------------------
 .../absolute_source_filter_test.rb            |  0
 .../node_filter/emoji_filter_test.rb          |  0
 .../node_filter/https_filter_test.rb          |  0
 .../image_max_width_filter_test.rb            |  0
 .../node_filter/mention_filter_test.rb        |  0
 .../node_filter/sanitization_filter_test.rb   |  0
 .../syntax_highlight_filter_test.rb           |  0
 .../table_of_contents_filter_test.rb          |  0
 .../node_filter/team_mention_filter_test.rb   |  0
 .../text_filter/autolink_filter_test.rb       |  0
 .../text_filter/image_filter_test.rb          |  0
 .../text_filter/markdown_filter_test.rb       |  0
 .../plain_text_input_filter_test.rb           |  0
 14 files changed, 21 deletions(-)
 rename test/html_pipeline/{filter => }/node_filter/absolute_source_filter_test.rb (100%)
 rename test/html_pipeline/{filter => }/node_filter/emoji_filter_test.rb (100%)
 rename test/html_pipeline/{filter => }/node_filter/https_filter_test.rb (100%)
 rename test/html_pipeline/{filter => }/node_filter/image_max_width_filter_test.rb (100%)
 rename test/html_pipeline/{filter => }/node_filter/mention_filter_test.rb (100%)
 rename test/html_pipeline/{filter => }/node_filter/sanitization_filter_test.rb (100%)
 rename test/html_pipeline/{filter => }/node_filter/syntax_highlight_filter_test.rb (100%)
 rename test/html_pipeline/{filter => }/node_filter/table_of_contents_filter_test.rb (100%)
 rename test/html_pipeline/{filter => }/node_filter/team_mention_filter_test.rb (100%)
 rename test/html_pipeline/{filter => }/text_filter/autolink_filter_test.rb (100%)
 rename test/html_pipeline/{filter => }/text_filter/image_filter_test.rb (100%)
 rename test/html_pipeline/{filter => }/text_filter/markdown_filter_test.rb (100%)
 rename test/html_pipeline/{filter => }/text_filter/plain_text_input_filter_test.rb (100%)

diff --git a/lib/html_pipeline.rb b/lib/html_pipeline.rb
index 47723911..e2f0a907 100644
--- a/lib/html_pipeline.rb
+++ b/lib/html_pipeline.rb
@@ -32,27 +32,6 @@ class HTMLPipeline
   # result_class    - The default Class of the result object for individual
   #                   calls.  Default: Hash.  Protip:  Pass in a Struct to get
   #                   some semblance of type safety.
-  # autoload :VERSION,               'html/pipeline/version'
-  # autoload :Filter,                'html/pipeline/filter'
-  # autoload :AbsoluteSourceFilter,  'html/pipeline/absolute_source_filter'
-  # autoload :BodyContent,           'html/pipeline/body_content'
-  # autoload :AutolinkFilter,        'html/pipeline/autolink_filter'
-  # autoload :CamoFilter,            'html/pipeline/camo_filter'
-  # autoload :EmailReplyFilter,      'html/pipeline/email_reply_filter'
-  # autoload :EmojiFilter,           'html/pipeline/emoji_filter'
-  # autoload :HttpsFilter,           'html/pipeline/https_filter'
-  # autoload :ImageFilter,           'html/pipeline/image_filter'
-  # autoload :ImageMaxWidthFilter,   'html/pipeline/image_max_width_filter'
-  # autoload :MarkdownFilter,        'html/pipeline/markdown_filter'
-  # autoload :MentionFilter,         'html/pipeline/mention_filter'
-  # autoload :TeamMentionFilter,     'html/pipeline/team_mention_filter'
-  # autoload :PlainTextInputFilter,  'html/pipeline/plain_text_input_filter'
-  # autoload :SanitizationFilter,    'html/pipeline/sanitization_filter'
-  # autoload :SyntaxHighlightFilter, 'html/pipeline/syntax_highlight_filter'
-  # autoload :TextileFilter,         'html/pipeline/textile_filter'
-  # autoload :TableOfContentsFilter, 'html/pipeline/toc_filter'
-  # autoload :TextFilter,            'html/pipeline/text_filter'
-
   class MissingDependencyError < RuntimeError; end
 
   def self.require_dependency(name, requirer)
diff --git a/test/html_pipeline/filter/node_filter/absolute_source_filter_test.rb b/test/html_pipeline/node_filter/absolute_source_filter_test.rb
similarity index 100%
rename from test/html_pipeline/filter/node_filter/absolute_source_filter_test.rb
rename to test/html_pipeline/node_filter/absolute_source_filter_test.rb
diff --git a/test/html_pipeline/filter/node_filter/emoji_filter_test.rb b/test/html_pipeline/node_filter/emoji_filter_test.rb
similarity index 100%
rename from test/html_pipeline/filter/node_filter/emoji_filter_test.rb
rename to test/html_pipeline/node_filter/emoji_filter_test.rb
diff --git a/test/html_pipeline/filter/node_filter/https_filter_test.rb b/test/html_pipeline/node_filter/https_filter_test.rb
similarity index 100%
rename from test/html_pipeline/filter/node_filter/https_filter_test.rb
rename to test/html_pipeline/node_filter/https_filter_test.rb
diff --git a/test/html_pipeline/filter/node_filter/image_max_width_filter_test.rb b/test/html_pipeline/node_filter/image_max_width_filter_test.rb
similarity index 100%
rename from test/html_pipeline/filter/node_filter/image_max_width_filter_test.rb
rename to test/html_pipeline/node_filter/image_max_width_filter_test.rb
diff --git a/test/html_pipeline/filter/node_filter/mention_filter_test.rb b/test/html_pipeline/node_filter/mention_filter_test.rb
similarity index 100%
rename from test/html_pipeline/filter/node_filter/mention_filter_test.rb
rename to test/html_pipeline/node_filter/mention_filter_test.rb
diff --git a/test/html_pipeline/filter/node_filter/sanitization_filter_test.rb b/test/html_pipeline/node_filter/sanitization_filter_test.rb
similarity index 100%
rename from test/html_pipeline/filter/node_filter/sanitization_filter_test.rb
rename to test/html_pipeline/node_filter/sanitization_filter_test.rb
diff --git a/test/html_pipeline/filter/node_filter/syntax_highlight_filter_test.rb b/test/html_pipeline/node_filter/syntax_highlight_filter_test.rb
similarity index 100%
rename from test/html_pipeline/filter/node_filter/syntax_highlight_filter_test.rb
rename to test/html_pipeline/node_filter/syntax_highlight_filter_test.rb
diff --git a/test/html_pipeline/filter/node_filter/table_of_contents_filter_test.rb b/test/html_pipeline/node_filter/table_of_contents_filter_test.rb
similarity index 100%
rename from test/html_pipeline/filter/node_filter/table_of_contents_filter_test.rb
rename to test/html_pipeline/node_filter/table_of_contents_filter_test.rb
diff --git a/test/html_pipeline/filter/node_filter/team_mention_filter_test.rb b/test/html_pipeline/node_filter/team_mention_filter_test.rb
similarity index 100%
rename from test/html_pipeline/filter/node_filter/team_mention_filter_test.rb
rename to test/html_pipeline/node_filter/team_mention_filter_test.rb
diff --git a/test/html_pipeline/filter/text_filter/autolink_filter_test.rb b/test/html_pipeline/text_filter/autolink_filter_test.rb
similarity index 100%
rename from test/html_pipeline/filter/text_filter/autolink_filter_test.rb
rename to test/html_pipeline/text_filter/autolink_filter_test.rb
diff --git a/test/html_pipeline/filter/text_filter/image_filter_test.rb b/test/html_pipeline/text_filter/image_filter_test.rb
similarity index 100%
rename from test/html_pipeline/filter/text_filter/image_filter_test.rb
rename to test/html_pipeline/text_filter/image_filter_test.rb
diff --git a/test/html_pipeline/filter/text_filter/markdown_filter_test.rb b/test/html_pipeline/text_filter/markdown_filter_test.rb
similarity index 100%
rename from test/html_pipeline/filter/text_filter/markdown_filter_test.rb
rename to test/html_pipeline/text_filter/markdown_filter_test.rb
diff --git a/test/html_pipeline/filter/text_filter/plain_text_input_filter_test.rb b/test/html_pipeline/text_filter/plain_text_input_filter_test.rb
similarity index 100%
rename from test/html_pipeline/filter/text_filter/plain_text_input_filter_test.rb
rename to test/html_pipeline/text_filter/plain_text_input_filter_test.rb

From 61fa9c6499b086928e8432d25b7b52269b714b81 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Sat, 4 Jun 2022 09:08:46 -0700
Subject: [PATCH 28/64] ruby version changes

---
 .github/workflows/ci.yml | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index bbb0c2fc..0aef6de3 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -15,11 +15,8 @@ jobs:
       fail-fast: true
       matrix:
         ruby-version:
+          - 3.1.0
           - 3.0.0
-          - 2.7.2
-          - 2.6.6
-          - 2.5.8
-          - truffleruby-head
         experimental: [false]
         include:
           - ruby-version: head
@@ -29,12 +26,14 @@ jobs:
 
     steps:
       - uses: actions/checkout@v2
-      - run: sudo apt-get -yqq install libxml2-dev libxslt-dev
-        if: startsWith(matrix.ruby-version, 'truffleruby')
+      - name: Install libxslt and libxml2
+        run: sudo apt-get install libxslt-dev libxml2-dev
       - name: Set up Ruby ${{ matrix.ruby-version }}
         uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby-version }}
           bundler-cache: true
+      - name: Install dependencies
+        run: bundle install
       - name: Run tests
         run: bundle exec rake

From b4076ac231cac0802548284e2f2ac314c50f3c5c Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Sat, 4 Jun 2022 10:52:09 -0700
Subject: [PATCH 29/64] update README

---
 README.md                                     | 103 ++++++++++--------
 bin/html-pipeline                             |  78 -------------
 lib/html_pipeline.rb                          |  40 ++++++-
 .../node_filter/mention_filter_test.rb        |   3 +-
 .../table_of_contents_filter_test.rb          |   2 +-
 .../node_filter/team_mention_filter_test.rb   |   3 +-
 test/html_pipeline_test.rb                    |  31 ++++--
 7 files changed, 120 insertions(+), 140 deletions(-)
 delete mode 100755 bin/html-pipeline

diff --git a/README.md b/README.md
index f4fce739..f28e299b 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# HTMLPipeline [![Build Status](https://travis-ci.org/jch/html-pipeline.svg?branch=master)](https://travis-ci.org/jch/html-pipeline)
+# HTMLPipeline
 
 HTML processing filters and utilities. This module includes a small
 framework for defining DOM based content filters and applying them to user
@@ -13,7 +13,7 @@ provided content.
 - [Dependencies](#dependencies)
 - [Documentation](#documentation)
 - [Extending](#extending)
-  - [3rd Party Extensions](#3rd-party-extensions)
+  - [Third Party Extensions](#third-party-extensions)
 - [Instrumenting](#instrumenting)
 - [Contributing](#contributing)
   - [Contributors](#contributors)
@@ -42,29 +42,39 @@ $ gem install html-pipeline
 ## Usage
 
 This library provides a handful of chainable HTML filters to transform user
-content into markup. A filter takes an HTML string or
-`Nokogiri::HTML::DocumentFragment`, optionally manipulates it, and then
-outputs the result.
+content into markup. There are two kinds of filters:
+
+* Text filters, which take a regular string
+* Node filters, which operates on a `Nokogiri::HTML::DocumentFragment`
+
+You can choose to call filters individually, or as part of a sequence called a pipeline.
 
 For example, to transform Markdown source into Markdown HTML:
 
 ```ruby
 require 'html/pipeline'
 
-filter = HTMLPipeline::MarkdownFilter.new("Hi **world**!")
-filter.call
+filter = HTMLPipeline::NodeFilter::MarkdownFilter.new("Hi **world**!")
+filter.call # returns "Hi <strong>world</strong>!"
 ```
 
-Filters can be combined into a pipeline which causes each filter to hand its
-output to the next filter's input. So if you wanted to have content be
-filtered through Markdown and be syntax highlighted, you can create the
+Filters combine into a pipeline, and each filter hands its
+output to the next filter's input sequentially. Text filters are
+processed first—the last text filter should generate HTML—before handing
+off to the node filters.
+
+If you wanted to have text content
+filtered through Markdown and the resulting HTML syntax highlighted, you can create the
 following pipeline:
 
 ```ruby
-pipeline = HTMLPipeline.new [
-  HTMLPipeline::MarkdownFilter,
-  HTMLPipeline::SyntaxHighlightFilter
-]
+pipeline = HTMLPipeline.new
+  text_filters: [
+    HTMLPipeline::MarkdownFilter,
+  ],
+  node_filters: [
+    HTMLPipeline::SyntaxHighlightFilter
+  ]
 result = pipeline.call <<-CODE
 This is *great*:
 
@@ -87,25 +97,25 @@ To generate CSS for HTML formatted code, use the [Rouge CSS Theme](https://githu
 
 Some filters take an optional **context** and/or **result** hash. These are
 used to pass around arguments and metadata between filters in a pipeline. For
-example, if you don't want to use GitHub formatted Markdown, you can pass an
+example, if you don't want to use GitHub Formatted Markdown, you can pass an
 option in the context hash:
 
 ```ruby
-filter = HTMLPipeline::MarkdownFilter.new("Hi **world**!", :gfm => false)
+filter = HTMLPipeline::TextFilter::MarkdownFilter.new("Hi **world**!", gfm: false)
 filter.call
 ```
 
 ### Examples
 
-We define different pipelines for different parts of our app. Here are a few
+Different pipelines can be defined for different parts of an app. Here are a few
 paraphrased snippets to get you started:
 
 ```ruby
 # The context hash is how you pass options between different filters.
 # See individual filter source for explanation of options.
 context = {
-  :asset_root => "http://your-domain.com/where/your/images/live/icons",
-  :base_url   => "http://your-domain.com"
+  asset_root: "http://your-domain.com/where/your/images/live/icons",
+  base_url: "http://your-domain.com"
 }
 
 # Pipeline providing sanitization and image hijacking but no mention
@@ -128,12 +138,12 @@ MarkdownPipeline = Pipeline.new [
   MentionFilter,
   EmojiFilter,
   SyntaxHighlightFilter
-], context.merge(:gfm => true) # enable github formatted markdown
+], context.merge(gfm: true) # enable github formatted markdown
 
 
 # Define a pipeline based on another pipeline's filters
 NonGFMMarkdownPipeline = Pipeline.new(MarkdownPipeline.filters,
-  context.merge(:gfm => false))
+  context.merge(gfm: false))
 
 # Pipelines aren't limited to the web. You can use them for email
 # processing also.
@@ -151,18 +161,25 @@ EmojiPipeline = Pipeline.new [
 
 ## Filters
 
-* `MentionFilter` - replace `@user` mentions with links
-* `TeamMentionFilter` - replace `@org/team` mentions with links
-* `AbsoluteSourceFilter` - replace relative image urls with fully qualified versions
+### TextFilters
+
 * `AutolinkFilter` - auto_linking urls in HTML
-* `EmojiFilter` - everyone loves [emoji](http://www.emoji-cheat-sheet.com/)!
-* `HttpsFilter` - HTML Filter for replacing http github urls with https versions.
-* `ImageMaxWidthFilter` - link to full size image for large images
+* `ImageFilter` - converts image `url` into `<img>` tag
 * `MarkdownFilter` - convert markdown to html
-* `PlainTextInputFilter` - html escape text and wrap the result in a div
+* `PlainTextInputFilter` - html escape text and wrap the result in a `<div>`
+
+
+### NodeFilters
+
+* `AbsoluteSourceFilter` - replace relative image urls with fully qualified versions
+* `EmojiFilter` - converts `:<emoji>:` to [emoji](http://www.emoji-cheat-sheet.com/)!
+* `HttpsFilter` - Replacing http urls with https versions
+* `ImageMaxWidthFilter` - link to full size image for large images
+* `MentionFilter` - replace `@user` mentions with links
 * `SanitizationFilter` - allow sanitize user markup
 * `SyntaxHighlightFilter` - code syntax highlighter
 * `TableOfContentsFilter` - anchor headings with name attributes and generate Table of Contents html unordered list linking headings
+* `TeamMentionFilter` - replace `@org/team` mentions with links
 
 ## Dependencies
 
@@ -184,22 +201,23 @@ gem 'rouge'
 * `SyntaxHighlightFilter` - `rouge`
 * `TableOfContentsFilter` - `escape_utils`
 
-_Note:_ See [Gemfile](/Gemfile) `:test` block for version requirements.
+_Note:_ See the [Gemfile](/Gemfile) `:test` group for version requirements.
 
 ## Documentation
 
 Full reference documentation can be [found here](http://rubydoc.info/gems/html-pipeline/frames).
 
 ## Extending
+
 To write a custom filter, you need a class with a `call` method that inherits
-from `HTMLPipeline::Filter`.
+from either `HTMLPipeline::TextFilter` or  `HTMLPipeline::NodeFilter`.
 
 For example this filter adds a base url to images that are root relative:
 
 ```ruby
 require 'uri'
 
-class RootRelativeFilter < HTMLPipeline::Filter
+class RootRelativeFilter < HTMLPipeline::NodeFilter
 
   def call
     doc.search("img").each do |img|
@@ -218,13 +236,13 @@ end
 Now this filter can be used in a pipeline:
 
 ```ruby
-Pipeline.new [ RootRelativeFilter ], { :base_url => 'http://somehost.com' }
+Pipeline.new node_filters: [ RootRelativeFilter ], { :base_url => 'http://somehost.com' }
 ```
 
-### 3rd Party Extensions
+### Third Party Extensions
 
 If you have an idea for a filter, propose it as
-[an issue](https://github.com/jch/html-pipeline/issues) first. This allows us discuss
+[an issue](https://github.com/gjtorikian/html-pipeline/issues) first. This allows us discuss
 whether the filter is a common enough use case to belong in this gem, or should be
 built as an external gem.
 
@@ -273,8 +291,9 @@ pipeline.setup_instrumentation "MarkdownPipeline"
 ```
 
 Filters are instrumented when they are run through the pipeline. A
-`call_filter.html_pipeline` event is published once the filter finishes. The
-`payload` should include the `filter` name. Each filter will trigger its own
+`call_filter.html_pipeline` event is published once any filter finishes; `call_text_filters`
+and `call_node_filters` is published when all of the text and node filters are finished, respectively.
+The `payload` should include the `filter` name. Each filter will trigger its own
 instrumentation call.
 
 ``` ruby
@@ -290,7 +309,7 @@ end
 The full pipeline is also instrumented:
 
 ``` ruby
-service.subscribe "call_pipeline.html_pipeline" do |event, start, ending, transaction_id, payload|
+service.subscribe "call_text_filters.html_pipeline" do |event, start, ending, transaction_id, payload|
   payload[:pipeline] #=> "MarkdownPipeline", set with `setup_instrumentation`
   payload[:filters] #=> ["MarkdownFilter"]
   payload[:doc] #=> HTML String or Nokogiri::DocumentFragment
@@ -332,7 +351,7 @@ re-define your own constant and pass that in via the context.
 
 ## Contributing
 
-Please review the [Contributing Guide](https://github.com/jch/html-pipeline/blob/master/CONTRIBUTING.md).
+Please review the [Contributing Guide](https://github.com/gjtorikian/html-pipeline/blob/master/CONTRIBUTING.md).
 
 1. [Fork it](https://help.github.com/articles/fork-a-repo)
 2. Create your feature branch (`git checkout -b my-new-feature`)
@@ -340,15 +359,13 @@ Please review the [Contributing Guide](https://github.com/jch/html-pipeline/blob
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create new [Pull Request](https://help.github.com/articles/using-pull-requests)
 
-To see what has changed in recent versions, see the [CHANGELOG](https://github.com/jch/html-pipeline/blob/master/CHANGELOG.md).
+To see what has changed in recent versions, see the [CHANGELOG](https://github.com/gjtorikian/html-pipeline/blob/master/CHANGELOG.md).
 
 ### Contributors
 
-Thanks to all of [these contributors](https://github.com/jch/html-pipeline/graphs/contributors).
-
-Project is a member of the [OSS Manifesto](http://ossmanifesto.org/).
+Thanks to all of [these contributors](https://github.com/gjtorikian/html-pipeline/graphs/contributors).
 
-The current maintainer is @gjtorikian
+This project is a member of the [OSS Manifesto](http://ossmanifesto.org/).
 
 ### Releasing A New Version
 
diff --git a/bin/html-pipeline b/bin/html-pipeline
deleted file mode 100755
index 536f84a3..00000000
--- a/bin/html-pipeline
+++ /dev/null
@@ -1,78 +0,0 @@
-#!/usr/bin/env ruby
-require 'html/pipeline'
-
-require 'optparse'
-
-# Accept "help", too
-.map! { |a| a == 'help' ? '--help' : a }
-
-onParser.new do |opts|
-  opts.banner = <<-HELP.gsub(/^    /, '')
-    Usage: html-pipeline [-h] [-f]
-           html-pipeline [FILTER [FILTER [...]]] < file.md
-       cat file.md | html-pipeline [FILTER [FILTER [...]]]
-  HELP
-
- opts.separator 'Options:'
-
-  opts.on('-f', '--filters', 'List the available filters') do
-    filters = HTMLPipeline.constants.grep(/\w+Filter$/)
-                            .map { |f| f.to_s.gsub(/Filter$/, '') }
-
-    # Text filter doesn't work, no call method
-    filters -= ['Text']
-
-    abort <<-HELP.gsub(/^      /, '')
-      Available filters:
-        #{filters.join("\n        ")}
-    HELP
-  end
-end.parse!
-
-# Default to a GitHub-ish pipeline
-if ARGV.empty?
-
-  filters = [
-    HTMLPipeline::MarkdownFilter,
-    HTMLPipeline::SanitizationFilter,
-    HTMLPipeline::ImageMaxWidthFilter,
-    HTMLPipeline::EmojiFilter,
-    HTMLPipeline::AutolinkFilter,
-    HTMLPipeline::TableOfContentsFilter
-  ]
-
-  # Add syntax highlighting if rouge is present
-  begin
-    require 'rouge'
-    filters << HTMLPipeline::SyntaxHighlightFilter
-  rescue LoadError
-  end
-
-else
-
-  def filter_named(name)
-    case name
-    when 'Text'
-      raise NameError # Text filter doesn't work, no call method
-    end
-
-    HTMLPipeline.const_get("#{name}Filter")
-  rescue NameError => e
-    abort "Unknown filter '#{name}'. List filters with the -f option."
-  end
-
-  filters = []
-  until ARGV.empty?
-    name = ARGV.shift
-    filters << filter_named(name)
-  end
-
-end
-
-context = {
-  asset_root: '/assets',
-  base_url: '/',
-  gfm: true
-}
-
-puts HTMLPipeline.new(filters, context).call(ARGF.read)[:output]
diff --git a/lib/html_pipeline.rb b/lib/html_pipeline.rb
index e2f0a907..a6a2ed72 100644
--- a/lib/html_pipeline.rb
+++ b/lib/html_pipeline.rb
@@ -33,6 +33,7 @@ class HTMLPipeline
   #                   calls.  Default: Hash.  Protip:  Pass in a Struct to get
   #                   some semblance of type safety.
   class MissingDependencyError < RuntimeError; end
+  class InvalidFilterError < ArgumentError; end
 
   def self.require_dependency(name, requirer)
     require name
@@ -89,7 +90,7 @@ def self.parse(document_or_html)
   end
 
   # Public: Returns an Array of Filter objects for this Pipeline.
-  attr_reader :filters
+  attr_reader :text_filters, :node_filters
 
   # Public: Instrumentation service for the pipeline.
   # Set an ActiveSupport::Notifications compatible object to enable.
@@ -109,10 +110,15 @@ class << self
     attr_accessor :default_instrumentation_service
   end
 
-  def initialize(filters, default_context: {}, result_class: Hash)
+  def initialize(text_filters: [], node_filters: [], default_context: {}, result_class: Hash)
     raise ArgumentError, "default_context cannot be nil" if default_context.nil?
 
-    @filters = filters.flatten.freeze
+    @text_filters = text_filters.flatten.freeze
+    validate_filter(@text_filters, HTMLPipeline::TextFilter)
+
+    @node_filters = node_filters.flatten.freeze
+    validate_filter(@node_filters, HTMLPipeline::NodeFilter)
+
     @default_context = default_context.freeze
     @result_class = result_class
     @instrumentation_service = self.class.default_instrumentation_service
@@ -134,14 +140,25 @@ def call(html, context: {}, result: {})
     context = @default_context.merge(context)
     context = context.freeze
     result ||= @result_class.new
-    payload = default_payload({ filters: @filters.map(&:name),
+
+    payload = default_payload({ text_filters: @text_filters.map(&:name),
                                 context: context, result: result, })
-    instrument("call_pipeline.html_pipeline", payload) do
+    instrument("call_text_filters.html_pipeline", payload) do
+      result[:output] =
+        @text_filters.inject(html) do |doc, filter|
+          perform_filter(filter, doc, context: context, result: result)
+        end
+    end
+
+    payload = default_payload({ node_filters: @node_filters.map(&:name),
+      context: context, result: result, })
+    instrument("call_node_filters.html_pipeline", payload) do
       result[:output] =
-        @filters.inject(html) do |doc, filter|
+        @node_filters.inject(result[:output]) do |doc, filter|
           perform_filter(filter, doc, context: context, result: result)
         end
     end
+
     result
   end
 
@@ -205,4 +222,15 @@ def instrument(event, payload = {}, &block)
   def default_payload(payload = {})
     { pipeline: instrumentation_name }.merge(payload)
   end
+
+  private def validate_filter(filters, klass)
+    return if filters.nil? || filters.empty?
+
+    invalid_filters = filters.select { |f| !f.ancestors.include?(klass) }
+
+    unless invalid_filters.empty?
+      verb = invalid_filters.count == 1 ? "is" : "are"
+      raise InvalidFilterError, "All filters must be #{klass} objects; #{invalid_filters.join(", ")} #{verb} not"
+    end
+  end
 end
diff --git a/test/html_pipeline/node_filter/mention_filter_test.rb b/test/html_pipeline/node_filter/mention_filter_test.rb
index fa5fa4d7..0bdc3514 100644
--- a/test/html_pipeline/node_filter/mention_filter_test.rb
+++ b/test/html_pipeline/node_filter/mention_filter_test.rb
@@ -8,8 +8,9 @@ def setup
       @filter = HTMLPipeline::NodeFilter::MentionFilter
       @context = { base_url: "/", info_url: nil, username_pattern: nil }
 
-      @pipeline = HTMLPipeline.new([
+      @pipeline = HTMLPipeline.new(text_filters: [
         HTMLPipeline::TextFilter::MarkdownFilter,
+      ], node_filters: [
         HTMLPipeline::NodeFilter::MentionFilter,
       ])
     end
diff --git a/test/html_pipeline/node_filter/table_of_contents_filter_test.rb b/test/html_pipeline/node_filter/table_of_contents_filter_test.rb
index f5c36d44..3716fb6f 100644
--- a/test/html_pipeline/node_filter/table_of_contents_filter_test.rb
+++ b/test/html_pipeline/node_filter/table_of_contents_filter_test.rb
@@ -8,7 +8,7 @@ class TableOfContentsFilterTest < Minitest::Test
       TocFilter = HTMLPipeline::NodeFilter::TableOfContentsFilter
 
       TocPipeline =
-        HTMLPipeline.new([
+        HTMLPipeline.new(node_filters: [
           TocFilter,
         ])
 
diff --git a/test/html_pipeline/node_filter/team_mention_filter_test.rb b/test/html_pipeline/node_filter/team_mention_filter_test.rb
index 349eebdc..710a421e 100644
--- a/test/html_pipeline/node_filter/team_mention_filter_test.rb
+++ b/test/html_pipeline/node_filter/team_mention_filter_test.rb
@@ -8,8 +8,9 @@ def setup
       @filter = HTMLPipeline::NodeFilter::TeamMentionFilter
 
       @pipeline =
-        HTMLPipeline.new([
+        HTMLPipeline.new(text_filters: [
           HTMLPipeline::TextFilter::MarkdownFilter,
+        ], node_filters: [
           HTMLPipeline::NodeFilter::TeamMentionFilter,
         ])
     end
diff --git a/test/html_pipeline_test.rb b/test/html_pipeline_test.rb
index 1e74a23c..f354ae9c 100644
--- a/test/html_pipeline_test.rb
+++ b/test/html_pipeline_test.rb
@@ -4,8 +4,7 @@
 require "helpers/mocked_instrumentation_service"
 
 class HTMLPipelineTest < Minitest::Test
-  Pipeline = HTMLPipeline
-  class TestFilter
+  class TestFilter < HTMLPipeline::TextFilter
     def self.call(input, context: {}, result: {})
       input.reverse
     end
@@ -14,7 +13,7 @@ def self.call(input, context: {}, result: {})
   def setup
     @default_context = {}
     @result_class = Hash
-    @pipeline = Pipeline.new([TestFilter], default_context: @default_context, result_class: @result_class)
+    @pipeline = HTMLPipeline.new(text_filters: [TestFilter], default_context: @default_context, result_class: @result_class)
   end
 
   def test_filter_instrumentation
@@ -33,32 +32,32 @@ def test_filter_instrumentation
 
   def test_pipeline_instrumentation
     service = MockedInstrumentationService.new
-    events = service.subscribe("call_pipeline.html_pipeline")
+    events = service.subscribe("call_text_filters.html_pipeline")
     @pipeline.instrumentation_service = service
     body = "hello"
     @pipeline.call(body)
     event, payload, = events.pop
     assert(event, "event expected")
-    assert_equal("call_pipeline.html_pipeline", event)
-    assert_equal(@pipeline.filters.map(&:name), payload[:filters])
+    assert_equal("call_text_filters.html_pipeline", event)
+    assert_equal(@pipeline.text_filters.map(&:name), payload[:text_filters])
     assert_equal(@pipeline.class.name, payload[:pipeline])
     assert_equal(body.reverse, payload[:result][:output])
   end
 
   def test_default_instrumentation_service
     service = "default"
-    Pipeline.default_instrumentation_service = service
-    pipeline = Pipeline.new([], default_context: @default_context, result_class: @result_class)
+    HTMLPipeline.default_instrumentation_service = service
+    pipeline = HTMLPipeline.new(text_filters: [], default_context: @default_context, result_class: @result_class)
     assert_equal(service, pipeline.instrumentation_service)
   ensure
-    Pipeline.default_instrumentation_service = nil
+    HTMLPipeline.default_instrumentation_service = nil
   end
 
   def test_setup_instrumentation
     assert_nil(@pipeline.instrumentation_service)
 
     service = MockedInstrumentationService.new
-    events = service.subscribe("call_pipeline.html_pipeline")
+    events = service.subscribe("call_text_filters.html_pipeline")
     name = "foo"
     @pipeline.setup_instrumentation(name, service: service)
 
@@ -73,4 +72,16 @@ def test_setup_instrumentation
     assert_equal(name, payload[:pipeline])
     assert_equal(body.reverse, payload[:result][:output])
   end
+
+  def test_incorrect_text_filters
+    assert_raises(HTMLPipeline::InvalidFilterError) do
+      HTMLPipeline.new(text_filters: [HTMLPipeline::NodeFilter::SyntaxHighlightFilter], default_context: @default_context, result_class: @result_class)
+    end
+  end
+
+  def test_incorrect_node_filters
+    assert_raises(HTMLPipeline::InvalidFilterError) do
+      HTMLPipeline.new(node_filters: [HTMLPipeline::TextFilter::MarkdownFilter], default_context: @default_context, result_class: @result_class)
+    end
+  end
 end

From 57e6c8a1db3fe4c5a22561678a78b8ecc2ceee6a Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Mon, 6 Jun 2022 13:14:06 -0400
Subject: [PATCH 30/64] update sanitization

---
 README.md                                     |  64 +++++++++-
 html-pipeline.gemspec                         |   4 +-
 lib/html_pipeline.rb                          |  27 +++-
 .../node_filter/sanitization_filter.rb        | 113 -----------------
 lib/html_pipeline/sanitization_filter.rb      |  88 +++++++++++++
 .../sanitization_filter_test.rb               | 117 ++++++++++++------
 6 files changed, 255 insertions(+), 158 deletions(-)
 delete mode 100644 lib/html_pipeline/node_filter/sanitization_filter.rb
 create mode 100644 lib/html_pipeline/sanitization_filter.rb
 rename test/{html_pipeline/node_filter => }/sanitization_filter_test.rb (56%)

diff --git a/README.md b/README.md
index f28e299b..452702db 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,7 @@ provided content.
 - [Usage](#usage)
   - [Examples](#examples)
 - [Filters](#filters)
+- [Sanitization](#sanitization)
 - [Dependencies](#dependencies)
 - [Documentation](#documentation)
 - [Extending](#extending)
@@ -54,7 +55,7 @@ For example, to transform Markdown source into Markdown HTML:
 ```ruby
 require 'html/pipeline'
 
-filter = HTMLPipeline::NodeFilter::MarkdownFilter.new("Hi **world**!")
+filter = HTMLPipeline::TextFilter::MarkdownFilter.new("Hi **world**!")
 filter.call # returns "Hi <strong>world</strong>!"
 ```
 
@@ -68,12 +69,12 @@ filtered through Markdown and the resulting HTML syntax highlighted, you can cre
 following pipeline:
 
 ```ruby
-pipeline = HTMLPipeline.new
+pipeline = HTMLPipeline.new \
   text_filters: [
-    HTMLPipeline::MarkdownFilter,
+    HTMLPipeline::TextFilter::MarkdownFilter,
   ],
   node_filters: [
-    HTMLPipeline::SyntaxHighlightFilter
+    HTMLPipeline::NodeFilter::SyntaxHighlightFilter
   ]
 result = pipeline.call <<-CODE
 This is *great*:
@@ -181,6 +182,61 @@ EmojiPipeline = Pipeline.new [
 * `TableOfContentsFilter` - anchor headings with name attributes and generate Table of Contents html unordered list linking headings
 * `TeamMentionFilter` - replace `@org/team` mentions with links
 
+## Sanitization
+
+Because the web is a scary place, HTML is automatically sanitized after the text filters
+are processed and before the node filters are processed. This is to prevent malicious or
+unexpected input from entering the pipeline.
+
+The sanitization process takes a hash configuration of settings. See the [selma]
+documentation for more information.
+
+A sample custom sanitization allowlist might look like this:
+
+```ruby
+ALLOWLIST = {
+  elements: ["p", "pre", "code"]
+}
+
+pipeline = HTMLPipeline.new \
+  text_filters: [
+    HTMLPipeline::MarkdownFilter,
+  ],
+  sanitization_config: ALLOWLIST,
+  node_filters: [
+    HTMLPipeline::SyntaxHighlightFilter
+  ]
+result = pipeline.call <<-CODE
+This is *great*:
+
+    some_code(:first)
+
+CODE
+result[:output].to_s
+```
+
+This would print:
+
+```html
+<p>This is great:</p>
+<pre><code>some_code(:first)
+</code></pre>
+```
+
+Sanitization can be disabled if and only if `nil` is explicitly passed as
+the config:
+
+```ruby
+pipeline = HTMLPipeline.new \
+  text_filters: [
+    HTMLPipeline::MarkdownFilter,
+  ],
+  sanitization_config: nil, # disable sanitization
+  node_filters: [
+    HTMLPipeline::SyntaxHighlightFilter
+  ]
+```
+
 ## Dependencies
 
 Filter gem dependencies are not bundled; you must bundle the filter's gem
diff --git a/html-pipeline.gemspec b/html-pipeline.gemspec
index 28a8ba4a..a84cff84 100644
--- a/html-pipeline.gemspec
+++ b/html-pipeline.gemspec
@@ -26,12 +26,14 @@ Gem::Specification.new do |gem|
   gem.add_dependency("nokogiri", "~> 1.11")
   gem.add_dependency("zeitwerk", "~> 2.5")
 
+  gem.add_development_dependency("debug") if "#{RbConfig::CONFIG["MAJOR"]}.#{RbConfig::CONFIG["MINOR"]}".to_f >= 3.1
+
   gem.post_install_message = <<~MSG
     -------------------------------------------------
     Thank you for installing html-pipeline!
     You must bundle Filter gem dependencies.
     See html-pipeline README.md for more details.
-    https://github.com/jch/html-pipeline#dependencies
+    https://github.com/gjtorikian/html-pipeline#dependencies
     -------------------------------------------------
   MSG
 end
diff --git a/lib/html_pipeline.rb b/lib/html_pipeline.rb
index a6a2ed72..a597e261 100644
--- a/lib/html_pipeline.rb
+++ b/lib/html_pipeline.rb
@@ -11,6 +11,8 @@
 gem_loader.ignore(File.join(lib_dir, "html-pipeline.rb"))
 gem_loader.setup
 
+# require "debug"
+
 class HTMLPipeline
   # HTML processing filters and utilities. This module includes a small
   # framework for defining DOM based content filters and applying them to user
@@ -92,6 +94,9 @@ def self.parse(document_or_html)
   # Public: Returns an Array of Filter objects for this Pipeline.
   attr_reader :text_filters, :node_filters
 
+  # Public: A hash representing the sanitization configuration settings
+  attr_reader :sanitization_config
+
   # Public: Instrumentation service for the pipeline.
   # Set an ActiveSupport::Notifications compatible object to enable.
   attr_accessor :instrumentation_service
@@ -110,7 +115,7 @@ class << self
     attr_accessor :default_instrumentation_service
   end
 
-  def initialize(text_filters: [], node_filters: [], default_context: {}, result_class: Hash)
+  def initialize(text_filters: [], sanitization_config: {}, node_filters: [], default_context: {}, result_class: Hash)
     raise ArgumentError, "default_context cannot be nil" if default_context.nil?
 
     @text_filters = text_filters.flatten.freeze
@@ -119,6 +124,14 @@ def initialize(text_filters: [], node_filters: [], default_context: {}, result_c
     @node_filters = node_filters.flatten.freeze
     validate_filter(@node_filters, HTMLPipeline::NodeFilter)
 
+    @sanitization_config = unless sanitization_config.nil?
+      if sanitization_config.empty?
+        SanitizationFilter::DEFAULT_CONFIG
+      else
+        sanitization_config
+      end
+    end
+
     @default_context = default_context.freeze
     @result_class = result_class
     @instrumentation_service = self.class.default_instrumentation_service
@@ -136,7 +149,7 @@ def initialize(text_filters: [], node_filters: [], default_context: {}, result_c
   # Returns the result Hash after being filtered by this Pipeline.  Contains an
   # :output key with the DocumentFragment or String HTML markup based on the
   # output of the last filter in the pipeline.
-  def call(html, context: {}, result: {})
+  def call(text, context: {}, result: {})
     context = @default_context.merge(context)
     context = context.freeze
     result ||= @result_class.new
@@ -145,16 +158,22 @@ def call(html, context: {}, result: {})
                                 context: context, result: result, })
     instrument("call_text_filters.html_pipeline", payload) do
       result[:output] =
-        @text_filters.inject(html) do |doc, filter|
+        @text_filters.inject(text) do |doc, filter|
           perform_filter(filter, doc, context: context, result: result)
         end
     end
 
+    html = HTMLPipeline.parse(result[:output])
+
+    unless @sanitization_config.nil?
+      html = SanitizationFilter.new(html, @sanitization_config).call.to_s
+    end
+
     payload = default_payload({ node_filters: @node_filters.map(&:name),
       context: context, result: result, })
     instrument("call_node_filters.html_pipeline", payload) do
       result[:output] =
-        @node_filters.inject(result[:output]) do |doc, filter|
+        @node_filters.inject(html) do |doc, filter|
           perform_filter(filter, doc, context: context, result: result)
         end
     end
diff --git a/lib/html_pipeline/node_filter/sanitization_filter.rb b/lib/html_pipeline/node_filter/sanitization_filter.rb
deleted file mode 100644
index cf60b131..00000000
--- a/lib/html_pipeline/node_filter/sanitization_filter.rb
+++ /dev/null
@@ -1,113 +0,0 @@
-# frozen_string_literal: true
-
-HTMLPipeline.require_dependency("sanitize", "SanitizationFilter")
-
-class HTMLPipeline
-  class NodeFilter
-    # HTML filter with sanization routines and allowlists. This module defines
-    # what HTML is allowed in user provided content and fixes up issues with
-    # unbalanced tags and whatnot.
-    #
-    # See the Sanitize docs for more information on the underlying library:
-    #
-    # https://github.com/rgrove/sanitize/#readme
-    #
-    # Context options:
-    #   :allowlist      - The sanitizer allowlist configuration to use. This
-    #                     can be one of the options constants defined in this
-    #                     class or a custom sanitize options hash.
-    #   :anchor_schemes - The URL schemes to allow in <a href> attributes. The
-    #                     default set is provided in the ANCHOR_SCHEMES
-    #                     constant in this class. If passed, this overrides any
-    #                     schemes specified in the allowlist configuration.
-    #
-    # This filter does not write additional information to the context.
-    class SanitizationFilter < NodeFilter
-      LISTS     = Set.new(["ul", "ol"].freeze)
-      LIST_ITEM = "li"
-
-      # List of table child elements. These must be contained by a <table> element
-      # or they are not allowed through. Otherwise they can be used to break out
-      # of places we're using tables to contain formatted user content (like pull
-      # request review comments).
-      TABLE_ITEMS = Set.new(["tr", "td", "th"].freeze)
-      TABLE = "table"
-      TABLE_SECTIONS = Set.new(["thead", "tbody", "tfoot"].freeze)
-
-      # These schemes are the only ones allowed in <a href> attributes by default.
-      ANCHOR_SCHEMES = ["http", "https", "mailto", "xmpp", :relative, "github-windows", "github-mac", "irc", "ircs"].freeze
-
-      # The main sanitization allowlist. Only these elements and attributes are
-      # allowed through by default.
-      ALLOWLIST = {
-        elements: ["h1", "h2", "h3", "h4", "h5", "h6", "h7", "h8", "br", "b", "i", "strong", "em", "a", "pre", "code", "img", "tt", "div", "ins", "del", "sup", "sub", "p", "ol", "ul", "table", "thead", "tbody", "tfoot", "blockquote", "dl", "dt", "dd", "kbd", "q", "samp", "var", "hr", "ruby", "rt", "rp", "li", "tr", "td", "th", "s", "strike", "summary", "details", "caption", "figure", "figcaption", "abbr", "bdo", "cite", "dfn", "mark", "small", "span", "time", "wbr"].freeze,
-        remove_contents: ["script"].freeze,
-        attributes: {
-          "a" => ["href"].freeze,
-          "img" => ["src", "longdesc"].freeze,
-          "div" => ["itemscope", "itemtype"].freeze,
-          "blockquote" => ["cite"].freeze,
-          "del" => ["cite"].freeze,
-          "ins" => ["cite"].freeze,
-          "q" => ["cite"].freeze,
-          all: ["abbr", "accept", "accept-charset", "accesskey", "action", "align", "alt", "aria-describedby", "aria-hidden", "aria-label", "aria-labelledby", "axis", "border", "cellpadding", "cellspacing", "char", "charoff", "charset", "checked", "clear", "cols", "colspan", "color", "compact", "coords", "datetime", "dir", "disabled", "enctype", "for", "frame", "headers", "height", "hreflang", "hspace", "ismap", "label", "lang", "maxlength", "media", "method", "multiple", "name", "nohref", "noshade", "nowrap", "open", "progress", "prompt", "readonly", "rel", "rev", "role", "rows", "rowspan", "rules", "scope", "selected", "shape", "size", "span", "start", "summary", "tabindex", "target", "title", "type", "usemap", "valign", "value", "vspace", "width", "itemprop"].freeze,
-        }.freeze,
-        protocols: {
-          "a" => { "href" => ANCHOR_SCHEMES }.freeze,
-          "blockquote" => { "cite" => ["http", "https", :relative].freeze },
-          "del" => { "cite" => ["http", "https", :relative].freeze },
-          "ins" => { "cite" => ["http", "https", :relative].freeze },
-          "q" => { "cite" => ["http", "https", :relative].freeze },
-          "img" => {
-            "src" => ["http", "https", :relative].freeze,
-            "longdesc" => ["http", "https", :relative].freeze,
-          }.freeze,
-        },
-        transformers: [
-          # Top-level <li> elements are removed because they can break out of
-          # containing markup.
-          lambda { |env|
-            name = env[:node_name]
-            node = env[:node]
-            node.replace(node.children) if name == LIST_ITEM && node.ancestors.none? { |n| LISTS.include?(n.name) }
-          },
-
-          # Table child elements that are not contained by a <table> are removed.
-          lambda { |env|
-            name = env[:node_name]
-            node = env[:node]
-            node.replace(node.children) if (TABLE_SECTIONS.include?(name) || TABLE_ITEMS.include?(name)) && node.ancestors.none? { |n| n.name == TABLE }
-          },
-        ].freeze,
-      }.freeze
-
-      # A more limited sanitization allowlist. This includes all attributes,
-      # protocols, and transformers from ALLOWLIST but with a more locked down
-      # set of allowed elements.
-      LIMITED = ALLOWLIST.merge(
-        elements: ["b", "i", "strong", "em", "a", "pre", "code", "img", "ins", "del", "sup", "sub", "mark", "abbr", "p", "ol", "ul", "li"]
-      )
-
-      # Strip all HTML tags from the document.
-      FULL = { elements: [] }.freeze
-
-      # Sanitize markup using the Sanitize library.
-      def call
-        Sanitize.clean_node!(doc, allowlist)
-      end
-
-      # The allowlist to use when sanitizing. This can be passed in the context
-      # hash to the filter but defaults to ALLOWLIST constant value above.
-      def allowlist
-        allowlist = context[:allowlist] || ALLOWLIST
-        anchor_schemes = context[:anchor_schemes]
-        return allowlist unless anchor_schemes
-
-        allowlist = allowlist.dup
-        allowlist[:protocols] = (allowlist[:protocols] || {}).dup
-        allowlist[:protocols]["a"] = (allowlist[:protocols]["a"] || {}).merge("href" => anchor_schemes)
-        allowlist
-      end
-    end
-  end
-end
diff --git a/lib/html_pipeline/sanitization_filter.rb b/lib/html_pipeline/sanitization_filter.rb
new file mode 100644
index 00000000..6572cc2c
--- /dev/null
+++ b/lib/html_pipeline/sanitization_filter.rb
@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+HTMLPipeline.require_dependency("sanitize", "SanitizationFilter")
+
+class HTMLPipeline
+  # A special filter with sanization routines and allowlists. This module defines
+  # what HTML is allowed in user provided content and fixes up issues with
+  # unbalanced tags and whatnot.
+  #
+  # See the Sanitize docs for more information on the underlying library:
+  #
+  # https://github.com/rgrove/sanitize/#readme
+  #
+  # This filter does not write additional information to the context.
+  class SanitizationFilter
+    LISTS     = Set.new(["ul", "ol"].freeze)
+    LIST_ITEM = "li"
+
+    # List of table child elements. These must be contained by a <table> element
+    # or they are not allowed through. Otherwise they can be used to break out
+    # of places we're using tables to contain formatted user content (like pull
+    # request review comments).
+    TABLE_ITEMS = Set.new(["tr", "td", "th"].freeze)
+    TABLE = "table"
+    TABLE_SECTIONS = Set.new(["thead", "tbody", "tfoot"].freeze)
+
+    # These schemes are the only ones allowed in <a href> attributes by default.
+    PROTOCOLS = ["http", "https", "mailto", "xmpp", :relative, "irc", "ircs"].freeze
+
+    # The main sanitization allowlist. Only these elements and attributes are
+    # allowed through by default.
+    DEFAULT_CONFIG = {
+      elements: ["h1", "h2", "h3", "h4", "h5", "h6", "h7", "h8", "br", "b", "i", "strong", "em", "a", "pre", "code", "img", "tt", "div", "ins", "del", "sup", "sub", "p", "ol", "ul", "table", "thead", "tbody", "tfoot", "blockquote", "dl", "dt", "dd", "kbd", "q", "samp", "var", "hr", "ruby", "rt", "rp", "li", "tr", "td", "th", "s", "strike", "summary", "details", "caption", "figure", "figcaption", "abbr", "bdo", "cite", "dfn", "mark", "small", "span", "time", "wbr"].freeze,
+      remove_contents: ["script"].freeze,
+      attributes: {
+        "a" => ["href"].freeze,
+        "img" => ["src", "longdesc"].freeze,
+        "div" => ["itemscope", "itemtype"].freeze,
+        "blockquote" => ["cite"].freeze,
+        "del" => ["cite"].freeze,
+        "ins" => ["cite"].freeze,
+        "q" => ["cite"].freeze,
+        all: ["abbr", "accept", "accept-charset", "accesskey", "action", "align", "alt", "aria-describedby", "aria-hidden", "aria-label", "aria-labelledby", "axis", "border", "cellpadding", "cellspacing", "char", "charoff", "charset", "checked", "clear", "cols", "colspan", "color", "compact", "coords", "datetime", "dir", "disabled", "enctype", "for", "frame", "headers", "height", "hreflang", "hspace", "ismap", "label", "lang", "maxlength", "media", "method", "multiple", "name", "nohref", "noshade", "nowrap", "open", "progress", "prompt", "readonly", "rel", "rev", "role", "rows", "rowspan", "rules", "scope", "selected", "shape", "size", "span", "start", "summary", "tabindex", "target", "title", "type", "usemap", "valign", "value", "vspace", "width", "itemprop"].freeze,
+      }.freeze,
+      protocols: {
+        "a" => { "href" => PROTOCOLS }.freeze,
+        "blockquote" => { "cite" => ["http", "https", :relative].freeze },
+        "del" => { "cite" => ["http", "https", :relative].freeze },
+        "ins" => { "cite" => ["http", "https", :relative].freeze },
+        "q" => { "cite" => ["http", "https", :relative].freeze },
+        "img" => {
+          "src" => ["http", "https", :relative].freeze,
+          "longdesc" => ["http", "https", :relative].freeze,
+        }.freeze,
+      },
+      transformers: [
+        # Top-level <li> elements are removed because they can break out of
+        # containing markup.
+        lambda { |env|
+          name = env[:node_name]
+          node = env[:node]
+          node.replace(node.children) if name == LIST_ITEM && node.ancestors.none? { |n| LISTS.include?(n.name) }
+        },
+
+        # Table child elements that are not contained by a <table> are removed.
+        lambda { |env|
+          name = env[:node_name]
+          node = env[:node]
+          node.replace(node.children) if (TABLE_SECTIONS.include?(name) || TABLE_ITEMS.include?(name)) && node.ancestors.none? { |n| n.name == TABLE }
+        },
+      ].freeze,
+    }.freeze
+
+    def initialize(doc, config)
+      @doc = HTMLPipeline.parse(doc)
+      @config = config
+    end
+
+    # Sanitize markup using the Sanitize library.
+    def call
+      Sanitize.clean_node!(@doc, @config)
+    end
+
+    def self.call(doc, config)
+      new(doc, config).call.to_s
+    end
+  end
+end
diff --git a/test/html_pipeline/node_filter/sanitization_filter_test.rb b/test/sanitization_filter_test.rb
similarity index 56%
rename from test/html_pipeline/node_filter/sanitization_filter_test.rb
rename to test/sanitization_filter_test.rb
index 06424fd6..3003bedb 100644
--- a/test/html_pipeline/node_filter/sanitization_filter_test.rb
+++ b/test/sanitization_filter_test.rb
@@ -4,78 +4,81 @@
 
 class HTMLPipeline
   class SanitizationFilterTest < Minitest::Test
-    SanitizationFilter = HTMLPipeline::NodeFilter::SanitizationFilter
+    SanitizationFilter = HTMLPipeline::SanitizationFilter
+    DEFAULT_CONFIG = SanitizationFilter::DEFAULT_CONFIG
 
     def test_removing_script_tags
       orig = %(<p><img src="http://github.com/img.png" /><script></script></p>)
-      html = SanitizationFilter.call(orig).to_s
+      html = SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s
       refute_match(/script/, html)
     end
 
     def test_removing_style_tags
       orig = %(<p><style>hey now</style></p>)
-      html = SanitizationFilter.call(orig).to_s
+      html = SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s
       refute_match(/style/, html)
     end
 
     def test_removing_style_attributes
       orig = %(<p style='font-size:1000%'>YO DAWG</p>)
-      html = SanitizationFilter.call(orig).to_s
+      html = SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s
       refute_match(/font-size/, html)
       refute_match(/style/, html)
     end
 
     def test_removing_script_event_handler_attributes
       orig = %(<a onclick='javascript:alert(0)'>YO DAWG</a>)
-      html = SanitizationFilter.call(orig).to_s
+      html = SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s
       refute_match(/javscript/, html)
       refute_match(/onclick/, html)
     end
 
     def test_sanitizes_li_elements_not_contained_in_ul_or_ol
       stuff = "a\n<li>b</li>\nc"
-      html  = SanitizationFilter.call(stuff).to_s
+      html  = SanitizationFilter.call(stuff, DEFAULT_CONFIG).to_s
       assert_equal("a\nb\nc", html)
     end
 
     def test_does_not_sanitize_li_elements_contained_in_ul_or_ol
       stuff = "a\n<ul><li>b</li></ul>\nc"
-      assert_equal(stuff, SanitizationFilter.call(stuff).to_s)
+      assert_equal(stuff, SanitizationFilter.call(stuff, DEFAULT_CONFIG).to_s)
     end
 
-    def test_github_specific_protocols_are_not_removed
+    def test_github_specific_protocols_are_removed
       stuff = '<a href="github-windows://spillthelog">Spill this yo</a> and so on'
-      assert_equal(stuff, SanitizationFilter.call(stuff).to_s)
+      assert_equal("<a>Spill this yo</a> and so on", SanitizationFilter.call(stuff, DEFAULT_CONFIG).to_s)
     end
 
     def test_unknown_schemes_are_removed
       stuff = '<a href="something-weird://heyyy">Wat</a> is this'
-      html  = SanitizationFilter.call(stuff).to_s
+      html  = SanitizationFilter.call(stuff, DEFAULT_CONFIG).to_s
       assert_equal("<a>Wat</a> is this", html)
     end
 
     def test_allowlisted_longdesc_schemes_are_allowed
       stuff = '<img src="./foo.jpg" longdesc="http://longdesc.com">'
-      html  = SanitizationFilter.call(stuff).to_s
+      html  = SanitizationFilter.call(stuff, DEFAULT_CONFIG).to_s
       assert_equal('<img src="./foo.jpg" longdesc="http://longdesc.com">', html)
     end
 
     def test_weird_longdesc_schemes_are_removed
       stuff = '<img src="./foo.jpg" longdesc="javascript:alert(1)">'
-      html  = SanitizationFilter.call(stuff).to_s
+      html  = SanitizationFilter.call(stuff, DEFAULT_CONFIG).to_s
       assert_equal('<img src="./foo.jpg">', html)
     end
 
     def test_standard_schemes_are_removed_if_not_specified_in_anchor_schemes
+      config = DEFAULT_CONFIG.merge(protocols: { "a" => { "href" => [] } })
       stuff  = '<a href="http://www.example.com/">No href for you</a>'
-      filter = SanitizationFilter.new(stuff, context: { anchor_schemes: [] })
+      filter = SanitizationFilter.new(stuff, config)
       html   = filter.call.to_s
       assert_equal("<a>No href for you</a>", html)
     end
 
     def test_custom_anchor_schemes_are_not_removed
+      config = DEFAULT_CONFIG.merge(protocols: { "a" => { "href" => ["something-weird"] } })
       stuff  = '<a href="something-weird://heyyy">Wat</a> is this'
-      filter = SanitizationFilter.new(stuff, context: { anchor_schemes: ["something-weird"] })
+      filter = SanitizationFilter.new(stuff, config)
       html   = filter.call.to_s
       assert_equal(stuff, html)
     end
@@ -87,7 +90,7 @@ def test_anchor_schemes_are_merged_with_other_anchor_restrictions
         attributes: { "a" => ["href", "ping"] },
         protocols: { "a" => { "ping" => ["http"] } },
       }
-      filter = SanitizationFilter.new(stuff, context: { allowlist: allowlist, anchor_schemes: ["something-weird"] })
+      filter = SanitizationFilter.new(stuff, allowlist)
       html   = filter.call.to_s
       assert_equal('<a href="something-weird://heyyy">Wat</a> is this', html)
     end
@@ -99,39 +102,32 @@ def test_uses_anchor_schemes_from_allowlist_when_not_separately_specified
         attributes: { "a" => ["href"] },
         protocols: { "a" => { "href" => ["something-weird"] } },
       }
-      filter = SanitizationFilter.new(stuff, context: { allowlist: allowlist })
+      filter = SanitizationFilter.new(stuff, allowlist)
       html   = filter.call.to_s
       assert_equal(stuff, html)
     end
 
     def test_allowlist_contains_default_anchor_schemes
-      assert_equal(["http", "https", "mailto", "xmpp", :relative, "github-windows", "github-mac", "irc", "ircs"], SanitizationFilter::ALLOWLIST[:protocols]["a"]["href"])
-    end
-
-    def test_allowlist_from_full_constant
-      stuff  = '<a href="something-weird://heyyy" ping="more-weird://hiii">Wat</a> is this'
-      filter = SanitizationFilter.new(stuff, context: { allowlist: SanitizationFilter::FULL })
-      html   = filter.call.to_s
-      assert_equal("Wat is this", html)
+      assert_equal(["http", "https", "mailto", "xmpp", :relative, "irc", "ircs"], SanitizationFilter::DEFAULT_CONFIG[:protocols]["a"]["href"])
     end
 
     def test_exports_default_anchor_schemes
-      assert_equal(["http", "https", "mailto", "xmpp", :relative, "github-windows", "github-mac", "irc", "ircs"], SanitizationFilter::ANCHOR_SCHEMES)
+      assert_equal(["http", "https", "mailto", "xmpp", :relative, "irc", "ircs"], SanitizationFilter::PROTOCOLS)
     end
 
     def test_script_contents_are_removed
       orig = "<script>JavaScript!</script>"
-      assert_equal("", SanitizationFilter.call(orig).to_s)
+      assert_equal("", SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s)
     end
 
     def test_table_rows_and_cells_removed_if_not_in_table
       orig = %(<tr><td>Foo</td></tr><td>Bar</td>)
-      assert_equal("FooBar", SanitizationFilter.call(orig).to_s)
+      assert_equal("FooBar", SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s)
     end
 
     def test_table_sections_removed_if_not_in_table
       orig = %(<thead><tr><td>Foo</td></tr></thead>)
-      assert_equal("Foo", SanitizationFilter.call(orig).to_s)
+      assert_equal("Foo", SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s)
     end
 
     def test_table_sections_are_not_removed
@@ -140,17 +136,17 @@ def test_table_sections_are_not_removed
 <tfoot><tr><td>Sum</td></tr></tfoot>
 <tbody><tr><td>1</td></tr></tbody>
 </table>)
-      assert_equal(orig, SanitizationFilter.call(orig).to_s)
+      assert_equal(orig, SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s)
     end
 
     def test_summary_tag_are_not_removed
       orig = %(<summary>Foo</summary>)
-      assert_equal(orig, SanitizationFilter.call(orig).to_s)
+      assert_equal(orig, SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s)
     end
 
     def test_details_tag_and_open_attribute_are_not_removed
       orig = %(<details open>Foo</details>)
-      assert_equal(orig, SanitizationFilter.call(orig).to_s)
+      assert_equal(orig, SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s)
     end
 
     def test_nested_details_tag_are_not_removed
@@ -164,14 +160,63 @@ def test_nested_details_tag_are_not_removed
         Qux
       </details>
       NESTED
-      assert_equal(orig, SanitizationFilter.call(orig).to_s)
+      assert_equal(orig, SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s)
     end
 
-    def test_allowlist_context
-      orig = %(<p><style>hey now</style></p>)
-      context = { allowlist: ["table"] }
+    def test_sanitization_pipeline_can_be_configured
+      config = {
+        elements: ["p", "pre", "code"],
+      }
 
-      assert_equal(["table"], SanitizationFilter.new(orig, context: context).allowlist)
+      pipeline = HTMLPipeline.new(\
+        text_filters: [
+          HTMLPipeline::TextFilter::MarkdownFilter,
+        ],
+        sanitization_config: config,
+        node_filters: [
+          HTMLPipeline::NodeFilter::SyntaxHighlightFilter,
+        ]
+      )
+
+      result = pipeline.call(<<~CODE)
+        This is *great*:
+
+            some_code(:first)
+      CODE
+
+      expected = <<~HTML
+        <p>This is great:</p>
+        <pre><code>some_code(:first)
+        </code></pre>
+      HTML
+
+      assert_equal(result[:output].to_s, expected.chomp)
+    end
+
+    def test_sanitization_pipeline_can_be_removed
+      pipeline = HTMLPipeline.new(\
+        text_filters: [
+          HTMLPipeline::TextFilter::MarkdownFilter,
+        ],
+        sanitization_config: nil,
+        node_filters: [
+          HTMLPipeline::NodeFilter::SyntaxHighlightFilter,
+        ]
+      )
+
+      result = pipeline.call(<<~CODE)
+        This is *great*:
+
+            some_code(:first)
+      CODE
+
+      expected = <<~HTML
+        <p>This is <em>great</em>:</p>
+        <pre><code>some_code(:first)
+        </code></pre>
+      HTML
+
+      assert_equal(result[:output].to_s, expected.chomp)
     end
   end
 end

From 441b2eb167b81c8f5e6d6175aeaed08c30979b8e Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Mon, 6 Jun 2022 13:20:47 -0400
Subject: [PATCH 31/64] lint

---
 lib/html_pipeline/node_filter/mention_filter.rb      | 2 +-
 lib/html_pipeline/node_filter/team_mention_filter.rb | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/html_pipeline/node_filter/mention_filter.rb b/lib/html_pipeline/node_filter/mention_filter.rb
index ee935d1c..87c72fe0 100644
--- a/lib/html_pipeline/node_filter/mention_filter.rb
+++ b/lib/html_pipeline/node_filter/mention_filter.rb
@@ -55,7 +55,7 @@ def self.mentioned_logins_in(text, username_pattern = USERNAME_PATTERN)
 
       # Default pattern used to extract usernames from text. The value can be
       # overriden by providing the username_pattern variable in the context.
-      USERNAME_PATTERN = /[a-z0-9][a-z0-9-]*/.freeze
+      USERNAME_PATTERN = /[a-z0-9][a-z0-9-]*/
 
       # Don't look for mentions in text nodes that are children of these elements
       IGNORE_PARENTS = ["pre", "code", "a", "style", "script"].to_set
diff --git a/lib/html_pipeline/node_filter/team_mention_filter.rb b/lib/html_pipeline/node_filter/team_mention_filter.rb
index 1f3e1d06..316d3a3a 100644
--- a/lib/html_pipeline/node_filter/team_mention_filter.rb
+++ b/lib/html_pipeline/node_filter/team_mention_filter.rb
@@ -44,7 +44,7 @@ def self.mentioned_teams_in(text, team_pattern = TEAM_PATTERN)
           /                       # dividing slash
           ([a-z0-9][a-z0-9\-_]*)   # team
           \b
-      }ix.freeze
+      }ix
 
       # Don't look for mentions in text nodes that are children of these elements
       IGNORE_PARENTS = ["pre", "code", "a", "style", "script"].to_set

From 7cbbbfc1db7d84349d9a2e0a1f7655720028da48 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Mon, 6 Jun 2022 13:23:51 -0400
Subject: [PATCH 32/64] ignore ruby-head

---
 .github/workflows/ci.yml | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 0aef6de3..c542edf0 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -17,23 +17,25 @@ jobs:
         ruby-version:
           - 3.1.0
           - 3.0.0
-        experimental: [false]
-        include:
-          - ruby-version: head
-            experimental: true
+          - ruby-head
 
     continue-on-error: ${{ matrix.experimental }}
 
     steps:
       - uses: actions/checkout@v2
+
       - name: Install libxslt and libxml2
         run: sudo apt-get install libxslt-dev libxml2-dev
+
       - name: Set up Ruby ${{ matrix.ruby-version }}
         uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby-version }}
           bundler-cache: true
+
       - name: Install dependencies
         run: bundle install
+
       - name: Run tests
         run: bundle exec rake
+        continue-on-error: ${{ matrix.ruby == 'ruby-head' }}

From c22c730dacd7955449e129bcf258f7d56076fd2b Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Mon, 6 Jun 2022 13:26:51 -0400
Subject: [PATCH 33/64] all pushes

---
 .github/workflows/ci.yml | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index c542edf0..3394316f 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -1,11 +1,7 @@
 name: Ruby CI
 
 on:
-  pull_request:
-    types: [opened, synchronize, reopened]
   push:
-    branches:
-      - main
 
 jobs:
   test:
@@ -17,6 +13,7 @@ jobs:
         ruby-version:
           - 3.1.0
           - 3.0.0
+          - 2.7.6
           - ruby-head
 
     continue-on-error: ${{ matrix.experimental }}

From debbff012c1900ac9722cdc3f405f4179ac3cb8f Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Mon, 6 Jun 2022 17:12:47 -0400
Subject: [PATCH 34/64] whoop

---
 .github/workflows/ci.yml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 3394316f..a942cf2f 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -14,7 +14,10 @@ jobs:
           - 3.1.0
           - 3.0.0
           - 2.7.6
-          - ruby-head
+        experimental: [false]
+        include:
+          - ruby-version: head
+            experimental: true
 
     continue-on-error: ${{ matrix.experimental }}
 

From 15d6de6babc7d8608aaae93df6753c3f07a29627 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Sat, 24 Dec 2022 12:41:46 -0800
Subject: [PATCH 35/64] clean up configs

---
 .github/FUNDING.yml        |  3 ---
 .github/workflows/ci.yml   | 11 +----------
 .github/workflows/lint.yml |  2 +-
 3 files changed, 2 insertions(+), 14 deletions(-)

diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
index b9b6a927..05f5e40f 100644
--- a/.github/FUNDING.yml
+++ b/.github/FUNDING.yml
@@ -1,4 +1 @@
 github: gjtorikian
-patreon: gjtorikian
-open_collective: garen-torikian
-issuehunt: gjtorikian
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index a942cf2f..96946987 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -11,15 +11,7 @@ jobs:
       fail-fast: true
       matrix:
         ruby-version:
-          - 3.1.0
-          - 3.0.0
-          - 2.7.6
-        experimental: [false]
-        include:
-          - ruby-version: head
-            experimental: true
-
-    continue-on-error: ${{ matrix.experimental }}
+          - 3.1
 
     steps:
       - uses: actions/checkout@v2
@@ -38,4 +30,3 @@ jobs:
 
       - name: Run tests
         run: bundle exec rake
-        continue-on-error: ${{ matrix.ruby == 'ruby-head' }}
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index b8a5c0ed..24fc46e6 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -15,7 +15,7 @@ jobs:
       - uses: actions/checkout@v2
       - uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 3.0
+          ruby-version: 3.1
           bundler-cache: true
       - run: bundle install
       - name: Rubocop

From 9626d700c3a0e1ea2c1c21779feace97aabd590d Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Sat, 24 Dec 2022 12:43:03 -0800
Subject: [PATCH 36/64] Migrate to Selma

---
 Gemfile                                       |  14 +-
 README.md                                     | 108 +++++-----
 html-pipeline.gemspec                         |   6 +-
 lib/html_pipeline.rb                          | 110 +++++------
 lib/html_pipeline/body_content.rb             |  12 +-
 lib/html_pipeline/convert_filter.rb           |  15 ++
 .../convert_filter/markdown_filter.rb         |  25 +++
 lib/html_pipeline/filter.rb                   |  49 ++---
 lib/html_pipeline/node_filter.rb              |  48 ++---
 .../node_filter/absolute_source_filter.rb     |  33 ++--
 lib/html_pipeline/node_filter/emoji_filter.rb |  32 +--
 lib/html_pipeline/node_filter/https_filter.rb |  17 +-
 .../node_filter/image_max_width_filter.rb     |  32 +--
 .../node_filter/mention_filter.rb             |  28 +--
 .../node_filter/syntax_highlight_filter.rb    |  47 +++--
 .../node_filter/table_of_contents_filter.rb   |  70 +++----
 .../node_filter/team_mention_filter.rb        |  32 +--
 lib/html_pipeline/sanitization_filter.rb      |  20 +-
 lib/html_pipeline/text_filter.rb              |  12 +-
 .../text_filter/markdown_filter.rb            |  55 ------
 .../text_filter/plain_text_input_filter.rb    |   2 +-
 .../convert_filter/markdown_filter_test.rb    | 132 +++++++++++++
 .../node_filter/emoji_filter_test.rb          |  84 ++++----
 .../node_filter/https_filter_test.rb          |  32 +--
 .../image_max_width_filter_test.rb            |  43 ++--
 .../node_filter/mention_filter_test.rb        |  66 +++----
 .../syntax_highlight_filter_test.rb           |  32 +--
 .../table_of_contents_filter_test.rb          | 185 +++++++++++-------
 .../node_filter/team_mention_filter_test.rb   |  58 +++---
 .../text_filter/markdown_filter_test.rb       | 180 -----------------
 test/html_pipeline_test.rb                    |  15 +-
 test/sanitization_filter_test.rb              |  35 ++--
 test/test_helper.rb                           |   8 +-
 33 files changed, 743 insertions(+), 894 deletions(-)
 create mode 100644 lib/html_pipeline/convert_filter.rb
 create mode 100644 lib/html_pipeline/convert_filter/markdown_filter.rb
 delete mode 100644 lib/html_pipeline/text_filter/markdown_filter.rb
 create mode 100644 test/html_pipeline/convert_filter/markdown_filter_test.rb
 delete mode 100644 test/html_pipeline/text_filter/markdown_filter_test.rb

diff --git a/Gemfile b/Gemfile
index fa2bc56d..bcd12a40 100644
--- a/Gemfile
+++ b/Gemfile
@@ -10,16 +10,28 @@ gem "awesome_print"
 gem "rubocop"
 gem "rubocop-standard"
 
+gem 'sorbet-runtime'
+
+group :development, :test do
+  gem "amazing_print"
+  gem "debug"
+end
+
 group :development do
+  gem 'tapioca', require: false
+  gem 'sorbet'
   gem "bundler"
   gem "rake"
 end
 
 group :test do
-  gem "commonmarker", "~> 0.16", require: false
+  gem 'commonmarker', '~> 1.0.0.pre3', require: false
   gem "gemoji", "~> 3.0", require: false
   gem "gemojione", "~> 4.3", require: false
   gem "minitest"
+
+  gem "minitest-bisect", "~> 1.6"
+
   gem "rinku",              "~> 1.7", require: false
   gem "sanitize",           "~> 5.2", require: false
 
diff --git a/README.md b/README.md
index 452702db..cdf62712 100644
--- a/README.md
+++ b/README.md
@@ -45,8 +45,8 @@ $ gem install html-pipeline
 This library provides a handful of chainable HTML filters to transform user
 content into markup. There are two kinds of filters:
 
-* Text filters, which take a regular string
-* Node filters, which operates on a `Nokogiri::HTML::DocumentFragment`
+- Text filters, which operate a UTF-8 string
+- Node filters, which operates on a UTF-8 HTML document
 
 You can choose to call filters individually, or as part of a sequence called a pipeline.
 
@@ -164,23 +164,22 @@ EmojiPipeline = Pipeline.new [
 
 ### TextFilters
 
-* `AutolinkFilter` - auto_linking urls in HTML
-* `ImageFilter` - converts image `url` into `<img>` tag
-* `MarkdownFilter` - convert markdown to html
-* `PlainTextInputFilter` - html escape text and wrap the result in a `<div>`
-
+- `AutolinkFilter` - auto_linking urls in HTML
+- `ImageFilter` - converts image `url` into `<img>` tag
+- `MarkdownFilter` - convert markdown to html
+- `PlainTextInputFilter` - html escape text and wrap the result in a `<div>`
 
 ### NodeFilters
 
-* `AbsoluteSourceFilter` - replace relative image urls with fully qualified versions
-* `EmojiFilter` - converts `:<emoji>:` to [emoji](http://www.emoji-cheat-sheet.com/)!
-* `HttpsFilter` - Replacing http urls with https versions
-* `ImageMaxWidthFilter` - link to full size image for large images
-* `MentionFilter` - replace `@user` mentions with links
-* `SanitizationFilter` - allow sanitize user markup
-* `SyntaxHighlightFilter` - code syntax highlighter
-* `TableOfContentsFilter` - anchor headings with name attributes and generate Table of Contents html unordered list linking headings
-* `TeamMentionFilter` - replace `@org/team` mentions with links
+- `AbsoluteSourceFilter` - replace relative image urls with fully qualified versions
+- `EmojiFilter` - converts `:<emoji>:` to [emoji](http://www.emoji-cheat-sheet.com/)!
+- `HttpsFilter` - Replacing http urls with https versions
+- `ImageMaxWidthFilter` - link to full size image for large images
+- `MentionFilter` - replace `@user` mentions with links
+- `SanitizationFilter` - allow sanitize user markup
+- `SyntaxHighlightFilter` - code syntax highlighter
+- `TableOfContentsFilter` - anchor headings with name attributes and generate Table of Contents html unordered list linking headings
+- `TeamMentionFilter` - replace `@org/team` mentions with links
 
 ## Sanitization
 
@@ -249,13 +248,13 @@ add the following to your Gemfile:
 gem 'rouge'
 ```
 
-* `AutolinkFilter` - `rinku`
-* `EmojiFilter` - `gemoji`
-* `MarkdownFilter` - `commonmarker`
-* `PlainTextInputFilter` - `escape_utils`
-* `SanitizationFilter` - `sanitize`
-* `SyntaxHighlightFilter` - `rouge`
-* `TableOfContentsFilter` - `escape_utils`
+- `AutolinkFilter` - `rinku`
+- `EmojiFilter` - `gemoji`
+- `MarkdownFilter` - `commonmarker`
+- `PlainTextInputFilter` - `escape_utils`
+- `SanitizationFilter` - `sanitize`
+- `SyntaxHighlightFilter` - `rouge`
+- `TableOfContentsFilter` - `escape_utils`
 
 _Note:_ See the [Gemfile](/Gemfile) `:test` group for version requirements.
 
@@ -266,7 +265,7 @@ Full reference documentation can be [found here](http://rubydoc.info/gems/html-p
 ## Extending
 
 To write a custom filter, you need a class with a `call` method that inherits
-from either `HTMLPipeline::TextFilter` or  `HTMLPipeline::NodeFilter`.
+from either `HTMLPipeline::TextFilter` or `HTMLPipeline::NodeFilter`.
 
 For example this filter adds a base url to images that are root relative:
 
@@ -304,25 +303,24 @@ built as an external gem.
 
 Here are some extensions people have built:
 
-* [html-pipeline-asciidoc_filter](https://github.com/asciidoctor/html-pipeline-asciidoc_filter)
-* [jekyll-html-pipeline](https://github.com/gjtorikian/jekyll-html-pipeline)
-* [nanoc-html-pipeline](https://github.com/burnto/nanoc-html-pipeline)
-* [html-pipeline-bitly](https://github.com/dewski/html-pipeline-bitly)
-* [html-pipeline-cite](https://github.com/lifted-studios/html-pipeline-cite)
-* [tilt-html-pipeline](https://github.com/bradgessler/tilt-html-pipeline)
-* [html-pipeline-wiki-link'](https://github.com/lifted-studios/html-pipeline-wiki-link) - WikiMedia-style wiki links
-* [task_list](https://github.com/github/task_list) - GitHub flavor Markdown Task List
-* [html-pipeline-nico_link](https://github.com/rutan/html-pipeline-nico_link) - An HTMLPipeline filter for [niconico](http://www.nicovideo.jp) description links
-* [html-pipeline-gitlab](https://gitlab.com/gitlab-org/html-pipeline-gitlab) - This gem implements various filters for html-pipeline used by GitLab
-* [html-pipeline-youtube](https://github.com/st0012/html-pipeline-youtube) - An HTMLPipeline filter for YouTube links
-* [html-pipeline-flickr](https://github.com/st0012/html-pipeline-flickr) - An HTMLPipeline filter for Flickr links
-* [html-pipeline-vimeo](https://github.com/dlackty/html-pipeline-vimeo) - An HTMLPipeline filter for Vimeo links
-* [html-pipeline-hashtag](https://github.com/mr-dxdy/html-pipeline-hashtag) - An HTMLPipeline filter for hashtags
-* [html-pipeline-linkify_github](https://github.com/jollygoodcode/html-pipeline-linkify_github) - An HTMLPipeline filter to autolink GitHub urls
-* [html-pipeline-redcarpet_filter](https://github.com/bmikol/html-pipeline-redcarpet_filter) - Render Markdown source text into Markdown HTML using Redcarpet
-* [html-pipeline-typogruby_filter](https://github.com/bmikol/html-pipeline-typogruby_filter) - Add Typogruby text filters to your HTMLPipeline
-* [korgi](https://github.com/jodeci/korgi) - HTMLPipeline filters for links to Rails resources
-
+- [html-pipeline-asciidoc_filter](https://github.com/asciidoctor/html-pipeline-asciidoc_filter)
+- [jekyll-html-pipeline](https://github.com/gjtorikian/jekyll-html-pipeline)
+- [nanoc-html-pipeline](https://github.com/burnto/nanoc-html-pipeline)
+- [html-pipeline-bitly](https://github.com/dewski/html-pipeline-bitly)
+- [html-pipeline-cite](https://github.com/lifted-studios/html-pipeline-cite)
+- [tilt-html-pipeline](https://github.com/bradgessler/tilt-html-pipeline)
+- [html-pipeline-wiki-link'](https://github.com/lifted-studios/html-pipeline-wiki-link) - WikiMedia-style wiki links
+- [task_list](https://github.com/github/task_list) - GitHub flavor Markdown Task List
+- [html-pipeline-nico_link](https://github.com/rutan/html-pipeline-nico_link) - An HTMLPipeline filter for [niconico](http://www.nicovideo.jp) description links
+- [html-pipeline-gitlab](https://gitlab.com/gitlab-org/html-pipeline-gitlab) - This gem implements various filters for html-pipeline used by GitLab
+- [html-pipeline-youtube](https://github.com/st0012/html-pipeline-youtube) - An HTMLPipeline filter for YouTube links
+- [html-pipeline-flickr](https://github.com/st0012/html-pipeline-flickr) - An HTMLPipeline filter for Flickr links
+- [html-pipeline-vimeo](https://github.com/dlackty/html-pipeline-vimeo) - An HTMLPipeline filter for Vimeo links
+- [html-pipeline-hashtag](https://github.com/mr-dxdy/html-pipeline-hashtag) - An HTMLPipeline filter for hashtags
+- [html-pipeline-linkify_github](https://github.com/jollygoodcode/html-pipeline-linkify_github) - An HTMLPipeline filter to autolink GitHub urls
+- [html-pipeline-redcarpet_filter](https://github.com/bmikol/html-pipeline-redcarpet_filter) - Render Markdown source text into Markdown HTML using Redcarpet
+- [html-pipeline-typogruby_filter](https://github.com/bmikol/html-pipeline-typogruby_filter) - Add Typogruby text filters to your HTMLPipeline
+- [korgi](https://github.com/jodeci/korgi) - HTMLPipeline filters for links to Rails resources
 
 ## Instrumenting
 
@@ -332,7 +330,7 @@ must be setup with an
 compatible service object and a name. New pipeline objects will default to the
 `HTMLPipeline.default_instrumentation_service` object.
 
-``` ruby
+```ruby
 # the AS::Notifications-compatible service object
 service = ActiveSupport::Notifications
 
@@ -352,26 +350,26 @@ and `call_node_filters` is published when all of the text and node filters are f
 The `payload` should include the `filter` name. Each filter will trigger its own
 instrumentation call.
 
-``` ruby
+```ruby
 service.subscribe "call_filter.html_pipeline" do |event, start, ending, transaction_id, payload|
   payload[:pipeline] #=> "MarkdownPipeline", set with `setup_instrumentation`
   payload[:filter] #=> "MarkdownFilter"
   payload[:context] #=> context Hash
   payload[:result] #=> instance of result class
-  payload[:result][:output] #=> output HTML String or Nokogiri::DocumentFragment
+  payload[:result][:output] #=> output HTML String
 end
 ```
 
 The full pipeline is also instrumented:
 
-``` ruby
+```ruby
 service.subscribe "call_text_filters.html_pipeline" do |event, start, ending, transaction_id, payload|
   payload[:pipeline] #=> "MarkdownPipeline", set with `setup_instrumentation`
   payload[:filters] #=> ["MarkdownFilter"]
-  payload[:doc] #=> HTML String or Nokogiri::DocumentFragment
+  payload[:doc] #=> HTML String
   payload[:context] #=> context Hash
   payload[:result] #=> instance of result class
-  payload[:result][:output] #=> output HTML String or Nokogiri::DocumentFragment
+  payload[:result][:output] #=> output HTML String
 end
 ```
 
@@ -427,9 +425,9 @@ This project is a member of the [OSS Manifesto](http://ossmanifesto.org/).
 
 This section is for gem maintainers to cut a new version of the gem.
 
-* create a new branch named `release-x.y.z` where `x.y.z` follows [semver](http://semver.org)
-* update lib/html/pipeline/version.rb to next version number X.X.X
-* update CHANGELOG.md. Prepare a draft with `script/changelog`
-* push branch and create a new pull request
-* after tests are green, merge to master
-* on the master branch, run `script/release`
+- create a new branch named `release-x.y.z` where `x.y.z` follows [semver](http://semver.org)
+- update lib/html/pipeline/version.rb to next version number X.X.X
+- update CHANGELOG.md. Prepare a draft with `script/changelog`
+- push branch and create a new pull request
+- after tests are green, merge to master
+- on the master branch, run `script/release`
diff --git a/html-pipeline.gemspec b/html-pipeline.gemspec
index a84cff84..dea8d8b9 100644
--- a/html-pipeline.gemspec
+++ b/html-pipeline.gemspec
@@ -16,18 +16,16 @@ Gem::Specification.new do |gem|
   gem.files         = %x(git ls-files -z).split("\x0").reject { |f| f =~ %r{^(test|gemfiles|script)/} }
   gem.require_paths = ["lib"]
 
-  gem.required_ruby_version = "~> 3.0"
+  gem.required_ruby_version = "~> 3.1"
 
   gem.metadata = {
     "funding_uri" => "https://github.com/sponsors/gjtorikian/",
     "rubygems_mfa_required" => "true",
   }
 
-  gem.add_dependency("nokogiri", "~> 1.11")
+  gem.add_dependency("selma", "~> 0.0.1")
   gem.add_dependency("zeitwerk", "~> 2.5")
 
-  gem.add_development_dependency("debug") if "#{RbConfig::CONFIG["MAJOR"]}.#{RbConfig::CONFIG["MINOR"]}".to_f >= 3.1
-
   gem.post_install_message = <<~MSG
     -------------------------------------------------
     Thank you for installing html-pipeline!
diff --git a/lib/html_pipeline.rb b/lib/html_pipeline.rb
index a597e261..576f438d 100644
--- a/lib/html_pipeline.rb
+++ b/lib/html_pipeline.rb
@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "nokogiri"
-
 require "zeitwerk"
 lib_dir = File.join(File.dirname(__dir__), "lib")
 gem_loader = Zeitwerk::Loader.for_gem
@@ -11,7 +9,10 @@
 gem_loader.ignore(File.join(lib_dir, "html-pipeline.rb"))
 gem_loader.setup
 
-# require "debug"
+if ENV.fetch("DEBUG", false)
+  require "amazing_print"
+  require "debug"
+end
 
 class HTMLPipeline
   # HTML processing filters and utilities. This module includes a small
@@ -25,9 +26,7 @@ class HTMLPipeline
   # of its lifetime with input.
   #
   # filters         - Array of Filter objects. Each must respond to call(doc,
-  #                   context) and return the modified DocumentFragment or a
-  #                   String containing HTML markup. Filters are performed in the
-  #                   order provided.
+  #                   context). Filters are performed in the order provided.
   # default_context - The default context hash. Values specified here will be merged
   #                   into values from the each individual pipeline run.  Can NOT be
   #                   nil.  Default: empty Hash.
@@ -37,6 +36,11 @@ class HTMLPipeline
   class MissingDependencyError < RuntimeError; end
   class InvalidFilterError < ArgumentError; end
 
+  def self.optional_dependency(name, requirer)
+    require name
+  rescue LoadError
+  end
+
   def self.require_dependency(name, requirer)
     require name
   rescue LoadError => e
@@ -77,20 +81,6 @@ def self.define_dependency_loaded_method(name, value)
     self.class.define_method(:"#{name}_loaded?", -> { value })
   end
 
-  # Our DOM implementation.
-  DocumentFragment = Nokogiri::HTML::DocumentFragment
-
-  # Parse a String into a DocumentFragment object. When a DocumentFragment is
-  # provided, return it verbatim.
-  def self.parse(document_or_html)
-    document_or_html ||= ""
-    if document_or_html.is_a?(String)
-      DocumentFragment.parse(document_or_html)
-    else
-      document_or_html
-    end
-  end
-
   # Public: Returns an Array of Filter objects for this Pipeline.
   attr_reader :text_filters, :node_filters
 
@@ -115,31 +105,31 @@ class << self
     attr_accessor :default_instrumentation_service
   end
 
-  def initialize(text_filters: [], sanitization_config: {}, node_filters: [], default_context: {}, result_class: Hash)
+  def initialize(text_filters: [], convert_filter: nil, sanitization_config: SanitizationFilter::DEFAULT_CONFIG, node_filters: [], default_context: {}, result_class: Hash)
     raise ArgumentError, "default_context cannot be nil" if default_context.nil?
 
     @text_filters = text_filters.flatten.freeze
-    validate_filter(@text_filters, HTMLPipeline::TextFilter)
+    validate_filters(@text_filters, HTMLPipeline::TextFilter)
 
     @node_filters = node_filters.flatten.freeze
-    validate_filter(@node_filters, HTMLPipeline::NodeFilter)
+    validate_filters(@node_filters, HTMLPipeline::NodeFilter)
 
-    @sanitization_config = unless sanitization_config.nil?
-      if sanitization_config.empty?
-        SanitizationFilter::DEFAULT_CONFIG
-      else
-        sanitization_config
-      end
+    @convert_filter = convert_filter
+    if @convert_filter.nil? && !@node_filters.empty?
+      raise InvalidFilterError, "Must provide `convert_filter` if `node_filter`s is also provided"
+    elsif !@convert_filter.nil?
+      validate_filter(@convert_filter, HTMLPipeline::ConvertFilter)
     end
 
+    @sanitization_config = sanitization_config.nil? ? nil : Selma::Sanitizer.new(sanitization_config)
+
     @default_context = default_context.freeze
-    @result_class = result_class
     @instrumentation_service = self.class.default_instrumentation_service
   end
 
   # Apply all filters in the pipeline to the given HTML.
-  #
-  # html    - A String containing HTML or a DocumentFragment object.
+  # TODO: test UTF-8
+  # html    - A UTF-8 String comprised of HTML.
   # context - The context hash passed to each filter. See the Filter docs
   #           for more info on possible values. This object MUST NOT be modified
   #           in place by filters.  Use the Result for passing state back.
@@ -147,12 +137,12 @@ def initialize(text_filters: [], sanitization_config: {}, node_filters: [], defa
   #           is where Filters store extracted information from the content.
   #
   # Returns the result Hash after being filtered by this Pipeline.  Contains an
-  # :output key with the DocumentFragment or String HTML markup based on the
+  # :output key with the String HTML markup based on the
   # output of the last filter in the pipeline.
   def call(text, context: {}, result: {})
     context = @default_context.merge(context)
     context = context.freeze
-    result ||= @result_class.new
+    result ||= {}
 
     payload = default_payload({ text_filters: @text_filters.map(&:name),
                                 context: context, result: result, })
@@ -163,21 +153,21 @@ def call(text, context: {}, result: {})
         end
     end
 
-    html = HTMLPipeline.parse(result[:output])
+    text = result[:output]
 
-    unless @sanitization_config.nil?
-      html = SanitizationFilter.new(html, @sanitization_config).call.to_s
-    end
+    html = @convert_filter.call(text) unless @convert_filter.nil?
 
-    payload = default_payload({ node_filters: @node_filters.map(&:name),
-      context: context, result: result, })
-    instrument("call_node_filters.html_pipeline", payload) do
-      result[:output] =
-        @node_filters.inject(html) do |doc, filter|
-          perform_filter(filter, doc, context: context, result: result)
-        end
+    unless @node_filters.empty?
+      payload = default_payload({ node_filters: @node_filters.map{ |f| f.class.name },
+        context: context, result: result, })
+      instrument("call_node_filters.html_pipeline", payload) do
+        result[:output] = Selma::Rewriter.new(sanitizer: @sanitization_config, handlers: @node_filters).rewrite(html)
+      end
     end
 
+    result = result.merge(Hash[ *@node_filters.collect { |f| f.result }.flatten ])
+    @node_filters.each { |f| f.reset! }
+
     result
   end
 
@@ -194,14 +184,6 @@ def perform_filter(filter, doc, context: {}, result: {})
     end
   end
 
-  # Like call but guarantee the value returned is a DocumentFragment.
-  # Pipelines may return a DocumentFragment or a String. Callers that need a
-  # DocumentFragment should use this method.
-  def to_document(input, context: {}, result: {})
-    result = call(input, context: context, result: result)
-    HTMLPipeline.parse(result[:output])
-  end
-
   # Like call but guarantee the value returned is a string of HTML markup.
   def to_html(input, context: {}, result: {})
     result = call(input, context: context, result: result)
@@ -242,14 +224,28 @@ def default_payload(payload = {})
     { pipeline: instrumentation_name }.merge(payload)
   end
 
-  private def validate_filter(filters, klass)
+  private def validate_filter(filter, klass)
+    if !correctly_ancestored?(filter, klass)
+      raise InvalidFilterError, "Filter must inherit from `#{klass}`; #{filter} does not"
+    end
+  end
+
+  private def validate_filters(filters, klass)
     return if filters.nil? || filters.empty?
 
-    invalid_filters = filters.select { |f| !f.ancestors.include?(klass) }
+    invalid_filters = filters.reject { |f| correctly_ancestored?(f, klass) }
 
     unless invalid_filters.empty?
-      verb = invalid_filters.count == 1 ? "is" : "are"
-      raise InvalidFilterError, "All filters must be #{klass} objects; #{invalid_filters.join(", ")} #{verb} not"
+      verb = invalid_filters.count == 1 ? "does" : "do"
+      raise InvalidFilterError, "All filters must inherit from `#{klass}`; #{invalid_filters.join(", ")} #{verb} not"
+    end
+  end
+
+  private def correctly_ancestored?(filter, klass)
+    if filter.respond_to?(:ancestors)
+      filter.ancestors.include?(klass)
+    else
+      filter.class.ancestors.include?(klass)
     end
   end
 end
diff --git a/lib/html_pipeline/body_content.rb b/lib/html_pipeline/body_content.rb
index 877b7721..866bf484 100644
--- a/lib/html_pipeline/body_content.rb
+++ b/lib/html_pipeline/body_content.rb
@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
 class HTMLPipeline
-  # Public: Runs a String of content through an HTML processing pipeline,
-  # providing easy access to a generated DocumentFragment.
+  # Public: Runs a String of content through an HTML processing pipeline.
   class BodyContent
     # Public: Initialize a BodyContent.
     #
@@ -25,16 +24,9 @@ def result
 
     # Public: Gets the updated body from the Pipeline result.
     #
-    # Returns a String or DocumentFragment.
+    # Returns a String.
     def output
       @output ||= result[:output]
     end
-
-    # Public: Parses the output into a DocumentFragment.
-    #
-    # Returns a DocumentFragment.
-    def document
-      @document ||= HTMLPipeline.parse(output)
-    end
   end
 end
diff --git a/lib/html_pipeline/convert_filter.rb b/lib/html_pipeline/convert_filter.rb
new file mode 100644
index 00000000..1a9a2ee3
--- /dev/null
+++ b/lib/html_pipeline/convert_filter.rb
@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class HTMLPipeline
+  class ConvertFilter < Filter
+    attr_reader :text, :html
+
+    def initialize(context: {}, result: {})
+      super(context: context, result: result)
+    end
+
+    def self.call(text, context: {}, result: {})
+      new(context: context, result: result).call(text)
+    end
+  end
+end
diff --git a/lib/html_pipeline/convert_filter/markdown_filter.rb b/lib/html_pipeline/convert_filter/markdown_filter.rb
new file mode 100644
index 00000000..cdff37fa
--- /dev/null
+++ b/lib/html_pipeline/convert_filter/markdown_filter.rb
@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+HTMLPipeline.require_dependency("commonmarker", "MarkdownFilter")
+
+class HTMLPipeline
+  class ConvertFilter
+    # HTML Filter that converts Markdown text into HTML.
+    #
+    # Context options:
+    #   :markdown[:parse] => Commonmarker parse options
+    #   :markdown[:render] => Commonmarker render options
+    #   :markdown[:extensions] => Commonmarker extensions options
+    class MarkdownFilter < ConvertFilter
+      def initialize(context: {}, result: {})
+        super(context: context, result: result)
+      end
+
+      # Convert Commonmark to HTML using the best available implementation.
+      def call(text)
+        options =  @context.fetch(:markdown, {})
+        Commonmarker.to_html(text, options: options).rstrip!
+      end
+    end
+  end
+end
diff --git a/lib/html_pipeline/filter.rb b/lib/html_pipeline/filter.rb
index b686b4c3..b51b8d9c 100644
--- a/lib/html_pipeline/filter.rb
+++ b/lib/html_pipeline/filter.rb
@@ -2,24 +2,12 @@
 
 class HTMLPipeline
   # Base class for user content HTML filters. Each filter takes an
-  # HTML string or Nokogiri::HTML::DocumentFragment, performs
-  # modifications and/or writes information to the result hash. Filters must
-  # return a DocumentFragment (typically the same instance provided to the call
-  # method) or a String with HTML markup.
+  # HTML string, performs modifications on it, and/or writes information to a result hash.
+  # Filters must return a String with HTML markup.
   #
-  # Example filter that replaces all images with trollface:
-  #
-  #   class TrollFilter < HTMLPipeline::Filter
-  #     def call
-  #       doc.search('img').each do |img|
-  #         img['src'] = "http://paradoxdgn.com/junk/avatars/trollface.jpg"
-  #       end
-  #     end
-  #   end
-  #
-  # The context Hash passes options to filters and should not be changed in
-  # place.  A Result Hash allows filters to make extracted information
-  # available to the caller and is mutable.
+  # The `context` Hash passes options to filters and should not be changed in
+  # place. A `result` Hash allows filters to make extracted information
+  # available to the caller, and is mutable.
   #
   # Common context options:
   #   :base_url   - The site's base URL
@@ -47,26 +35,18 @@ def initialize(context: {}, result: {})
     attr_reader :result
 
     # The main filter entry point. The doc attribute is guaranteed to be a
-    # Nokogiri::HTML::DocumentFragment when invoked. Subclasses should modify
-    # this document in place or extract information and add it to the context
+    # string when invoked. Subclasses should modify
+    # this text in place or extract information and add it to the context
     # hash.
     def call
-      raise NotImplementedError
+      raise NoMethodError
     end
 
     # Perform a filter on doc with the given context.
     #
-    # Returns a HTMLPipeline::DocumentFragment or a String containing HTML
-    # markup.
-    def self.call(input, context: {}, result: {})
-      new(input, context: context, result: result).call
-    end
-
-    # Like call but guarantees that a DocumentFragment is returned, even when
-    # the last filter returns a String.
-    def self.to_document(input, context: {})
-      html = call(input, context: context)
-      HTMLPipeline.parse(html)
+    # Returns a String comprised of HTML markup.
+    def self.call(input, context: {})
+      raise NoMethodError
     end
 
     # Make sure the context has everything we need. Noop: Subclasses can override.
@@ -85,10 +65,9 @@ def base_url
     # tags - An array of tag name strings to check. These should be downcase.
     #
     # Returns true when the node has a matching ancestor.
-    def has_ancestor?(node, tags)
-      while (node = node.parent)
-        break true if tags.include?(node.name.downcase)
-      end
+    def has_ancestor?(element, ancestor)
+      ancestors = element.ancestors
+      ancestors.include?(ancestor)
     end
 
     # Validator for required context. This will check that anything passed in
diff --git a/lib/html_pipeline/node_filter.rb b/lib/html_pipeline/node_filter.rb
index c81045e5..a59a57a9 100644
--- a/lib/html_pipeline/node_filter.rb
+++ b/lib/html_pipeline/node_filter.rb
@@ -1,53 +1,29 @@
 # frozen_string_literal: true
 
+require "selma"
+
 class HTMLPipeline
   class NodeFilter < Filter
-    def initialize(html, context: {}, result: {})
-      typecheck_input(html)
-      super(context: context, result: result)
-    end
-
-    # Like call but guarantees that a string of HTML markup is returned.
-    def self.to_html(input, context: {})
-      output = call(input, context: context)
-      if output.respond_to?(:to_html)
-        output.to_html
-      else
-        output.to_s
-      end
-    end
-
-    # The Nokogiri::HTML::DocumentFragment to be manipulated. If the filter was
-    # provided a String, parse into a DocumentFragment the first time this
-    # method is called.
-    def doc
-      @doc ||= parse_html(html)
+    def initialize(context: {}, result: {})
+      super(context: context, result: {})
+      send(:after_initialize) if respond_to?(:after_initialize)
     end
 
-    # The String representation of the document. If a DocumentFragment was
-    # provided to the Filter, it is serialized into a String when this method is
-    # called.
+    # The String representation of the document.
     def html
       raise InvalidDocumentException if @html.nil? && @doc.nil?
 
       @html || doc.to_html
     end
 
-    # Ensure the passed argument is a DocumentFragment. When a string is
-    # provided, it is parsed and returned; otherwise, the DocumentFragment is
-    # returned unmodified.
-    private def parse_html(html)
-      HTMLPipeline.parse(html)
+    def reset!
+      result = {}
+      send(:after_initialize) if respond_to?(:after_initialize)
     end
 
-    private def typecheck_input(doc)
-      if doc.is_a?(String)
-        @html = doc.to_str
-        @doc = nil
-      else
-        @doc = doc
-        @html = nil
-      end
+    def self.call(html, context: {}, result: {})
+      node_filter = new(context: context, result: result)
+      Selma::Rewriter.new(sanitizer: nil, handlers: [node_filter]).rewrite(html)
     end
   end
 end
diff --git a/lib/html_pipeline/node_filter/absolute_source_filter.rb b/lib/html_pipeline/node_filter/absolute_source_filter.rb
index f390f10b..f253fd6e 100644
--- a/lib/html_pipeline/node_filter/absolute_source_filter.rb
+++ b/lib/html_pipeline/node_filter/absolute_source_filter.rb
@@ -5,6 +5,12 @@
 class HTMLPipeline
   class NodeFilter
     class AbsoluteSourceFilter < NodeFilter
+      SELECTOR = Selma::Selector.new(match_element: "img")
+
+      def selector
+        SELECTOR
+      end
+
       # HTML Filter for replacing relative and root relative image URLs with
       # fully qualified URLs
       #
@@ -18,21 +24,20 @@ class AbsoluteSourceFilter < NodeFilter
       #
       # This filter does not write additional information to the context.
       # This filter would need to be run before CamoFilter.
-      def call
-        doc.search("img").each do |element|
-          next if element["src"].nil? || element["src"].empty?
-
-          src = element["src"].strip
-          next if src.start_with?("http")
-
-          base = if src.start_with?("/")
-            image_base_url
-          else
-            image_subpage_url
-          end
-          element["src"] = URI.join(base, src).to_s
+      def handle_element(element)
+        src = element["src"]
+        return if src.nil? || src.empty?
+
+        src = src.strip
+        return if src.start_with?("http")
+
+        base = if src.start_with?("/")
+          image_base_url
+        else
+          image_subpage_url
         end
-        doc
+
+        element["src"] = URI.join(base, src).to_s
       end
 
       # Private: the base url you want to use
diff --git a/lib/html_pipeline/node_filter/emoji_filter.rb b/lib/html_pipeline/node_filter/emoji_filter.rb
index 123e8dde..e91333c5 100644
--- a/lib/html_pipeline/node_filter/emoji_filter.rb
+++ b/lib/html_pipeline/node_filter/emoji_filter.rb
@@ -15,18 +15,25 @@ class NodeFilter
     class EmojiFilter < NodeFilter
       DEFAULT_IGNORED_ANCESTOR_TAGS = ["pre", "code", "tt"].freeze
 
-      def call
-        doc.search(".//text()").each do |node|
-          content = node.text
-          next unless content.include?(":")
-          next if has_ancestor?(node, ignored_ancestor_tags)
+      # Build a regexp that matches all valid :emoji: names.
+      def after_initialize
+        @emoji_pattern ||= /:(#{emoji_names.map { |name| Regexp.escape(name) }.join('|')}):/
+      end
+
+      def selector
+        Selma::Selector.new(match_text_within: "*", ignore_text_within: ignored_ancestor_tags)
+      end
+
+      def handle_text(text)
+        return text unless text.include?(":")
 
-          html = emoji_image_filter(content)
-          next if html == content
+        emoji_image_filter(text)
+      end
 
-          node.replace(html)
+      def emoji_image_filter(text)
+        text.gsub(emoji_pattern) do
+          emoji_image_tag(Regexp.last_match(1))
         end
-        doc
       end
 
       # Implementation of validate hook.
@@ -41,7 +48,7 @@ def validate
       #
       # Returns a String with :emoji: replaced with images.
       def emoji_image_filter(text)
-        text.gsub(emoji_pattern) do
+        text.gsub(@emoji_pattern) do
           emoji_image_tag(Regexp.last_match(1))
         end
       end
@@ -81,11 +88,6 @@ def asset_path(name)
         "<img #{html_attrs}>"
       end
 
-      # Build a regexp that matches all valid :emoji: names.
-      def emoji_pattern
-        @emoji_pattern ||= /:(#{emoji_names.map { |name| Regexp.escape(name) }.join('|')}):/
-      end
-
       def emoji_names
         if self.class.gemoji_loaded?
           Emoji.all.map(&:aliases)
diff --git a/lib/html_pipeline/node_filter/https_filter.rb b/lib/html_pipeline/node_filter/https_filter.rb
index 1f11c770..0740c760 100644
--- a/lib/html_pipeline/node_filter/https_filter.rb
+++ b/lib/html_pipeline/node_filter/https_filter.rb
@@ -8,21 +8,14 @@ class NodeFilter
     # Context options:
     #   :http_url - The HTTP url to force HTTPS. Falls back to :base_url
     class HttpsFilter < NodeFilter
-      def call
-        doc.css(%(a[href^="#{http_url}"])).each do |element|
-          element["href"] = element["href"].sub(/^http:/, "https:")
-        end
-        doc
-      end
+      SELECTOR = Selma::Selector.new(match_element: %(a[href^="http:"]))
 
-      # HTTP url to replace. Falls back to :base_url
-      def http_url
-        context[:http_url] || context[:base_url]
+      def selector
+        SELECTOR
       end
 
-      # Raise error if :http_url undefined
-      def validate
-        needs(:http_url) unless http_url
+      def handle_element(element)
+        element["href"] = element["href"].sub(/^http:/, "https:")
       end
     end
   end
diff --git a/lib/html_pipeline/node_filter/image_max_width_filter.rb b/lib/html_pipeline/node_filter/image_max_width_filter.rb
index 659dcf9e..42381080 100644
--- a/lib/html_pipeline/node_filter/image_max_width_filter.rb
+++ b/lib/html_pipeline/node_filter/image_max_width_filter.rb
@@ -9,28 +9,30 @@ class NodeFilter
     # The max-width inline styles are especially useful in HTML email which
     # don't use a global stylesheets.
     class ImageMaxWidthFilter < NodeFilter
-      def call
-        doc.search("img").each do |element|
-          # Skip if there's already a style attribute. Not sure how this
-          # would happen but we can reconsider it in the future.
-          next if element["style"]
+      SELECTOR = Selma::Selector.new(match_element: "img")
 
-          # Bail out if src doesn't look like a valid http url. trying to avoid weird
-          # js injection via javascript: urls.
-          next if /\Ajavascript/i.match?(element["src"].to_s.strip)
+      def selector
+        SELECTOR
+      end
+
+      def handle_element(element)
+        # Skip if there's already a style attribute. Not sure how this
+        # would happen but we can reconsider it in the future.
+        return if element["style"]
 
-          element["style"] = "max-width:100%;"
+        # Bail out if src doesn't look like a valid http url. trying to avoid weird
+        # js injection via javascript: urls.
+        return if /\Ajavascript/i.match?(element["src"].to_s.strip)
 
-          link_image(element) unless has_ancestor?(element, ["a"])
-        end
+        element["style"] = "max-width:100%;"
 
-        doc
+        link_image(element) unless has_ancestor?(element, "a")
       end
 
       def link_image(element)
-        link = doc.document.create_element("a", href: element["src"], target: "_blank")
-        link.add_child(element.dup)
-        element.replace(link)
+        link_start = %Q(<a target="_blank" href="#{element["src"]}">)
+        link_end = "</a>"
+        element.wrap(link_start, link_end, :as_html)
       end
     end
   end
diff --git a/lib/html_pipeline/node_filter/mention_filter.rb b/lib/html_pipeline/node_filter/mention_filter.rb
index 87c72fe0..f68394f3 100644
--- a/lib/html_pipeline/node_filter/mention_filter.rb
+++ b/lib/html_pipeline/node_filter/mention_filter.rb
@@ -58,22 +58,26 @@ def self.mentioned_logins_in(text, username_pattern = USERNAME_PATTERN)
       USERNAME_PATTERN = /[a-z0-9][a-z0-9-]*/
 
       # Don't look for mentions in text nodes that are children of these elements
-      IGNORE_PARENTS = ["pre", "code", "a", "style", "script"].to_set
+      IGNORE_PARENTS = ["pre", "code", "a", "style", "script"]
 
-      def call
+      SELECTOR = Selma::Selector.new(match_text_within: "*", ignore_text_within: IGNORE_PARENTS)
+
+      # TODO: document this
+      def after_initialize
         result[:mentioned_usernames] ||= []
+      end
 
-        doc.search(".//text()").each do |node|
-          content = node.to_html
-          next unless content.include?("@")
-          next if has_ancestor?(node, IGNORE_PARENTS)
+      def selector
+        SELECTOR
+      end
 
-          html = mention_link_filter(content, base_url: base_url, username_pattern: username_pattern)
-          next if html == content
+      def handle_text(text)
+        return text unless text.include?("@")
 
-          node.replace(html)
-        end
-        doc
+        html = mention_link_filter(text, base_url: base_url, username_pattern: username_pattern)
+        return text if html == text
+
+        html
       end
 
       # The URL to provide when someone @mentions a "mention" name, such
@@ -112,7 +116,7 @@ def link_to_mentioned_user(base_url, login)
         url = base_url.dup
         url << "/" unless %r{[/~]\z}.match?(url)
 
-        "<a href='#{url << login}' class='user-mention'>" \
+        "<a href=\"#{url << login}\" class=\"user-mention\">" \
           "@#{login}" \
           "</a>"
       end
diff --git a/lib/html_pipeline/node_filter/syntax_highlight_filter.rb b/lib/html_pipeline/node_filter/syntax_highlight_filter.rb
index bdc51810..38f9281a 100644
--- a/lib/html_pipeline/node_filter/syntax_highlight_filter.rb
+++ b/lib/html_pipeline/node_filter/syntax_highlight_filter.rb
@@ -14,37 +14,46 @@ class NodeFilter
     #
     # This filter does not write any additional information to the context hash.
     class SyntaxHighlightFilter < NodeFilter
-      def initialize(doc, context: {}, result: {})
-        super(doc, context: context, result: result)
-        @formatter = Rouge::Formatters::HTML.new
+      def initialize(context: {}, result: {})
+        super(context: context, result: result)
+        # TODO: test the optionality of this
+        @formatter = context[:formatter] || Rouge::Formatters::HTML.new
       end
 
-      def call
-        doc.search("pre").each do |node|
-          default = context[:highlight]&.to_s
-          next unless (lang = node["lang"] || default)
-          next unless (lexer = lexer_for(lang))
-
-          text = node.inner_text
-          html = highlight_with_timeout_handling(text, lexer)
-          next if html.nil?
-
-          node.inner_html = html
-          scope = context.fetch(:scope, "highlight")
-          node["class"] = "#{scope} #{scope}-#{lang}"
-        end
-        doc
+      SELECTOR = Selma::Selector.new(match_element: "pre", match_text_within: "pre")
+
+      def selector
+        SELECTOR
+      end
+
+      def handle_element(element)
+        default = context[:highlight]&.to_s
+        @lang = element["lang"] || default
+
+        scope = context.fetch(:scope, "highlight")
+
+        element["class"] = "#{scope} #{scope}-#{@lang}" if include_lang?
+      end
+
+      def handle_text(text)
+        return text if @lang.nil?
+        return text if (lexer = lexer_for(@lang)).nil?
+        highlight_with_timeout_handling(text, lexer)
       end
 
       def highlight_with_timeout_handling(text, lexer)
         Rouge.highlight(text, lexer, @formatter)
       rescue Timeout::Error => _e
-        nil
+        text
       end
 
       def lexer_for(lang)
         Rouge::Lexer.find(lang)
       end
+
+      def include_lang?
+        !@lang.nil? && !@lang.empty?
+      end
     end
   end
 end
diff --git a/lib/html_pipeline/node_filter/table_of_contents_filter.rb b/lib/html_pipeline/node_filter/table_of_contents_filter.rb
index bd0fd2cc..a1d8e9d9 100644
--- a/lib/html_pipeline/node_filter/table_of_contents_filter.rb
+++ b/lib/html_pipeline/node_filter/table_of_contents_filter.rb
@@ -4,11 +4,10 @@
 
 class HTMLPipeline
   class NodeFilter
-    # HTML filter that adds an 'id' attribute to all headers
-    # in a document, so they can be accessed from a table of contents.
-    #
-    # Generates the Table of Contents, with links to each header.
-    #
+    # Generates a Table of Contents: an array of hashes containing:
+    # * `href`: the relative link to the header
+    # * `text`: the text of the header
+
     # Examples
     #
     #  TocPipeline =
@@ -23,46 +22,49 @@ class NodeFilter
     #  TocPipeline.call(orig, {}, result)
     #  # => {:toc=> ...}
     #  result[:toc]
-    #  # => "<ul class=\"section-nav\">\n<li><a href=\"#ice-cube\">...</li><ul>"
+    #  # => "{:href=>"#ice-cube", :text=>"Ice cube"}"
     #  result[:output].to_s
     #  # => "<h1>\n<a id=\"ice-cube\" class=\"anchor\" href=\"#ice-cube\">..."
     class TableOfContentsFilter < NodeFilter
-      PUNCTUATION_REGEXP = /[^\p{Word}\- ]/u
+      SELECTOR = Selma::Selector.new(match_element: "h1 a[href], h2 a[href], h3 a[href], h4 a[href], h5 a[href], h6 a[href]",
+                                     match_text_within: "h1, h2, h3, h4, h5, h6")
+
+      def selector
+        SELECTOR
+      end
 
       # The icon that will be placed next to an anchored rendered markdown header
-      def anchor_icon
-        context[:anchor_icon] || '<span aria-hidden="true" class="octicon octicon-link"></span>'
+      def anchor_html
+        @context[:anchor_html] || %(<span aria-hidden="true" class="anchor"></span>)
+      end
+
+      # The class that will be attached on the anchored rendered markdown header
+      def classes
+        context[:classes] || "anchor"
+      end
+
+      def after_initialize
+        result[:toc] = []
       end
 
-      def call
-        result[:toc] = +""
+      def handle_element(element)
+        header_href = element["href"]
 
-        headers = Hash.new(0)
-        doc.css("h1, h2, h3, h4, h5, h6").each do |node|
-          text = node.text
-          id = ascii_downcase(text)
-          id.gsub!(PUNCTUATION_REGEXP, "") # remove punctuation
-          id.tr!(" ", "-") # replace spaces with dash
+        return unless header_href.start_with?("#")
+        header_id = header_href[1..-1]
 
-          uniq = (headers[id]).positive? ? "-#{headers[id]}" : ""
-          headers[id] += 1
-          if (header_content = node.children.first)
-            result[:toc] << %(<li><a href="##{id}#{uniq}">#{EscapeUtils.escape_html(text)}</a></li>\n)
-            header_content.add_previous_sibling(%(<a id="#{id}#{uniq}" class="anchor" href="##{id}#{uniq}" aria-hidden="true">#{anchor_icon}</a>))
-          end
-        end
-        result[:toc] = %(<ul class="section-nav">\n#{result[:toc]}</ul>) unless result[:toc].empty?
-        doc
+        element["id"] = header_id
+        element["class"] = classes
+
+        element.set_inner_content(anchor_html, :as_html)
+
+        result[:toc] << { href: header_href }
       end
 
-      if RUBY_VERSION >= "2.4"
-        def ascii_downcase(str)
-          str.downcase(:ascii)
-        end
-      else
-        def ascii_downcase(str)
-          str.downcase
-        end
+      def handle_text(text)
+        result[:toc].last.merge!(text: text)
+
+        text
       end
     end
   end
diff --git a/lib/html_pipeline/node_filter/team_mention_filter.rb b/lib/html_pipeline/node_filter/team_mention_filter.rb
index 316d3a3a..a9aad730 100644
--- a/lib/html_pipeline/node_filter/team_mention_filter.rb
+++ b/lib/html_pipeline/node_filter/team_mention_filter.rb
@@ -41,28 +41,29 @@ def self.mentioned_teams_in(text, team_pattern = TEAM_PATTERN)
       TEAM_PATTERN = %r{
         (?<=^|\W)                  # beginning of string or non-word char
         @([a-z0-9][a-z0-9-]*)      # @organization
-          /                       # dividing slash
+          (?:/|&\#47;?)             # dividing slash
           ([a-z0-9][a-z0-9\-_]*)   # team
           \b
       }ix
 
       # Don't look for mentions in text nodes that are children of these elements
-      IGNORE_PARENTS = ["pre", "code", "a", "style", "script"].to_set
+      IGNORE_PARENTS = ["pre", "code", "a", "style", "script"]
 
-      def call
-        result[:mentioned_teams] ||= []
+      SELECTOR = Selma::Selector.new(match_text_within: "*", ignore_text_within: IGNORE_PARENTS)
 
-        doc.search(".//text()").each do |node|
-          content = node.to_html
-          next unless content.include?("@")
-          next if has_ancestor?(node, IGNORE_PARENTS)
+      # TODO: document this
+      def after_initialize
+        result[:mentioned_teams] = []
+      end
+
+      def selector
+        SELECTOR
+      end
 
-          html = mention_link_filter(content, base_url: base_url, team_pattern: team_pattern)
-          next if html == content
+      def handle_text(text)
+        return text unless text.include?("@")
 
-          node.replace(html)
-        end
-        doc
+        mention_link_filter(text, base_url: base_url, team_pattern: team_pattern)
       end
 
       def team_pattern
@@ -81,8 +82,9 @@ def team_pattern
       def mention_link_filter(text, base_url: "/", team_pattern: TEAM_PATTERN)
         self.class.mentioned_teams_in(text, team_pattern) do |match, org, team|
           link = link_to_mentioned_team(base_url, org, team)
+          seperator = %r{/|&\#47;?}
 
-          link ? match.sub("@#{org}/#{team}", link) : match
+          link ? match.sub(%r{@#{org}#{seperator}#{team}}, link) : match
         end
       end
 
@@ -92,7 +94,7 @@ def link_to_mentioned_team(base_url, org, team)
         url = base_url.dup
         url << "/" unless %r{[/~]\z}.match?(url)
 
-        "<a href='#{url << org}/#{team}' class='team-mention'>" \
+        "<a href=\"#{url << org}/#{team}\" class=\"team-mention\">" \
           "@#{org}/#{team}" \
           "</a>"
       end
diff --git a/lib/html_pipeline/sanitization_filter.rb b/lib/html_pipeline/sanitization_filter.rb
index 6572cc2c..6868e605 100644
--- a/lib/html_pipeline/sanitization_filter.rb
+++ b/lib/html_pipeline/sanitization_filter.rb
@@ -7,9 +7,9 @@ class HTMLPipeline
   # what HTML is allowed in user provided content and fixes up issues with
   # unbalanced tags and whatnot.
   #
-  # See the Sanitize docs for more information on the underlying library:
+  # See the Selma docs for more information on the underlying library:
   #
-  # https://github.com/rgrove/sanitize/#readme
+  # https://github.com/gjtorikian/selma/#readme
   #
   # This filter does not write additional information to the context.
   class SanitizationFilter
@@ -71,18 +71,12 @@ class SanitizationFilter
       ].freeze,
     }.freeze
 
-    def initialize(doc, config)
-      @doc = HTMLPipeline.parse(doc)
-      @config = config
-    end
-
-    # Sanitize markup using the Sanitize library.
-    def call
-      Sanitize.clean_node!(@doc, @config)
-    end
+    def self.call(html, config)
+      raise ArgumentError, "html must be a String, not #{html.class}" unless html.is_a?(String)
+      raise ArgumentError, "config must be a Hash, not #{config.class}" unless config.is_a?(Hash)
 
-    def self.call(doc, config)
-      new(doc, config).call.to_s
+      sanitization_config = Selma::Sanitizer.new(config)
+      Selma::Rewriter.new(sanitizer: sanitization_config).rewrite(html)
     end
   end
 end
diff --git a/lib/html_pipeline/text_filter.rb b/lib/html_pipeline/text_filter.rb
index d12efebd..37797492 100644
--- a/lib/html_pipeline/text_filter.rb
+++ b/lib/html_pipeline/text_filter.rb
@@ -5,21 +5,15 @@ class TextFilter < Filter
     attr_reader :text
 
     def initialize(text, context: {}, result: {})
-      raise TypeError, "text cannot be HTML" if text.is_a?(DocumentFragment)
+      raise TypeError, "text must be a String" unless text.is_a?(String)
 
       # Ensure that this is always a string
       @text = text.respond_to?(:to_str) ? text.to_str : text.to_s
       super(context: context, result: result)
     end
 
-    # Like call but guarantees that a string of HTML markup is returned.
-    def self.process(input, context: {})
-      output = call(input, context: context)
-      if output.respond_to?(:to_html)
-        output.to_html
-      else
-        output.to_s
-      end
+    def self.call(input, context: {}, result: {})
+      new(input, context: context, result: result).call
     end
   end
 end
diff --git a/lib/html_pipeline/text_filter/markdown_filter.rb b/lib/html_pipeline/text_filter/markdown_filter.rb
deleted file mode 100644
index 85ac9c2b..00000000
--- a/lib/html_pipeline/text_filter/markdown_filter.rb
+++ /dev/null
@@ -1,55 +0,0 @@
-# frozen_string_literal: true
-
-HTMLPipeline.require_dependency("commonmarker", "MarkdownFilter")
-
-class HTMLPipeline
-  class TextFilter
-    # HTML Filter that converts Markdown text into HTML and converts into a
-    # DocumentFragment. This is different from most filters in that it can take a
-    # non-HTML as input. It must be used as the first filter in a pipeline.
-    #
-    # Context options:
-    #   :gfm      => false    Disable GFM line-end processing
-    #   :commonmarker_extensions => [ :table, :strikethrough,
-    #      :tagfilter, :autolink ] Commonmarker extensions to include
-    #
-    # This filter does not write any additional information to the context hash.
-    class MarkdownFilter < TextFilter
-      DEFAULT_COMMONMARKER_EXTENSIONS = [:table, :strikethrough, :tagfilter, :autolink].freeze
-
-      def initialize(text, context: {}, result: {})
-        super(text, context: context, result: result)
-        @text = @text.delete("\r")
-      end
-
-      # Convert Markdown to HTML using the best available implementation
-      # and convert into a DocumentFragment.
-      def call
-        extensions = context.fetch(
-          :commonmarker_extensions,
-          DEFAULT_COMMONMARKER_EXTENSIONS
-        )
-        html = if (renderer = context[:commonmarker_renderer])
-          raise ArgumentError, "`commonmark_renderer` must be derived from `CommonMarker::HtmlRenderer`" unless renderer < CommonMarker::HtmlRenderer
-
-          parse_options = :DEFAULT
-          parse_options = [:UNSAFE] if context[:unsafe]
-
-          render_options = [:GITHUB_PRE_LANG]
-          render_options << :HARDBREAKS if context[:gfm] != false
-          render_options << :UNSAFE if context[:unsafe]
-
-          doc = CommonMarker.render_doc(@text, parse_options, extensions)
-          renderer.new(options: render_options, extensions: extensions).render(doc)
-        else
-          options = [:GITHUB_PRE_LANG]
-          options << :HARDBREAKS if context[:gfm] != false
-          options << :UNSAFE if context[:unsafe]
-          CommonMarker.render_html(@text, options, extensions)
-        end
-        html.rstrip!
-        html
-      end
-    end
-  end
-end
diff --git a/lib/html_pipeline/text_filter/plain_text_input_filter.rb b/lib/html_pipeline/text_filter/plain_text_input_filter.rb
index 6c10cbe2..ef72acd9 100644
--- a/lib/html_pipeline/text_filter/plain_text_input_filter.rb
+++ b/lib/html_pipeline/text_filter/plain_text_input_filter.rb
@@ -8,7 +8,7 @@ class TextFilter
     # in a div.
     class PlainTextInputFilter < TextFilter
       def call
-        "<div>#{EscapeUtils.escape_html(@text, false)}</div>"
+        "<div>#{CGI.escapeHTML(@text)}</div>"
       end
     end
   end
diff --git a/test/html_pipeline/convert_filter/markdown_filter_test.rb b/test/html_pipeline/convert_filter/markdown_filter_test.rb
new file mode 100644
index 00000000..1fc5c2ba
--- /dev/null
+++ b/test/html_pipeline/convert_filter/markdown_filter_test.rb
@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+MarkdownFilter = HTMLPipeline::ConvertFilter::MarkdownFilter
+
+class HTMLPipeline
+  class MarkdownFilterTest < Minitest::Test
+    def setup
+      @haiku =
+        "Pointing at the moon\n" \
+          "Reminded of simple things\n" \
+          "Moments matter most"
+      @links =
+        "See http://example.org/ for more info"
+      @code =
+        "```\n" \
+          "def hello()" \
+          "  'world'" \
+          "end" \
+          "```"
+      @header = <<~DOC
+        # Words
+
+        Some words
+
+        ## Words
+
+        More words?
+      DOC
+    end
+
+    def test_fails_when_given_a_non_string
+      assert_raises(TypeError) { MarkdownFilter.call(23, context: {}) }
+    end
+
+    def test_gfm_enabled_by_default
+      doc = MarkdownFilter.call(@haiku)
+      assert_equal(2, Nokogiri.parse(doc).search("br").size)
+    end
+
+    def test_disabling_hardbreaks
+      doc = MarkdownFilter.call(@haiku, context: { markdown: { render: {hardbreaks: false } }} )
+      assert_equal(0, Nokogiri.parse(doc).search("br").size)
+    end
+
+    def test_fenced_code_blocks
+      doc = MarkdownFilter.call(@code)
+      assert_equal(1, Nokogiri.parse(doc).search("pre").size)
+    end
+
+    def test_fenced_code_blocks_with_language
+      doc = MarkdownFilter.call(@code.sub("```", "``` ruby"))
+      assert_equal(1, Nokogiri.parse(doc).search("pre").size)
+      assert_equal("ruby", Nokogiri.parse(doc).search("pre").first["lang"])
+    end
+
+    def test_standard_extensions
+      iframe = "<iframe src='http://www.google.com'></iframe>"
+      iframe_escaped = "&lt;iframe src='http://www.google.com'>&lt;/iframe>"
+      doc = MarkdownFilter.call(iframe, context: { markdown: { render: { unsafe_: true } } })
+      assert_equal(doc, iframe_escaped)
+    end
+
+    def test_changing_extensions
+      iframe = "<iframe src='http://www.google.com'></iframe>"
+      doc = MarkdownFilter.call(iframe, context: { markdown: { extension: { tagfilter: false }, render: { unsafe_: true }}})
+      assert_equal(doc, iframe)
+    end
+
+    def test_without_tagfilter
+      options = { render: { unsafe_: true }, extension: { tagfilter: false } }
+      script = "<script>foobar</script>"
+      results = MarkdownFilter.call(script, context: { markdown: options })
+
+      assert_equal(results, script)
+    end
+  end
+end
+
+class GFMTest < Minitest::Test
+  def setup
+    @gfm = MarkdownFilter
+    @context = { markdown: { render: { unsafe_: true } } }
+  end
+
+  def test_not_touch_single_underscores_inside_words
+    assert_equal("<p>foo_bar</p>",
+      @gfm.call("foo_bar", context: @context))
+  end
+
+  def test_not_touch_underscores_in_code_blocks
+    assert_equal("<pre><code>foo_bar_baz\n</code></pre>",
+      @gfm.call("    foo_bar_baz", context: @context))
+  end
+
+  def test_not_touch_underscores_in_pre_blocks
+    assert_equal("<pre>\nfoo_bar_baz\n</pre>",
+      @gfm.call("<pre>\nfoo_bar_baz\n</pre>", context: @context))
+  end
+
+  def test_not_touch_two_or_more_underscores_inside_words
+    assert_equal("<p>foo_bar_baz</p>",
+      @gfm.call("foo_bar_baz", context: @context))
+  end
+
+  def test_turn_newlines_into_br_tags_in_simple_cases
+    assert_equal("<p>foo<br />\nbar</p>",
+      @gfm.call("foo  \nbar", context: @context))
+  end
+
+  def test_convert_newlines_in_all_groups
+    assert_equal("<p>apple<br />\npear<br />\norange</p>\n" \
+      "<p>ruby<br />\npython<br />\nerlang</p>",
+      @gfm.call("apple  \npear  \norange  \n\nruby  \npython  \nerlang", context: @context))
+  end
+
+  def test_convert_newlines_in_even_long_groups
+    assert_equal("<p>apple<br />\npear<br />\norange<br />\nbanana</p>\n" \
+      "<p>ruby<br />\npython<br />\nerlang</p>",
+      @gfm.call("apple  \npear  \norange  \nbanana  \n\nruby  \npython  \nerlang", context: @context))
+  end
+
+  def test_not_convert_newlines_in_lists
+    options = Commonmarker::Config.merged_with_defaults({})
+    options[:extension].delete(:header_ids)
+    assert_equal("<h1>foo</h1>\n<h1>bar</h1>",
+      @gfm.call("# foo\n# bar", context: { markdown: options }))
+    assert_equal("<ul>\n<li>foo</li>\n<li>bar</li>\n</ul>",
+      @gfm.call("* foo\n* bar", context: { markdown: options }))
+  end
+end
diff --git a/test/html_pipeline/node_filter/emoji_filter_test.rb b/test/html_pipeline/node_filter/emoji_filter_test.rb
index c34013de..a20e49a7 100644
--- a/test/html_pipeline/node_filter/emoji_filter_test.rb
+++ b/test/html_pipeline/node_filter/emoji_filter_test.rb
@@ -2,6 +2,7 @@
 
 require "test_helper"
 
+EmojiFilterFilter = HTMLPipeline::NodeFilter::EmojiFilter
 class HTMLPipeline
   class EmojiFilterTest < Minitest::Test
     def setup
@@ -9,15 +10,14 @@ def setup
     end
 
     def test_emojify
-      filter = @emoji_filter.new("<p>:shipit:</p>", context: { asset_root: "https://foo.com" })
-      doc = filter.call
-      assert_match("https://foo.com/emoji/shipit.png", doc.search("img").attr("src").value)
+      orig = "<p>:shipit:</p>"
+      result = @emoji_filter.call(orig, context: { asset_root: "https://foo.com" })
+      assert_match("https://foo.com/emoji/shipit.png", result)
     end
 
     def test_uri_encoding
-      filter = @emoji_filter.new("<p>:+1:</p>", context: { asset_root: "https://foo.com" })
-      doc = filter.call
-      assert_match("https://foo.com/emoji/unicode/1f44d.png", doc.search("img").attr("src").value)
+      result = @emoji_filter.call("<p>:+1:</p>", context: { asset_root: "https://foo.com" })
+      assert_match("https://foo.com/emoji/unicode/1f44d.png", result)
     end
 
     def test_required_context_validation
@@ -28,93 +28,81 @@ def test_required_context_validation
     end
 
     def test_custom_asset_path
-      filter = @emoji_filter.new("<p>:+1:</p>", context: { asset_path: ":file_name", asset_root: "https://foo.com" })
-      doc = filter.call
-      assert_match("https://foo.com/unicode/1f44d.png", doc.search("img").attr("src").value)
+      result = @emoji_filter.call("<p>:+1:</p>", context: { asset_path: ":file_name", asset_root: "https://foo.com" })
+      assert_match("https://foo.com/unicode/1f44d.png", result)
     end
 
     def test_not_emojify_in_code_tags
       body = "<code>:shipit:</code>"
-      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com" })
-      doc = filter.call
-      assert_equal(body, doc.to_html)
+      result = @emoji_filter.call(body, context: { asset_root: "https://foo.com" })
+      assert_equal(body, result)
     end
 
     def test_not_emojify_in_tt_tags
       body = "<tt>:shipit:</tt>"
-      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com" })
-      doc = filter.call
-      assert_equal(body, doc.to_html)
+      result = @emoji_filter.call(body, context: { asset_root: "https://foo.com" })
+      assert_equal(body, result)
     end
 
     def test_not_emojify_in_pre_tags
       body = "<pre>:shipit:</pre>"
-      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com" })
-      doc = filter.call
-      assert_equal(body, doc.to_html)
+      result = @emoji_filter.call(body, context: { asset_root: "https://foo.com" })
+      assert_equal(body, result)
     end
 
     def test_not_emojify_in_custom_single_tag_foo
       body = "<foo>:shipit:</foo>"
-      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com", ignored_ancestor_tags: ["foo"] })
-      doc = filter.call
-      assert_equal(body, doc.to_html)
+      result = @emoji_filter.call(body, context: { asset_root: "https://foo.com", ignored_ancestor_tags: ["foo"] })
+      assert_equal(body, result)
     end
 
     def test_not_emojify_in_custom_multiple_tags_foo_and_bar
       body = "<bar>:shipit:</bar>"
-      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com", ignored_ancestor_tags: ["foo", "bar"] })
-      doc = filter.call
-      assert_equal(body, doc.to_html)
+      result = @emoji_filter.call(body, context: { asset_root: "https://foo.com", ignored_ancestor_tags: ["foo", "bar"] })
+      assert_equal(body, result)
     end
 
     def test_img_tag_attributes
-      body = ":shipit:"
-      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com" })
-      doc = filter.call
-      assert_equal(%(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" height="20" width="20" align="absmiddle">), doc.to_html)
+      body = "<p>:shipit:</p>"
+      result = @emoji_filter.call(body, context: { asset_root: "https://foo.com" })
+      assert_match(%(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" height="20" width="20" align="absmiddle">), result)
     end
 
     def test_img_tag_attributes_can_be_customized
-      body = ":shipit:"
-      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com", img_attrs: Hash("draggable" => "false", "height" => nil, "width" => nil, "align" => nil) })
-      doc = filter.call
-      assert_equal(%(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" draggable="false">), doc.to_html)
+      body = "<p>:shipit:</p>"
+      result = @emoji_filter.call(body, context: { asset_root: "https://foo.com", img_attrs: Hash("draggable" => "false", "height" => nil, "width" => nil, "align" => nil) })
+      assert_match(%(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" draggable="false">), result)
     end
 
     def test_img_attrs_value_can_accept_proclike_object
       remove_colons = ->(name) { name.delete(":") }
-      body = ":shipit:"
-      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com", img_attrs: Hash("title" => remove_colons) })
-      doc = filter.call
-      assert_equal(%(<img class="emoji" title="shipit" alt=":shipit:" src="https://foo.com/emoji/shipit.png" height="20" width="20" align="absmiddle">), doc.to_html)
+      body = "<p>:shipit:</p>"
+      result = @emoji_filter.call(body, context: { asset_root: "https://foo.com", img_attrs: Hash("title" => remove_colons) })
+      assert_match(%(<img class="emoji" title="shipit" alt=":shipit:" src="https://foo.com/emoji/shipit.png" height="20" width="20" align="absmiddle">), result)
     end
 
     def test_img_attrs_can_accept_symbolized_keys
-      body = ":shipit:"
-      filter = @emoji_filter.new(body, context: { asset_root: "https://foo.com", img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
-      doc = filter.call
-      assert_equal(%(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" draggable="false">), doc.to_html)
+      body = "<p>:shipit:</p>"
+      result = @emoji_filter.call(body, context: { asset_root: "https://foo.com", img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
+      assert_match(%(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" draggable="false">), result)
     end
 
     def test_works_with_gemoji
       require "gemojione"
 
       HTMLPipeline::NodeFilter::EmojiFilter.stub(:gemoji_loaded?, false) do
-        body = ":flag_ar:"
-        filter = HTMLPipeline::NodeFilter::EmojiFilter.new(body, context: { asset_root: "https://foo.com" })
-        doc = filter.call
-        assert_equal(%(<img class="emoji" title=":flag_ar:" alt=":flag_ar:" src="https://foo.com/emoji/1f1e6-1f1f7.png" height="20" width="20" align="absmiddle">), doc.to_html)
+        body = "<span>:flag_ar:</span>"
+        result = HTMLPipeline::NodeFilter::EmojiFilter.call(body, context: { asset_root: "https://foo.com" })
+        assert_equal(%(<span><img class="emoji" title=":flag_ar:" alt=":flag_ar:" src="https://foo.com/emoji/1f1e6-1f1f7.png" height="20" width="20" align="absmiddle"></span>), result)
       end
     end
 
     def test_gemoji_can_accept_symbolized_keys
       require "gemojione"
       HTMLPipeline::NodeFilter::EmojiFilter.stub(:gemoji_loaded?, false) do
-        body = ":flag_ar:"
-        filter = HTMLPipeline::NodeFilter::EmojiFilter.new(body, context: { asset_root: "https://coolwebsite.com", img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
-        doc = filter.call
-        assert_equal(%(<img class="emoji" title=":flag_ar:" alt=":flag_ar:" src="https://coolwebsite.com/emoji/1f1e6-1f1f7.png" draggable="false">), doc.to_html)
+        body = "<span>:flag_ar:</span>"
+        result = HTMLPipeline::NodeFilter::EmojiFilter.call(body, context: { asset_root: "https://coolwebsite.com", img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
+        assert_equal(%(<span><img class="emoji" title=":flag_ar:" alt=":flag_ar:" src="https://coolwebsite.com/emoji/1f1e6-1f1f7.png" draggable="false"></span>), result)
       end
     end
   end
diff --git a/test/html_pipeline/node_filter/https_filter_test.rb b/test/html_pipeline/node_filter/https_filter_test.rb
index 5a98ed30..ca2ec92d 100644
--- a/test/html_pipeline/node_filter/https_filter_test.rb
+++ b/test/html_pipeline/node_filter/https_filter_test.rb
@@ -7,47 +7,27 @@
 class HTMLPipeline
   class HttpsFilterTest < Minitest::Test
     def setup
-      @filter = HttpsFilter
       @options = { base_url: "http://github.com" }
     end
 
     def test_http
       assert_equal(%(<a href="https://github.com">github.com</a>),
-        @filter.to_html(%(<a href="http://github.com">github.com</a>), context: @options))
+      HttpsFilter.call(%(<a href="http://github.com">github.com</a>), context: @options))
     end
 
     def test_https
       assert_equal(%(<a href="https://github.com">github.com</a>),
-        @filter.to_html(%(<a href="https://github.com">github.com</a>), context: @options))
+        HttpsFilter.call(%(<a href="https://github.com">github.com</a>), context: @options))
     end
 
     def test_subdomain
-      assert_equal(%(<a href="http://help.github.com">github.com</a>),
-        @filter.to_html(%(<a href="http://help.github.com">github.com</a>), context: @options))
+      assert_equal(%(<a href="https://help.github.com">github.com</a>),
+        HttpsFilter.call(%(<a href="http://help.github.com">github.com</a>), context: @options))
     end
 
     def test_other
-      assert_equal(%(<a href="http://github.io">github.io</a>),
-        @filter.to_html(%(<a href="http://github.io">github.io</a>), context: @options))
-    end
-
-    def test_uses_http_url_over_base_url
-      options = { http_url: "http://github.com", base_url: "https://github.com" }
-
-      assert_equal(%(<a href="https://github.com">github.com</a>),
-        @filter.to_html(%(<a href="http://github.com">github.com</a>), context: options))
-    end
-
-    def test_only_http_url
-      options = { http_url: "http://github.com" }
-
-      assert_equal(%(<a href="https://github.com">github.com</a>),
-        @filter.to_html(%(<a href="http://github.com">github.com</a>), context: options))
-    end
-
-    def test_validates_http_url
-      exception = assert_raises(ArgumentError) { @filter.to_html("") }
-      assert_match("HTMLPipeline::NodeFilter::HttpsFilter: :http_url", exception.message)
+      assert_equal(%(<a href="https://github.io">github.io</a>),
+        HttpsFilter.call(%(<a href="http://github.io">github.io</a>), context: @options))
     end
   end
 end
diff --git a/test/html_pipeline/node_filter/image_max_width_filter_test.rb b/test/html_pipeline/node_filter/image_max_width_filter_test.rb
index 6d67173c..c1b42ccf 100644
--- a/test/html_pipeline/node_filter/image_max_width_filter_test.rb
+++ b/test/html_pipeline/node_filter/image_max_width_filter_test.rb
@@ -9,46 +9,41 @@ def setup
     end
 
     def test_rewrites_image_style_tags
-      body = "<p>Screenshot: <img src='screenshot.png'></p>"
-      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
-
-      res = @filter.call(doc)
-      assert_equal_html('<p>Screenshot: <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
-        res.to_html)
+      body = '<p>Screenshot: <img src="screenshot.png"></p>'
+      res = @filter.call(body)
+      assert_equal('<p>Screenshot: <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
+        res)
     end
 
     def test_leaves_existing_image_style_tags_alone
-      body = "<p><img src='screenshot.png' style='width:100px;'></p>"
-      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
+      body = '<p><img src="screenshot.png" style="width:100px;"></p>'
 
-      res = @filter.call(doc)
-      assert_equal_html('<p><img src="screenshot.png" style="width:100px;"></p>',
-        res.to_html)
+      res = @filter.call(body)
+      assert_equal('<p><img src="screenshot.png" style="width:100px;"></p>',
+        res)
     end
 
     def test_links_to_image
-      body = "<p>Screenshot: <img src='screenshot.png'></p>"
-      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
+      body = '<p>Screenshot: <img src="screenshot.png"></p>'
 
-      res = @filter.call(doc)
-      assert_equal_html('<p>Screenshot: <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
-        res.to_html)
+      res = @filter.call(body)
+      assert_equal('<p>Screenshot: <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
+        res)
     end
 
     def test_doesnt_link_to_image_when_already_linked
-      body = "<p>Screenshot: <a href='blah.png'><img src='screenshot.png'></a></p>"
-      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
+      body = '<p>Screenshot: <a href="blah.png"><img src="screenshot.png"></a></p>'
 
-      res = @filter.call(doc)
-      assert_equal_html('<p>Screenshot: <a href="blah.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
-        res.to_html)
+      res = @filter.call(body)
+      assert_equal('<p>Screenshot: <a href="blah.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
+        res)
     end
 
     def test_doesnt_screw_up_inlined_images
-      body = "<p>Screenshot <img src='screenshot.png'>, yes, this is a <b>screenshot</b> indeed.</p>"
-      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
+      body = '<p>Screenshot <img src="screenshot.png">, yes, this is a <b>screenshot</b> indeed.</p>'
 
-      assert_equal_html('<p>Screenshot <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a>, yes, this is a <b>screenshot</b> indeed.</p>', @filter.call(doc).to_html)
+      res = @filter.call(body)
+      assert_equal('<p>Screenshot <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a>, yes, this is a <b>screenshot</b> indeed.</p>', res)
     end
   end
 end
diff --git a/test/html_pipeline/node_filter/mention_filter_test.rb b/test/html_pipeline/node_filter/mention_filter_test.rb
index 0bdc3514..1ddd25cf 100644
--- a/test/html_pipeline/node_filter/mention_filter_test.rb
+++ b/test/html_pipeline/node_filter/mention_filter_test.rb
@@ -8,92 +8,79 @@ def setup
       @filter = HTMLPipeline::NodeFilter::MentionFilter
       @context = { base_url: "/", info_url: nil, username_pattern: nil }
 
-      @pipeline = HTMLPipeline.new(text_filters: [
-        HTMLPipeline::TextFilter::MarkdownFilter,
-      ], node_filters: [
-        HTMLPipeline::NodeFilter::MentionFilter,
+      @pipeline = HTMLPipeline.new(convert_filter:
+        HTMLPipeline::ConvertFilter::MarkdownFilter.new,
+      node_filters: [
+        HTMLPipeline::NodeFilter::MentionFilter.new,
       ])
     end
 
     def mentioned_usernames(body)
       result = {}
-      @pipeline.call(body, result: result)
+      result = @pipeline.call(body, result: result)
       result[:mentioned_usernames]
     end
-
-    def test_filtering_a_documentfragment
-      body = "<p>@kneath: check it out.</p>"
-      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
-
-      res  = @filter.call(doc, context: @context)
-      assert_same(doc, res)
-
-      link = '<a href="/kneath" class="user-mention">@kneath</a>'
-      assert_equal("<p>#{link}: check it out.</p>",
-        res.to_html)
-    end
-
+    @pipeline =
     def test_filtering_plain_text
       body = "<p>@kneath: check it out.</p>"
       res  = @filter.call(body, context: @context)
 
       link = '<a href="/kneath" class="user-mention">@kneath</a>'
       assert_equal("<p>#{link}: check it out.</p>",
-        res.to_html)
+        res)
     end
 
     def test_not_replacing_mentions_in_pre_tags
       body = "<pre>@kneath: okay</pre>"
-      assert_equal(body, @filter.call(body, context: @context).to_html)
+      assert_equal(body, @filter.call(body, context: @context))
     end
 
     def test_not_replacing_mentions_in_code_tags
       body = "<p><code>@kneath:</code> okay</p>"
-      assert_equal(body, @filter.call(body, context: @context).to_html)
+      assert_equal(body, @filter.call(body, context: @context))
     end
 
     def test_not_replacing_mentions_in_style_tags
       body = "<style>@media (min-width: 768px) { color: red; }</style>"
-      assert_equal(body, @filter.call(body, context: @context).to_html)
+      assert_equal(body, @filter.call(body, context: @context))
     end
 
     def test_not_replacing_mentions_in_links
       body = "<p><a>@kneath</a> okay</p>"
-      assert_equal(body, @filter.call(body, context: @context).to_html)
+      assert_equal(body, @filter.call(body, context: @context))
     end
 
     def test_entity_encoding_and_whatnot
       body = "<p>@&#x6b;neath what's up</p>"
-      link = '<a href="/kneath" class="user-mention">@kneath</a>'
-      assert_equal("<p>#{link} what's up</p>", @filter.call(body, context: @context).to_html)
+      assert_equal(body, @filter.call(body, context: @context))
     end
 
     def test_html_injection
       body = "<p>@kneath &lt;script>alert(0)&lt;/script></p>"
       link = '<a href="/kneath" class="user-mention">@kneath</a>'
-      assert_equal("<p>#{link} &lt;script&gt;alert(0)&lt;/script&gt;</p>",
-        @filter.call(body, context: @context).to_html)
+      assert_equal("<p>#{link} &lt;script>alert(0)&lt;/script></p>",
+        @filter.call(body, context: @context))
     end
 
     def test_base_url_slash
       body = "<p>Hi, @jch!</p>"
       link = '<a href="/jch" class="user-mention">@jch</a>'
       assert_equal("<p>Hi, #{link}!</p>",
-        @filter.call(body, context: { base_url: "/" }).to_html)
+        @filter.call(body, context: { base_url: "/" }))
     end
 
     def test_base_url_under_custom_route
       body = "<p>Hi, @jch!</p>"
       link = '<a href="/userprofile/jch" class="user-mention">@jch</a>'
       assert_equal("<p>Hi, #{link}!</p>",
-        @filter.call(body, context: @context.merge({ base_url: "/userprofile" })).to_html)
+        @filter.call(body, context: @context.merge({ base_url: "/userprofile" })))
     end
 
     def test_base_url_slash_with_tilde
       body = "<p>Hi, @jch!</p>"
       link = '<a href="/~jch" class="user-mention">@jch</a>'
       assert_equal("<p>Hi, #{link}!</p>",
-        @filter.call(body, context: @context.merge({ base_url: "/~" })).to_html)
+        @filter.call(body, context: @context.merge({ base_url: "/~" })))
     end
 
     def test_matches_usernames_in_body
@@ -173,32 +160,31 @@ def test_mention_at_end_of_parenthetical_sentence
 
     def test_username_pattern_can_be_customized
       body = "<p>@_abc: test.</p>"
-      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
 
-      res  = @filter.call(doc, context: { base_url: "/", username_pattern: /(_[a-z]{3})/ })
+      res  = @filter.call(body, context: { base_url: "/", username_pattern: /(_[a-z]{3})/ })
 
       link = '<a href="/_abc" class="user-mention">@_abc</a>'
       assert_equal("<p>#{link}: test.</p>",
-        res.to_html)
+        res)
     end
 
     def test_filter_does_not_create_a_new_object_for_default_username_pattern
       body = "<div>@test</div>"
-      doc = Nokogiri::HTML::DocumentFragment.parse(body)
 
-      @filter.call(doc.clone)
+      @filter.call(body.dup)
       pattern_count = HTMLPipeline::NodeFilter::MentionFilter::MENTION_PATTERNS.length
-      @filter.call(doc.clone)
 
+      @filter.call(body.dup)
       assert_equal(pattern_count, HTMLPipeline::NodeFilter::MentionFilter::MENTION_PATTERNS.length)
-      @filter.call(doc.clone, context: { username_pattern: /test/ })
+
+      @filter.call(body.clone, context: { username_pattern: /test/ })
       assert_equal(pattern_count + 1, HTMLPipeline::NodeFilter::MentionFilter::MENTION_PATTERNS.length)
     end
 
     def test_mention_link_filter
-      filter = HTMLPipeline::NodeFilter::MentionFilter.new(nil)
-      expected = "<a href='/hubot' class='user-mention'>@hubot</a>"
-      assert_equal(expected, filter.mention_link_filter("@hubot"))
+      result = HTMLPipeline::NodeFilter::MentionFilter.call("<p>@hubot</p>")
+      expected = '<p><a href="/hubot" class="user-mention">@hubot</a></p>'
+      assert_equal(expected, result)
     end
   end
 end
diff --git a/test/html_pipeline/node_filter/syntax_highlight_filter_test.rb b/test/html_pipeline/node_filter/syntax_highlight_filter_test.rb
index adae8fbe..cba3152d 100644
--- a/test/html_pipeline/node_filter/syntax_highlight_filter_test.rb
+++ b/test/html_pipeline/node_filter/syntax_highlight_filter_test.rb
@@ -8,65 +8,53 @@
 class HTMLPipeline
   class SyntaxHighlightFilterTest < Minitest::Test
     def test_highlight_default
-      filter = SyntaxHighlightFilter.new(\
+      result = SyntaxHighlightFilter.call(\
         "<pre>hello</pre>", context: { highlight: "coffeescript" }
       )
 
-      doc = filter.call
+      doc = Nokogiri.parse(result)
       refute_empty(doc.css(".highlight"))
       refute_empty(doc.css(".highlight-coffeescript"))
     end
 
     def test_highlight_default_will_not_override
-      filter = SyntaxHighlightFilter.new(\
+      result = SyntaxHighlightFilter.call(\
         "<pre lang='c'>hello</pre>",  context: { highlight: "coffeescript" }
       )
 
-      doc = filter.call
+      doc = Nokogiri.parse(result)
       assert_empty(doc.css(".highlight-coffeescript"))
       refute_empty(doc.css(".highlight-c"))
     end
 
     def test_highlight_does_not_remove_pre_tag
-      filter = SyntaxHighlightFilter.new(\
+      result = SyntaxHighlightFilter.call(\
         "<pre lang='c'>hello</pre>",  context: { highlight: "coffeescript" }
       )
 
-      doc = filter.call
+      doc = Nokogiri.parse(result)
 
       refute_empty(doc.css("pre"))
     end
 
     def test_highlight_allows_optional_scope
-      filter = SyntaxHighlightFilter.new(\
+      result = SyntaxHighlightFilter.call(\
         "<pre lang='c'>hello</pre>",  context: { highlight: "coffeescript", scope: "test-scope" }
       )
 
-      doc = filter.call
+      doc = Nokogiri.parse(result)
 
       refute_empty(doc.css("pre.test-scope"))
     end
 
     def test_highlight_keeps_the_pre_tags_lang
-      filter = SyntaxHighlightFilter.new(\
+      result = SyntaxHighlightFilter.call(\
         "<pre lang='c'>hello</pre>",  context: { highlight: "coffeescript" }
       )
 
-      doc = filter.call
+      doc = Nokogiri.parse(result)
 
       refute_empty(doc.css("pre[lang=c]"))
     end
-
-    def test_highlight_handles_nested_pre_tags
-      inner_code = "<pre>console.log('i am nested!')</pre>"
-      escaped = EscapeUtils.escape_html(inner_code)
-      html = "<pre lang='html'>#{escaped}</pre>"
-      filter = SyntaxHighlightFilter.new(html, context: { highlight: "html" })
-
-      doc = filter.call
-
-      assert_equal(2, doc.css("span[class=nt]").length)
-      assert_equal(EscapeUtils.unescape_html(escaped), doc.inner_text)
-    end
   end
 end
diff --git a/test/html_pipeline/node_filter/table_of_contents_filter_test.rb b/test/html_pipeline/node_filter/table_of_contents_filter_test.rb
index 3716fb6f..42995182 100644
--- a/test/html_pipeline/node_filter/table_of_contents_filter_test.rb
+++ b/test/html_pipeline/node_filter/table_of_contents_filter_test.rb
@@ -8,36 +8,41 @@ class TableOfContentsFilterTest < Minitest::Test
       TocFilter = HTMLPipeline::NodeFilter::TableOfContentsFilter
 
       TocPipeline =
-        HTMLPipeline.new(node_filters: [
-          TocFilter,
+        HTMLPipeline.new(convert_filter: HTMLPipeline::ConvertFilter::MarkdownFilter.new, node_filters: [
+          TocFilter.new,
         ])
 
-      def toc(content)
-        result = {}
-        TocPipeline.call(content, context: {}, result: result)
-        result[:toc]
+      def toc_s(content)
+        result = TocPipeline.call(content, context: {}, result: result)
+        result[:toc].to_s
       end
 
-      def test_anchors_are_added_properly
-        orig = %(<h1>Ice cube</h1><p>Will swarm on any motherfucker in a blue uniform</p>)
-        assert_includes(TocFilter.call(orig).to_s, "<a id=")
+      def test_anchors_and_list_are_added_properly
+        orig = %(# Ice cube\n\nWill swarm on any motherfucker in a blue uniform)
+        result = TocPipeline.call(orig)
+        assert_includes(result[:output], "<a href=")
       end
 
-      def test_custom_anchor_icons_added_properly
-        orig = %(<h1>Ice cube</h1>)
-        expected = %(<h1>\n<a id="ice-cube" class="anchor" href="#ice-cube" aria-hidden="true">#</a>Ice cube</h1>)
-
-        assert_equal(expected, TocFilter.call(orig, context: { anchor_icon: "#" }).to_s)
+      def test_custom_anchor_html_added_properly
+        orig = %(# Ice cube)
+        expected = %(<h1><a href="#ice-cube" aria-hidden="true" id="ice-cube" class="anchor">#</a>Ice cube</h1>)
+        pipeline = HTMLPipeline.new(convert_filter: HTMLPipeline::ConvertFilter::MarkdownFilter, node_filters: [
+          TocFilter.new(context: { anchor_html: "#" }),
+        ])
+        result = pipeline.call(orig)
+        assert_equal(expected, result[:output])
       end
 
       def test_toc_list_added_properly
-        orig = %(<h1>Ice cube</h1><p>Will swarm on any motherfucker in a blue uniform</p>)
-        assert_includes(toc(orig), %(<ul class="section-nav">\n<li><a href="))
+        orig = %(# Ice cube\n\nWill swarm on any motherfucker in a blue uniform)
+        result = TocPipeline.call(orig)
+        assert_equal(result[:toc].first, {:href=>"#ice-cube", :text=>"Ice cube"})
       end
 
       def test_anchors_have_sane_names
-        orig = %(<h1>Dr Dre</h1><h1>Ice Cube</h1><h1>Eazy-E</h1><h1>MC Ren</h1>)
-        result = TocFilter.call(orig).to_s
+        orig = %(# Dr. Dre\n\n# Ice Cube\n\n# Eazy-E\n\n# MC Ren)
+
+        result = TocPipeline.call(orig)[:output]
 
         assert_includes(result, '"dr-dre"')
         assert_includes(result, '"ice-cube"')
@@ -46,99 +51,131 @@ def test_anchors_have_sane_names
       end
 
       def test_anchors_have_aria_hidden
-        orig = "<h1>Straight Outta Compton</h1>"
-        result = TocFilter.call(orig).to_s
+        orig = "# Straight Outta Compton"
+        result = TocPipeline.call(orig)[:output]
         assert_includes(result, 'aria-hidden="true"')
       end
 
       def test_toc_hrefs_have_sane_values
-        orig = %(<h1>Dr Dre</h1><h1>Ice Cube</h1><h1>Eazy-E</h1><h1>MC Ren</h1>)
-        toc = TocFilter.call(orig).to_s
-        assert_includes(toc, '"#dr-dre"')
-        assert_includes(toc, '"#ice-cube"')
-        assert_includes(toc, '"#eazy-e"')
-        assert_includes(toc, '"#mc-ren"')
+        orig = %(# Dr. Dre\n\n# Ice Cube\n\n# Eazy-E\n\n# MC Ren)
+        result = TocPipeline.call(orig)[:output]
+
+        assert_includes(result, '"#dr-dre"')
+        assert_includes(result, '"#ice-cube"')
+        assert_includes(result, '"#eazy-e"')
+        assert_includes(result, '"#mc-ren"')
       end
 
       def test_dupe_headers_have_unique_trailing_identifiers
-        orig = %(<h1>Straight Outta Compton</h1>
-             <h2>Dopeman</h2>
-             <h3>Express Yourself</h3>
-             <h1>Dopeman</h1>)
+        orig = <<~STR
+             # Straight Outta Compton
+
+             ## Dopeman
 
-        result = TocFilter.call(orig).to_s
+             ### Express Yourself
+
+             # Dopeman
+             STR
+
+        result = TocPipeline.call(orig)[:output]
 
         assert_includes(result, '"dopeman"')
         assert_includes(result, '"dopeman-1"')
       end
 
       def test_dupe_headers_have_unique_toc_anchors
-        orig = %(<h1>Straight Outta Compton</h1>
-              <h2>Dopeman</h2>
-              <h3>Express Yourself</h3>
-              <h1>Dopeman</h1>)
+        orig = <<~STR
+             # Straight Outta Compton
+
+             ## Dopeman
+
+             ### Express Yourself
 
-        assert_includes(toc(orig), '"#dopeman"')
-        assert_includes(toc(orig), '"#dopeman-1"')
+             # Dopeman
+             STR
+
+        assert_includes(toc_s(orig), '"#dopeman"')
+        assert_includes(toc_s(orig), '"#dopeman-1"')
       end
 
       def test_all_header_tags_are_found_when_adding_anchors
-        orig = %(<h1>"Funky President" by James Brown</h1>
-             <h2>"It's My Thing" by Marva Whitney</h2>
-             <h3>"Boogie Back" by Roy Ayers</h3>
-             <h4>"Feel Good" by Fancy</h4>
-             <h5>"Funky Drummer" by James Brown</h5>
-             <h6>"Ruthless Villain" by Eazy-E</h6>
-             <h7>"Be Thankful for What You Got" by William DeVaughn</h7>)
+        orig = <<~STR
+                # "Funky President" by James Brown
+                ## "It's My Thing" by Marva Whitney
+                ### "Boogie Back" by Roy Ayers
+                #### "Feel Good" by Fancy
+                ##### "Funky Drummer" by James Brown
+                ###### "Ruthless Villain" by Eazy-E
+              STR
+
+              result = TocPipeline.call(orig, context: {}, result: result)
 
-        doc = TocFilter.call(orig)
+        doc = Nokogiri::HTML(result[:output])
 
         assert_equal(6, doc.search("a").size)
       end
 
       def test_toc_outputs_escaped_html
-        orig = %(<h1>&lt;img src="x" onerror="alert(42)"&gt;</h1>)
+        orig = %(# &lt;img src="x" onerror="alert(42)"&gt;)
 
-        refute_includes(toc(orig), %(<img src="x" onerror="alert(42)">))
+        refute_includes(toc_s(orig), %(<img src="x" onerror="alert(42)">))
       end
 
       def test_toc_is_complete
-        orig = %(<h1>"Funky President" by James Brown</h1>
-              <h2>"It's My Thing" by Marva Whitney</h2>
-              <h3>"Boogie Back" by Roy Ayers</h3>
-              <h4>"Feel Good" by Fancy</h4>
-              <h5>"Funky Drummer" by James Brown</h5>
-              <h6>"Ruthless Villain" by Eazy-E</h6>
-              <h7>"Be Thankful for What You Got" by William DeVaughn</h7>)
-
-        expected = %(<ul class="section-nav">\n<li><a href="#funky-president-by-james-brown">&quot;Funky President&quot; by James Brown</a></li>\n<li><a href="#its-my-thing-by-marva-whitney">&quot;It&#39;s My Thing&quot; by Marva Whitney</a></li>\n<li><a href="#boogie-back-by-roy-ayers">&quot;Boogie Back&quot; by Roy Ayers</a></li>\n<li><a href="#feel-good-by-fancy">&quot;Feel Good&quot; by Fancy</a></li>\n<li><a href="#funky-drummer-by-james-brown">&quot;Funky Drummer&quot; by James Brown</a></li>\n<li><a href="#ruthless-villain-by-eazy-e">&quot;Ruthless Villain&quot; by Eazy-E</a></li>\n</ul>)
-
-        assert_equal(expected, toc(orig))
+        orig = <<~STR
+                # "Funky President" by James Brown
+                ## "It's My Thing" by Marva Whitney
+                ### "Boogie Back" by Roy Ayers
+                #### "Feel Good" by Fancy
+                ##### "Funky Drummer" by James Brown
+                ###### "Ruthless Villain" by Eazy-E
+              STR
+
+              result = TocPipeline.call(orig)[:toc]
+        expected = [{:href=>"#funky-president-by-james-brown", :text=>"&quot;Funky President&quot; by James Brown"},
+                     {:href=>"#its-my-thing-by-marva-whitney", :text=>"&quot;It's My Thing&quot; by Marva Whitney"},
+                     {:href=>"#boogie-back-by-roy-ayers", :text=>"&quot;Boogie Back&quot; by Roy Ayers"},
+                     {:href=>"#feel-good-by-fancy", :text=>"&quot;Feel Good&quot; by Fancy"},
+                     {:href=>"#funky-drummer-by-james-brown", :text=>"&quot;Funky Drummer&quot; by James Brown"},
+                     {:href=>"#ruthless-villain-by-eazy-e", :text=>"&quot;Ruthless Villain&quot; by Eazy-E"}]
+
+                     0..6.times do |i|
+
+          assert_equal(expected[i], result[i])
+        end
       end
 
-      if RUBY_VERSION > "1.9" # not sure how to make this work on 1.8.7
+      def test_anchors_with_utf8_characters
+        orig = <<~STR
+              # 日本語
 
-        def test_anchors_with_utf8_characters
-          orig = %(<h1>日本語</h1>
-               <h1>Русский</h1)
+              # Русский
+              STR
 
-          rendered_h1s = TocFilter.call(orig).search("h1").map(&:to_s)
+        rendered_h1s = Nokogiri::HTML(TocPipeline.call(orig)[:output]).search("h1").map(&:to_s)
 
-          assert_equal("<h1>\n<a id=\"日本語\" class=\"anchor\" href=\"#%E6%97%A5%E6%9C%AC%E8%AA%9E\" aria-hidden=\"true\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"></span></a>日本語</h1>",
-            rendered_h1s[0])
-          assert_equal("<h1>\n<a id=\"Русский\" class=\"anchor\" href=\"#%D0%A0%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9\" aria-hidden=\"true\"><span aria-hidden=\"true\" class=\"octicon octicon-link\"></span></a>Русский</h1>",
-            rendered_h1s[1])
-        end
+        assert_equal("<h1>\n<a href=\"#%E6%97%A5%E6%9C%AC%E8%AA%9E\" aria-hidden=\"true\" id=\"%E6%97%A5%E6%9C%AC%E8%AA%9E\" class=\"anchor\"><span aria-hidden=\"true\" class=\"anchor\"></span></a>日本語</h1>",
+          rendered_h1s[0])
+        assert_equal("<h1>\n<a href=\"#%D1%80%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9\" aria-hidden=\"true\" id=\"%D1%80%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9\" class=\"anchor\"><span aria-hidden=\"true\" class=\"anchor\"></span></a>Русский</h1>",
+          rendered_h1s[1])
+      end
+
+      def test_toc_with_utf8_characters
+        orig = <<~STR
+        # 日本語
 
-        def test_toc_with_utf8_characters
-          orig = %(<h1>日本語</h1>
-                <h1>Русский</h1)
+        # Русский
+        STR
 
-          rendered_toc = Nokogiri::HTML::DocumentFragment.parse(toc(orig)).to_s
+        result = TocPipeline.call(orig)[:toc]
 
-          expected = %(<ul class="section-nav">\n<li><a href="#%E6%97%A5%E6%9C%AC%E8%AA%9E">日本語</a></li>\n<li><a href="#%D0%A0%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9">Русский</a></li>\n</ul>)
+        expected = [{:href=>"#%E6%97%A5%E6%9C%AC%E8%AA%9E",
+                     :text=>"日本語"},
+                     {:href=>"#%D1%80%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9",
+                    :text => "Русский"}]
 
-          assert_equal(expected, rendered_toc)
+        0..2.times do |i|
+          assert_equal(expected[i], result[i])
         end
       end
     end
diff --git a/test/html_pipeline/node_filter/team_mention_filter_test.rb b/test/html_pipeline/node_filter/team_mention_filter_test.rb
index 710a421e..101c5961 100644
--- a/test/html_pipeline/node_filter/team_mention_filter_test.rb
+++ b/test/html_pipeline/node_filter/team_mention_filter_test.rb
@@ -8,16 +8,15 @@ def setup
       @filter = HTMLPipeline::NodeFilter::TeamMentionFilter
 
       @pipeline =
-        HTMLPipeline.new(text_filters: [
-          HTMLPipeline::TextFilter::MarkdownFilter,
-        ], node_filters: [
-          HTMLPipeline::NodeFilter::TeamMentionFilter,
+        HTMLPipeline.new(convert_filter: HTMLPipeline::ConvertFilter::MarkdownFilter.new,
+        node_filters: [
+          HTMLPipeline::NodeFilter::TeamMentionFilter.new,
         ])
     end
 
     def mentioned_teams(body)
       result = {}
-      @pipeline.call(body, result: result)
+      result = @pipeline.call(body, result: result)
       result[:mentioned_teams]
     end
 
@@ -27,79 +26,67 @@ def test_filtering_plain_text
 
       link = '<a href="/github/team" class="team-mention">@github/team</a>'
       assert_equal("<p>#{link}: check it out.</p>",
-        res.to_html)
-    end
-
-    def test_filtering_a_documentfragment
-      body = "<p>@github/team: check it out.</p>"
-      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
-
-      res  = @filter.call(doc, context: { base_url: "/" })
-      assert_same(doc, res)
-
-      link = '<a href="/github/team" class="team-mention">@github/team</a>'
-      assert_equal("<p>#{link}: check it out.</p>",
-        res.to_html)
+        res)
     end
 
     def test_not_replacing_mentions_in_pre_tags
       body = "<pre>@github/team: okay</pre>"
-      assert_equal(body, @filter.call(body).to_html)
+      assert_equal(body, @filter.call(body))
     end
 
     def test_not_replacing_mentions_in_code_tags
       body = "<p><code>@github/team:</code> okay</p>"
-      assert_equal(body, @filter.call(body).to_html)
+      assert_equal(body, @filter.call(body))
     end
 
     def test_not_replacing_mentions_in_style_tags
       body = "<style>@github/team (min-width: 768px) { color: red; }</style>"
-      assert_equal(body, @filter.call(body).to_html)
+      assert_equal(body, @filter.call(body))
     end
 
     def test_not_replacing_mentions_in_links
       body = "<p><a>@github/team</a> okay</p>"
-      assert_equal(body, @filter.call(body).to_html)
+      assert_equal(body, @filter.call(body))
     end
 
     def test_entity_encoding_and_whatnot
       body = "<p>@github&#47team what's up</p>"
       link = '<a href="/github/team" class="team-mention">@github/team</a>'
-      assert_equal("<p>#{link} what's up</p>", @filter.call(body, context: { base_url: "/" }).to_html)
+      assert_equal("<p>#{link} what's up</p>", @filter.call(body, context: { base_url: "/" }))
     end
 
     def test_html_injection
       body = "<p>@github/team &lt;script>alert(0)&lt;/script></p>"
       link = '<a href="/github/team" class="team-mention">@github/team</a>'
-      assert_equal("<p>#{link} &lt;script&gt;alert(0)&lt;/script&gt;</p>",
-        @filter.call(body, context: { base_url: "/" }).to_html)
+      assert_equal("<p>#{link} &lt;script>alert(0)&lt;/script></p>",
+        @filter.call(body, context: { base_url: "/" }))
     end
 
     def test_links_to_nothing_with_user_mention
       body = "<p>Hi, @kneath</p>"
       assert_equal("<p>Hi, @kneath</p>",
-        @filter.call(body, context: { base_url: "/" }).to_html)
+        @filter.call(body, context: { base_url: "/" }))
     end
 
     def test_base_url_slash
       body = "<p>Hi, @github/team!</p>"
       link = '<a href="/github/team" class="team-mention">@github/team</a>'
       assert_equal("<p>Hi, #{link}!</p>",
-        @filter.call(body, context: { base_url: "/" }).to_html)
+        @filter.call(body, context: { base_url: "/" }))
     end
 
     def test_base_url_under_custom_route
       body = "<p>Hi, @org/team!</p>"
       link = '<a href="www.github.com/org/team" class="team-mention">@org/team</a>'
       assert_equal("<p>Hi, #{link}!</p>",
-        @filter.call(body, context: { base_url: "www.github.com" }).to_html)
+        @filter.call(body, context: { base_url: "www.github.com" }))
     end
 
     def test_base_url_slash_with_tilde
       body = "<p>Hi, @github/team!</p>"
       link = '<a href="/~github/team" class="team-mention">@github/team</a>'
       assert_equal("<p>Hi, #{link}!</p>",
-        @filter.call(body, context: { base_url: "/~" }).to_html)
+        @filter.call(body, context: { base_url: "/~" }))
     end
 
     def test_multiple_team_mentions
@@ -107,7 +94,7 @@ def test_multiple_team_mentions
       link_whale = '<a href="/github/whale" class="team-mention">@github/whale</a>'
       link_donut = '<a href="/github/donut" class="team-mention">@github/donut</a>'
       assert_equal("<p>Hi, #{link_whale} and #{link_donut}!</p>",
-        @filter.call(body).to_html)
+        @filter.call(body))
     end
 
     def test_matches_teams_in_body
@@ -187,19 +174,18 @@ def test_mention_at_end_of_parenthetical_sentence
 
     def test_team_pattern_can_be_customized
       body = "<p>@_abc/XYZ: test</p>"
-      doc  = Nokogiri::HTML::DocumentFragment.parse(body)
 
-      res  = @filter.call(doc, context: { team_pattern: %r{@(_[a-z]{3})/([A-Z]{3})} })
+      res  = @filter.call(body, context: { team_pattern: %r{@(_[a-z]{3})/([A-Z]{3})} })
 
       link = '<a href="/_abc/XYZ" class="team-mention">@_abc/XYZ</a>'
       assert_equal("<p>#{link}: test</p>",
-        res.to_html)
+        res)
     end
 
     def test_mention_link_filter
-      filter = HTMLPipeline::NodeFilter::TeamMentionFilter.new(nil)
-      expected = "<a href='/bot/hubot' class='team-mention'>@bot/hubot</a>"
-      assert_equal(expected, filter.mention_link_filter("@bot/hubot"))
+      result = HTMLPipeline::NodeFilter::TeamMentionFilter.call("<p>@bot/hubot</p>")
+      expected = "<p><a href=\"/bot/hubot\" class=\"team-mention\">@bot/hubot</a></p>"
+      assert_equal(expected, result)
     end
   end
 end
diff --git a/test/html_pipeline/text_filter/markdown_filter_test.rb b/test/html_pipeline/text_filter/markdown_filter_test.rb
deleted file mode 100644
index 64dba8cf..00000000
--- a/test/html_pipeline/text_filter/markdown_filter_test.rb
+++ /dev/null
@@ -1,180 +0,0 @@
-# frozen_string_literal: true
-
-require "test_helper"
-
-MarkdownFilter = HTMLPipeline::TextFilter::MarkdownFilter
-
-class HTMLPipeline
-  class MarkdownFilterTest < Minitest::Test
-    class CustomRenderer < CommonMarker::HtmlRenderer
-      def header(node)
-        block do
-          text = node.first_child.string_content
-          level = node.header_level
-          out("{level: #{level}, text: #{text}}")
-          super
-        end
-      end
-    end
-
-    def setup
-      @haiku =
-        "Pointing at the moon\n" \
-          "Reminded of simple things\n" \
-          "Moments matter most"
-      @links =
-        "See http://example.org/ for more info"
-      @code =
-        "```\n" \
-          "def hello()" \
-          "  'world'" \
-          "end" \
-          "```"
-      @header = <<~DOC
-        # Words
-
-        Some words
-
-        ## Words
-
-        More words?
-      DOC
-    end
-
-    def test_fails_when_given_a_documentfragment
-      body = "<p>heyo</p>"
-      doc  = HTMLPipeline.parse(body)
-      assert_raises(TypeError) { MarkdownFilter.call(doc, context: {}) }
-    end
-
-    def test_gfm_enabled_by_default
-      doc = MarkdownFilter.to_document(@haiku)
-      assert(doc.is_a?(HTMLPipeline::DocumentFragment))
-      assert_equal(2, doc.search("br").size)
-    end
-
-    def test_disabling_gfm
-      doc = MarkdownFilter.to_document(@haiku, context: { gfm: false })
-      assert(doc.is_a?(HTMLPipeline::DocumentFragment))
-      assert_equal(0, doc.search("br").size)
-    end
-
-    def test_fenced_code_blocks
-      doc = MarkdownFilter.to_document(@code)
-      assert(doc.is_a?(HTMLPipeline::DocumentFragment))
-      assert_equal(1, doc.search("pre").size)
-    end
-
-    def test_fenced_code_blocks_with_language
-      doc = MarkdownFilter.to_document(@code.sub("```", "``` ruby"))
-      assert(doc.is_a?(HTMLPipeline::DocumentFragment))
-      assert_equal(1, doc.search("pre").size)
-      assert_equal("ruby", doc.search("pre").first["lang"])
-    end
-
-    def test_standard_extensions
-      iframe = "<iframe src='http://www.google.com'></iframe>"
-      iframe_escaped = "&lt;iframe src='http://www.google.com'>&lt;/iframe>"
-      doc = MarkdownFilter.new(iframe, context: { unsafe: true }).call
-      assert_equal(doc, iframe_escaped)
-    end
-
-    def test_changing_extensions
-      iframe = "<iframe src='http://www.google.com'></iframe>"
-      doc = MarkdownFilter.new(iframe, context: { commonmarker_extensions: [], unsafe: true }).call
-      assert_equal(doc, iframe)
-    end
-
-    def test_bogus_renderer
-      assert_raises(ArgumentError) do
-        MarkdownFilter.to_document(@haiku, context: { commonmarker_renderer: 23 })
-      end
-    end
-
-    def test_legitimate_renderer
-      results = MarkdownFilter.new(@header, context: { commonmarker_renderer: CustomRenderer }).call
-      expected = <<~DOC
-        {level: 1, text: Words}
-        <h1>Words</h1>
-        <p>Some words</p>
-        {level: 2, text: Words}
-        <h2>Words</h2>
-        <p>More words?</p>
-      DOC
-
-      assert_equal(results, expected.chomp)
-    end
-
-    def test_without_tagfilter
-      extensions = HTMLPipeline::TextFilter::MarkdownFilter::DEFAULT_COMMONMARKER_EXTENSIONS - [:tagfilter]
-      script = "<script>foobar</script>"
-      results = MarkdownFilter.new(script, context: { unsafe: true, commonmarker_extensions: extensions }).call
-
-      assert_equal(results, script)
-    end
-
-    def test_legitimate_custom_renderer_without_tagfilter
-      extensions = HTMLPipeline::TextFilter::MarkdownFilter::DEFAULT_COMMONMARKER_EXTENSIONS - [:tagfilter]
-      script = "<script>foobar</script>"
-      results = MarkdownFilter.new(script, context: { unsafe: true, commonmarker_extensions: extensions, commonmarker_renderer: CustomRenderer }).call
-
-      assert_equal(results, script)
-    end
-
-    def test_unsafe_custom_renderer_fenced_code_blocks_with_language
-      doc = MarkdownFilter.to_document(@code.sub("```", "``` ruby"), context: { unsafe: true, commonmarker_renderer: CustomRenderer })
-      assert_equal("ruby", doc.search("pre").first["lang"])
-    end
-  end
-end
-
-class GFMTest < Minitest::Test
-  def setup
-    @gfm = MarkdownFilter
-    @context = { gfm: true, unsafe: true }
-  end
-
-  def test_not_touch_single_underscores_inside_words
-    assert_equal("<p>foo_bar</p>",
-      @gfm.call("foo_bar", context: @context))
-  end
-
-  def test_not_touch_underscores_in_code_blocks
-    assert_equal("<pre><code>foo_bar_baz\n</code></pre>",
-      @gfm.call("    foo_bar_baz", context: @context))
-  end
-
-  def test_not_touch_underscores_in_pre_blocks
-    assert_equal("<pre>\nfoo_bar_baz\n</pre>",
-      @gfm.call("<pre>\nfoo_bar_baz\n</pre>", context: @context))
-  end
-
-  def test_not_touch_two_or_more_underscores_inside_words
-    assert_equal("<p>foo_bar_baz</p>",
-      @gfm.call("foo_bar_baz", context: @context))
-  end
-
-  def test_turn_newlines_into_br_tags_in_simple_cases
-    assert_equal("<p>foo<br />\nbar</p>",
-      @gfm.call("foo\nbar", context: @context))
-  end
-
-  def test_convert_newlines_in_all_groups
-    assert_equal("<p>apple<br />\npear<br />\norange</p>\n" \
-      "<p>ruby<br />\npython<br />\nerlang</p>",
-      @gfm.call("apple\npear\norange\n\nruby\npython\nerlang", context: @context))
-  end
-
-  def test_convert_newlines_in_even_long_groups
-    assert_equal("<p>apple<br />\npear<br />\norange<br />\nbanana</p>\n" \
-      "<p>ruby<br />\npython<br />\nerlang</p>",
-      @gfm.call("apple\npear\norange\nbanana\n\nruby\npython\nerlang", context: @context))
-  end
-
-  def test_not_convert_newlines_in_lists
-    assert_equal("<h1>foo</h1>\n<h1>bar</h1>",
-      @gfm.call("# foo\n# bar", context: @context))
-    assert_equal("<ul>\n<li>foo</li>\n<li>bar</li>\n</ul>",
-      @gfm.call("* foo\n* bar", context: @context))
-  end
-end
diff --git a/test/html_pipeline_test.rb b/test/html_pipeline_test.rb
index f354ae9c..d3f4088b 100644
--- a/test/html_pipeline_test.rb
+++ b/test/html_pipeline_test.rb
@@ -12,8 +12,7 @@ def self.call(input, context: {}, result: {})
 
   def setup
     @default_context = {}
-    @result_class = Hash
-    @pipeline = HTMLPipeline.new(text_filters: [TestFilter], default_context: @default_context, result_class: @result_class)
+    @pipeline = HTMLPipeline.new(text_filters: [TestFilter], default_context: @default_context)
   end
 
   def test_filter_instrumentation
@@ -47,7 +46,7 @@ def test_pipeline_instrumentation
   def test_default_instrumentation_service
     service = "default"
     HTMLPipeline.default_instrumentation_service = service
-    pipeline = HTMLPipeline.new(text_filters: [], default_context: @default_context, result_class: @result_class)
+    pipeline = HTMLPipeline.new(text_filters: [], default_context: @default_context)
     assert_equal(service, pipeline.instrumentation_service)
   ensure
     HTMLPipeline.default_instrumentation_service = nil
@@ -75,13 +74,19 @@ def test_setup_instrumentation
 
   def test_incorrect_text_filters
     assert_raises(HTMLPipeline::InvalidFilterError) do
-      HTMLPipeline.new(text_filters: [HTMLPipeline::NodeFilter::SyntaxHighlightFilter], default_context: @default_context, result_class: @result_class)
+      HTMLPipeline.new(text_filters: [HTMLPipeline::NodeFilter::SyntaxHighlightFilter], default_context: @default_context)
+    end
+  end
+
+  def test_incorrect_convert_filter
+    assert_raises(HTMLPipeline::InvalidFilterError) do
+      HTMLPipeline.new(convert_filter: HTMLPipeline::TextFilter::AutolinkFilter, default_context: @default_context)
     end
   end
 
   def test_incorrect_node_filters
     assert_raises(HTMLPipeline::InvalidFilterError) do
-      HTMLPipeline.new(node_filters: [HTMLPipeline::TextFilter::MarkdownFilter], default_context: @default_context, result_class: @result_class)
+      HTMLPipeline.new(node_filters: [HTMLPipeline::ConvertFilter::MarkdownFilter], default_context: @default_context)
     end
   end
 end
diff --git a/test/sanitization_filter_test.rb b/test/sanitization_filter_test.rb
index 3003bedb..6f62c18b 100644
--- a/test/sanitization_filter_test.rb
+++ b/test/sanitization_filter_test.rb
@@ -35,7 +35,7 @@ def test_removing_script_event_handler_attributes
 
     def test_sanitizes_li_elements_not_contained_in_ul_or_ol
       stuff = "a\n<li>b</li>\nc"
-      html  = SanitizationFilter.call(stuff, DEFAULT_CONFIG).to_s
+      html  = SanitizationFilter.call(stuff, { elements: {}}).to_s
       assert_equal("a\nb\nc", html)
     end
 
@@ -70,16 +70,14 @@ def test_weird_longdesc_schemes_are_removed
     def test_standard_schemes_are_removed_if_not_specified_in_anchor_schemes
       config = DEFAULT_CONFIG.merge(protocols: { "a" => { "href" => [] } })
       stuff  = '<a href="http://www.example.com/">No href for you</a>'
-      filter = SanitizationFilter.new(stuff, config)
-      html   = filter.call.to_s
+      html = SanitizationFilter.call(stuff, config)
       assert_equal("<a>No href for you</a>", html)
     end
 
     def test_custom_anchor_schemes_are_not_removed
       config = DEFAULT_CONFIG.merge(protocols: { "a" => { "href" => ["something-weird"] } })
       stuff  = '<a href="something-weird://heyyy">Wat</a> is this'
-      filter = SanitizationFilter.new(stuff, config)
-      html   = filter.call.to_s
+      html = SanitizationFilter.call(stuff, config)
       assert_equal(stuff, html)
     end
 
@@ -87,11 +85,10 @@ def test_anchor_schemes_are_merged_with_other_anchor_restrictions
       stuff = '<a href="something-weird://heyyy" ping="more-weird://hiii">Wat</a> is this'
       allowlist = {
         elements: ["a"],
-        attributes: { "a" => ["href", "ping"] },
-        protocols: { "a" => { "ping" => ["http"] } },
+        attributes: { "a" => ["href"] },
+        protocols: { "a" => { "href" => ["something-weird"] } },
       }
-      filter = SanitizationFilter.new(stuff, allowlist)
-      html   = filter.call.to_s
+      html = SanitizationFilter.call(stuff, allowlist)
       assert_equal('<a href="something-weird://heyyy">Wat</a> is this', html)
     end
 
@@ -102,8 +99,7 @@ def test_uses_anchor_schemes_from_allowlist_when_not_separately_specified
         attributes: { "a" => ["href"] },
         protocols: { "a" => { "href" => ["something-weird"] } },
       }
-      filter = SanitizationFilter.new(stuff, allowlist)
-      html   = filter.call.to_s
+      html = SanitizationFilter.call(stuff, allowlist)
       assert_equal(stuff, html)
     end
 
@@ -122,12 +118,12 @@ def test_script_contents_are_removed
 
     def test_table_rows_and_cells_removed_if_not_in_table
       orig = %(<tr><td>Foo</td></tr><td>Bar</td>)
-      assert_equal("FooBar", SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s)
+      assert_equal("FooBar", SanitizationFilter.call(orig, { elements: {}}))
     end
 
     def test_table_sections_removed_if_not_in_table
       orig = %(<thead><tr><td>Foo</td></tr></thead>)
-      assert_equal("Foo", SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s)
+      assert_equal("Foo", SanitizationFilter.call(orig, { elements: {}}).to_s)
     end
 
     def test_table_sections_are_not_removed
@@ -169,12 +165,11 @@ def test_sanitization_pipeline_can_be_configured
       }
 
       pipeline = HTMLPipeline.new(\
-        text_filters: [
-          HTMLPipeline::TextFilter::MarkdownFilter,
-        ],
+        convert_filter:
+          HTMLPipeline::ConvertFilter::MarkdownFilter.new,
         sanitization_config: config,
         node_filters: [
-          HTMLPipeline::NodeFilter::SyntaxHighlightFilter,
+          HTMLPipeline::NodeFilter::SyntaxHighlightFilter.new,
         ]
       )
 
@@ -195,12 +190,10 @@ def test_sanitization_pipeline_can_be_configured
 
     def test_sanitization_pipeline_can_be_removed
       pipeline = HTMLPipeline.new(\
-        text_filters: [
-          HTMLPipeline::TextFilter::MarkdownFilter,
-        ],
+        convert_filter: HTMLPipeline::ConvertFilter::MarkdownFilter.new,
         sanitization_config: nil,
         node_filters: [
-          HTMLPipeline::NodeFilter::SyntaxHighlightFilter,
+          HTMLPipeline::NodeFilter::SyntaxHighlightFilter.new,
         ]
       )
 
diff --git a/test/test_helper.rb b/test/test_helper.rb
index 9db81b7f..8deb225b 100644
--- a/test/test_helper.rb
+++ b/test/test_helper.rb
@@ -10,12 +10,8 @@
 require "awesome_print"
 
 module TestHelpers
-  # Asserts that two html fragments are equivalent. Attribute order
-  # will be ignored.
-  def assert_equal_html(expected, actual)
-    assert_equal(Nokogiri::HTML::DocumentFragment.parse(expected).to_h,
-      Nokogiri::HTML::DocumentFragment.parse(actual).to_h)
-  end
+
+
 end
 
 Minitest::Test.include(TestHelpers)

From bf2733a7c50f6f6c0a42ca55ebf6e0af60773a51 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Sat, 24 Dec 2022 13:36:42 -0800
Subject: [PATCH 37/64] update workflows

---
 .github/FUNDING.yml                    | 11 ++++
 .github/dependabot.yml                 | 20 ++++++++
 .github/workflows/automerge.yml        | 34 +++++++++++++
 .github/workflows/lint.yml             | 14 +++---
 .github/workflows/tag_and_release.yml  | 70 ++++++++++++++++++++++++++
 .github/workflows/{ci.yml => test.yml} | 16 +++---
 Gemfile                                |  3 +-
 script/changelog                       | 47 -----------------
 script/generate_changelog              |  3 ++
 script/package                         |  7 ---
 script/release                         | 16 ------
 11 files changed, 155 insertions(+), 86 deletions(-)
 create mode 100644 .github/dependabot.yml
 create mode 100644 .github/workflows/automerge.yml
 create mode 100644 .github/workflows/tag_and_release.yml
 rename .github/workflows/{ci.yml => test.yml} (66%)
 delete mode 100755 script/changelog
 create mode 100755 script/generate_changelog
 delete mode 100755 script/package
 delete mode 100755 script/release

diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
index 05f5e40f..6cbca5f7 100644
--- a/.github/FUNDING.yml
+++ b/.github/FUNDING.yml
@@ -1 +1,12 @@
+# These are supported funding model platforms
+
 github: gjtorikian
+# patreon: gjtorikian
+# open_collective: garen-torikian
+#ko_fi: # Replace with a single Ko-fi username
+#tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+#community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+#liberapay: # Replace with a single Liberapay username
+# issuehunt: gjtorikian
+#otechie: # Replace with a single Otechie username
+#custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
new file mode 100644
index 00000000..be466a31
--- /dev/null
+++ b/.github/dependabot.yml
@@ -0,0 +1,20 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: daily
+      time: "09:00"
+      timezone: "Etc/UTC"
+    open-pull-requests-limit: 10
+
+  - package-ecosystem: "bundler"
+    directory: "/"
+    schedule:
+      interval: daily
+      time: "09:00"
+      timezone: "Etc/UTC"
+    open-pull-requests-limit: 10
+    allow:
+      - dependency-name: "*"
+        dependency-type: "production"
diff --git a/.github/workflows/automerge.yml b/.github/workflows/automerge.yml
new file mode 100644
index 00000000..4b61205e
--- /dev/null
+++ b/.github/workflows/automerge.yml
@@ -0,0 +1,34 @@
+name: PR auto-{approve,merge}
+
+on:
+  pull_request_target:
+
+permissions:
+  pull-requests: write
+  contents: write
+
+jobs:
+  dependabot:
+    name: Dependabot
+    runs-on: ubuntu-latest
+
+    if: ${{ github.actor == 'dependabot[bot]' }}
+    steps:
+      - name: Fetch Dependabot metadata
+        id: dependabot-metadata
+        uses: dependabot/fetch-metadata@v1
+        with:
+          github-token: "${{ secrets.GITHUB_TOKEN }}"
+
+      - name: Approve Dependabot PR
+        if: ${{steps.dependabot-metadata.outputs.update-type != 'version-update:semver-major'}}
+        run: gh pr review --approve "$PR_URL"
+        env:
+          PR_URL: ${{github.event.pull_request.html_url}}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Merge Dependabot PR
+        run: gh pr merge --auto --squash "$PR_URL"
+        env:
+          PR_URL: ${{ github.event.pull_request.html_url }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 24fc46e6..464723f2 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -2,20 +2,20 @@ name: Linting
 
 on:
   pull_request:
-    types: [opened, synchronize, reopened]
-  push:
-    branches:
-      - main
+    paths:
+      - "**/*.rb"
+
+permissions:
+  contents: read
 
 jobs:
   test:
     runs-on: ubuntu-latest
-    continue-on-error: true
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
       - uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 3.1
+          ruby-version: 3.0
           bundler-cache: true
       - run: bundle install
       - name: Rubocop
diff --git a/.github/workflows/tag_and_release.yml b/.github/workflows/tag_and_release.yml
new file mode 100644
index 00000000..628a5da1
--- /dev/null
+++ b/.github/workflows/tag_and_release.yml
@@ -0,0 +1,70 @@
+name: Tag and Release
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+    paths:
+      - "lib/html_pipeline/version.rb"
+
+jobs:
+  release:
+    env:
+      GEM_NAME: html-pipeline
+      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      GEM_HOST_API_KEY: ${{ secrets.RUBYGEMS_API_BOT_KEY }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set up Ruby 3.1
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.1
+          bundler-cache: true
+
+      - name: Configure Git
+        run: |
+          git config --local user.email "actions@github.com"
+          git config --local user.name "Actions Auto Build"
+
+      - name: Get current version
+        id: version-label
+        run: |
+          VERSION=$(grep VERSION lib/html_pipeline/version.rb | head -n 1 | cut -d'"' -f2)
+          echo "version=${VERSION}" >> $GITHUB_OUTPUT
+
+      - name: Create tag
+        run: |
+          git tag -a v${{ steps.version-label.outputs.version }} -m "Release v${{ steps.version-label.outputs.version }}"
+          git push origin --tags
+
+      - name: Generate CHANGELOG.md
+        id: changelog
+        run: script/generate_changelog
+
+      - name: Commit & Push Changelog
+        run: |
+          git config --local user.email "actions@github.com"
+          git config --local user.name "Actions Auto Build"
+          git add -f CHANGELOG.md
+          git commit -m "docs: update changelog" || true
+          git push
+
+      - name: Publish release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh release create v${{ steps.version-label.outputs.version }} --generate-notes
+
+      - name: Publish to RubyGems
+        run: |
+          mkdir -p $HOME/.gem
+          touch $HOME/.gem/credentials
+          chmod 0600 $HOME/.gem/credentials
+          printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+          bundle exec rake package
+          for gem in pkg/html_pipeline-${{ steps.version-label.outputs.version }}*.gem ; do
+            gem push "$gem" --host https://rubygems.org
+          done
diff --git a/.github/workflows/ci.yml b/.github/workflows/test.yml
similarity index 66%
rename from .github/workflows/ci.yml
rename to .github/workflows/test.yml
index 96946987..aa87ada1 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/test.yml
@@ -1,7 +1,10 @@
-name: Ruby CI
+name: Tests
 
 on:
-  push:
+  pull_request:
+
+permissions:
+  contents: read
 
 jobs:
   test:
@@ -11,13 +14,10 @@ jobs:
       fail-fast: true
       matrix:
         ruby-version:
-          - 3.1
+          - 3.1.0
 
     steps:
-      - uses: actions/checkout@v2
-
-      - name: Install libxslt and libxml2
-        run: sudo apt-get install libxslt-dev libxml2-dev
+      - uses: actions/checkout@v3
 
       - name: Set up Ruby ${{ matrix.ruby-version }}
         uses: ruby/setup-ruby@v1
@@ -29,4 +29,4 @@ jobs:
         run: bundle install
 
       - name: Run tests
-        run: bundle exec rake
+        run: bundle exec rake test
diff --git a/Gemfile b/Gemfile
index bcd12a40..09ba5091 100644
--- a/Gemfile
+++ b/Gemfile
@@ -10,7 +10,8 @@ gem "awesome_print"
 gem "rubocop"
 gem "rubocop-standard"
 
-gem 'sorbet-runtime'
+gem "github_changelog_generator", "~> 1.16"
+
 
 group :development, :test do
   gem "amazing_print"
diff --git a/script/changelog b/script/changelog
deleted file mode 100755
index 1e1d7eea..00000000
--- a/script/changelog
+++ /dev/null
@@ -1,47 +0,0 @@
-#!/bin/bash
-# Usage: script/changelog [-r <repo>] [-b <base>] [-h <head>]
-#
-#  repo: base string of GitHub repository url. e.g. "user_or_org/repository". Defaults to git remote url.
-#  base: git ref to compare from. e.g. "v1.3.1". Defaults to latest git tag.
-#  head: git ref to compare to. Defaults to "HEAD".
-#
-# Generate a changelog preview from pull requests merged between `base` and
-# `head`.
-#
-# https://github.com/jch/release-scripts/blob/master/changelog
-set -e
-
-[ $# -eq 0 ] && set -- --help
-while [[ $# > 1 ]]
-do
-  key="$1"
-  case $key in
-    -r|--repo)
-    repo="$2"
-    shift
-    ;;
-    -b|--base)
-    base="$2"
-    shift
-    ;;
-    -h|--head)
-    head="$2"
-    shift
-    ;;
-    *)
-    ;;
-  esac
-  shift
-done
-
-repo="${repo:-$(git remote -v | grep push | awk '{print $2}' | cut -d'/' -f4- | sed 's/\.git//')}"
-base="${base:-$(git tag -l | sort -t. -k 1,1n -k 2,2n -k 3,3n | tail -n 1)}"
-head="${head:-HEAD}"
-api_url="https://api.github.com"
-
-# get merged PR's. Better way is to query the API for these, but this is easier
-for pr in $(git log --oneline $base..$head | grep "Merge pull request" | awk '{gsub("#",""); print $5}')
-do
-  # frustrated with trying to pull out the right values, fell back to ruby
-  curl -s "$api_url/repos/$repo/pulls/$pr" | ruby -rjson -e 'pr=JSON.parse(STDIN.read); puts "* #{pr[%q(title)]} [##{pr[%q(number)]}](#{pr[%q(html_url)]})"'
-done
diff --git a/script/generate_changelog b/script/generate_changelog
new file mode 100755
index 00000000..61d8612b
--- /dev/null
+++ b/script/generate_changelog
@@ -0,0 +1,3 @@
+#!/bin/sh
+
+ CHANGELOG_GITHUB_TOKEN="$GITHUB_TOKEN" bundle exec github_changelog_generator -u gjtorikian -p generate_changelog
diff --git a/script/package b/script/package
deleted file mode 100755
index 926f4891..00000000
--- a/script/package
+++ /dev/null
@@ -1,7 +0,0 @@
-#!/usr/bin/env bash
-# Usage: script/gem
-# Updates the gemspec and builds a new gem in the pkg directory.
-
-mkdir -p pkg
-gem build *.gemspec
-mv *.gem pkg
diff --git a/script/release b/script/release
deleted file mode 100755
index 6dcd8cb3..00000000
--- a/script/release
+++ /dev/null
@@ -1,16 +0,0 @@
-#!/usr/bin/env bash
-# Usage: script/release
-# Build the package, tag a commit, push it to origin, and then release the
-# package publicly.
-
-set -e
-
-version="$(script/package | grep Version: | awk '{print $2}')"
-[ -n "$version" ] || exit 1
-
-echo $version
-git commit --allow-empty -a -m "Release $version"
-git tag "v$version"
-git push origin
-git push origin "v$version"
-gem push pkg/*-${version}.gem

From 6177ee394d70ab10b0679c670da3762270b3caa0 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Sat, 24 Dec 2022 13:36:45 -0800
Subject: [PATCH 38/64] lint

---
 Gemfile                                       |  7 +-
 lib/html_pipeline.rb                          | 81 ++++++++--------
 lib/html_pipeline/convert_filter.rb           |  8 +-
 .../convert_filter/markdown_filter.rb         |  2 +-
 lib/html_pipeline/filter.rb                   | 15 +--
 lib/html_pipeline/node_filter.rb              | 12 ++-
 lib/html_pipeline/node_filter/emoji_filter.rb |  6 --
 .../node_filter/image_max_width_filter.rb     |  2 +-
 .../node_filter/mention_filter.rb             | 41 ++++----
 .../node_filter/syntax_highlight_filter.rb    |  1 +
 .../node_filter/table_of_contents_filter.rb   |  5 +-
 .../node_filter/team_mention_filter.rb        | 42 ++++----
 lib/html_pipeline/sanitization_filter.rb      | 14 +--
 lib/html_pipeline/text_filter.rb              |  8 +-
 .../convert_filter/markdown_filter_test.rb    | 11 ++-
 .../absolute_source_filter_test.rb            |  5 +
 .../node_filter/emoji_filter_test.rb          | 15 +++
 .../node_filter/https_filter_test.rb          |  2 +-
 .../image_max_width_filter_test.rb            |  5 +
 .../node_filter/mention_filter_test.rb        | 49 ++++++++--
 .../syntax_highlight_filter_test.rb           |  2 +
 .../table_of_contents_filter_test.rb          | 97 ++++++++++---------
 .../node_filter/team_mention_filter_test.rb   | 35 ++++++-
 test/html_pipeline/require_helper_test.rb     |  4 +
 .../plain_text_input_filter_test.rb           |  2 +
 test/html_pipeline_test.rb                    | 10 +-
 test/sanitization_filter_test.rb              | 30 +++++-
 test/test_helper.rb                           |  2 -
 28 files changed, 324 insertions(+), 189 deletions(-)

diff --git a/Gemfile b/Gemfile
index 09ba5091..4e3b3cd5 100644
--- a/Gemfile
+++ b/Gemfile
@@ -12,6 +12,7 @@ gem "rubocop-standard"
 
 gem "github_changelog_generator", "~> 1.16"
 
+gem "sorbet-runtime"
 
 group :development, :test do
   gem "amazing_print"
@@ -19,14 +20,14 @@ group :development, :test do
 end
 
 group :development do
-  gem 'tapioca', require: false
-  gem 'sorbet'
+  gem "tapioca", require: false
+  gem "sorbet"
   gem "bundler"
   gem "rake"
 end
 
 group :test do
-  gem 'commonmarker', '~> 1.0.0.pre3', require: false
+  gem "commonmarker", "~> 1.0.0.pre3", require: false
   gem "gemoji", "~> 3.0", require: false
   gem "gemojione", "~> 4.3", require: false
   gem "minitest"
diff --git a/lib/html_pipeline.rb b/lib/html_pipeline.rb
index 576f438d..e4a672aa 100644
--- a/lib/html_pipeline.rb
+++ b/lib/html_pipeline.rb
@@ -4,7 +4,7 @@
 lib_dir = File.join(File.dirname(__dir__), "lib")
 gem_loader = Zeitwerk::Loader.for_gem
 gem_loader.inflector.inflect(
-  "html_pipeline" => "HTMLPipeline"
+  "html_pipeline" => "HTMLPipeline",
 )
 gem_loader.ignore(File.join(lib_dir, "html-pipeline.rb"))
 gem_loader.setup
@@ -36,51 +36,52 @@ class HTMLPipeline
   class MissingDependencyError < RuntimeError; end
   class InvalidFilterError < ArgumentError; end
 
-  def self.optional_dependency(name, requirer)
-    require name
-  rescue LoadError
-  end
+  class << self
+    def optional_dependency(name, requirer)
+      require name
+    rescue LoadError # rubocop:disable Lint/SuppressedException:
+    end
 
-  def self.require_dependency(name, requirer)
-    require name
-  rescue LoadError => e
-    raise MissingDependencyError,
-      "Missing dependency '#{name}' for #{requirer}. See README.md for details.\n#{e.class.name}: #{e}"
-  end
+    def require_dependency(name, requirer)
+      require name
+    rescue LoadError => e
+      raise MissingDependencyError,
+        "Missing dependency '#{name}' for #{requirer}. See README.md for details.\n#{e.class.name}: #{e}"
+    end
+
+    def require_dependencies(names, requirer)
+      dependency_list = names.dup
+      loaded = false
+
+      while !loaded && names.length > 1
+        name = names.shift
 
-  def self.require_dependencies(names, requirer)
-    dependency_list = names.dup
-    loaded = false
+        begin
+          require_dependency(name, requirer)
+          loaded = true # we got a dependency
+          define_dependency_loaded_method(name, true)
+        # try the next dependency
+        rescue MissingDependencyError
+          define_dependency_loaded_method(name, false)
+        end
+      end
 
-    while !loaded && names.length > 1
-      name = names.shift
+      return if loaded
 
       begin
-        require_dependency(name, requirer)
-        loaded = true # we got a dependency
+        name = names.shift
+        require name
         define_dependency_loaded_method(name, true)
-      # try the next dependency
-      rescue MissingDependencyError
-        define_dependency_loaded_method(name, false)
+      rescue LoadError => e
+        raise MissingDependencyError,
+          "Missing all dependencies '#{dependency_list.join(", ")}' for #{requirer}. See README.md for details.\n#{e.class.name}: #{e}"
       end
     end
 
-    return if loaded
-
-    begin
-      name = names.shift
-      require name
-      define_dependency_loaded_method(name, true)
-    rescue LoadError => e
-      raise MissingDependencyError,
-        "Missing all dependencies '#{dependency_list.join(", ")}' for #{requirer}. See README.md for details.\n#{e.class.name}: #{e}"
+    def define_dependency_loaded_method(name, value)
+      self.class.define_method(:"#{name}_loaded?", -> { value })
     end
-  end
-
-  def self.define_dependency_loaded_method(name, value)
-    self.class.define_method(:"#{name}_loaded?", -> { value })
-  end
-
+end
   # Public: Returns an Array of Filter objects for this Pipeline.
   attr_reader :text_filters, :node_filters
 
@@ -158,15 +159,15 @@ def call(text, context: {}, result: {})
     html = @convert_filter.call(text) unless @convert_filter.nil?
 
     unless @node_filters.empty?
-      payload = default_payload({ node_filters: @node_filters.map{ |f| f.class.name },
+      payload = default_payload({ node_filters: @node_filters.map { |f| f.class.name },
         context: context, result: result, })
       instrument("call_node_filters.html_pipeline", payload) do
         result[:output] = Selma::Rewriter.new(sanitizer: @sanitization_config, handlers: @node_filters).rewrite(html)
       end
     end
 
-    result = result.merge(Hash[ *@node_filters.collect { |f| f.result }.flatten ])
-    @node_filters.each { |f| f.reset! }
+    result = result.merge(Hash[*@node_filters.collect(&:result).flatten])
+    @node_filters.each(&:reset!)
 
     result
   end
@@ -225,7 +226,7 @@ def default_payload(payload = {})
   end
 
   private def validate_filter(filter, klass)
-    if !correctly_ancestored?(filter, klass)
+    unless correctly_ancestored?(filter, klass)
       raise InvalidFilterError, "Filter must inherit from `#{klass}`; #{filter} does not"
     end
   end
diff --git a/lib/html_pipeline/convert_filter.rb b/lib/html_pipeline/convert_filter.rb
index 1a9a2ee3..4bacd563 100644
--- a/lib/html_pipeline/convert_filter.rb
+++ b/lib/html_pipeline/convert_filter.rb
@@ -8,8 +8,10 @@ def initialize(context: {}, result: {})
       super(context: context, result: result)
     end
 
-    def self.call(text, context: {}, result: {})
-      new(context: context, result: result).call(text)
-    end
+    class << self
+      def call(text, context: {}, result: {})
+        new(context: context, result: result).call(text)
+      end
+  end
   end
 end
diff --git a/lib/html_pipeline/convert_filter/markdown_filter.rb b/lib/html_pipeline/convert_filter/markdown_filter.rb
index cdff37fa..3c8bd249 100644
--- a/lib/html_pipeline/convert_filter/markdown_filter.rb
+++ b/lib/html_pipeline/convert_filter/markdown_filter.rb
@@ -17,7 +17,7 @@ def initialize(context: {}, result: {})
 
       # Convert Commonmark to HTML using the best available implementation.
       def call(text)
-        options =  @context.fetch(:markdown, {})
+        options = @context.fetch(:markdown, {})
         Commonmarker.to_html(text, options: options).rstrip!
       end
     end
diff --git a/lib/html_pipeline/filter.rb b/lib/html_pipeline/filter.rb
index b51b8d9c..d2ff6e4c 100644
--- a/lib/html_pipeline/filter.rb
+++ b/lib/html_pipeline/filter.rb
@@ -42,13 +42,14 @@ def call
       raise NoMethodError
     end
 
-    # Perform a filter on doc with the given context.
-    #
-    # Returns a String comprised of HTML markup.
-    def self.call(input, context: {})
-      raise NoMethodError
-    end
-
+    class << self
+      # Perform a filter on doc with the given context.
+      #
+      # Returns a String comprised of HTML markup.
+      def call(input, context: {})
+        raise NoMethodError
+      end
+  end
     # Make sure the context has everything we need. Noop: Subclasses can override.
     def validate; end
 
diff --git a/lib/html_pipeline/node_filter.rb b/lib/html_pipeline/node_filter.rb
index a59a57a9..c05e581a 100644
--- a/lib/html_pipeline/node_filter.rb
+++ b/lib/html_pipeline/node_filter.rb
@@ -17,13 +17,15 @@ def html
     end
 
     def reset!
-      result = {}
+      result = {} # rubocop:disable Lint/UselessAssignment
       send(:after_initialize) if respond_to?(:after_initialize)
     end
 
-    def self.call(html, context: {}, result: {})
-      node_filter = new(context: context, result: result)
-      Selma::Rewriter.new(sanitizer: nil, handlers: [node_filter]).rewrite(html)
-    end
+    class << self
+      def call(html, context: {}, result: {})
+        node_filter = new(context: context, result: result)
+        Selma::Rewriter.new(sanitizer: nil, handlers: [node_filter]).rewrite(html)
+      end
+  end
   end
 end
diff --git a/lib/html_pipeline/node_filter/emoji_filter.rb b/lib/html_pipeline/node_filter/emoji_filter.rb
index e91333c5..af0d7190 100644
--- a/lib/html_pipeline/node_filter/emoji_filter.rb
+++ b/lib/html_pipeline/node_filter/emoji_filter.rb
@@ -30,12 +30,6 @@ def handle_text(text)
         emoji_image_filter(text)
       end
 
-      def emoji_image_filter(text)
-        text.gsub(emoji_pattern) do
-          emoji_image_tag(Regexp.last_match(1))
-        end
-      end
-
       # Implementation of validate hook.
       # Errors should raise exceptions or use an existing validator.
       def validate
diff --git a/lib/html_pipeline/node_filter/image_max_width_filter.rb b/lib/html_pipeline/node_filter/image_max_width_filter.rb
index 42381080..f662af3a 100644
--- a/lib/html_pipeline/node_filter/image_max_width_filter.rb
+++ b/lib/html_pipeline/node_filter/image_max_width_filter.rb
@@ -30,7 +30,7 @@ def handle_element(element)
       end
 
       def link_image(element)
-        link_start = %Q(<a target="_blank" href="#{element["src"]}">)
+        link_start = %(<a target="_blank" href="#{element["src"]}">)
         link_end = "</a>"
         element.wrap(link_start, link_end, :as_html)
       end
diff --git a/lib/html_pipeline/node_filter/mention_filter.rb b/lib/html_pipeline/node_filter/mention_filter.rb
index f68394f3..3f3fa6b1 100644
--- a/lib/html_pipeline/node_filter/mention_filter.rb
+++ b/lib/html_pipeline/node_filter/mention_filter.rb
@@ -17,27 +17,28 @@ class NodeFilter
     #                       identify usernames
     #
     class MentionFilter < NodeFilter
-      # Public: Find user @mentions in text.  See
-      # MentionFilter#mention_link_filter.
-      #
-      #   MentionFilter.mentioned_logins_in(text) do |match, login, is_mentioned|
-      #     "<a href=...>#{login}</a>"
-      #   end
-      #
-      # text - String text to search.
-      #
-      # Yields the String match, the String login name, and a Boolean determining
-      # if the match = "@mention[ed]".  The yield's return replaces the match in
-      # the original text.
-      #
-      # Returns a String replaced with the return of the block.
-      def self.mentioned_logins_in(text, username_pattern = USERNAME_PATTERN)
-        text.gsub(MENTION_PATTERNS[username_pattern]) do |match|
-          login = Regexp.last_match(1)
-          yield match, login
+      class << self
+        # Public: Find user @mentions in text.  See
+        # MentionFilter#mention_link_filter.
+        #
+        #   MentionFilter.mentioned_logins_in(text) do |match, login, is_mentioned|
+        #     "<a href=...>#{login}</a>"
+        #   end
+        #
+        # text - String text to search.
+        #
+        # Yields the String match, the String login name, and a Boolean determining
+        # if the match = "@mention[ed]".  The yield's return replaces the match in
+        # the original text.
+        #
+        # Returns a String replaced with the return of the block.
+        def mentioned_logins_in(text, username_pattern = USERNAME_PATTERN)
+          text.gsub(MENTION_PATTERNS[username_pattern]) do |match|
+            login = Regexp.last_match(1)
+            yield match, login
+          end
         end
-      end
-
+    end
       # Hash that contains all of the mention patterns used by the pipeline
       MENTION_PATTERNS = Hash.new do |hash, key|
         hash[key] = %r{
diff --git a/lib/html_pipeline/node_filter/syntax_highlight_filter.rb b/lib/html_pipeline/node_filter/syntax_highlight_filter.rb
index 38f9281a..6813ad0d 100644
--- a/lib/html_pipeline/node_filter/syntax_highlight_filter.rb
+++ b/lib/html_pipeline/node_filter/syntax_highlight_filter.rb
@@ -38,6 +38,7 @@ def handle_element(element)
       def handle_text(text)
         return text if @lang.nil?
         return text if (lexer = lexer_for(@lang)).nil?
+
         highlight_with_timeout_handling(text, lexer)
       end
 
diff --git a/lib/html_pipeline/node_filter/table_of_contents_filter.rb b/lib/html_pipeline/node_filter/table_of_contents_filter.rb
index a1d8e9d9..3abceed3 100644
--- a/lib/html_pipeline/node_filter/table_of_contents_filter.rb
+++ b/lib/html_pipeline/node_filter/table_of_contents_filter.rb
@@ -27,7 +27,7 @@ class NodeFilter
     #  # => "<h1>\n<a id=\"ice-cube\" class=\"anchor\" href=\"#ice-cube\">..."
     class TableOfContentsFilter < NodeFilter
       SELECTOR = Selma::Selector.new(match_element: "h1 a[href], h2 a[href], h3 a[href], h4 a[href], h5 a[href], h6 a[href]",
-                                     match_text_within: "h1, h2, h3, h4, h5, h6")
+        match_text_within: "h1, h2, h3, h4, h5, h6")
 
       def selector
         SELECTOR
@@ -51,6 +51,7 @@ def handle_element(element)
         header_href = element["href"]
 
         return unless header_href.start_with?("#")
+
         header_id = header_href[1..-1]
 
         element["id"] = header_id
@@ -62,7 +63,7 @@ def handle_element(element)
       end
 
       def handle_text(text)
-        result[:toc].last.merge!(text: text)
+        result[:toc].last[:text] = text
 
         text
       end
diff --git a/lib/html_pipeline/node_filter/team_mention_filter.rb b/lib/html_pipeline/node_filter/team_mention_filter.rb
index a9aad730..463b60df 100644
--- a/lib/html_pipeline/node_filter/team_mention_filter.rb
+++ b/lib/html_pipeline/node_filter/team_mention_filter.rb
@@ -14,26 +14,28 @@ class NodeFilter
     #                       identify team names
     #
     class TeamMentionFilter < NodeFilter
-      # Public: Find @org/team mentions in text.  See
-      # TeamMentionFilter#team_mention_link_filter.
-      #
-      #   TeamMentionFilter.mentioned_teams_in(text) do |match, org, team|
-      #     "<a href=...>#{team}</a>"
-      #   end
-      #
-      # text - String text to search.
-      #
-      # Yields the String match, org name, and team name.  The yield's
-      # return replaces the match in the original text.
-      #
-      # Returns a String replaced with the return of the block.
-      def self.mentioned_teams_in(text, team_pattern = TEAM_PATTERN)
-        text.gsub(team_pattern) do |match|
-          org = Regexp.last_match(1)
-          team = Regexp.last_match(2)
-          yield match, org, team
+      class << self
+        # Public: Find @org/team mentions in text.  See
+        # TeamMentionFilter#team_mention_link_filter.
+        #
+        #   TeamMentionFilter.mentioned_teams_in(text) do |match, org, team|
+        #     "<a href=...>#{team}</a>"
+        #   end
+        #
+        # text - String text to search.
+        #
+        # Yields the String match, org name, and team name.  The yield's
+        # return replaces the match in the original text.
+        #
+        # Returns a String replaced with the return of the block.
+        def mentioned_teams_in(text, team_pattern = TEAM_PATTERN)
+          text.gsub(team_pattern) do |match|
+            org = Regexp.last_match(1)
+            team = Regexp.last_match(2)
+            yield match, org, team
+          end
         end
-      end
+    end
 
       # Default pattern used to extract team names from text. The value can be
       # overridden by providing the team_pattern variable in the context. To
@@ -84,7 +86,7 @@ def mention_link_filter(text, base_url: "/", team_pattern: TEAM_PATTERN)
           link = link_to_mentioned_team(base_url, org, team)
           seperator = %r{/|&\#47;?}
 
-          link ? match.sub(%r{@#{org}#{seperator}#{team}}, link) : match
+          link ? match.sub(/@#{org}#{seperator}#{team}/, link) : match
         end
       end
 
diff --git a/lib/html_pipeline/sanitization_filter.rb b/lib/html_pipeline/sanitization_filter.rb
index 6868e605..05be929d 100644
--- a/lib/html_pipeline/sanitization_filter.rb
+++ b/lib/html_pipeline/sanitization_filter.rb
@@ -71,12 +71,14 @@ class SanitizationFilter
       ].freeze,
     }.freeze
 
-    def self.call(html, config)
-      raise ArgumentError, "html must be a String, not #{html.class}" unless html.is_a?(String)
-      raise ArgumentError, "config must be a Hash, not #{config.class}" unless config.is_a?(Hash)
+    class << self
+      def call(html, config)
+        raise ArgumentError, "html must be a String, not #{html.class}" unless html.is_a?(String)
+        raise ArgumentError, "config must be a Hash, not #{config.class}" unless config.is_a?(Hash)
 
-      sanitization_config = Selma::Sanitizer.new(config)
-      Selma::Rewriter.new(sanitizer: sanitization_config).rewrite(html)
-    end
+        sanitization_config = Selma::Sanitizer.new(config)
+        Selma::Rewriter.new(sanitizer: sanitization_config).rewrite(html)
+      end
+  end
   end
 end
diff --git a/lib/html_pipeline/text_filter.rb b/lib/html_pipeline/text_filter.rb
index 37797492..98d13030 100644
--- a/lib/html_pipeline/text_filter.rb
+++ b/lib/html_pipeline/text_filter.rb
@@ -12,8 +12,10 @@ def initialize(text, context: {}, result: {})
       super(context: context, result: result)
     end
 
-    def self.call(input, context: {}, result: {})
-      new(input, context: context, result: result).call
-    end
+    class << self
+      def call(input, context: {}, result: {})
+        new(input, context: context, result: result).call
+      end
+  end
   end
 end
diff --git a/test/html_pipeline/convert_filter/markdown_filter_test.rb b/test/html_pipeline/convert_filter/markdown_filter_test.rb
index 1fc5c2ba..6722eb6e 100644
--- a/test/html_pipeline/convert_filter/markdown_filter_test.rb
+++ b/test/html_pipeline/convert_filter/markdown_filter_test.rb
@@ -36,21 +36,25 @@ def test_fails_when_given_a_non_string
 
     def test_gfm_enabled_by_default
       doc = MarkdownFilter.call(@haiku)
+
       assert_equal(2, Nokogiri.parse(doc).search("br").size)
     end
 
     def test_disabling_hardbreaks
-      doc = MarkdownFilter.call(@haiku, context: { markdown: { render: {hardbreaks: false } }} )
+      doc = MarkdownFilter.call(@haiku, context: { markdown: { render: { hardbreaks: false } } })
+
       assert_equal(0, Nokogiri.parse(doc).search("br").size)
     end
 
     def test_fenced_code_blocks
       doc = MarkdownFilter.call(@code)
+
       assert_equal(1, Nokogiri.parse(doc).search("pre").size)
     end
 
     def test_fenced_code_blocks_with_language
       doc = MarkdownFilter.call(@code.sub("```", "``` ruby"))
+
       assert_equal(1, Nokogiri.parse(doc).search("pre").size)
       assert_equal("ruby", Nokogiri.parse(doc).search("pre").first["lang"])
     end
@@ -59,12 +63,14 @@ def test_standard_extensions
       iframe = "<iframe src='http://www.google.com'></iframe>"
       iframe_escaped = "&lt;iframe src='http://www.google.com'>&lt;/iframe>"
       doc = MarkdownFilter.call(iframe, context: { markdown: { render: { unsafe_: true } } })
+
       assert_equal(doc, iframe_escaped)
     end
 
     def test_changing_extensions
       iframe = "<iframe src='http://www.google.com'></iframe>"
-      doc = MarkdownFilter.call(iframe, context: { markdown: { extension: { tagfilter: false }, render: { unsafe_: true }}})
+      doc = MarkdownFilter.call(iframe, context: { markdown: { extension: { tagfilter: false }, render: { unsafe_: true } } })
+
       assert_equal(doc, iframe)
     end
 
@@ -124,6 +130,7 @@ def test_convert_newlines_in_even_long_groups
   def test_not_convert_newlines_in_lists
     options = Commonmarker::Config.merged_with_defaults({})
     options[:extension].delete(:header_ids)
+
     assert_equal("<h1>foo</h1>\n<h1>bar</h1>",
       @gfm.call("# foo\n# bar", context: { markdown: options }))
     assert_equal("<ul>\n<li>foo</li>\n<li>bar</li>\n</ul>",
diff --git a/test/html_pipeline/node_filter/absolute_source_filter_test.rb b/test/html_pipeline/node_filter/absolute_source_filter_test.rb
index 2e75c129..0cd36a10 100644
--- a/test/html_pipeline/node_filter/absolute_source_filter_test.rb
+++ b/test/html_pipeline/node_filter/absolute_source_filter_test.rb
@@ -17,12 +17,14 @@ def setup
 
       def test_rewrites_root_urls
         orig = %(<p><img src="/img.png"></p>)
+
         assert_equal("<p><img src=\"#{@image_base_url}/img.png\"></p>",
           AbsoluteSourceFilter.call(orig, context: @options).to_s)
       end
 
       def test_rewrites_relative_urls
         orig = %(<p><img src="post/img.png"></p>)
+
         assert_equal("<p><img src=\"#{@image_subpage_url}/img.png\"></p>",
           AbsoluteSourceFilter.call(orig, context: @options).to_s)
       end
@@ -30,6 +32,7 @@ def test_rewrites_relative_urls
       def test_does_not_rewrite_absolute_urls
         orig = %(<p><img src="http://other.example.com/img.png"></p>)
         result = AbsoluteSourceFilter.call(orig, context: @options).to_s
+
         refute_match(/@image_base_url/, result)
         refute_match(/@image_subpage_url/, result)
       end
@@ -47,11 +50,13 @@ def test_tells_you_where_context_is_required
         exception = assert_raises(RuntimeError) do
           AbsoluteSourceFilter.call('<img src="img.png">', context: {})
         end
+
         assert_match("HTMLPipeline::NodeFilter::AbsoluteSourceFilter", exception.message)
 
         exception = assert_raises(RuntimeError) do
           AbsoluteSourceFilter.call('<img src="/img.png">', context: {})
         end
+
         assert_match("HTMLPipeline::NodeFilter::AbsoluteSourceFilter", exception.message)
       end
     end
diff --git a/test/html_pipeline/node_filter/emoji_filter_test.rb b/test/html_pipeline/node_filter/emoji_filter_test.rb
index a20e49a7..7fcfc2d7 100644
--- a/test/html_pipeline/node_filter/emoji_filter_test.rb
+++ b/test/html_pipeline/node_filter/emoji_filter_test.rb
@@ -12,11 +12,13 @@ def setup
     def test_emojify
       orig = "<p>:shipit:</p>"
       result = @emoji_filter.call(orig, context: { asset_root: "https://foo.com" })
+
       assert_match("https://foo.com/emoji/shipit.png", result)
     end
 
     def test_uri_encoding
       result = @emoji_filter.call("<p>:+1:</p>", context: { asset_root: "https://foo.com" })
+
       assert_match("https://foo.com/emoji/unicode/1f44d.png", result)
     end
 
@@ -24,53 +26,62 @@ def test_required_context_validation
       exception = assert_raises(ArgumentError) do
         @emoji_filter.call("", context: {})
       end
+
       assert_match(/:asset_root/, exception.message)
     end
 
     def test_custom_asset_path
       result = @emoji_filter.call("<p>:+1:</p>", context: { asset_path: ":file_name", asset_root: "https://foo.com" })
+
       assert_match("https://foo.com/unicode/1f44d.png", result)
     end
 
     def test_not_emojify_in_code_tags
       body = "<code>:shipit:</code>"
       result = @emoji_filter.call(body, context: { asset_root: "https://foo.com" })
+
       assert_equal(body, result)
     end
 
     def test_not_emojify_in_tt_tags
       body = "<tt>:shipit:</tt>"
       result = @emoji_filter.call(body, context: { asset_root: "https://foo.com" })
+
       assert_equal(body, result)
     end
 
     def test_not_emojify_in_pre_tags
       body = "<pre>:shipit:</pre>"
       result = @emoji_filter.call(body, context: { asset_root: "https://foo.com" })
+
       assert_equal(body, result)
     end
 
     def test_not_emojify_in_custom_single_tag_foo
       body = "<foo>:shipit:</foo>"
       result = @emoji_filter.call(body, context: { asset_root: "https://foo.com", ignored_ancestor_tags: ["foo"] })
+
       assert_equal(body, result)
     end
 
     def test_not_emojify_in_custom_multiple_tags_foo_and_bar
       body = "<bar>:shipit:</bar>"
       result = @emoji_filter.call(body, context: { asset_root: "https://foo.com", ignored_ancestor_tags: ["foo", "bar"] })
+
       assert_equal(body, result)
     end
 
     def test_img_tag_attributes
       body = "<p>:shipit:</p>"
       result = @emoji_filter.call(body, context: { asset_root: "https://foo.com" })
+
       assert_match(%(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" height="20" width="20" align="absmiddle">), result)
     end
 
     def test_img_tag_attributes_can_be_customized
       body = "<p>:shipit:</p>"
       result = @emoji_filter.call(body, context: { asset_root: "https://foo.com", img_attrs: Hash("draggable" => "false", "height" => nil, "width" => nil, "align" => nil) })
+
       assert_match(%(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" draggable="false">), result)
     end
 
@@ -78,12 +89,14 @@ def test_img_attrs_value_can_accept_proclike_object
       remove_colons = ->(name) { name.delete(":") }
       body = "<p>:shipit:</p>"
       result = @emoji_filter.call(body, context: { asset_root: "https://foo.com", img_attrs: Hash("title" => remove_colons) })
+
       assert_match(%(<img class="emoji" title="shipit" alt=":shipit:" src="https://foo.com/emoji/shipit.png" height="20" width="20" align="absmiddle">), result)
     end
 
     def test_img_attrs_can_accept_symbolized_keys
       body = "<p>:shipit:</p>"
       result = @emoji_filter.call(body, context: { asset_root: "https://foo.com", img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
+
       assert_match(%(<img class="emoji" title=":shipit:" alt=":shipit:" src="https://foo.com/emoji/shipit.png" draggable="false">), result)
     end
 
@@ -93,6 +106,7 @@ def test_works_with_gemoji
       HTMLPipeline::NodeFilter::EmojiFilter.stub(:gemoji_loaded?, false) do
         body = "<span>:flag_ar:</span>"
         result = HTMLPipeline::NodeFilter::EmojiFilter.call(body, context: { asset_root: "https://foo.com" })
+
         assert_equal(%(<span><img class="emoji" title=":flag_ar:" alt=":flag_ar:" src="https://foo.com/emoji/1f1e6-1f1f7.png" height="20" width="20" align="absmiddle"></span>), result)
       end
     end
@@ -102,6 +116,7 @@ def test_gemoji_can_accept_symbolized_keys
       HTMLPipeline::NodeFilter::EmojiFilter.stub(:gemoji_loaded?, false) do
         body = "<span>:flag_ar:</span>"
         result = HTMLPipeline::NodeFilter::EmojiFilter.call(body, context: { asset_root: "https://coolwebsite.com", img_attrs: Hash(draggable: false, height: nil, width: nil, align: nil) })
+
         assert_equal(%(<span><img class="emoji" title=":flag_ar:" alt=":flag_ar:" src="https://coolwebsite.com/emoji/1f1e6-1f1f7.png" draggable="false"></span>), result)
       end
     end
diff --git a/test/html_pipeline/node_filter/https_filter_test.rb b/test/html_pipeline/node_filter/https_filter_test.rb
index ca2ec92d..98eb25b9 100644
--- a/test/html_pipeline/node_filter/https_filter_test.rb
+++ b/test/html_pipeline/node_filter/https_filter_test.rb
@@ -12,7 +12,7 @@ def setup
 
     def test_http
       assert_equal(%(<a href="https://github.com">github.com</a>),
-      HttpsFilter.call(%(<a href="http://github.com">github.com</a>), context: @options))
+        HttpsFilter.call(%(<a href="http://github.com">github.com</a>), context: @options))
     end
 
     def test_https
diff --git a/test/html_pipeline/node_filter/image_max_width_filter_test.rb b/test/html_pipeline/node_filter/image_max_width_filter_test.rb
index c1b42ccf..df7f4f9d 100644
--- a/test/html_pipeline/node_filter/image_max_width_filter_test.rb
+++ b/test/html_pipeline/node_filter/image_max_width_filter_test.rb
@@ -11,6 +11,7 @@ def setup
     def test_rewrites_image_style_tags
       body = '<p>Screenshot: <img src="screenshot.png"></p>'
       res = @filter.call(body)
+
       assert_equal('<p>Screenshot: <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
         res)
     end
@@ -19,6 +20,7 @@ def test_leaves_existing_image_style_tags_alone
       body = '<p><img src="screenshot.png" style="width:100px;"></p>'
 
       res = @filter.call(body)
+
       assert_equal('<p><img src="screenshot.png" style="width:100px;"></p>',
         res)
     end
@@ -27,6 +29,7 @@ def test_links_to_image
       body = '<p>Screenshot: <img src="screenshot.png"></p>'
 
       res = @filter.call(body)
+
       assert_equal('<p>Screenshot: <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
         res)
     end
@@ -35,6 +38,7 @@ def test_doesnt_link_to_image_when_already_linked
       body = '<p>Screenshot: <a href="blah.png"><img src="screenshot.png"></a></p>'
 
       res = @filter.call(body)
+
       assert_equal('<p>Screenshot: <a href="blah.png"><img src="screenshot.png" style="max-width:100%;"></a></p>',
         res)
     end
@@ -43,6 +47,7 @@ def test_doesnt_screw_up_inlined_images
       body = '<p>Screenshot <img src="screenshot.png">, yes, this is a <b>screenshot</b> indeed.</p>'
 
       res = @filter.call(body)
+
       assert_equal('<p>Screenshot <a target="_blank" href="screenshot.png"><img src="screenshot.png" style="max-width:100%;"></a>, yes, this is a <b>screenshot</b> indeed.</p>', res)
     end
   end
diff --git a/test/html_pipeline/node_filter/mention_filter_test.rb b/test/html_pipeline/node_filter/mention_filter_test.rb
index 1ddd25cf..bcd9b2d1 100644
--- a/test/html_pipeline/node_filter/mention_filter_test.rb
+++ b/test/html_pipeline/node_filter/mention_filter_test.rb
@@ -10,9 +10,9 @@ def setup
 
       @pipeline = HTMLPipeline.new(convert_filter:
         HTMLPipeline::ConvertFilter::MarkdownFilter.new,
-      node_filters: [
-        HTMLPipeline::NodeFilter::MentionFilter.new,
-      ])
+        node_filters: [
+          HTMLPipeline::NodeFilter::MentionFilter.new,
+        ])
     end
 
     def mentioned_usernames(body)
@@ -21,43 +21,50 @@ def mentioned_usernames(body)
       result[:mentioned_usernames]
     end
     @pipeline =
-    def test_filtering_plain_text
-      body = "<p>@kneath: check it out.</p>"
-      res  = @filter.call(body, context: @context)
+      def test_filtering_plain_text
+        body = "<p>@kneath: check it out.</p>"
+        res  = @filter.call(body, context: @context)
 
-      link = '<a href="/kneath" class="user-mention">@kneath</a>'
-      assert_equal("<p>#{link}: check it out.</p>",
-        res)
-    end
+        link = '<a href="/kneath" class="user-mention">@kneath</a>'
+
+        assert_equal("<p>#{link}: check it out.</p>",
+          res)
+      end
 
     def test_not_replacing_mentions_in_pre_tags
       body = "<pre>@kneath: okay</pre>"
+
       assert_equal(body, @filter.call(body, context: @context))
     end
 
     def test_not_replacing_mentions_in_code_tags
       body = "<p><code>@kneath:</code> okay</p>"
+
       assert_equal(body, @filter.call(body, context: @context))
     end
 
     def test_not_replacing_mentions_in_style_tags
       body = "<style>@media (min-width: 768px) { color: red; }</style>"
+
       assert_equal(body, @filter.call(body, context: @context))
     end
 
     def test_not_replacing_mentions_in_links
       body = "<p><a>@kneath</a> okay</p>"
+
       assert_equal(body, @filter.call(body, context: @context))
     end
 
     def test_entity_encoding_and_whatnot
       body = "<p>@&#x6b;neath what's up</p>"
+
       assert_equal(body, @filter.call(body, context: @context))
     end
 
     def test_html_injection
       body = "<p>@kneath &lt;script>alert(0)&lt;/script></p>"
       link = '<a href="/kneath" class="user-mention">@kneath</a>'
+
       assert_equal("<p>#{link} &lt;script>alert(0)&lt;/script></p>",
         @filter.call(body, context: @context))
     end
@@ -65,6 +72,7 @@ def test_html_injection
     def test_base_url_slash
       body = "<p>Hi, @jch!</p>"
       link = '<a href="/jch" class="user-mention">@jch</a>'
+
       assert_equal("<p>Hi, #{link}!</p>",
         @filter.call(body, context: { base_url: "/" }))
     end
@@ -72,6 +80,7 @@ def test_base_url_slash
     def test_base_url_under_custom_route
       body = "<p>Hi, @jch!</p>"
       link = '<a href="/userprofile/jch" class="user-mention">@jch</a>'
+
       assert_equal("<p>Hi, #{link}!</p>",
         @filter.call(body, context: @context.merge({ base_url: "/userprofile" })))
     end
@@ -79,82 +88,98 @@ def test_base_url_under_custom_route
     def test_base_url_slash_with_tilde
       body = "<p>Hi, @jch!</p>"
       link = '<a href="/~jch" class="user-mention">@jch</a>'
+
       assert_equal("<p>Hi, #{link}!</p>",
         @filter.call(body, context: @context.merge({ base_url: "/~" })))
     end
 
     def test_matches_usernames_in_body
       body = "@test how are you?"
+
       assert_equal(["test"], mentioned_usernames(body))
     end
 
     def test_matches_usernames_with_dashes
       body = "hi @some-user"
+
       assert_equal(["some-user"], mentioned_usernames(body))
     end
 
     def test_matches_usernames_followed_by_a_single_dot
       body = "okay @some-user."
+
       assert_equal(["some-user"], mentioned_usernames(body))
     end
 
     def test_matches_usernames_followed_by_multiple_dots
       body = "okay @some-user..."
+
       assert_equal(["some-user"], mentioned_usernames(body))
     end
 
     def test_does_not_match_email_addresses
       body = "aman@tmm1.net"
+
       assert_empty(mentioned_usernames(body))
     end
 
     def test_does_not_match_domain_name_looking_things
       body = "we need a @github.com email"
+
       assert_empty(mentioned_usernames(body))
     end
 
     def test_does_not_match_organization_team_mentions
       body = "we need to @github/enterprise know"
+
       assert_empty(mentioned_usernames(body))
     end
 
     def test_matches_colon_suffixed_names
       body = "@tmm1: what do you think?"
+
       assert_equal(["tmm1"], mentioned_usernames(body))
     end
 
     def test_matches_list_of_names
       body = "@defunkt @atmos @kneath"
+
       assert_equal(["defunkt", "atmos", "kneath"], mentioned_usernames(body))
     end
 
     def test_matches_list_of_names_with_commas
       body = "/cc @defunkt, @atmos, @kneath"
+
       assert_equal(["defunkt", "atmos", "kneath"], mentioned_usernames(body))
     end
 
     def test_matches_inside_brackets
       body = "(@mislav) and [@rtomayko]"
+
       assert_equal(["mislav", "rtomayko"], mentioned_usernames(body))
     end
 
     def test_doesnt_ignore_invalid_users
       body = "@defunkt @mojombo and @somedude"
+
       assert_equal(["defunkt", "mojombo", "somedude"], mentioned_usernames(body))
     end
 
     def test_returns_distinct_set
       body = "/cc @defunkt, @atmos, @kneath, @defunkt, @defunkt"
+
       assert_equal(["defunkt", "atmos", "kneath"], mentioned_usernames(body))
     end
 
     def test_does_not_match_inline_code_block_with_multiple_code_blocks
       body = "something\n\n`/cc @defunkt @atmos @kneath` `/cc @atmos/atmos`"
+
       assert_empty(mentioned_usernames(body))
     end
 
     def test_mention_at_end_of_parenthetical_sentence
       body = "(We're talking 'bout @ymendel.)"
+
       assert_equal(["ymendel"], mentioned_usernames(body))
     end
 
@@ -164,6 +189,7 @@ def test_username_pattern_can_be_customized
       res  = @filter.call(body, context: { base_url: "/", username_pattern: /(_[a-z]{3})/ })
 
       link = '<a href="/_abc" class="user-mention">@_abc</a>'
+
       assert_equal("<p>#{link}: test.</p>",
         res)
     end
@@ -175,15 +201,18 @@ def test_filter_does_not_create_a_new_object_for_default_username_pattern
       pattern_count = HTMLPipeline::NodeFilter::MentionFilter::MENTION_PATTERNS.length
 
       @filter.call(body.dup)
+
       assert_equal(pattern_count, HTMLPipeline::NodeFilter::MentionFilter::MENTION_PATTERNS.length)
 
       @filter.call(body.clone, context: { username_pattern: /test/ })
+
       assert_equal(pattern_count + 1, HTMLPipeline::NodeFilter::MentionFilter::MENTION_PATTERNS.length)
     end
 
     def test_mention_link_filter
       result = HTMLPipeline::NodeFilter::MentionFilter.call("<p>@hubot</p>")
       expected = '<p><a href="/hubot" class="user-mention">@hubot</a></p>'
+
       assert_equal(expected, result)
     end
   end
diff --git a/test/html_pipeline/node_filter/syntax_highlight_filter_test.rb b/test/html_pipeline/node_filter/syntax_highlight_filter_test.rb
index cba3152d..92d3863d 100644
--- a/test/html_pipeline/node_filter/syntax_highlight_filter_test.rb
+++ b/test/html_pipeline/node_filter/syntax_highlight_filter_test.rb
@@ -13,6 +13,7 @@ def test_highlight_default
       )
 
       doc = Nokogiri.parse(result)
+
       refute_empty(doc.css(".highlight"))
       refute_empty(doc.css(".highlight-coffeescript"))
     end
@@ -23,6 +24,7 @@ def test_highlight_default_will_not_override
       )
 
       doc = Nokogiri.parse(result)
+
       assert_empty(doc.css(".highlight-coffeescript"))
       refute_empty(doc.css(".highlight-c"))
     end
diff --git a/test/html_pipeline/node_filter/table_of_contents_filter_test.rb b/test/html_pipeline/node_filter/table_of_contents_filter_test.rb
index 42995182..33b62889 100644
--- a/test/html_pipeline/node_filter/table_of_contents_filter_test.rb
+++ b/test/html_pipeline/node_filter/table_of_contents_filter_test.rb
@@ -20,6 +20,7 @@ def toc_s(content)
       def test_anchors_and_list_are_added_properly
         orig = %(# Ice cube\n\nWill swarm on any motherfucker in a blue uniform)
         result = TocPipeline.call(orig)
+
         assert_includes(result[:output], "<a href=")
       end
 
@@ -30,13 +31,15 @@ def test_custom_anchor_html_added_properly
           TocFilter.new(context: { anchor_html: "#" }),
         ])
         result = pipeline.call(orig)
+
         assert_equal(expected, result[:output])
       end
 
       def test_toc_list_added_properly
         orig = %(# Ice cube\n\nWill swarm on any motherfucker in a blue uniform)
         result = TocPipeline.call(orig)
-        assert_equal(result[:toc].first, {:href=>"#ice-cube", :text=>"Ice cube"})
+
+        assert_equal({ href: "#ice-cube", text: "Ice cube" }, result[:toc].first)
       end
 
       def test_anchors_have_sane_names
@@ -53,6 +56,7 @@ def test_anchors_have_sane_names
       def test_anchors_have_aria_hidden
         orig = "# Straight Outta Compton"
         result = TocPipeline.call(orig)[:output]
+
         assert_includes(result, 'aria-hidden="true"')
       end
 
@@ -68,14 +72,14 @@ def test_toc_hrefs_have_sane_values
 
       def test_dupe_headers_have_unique_trailing_identifiers
         orig = <<~STR
-             # Straight Outta Compton
+          # Straight Outta Compton
 
-             ## Dopeman
+          ## Dopeman
 
-             ### Express Yourself
+          ### Express Yourself
 
-             # Dopeman
-             STR
+          # Dopeman
+        STR
 
         result = TocPipeline.call(orig)[:output]
 
@@ -85,14 +89,14 @@ def test_dupe_headers_have_unique_trailing_identifiers
 
       def test_dupe_headers_have_unique_toc_anchors
         orig = <<~STR
-             # Straight Outta Compton
+          # Straight Outta Compton
 
-             ## Dopeman
+          ## Dopeman
 
-             ### Express Yourself
+          ### Express Yourself
 
-             # Dopeman
-             STR
+          # Dopeman
+        STR
 
         assert_includes(toc_s(orig), '"#dopeman"')
         assert_includes(toc_s(orig), '"#dopeman-1"')
@@ -100,15 +104,15 @@ def test_dupe_headers_have_unique_toc_anchors
 
       def test_all_header_tags_are_found_when_adding_anchors
         orig = <<~STR
-                # "Funky President" by James Brown
-                ## "It's My Thing" by Marva Whitney
-                ### "Boogie Back" by Roy Ayers
-                #### "Feel Good" by Fancy
-                ##### "Funky Drummer" by James Brown
-                ###### "Ruthless Villain" by Eazy-E
-              STR
+          # "Funky President" by James Brown
+          ## "It's My Thing" by Marva Whitney
+          ### "Boogie Back" by Roy Ayers
+          #### "Feel Good" by Fancy
+          ##### "Funky Drummer" by James Brown
+          ###### "Ruthless Villain" by Eazy-E
+        STR
 
-              result = TocPipeline.call(orig, context: {}, result: result)
+        result = TocPipeline.call(orig, context: {}, result: result)
 
         doc = Nokogiri::HTML(result[:output])
 
@@ -123,34 +127,33 @@ def test_toc_outputs_escaped_html
 
       def test_toc_is_complete
         orig = <<~STR
-                # "Funky President" by James Brown
-                ## "It's My Thing" by Marva Whitney
-                ### "Boogie Back" by Roy Ayers
-                #### "Feel Good" by Fancy
-                ##### "Funky Drummer" by James Brown
-                ###### "Ruthless Villain" by Eazy-E
-              STR
-
-              result = TocPipeline.call(orig)[:toc]
-        expected = [{:href=>"#funky-president-by-james-brown", :text=>"&quot;Funky President&quot; by James Brown"},
-                     {:href=>"#its-my-thing-by-marva-whitney", :text=>"&quot;It's My Thing&quot; by Marva Whitney"},
-                     {:href=>"#boogie-back-by-roy-ayers", :text=>"&quot;Boogie Back&quot; by Roy Ayers"},
-                     {:href=>"#feel-good-by-fancy", :text=>"&quot;Feel Good&quot; by Fancy"},
-                     {:href=>"#funky-drummer-by-james-brown", :text=>"&quot;Funky Drummer&quot; by James Brown"},
-                     {:href=>"#ruthless-villain-by-eazy-e", :text=>"&quot;Ruthless Villain&quot; by Eazy-E"}]
-
-                     0..6.times do |i|
+          # "Funky President" by James Brown
+          ## "It's My Thing" by Marva Whitney
+          ### "Boogie Back" by Roy Ayers
+          #### "Feel Good" by Fancy
+          ##### "Funky Drummer" by James Brown
+          ###### "Ruthless Villain" by Eazy-E
+        STR
 
-          assert_equal(expected[i], result[i])
-        end
+        result = TocPipeline.call(orig)[:toc]
+        expected = [{ href: "#funky-president-by-james-brown", text: "&quot;Funky President&quot; by James Brown" },
+                    { href: "#its-my-thing-by-marva-whitney", text: "&quot;It's My Thing&quot; by Marva Whitney" },
+                    { href: "#boogie-back-by-roy-ayers", text: "&quot;Boogie Back&quot; by Roy Ayers" },
+                    { href: "#feel-good-by-fancy", text: "&quot;Feel Good&quot; by Fancy" },
+                    { href: "#funky-drummer-by-james-brown", text: "&quot;Funky Drummer&quot; by James Brown" },
+                    { href: "#ruthless-villain-by-eazy-e", text: "&quot;Ruthless Villain&quot; by Eazy-E" },]
+
+        0..6.times do |i|
+             assert_equal(expected[i], result[i])
+           end
       end
 
       def test_anchors_with_utf8_characters
         orig = <<~STR
-              # 日本語
+          # 日本語
 
-              # Русский
-              STR
+          # Русский
+        STR
 
         rendered_h1s = Nokogiri::HTML(TocPipeline.call(orig)[:output]).search("h1").map(&:to_s)
 
@@ -162,17 +165,17 @@ def test_anchors_with_utf8_characters
 
       def test_toc_with_utf8_characters
         orig = <<~STR
-        # 日本語
+          # 日本語
 
-        # Русский
+          # Русский
         STR
 
         result = TocPipeline.call(orig)[:toc]
 
-        expected = [{:href=>"#%E6%97%A5%E6%9C%AC%E8%AA%9E",
-                     :text=>"日本語"},
-                     {:href=>"#%D1%80%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9",
-                    :text => "Русский"}]
+        expected = [{ href: "#%E6%97%A5%E6%9C%AC%E8%AA%9E",
+                      text: "日本語", },
+                    { href: "#%D1%80%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9",
+                      text: "Русский", },]
 
         0..2.times do |i|
           assert_equal(expected[i], result[i])
diff --git a/test/html_pipeline/node_filter/team_mention_filter_test.rb b/test/html_pipeline/node_filter/team_mention_filter_test.rb
index 101c5961..4c93dbab 100644
--- a/test/html_pipeline/node_filter/team_mention_filter_test.rb
+++ b/test/html_pipeline/node_filter/team_mention_filter_test.rb
@@ -9,9 +9,9 @@ def setup
 
       @pipeline =
         HTMLPipeline.new(convert_filter: HTMLPipeline::ConvertFilter::MarkdownFilter.new,
-        node_filters: [
-          HTMLPipeline::NodeFilter::TeamMentionFilter.new,
-        ])
+          node_filters: [
+            HTMLPipeline::NodeFilter::TeamMentionFilter.new,
+          ])
     end
 
     def mentioned_teams(body)
@@ -25,45 +25,53 @@ def test_filtering_plain_text
       res  = @filter.call(body, context: { base_url: "/" })
 
       link = '<a href="/github/team" class="team-mention">@github/team</a>'
+
       assert_equal("<p>#{link}: check it out.</p>",
         res)
     end
 
     def test_not_replacing_mentions_in_pre_tags
       body = "<pre>@github/team: okay</pre>"
+
       assert_equal(body, @filter.call(body))
     end
 
     def test_not_replacing_mentions_in_code_tags
       body = "<p><code>@github/team:</code> okay</p>"
+
       assert_equal(body, @filter.call(body))
     end
 
     def test_not_replacing_mentions_in_style_tags
       body = "<style>@github/team (min-width: 768px) { color: red; }</style>"
+
       assert_equal(body, @filter.call(body))
     end
 
     def test_not_replacing_mentions_in_links
       body = "<p><a>@github/team</a> okay</p>"
+
       assert_equal(body, @filter.call(body))
     end
 
     def test_entity_encoding_and_whatnot
       body = "<p>@github&#47team what's up</p>"
       link = '<a href="/github/team" class="team-mention">@github/team</a>'
+
       assert_equal("<p>#{link} what's up</p>", @filter.call(body, context: { base_url: "/" }))
     end
 
     def test_html_injection
       body = "<p>@github/team &lt;script>alert(0)&lt;/script></p>"
       link = '<a href="/github/team" class="team-mention">@github/team</a>'
+
       assert_equal("<p>#{link} &lt;script>alert(0)&lt;/script></p>",
         @filter.call(body, context: { base_url: "/" }))
     end
 
     def test_links_to_nothing_with_user_mention
       body = "<p>Hi, @kneath</p>"
+
       assert_equal("<p>Hi, @kneath</p>",
         @filter.call(body, context: { base_url: "/" }))
     end
@@ -71,6 +79,7 @@ def test_links_to_nothing_with_user_mention
     def test_base_url_slash
       body = "<p>Hi, @github/team!</p>"
       link = '<a href="/github/team" class="team-mention">@github/team</a>'
+
       assert_equal("<p>Hi, #{link}!</p>",
         @filter.call(body, context: { base_url: "/" }))
     end
@@ -78,6 +87,7 @@ def test_base_url_slash
     def test_base_url_under_custom_route
       body = "<p>Hi, @org/team!</p>"
       link = '<a href="www.github.com/org/team" class="team-mention">@org/team</a>'
+
       assert_equal("<p>Hi, #{link}!</p>",
         @filter.call(body, context: { base_url: "www.github.com" }))
     end
@@ -85,6 +95,7 @@ def test_base_url_under_custom_route
     def test_base_url_slash_with_tilde
       body = "<p>Hi, @github/team!</p>"
       link = '<a href="/~github/team" class="team-mention">@github/team</a>'
+
       assert_equal("<p>Hi, #{link}!</p>",
         @filter.call(body, context: { base_url: "/~" }))
     end
@@ -93,82 +104,98 @@ def test_multiple_team_mentions
       body = "<p>Hi, @github/whale and @github/donut!</p>"
       link_whale = '<a href="/github/whale" class="team-mention">@github/whale</a>'
       link_donut = '<a href="/github/donut" class="team-mention">@github/donut</a>'
+
       assert_equal("<p>Hi, #{link_whale} and #{link_donut}!</p>",
         @filter.call(body))
     end
 
     def test_matches_teams_in_body
       body = "@test/team how are you?"
+
       assert_equal(["team"], mentioned_teams(body))
     end
 
     def test_matches_orgs_with_dashes
       body = "hi @some-org/team"
+
       assert_equal(["team"], mentioned_teams(body))
     end
 
     def test_matches_teams_with_dashes
       body = "hi @github/some-team"
+
       assert_equal(["some-team"], mentioned_teams(body))
     end
 
     def test_matches_teams_followed_by_a_single_dot
       body = "okay @github/team."
+
       assert_equal(["team"], mentioned_teams(body))
     end
 
     def test_matches_teams_followed_by_multiple_dots
       body = "okay @github/team..."
+
       assert_equal(["team"], mentioned_teams(body))
     end
 
     def test_does_not_match_email_addresses
       body = "aman@tmm1.net"
+
       assert_empty(mentioned_teams(body))
     end
 
     def test_does_not_match_domain_name_looking_things
       body = "we need a @github.com email"
+
       assert_empty(mentioned_teams(body))
     end
 
     def test_does_not_match_user_mentions
       body = "we need to @enterprise know"
+
       assert_empty(mentioned_teams(body))
     end
 
     def test_matches_colon_suffixed_team_names
       body = "@github/team: what do you think?"
+
       assert_equal(["team"], mentioned_teams(body))
     end
 
     def test_matches_list_of_teams
       body = "@github/whale @github/donut @github/green"
+
       assert_equal(["whale", "donut", "green"], mentioned_teams(body))
     end
 
     def test_matches_list_of_teams_with_commas
       body = "/cc @github/whale, @github/donut, @github/green"
+
       assert_equal(["whale", "donut", "green"], mentioned_teams(body))
     end
 
     def test_matches_inside_brackets
       body = "(@github/whale) and [@github/donut]"
+
       assert_equal(["whale", "donut"], mentioned_teams(body))
     end
 
     def test_returns_distinct_set
       body = "/cc @github/whale, @github/donut, @github/whale, @github/whale"
+
       assert_equal(["whale", "donut"], mentioned_teams(body))
     end
 
     def test_does_not_match_inline_code_block_with_multiple_code_blocks
       body = "something\n\n`/cc @github/whale @github/donut @github/green` `/cc @donut/donut`"
+
       assert_empty(mentioned_teams(body))
     end
 
     def test_mention_at_end_of_parenthetical_sentence
       body = "(We're talking 'bout @some-org/some-team.)"
+
       assert_equal(["some-team"], mentioned_teams(body))
     end
 
@@ -178,6 +205,7 @@ def test_team_pattern_can_be_customized
       res  = @filter.call(body, context: { team_pattern: %r{@(_[a-z]{3})/([A-Z]{3})} })
 
       link = '<a href="/_abc/XYZ" class="team-mention">@_abc/XYZ</a>'
+
       assert_equal("<p>#{link}: test</p>",
         res)
     end
@@ -185,6 +213,7 @@ def test_team_pattern_can_be_customized
     def test_mention_link_filter
       result = HTMLPipeline::NodeFilter::TeamMentionFilter.call("<p>@bot/hubot</p>")
       expected = "<p><a href=\"/bot/hubot\" class=\"team-mention\">@bot/hubot</a></p>"
+
       assert_equal(expected, result)
     end
   end
diff --git a/test/html_pipeline/require_helper_test.rb b/test/html_pipeline/require_helper_test.rb
index 31ac5b50..6c67bd28 100644
--- a/test/html_pipeline/require_helper_test.rb
+++ b/test/html_pipeline/require_helper_test.rb
@@ -10,6 +10,7 @@ def test_works_with_existing_dependency
 
     def test_works_with_existing_dependencies
       HTMLPipeline.require_dependencies(["old_sql", "nokogiri"], "SomeClass")
+
       assert_predicate(HTMLPipeline, :nokogiri_loaded?)
       refute_predicate(HTMLPipeline, :old_sql_loaded?)
     end
@@ -30,6 +31,7 @@ def test_raises_dependency_error_including_message
       error = assert_raises(HTMLPipeline::MissingDependencyError) do
         HTMLPipeline.require_dependency("non-existant", "SomeClass")
       end
+
       assert_includes(error.message, "Missing dependency 'non-existant' for SomeClass. See README.md for details.")
     end
 
@@ -37,6 +39,7 @@ def test_raises_dependencies_error_including_message
       error = assert_raises(HTMLPipeline::MissingDependencyError) do
         HTMLPipeline.require_dependencies(["non-existant", "something"], "SomeClass")
       end
+
       assert_includes(error.message, "Missing all dependencies 'non-existant, something' for SomeClass. See README.md for details.")
     end
 
@@ -44,6 +47,7 @@ def test_raises_error_includes_underlying_message
       error = assert_raises(HTMLPipeline::MissingDependencyError) do
         HTMLPipeline.require_dependency("non-existant", "SomeClass")
       end
+
       assert_includes(error.message, "LoadError: cannot load such file")
     end
   end
diff --git a/test/html_pipeline/text_filter/plain_text_input_filter_test.rb b/test/html_pipeline/text_filter/plain_text_input_filter_test.rb
index a0af12cc..742afab9 100644
--- a/test/html_pipeline/text_filter/plain_text_input_filter_test.rb
+++ b/test/html_pipeline/text_filter/plain_text_input_filter_test.rb
@@ -14,11 +14,13 @@ def test_fails_when_given_a_documentfragment
 
     def test_wraps_input_in_a_div_element
       doc = PlainTextInputFilter.call("howdy pahtner", context: {})
+
       assert_equal("<div>howdy pahtner</div>", doc.to_s)
     end
 
     def test_html_escapes_plain_text_input
       doc = PlainTextInputFilter.call("See: <http://example.org>", context: {})
+
       assert_equal("<div>See: &lt;http://example.org&gt;</div>",
         doc.to_s)
     end
diff --git a/test/html_pipeline_test.rb b/test/html_pipeline_test.rb
index d3f4088b..dd79d2a8 100644
--- a/test/html_pipeline_test.rb
+++ b/test/html_pipeline_test.rb
@@ -5,8 +5,10 @@
 
 class HTMLPipelineTest < Minitest::Test
   class TestFilter < HTMLPipeline::TextFilter
-    def self.call(input, context: {}, result: {})
-      input.reverse
+    class << self
+      def call(input, context: {}, result: {})
+        input.reverse
+      end
     end
   end
 
@@ -22,6 +24,7 @@ def test_filter_instrumentation
     body = "hello"
     @pipeline.call(body)
     event, payload, = events.pop
+
     assert(event, "event expected")
     assert_equal("call_filter.html_pipeline", event)
     assert_equal(TestFilter.name, payload[:filter])
@@ -36,6 +39,7 @@ def test_pipeline_instrumentation
     body = "hello"
     @pipeline.call(body)
     event, payload, = events.pop
+
     assert(event, "event expected")
     assert_equal("call_text_filters.html_pipeline", event)
     assert_equal(@pipeline.text_filters.map(&:name), payload[:text_filters])
@@ -47,6 +51,7 @@ def test_default_instrumentation_service
     service = "default"
     HTMLPipeline.default_instrumentation_service = service
     pipeline = HTMLPipeline.new(text_filters: [], default_context: @default_context)
+
     assert_equal(service, pipeline.instrumentation_service)
   ensure
     HTMLPipeline.default_instrumentation_service = nil
@@ -67,6 +72,7 @@ def test_setup_instrumentation
     @pipeline.call(body)
 
     event, payload, = events.pop
+
     assert(event, "expected event")
     assert_equal(name, payload[:pipeline])
     assert_equal(body.reverse, payload[:result][:output])
diff --git a/test/sanitization_filter_test.rb b/test/sanitization_filter_test.rb
index 6f62c18b..4c56e915 100644
--- a/test/sanitization_filter_test.rb
+++ b/test/sanitization_filter_test.rb
@@ -10,18 +10,21 @@ class SanitizationFilterTest < Minitest::Test
     def test_removing_script_tags
       orig = %(<p><img src="http://github.com/img.png" /><script></script></p>)
       html = SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s
+
       refute_match(/script/, html)
     end
 
     def test_removing_style_tags
       orig = %(<p><style>hey now</style></p>)
       html = SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s
+
       refute_match(/style/, html)
     end
 
     def test_removing_style_attributes
       orig = %(<p style='font-size:1000%'>YO DAWG</p>)
       html = SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s
+
       refute_match(/font-size/, html)
       refute_match(/style/, html)
     end
@@ -29,41 +32,48 @@ def test_removing_style_attributes
     def test_removing_script_event_handler_attributes
       orig = %(<a onclick='javascript:alert(0)'>YO DAWG</a>)
       html = SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s
+
       refute_match(/javscript/, html)
       refute_match(/onclick/, html)
     end
 
     def test_sanitizes_li_elements_not_contained_in_ul_or_ol
       stuff = "a\n<li>b</li>\nc"
-      html  = SanitizationFilter.call(stuff, { elements: {}}).to_s
+      html  = SanitizationFilter.call(stuff, { elements: {} }).to_s
+
       assert_equal("a\nb\nc", html)
     end
 
     def test_does_not_sanitize_li_elements_contained_in_ul_or_ol
       stuff = "a\n<ul><li>b</li></ul>\nc"
+
       assert_equal(stuff, SanitizationFilter.call(stuff, DEFAULT_CONFIG).to_s)
     end
 
     def test_github_specific_protocols_are_removed
       stuff = '<a href="github-windows://spillthelog">Spill this yo</a> and so on'
+
       assert_equal("<a>Spill this yo</a> and so on", SanitizationFilter.call(stuff, DEFAULT_CONFIG).to_s)
     end
 
     def test_unknown_schemes_are_removed
       stuff = '<a href="something-weird://heyyy">Wat</a> is this'
       html  = SanitizationFilter.call(stuff, DEFAULT_CONFIG).to_s
+
       assert_equal("<a>Wat</a> is this", html)
     end
 
     def test_allowlisted_longdesc_schemes_are_allowed
       stuff = '<img src="./foo.jpg" longdesc="http://longdesc.com">'
       html  = SanitizationFilter.call(stuff, DEFAULT_CONFIG).to_s
+
       assert_equal('<img src="./foo.jpg" longdesc="http://longdesc.com">', html)
     end
 
     def test_weird_longdesc_schemes_are_removed
       stuff = '<img src="./foo.jpg" longdesc="javascript:alert(1)">'
       html  = SanitizationFilter.call(stuff, DEFAULT_CONFIG).to_s
+
       assert_equal('<img src="./foo.jpg">', html)
     end
 
@@ -71,6 +81,7 @@ def test_standard_schemes_are_removed_if_not_specified_in_anchor_schemes
       config = DEFAULT_CONFIG.merge(protocols: { "a" => { "href" => [] } })
       stuff  = '<a href="http://www.example.com/">No href for you</a>'
       html = SanitizationFilter.call(stuff, config)
+
       assert_equal("<a>No href for you</a>", html)
     end
 
@@ -78,6 +89,7 @@ def test_custom_anchor_schemes_are_not_removed
       config = DEFAULT_CONFIG.merge(protocols: { "a" => { "href" => ["something-weird"] } })
       stuff  = '<a href="something-weird://heyyy">Wat</a> is this'
       html = SanitizationFilter.call(stuff, config)
+
       assert_equal(stuff, html)
     end
 
@@ -89,6 +101,7 @@ def test_anchor_schemes_are_merged_with_other_anchor_restrictions
         protocols: { "a" => { "href" => ["something-weird"] } },
       }
       html = SanitizationFilter.call(stuff, allowlist)
+
       assert_equal('<a href="something-weird://heyyy">Wat</a> is this', html)
     end
 
@@ -100,6 +113,7 @@ def test_uses_anchor_schemes_from_allowlist_when_not_separately_specified
         protocols: { "a" => { "href" => ["something-weird"] } },
       }
       html = SanitizationFilter.call(stuff, allowlist)
+
       assert_equal(stuff, html)
     end
 
@@ -113,17 +127,20 @@ def test_exports_default_anchor_schemes
 
     def test_script_contents_are_removed
       orig = "<script>JavaScript!</script>"
+
       assert_equal("", SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s)
     end
 
     def test_table_rows_and_cells_removed_if_not_in_table
       orig = %(<tr><td>Foo</td></tr><td>Bar</td>)
-      assert_equal("FooBar", SanitizationFilter.call(orig, { elements: {}}))
+
+      assert_equal("FooBar", SanitizationFilter.call(orig, { elements: {} }))
     end
 
     def test_table_sections_removed_if_not_in_table
       orig = %(<thead><tr><td>Foo</td></tr></thead>)
-      assert_equal("Foo", SanitizationFilter.call(orig, { elements: {}}).to_s)
+
+      assert_equal("Foo", SanitizationFilter.call(orig, { elements: {} }).to_s)
     end
 
     def test_table_sections_are_not_removed
@@ -132,16 +149,19 @@ def test_table_sections_are_not_removed
 <tfoot><tr><td>Sum</td></tr></tfoot>
 <tbody><tr><td>1</td></tr></tbody>
 </table>)
+
       assert_equal(orig, SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s)
     end
 
     def test_summary_tag_are_not_removed
       orig = %(<summary>Foo</summary>)
+
       assert_equal(orig, SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s)
     end
 
     def test_details_tag_and_open_attribute_are_not_removed
       orig = %(<details open>Foo</details>)
+
       assert_equal(orig, SanitizationFilter.call(orig, DEFAULT_CONFIG).to_s)
     end
 
@@ -170,7 +190,7 @@ def test_sanitization_pipeline_can_be_configured
         sanitization_config: config,
         node_filters: [
           HTMLPipeline::NodeFilter::SyntaxHighlightFilter.new,
-        ]
+        ],
       )
 
       result = pipeline.call(<<~CODE)
@@ -194,7 +214,7 @@ def test_sanitization_pipeline_can_be_removed
         sanitization_config: nil,
         node_filters: [
           HTMLPipeline::NodeFilter::SyntaxHighlightFilter.new,
-        ]
+        ],
       )
 
       result = pipeline.call(<<~CODE)
diff --git a/test/test_helper.rb b/test/test_helper.rb
index 8deb225b..6c7bcd49 100644
--- a/test/test_helper.rb
+++ b/test/test_helper.rb
@@ -10,8 +10,6 @@
 require "awesome_print"
 
 module TestHelpers
-
-
 end
 
 Minitest::Test.include(TestHelpers)

From 923eff0697dbfce5977b6ffe7209aa12f711781c Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Sat, 24 Dec 2022 13:43:38 -0800
Subject: [PATCH 39/64] oop, latest rubygems, please

---
 .github/workflows/test.yml | 1 +
 html-pipeline.gemspec      | 2 ++
 2 files changed, 3 insertions(+)

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index aa87ada1..ba94ccbf 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -23,6 +23,7 @@ jobs:
         uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby-version }}
+          rubygems: latest
           bundler-cache: true
 
       - name: Install dependencies
diff --git a/html-pipeline.gemspec b/html-pipeline.gemspec
index dea8d8b9..dbd6e278 100644
--- a/html-pipeline.gemspec
+++ b/html-pipeline.gemspec
@@ -17,6 +17,8 @@ Gem::Specification.new do |gem|
   gem.require_paths = ["lib"]
 
   gem.required_ruby_version = "~> 3.1"
+  # https://github.com/rubygems/rubygems/pull/5852#issuecomment-1231118509
+  gem.required_rubygems_version = ">= 3.3.22"
 
   gem.metadata = {
     "funding_uri" => "https://github.com/sponsors/gjtorikian/",

From 8d3a4110dcf877edca67ab5f1bcffdff5513f2a1 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Mon, 26 Dec 2022 09:50:34 -0800
Subject: [PATCH 40/64] update selma semantics

---
 lib/html_pipeline/node_filter/emoji_filter.rb         |  6 +++---
 .../node_filter/image_max_width_filter.rb             |  3 ++-
 lib/html_pipeline/node_filter/mention_filter.rb       | 11 ++++++-----
 .../node_filter/syntax_highlight_filter.rb            |  9 +++++----
 .../node_filter/table_of_contents_filter.rb           |  8 +++-----
 lib/html_pipeline/node_filter/team_mention_filter.rb  |  7 ++++---
 6 files changed, 23 insertions(+), 21 deletions(-)

diff --git a/lib/html_pipeline/node_filter/emoji_filter.rb b/lib/html_pipeline/node_filter/emoji_filter.rb
index af0d7190..8a01661d 100644
--- a/lib/html_pipeline/node_filter/emoji_filter.rb
+++ b/lib/html_pipeline/node_filter/emoji_filter.rb
@@ -24,10 +24,10 @@ def selector
         Selma::Selector.new(match_text_within: "*", ignore_text_within: ignored_ancestor_tags)
       end
 
-      def handle_text(text)
-        return text unless text.include?(":")
+      def handle_text_chunk(text)
+        return unless text.to_s.include?(":")
 
-        emoji_image_filter(text)
+        text.replace(emoji_image_filter(text.to_s), as: :html)
       end
 
       # Implementation of validate hook.
diff --git a/lib/html_pipeline/node_filter/image_max_width_filter.rb b/lib/html_pipeline/node_filter/image_max_width_filter.rb
index f662af3a..4e2501f5 100644
--- a/lib/html_pipeline/node_filter/image_max_width_filter.rb
+++ b/lib/html_pipeline/node_filter/image_max_width_filter.rb
@@ -31,8 +31,9 @@ def handle_element(element)
 
       def link_image(element)
         link_start = %(<a target="_blank" href="#{element["src"]}">)
+        element.before(link_start, as: :html)
         link_end = "</a>"
-        element.wrap(link_start, link_end, :as_html)
+        element.after(link_end, as: :html)
       end
     end
   end
diff --git a/lib/html_pipeline/node_filter/mention_filter.rb b/lib/html_pipeline/node_filter/mention_filter.rb
index 3f3fa6b1..a4c4b327 100644
--- a/lib/html_pipeline/node_filter/mention_filter.rb
+++ b/lib/html_pipeline/node_filter/mention_filter.rb
@@ -72,13 +72,14 @@ def selector
         SELECTOR
       end
 
-      def handle_text(text)
-        return text unless text.include?("@")
+      def handle_text_chunk(text)
+        content = text.to_s
+        return unless content.include?("@")
 
-        html = mention_link_filter(text, base_url: base_url, username_pattern: username_pattern)
-        return text if html == text
+        html = mention_link_filter(content, base_url: base_url, username_pattern: username_pattern)
+        return if html == content
 
-        html
+        text.replace(html, as: :html)
       end
 
       # The URL to provide when someone @mentions a "mention" name, such
diff --git a/lib/html_pipeline/node_filter/syntax_highlight_filter.rb b/lib/html_pipeline/node_filter/syntax_highlight_filter.rb
index 6813ad0d..fcc2082c 100644
--- a/lib/html_pipeline/node_filter/syntax_highlight_filter.rb
+++ b/lib/html_pipeline/node_filter/syntax_highlight_filter.rb
@@ -35,11 +35,12 @@ def handle_element(element)
         element["class"] = "#{scope} #{scope}-#{@lang}" if include_lang?
       end
 
-      def handle_text(text)
-        return text if @lang.nil?
-        return text if (lexer = lexer_for(@lang)).nil?
+      def handle_text_chunk(text)
+        return if @lang.nil?
+        return if (lexer = lexer_for(@lang)).nil?
+        content = text.to_s
 
-        highlight_with_timeout_handling(text, lexer)
+        text.replace(highlight_with_timeout_handling(content, lexer), as: :html)
       end
 
       def highlight_with_timeout_handling(text, lexer)
diff --git a/lib/html_pipeline/node_filter/table_of_contents_filter.rb b/lib/html_pipeline/node_filter/table_of_contents_filter.rb
index 3abceed3..80de8de1 100644
--- a/lib/html_pipeline/node_filter/table_of_contents_filter.rb
+++ b/lib/html_pipeline/node_filter/table_of_contents_filter.rb
@@ -57,15 +57,13 @@ def handle_element(element)
         element["id"] = header_id
         element["class"] = classes
 
-        element.set_inner_content(anchor_html, :as_html)
+        element.set_inner_content(anchor_html, as: :html)
 
         result[:toc] << { href: header_href }
       end
 
-      def handle_text(text)
-        result[:toc].last[:text] = text
-
-        text
+      def handle_text_chunk(text)
+        result[:toc].last[:text] = text.to_s
       end
     end
   end
diff --git a/lib/html_pipeline/node_filter/team_mention_filter.rb b/lib/html_pipeline/node_filter/team_mention_filter.rb
index 463b60df..b27e74a6 100644
--- a/lib/html_pipeline/node_filter/team_mention_filter.rb
+++ b/lib/html_pipeline/node_filter/team_mention_filter.rb
@@ -62,10 +62,11 @@ def selector
         SELECTOR
       end
 
-      def handle_text(text)
-        return text unless text.include?("@")
+      def handle_text_chunk(text)
+        content = text.to_s
+        return unless content.include?("@")
 
-        mention_link_filter(text, base_url: base_url, team_pattern: team_pattern)
+        text.replace(mention_link_filter(content, base_url: base_url, team_pattern: team_pattern), as: :html)
       end
 
       def team_pattern

From f3d3f71ba16981522aa48dbf5bd0e60a1cba0d4f Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Mon, 26 Dec 2022 10:02:41 -0800
Subject: [PATCH 41/64] define a safer allowlist

---
 lib/html_pipeline/sanitization_filter.rb | 66 +++++++++---------------
 test/sanitization_filter_test.rb         |  4 +-
 2 files changed, 26 insertions(+), 44 deletions(-)

diff --git a/lib/html_pipeline/sanitization_filter.rb b/lib/html_pipeline/sanitization_filter.rb
index 05be929d..7fcc1308 100644
--- a/lib/html_pipeline/sanitization_filter.rb
+++ b/lib/html_pipeline/sanitization_filter.rb
@@ -13,37 +13,35 @@ class HTMLPipeline
   #
   # This filter does not write additional information to the context.
   class SanitizationFilter
-    LISTS     = Set.new(["ul", "ol"].freeze)
-    LIST_ITEM = "li"
-
-    # List of table child elements. These must be contained by a <table> element
-    # or they are not allowed through. Otherwise they can be used to break out
-    # of places we're using tables to contain formatted user content (like pull
-    # request review comments).
-    TABLE_ITEMS = Set.new(["tr", "td", "th"].freeze)
-    TABLE = "table"
-    TABLE_SECTIONS = Set.new(["thead", "tbody", "tfoot"].freeze)
-
-    # These schemes are the only ones allowed in <a href> attributes by default.
-    PROTOCOLS = ["http", "https", "mailto", "xmpp", :relative, "irc", "ircs"].freeze
+    VALID_PROTOCOLS = Selma::Sanitizer::Config::VALID_PROTOCOLS.dup
 
     # The main sanitization allowlist. Only these elements and attributes are
     # allowed through by default.
     DEFAULT_CONFIG = {
-      elements: ["h1", "h2", "h3", "h4", "h5", "h6", "h7", "h8", "br", "b", "i", "strong", "em", "a", "pre", "code", "img", "tt", "div", "ins", "del", "sup", "sub", "p", "ol", "ul", "table", "thead", "tbody", "tfoot", "blockquote", "dl", "dt", "dd", "kbd", "q", "samp", "var", "hr", "ruby", "rt", "rp", "li", "tr", "td", "th", "s", "strike", "summary", "details", "caption", "figure", "figcaption", "abbr", "bdo", "cite", "dfn", "mark", "small", "span", "time", "wbr"].freeze,
-      remove_contents: ["script"].freeze,
+      elements: ["h1", "h2", "h3", "h4", "h5", "h6", "br", "b", "i", "strong", "em", "a", "pre", "code",
+                   "img", "tt", "div", "ins", "del", "sup", "sub", "p", "ol", "ul", "table", "thead", "tbody", "tfoot",
+                   "blockquote", "dl", "dt", "dd", "kbd", "q", "samp", "var", "hr", "ruby", "rt", "rp", "li", "tr", "td", "th",
+                   "s", "strike", "summary", "details", "caption", "figure", "figcaption", "abbr", "bdo", "cite",
+                   "dfn", "mark", "small", "span", "time", "wbr",],
+
       attributes: {
-        "a" => ["href"].freeze,
-        "img" => ["src", "longdesc"].freeze,
-        "div" => ["itemscope", "itemtype"].freeze,
-        "blockquote" => ["cite"].freeze,
-        "del" => ["cite"].freeze,
-        "ins" => ["cite"].freeze,
-        "q" => ["cite"].freeze,
-        all: ["abbr", "accept", "accept-charset", "accesskey", "action", "align", "alt", "aria-describedby", "aria-hidden", "aria-label", "aria-labelledby", "axis", "border", "cellpadding", "cellspacing", "char", "charoff", "charset", "checked", "clear", "cols", "colspan", "color", "compact", "coords", "datetime", "dir", "disabled", "enctype", "for", "frame", "headers", "height", "hreflang", "hspace", "ismap", "label", "lang", "maxlength", "media", "method", "multiple", "name", "nohref", "noshade", "nowrap", "open", "progress", "prompt", "readonly", "rel", "rev", "role", "rows", "rowspan", "rules", "scope", "selected", "shape", "size", "span", "start", "summary", "tabindex", "target", "title", "type", "usemap", "valign", "value", "vspace", "width", "itemprop"].freeze,
-      }.freeze,
+        "a" => ["href"],
+        "img" => ["src", "longdesc"],
+        "div" => ["itemscope", "itemtype"],
+        "blockquote" => ["cite"],
+        "del" => ["cite"],
+        "ins" => ["cite"],
+        "q" => ["cite"],
+        all: ["abbr", "accept", "accept-charset", "accesskey", "action", "align", "alt", "aria-describedby",
+              "aria-hidden", "aria-label", "aria-labelledby", "axis", "border", "cellpadding", "cellspacing", "char",
+              "charoff", "charset", "checked", "clear", "cols", "colspan", "color", "compact", "coords", "datetime", "dir",
+              "disabled", "enctype", "for", "frame", "headers", "height", "hreflang", "hspace", "id", "ismap", "label", "lang",
+              "maxlength", "media", "method", "multiple", "name", "nohref", "noshade", "nowrap", "open", "progress",
+              "prompt", "readonly", "rel", "rev", "role", "rows", "rowspan", "rules", "scope", "selected", "shape",
+              "size", "span", "start", "summary", "tabindex",  "title", "type", "usemap", "valign", "value", "width", "itemprop",],
+      },
       protocols: {
-        "a" => { "href" => PROTOCOLS }.freeze,
+        "a" => { "href" => Selma::Sanitizer::Config::VALID_PROTOCOLS }.freeze,
         "blockquote" => { "cite" => ["http", "https", :relative].freeze },
         "del" => { "cite" => ["http", "https", :relative].freeze },
         "ins" => { "cite" => ["http", "https", :relative].freeze },
@@ -53,23 +51,7 @@ class SanitizationFilter
           "longdesc" => ["http", "https", :relative].freeze,
         }.freeze,
       },
-      transformers: [
-        # Top-level <li> elements are removed because they can break out of
-        # containing markup.
-        lambda { |env|
-          name = env[:node_name]
-          node = env[:node]
-          node.replace(node.children) if name == LIST_ITEM && node.ancestors.none? { |n| LISTS.include?(n.name) }
-        },
-
-        # Table child elements that are not contained by a <table> are removed.
-        lambda { |env|
-          name = env[:node_name]
-          node = env[:node]
-          node.replace(node.children) if (TABLE_SECTIONS.include?(name) || TABLE_ITEMS.include?(name)) && node.ancestors.none? { |n| n.name == TABLE }
-        },
-      ].freeze,
-    }.freeze
+    }
 
     class << self
       def call(html, config)
diff --git a/test/sanitization_filter_test.rb b/test/sanitization_filter_test.rb
index 4c56e915..9f740c95 100644
--- a/test/sanitization_filter_test.rb
+++ b/test/sanitization_filter_test.rb
@@ -118,11 +118,11 @@ def test_uses_anchor_schemes_from_allowlist_when_not_separately_specified
     end
 
     def test_allowlist_contains_default_anchor_schemes
-      assert_equal(["http", "https", "mailto", "xmpp", :relative, "irc", "ircs"], SanitizationFilter::DEFAULT_CONFIG[:protocols]["a"]["href"])
+      assert_equal(["http", "https", "mailto", :relative], SanitizationFilter::DEFAULT_CONFIG[:protocols]["a"]["href"])
     end
 
     def test_exports_default_anchor_schemes
-      assert_equal(["http", "https", "mailto", "xmpp", :relative, "irc", "ircs"], SanitizationFilter::PROTOCOLS)
+      assert_equal(["http", "https", "mailto", :relative], SanitizationFilter::VALID_PROTOCOLS)
     end
 
     def test_script_contents_are_removed

From d8045416f0e5a9fccee7813c21cb62a86d58dceb Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Mon, 26 Dec 2022 10:47:38 -0800
Subject: [PATCH 42/64] lint

---
 lib/html_pipeline/node_filter/syntax_highlight_filter.rb | 1 +
 lib/html_pipeline/sanitization_filter.rb                 | 8 ++++----
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/lib/html_pipeline/node_filter/syntax_highlight_filter.rb b/lib/html_pipeline/node_filter/syntax_highlight_filter.rb
index fcc2082c..2fcda21b 100644
--- a/lib/html_pipeline/node_filter/syntax_highlight_filter.rb
+++ b/lib/html_pipeline/node_filter/syntax_highlight_filter.rb
@@ -38,6 +38,7 @@ def handle_element(element)
       def handle_text_chunk(text)
         return if @lang.nil?
         return if (lexer = lexer_for(@lang)).nil?
+
         content = text.to_s
 
         text.replace(highlight_with_timeout_handling(content, lexer), as: :html)
diff --git a/lib/html_pipeline/sanitization_filter.rb b/lib/html_pipeline/sanitization_filter.rb
index 7fcc1308..d7cdb9ee 100644
--- a/lib/html_pipeline/sanitization_filter.rb
+++ b/lib/html_pipeline/sanitization_filter.rb
@@ -19,10 +19,10 @@ class SanitizationFilter
     # allowed through by default.
     DEFAULT_CONFIG = {
       elements: ["h1", "h2", "h3", "h4", "h5", "h6", "br", "b", "i", "strong", "em", "a", "pre", "code",
-                   "img", "tt", "div", "ins", "del", "sup", "sub", "p", "ol", "ul", "table", "thead", "tbody", "tfoot",
-                   "blockquote", "dl", "dt", "dd", "kbd", "q", "samp", "var", "hr", "ruby", "rt", "rp", "li", "tr", "td", "th",
-                   "s", "strike", "summary", "details", "caption", "figure", "figcaption", "abbr", "bdo", "cite",
-                   "dfn", "mark", "small", "span", "time", "wbr",],
+                 "img", "tt", "div", "ins", "del", "sup", "sub", "p", "ol", "ul", "table", "thead", "tbody", "tfoot",
+                 "blockquote", "dl", "dt", "dd", "kbd", "q", "samp", "var", "hr", "ruby", "rt", "rp", "li", "tr", "td", "th",
+                 "s", "strike", "summary", "details", "caption", "figure", "figcaption", "abbr", "bdo", "cite",
+                 "dfn", "mark", "small", "span", "time", "wbr",],
 
       attributes: {
         "a" => ["href"],

From bb7b25ced7c64e19a28c023125576691f3aa07a0 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Mon, 26 Dec 2022 21:45:25 -0800
Subject: [PATCH 43/64] Remove outdated elements/attrs

Closes https://github.com/gjtorikian/html-pipeline/issues/342
Closes https://github.com/gjtorikian/html-pipeline/issues/303
---
 lib/html_pipeline/sanitization_filter.rb | 10 ++++-----
 test/sanitization_filter_test.rb         | 27 ++++++++++++++++++++++++
 2 files changed, 32 insertions(+), 5 deletions(-)

diff --git a/lib/html_pipeline/sanitization_filter.rb b/lib/html_pipeline/sanitization_filter.rb
index d7cdb9ee..a58e1393 100644
--- a/lib/html_pipeline/sanitization_filter.rb
+++ b/lib/html_pipeline/sanitization_filter.rb
@@ -17,7 +17,7 @@ class SanitizationFilter
 
     # The main sanitization allowlist. Only these elements and attributes are
     # allowed through by default.
-    DEFAULT_CONFIG = {
+    DEFAULT_CONFIG = Selma::Sanitizer::Config.freeze_config({
       elements: ["h1", "h2", "h3", "h4", "h5", "h6", "br", "b", "i", "strong", "em", "a", "pre", "code",
                  "img", "tt", "div", "ins", "del", "sup", "sub", "p", "ol", "ul", "table", "thead", "tbody", "tfoot",
                  "blockquote", "dl", "dt", "dd", "kbd", "q", "samp", "var", "hr", "ruby", "rt", "rp", "li", "tr", "td", "th",
@@ -33,8 +33,8 @@ class SanitizationFilter
         "ins" => ["cite"],
         "q" => ["cite"],
         all: ["abbr", "accept", "accept-charset", "accesskey", "action", "align", "alt", "aria-describedby",
-              "aria-hidden", "aria-label", "aria-labelledby", "axis", "border", "cellpadding", "cellspacing", "char",
-              "charoff", "charset", "checked", "clear", "cols", "colspan", "color", "compact", "coords", "datetime", "dir",
+              "aria-hidden", "aria-label", "aria-labelledby", "axis", "border", "char",
+              "charoff", "charset", "checked", "clear", "cols", "colspan", "compact", "coords", "datetime", "dir",
               "disabled", "enctype", "for", "frame", "headers", "height", "hreflang", "hspace", "id", "ismap", "label", "lang",
               "maxlength", "media", "method", "multiple", "name", "nohref", "noshade", "nowrap", "open", "progress",
               "prompt", "readonly", "rel", "rev", "role", "rows", "rowspan", "rules", "scope", "selected", "shape",
@@ -49,9 +49,9 @@ class SanitizationFilter
         "img" => {
           "src" => ["http", "https", :relative].freeze,
           "longdesc" => ["http", "https", :relative].freeze,
-        }.freeze,
+        },
       },
-    }
+    })
 
     class << self
       def call(html, config)
diff --git a/test/sanitization_filter_test.rb b/test/sanitization_filter_test.rb
index 9f740c95..a27747eb 100644
--- a/test/sanitization_filter_test.rb
+++ b/test/sanitization_filter_test.rb
@@ -93,6 +93,33 @@ def test_custom_anchor_schemes_are_not_removed
       assert_equal(stuff, html)
     end
 
+    def test_allow_svg_elements_to_be_added
+      config = DEFAULT_CONFIG.dup
+      frag  = <<~FRAG
+      <svg height="100" width="100">
+      <circle cx="50" cy="50" r="40" stroke="black" stroke-width="3" fill="red" />
+      </svg>
+      FRAG
+
+      html = SanitizationFilter.call(frag, config)
+
+      assert_equal("\n", html)
+
+      config = { elements: ["svg", "circle"],
+      attributes: { "svg" => ["width"],
+                    "circle" => ["cx", "cy", "r"], }, }
+
+      result = <<~FRAG
+      <svg width="100">
+      <circle cx="50" cy="50" r="40" />
+      </svg>
+      FRAG
+
+      html = SanitizationFilter.call(frag, config)
+
+      assert_equal(result, html)
+    end
+
     def test_anchor_schemes_are_merged_with_other_anchor_restrictions
       stuff = '<a href="something-weird://heyyy" ping="more-weird://hiii">Wat</a> is this'
       allowlist = {

From aecaad396d4621598a938593ff20d7a14a83ef1f Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Mon, 26 Dec 2022 21:48:19 -0800
Subject: [PATCH 44/64] Add picture/source

Closes https://github.com/gjtorikian/html-pipeline/issues/352
---
 lib/html_pipeline/sanitization_filter.rb | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/lib/html_pipeline/sanitization_filter.rb b/lib/html_pipeline/sanitization_filter.rb
index a58e1393..d4a2ba78 100644
--- a/lib/html_pipeline/sanitization_filter.rb
+++ b/lib/html_pipeline/sanitization_filter.rb
@@ -19,10 +19,10 @@ class SanitizationFilter
     # allowed through by default.
     DEFAULT_CONFIG = Selma::Sanitizer::Config.freeze_config({
       elements: ["h1", "h2", "h3", "h4", "h5", "h6", "br", "b", "i", "strong", "em", "a", "pre", "code",
-                 "img", "tt", "div", "ins", "del", "sup", "sub", "p", "ol", "ul", "table", "thead", "tbody", "tfoot",
+                 "img", "tt", "div", "ins", "del", "sup", "sub", "p", "picture", "ol", "ul", "table", "thead", "tbody", "tfoot",
                  "blockquote", "dl", "dt", "dd", "kbd", "q", "samp", "var", "hr", "ruby", "rt", "rp", "li", "tr", "td", "th",
                  "s", "strike", "summary", "details", "caption", "figure", "figcaption", "abbr", "bdo", "cite",
-                 "dfn", "mark", "small", "span", "time", "wbr",],
+                 "dfn", "mark", "small", "source", "span", "time", "wbr",],
 
       attributes: {
         "a" => ["href"],
@@ -32,6 +32,7 @@ class SanitizationFilter
         "del" => ["cite"],
         "ins" => ["cite"],
         "q" => ["cite"],
+        "source" => ["srcset"],
         all: ["abbr", "accept", "accept-charset", "accesskey", "action", "align", "alt", "aria-describedby",
               "aria-hidden", "aria-label", "aria-labelledby", "axis", "border", "char",
               "charoff", "charset", "checked", "clear", "cols", "colspan", "compact", "coords", "datetime", "dir",

From 86b90c21b91d308faa724c410b2d8a16b3fda316 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Mon, 26 Dec 2022 21:52:16 -0800
Subject: [PATCH 45/64] Allow loading on `img` tags

Closes https://github.com/gjtorikian/html-pipeline/issues/359
---
 lib/html_pipeline/sanitization_filter.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/html_pipeline/sanitization_filter.rb b/lib/html_pipeline/sanitization_filter.rb
index d4a2ba78..89097343 100644
--- a/lib/html_pipeline/sanitization_filter.rb
+++ b/lib/html_pipeline/sanitization_filter.rb
@@ -26,7 +26,7 @@ class SanitizationFilter
 
       attributes: {
         "a" => ["href"],
-        "img" => ["src", "longdesc"],
+        "img" => ["src", "longdesc", "loading", "alt"],
         "div" => ["itemscope", "itemtype"],
         "blockquote" => ["cite"],
         "del" => ["cite"],

From e6322469666941c968a2d764a909f64bd3ae0805 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Mon, 26 Dec 2022 21:56:33 -0800
Subject: [PATCH 46/64] specify 3.1.0

---
 .github/workflows/lint.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 464723f2..805e817c 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -15,7 +15,7 @@ jobs:
       - uses: actions/checkout@v3
       - uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 3.0
+          ruby-version: 3.1.0
           bundler-cache: true
       - run: bundle install
       - name: Rubocop

From 7de16b565536fc33d8cc958f49e53ff0a3475605 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Mon, 26 Dec 2022 23:13:40 -0800
Subject: [PATCH 47/64] lint

---
 .github/workflows/lint.yml       |  1 +
 test/sanitization_filter_test.rb | 18 +++++++++---------
 2 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 805e817c..2a5663ae 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -16,6 +16,7 @@ jobs:
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: 3.1.0
+          rubygems: latest
           bundler-cache: true
       - run: bundle install
       - name: Rubocop
diff --git a/test/sanitization_filter_test.rb b/test/sanitization_filter_test.rb
index a27747eb..6aebc2fc 100644
--- a/test/sanitization_filter_test.rb
+++ b/test/sanitization_filter_test.rb
@@ -95,10 +95,10 @@ def test_custom_anchor_schemes_are_not_removed
 
     def test_allow_svg_elements_to_be_added
       config = DEFAULT_CONFIG.dup
-      frag  = <<~FRAG
-      <svg height="100" width="100">
-      <circle cx="50" cy="50" r="40" stroke="black" stroke-width="3" fill="red" />
-      </svg>
+      frag = <<~FRAG
+        <svg height="100" width="100">
+        <circle cx="50" cy="50" r="40" stroke="black" stroke-width="3" fill="red" />
+        </svg>
       FRAG
 
       html = SanitizationFilter.call(frag, config)
@@ -106,13 +106,13 @@ def test_allow_svg_elements_to_be_added
       assert_equal("\n", html)
 
       config = { elements: ["svg", "circle"],
-      attributes: { "svg" => ["width"],
-                    "circle" => ["cx", "cy", "r"], }, }
+                 attributes: { "svg" => ["width"],
+                               "circle" => ["cx", "cy", "r"], }, }
 
       result = <<~FRAG
-      <svg width="100">
-      <circle cx="50" cy="50" r="40" />
-      </svg>
+        <svg width="100">
+        <circle cx="50" cy="50" r="40" />
+        </svg>
       FRAG
 
       html = SanitizationFilter.call(frag, config)

From 28c8372c96ff1063ba1779ab45bc46949567adc3 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Tue, 27 Dec 2022 08:00:54 -0800
Subject: [PATCH 48/64] remove unnecessary dependencies

---
 .rubocop.yml                                        | 13 +++++++++++++
 Gemfile                                             |  4 ++--
 lib/html_pipeline/node_filter.rb                    |  2 +-
 .../node_filter/table_of_contents_filter.rb         |  2 --
 lib/html_pipeline/sanitization_filter.rb            |  2 --
 .../text_filter/plain_text_input_filter.rb          |  2 --
 .../node_filter/syntax_highlight_filter_test.rb     |  1 -
 test/test_helper.rb                                 |  2 ++
 8 files changed, 18 insertions(+), 10 deletions(-)

diff --git a/.rubocop.yml b/.rubocop.yml
index 81748ee8..ff7134f7 100644
--- a/.rubocop.yml
+++ b/.rubocop.yml
@@ -2,3 +2,16 @@ inherit_gem:
   rubocop-standard:
     - config/default.yml
     - config/minitest.yml
+
+inherit_mode:
+  merge:
+    - Exclude
+
+AllCops:
+  Exclude:
+    - test/progit/**/*
+    - "pkg/**/*"
+    - "ext/**/*"
+    - "vendor/**/*"
+    - "tmp/**/*"
+    - "test/progit/**/*"
diff --git a/Gemfile b/Gemfile
index 4e3b3cd5..25f715d5 100644
--- a/Gemfile
+++ b/Gemfile
@@ -34,10 +34,10 @@ group :test do
 
   gem "minitest-bisect", "~> 1.6"
 
+  gem "nokogiri", "~> 1.13"
+
   gem "rinku",              "~> 1.7", require: false
-  gem "sanitize",           "~> 5.2", require: false
 
-  gem "escape_utils", "~> 1.0", require: false
   gem "minitest-focus", "~> 1.1"
   gem "rouge", "~> 3.1", require: false
 end
diff --git a/lib/html_pipeline/node_filter.rb b/lib/html_pipeline/node_filter.rb
index c05e581a..fa6948e9 100644
--- a/lib/html_pipeline/node_filter.rb
+++ b/lib/html_pipeline/node_filter.rb
@@ -26,6 +26,6 @@ def call(html, context: {}, result: {})
         node_filter = new(context: context, result: result)
         Selma::Rewriter.new(sanitizer: nil, handlers: [node_filter]).rewrite(html)
       end
-  end
+    end
   end
 end
diff --git a/lib/html_pipeline/node_filter/table_of_contents_filter.rb b/lib/html_pipeline/node_filter/table_of_contents_filter.rb
index 80de8de1..3017a8ea 100644
--- a/lib/html_pipeline/node_filter/table_of_contents_filter.rb
+++ b/lib/html_pipeline/node_filter/table_of_contents_filter.rb
@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-HTMLPipeline.require_dependency("escape_utils", "TableOfContentsFilter")
-
 class HTMLPipeline
   class NodeFilter
     # Generates a Table of Contents: an array of hashes containing:
diff --git a/lib/html_pipeline/sanitization_filter.rb b/lib/html_pipeline/sanitization_filter.rb
index d7cdb9ee..2d7c9170 100644
--- a/lib/html_pipeline/sanitization_filter.rb
+++ b/lib/html_pipeline/sanitization_filter.rb
@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-HTMLPipeline.require_dependency("sanitize", "SanitizationFilter")
-
 class HTMLPipeline
   # A special filter with sanization routines and allowlists. This module defines
   # what HTML is allowed in user provided content and fixes up issues with
diff --git a/lib/html_pipeline/text_filter/plain_text_input_filter.rb b/lib/html_pipeline/text_filter/plain_text_input_filter.rb
index ef72acd9..fc5fcdd3 100644
--- a/lib/html_pipeline/text_filter/plain_text_input_filter.rb
+++ b/lib/html_pipeline/text_filter/plain_text_input_filter.rb
@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-HTMLPipeline.require_dependency("escape_utils", "PlainTextInputFilter")
-
 class HTMLPipeline
   class TextFilter
     # Simple filter for plain text input. HTML escapes the text input and wraps it
diff --git a/test/html_pipeline/node_filter/syntax_highlight_filter_test.rb b/test/html_pipeline/node_filter/syntax_highlight_filter_test.rb
index 92d3863d..a2b47e0b 100644
--- a/test/html_pipeline/node_filter/syntax_highlight_filter_test.rb
+++ b/test/html_pipeline/node_filter/syntax_highlight_filter_test.rb
@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "test_helper"
-require "escape_utils"
 
 SyntaxHighlightFilter = HTMLPipeline::NodeFilter::SyntaxHighlightFilter
 
diff --git a/test/test_helper.rb b/test/test_helper.rb
index 6c7bcd49..6e70b91a 100644
--- a/test/test_helper.rb
+++ b/test/test_helper.rb
@@ -9,6 +9,8 @@
 
 require "awesome_print"
 
+require "nokogiri"
+
 module TestHelpers
 end
 

From 993af12c6c182ba430f5bb88279934ef2a5c22df Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Tue, 27 Dec 2022 08:02:07 -0800
Subject: [PATCH 49/64] :gem: bump to 3.0.0.pre1

---
 lib/html_pipeline/version.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/html_pipeline/version.rb b/lib/html_pipeline/version.rb
index f727e736..fbe6f8a8 100644
--- a/lib/html_pipeline/version.rb
+++ b/lib/html_pipeline/version.rb
@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class HTMLPipeline
-  VERSION = "2.13.2"
+  VERSION = "3.0.0.pre1"
 end

From dc6a05b96f72ef48ecb1d973ff9335987792b287 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Wed, 28 Dec 2022 14:36:19 -0800
Subject: [PATCH 50/64] Add Commonmarker syntax highlighting directly

---
 Gemfile                                       |  2 +-
 .../convert_filter/markdown_filter.rb         |  3 +-
 .../node_filter/syntax_highlight_filter.rb    | 62 -------------------
 .../convert_filter/markdown_filter_test.rb    |  2 +-
 .../syntax_highlight_filter_test.rb           | 61 ------------------
 test/html_pipeline_test.rb                    |  2 +-
 test/sanitization_filter_test.rb              | 14 ++---
 7 files changed, 12 insertions(+), 134 deletions(-)
 delete mode 100644 lib/html_pipeline/node_filter/syntax_highlight_filter.rb
 delete mode 100644 test/html_pipeline/node_filter/syntax_highlight_filter_test.rb

diff --git a/Gemfile b/Gemfile
index 25f715d5..3aa87403 100644
--- a/Gemfile
+++ b/Gemfile
@@ -27,7 +27,7 @@ group :development do
 end
 
 group :test do
-  gem "commonmarker", "~> 1.0.0.pre3", require: false
+  gem "commonmarker", "~> 1.0.0.pre4", require: false
   gem "gemoji", "~> 3.0", require: false
   gem "gemojione", "~> 4.3", require: false
   gem "minitest"
diff --git a/lib/html_pipeline/convert_filter/markdown_filter.rb b/lib/html_pipeline/convert_filter/markdown_filter.rb
index 3c8bd249..ee172285 100644
--- a/lib/html_pipeline/convert_filter/markdown_filter.rb
+++ b/lib/html_pipeline/convert_filter/markdown_filter.rb
@@ -18,7 +18,8 @@ def initialize(context: {}, result: {})
       # Convert Commonmark to HTML using the best available implementation.
       def call(text)
         options = @context.fetch(:markdown, {})
-        Commonmarker.to_html(text, options: options).rstrip!
+        plugins = options.fetch(:plugins, {})
+        Commonmarker.to_html(text, options: options, plugins: plugins).rstrip!
       end
     end
   end
diff --git a/lib/html_pipeline/node_filter/syntax_highlight_filter.rb b/lib/html_pipeline/node_filter/syntax_highlight_filter.rb
deleted file mode 100644
index 2fcda21b..00000000
--- a/lib/html_pipeline/node_filter/syntax_highlight_filter.rb
+++ /dev/null
@@ -1,62 +0,0 @@
-# frozen_string_literal: true
-
-HTMLPipeline.require_dependency("rouge", "SyntaxHighlightFilter")
-
-class HTMLPipeline
-  class NodeFilter
-    # HTML Filter that syntax highlights text inside code blocks.
-    #
-    # Context options:
-    #
-    #   :highlight => String represents the language to pick lexer. Defaults to empty string.
-    #   :scope => String represents the class attribute adds to pre element after.
-    #             Defaults to "highlight highlight-css" if highlights a css code block.
-    #
-    # This filter does not write any additional information to the context hash.
-    class SyntaxHighlightFilter < NodeFilter
-      def initialize(context: {}, result: {})
-        super(context: context, result: result)
-        # TODO: test the optionality of this
-        @formatter = context[:formatter] || Rouge::Formatters::HTML.new
-      end
-
-      SELECTOR = Selma::Selector.new(match_element: "pre", match_text_within: "pre")
-
-      def selector
-        SELECTOR
-      end
-
-      def handle_element(element)
-        default = context[:highlight]&.to_s
-        @lang = element["lang"] || default
-
-        scope = context.fetch(:scope, "highlight")
-
-        element["class"] = "#{scope} #{scope}-#{@lang}" if include_lang?
-      end
-
-      def handle_text_chunk(text)
-        return if @lang.nil?
-        return if (lexer = lexer_for(@lang)).nil?
-
-        content = text.to_s
-
-        text.replace(highlight_with_timeout_handling(content, lexer), as: :html)
-      end
-
-      def highlight_with_timeout_handling(text, lexer)
-        Rouge.highlight(text, lexer, @formatter)
-      rescue Timeout::Error => _e
-        text
-      end
-
-      def lexer_for(lang)
-        Rouge::Lexer.find(lang)
-      end
-
-      def include_lang?
-        !@lang.nil? && !@lang.empty?
-      end
-    end
-  end
-end
diff --git a/test/html_pipeline/convert_filter/markdown_filter_test.rb b/test/html_pipeline/convert_filter/markdown_filter_test.rb
index 6722eb6e..e656e080 100644
--- a/test/html_pipeline/convert_filter/markdown_filter_test.rb
+++ b/test/html_pipeline/convert_filter/markdown_filter_test.rb
@@ -87,7 +87,7 @@ def test_without_tagfilter
 class GFMTest < Minitest::Test
   def setup
     @gfm = MarkdownFilter
-    @context = { markdown: { render: { unsafe_: true } } }
+    @context = { markdown: { render: { unsafe_: true }, plugins: { syntax_highlighter: nil } } }
   end
 
   def test_not_touch_single_underscores_inside_words
diff --git a/test/html_pipeline/node_filter/syntax_highlight_filter_test.rb b/test/html_pipeline/node_filter/syntax_highlight_filter_test.rb
deleted file mode 100644
index a2b47e0b..00000000
--- a/test/html_pipeline/node_filter/syntax_highlight_filter_test.rb
+++ /dev/null
@@ -1,61 +0,0 @@
-# frozen_string_literal: true
-
-require "test_helper"
-
-SyntaxHighlightFilter = HTMLPipeline::NodeFilter::SyntaxHighlightFilter
-
-class HTMLPipeline
-  class SyntaxHighlightFilterTest < Minitest::Test
-    def test_highlight_default
-      result = SyntaxHighlightFilter.call(\
-        "<pre>hello</pre>", context: { highlight: "coffeescript" }
-      )
-
-      doc = Nokogiri.parse(result)
-
-      refute_empty(doc.css(".highlight"))
-      refute_empty(doc.css(".highlight-coffeescript"))
-    end
-
-    def test_highlight_default_will_not_override
-      result = SyntaxHighlightFilter.call(\
-        "<pre lang='c'>hello</pre>",  context: { highlight: "coffeescript" }
-      )
-
-      doc = Nokogiri.parse(result)
-
-      assert_empty(doc.css(".highlight-coffeescript"))
-      refute_empty(doc.css(".highlight-c"))
-    end
-
-    def test_highlight_does_not_remove_pre_tag
-      result = SyntaxHighlightFilter.call(\
-        "<pre lang='c'>hello</pre>",  context: { highlight: "coffeescript" }
-      )
-
-      doc = Nokogiri.parse(result)
-
-      refute_empty(doc.css("pre"))
-    end
-
-    def test_highlight_allows_optional_scope
-      result = SyntaxHighlightFilter.call(\
-        "<pre lang='c'>hello</pre>",  context: { highlight: "coffeescript", scope: "test-scope" }
-      )
-
-      doc = Nokogiri.parse(result)
-
-      refute_empty(doc.css("pre.test-scope"))
-    end
-
-    def test_highlight_keeps_the_pre_tags_lang
-      result = SyntaxHighlightFilter.call(\
-        "<pre lang='c'>hello</pre>",  context: { highlight: "coffeescript" }
-      )
-
-      doc = Nokogiri.parse(result)
-
-      refute_empty(doc.css("pre[lang=c]"))
-    end
-  end
-end
diff --git a/test/html_pipeline_test.rb b/test/html_pipeline_test.rb
index dd79d2a8..befe4cad 100644
--- a/test/html_pipeline_test.rb
+++ b/test/html_pipeline_test.rb
@@ -80,7 +80,7 @@ def test_setup_instrumentation
 
   def test_incorrect_text_filters
     assert_raises(HTMLPipeline::InvalidFilterError) do
-      HTMLPipeline.new(text_filters: [HTMLPipeline::NodeFilter::SyntaxHighlightFilter], default_context: @default_context)
+      HTMLPipeline.new(text_filters: [HTMLPipeline::NodeFilter::MentionFilter], default_context: @default_context)
     end
   end
 
diff --git a/test/sanitization_filter_test.rb b/test/sanitization_filter_test.rb
index 9f740c95..1bbf1928 100644
--- a/test/sanitization_filter_test.rb
+++ b/test/sanitization_filter_test.rb
@@ -189,18 +189,18 @@ def test_sanitization_pipeline_can_be_configured
           HTMLPipeline::ConvertFilter::MarkdownFilter.new,
         sanitization_config: config,
         node_filters: [
-          HTMLPipeline::NodeFilter::SyntaxHighlightFilter.new,
+          HTMLPipeline::NodeFilter::MentionFilter.new,
         ],
       )
 
       result = pipeline.call(<<~CODE)
-        This is *great*:
+        This is *great*, @balevine:
 
             some_code(:first)
       CODE
 
       expected = <<~HTML
-        <p>This is great:</p>
+        <p>This is great, <a href="/balevine" class="user-mention">@balevine</a>:</p>
         <pre><code>some_code(:first)
         </code></pre>
       HTML
@@ -210,21 +210,21 @@ def test_sanitization_pipeline_can_be_configured
 
     def test_sanitization_pipeline_can_be_removed
       pipeline = HTMLPipeline.new(\
-        convert_filter: HTMLPipeline::ConvertFilter::MarkdownFilter.new,
+        convert_filter: HTMLPipeline::ConvertFilter::MarkdownFilter.new(context: { markdown: { plugins: { syntax_highlighter: nil } } }),
         sanitization_config: nil,
         node_filters: [
-          HTMLPipeline::NodeFilter::SyntaxHighlightFilter.new,
+          HTMLPipeline::NodeFilter::MentionFilter.new,
         ],
       )
 
       result = pipeline.call(<<~CODE)
-        This is *great*:
+        This is *great*, @balevine:
 
             some_code(:first)
       CODE
 
       expected = <<~HTML
-        <p>This is <em>great</em>:</p>
+        <p>This is <em>great</em>, <a href="/balevine" class="user-mention">@balevine</a>:</p>
         <pre><code>some_code(:first)
         </code></pre>
       HTML

From add33b7be53ae901313ef426ac2b6b4d7083af21 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Wed, 28 Dec 2022 18:09:50 -0600
Subject: [PATCH 51/64] remove unneeded code

---
 CONTRIBUTING.md                               | 60 ------------------
 Gemfile                                       |  3 -
 lib/html_pipeline/body_content.rb             | 32 ----------
 .../text_filter/autolink_filter.rb            | 34 -----------
 .../text_filter/autolink_filter_test.rb       | 61 -------------------
 5 files changed, 190 deletions(-)
 delete mode 100644 CONTRIBUTING.md
 delete mode 100644 lib/html_pipeline/body_content.rb
 delete mode 100644 lib/html_pipeline/text_filter/autolink_filter.rb
 delete mode 100644 test/html_pipeline/text_filter/autolink_filter_test.rb

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
deleted file mode 100644
index fb3a8e60..00000000
--- a/CONTRIBUTING.md
+++ /dev/null
@@ -1,60 +0,0 @@
-# Contributing
-
-Thanks for using and improving `HTMLPipeline`!
-
-- [Submitting a New Issue](#submitting-a-new-issue)
-- [Sending a Pull Request](#sending-a-pull-request)
-
-## Submitting a New Issue
-
-If there's an idea you'd like to propose, or a design change, feel free to file a new issue.
-
-If you have an implementation question or believe you've found a bug, please provide as many details as possible:
-
-- Input document
-- Output HTML document
-- the exact `HTMLPipeline` code you are using
-- output of the following from your project
-
-```
-ruby -v
-bundle exec nokogiri -v
-```
-
-## Sending a Pull Request
-
-[Pull requests][pr] are always welcome!
-
-Check out [the project's issues list][issues] for ideas on what could be improved.
-
-Before sending, please add tests and ensure the test suite passes.
-
-### Running the Tests
-
-To run the full suite:
-
-  `bundle exec rake`
-
-To run a specific test file:
-
-  `bundle exec ruby -Itest test/html/pipeline_test.rb`
-
-To run a specific test:
-
-  `bundle exec ruby -Itest test/html/pipeline/markdown_filter_test.rb -n test_disabling_gfm`
-
-To run the full suite with all [supported rubies][travisyaml] in bash:
-
-```bash
-rubies=(ree-1.8.7-2011.03 1.9.2-p290 1.9.3-p429 2.0.0-p247)
-for r in ${rubies[*]}
-do
-  rbenv local $r # switch to your version manager of choice
-  bundle install
-  bundle exec rake
-done
-```
-
-[issues]: https://github.com/jch/html-pipeline/issues
-[pr]: https://help.github.com/articles/using-pull-requests
-[travisyaml]: https://github.com/jch/html-pipeline/blob/master/.travis.yml
diff --git a/Gemfile b/Gemfile
index 3aa87403..e18f5638 100644
--- a/Gemfile
+++ b/Gemfile
@@ -36,8 +36,5 @@ group :test do
 
   gem "nokogiri", "~> 1.13"
 
-  gem "rinku",              "~> 1.7", require: false
-
   gem "minitest-focus", "~> 1.1"
-  gem "rouge", "~> 3.1", require: false
 end
diff --git a/lib/html_pipeline/body_content.rb b/lib/html_pipeline/body_content.rb
deleted file mode 100644
index 866bf484..00000000
--- a/lib/html_pipeline/body_content.rb
+++ /dev/null
@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-class HTMLPipeline
-  # Public: Runs a String of content through an HTML processing pipeline.
-  class BodyContent
-    # Public: Initialize a BodyContent.
-    #
-    # body     - A String body.
-    # context  - A Hash of context options for the filters.
-    # pipeline - A HTMLPipeline object with one or more Filters.
-    def initialize(body, context, pipeline)
-      @body = body
-      @context = context
-      @pipeline = pipeline
-    end
-
-    # Public: Gets the memoized result of the body content as it passed through
-    # the Pipeline.
-    #
-    # Returns a Hash, or something similar as defined by @pipeline.result_class.
-    def result
-      @result ||= @pipeline.call(@body, @context)
-    end
-
-    # Public: Gets the updated body from the Pipeline result.
-    #
-    # Returns a String.
-    def output
-      @output ||= result[:output]
-    end
-  end
-end
diff --git a/lib/html_pipeline/text_filter/autolink_filter.rb b/lib/html_pipeline/text_filter/autolink_filter.rb
deleted file mode 100644
index 655ff40b..00000000
--- a/lib/html_pipeline/text_filter/autolink_filter.rb
+++ /dev/null
@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-HTMLPipeline.require_dependency("rinku", "AutolinkFilter")
-
-class HTMLPipeline
-  class TextFilter
-    # Text Filter for auto_linking urls in HTML.
-    #
-    # Context options:
-    #   :autolink  - boolean whether to autolink urls
-    #   :link_mode - :all, :urls or :email_addresses
-    #   :link_attr - HTML attributes for the link that will be generated
-    #   :skip_tags - HTML tags inside which autolinking will be skipped.
-    #                See Rinku.skip_tags
-    #   :flags     - additional Rinku flags. See https://github.com/vmg/rinku
-    #
-    # This filter does not write additional information to the context.
-    class AutolinkFilter < TextFilter
-      def call
-        return text if context[:autolink] == false
-
-        skip_tags = context[:skip_tags]
-        flags = 0
-        flags |= context[:flags] if context[:flags]
-
-        Rinku.auto_link(text, link_mode, context[:link_attr], skip_tags, flags)
-      end
-
-      def link_mode
-        context[:link_mode] || :urls
-      end
-    end
-  end
-end
diff --git a/test/html_pipeline/text_filter/autolink_filter_test.rb b/test/html_pipeline/text_filter/autolink_filter_test.rb
deleted file mode 100644
index 65c45d01..00000000
--- a/test/html_pipeline/text_filter/autolink_filter_test.rb
+++ /dev/null
@@ -1,61 +0,0 @@
-# frozen_string_literal: true
-
-require "test_helper"
-
-AutolinkFilter = HTMLPipeline::TextFilter::AutolinkFilter
-
-class HTMLPipeline
-  class TextFilter
-    class AutolinkFilterTest < Minitest::Test
-      def test_uses_rinku_for_autolinking
-        # just try to parse a complicated piece of HTML
-        # that Rails auto_link cannot handle
-        assert_equal('<p>"<a href="http://www.github.com">http://www.github.com</a>"</p>',
-          AutolinkFilter.call('<p>"http://www.github.com"</p>'))
-      end
-
-      def test_autolink_option
-        assert_equal('<p>"http://www.github.com"</p>',
-          AutolinkFilter.call('<p>"http://www.github.com"</p>', context: { autolink: false }))
-      end
-
-      def test_autolink_link_attr
-        assert_equal('<p>"<a href="http://www.github.com" target="_blank">http://www.github.com</a>"</p>',
-          AutolinkFilter.call('<p>"http://www.github.com"</p>', context: { link_attr: 'target="_blank"' }))
-      end
-
-      def test_autolink_flags
-        assert_equal('<p>"<a href="http://github">http://github</a>"</p>',
-          AutolinkFilter.call('<p>"http://github"</p>', context: { flags: Rinku::AUTOLINK_SHORT_DOMAINS }))
-      end
-
-      def test_autolink_skip_tags
-        assert_equal('<code>"http://github.com"</code>',
-          AutolinkFilter.call('<code>"http://github.com"</code>'))
-
-        assert_equal('<code>"<a href="http://github.com">http://github.com</a>"</code>',
-          AutolinkFilter.call('<code>"http://github.com"</code>', context: { skip_tags: ["kbd", "script"] }))
-      end
-
-      def test_link_mode_default
-        assert_equal('<p>"<a href="http://www.github.com">http://www.github.com</a>"</p><p>"user@example.com"</p>',
-          AutolinkFilter.call('<p>"http://www.github.com"</p><p>"user@example.com"</p>'))
-      end
-
-      def test_link_mode_urls
-        assert_equal('<p>"<a href="http://www.github.com">http://www.github.com</a>"</p><p>"user@example.com"</p>',
-          AutolinkFilter.call('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :urls }))
-      end
-
-      def test_link_mode_all
-        assert_equal('<p>"<a href="http://www.github.com">http://www.github.com</a>"</p><p>"<a href="mailto:user@example.com">user@example.com</a>"</p>',
-          AutolinkFilter.call('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :all }))
-      end
-
-      def test_link_mode_email_addresses
-        assert_equal('<p>"http://www.github.com"</p><p>"<a href="mailto:user@example.com">user@example.com</a>"</p>',
-          AutolinkFilter.call('<p>"http://www.github.com"</p><p>"user@example.com"</p>', context: { link_mode: :email_addresses }))
-      end
-    end
-  end
-end

From cadafbc9c729901f7c2ea3d90a0f2bb9ab5b1962 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Wed, 28 Dec 2022 18:09:59 -0600
Subject: [PATCH 52/64] Add README

---
 LICENSE.txt |   2 +-
 README.md   | 363 ++++++++++++++++++++--------------------------------
 2 files changed, 141 insertions(+), 224 deletions(-)

diff --git a/LICENSE.txt b/LICENSE.txt
index 7c5020a1..574b42c1 100644
--- a/LICENSE.txt
+++ b/LICENSE.txt
@@ -1,4 +1,4 @@
-Copyright (c) 2022 Garen Torikian
+Copyright (c) 2023 Garen Torikian
 
 MIT License
 
diff --git a/README.md b/README.md
index cdf62712..a928924c 100644
--- a/README.md
+++ b/README.md
@@ -1,24 +1,20 @@
 # HTMLPipeline
 
-HTML processing filters and utilities. This module includes a small
-framework for defining DOM based content filters and applying them to user
+HTML processing filters and utilities. This module is a small
+framework for defining CSS-based content filters and applying them to user
 provided content.
 
-[This project was started at GitHub](https://github.com/blog/1311-html-pipeline-chainable-content-filters). While GitHub still uses a similar design and pattern for rendering content, this gem should be considered standalone and independent from GitHub.
+[Although this project was started at GitHub](https://github.com/blog/1311-html-pipeline-chainable-content-filters), they no longer do. This gem must be considered standalone and independent from GitHub.
 
 - [Installation](#installation)
 - [Usage](#usage)
-  - [Examples](#examples)
+  - [More Examples](#more-examples)
 - [Filters](#filters)
-- [Sanitization](#sanitization)
 - [Dependencies](#dependencies)
 - [Documentation](#documentation)
-- [Extending](#extending)
-  - [Third Party Extensions](#third-party-extensions)
 - [Instrumenting](#instrumenting)
-- [Contributing](#contributing)
-  - [Contributors](#contributors)
-  - [Releasing A New Version](#releasing-a-new-version)
+- [Third Party Extensions](#third-party-extensions)
+- [FAQ](#faq)
 
 ## Installation
 
@@ -43,70 +39,68 @@ $ gem install html-pipeline
 ## Usage
 
 This library provides a handful of chainable HTML filters to transform user
-content into markup. There are two kinds of filters:
+content into HTML markup. Each filter does some work, and then hands off the
+results tothe next filter. A pipeline has several kinds of filters available to use:
 
-- Text filters, which operate a UTF-8 string
-- Node filters, which operates on a UTF-8 HTML document
+- Multiple `TextFilter`s, which operate a UTF-8 string
+- A `ConvertFilter` filter, which turns text into HTML (eg., Commonmark/Asciidoc -> HTML)
+- A `SanitizationFilter`, which remove dangerous/unwanted HTML elements and attributes
+- Multiple `NodeFilter`s, which operate on a UTF-8 HTML document
 
-You can choose to call filters individually, or as part of a sequence called a pipeline.
+You can assemble each sequence into a single pipeline, or choose to call each filter individually.
 
-For example, to transform Markdown source into Markdown HTML:
+As an example, suppose we want to transform Commonmark source text into Markdown HTML. With the content, we also want to:
 
-```ruby
-require 'html/pipeline'
-
-filter = HTMLPipeline::TextFilter::MarkdownFilter.new("Hi **world**!")
-filter.call # returns "Hi <strong>world</strong>!"
-```
+- change every instance of `$NAME` to "`Johnny"
+- strip undesired HTML
+- linkify @mention
 
-Filters combine into a pipeline, and each filter hands its
-output to the next filter's input sequentially. Text filters are
-processed first—the last text filter should generate HTML—before handing
-off to the node filters.
-
-If you wanted to have text content
-filtered through Markdown and the resulting HTML syntax highlighted, you can create the
-following pipeline:
+We can construct a pipeline to do all that like this:
 
 ```ruby
-pipeline = HTMLPipeline.new \
-  text_filters: [
-    HTMLPipeline::TextFilter::MarkdownFilter,
-  ],
-  node_filters: [
-    HTMLPipeline::NodeFilter::SyntaxHighlightFilter
-  ]
-result = pipeline.call <<-CODE
-This is *great*:
+require 'html_pipeline'
 
-    some_code(:first)
+class HelloJohnnyFilter < HTMLPipelineFilter
+  def call
+    text.gsub("$NAME", "Johnny")
+  end
+end
 
-CODE
-result[:output].to_s
+pipeline = HTMLPipeline.new(
+  text_filters: [HelloJohnnyFilter.new]
+  convert_filter: HTMLPipeline::ConvertFilter::MarkdownFilter.new),
+    # note: next line is not needed as sanitization occurs by default;
+    # see below for more info
+  sanitization_config: HTMLPipeline::SanitizationFilter::DEFAULT_CONFIG,
+  node_filters: [HTMLPipeline::NodeFilter::MentionFilter.new]
+)
+pipeline.call(user_supplied_text) # recommended: can call pipeline over and over
 ```
 
-Prints:
-
-```html
-<p>This is <em>great</em>:</p>
+Filters can be custom ones you create (like `HelloJohnnyFilter`), and `HTMLPipeline` additionally provides several helpful ones (detailed below). If you only need a single filter, you can call one individually, too:
 
-<pre><code>some_code(:first)
-</code></pre>
+```ruby
+filter = HTMLPipeline::ConvertFilter::MarkdownFilter.new(text)
+filter.call
 ```
 
-To generate CSS for HTML formatted code, use the [Rouge CSS Theme](https://github.com/rouge-ruby/rouge#css-options) `#css` method. `rouge` is a dependency of the `SyntaxHighlightFilter`.
+Filters combine into a sequential pipeline, and each filter hands its
+output to the next filter's input. Text filters are
+processed first, then the convert filter, sanitization filter, and finally, the node filters.
 
-Some filters take an optional **context** and/or **result** hash. These are
+Some filters take optional `context` and/or `result` hash(es). These are
 used to pass around arguments and metadata between filters in a pipeline. For
-example, if you don't want to use GitHub Formatted Markdown, you can pass an
-option in the context hash:
+example, if you want to disable footnotes in the `MarkdownFilter`, you can pass an option in the context hash:
 
 ```ruby
-filter = HTMLPipeline::TextFilter::MarkdownFilter.new("Hi **world**!", gfm: false)
+context =  { markdown: extensions: { footnotes: false } }
+filter = HTMLPipeline::ConvertFilter::MarkdownFilter.new("Hi **world**!", context: context)
 filter.call
 ```
 
-### Examples
+Please refer to the documentation for each filter to understand what configuration options are available.
+
+### More Examples
 
 Different pipelines can be defined for different parts of an app. Here are a few
 paraphrased snippets to get you started:
@@ -119,78 +113,45 @@ context = {
   base_url: "http://your-domain.com"
 }
 
-# Pipeline providing sanitization and image hijacking but no mention
-# related features.
-SimplePipeline = Pipeline.new [
-  SanitizationFilter,
-  TableOfContentsFilter, # add 'name' anchors to all headers and generate toc list
-  ImageMaxWidthFilter,
-  SyntaxHighlightFilter,
-  EmojiFilter,
-  AutolinkFilter
-], context
-
 # Pipeline used for user provided content on the web
-MarkdownPipeline = Pipeline.new [
-  MarkdownFilter,
-  SanitizationFilter,
-  ImageMaxWidthFilter,
-  HttpsFilter,
-  MentionFilter,
-  EmojiFilter,
-  SyntaxHighlightFilter
-], context.merge(gfm: true) # enable github formatted markdown
-
-
-# Define a pipeline based on another pipeline's filters
-NonGFMMarkdownPipeline = Pipeline.new(MarkdownPipeline.filters,
-  context.merge(gfm: false))
+MarkdownPipeline = HTMLPipeline.new (
+  text_filters: [HTMLPipeline::TextFilter::ImageMaxWidthFilter.new],
+  convert_filter: [HTMLPipeline::ConvertFilter::MarkdownFilter.new],
+  node_filters: [
+    HTMLPipeline::NodeFilter::HttpsFilter.new,HTMLPipeline::NodeFilter::MentionFilter.new,
+  ], context: context)
 
 # Pipelines aren't limited to the web. You can use them for email
 # processing also.
-HtmlEmailPipeline = Pipeline.new [
-  PlainTextInputFilter,
-  ImageMaxWidthFilter
-], {}
-
-# Just emoji.
-EmojiPipeline = Pipeline.new [
-  PlainTextInputFilter,
-  EmojiFilter
-], context
+HtmlEmailPipeline = HTMLPipeline.new(
+  text_filters: [
+    PlainTextInputFilter.new,
+    ImageMaxWidthFilter.new
+  ], {})
 ```
 
 ## Filters
 
 ### TextFilters
 
-- `AutolinkFilter` - auto_linking urls in HTML
+`TextFilter`s must define a method named `call` which is called on the text. `@text`, `@config`, and `@result` are available to use, and any changes made to these ivars are passed on to the next filter.
+
 - `ImageFilter` - converts image `url` into `<img>` tag
-- `MarkdownFilter` - convert markdown to html
 - `PlainTextInputFilter` - html escape text and wrap the result in a `<div>`
 
-### NodeFilters
+### ConvertFilter
 
-- `AbsoluteSourceFilter` - replace relative image urls with fully qualified versions
-- `EmojiFilter` - converts `:<emoji>:` to [emoji](http://www.emoji-cheat-sheet.com/)!
-- `HttpsFilter` - Replacing http urls with https versions
-- `ImageMaxWidthFilter` - link to full size image for large images
-- `MentionFilter` - replace `@user` mentions with links
-- `SanitizationFilter` - allow sanitize user markup
-- `SyntaxHighlightFilter` - code syntax highlighter
-- `TableOfContentsFilter` - anchor headings with name attributes and generate Table of Contents html unordered list linking headings
-- `TeamMentionFilter` - replace `@org/team` mentions with links
+The `ConvertFilter` takes text and turns it into HTML. `@text`, `@config`, and `@result` are available to use. `ConvertFilter` must defined a method named `call`, taking one argument, `text`. `call` must return a string representing the new HTML document.
+
+- `MarkdownFilter` - creates HTML from text using [Commonmarker](https://www.github.com/gjtorikian/commonmarker)
 
-## Sanitization
+### Sanitization
 
-Because the web is a scary place, HTML is automatically sanitized after the text filters
-are processed and before the node filters are processed. This is to prevent malicious or
-unexpected input from entering the pipeline.
+Because the web can be a scary place, HTML is automatically sanitized after the `ConvertFilter` runs and before the `NodeFilter`s are processed. This is to prevent malicious or unexpected input from entering the pipeline.
 
-The sanitization process takes a hash configuration of settings. See the [selma]
-documentation for more information.
+The sanitization process takes a hash configuration of settings. See the [Selma](https://www.github.com/gjtorikian/selma) documentation for more information on how to configure these settings.
 
-A sample custom sanitization allowlist might look like this:
+A default sanitization config is provided by this library (`HTMLPipeline::SanitizationFilter::DEFAULT_CONFIG`). A sample custom sanitization allowlist might look like this:
 
 ```ruby
 ALLOWLIST = {
@@ -201,10 +162,9 @@ pipeline = HTMLPipeline.new \
   text_filters: [
     HTMLPipeline::MarkdownFilter,
   ],
-  sanitization_config: ALLOWLIST,
-  node_filters: [
-    HTMLPipeline::SyntaxHighlightFilter
-  ]
+  convert_filter: [HTMLPipeline::ConvertFilter::MarkdownFilter.new],
+  sanitization_config: ALLOWLIST
+
 result = pipeline.call <<-CODE
 This is *great*:
 
@@ -230,97 +190,58 @@ pipeline = HTMLPipeline.new \
   text_filters: [
     HTMLPipeline::MarkdownFilter,
   ],
-  sanitization_config: nil, # disable sanitization
-  node_filters: [
-    HTMLPipeline::SyntaxHighlightFilter
-  ]
+  convert_filter: [HTMLPipeline::ConvertFilter::MarkdownFilter.new],
+  sanitization_config: nil
 ```
 
-## Dependencies
-
-Filter gem dependencies are not bundled; you must bundle the filter's gem
-dependencies. The below list details filters with dependencies. For example,
-`SyntaxHighlightFilter` uses [rouge](https://github.com/jneen/rouge)
-to detect and highlight languages. For example, to use the `SyntaxHighlightFilter`,
-add the following to your Gemfile:
-
-```ruby
-gem 'rouge'
-```
-
-- `AutolinkFilter` - `rinku`
-- `EmojiFilter` - `gemoji`
-- `MarkdownFilter` - `commonmarker`
-- `PlainTextInputFilter` - `escape_utils`
-- `SanitizationFilter` - `sanitize`
-- `SyntaxHighlightFilter` - `rouge`
-- `TableOfContentsFilter` - `escape_utils`
-
-_Note:_ See the [Gemfile](/Gemfile) `:test` group for version requirements.
-
-## Documentation
-
-Full reference documentation can be [found here](http://rubydoc.info/gems/html-pipeline/frames).
-
-## Extending
+### NodeFilters
 
-To write a custom filter, you need a class with a `call` method that inherits
-from either `HTMLPipeline::TextFilter` or `HTMLPipeline::NodeFilter`.
+`NodeFilters`s can operate either on HTML elements or text nodes using CSS selectors. Each `NodeFilter` must define a method named `selector` which provides an instance of `Selma::Selector`. If elements are being manipulated, `handle_element` must be defined, taking one argument, `element`; if text nodes are being manipulated, `handle_text_chunk` must be defined, taking one argument, `text_chunk`. `@config`, and `@result` are available to use, and any changes made to these ivars are passed on to the next filter.
 
-For example this filter adds a base url to images that are root relative:
+Here's an example `NodeFilter` that adds a base url to images that are root relative:
 
 ```ruby
 require 'uri'
 
 class RootRelativeFilter < HTMLPipeline::NodeFilter
 
-  def call
-    doc.search("img").each do |img|
-      next if img['src'].nil?
-      src = img['src'].strip
-      if src.start_with? '/'
-        img["src"] = URI.join(context[:base_url], src).to_s
-      end
-    end
-    doc
+  SELECTOR = Selma::Selector.new(match_element: "img")
+
+  def selector
+    SELECTOR
   end
 
+  def handle_element(img)
+    next if img['src'].nil?
+    src = img['src'].strip
+    if src.start_with? '/'
+      img["src"] = URI.join(context[:base_url], src).to_s
+    end
+  end
 end
 ```
 
-Now this filter can be used in a pipeline:
+For more information on how to write effective `NodeFilter`s, refer to the provided filters, and see the underlying lib, [Selma](https://www.github.com/gjtorikian/selma) for more information.
 
-```ruby
-Pipeline.new node_filters: [ RootRelativeFilter ], { :base_url => 'http://somehost.com' }
-```
+- `AbsoluteSourceFilter` - replace relative image urls with fully qualified versions
+- `EmojiFilter` - converts `:<emoji>:` to [emoji](http://www.emoji-cheat-sheet.com/)!
+- `HttpsFilter` - Replacing http urls with https versions
+- `ImageMaxWidthFilter` - link to full size image for large images
+- `MentionFilter` - replace `@user` mentions with links
+- `SanitizationFilter` - allow sanitize user markup
+- `TableOfContentsFilter` - anchor headings with name attributes and generate Table of Contents html unordered list linking headings
+- `TeamMentionFilter` - replace `@org/team` mentions with links
 
-### Third Party Extensions
+## Dependencies
 
-If you have an idea for a filter, propose it as
-[an issue](https://github.com/gjtorikian/html-pipeline/issues) first. This allows us discuss
-whether the filter is a common enough use case to belong in this gem, or should be
-built as an external gem.
+Since filters can be customized to your heart's content, gem dependencies are _not_ bundled; this project doesn't know which of the default filters you might use, and as such, you must bundle each filter's gem
+dependencies yourself.
 
-Here are some extensions people have built:
+_Note:_ See the [Gemfile](/Gemfile) `:test` group for any version requirements.
 
-- [html-pipeline-asciidoc_filter](https://github.com/asciidoctor/html-pipeline-asciidoc_filter)
-- [jekyll-html-pipeline](https://github.com/gjtorikian/jekyll-html-pipeline)
-- [nanoc-html-pipeline](https://github.com/burnto/nanoc-html-pipeline)
-- [html-pipeline-bitly](https://github.com/dewski/html-pipeline-bitly)
-- [html-pipeline-cite](https://github.com/lifted-studios/html-pipeline-cite)
-- [tilt-html-pipeline](https://github.com/bradgessler/tilt-html-pipeline)
-- [html-pipeline-wiki-link'](https://github.com/lifted-studios/html-pipeline-wiki-link) - WikiMedia-style wiki links
-- [task_list](https://github.com/github/task_list) - GitHub flavor Markdown Task List
-- [html-pipeline-nico_link](https://github.com/rutan/html-pipeline-nico_link) - An HTMLPipeline filter for [niconico](http://www.nicovideo.jp) description links
-- [html-pipeline-gitlab](https://gitlab.com/gitlab-org/html-pipeline-gitlab) - This gem implements various filters for html-pipeline used by GitLab
-- [html-pipeline-youtube](https://github.com/st0012/html-pipeline-youtube) - An HTMLPipeline filter for YouTube links
-- [html-pipeline-flickr](https://github.com/st0012/html-pipeline-flickr) - An HTMLPipeline filter for Flickr links
-- [html-pipeline-vimeo](https://github.com/dlackty/html-pipeline-vimeo) - An HTMLPipeline filter for Vimeo links
-- [html-pipeline-hashtag](https://github.com/mr-dxdy/html-pipeline-hashtag) - An HTMLPipeline filter for hashtags
-- [html-pipeline-linkify_github](https://github.com/jollygoodcode/html-pipeline-linkify_github) - An HTMLPipeline filter to autolink GitHub urls
-- [html-pipeline-redcarpet_filter](https://github.com/bmikol/html-pipeline-redcarpet_filter) - Render Markdown source text into Markdown HTML using Redcarpet
-- [html-pipeline-typogruby_filter](https://github.com/bmikol/html-pipeline-typogruby_filter) - Add Typogruby text filters to your HTMLPipeline
-- [korgi](https://github.com/jodeci/korgi) - HTMLPipeline filters for links to Rails resources
+## Documentation
+
+Full reference documentation can be [found here](http://rubydoc.info/gems/html-pipeline/frames).
 
 ## Instrumenting
 
@@ -373,61 +294,57 @@ service.subscribe "call_text_filters.html_pipeline" do |event, start, ending, tr
 end
 ```
 
+## Third Party Extensions
+
+If you have an idea for a filter, propose it as
+[an issue](https://github.com/gjtorikian/html-pipeline/issues) first. This allows us to discuss
+whether the filter is a common enough use case to belong in this gem, or should be
+built as an external gem.
+
+Here are some extensions people have built:
+
+- [html-pipeline-asciidoc_filter](https://github.com/asciidoctor/html-pipeline-asciidoc_filter)
+- [jekyll-html-pipeline](https://github.com/gjtorikian/jekyll-html-pipeline)
+- [nanoc-html-pipeline](https://github.com/burnto/nanoc-html-pipeline)
+- [html-pipeline-bitly](https://github.com/dewski/html-pipeline-bitly)
+- [html-pipeline-cite](https://github.com/lifted-studios/html-pipeline-cite)
+- [tilt-html-pipeline](https://github.com/bradgessler/tilt-html-pipeline)
+- [html-pipeline-wiki-link'](https://github.com/lifted-studios/html-pipeline-wiki-link) - WikiMedia-style wiki links
+- [task_list](https://github.com/github/task_list) - GitHub flavor Markdown Task List
+- [html-pipeline-nico_link](https://github.com/rutan/html-pipeline-nico_link) - An HTMLPipeline filter for [niconico](http://www.nicovideo.jp) description links
+- [html-pipeline-gitlab](https://gitlab.com/gitlab-org/html-pipeline-gitlab) - This gem implements various filters for html-pipeline used by GitLab
+- [html-pipeline-youtube](https://github.com/st0012/html-pipeline-youtube) - An HTMLPipeline filter for YouTube links
+- [html-pipeline-flickr](https://github.com/st0012/html-pipeline-flickr) - An HTMLPipeline filter for Flickr links
+- [html-pipeline-vimeo](https://github.com/dlackty/html-pipeline-vimeo) - An HTMLPipeline filter for Vimeo links
+- [html-pipeline-hashtag](https://github.com/mr-dxdy/html-pipeline-hashtag) - An HTMLPipeline filter for hashtags
+- [html-pipeline-linkify_github](https://github.com/jollygoodcode/html-pipeline-linkify_github) - An HTMLPipeline filter to autolink GitHub urls
+- [html-pipeline-redcarpet_filter](https://github.com/bmikol/html-pipeline-redcarpet_filter) - Render Markdown source text into Markdown HTML using Redcarpet
+- [html-pipeline-typogruby_filter](https://github.com/bmikol/html-pipeline-typogruby_filter) - Add Typogruby text filters to your HTMLPipeline
+- [korgi](https://github.com/jodeci/korgi) - HTMLPipeline filters for links to Rails resources
+
 ## FAQ
 
 ### 1. Why doesn't my pipeline work when there's no root element in the document?
 
 To make a pipeline work on a plain text document, put the `PlainTextInputFilter`
-at the beginning of your pipeline. This will wrap the content in a `div` so the
-filters have a root element to work with. If you're passing in an HTML fragment,
+at the end of your `text_filter`s config . This will wrap the content in a `div` so the filters have a root element to work with. If you're passing in an HTML fragment,
 but it doesn't have a root element, you can wrap the content in a `div`
-yourself. For example:
-
-```ruby
-EmojiPipeline = Pipeline.new [
-  PlainTextInputFilter,  # <- Wraps input in a div and escapes html tags
-  EmojiFilter
-], context
-
-plain_text = "Gutentag! :wave:"
-EmojiPipeline.call(plain_text)
-
-html_fragment = "This is outside of an html element, but <strong>this isn't. :+1:</strong>"
-EmojiPipeline.call("<div>#{html_fragment}</div>") # <- Wrap your own html fragments to avoid escaping
-```
+yourself.
 
 ### 2. How do I customize an allowlist for `SanitizationFilter`s?
 
-`SanitizationFilter::ALLOWLIST` is the default allowlist used if no `:allowlist`
-argument is given in the context. The default is a good starting template for
+`HTMLPipeline::SanitizationFilter::ALLOWLIST` is the default allowlist used if no `sanitization_config`
+argument is given. The default is a good starting template for
 you to add additional elements. You can either modify the constant's value, or
-re-define your own constant and pass that in via the context.
+re-define your own config and pass that in, such as:
 
-## Contributing
-
-Please review the [Contributing Guide](https://github.com/gjtorikian/html-pipeline/blob/master/CONTRIBUTING.md).
-
-1. [Fork it](https://help.github.com/articles/fork-a-repo)
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Added some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new [Pull Request](https://help.github.com/articles/using-pull-requests)
-
-To see what has changed in recent versions, see the [CHANGELOG](https://github.com/gjtorikian/html-pipeline/blob/master/CHANGELOG.md).
+```ruby
+config = HTMLPipeline::SanitizerFilter::DEFAULT_CONFIG.dup
+config[:elements] << "iframe" # sure, whatever you want
+```
 
 ### Contributors
 
 Thanks to all of [these contributors](https://github.com/gjtorikian/html-pipeline/graphs/contributors).
 
 This project is a member of the [OSS Manifesto](http://ossmanifesto.org/).
-
-### Releasing A New Version
-
-This section is for gem maintainers to cut a new version of the gem.
-
-- create a new branch named `release-x.y.z` where `x.y.z` follows [semver](http://semver.org)
-- update lib/html/pipeline/version.rb to next version number X.X.X
-- update CHANGELOG.md. Prepare a draft with `script/changelog`
-- push branch and create a new pull request
-- after tests are green, merge to master
-- on the master branch, run `script/release`

From d45980a4025b31af11b80d6b66e8d022eeba9ae5 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Wed, 28 Dec 2022 18:10:05 -0600
Subject: [PATCH 53/64] Add UPGRADING.md

---
 UPGRADING.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 UPGRADING.md

diff --git a/UPGRADING.md b/UPGRADING.md
new file mode 100644
index 00000000..f2f2a5a1
--- /dev/null
+++ b/UPGRADING.md
@@ -0,0 +1,35 @@
+# Upgrade Guide
+
+## From v2 to v3
+
+HTMLPipeline v3 is a massive improvement over this still much loved (and woefully under-maintained) project. This section will attempt to list all of the breaking changes between the two versions and provide suggestions on how to upgrade.
+
+### Changed namespace
+
+This project is now under a module called `HTMLProofer`, not `HTML::Proofer`.
+
+### Removed filters
+
+The following filters were removed:
+
+- `AutolinkFilter`: this is handled by [Commonmarker](https://www.github.com/gjtorikian/commonmarker) and can be disabled/enabled through the `MarkdownFilter`'s `context` hash
+- `SyntaxHighlightFilter`: this is handled by [Commonmarker](https://www.github.com/gjtorikian/commonmarker) and can be disabled/enabled through the `MarkdownFilter`'s `context` hash
+- `SanitizationFilter`: this is handled by [Selma](https://www.github.com/gjtorikian/selma); configuration can be done through the `sanitization_config` hash
+
+- `EmailReplyFilter`
+- `CamoFilter`
+- `TextFilter`
+
+### Changed API
+
+The new way to call this project is as follows:
+
+```ruby
+HTMLPipeline.new(
+    text_filters: [], # array of instantiated (`.new`ed) `HTMLPipeline::TextFilter`
+    convert_filter:, # a filter that runs to turn text into HTML
+    sanitization_config: {}, # an allowlist of elements/attributes/protocols to keep
+    node_filters:[]) # array of instantiated (`.new`ed) `HTMLPipeline::NodeFilter`
+```
+
+Please refer to the README for more information on constructing filters. In most cases, the underlying filter needs only a few changes, primarily to make use of [Selma](https://www.github.com/gjtorikian/selma) rather than Nokogiri.

From 79efd87da746625e7d0bacce2f6f5959703ca78e Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Wed, 28 Dec 2022 18:10:44 -0600
Subject: [PATCH 54/64] eep

---
 UPGRADING.md         | 2 +-
 lib/html-pipeline.rb | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/UPGRADING.md b/UPGRADING.md
index f2f2a5a1..398c7531 100644
--- a/UPGRADING.md
+++ b/UPGRADING.md
@@ -6,7 +6,7 @@ HTMLPipeline v3 is a massive improvement over this still much loved (and woefull
 
 ### Changed namespace
 
-This project is now under a module called `HTMLProofer`, not `HTML::Proofer`.
+This project is now under a module called `HTMLPipeline`, not `HTML::Pipeline`.
 
 ### Removed filters
 
diff --git a/lib/html-pipeline.rb b/lib/html-pipeline.rb
index 75ee89e4..d72c0c65 100644
--- a/lib/html-pipeline.rb
+++ b/lib/html-pipeline.rb
@@ -1,3 +1,3 @@
 # frozen_string_literal: true
 
-require_relative "html_proofer"
+require_relative "html_pipeline"

From 959c6ad5b05fc53068ac4792047eb026d2c22601 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Wed, 28 Dec 2022 18:15:23 -0600
Subject: [PATCH 55/64] fix releases

---
 .github/workflows/tag_and_release.yml | 2 +-
 Rakefile                              | 9 ++++++---
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/tag_and_release.yml b/.github/workflows/tag_and_release.yml
index 628a5da1..a1bec14b 100644
--- a/.github/workflows/tag_and_release.yml
+++ b/.github/workflows/tag_and_release.yml
@@ -65,6 +65,6 @@ jobs:
           chmod 0600 $HOME/.gem/credentials
           printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
           bundle exec rake package
-          for gem in pkg/html_pipeline-${{ steps.version-label.outputs.version }}*.gem ; do
+          for gem in pkg/html-pipeline-${{ steps.version-label.outputs.version }}*.gem ; do
             gem push "$gem" --host https://rubygems.org
           done
diff --git a/Rakefile b/Rakefile
index fe0a93cc..a86d00c4 100755
--- a/Rakefile
+++ b/Rakefile
@@ -1,10 +1,8 @@
 #!/usr/bin/env rake
 # frozen_string_literal: true
 
-require "rubygems"
-require "bundler/setup"
-
 require "bundler/gem_tasks"
+require "rubygems/package_task"
 require "rake/testtask"
 
 Rake::TestTask.new do |t|
@@ -19,3 +17,8 @@ task default: :test
 require "rubocop/rake_task"
 
 RuboCop::RakeTask.new(:rubocop)
+
+GEMSPEC = Bundler.load_gemspec("html-pipeline.gemspec")
+gem_path = Gem::PackageTask.new(GEMSPEC).define
+desc "Package the ruby gem"
+task "package" => [gem_path]

From 3ec1f48d12999ba5a2be711aea3337e745f4cc57 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Wed, 28 Dec 2022 18:21:21 -0600
Subject: [PATCH 56/64] specify what dependencies are

---
 html-pipeline.gemspec | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/html-pipeline.gemspec b/html-pipeline.gemspec
index dbd6e278..1a7fd0ed 100644
--- a/html-pipeline.gemspec
+++ b/html-pipeline.gemspec
@@ -31,8 +31,8 @@ Gem::Specification.new do |gem|
   gem.post_install_message = <<~MSG
     -------------------------------------------------
     Thank you for installing html-pipeline!
-    You must bundle Filter gem dependencies.
-    See html-pipeline README.md for more details.
+    You must bundle filter gem dependencies.
+    See the html-pipeline README.md for more details:
     https://github.com/gjtorikian/html-pipeline#dependencies
     -------------------------------------------------
   MSG

From 8f771f5ec820688451303108eebbbd5a9b273347 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Wed, 28 Dec 2022 18:22:28 -0600
Subject: [PATCH 57/64] add "warning"

---
 README.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/README.md b/README.md
index a928924c..716feab4 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,8 @@
 # HTMLPipeline
 
+> **Note**
+> This README refers to the behavior in the new 3.0.0.pre1 gem.
+
 HTML processing filters and utilities. This module is a small
 framework for defining CSS-based content filters and applying them to user
 provided content.

From b4e80e7058e609f44a7a33b11dbbb1c0e3f3a3e4 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Thu, 29 Dec 2022 12:48:28 -0500
Subject: [PATCH 58/64] fix test

---
 test/html_pipeline_test.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/test/html_pipeline_test.rb b/test/html_pipeline_test.rb
index befe4cad..e6b2a933 100644
--- a/test/html_pipeline_test.rb
+++ b/test/html_pipeline_test.rb
@@ -86,7 +86,7 @@ def test_incorrect_text_filters
 
   def test_incorrect_convert_filter
     assert_raises(HTMLPipeline::InvalidFilterError) do
-      HTMLPipeline.new(convert_filter: HTMLPipeline::TextFilter::AutolinkFilter, default_context: @default_context)
+      HTMLPipeline.new(convert_filter: HTMLPipeline::NodeFilter::ImageMaxWidthFilter, default_context: @default_context)
     end
   end
 

From d1753cf7bd347cc01e22a8dc57f8326a663bd215 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 30 Dec 2022 09:35:52 -0500
Subject: [PATCH 59/64] add link to tests

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index 716feab4..7beb9797 100644
--- a/README.md
+++ b/README.md
@@ -197,6 +197,8 @@ pipeline = HTMLPipeline.new \
   sanitization_config: nil
 ```
 
+For more examples of customizing the sanitization process to include the tags you want, check out [the tests](test/sanitization_filter_test.rb).
+
 ### NodeFilters
 
 `NodeFilters`s can operate either on HTML elements or text nodes using CSS selectors. Each `NodeFilter` must define a method named `selector` which provides an instance of `Selma::Selector`. If elements are being manipulated, `handle_element` must be defined, taking one argument, `element`; if text nodes are being manipulated, `handle_text_chunk` must be defined, taking one argument, `text_chunk`. `@config`, and `@result` are available to use, and any changes made to these ivars are passed on to the next filter.

From 6e3920d68a70097b4d9f3dd92f03b417a1fe419d Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 30 Dec 2022 09:39:22 -0500
Subject: [PATCH 60/64] document `after_initialize`

---
 README.md                                            | 2 ++
 lib/html_pipeline/node_filter/mention_filter.rb      | 1 -
 lib/html_pipeline/node_filter/team_mention_filter.rb | 1 -
 3 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 7beb9797..7df85aa7 100644
--- a/README.md
+++ b/README.md
@@ -203,6 +203,8 @@ For more examples of customizing the sanitization process to include the tags yo
 
 `NodeFilters`s can operate either on HTML elements or text nodes using CSS selectors. Each `NodeFilter` must define a method named `selector` which provides an instance of `Selma::Selector`. If elements are being manipulated, `handle_element` must be defined, taking one argument, `element`; if text nodes are being manipulated, `handle_text_chunk` must be defined, taking one argument, `text_chunk`. `@config`, and `@result` are available to use, and any changes made to these ivars are passed on to the next filter.
 
+`NodeFilter` also has an optional method, `after_initialize`, which is run after the filter initializes. This can be useful in setting up a custom state for `result` to take advantage of.
+
 Here's an example `NodeFilter` that adds a base url to images that are root relative:
 
 ```ruby
diff --git a/lib/html_pipeline/node_filter/mention_filter.rb b/lib/html_pipeline/node_filter/mention_filter.rb
index a4c4b327..f98a598c 100644
--- a/lib/html_pipeline/node_filter/mention_filter.rb
+++ b/lib/html_pipeline/node_filter/mention_filter.rb
@@ -63,7 +63,6 @@ def mentioned_logins_in(text, username_pattern = USERNAME_PATTERN)
 
       SELECTOR = Selma::Selector.new(match_text_within: "*", ignore_text_within: IGNORE_PARENTS)
 
-      # TODO: document this
       def after_initialize
         result[:mentioned_usernames] ||= []
       end
diff --git a/lib/html_pipeline/node_filter/team_mention_filter.rb b/lib/html_pipeline/node_filter/team_mention_filter.rb
index b27e74a6..eb3efb0f 100644
--- a/lib/html_pipeline/node_filter/team_mention_filter.rb
+++ b/lib/html_pipeline/node_filter/team_mention_filter.rb
@@ -53,7 +53,6 @@ def mentioned_teams_in(text, team_pattern = TEAM_PATTERN)
 
       SELECTOR = Selma::Selector.new(match_text_within: "*", ignore_text_within: IGNORE_PARENTS)
 
-      # TODO: document this
       def after_initialize
         result[:mentioned_teams] = []
       end

From 86ca424f04e1f3da48b684549ed89ed77732067a Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 30 Dec 2022 09:39:55 -0500
Subject: [PATCH 61/64] tested already

---
 lib/html_pipeline.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/html_pipeline.rb b/lib/html_pipeline.rb
index e4a672aa..ad709561 100644
--- a/lib/html_pipeline.rb
+++ b/lib/html_pipeline.rb
@@ -129,7 +129,7 @@ def initialize(text_filters: [], convert_filter: nil, sanitization_config: Sanit
   end
 
   # Apply all filters in the pipeline to the given HTML.
-  # TODO: test UTF-8
+  #
   # html    - A UTF-8 String comprised of HTML.
   # context - The context hash passed to each filter. See the Filter docs
   #           for more info on possible values. This object MUST NOT be modified

From 3f8e61e31534078e14186b2e9c48bff19c7b8ad5 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 30 Dec 2022 09:42:50 -0500
Subject: [PATCH 62/64] typo

---
 test/html_pipeline/require_helper_test.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/test/html_pipeline/require_helper_test.rb b/test/html_pipeline/require_helper_test.rb
index 6c67bd28..3c1baeb4 100644
--- a/test/html_pipeline/require_helper_test.rb
+++ b/test/html_pipeline/require_helper_test.rb
@@ -21,7 +21,7 @@ def test_raises_mising_dependency_error
       end
     end
 
-    def test_raises_mising_dependenccies_error
+    def test_raises_mising_dependencies_error
       assert_raises(HTMLPipeline::MissingDependencyError) do
         HTMLPipeline.require_dependencies(["non-existant", "something"], "SomeClass")
       end

From 4297aae2d860dc955f906cf1b2b7d24dc11b953b Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 30 Dec 2022 09:45:21 -0500
Subject: [PATCH 63/64] add note on multiple dependencies

---
 README.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 7df85aa7..f1d30ef3 100644
--- a/README.md
+++ b/README.md
@@ -244,7 +244,10 @@ For more information on how to write effective `NodeFilter`s, refer to the provi
 Since filters can be customized to your heart's content, gem dependencies are _not_ bundled; this project doesn't know which of the default filters you might use, and as such, you must bundle each filter's gem
 dependencies yourself.
 
-_Note:_ See the [Gemfile](/Gemfile) `:test` group for any version requirements.
+> **Note**
+> See the [Gemfile](/Gemfile) `:test` group for any version requirements.
+
+When developing a custom filter, call `HTMLPipeline.require_dependency` at the start to ensure that the local machine has the necessary dependency. You can also use `HTMLPipeline.require_dependencies` to provide a list of dependencies to check.
 
 ## Documentation
 

From 785126453f58eedcb795d94802b02dfbfd6e2413 Mon Sep 17 00:00:00 2001
From: "Garen J. Torikian" <gjtorikian@users.noreply.github.com>
Date: Fri, 30 Dec 2022 09:48:46 -0500
Subject: [PATCH 64/64] typo

---
 UPGRADING.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/UPGRADING.md b/UPGRADING.md
index 398c7531..f0565678 100644
--- a/UPGRADING.md
+++ b/UPGRADING.md
@@ -29,7 +29,7 @@ HTMLPipeline.new(
     text_filters: [], # array of instantiated (`.new`ed) `HTMLPipeline::TextFilter`
     convert_filter:, # a filter that runs to turn text into HTML
     sanitization_config: {}, # an allowlist of elements/attributes/protocols to keep
-    node_filters:[]) # array of instantiated (`.new`ed) `HTMLPipeline::NodeFilter`
+    node_filters: []) # array of instantiated (`.new`ed) `HTMLPipeline::NodeFilter`
 ```
 
 Please refer to the README for more information on constructing filters. In most cases, the underlying filter needs only a few changes, primarily to make use of [Selma](https://www.github.com/gjtorikian/selma) rather than Nokogiri.