Optionally pass the Beautiful Soup object to constructors

linkpreview/linkpreview.py

@@ -1,5 +1,7 @@
 from os.path import dirname
 
+from bs4 import BeautifulSoup
+
 from linkpreview.link import Link
 from linkpreview.preview import (
     Generic,
@@ -14,13 +16,17 @@
 
 
 class LinkPreview:
-    def __init__(self, link: Link, parser: str = PARSER):
+    def __init__(self, link: Link, parser: str | None = PARSER, soup: BeautifulSoup | None = None):
+        if parser and soup:
+            raise Exception(
+                'Only one of `parser` or soup` argument must be provided to LinkPreview')
+
         self.link = link
-        self.generic = Generic(link, parser)
-        self.opengraph = OpenGraph(link, parser)
-        self.twitter = TwitterCard(link, parser)
-        self.microdata = Microdata(link, parser)
-        self.jsonld = JsonLd(link, parser)
+        self.generic = Generic(link, parser, soup)
+        self.opengraph = OpenGraph(link, parser, soup)
+        self.twitter = TwitterCard(link, parser, soup)
+        self.microdata = Microdata(link, parser, soup)
+        self.jsonld = JsonLd(link, parser, soup)
 
     @LazyAttribute
     def sources(self):

linkpreview/preview/base.py

@@ -7,9 +7,12 @@ class PreviewBase(object):  # pragma: nocover
     Base for all web preview.
     """
 
-    def __init__(self, link: Link, parser: str):
+    def __init__(self, link: Link, parser: str, soup: BeautifulSoup):
         self.link = link
-        self._soup = BeautifulSoup(self.link.content, parser)
+        if soup:
+            self._soup = soup
+        else:
+            self._soup = BeautifulSoup(self.link.content, parser)
 
     @property
     def title(self):