HTML API: Search HTML text using a regexp & print the containing HTML.

[dmsnell]

Apply this patch for a tool to search through an HTML document looking for a match using a regular expression pattern. It will only search the text content of the document, but it will print the containing HTML of each match.

• -B5 print the previous five lines preceding a match
• -A3 print the following three lines after a match
• -p '/[Ss]ome PCRE pattern!?/i' search for matches to this pattern
• -i /path/to/file scan the file at this path
• - scan the input on stdin
• -m8 stop searching after finding the first eight matches

php html-grep.php -i ~/Downloads/single-page.html -m 15 -B3 -A8 -p '~(start|end) tag whose name is "(li|button)"\s*Run~i'

[github-actions]

Test using WordPress Playground

The changes in this pull request can previewed and tested using a WordPress Playground instance.

WordPress Playground is an experimental project that creates a full WordPress instance entirely within the browser.

Some things to be aware of

• The Plugin and Theme Directories cannot be accessed within Playground.
• All changes will be lost when closing a tab with a Playground instance.
• All changes will be lost when refreshing the page.
• A fresh instance is created each time the link below is clicked.
• Every time this pull request is updated, a new ZIP file containing all changes is created. If changes are not reflected in the Playground instance,
  it's possible that the most recent build failed, or has not completed. Check the list of workflow runs to be sure.

For more details about these limitations and more, check out the Limitations page in the WordPress Playground documentation.

Test this pull request with WordPress Playground.

[dmsnell]

Replaced by #6832