Support newer BeautifulSoup (#50)

v 0.13.0
* update testharness
* improve typing
* remove deprecations
* adjust tests for deprecations
* bump beautifulsoup to 4.14.x branch
* standardizing UrlParserCacheable, cached_urlparser, and cached_urlparser_maxitems

Author: jvanasco

.github/workflows/python-package.yml

@@ -15,20 +15,15 @@ jobs:
     strategy:
       matrix:
         os:
-          - "ubuntu-latest"
+          - "ubuntu-22.04"
         python-version:
+          - "3.7"
           - "3.8"
           - "3.9"
           - "3.10"
           - "3.11"
           - "3.12"
           - "3.13"
-        include:
-          # ubuntu-latest[22.04] does not have: py36
-          - os: "ubuntu-20.04"
-            python-version: "3.6"
-          - os: "ubuntu-20.04"
-            python-version: "3.7"
     steps:
     - uses: actions/checkout@v3
     - name: Set up Python ${{ matrix.python-version }}

CHANGELOG.txt

@@ -1,5 +1,27 @@
-1.0
-    1.0 will be a complete api overhaul
+1.0 (unreleased)
+    1.0 will include an api overhaul and remove all deprecations
+
+
+0.13.0
+    * drop py36; no test options due to github deprecation of ubuntu20.04
+    * `_coerce_validate_strategy` (invoked by `get_metadatas`) will now raise a
+        ValueError if a string other than "all" is submitted.  The only valid
+        string is "all", otherwise a list of string - excluding "all" - must be
+        submitted. Warnings of this have been emitted for several years.
+    * __init__(`search_head_only`) now defaults to False
+    * `UrlParserCacheable` has been extended to accepted a `urlparser` argument.
+      This defaults to `urlparse` and expects the same signature.
+    * __init__(`cached_urlparser`) has new deprecations to standardize the API
+        submitting an Int to set max_items is deprecated; instead:
+            cached_urlparser=True
+            cached_urlparser_maxitems=int
+        submitting 0 is deprecated; instead:
+            cached_urlparser=False
+                or
+            cached_urlparser_maxitems=0
+            cached_urlparser=False
+    * __init__(`cached_urlparser_maxitems`) has been added
+    * the next release is likely to be 1.0
 
 0.12.3
     * pin "BeautifulSoup4<4.15.0"

pytest.ini

@@ -0,0 +1,5 @@
+[pytest]
+
+filterwarnings =
+    ignore:MetadataParser.
+    ignore:`ParsedResult.get_metadata` returns a string

setup.py

@@ -27,9 +27,10 @@
     long_description = fp.read()
 
 requires = [
-    "BeautifulSoup4<4.15.0",
+    "BeautifulSoup4>4.13.0,<4.14.0",
     "requests>=2.19.1",
     "requests-toolbelt>=0.8.0",
+    "typing_extensions",
 ]
 if sys.version_info.major == 2:
     requires.append("backports.html")
@@ -59,7 +60,6 @@
         "Intended Audience :: Developers",
         "License :: OSI Approved :: MIT License",
         "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.6",
         "Programming Language :: Python :: 3.7",
         "Programming Language :: Python :: 3.8",
         "Programming Language :: Python :: 3.9",