From 172c1cf61b979e07f5534563e4926d00e7edd521 Mon Sep 17 00:00:00 2001 From: Leonard Richardson Date: Sun, 12 Feb 2023 12:38:41 -0500 Subject: Improved documentation of new method. --- bs4/css.py | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) (limited to 'bs4/css.py') diff --git a/bs4/css.py b/bs4/css.py index 3cf4df1..197bfaf 100644 --- a/bs4/css.py +++ b/bs4/css.py @@ -58,6 +58,9 @@ class CSS(object): def _ns(self, ns, select): """Normalize a dictionary of namespaces.""" if not isinstance(select, self.api.SoupSieve) and ns is None: + # If the selector is a precompiled pattern, it already has + # a namespace context compiled in, which cannot be + # replaced. ns = self.tag._namespaces return ns @@ -84,15 +87,17 @@ class CSS(object): parsing the document. :param flags: Flags to be passed into Soup Sieve's - soupsieve.select_one() method. + soupsieve.compile() method. :param kwargs: Keyword arguments to be passed into SoupSieve's - soupsieve.select_one() method. + soupsieve.compile() method. :return: A precompiled selector object. :rtype: soupsieve.SoupSieve """ - return self.api.compile(select, self._ns(namespaces, select), flags, **kwargs) + return self.api.compile( + select, self._ns(namespaces, select), flags, **kwargs + ) def select_one(self, select, namespaces=None, flags=0, **kwargs): """Perform a CSS selection operation on the current Tag and return the -- cgit v1.2.3