Release v0.38 (#629)

* Prepare to release v0.38

* Fix some docs issues

* Add last minute change

Author: philss

CHANGELOG.md

@@ -7,6 +7,53 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [Unreleased][unreleased]
 
+## [0.38.0] - 2025-06-14
+
+### Added
+
+- This version adds initial support for the `:has` pseudo-selector.
+  It is a great addition that enables finding elements containing
+  matching children.
+
+  Examples for selectors:
+
+  * `"div:has(h1)"`
+  * `"div:has(h1, p, span)"`
+  * `"div:has(p.foo)"`
+  * `"div:has(img[src='https://example.com'])"`
+  * `"tr:has(*:fl-contains('TEST'))"`
+
+  Note that combinators like `">"` are not allowed yet.
+
+  Thank you [@bvobart](https://github.com/bvobart) for this feature!
+
+### Fixed
+
+- Add `:style` option documentation to `Floki.text/2`.
+  Thanks [@s3cur3](https://github.com/s3cur3) for the fix.
+
+- Fix deprecation warnings for upcoming Elixir 1.19.
+
+- Prevent from crashing when selector is an empty string.
+
+### Removed
+
+- Remove support for Elixir 1.14 and OTP 23.
+
+- Remove deprecated functions and function clauses
+  that were accepting strings (binaries).
+
+  Affected functions:
+
+  * `parse/1` - removed function
+  * `map/2` - removed function
+  * `attr/4` - removed clause
+  * `find/2` - removed clause
+  * `text/3` - removed clause
+  * `text/3` - removed clause
+  * `attribute/2` - removed clause
+  * `filter_out/2` - removed clause
+
 ## [0.37.1] - 2025-03-22
 
 ### Fixed
@@ -820,7 +867,8 @@ of the parent element inside HTML.
 
 - Elixir version requirement from "~> 1.0.0" to ">= 1.0.0".
 
-[unreleased]: https://github.com/philss/floki/compare/v0.37.1...HEAD
+[unreleased]: https://github.com/philss/floki/compare/v0.38.0...HEAD
+[0.38.0]: https://github.com/philss/floki/compare/v0.37.1...v0.38.0
 [0.37.1]: https://github.com/philss/floki/compare/v0.37.0...v0.37.1
 [0.37.0]: https://github.com/philss/floki/compare/v0.36.3...v0.37.0
 [0.36.3]: https://github.com/philss/floki/compare/v0.36.2...v0.36.3

README.md

@@ -40,7 +40,7 @@ Floki.find(document, "p.headline")
 
 document
 |> Floki.find("p.headline")
-|> Floki.raw_html
+|> Floki.raw_html()
 # => <p class="headline">Floki</p>
 ```
 
@@ -61,7 +61,7 @@ Add Floki to your `mix.exs`:
 ```elixir
 defp deps do
   [
-    {:floki, "~> 0.37.0"}
+    {:floki, "~> 0.38.0"}
   ]
 end
 ```
@@ -72,7 +72,7 @@ If you are running on [Livebook](https://livebook.dev) or a script, you can inst
 
 ```elixir
 Mix.install([
-  {:floki, "~> 0.37.0"}
+  {:floki, "~> 0.38.0"}
 ])
 ```
 
@@ -128,8 +128,8 @@ you don't need to install anything to compile it thanks to [RustlerPrecompiled](
 ```elixir
 defp deps do
   [
-    {:floki, "~> 0.37.0"},
-    {:html5ever, "~> 0.15.0"}
+    {:floki, "~> 0.38.0"},
+    {:html5ever, "~> 0.16.0"}
   ]
 end
 ```
@@ -156,7 +156,7 @@ First, add `fast_html` to your dependencies:
 ```elixir
 defp deps do
   [
-    {:floki, "~> 0.37.0"},
+    {:floki, "~> 0.38.0"},
     {:fast_html, "~> 2.0"}
   ]
 end
@@ -201,7 +201,7 @@ To convert your node tree back to raw HTML (spaces are ignored):
 ```elixir
 document
 |> Floki.find(".example")
-|> Floki.raw_html
+|> Floki.raw_html()
 # =>  <div class="example"></div>
 ```
 
@@ -226,7 +226,7 @@ If you want to get the text from an element, try:
 ```elixir
 document
 |> Floki.find(".headline")
-|> Floki.text
+|> Floki.text()
 
 # => "Floki"
 ```

lib/floki.ex

@@ -1,8 +1,6 @@
 defmodule Floki do
   alias Floki.{Finder, FilterOut, HTMLTree}
 
-  require Logger
-
   @moduledoc """
   Floki is a simple HTML parser that enables search for nodes using CSS selectors.
 

lib/floki/html_parser/mochiweb.ex

@@ -1,7 +1,14 @@
 defmodule Floki.HTMLParser.Mochiweb do
-  @behaviour Floki.HTMLParser
+  @moduledoc """
+  The default HTML parser engine for Floki.
+
+  This parser is historically not compliant to the HTML5 specs, but will
+  parse faster and in most of the cases it will produce a valid HTML tree.
 
-  @moduledoc false
+  For alternative, please check the `README.md` file.
+  """
+
+  @behaviour Floki.HTMLParser
   @root_node "floki"
 
   @impl true

mix.exs

@@ -3,7 +3,7 @@ defmodule Floki.Mixfile do
 
   @description "Floki is a simple HTML parser that enables search for nodes using CSS selectors."
   @source_url "https://github.com/philss/floki"
-  @version "0.37.1"
+  @version "0.38.0"
 
   def project do
     [
@@ -33,7 +33,7 @@ defmodule Floki.Mixfile do
     [
       extras: ["CHANGELOG.md", {:"README.md", [title: "Overview"]}],
       main: "readme",
-      assets: "assets",
+      assets: %{"assets" => "assets"},
       logo: "assets/images/floki-logo.svg",
       source_url: @source_url,
       source_ref: "v#{@version}",