Coverage for /pythoncovmergedfiles/medio/medio/usr/local/lib/python3.11/site-packages/soupsieve/css

1"""CSS selector parser."""

2from __future__ import annotations

3import re

4from functools import lru_cache

5from . import util

6from . import css_match as cm

7from . import css_types as ct

8from .util import SelectorSyntaxError

9import warnings

10from typing import Match, Any, Iterator, cast

11from dataclasses import dataclass

12from collections import UserDict

13import threading

15RE_LOCK = threading.Lock()

16SEL_LOCK = threading.RLock()

18UNICODE_REPLACEMENT_CHAR = 0xFFFD

20SELECTOR_LIMIT = 8192

22# Simple pseudo classes that take no parameters

23PSEUDO_SIMPLE = {

24 ":any-link",

25 ":empty",

26 ":first-child",

27 ":first-of-type",

28 ":in-range",

29 ":open",

30 ":out-of-range",

31 ":last-child",

32 ":last-of-type",

33 ":link",

34 ":only-child",

35 ":only-of-type",

36 ":root",

37 ':checked',

38 ':default',

39 ':disabled',

40 ':enabled',

41 ':indeterminate',

42 ':optional',

43 ':placeholder-shown',

44 ':read-only',

45 ':read-write',

46 ':required',

47 ':scope',

48 ':defined',

49 ':muted'

50}

52# Supported, simple pseudo classes that match nothing in the Soup Sieve environment

53PSEUDO_SIMPLE_NO_MATCH = {

54 ':active',

55 ':autofill',

56 ':buffering',

57 ':current',

58 ':focus',

59 ':focus-visible',

60 ':focus-within',

61 ':fullscreen',

62 ':future',

63 ':host',

64 ':hover',

65 ':local-link',

66 ':past',

67 ':paused',

68 ':picture-in-picture',

69 ':playing',

70 ':popover-open',

71 ':seeking',

72 ':stalled',

73 ':target',

74 ':target-within',

75 ':user-invalid',

76 ':volume-locked',

77 ':visited'

78}

80# Complex pseudo classes that take selector lists

81PSEUDO_COMPLEX = {

82 ':contains',

83 ':-soup-contains',

84 ':-soup-contains-own',

85 ':has',

86 ':is',

87 ':matches',

88 ':not',

89 ':where'

90}

92PSEUDO_COMPLEX_NO_MATCH = {

93 ':current',

94 ':host',

95 ':host-context'

96}

98# Complex pseudo classes that take very specific parameters and are handled special

99PSEUDO_SPECIAL = {

100 ':dir',

101 ':lang',

102 ':nth-child',

103 ':nth-last-child',

104 ':nth-last-of-type',

105 ':nth-of-type'

106}

107

108PSEUDO_SUPPORTED = PSEUDO_SIMPLE | PSEUDO_SIMPLE_NO_MATCH | PSEUDO_COMPLEX | PSEUDO_COMPLEX_NO_MATCH | PSEUDO_SPECIAL

109

110# Sub-patterns parts

111# Whitespace

112NEWLINE = r'(?:\r\n|(?!\r\n)[\n\f\r])'

113WS = fr'(?:[ \t]|{NEWLINE})'

114# Comments

115COMMENTS = r'(?:/\*(?:[^*]|\*(?!/))*\*/)'

116# Whitespace with comments included

117WSC = fr'(?:{WS}|{COMMENTS})'

118# CSS escapes

119CSS_ESCAPES = fr'(?:\\(?:[a-f0-9]{{1,6}}{WS}?|[^\r\n\f]|$))'

120CSS_STRING_ESCAPES = fr'(?:\\(?:[a-f0-9]{{1,6}}{WS}?|[^\r\n\f]|$|{NEWLINE}))'

121# CSS Identifier

122IDENTIFIER = fr'''

123(?:(?:--|-?(?:[^\x00-\x2f\x30-\x40\x5B-\x5E\x60\x7B-\x9f]|{CSS_ESCAPES}))

124(?:[^\x00-\x2c\x2e\x2f\x3A-\x40\x5B-\x5E\x60\x7B-\x9f]|{CSS_ESCAPES})*)

125'''

126# `nth` content

127NTH = fr'(?:[-+])?(?:[0-9]+n?|n)(?:(?<=n){WSC}*(?:[-+]){WSC}*(?:[0-9]+))?'

128# Value: quoted string or identifier

129VALUE = fr'''(?:"(?:\\(?:.|{NEWLINE})|[^\\"\r\n\f])*?"|'(?:\\(?:.|{NEWLINE})|[^\\'\r\n\f])*?'|{IDENTIFIER})'''

130# Attribute value comparison. `!=` is handled special as it is non-standard.

131ATTR = fr'(?:{WSC}*(?P<cmp>[!~^|*$]?=){WSC}*(?P<value>{VALUE})(?:{WSC}*(?P<case>[is]))?)?{WSC}*'

132

133# Selector patterns

134# IDs (`#id`)

135PAT_ID = fr'\#{IDENTIFIER}'

136# Classes (`.class`)

137PAT_CLASS = fr'\.{IDENTIFIER}'

138# Prefix:Tag (`prefix|tag`)

139PAT_TAG = fr'(?P<tag_ns>(?:{IDENTIFIER}|\*)?\|)?(?P<tag_name>{IDENTIFIER}|\*)'

140# Attributes (`[attr]`, `[attr=value]`, etc.)

141PAT_ATTR = fr'\[{WSC}*(?P<attr_ns>(?:{IDENTIFIER}|\*)?\|)?(?P<attr_name>{IDENTIFIER}){ATTR}\]'

142# Pseudo class (`:pseudo-class`, `:pseudo-class(`)

143PAT_PSEUDO_CLASS = fr'(?P<name>:{IDENTIFIER})(?P<open>\({WSC}*)?'

144# Pseudo class special patterns. Matches `:pseudo-class(` for special case pseudo classes.

145PAT_PSEUDO_CLASS_SPECIAL = fr'(?P<name>:{IDENTIFIER})(?P<open>\({WSC}*)'

146# Custom pseudo class (`:--custom-pseudo`)

147PAT_PSEUDO_CLASS_CUSTOM = fr'(?P<name>:(?=--){IDENTIFIER})'

148# Nesting ampersand selector. Matches `&`

149PAT_AMP = r'&'

150# Closing pseudo group (`)`)

151PAT_PSEUDO_CLOSE = fr'{WSC}*\)'

152# Pseudo element (`::pseudo-element`)

153PAT_PSEUDO_ELEMENT = fr':{PAT_PSEUDO_CLASS}'

154# At rule (`@page`, etc.) (not supported)

155PAT_AT_RULE = fr'@P{IDENTIFIER}'

156# Pseudo class `nth-child` (`:nth-child(an+b [of S]?)`, `:first-child`, etc.)

157PAT_PSEUDO_NTH_CHILD = fr'''

158(?P<pseudo_nth_child>{PAT_PSEUDO_CLASS_SPECIAL}

159(?P<nth_child>{NTH}|even|odd))(?:{WSC}*\)|(?P<of>{COMMENTS}*{WS}{WSC}*of{COMMENTS}*{WS}{WSC}*))

160'''

161# Pseudo class `nth-of-type` (`:nth-of-type(an+b)`, `:first-of-type`, etc.)

162PAT_PSEUDO_NTH_TYPE = fr'''

163(?P<pseudo_nth_type>{PAT_PSEUDO_CLASS_SPECIAL}

164(?P<nth_type>{NTH}|even|odd)){WSC}*\)

165'''

166# Pseudo class language (`:lang("*-de", en)`)

167PAT_PSEUDO_LANG = fr'{PAT_PSEUDO_CLASS_SPECIAL}(?P<values>{VALUE}(?:{WSC}*,{WSC}*{VALUE})*){WSC}*\)'

168# Pseudo class direction (`:dir(ltr)`)

169PAT_PSEUDO_DIR = fr'{PAT_PSEUDO_CLASS_SPECIAL}(?P<dir>ltr|rtl){WSC}*\)'

170# Combining characters (`>`, `~`, ` `, `+`, `,`)

171PAT_COMBINE = fr'{WSC}*?(?P<relation>[,+>~]|{WS}(?![,+>~])){WSC}*'

172# Extra: Contains (`:contains(text)`)

173PAT_PSEUDO_CONTAINS = fr'{PAT_PSEUDO_CLASS_SPECIAL}(?P<values>{VALUE}(?:{WSC}*,{WSC}*{VALUE})*){WSC}*\)'

174

175# Regular expressions

176# CSS escape pattern

177RE_CSS_ESC = re.compile(fr'(?:(\\[a-f0-9]{{1,6}}{WSC}?)|(\\[^\r\n\f])|(\\$))', re.I)

178RE_CSS_STR_ESC = re.compile(fr'(?:(\\[a-f0-9]{{1,6}}{WS}?)|(\\[^\r\n\f])|(\\$)|(\\{NEWLINE}))', re.I)

179# Pattern to break up `nth` specifiers

180RE_NTH = re.compile(fr'(?P<s1>[-+])?(?P<a>[0-9]+n?|n)(?:(?<=n){WSC}*(?P<s2>[-+]){WSC}*(?P<b>[0-9]+))?', re.I)

181# Pattern to iterate multiple values.

182RE_VALUES = re.compile(fr'(?:(?P<value>{VALUE})|(?P<split>{WSC}*,{WSC}*))', re.X)

183# Whitespace checks

184RE_WS = re.compile(WS)

185RE_WS_BEGIN = re.compile(fr'^{WSC}*')

186RE_WS_END = re.compile(fr'^(?:[ \t]|(?:\n\r|(?!\n\r)[\n\f\r])|{COMMENTS})*')

187RE_CUSTOM = re.compile(fr'^{PAT_PSEUDO_CLASS_CUSTOM}$', re.X)

188RE_PSEUDO_CLASS_SPECIAL = re.compile(PAT_PSEUDO_CLASS_SPECIAL, re.I | re.X | re.U)

189

190# Constants

191# List split token

192COMMA_COMBINATOR = ','

193# Relation token for descendant

194WS_COMBINATOR = " "

195

196# Parse flags

197FLG_PSEUDO = 0x01

198FLG_NOT = 0x02

199FLG_RELATIVE = 0x04

200FLG_DEFAULT = 0x08

201FLG_HTML = 0x10

202FLG_INDETERMINATE = 0x20

203FLG_OPEN = 0x40

204FLG_IN_RANGE = 0x80

205FLG_OUT_OF_RANGE = 0x100

206FLG_PLACEHOLDER_SHOWN = 0x200

207FLG_FORGIVE = 0x400

208

209# Maximum cached patterns to store

210_MAXCACHE = 500

211

212

213@lru_cache(maxsize=_MAXCACHE)

214def _cached_css_compile(

215 pattern: str,

216 namespaces: ct.Namespaces | None,

217 custom: ct.CustomSelectors | None,

218 flags: int

219) -> cm.SoupSieve:

220 """Cached CSS compile."""

221

222 custom_selectors = process_custom(custom)

223 return cm.SoupSieve(

224 pattern,

225 CSSParser(

226 pattern,

227 custom=custom_selectors,

228 flags=flags

229 ).process_selectors(),

230 namespaces,

231 custom,

232 flags

233 )

234

235

236def _purge_cache() -> None:

237 """Purge the cache."""

238

239 _cached_css_compile.cache_clear()

240

241

242def process_custom(custom: ct.CustomSelectors | None) -> dict[str, str | ct.SelectorList]:

243 """Process custom."""

244

245 custom_selectors = {}

246 if custom is not None:

247 for key, value in custom.items():

248 name = util.lower(key)

249 if RE_CUSTOM.match(name) is None:

250 raise SelectorSyntaxError(f"The name '{name}' is not a valid custom pseudo-class name")

251 if name in custom_selectors:

252 raise KeyError(f"The custom selector '{name}' has already been registered")

253 custom_selectors[css_unescape(name)] = value

254 return custom_selectors

255

256

257def css_unescape(content: str, string: bool = False) -> str:

258 """

259 Unescape CSS value.

260

261 Strings allow for spanning the value on multiple strings by escaping a new line.

262 """

263

264 def replace(m: Match[str]) -> str:

265 """Replace with the appropriate substitute."""

266

267 if m.group(1):

268 codepoint = int(m.group(1)[1:], 16)

269 if codepoint == 0:

270 codepoint = UNICODE_REPLACEMENT_CHAR

271 value = chr(codepoint)

272 elif m.group(2):

273 value = m.group(2)[1:]

274 elif m.group(3):

275 value = '\ufffd'

276 else:

277 value = ''

278

279 return value

280

281 return (RE_CSS_ESC if not string else RE_CSS_STR_ESC).sub(replace, content)

282

283

284def escape(ident: str) -> str:

285 """Escape identifier."""

286

287 string = []

288 length = len(ident)

289 start_dash = length > 0 and ident[0] == '-'

290 if length == 1 and start_dash:

291 # Need to escape identifier that is a single `-` with no other characters

292 string.append(f'\\{ident}')

293 else:

294 for index, c in enumerate(ident):

295 codepoint = ord(c)

296 if codepoint == 0x00:

297 string.append('\ufffd')

298 elif (0x01 <= codepoint <= 0x1F) or codepoint == 0x7F:

299 string.append(f'\\{codepoint:x} ')

300 elif (index == 0 or (start_dash and index == 1)) and (0x30 <= codepoint <= 0x39):

301 string.append(f'\\{codepoint:x} ')

302 elif (

303 codepoint in (0x2D, 0x5F) or codepoint >= 0x80 or (0x30 <= codepoint <= 0x39) or

304 (0x30 <= codepoint <= 0x39) or (0x41 <= codepoint <= 0x5A) or (0x61 <= codepoint <= 0x7A)

305 ):

306 string.append(c)

307 else:

308 string.append(f'\\{c}')

309 return ''.join(string)

310

311

312class SelectorPattern:

313 """Selector pattern."""

314

315 def __init__(self, name: str, pattern: str) -> None:

316 """Initialize."""

317

318 self.name = name

319 self.pattern = pattern

320 self._re_pattern: re.Pattern[str] | None = None

321

322 @property

323 def re_pattern(self) -> re.Pattern[str]:

324 """Retrieve the compiled regular expression pattern."""

325

326 with RE_LOCK:

327 if self._re_pattern is None:

328 self._re_pattern = re.compile(self.pattern, re.I | re.X | re.U)

329 return self._re_pattern

330

331 def get_name(self) -> str:

332 """Get name."""

333

334 return self.name

335

336 def match(self, selector: str, index: int, flags: int) -> Match[str] | None:

337 """Match the selector."""

338

339 return self.re_pattern.match(selector, index)

340

341

342class SpecialPseudoPattern(SelectorPattern):

343 """Selector pattern."""

344

345 def __init__(self, patterns: tuple[tuple[str, tuple[str, ...], str, type[SelectorPattern]], ...]) -> None:

346 """Initialize."""

347

348 self.patterns = {}

349 for p in patterns:

350 name = p[0]

351 pattern = p[3](name, p[2])

352 for pseudo in p[1]:

353 self.patterns[pseudo] = pattern

354

355 self.matched_name = None # type: SelectorPattern | None

356

357 def get_name(self) -> str:

358 """Get name."""

359

360 return '' if self.matched_name is None else self.matched_name.get_name()

361

362 def match(self, selector: str, index: int, flags: int) -> Match[str] | None:

363 """Match the selector."""

364

365 pseudo = None

366 m = RE_PSEUDO_CLASS_SPECIAL.match(selector, index)

367 if m:

368 name = util.lower(css_unescape(m.group('name')))

369 pattern = self.patterns.get(name)

370 if pattern:

371 pseudo = pattern.match(selector, index, flags)

372 if pseudo:

373 self.matched_name = pattern

374

375 return pseudo

376

377

378class _Selector:

379 """

380 Intermediate selector class.

381

382 This stores selector data for a compound selector as we are acquiring them.

383 Once we are done collecting the data for a compound selector, we freeze

384 the data in an object that can be pickled and hashed.

385 """

386

387 def __init__(self, **kwargs: Any) -> None:

388 """Initialize."""

389

390 self.tag = kwargs.get('tag', None) # type: ct.SelectorTag | None

391 self.ids = kwargs.get('ids', []) # type: list[str]

392 self.classes = kwargs.get('classes', []) # type: list[str]

393 self.attributes = kwargs.get('attributes', []) # type: list[ct.SelectorAttribute]

394 self.nth = kwargs.get('nth', []) # type: list[ct.SelectorNth]

395 self.selectors = kwargs.get('selectors', []) # type: list[ct.SelectorList]

396 self.relations = kwargs.get('relations', []) # type: list[_Selector]

397 self.rel_type = kwargs.get('rel_type', None) # type: str | None

398 self.contains = kwargs.get('contains', []) # type: list[ct.SelectorContains]

399 self.lang = kwargs.get('lang', []) # type: list[ct.SelectorLang]

400 self.flags = kwargs.get('flags', 0) # type: int

401 self.no_match = kwargs.get('no_match', False) # type: bool

402

403 def _freeze_relations(self, relations: list[_Selector]) -> ct.SelectorList:

404 """Freeze relation."""

405

406 if relations:

407 sel = relations[0]

408 sel.relations.extend(relations[1:])

409 return ct.SelectorList([sel.freeze()])

410 else:

411 return ct.SelectorList()

412

413 def freeze(self) -> ct.Selector | ct.SelectorNull:

414 """Freeze self."""

415

416 if self.no_match:

417 return ct.SelectorNull()

418 else:

419 return ct.Selector(

420 self.tag,

421 tuple(self.ids),

422 tuple(self.classes),

423 tuple(self.attributes),

424 tuple(self.nth),

425 tuple(self.selectors),

426 self._freeze_relations(self.relations),

427 self.rel_type,

428 tuple(self.contains),

429 tuple(self.lang),

430 self.flags

431 )

432

433 def __str__(self) -> str: # pragma: no cover

434 """String representation."""

435

436 return (

437 f'_Selector(tag={self.tag!r}, ids={self.ids!r}, classes={self.classes!r}, attributes={self.attributes!r}, '

438 f'nth={self.nth!r}, selectors={self.selectors!r}, relations={self.relations!r}, '

439 f'rel_type={self.rel_type!r}, contains={self.contains!r}, lang={self.lang!r}, flags={self.flags!r}, '

440 f'no_match={self.no_match!r})'

441 )

442

443 __repr__ = __str__

444

445

446@dataclass

447class CSSPattern:

448 """A CSS pattern that hasn't been processed by `CSSParser` yet."""

449

450 selector: str

451 flags: int

452

453

454class PseudoSelectorMap(UserDict[str, CSSPattern | ct.SelectorList]):

455 """Pseudo selector map."""

456

457 def __setitem__(self, key: str, value: CSSPattern | ct.SelectorList) -> None:

458 """Set item."""

459

460 self.data[key] = value

461

462 def __getitem__(self, key: str) -> ct.SelectorList:

463 """Get item."""

464

465 with SEL_LOCK:

466 value = self.data[key]

467 if isinstance(value, CSSPattern):

468 value = CSSParser(value.selector).process_selectors(flags=value.flags)

469 self.data[key] = value

470

471 return value

472

473

474# CSS pattern for `:link` and `:any-link`

475CSS_LINK = CSSPattern('html|*:is(a, area)[href]', FLG_PSEUDO | FLG_HTML)

476# CSS pattern for `:checked`

477CSS_CHECKED = CSSPattern(

478 '''

479 html|*:is(input[type=checkbox], input[type=radio])[checked], html|option[selected]

480 ''',

481 FLG_PSEUDO | FLG_HTML

482)

483# CSS pattern for `:default` (must compile CSS_CHECKED first)

484CSS_DEFAULT = CSSPattern(

485 '''

486 :checked,

487

488 /*

489 This pattern must be at the end.

490 Special logic is applied to the last selector.

491 */

492 html|form html|*:is(button, input)[type="submit"]

493 ''',

494 FLG_PSEUDO | FLG_HTML | FLG_DEFAULT

495)

496# CSS pattern for `:indeterminate`

497CSS_INDETERMINATE = CSSPattern(

498 '''

499 html|input[type="checkbox"][indeterminate],

500 html|input[type="radio"]:is(:not([name]), [name=""]):not([checked]),

501 html|progress:not([value]),

502

503 /*

504 This pattern must be at the end.

505 Special logic is applied to the last selector.

506 */

507 html|input[type="radio"][name]:not([name='']):not([checked])

508 ''',

509 FLG_PSEUDO | FLG_HTML | FLG_INDETERMINATE

510)

511# CSS pattern for `:disabled`

512CSS_DISABLED = CSSPattern(

513 '''

514 html|*:is(input:not([type=hidden]), button, select, textarea, fieldset, optgroup, option, fieldset)[disabled],

515 html|optgroup[disabled] > html|option,

516 html|fieldset[disabled] > html|*:is(input:not([type=hidden]), button, select, textarea, fieldset),

517 html|fieldset[disabled] >

518 html|*:not(legend:nth-of-type(1)) html|*:is(input:not([type=hidden]), button, select, textarea, fieldset)

519 ''',

520 FLG_PSEUDO | FLG_HTML

521)

522# CSS pattern for `:enabled`

523CSS_ENABLED = CSSPattern(

524 '''

525 html|*:is(input:not([type=hidden]), button, select, textarea, fieldset, optgroup, option, fieldset):not(:disabled)

526 ''',

527 FLG_PSEUDO | FLG_HTML

528)

529# CSS pattern for `:required`

530CSS_REQUIRED = CSSPattern('html|*:is(input, textarea, select)[required]', FLG_PSEUDO | FLG_HTML)

531# CSS pattern for `:optional`

532CSS_OPTIONAL = CSSPattern('html|*:is(input, textarea, select):not([required])', FLG_PSEUDO | FLG_HTML)

533# CSS pattern for `:placeholder-shown`

534CSS_PLACEHOLDER_SHOWN = CSSPattern(

535 '''

536 html|input:is(

537 :not([type]),

538 [type=""],

539 [type=text],

540 [type=search],

541 [type=url],

542 [type=tel],

543 [type=email],

544 [type=password],

545 [type=number]

546 )[placeholder]:not([placeholder='']):is(:not([value]), [value=""]),

547 html|textarea[placeholder]:not([placeholder=''])

548 ''',

549 FLG_PSEUDO | FLG_HTML | FLG_PLACEHOLDER_SHOWN

550)

551# CSS pattern for `:read-write` (CSS_DISABLED must be compiled first)

552CSS_READ_WRITE = CSSPattern(

553 '''

554 html|*:is(

555 textarea,

556 input:is(

557 :not([type]),

558 [type=""],

559 [type=text],

560 [type=search],

561 [type=url],

562 [type=tel],

563 [type=email],

564 [type=number],

565 [type=password],

566 [type=date],

567 [type=datetime-local],

568 [type=month],

569 [type=time],

570 [type=week]

571 )

572 ):not([readonly], :disabled),

573 html|*:is([contenteditable=""], [contenteditable="true" i])

574 ''',

575 FLG_PSEUDO | FLG_HTML

576)

577# CSS pattern for `:read-only`

578CSS_READ_ONLY = CSSPattern('html|*:not(:read-write)', FLG_PSEUDO | FLG_HTML)

579# CSS pattern for `:in-range`

580CSS_IN_RANGE = CSSPattern(

581 '''

582 html|input:is(

583 [type="date"],

584 [type="month"],

585 [type="week"],

586 [type="time"],

587 [type="datetime-local"],

588 [type="number"],

589 [type="range"]

590 ):is(

591 [min],

592 [max]

593 )

594 ''',

595 FLG_PSEUDO | FLG_HTML | FLG_IN_RANGE

596)

597# CSS pattern for `:out-of-range`

598CSS_OUT_OF_RANGE = CSSPattern(

599 '''

600 html|input:is(

601 [type="date"],

602 [type="month"],

603 [type="week"],

604 [type="time"],

605 [type="datetime-local"],

606 [type="number"],

607 [type="range"]

608 ):is(

609 [min],

610 [max]

611 )

612 ''',

613 FLG_PSEUDO | FLG_HTML | FLG_OUT_OF_RANGE

614)

615# CSS pattern for :open

616CSS_OPEN = CSSPattern('html|*:is(details, dialog)[open]', FLG_PSEUDO | FLG_HTML)

617# CSS pattern for :muted

618CSS_MUTED = CSSPattern('html|*:is(video, audio)[muted]', FLG_PSEUDO | FLG_HTML)

619# CSS pattern default for `:nth-child` "of S" feature

620CSS_NTH_OF_S_DEFAULT = CSSPattern("*|*", FLG_PSEUDO)

621

622

623class CSSParser:

624 """Parse CSS selectors."""

625

626 CSS_TOKENS = (

627 SelectorPattern("pseudo_close", PAT_PSEUDO_CLOSE),

628 SpecialPseudoPattern(

629 (

630 (

631 "pseudo_contains",

632 (':contains', ':-soup-contains', ':-soup-contains-own'),

633 PAT_PSEUDO_CONTAINS,

634 SelectorPattern

635 ),

636 ("pseudo_nth_child", (':nth-child', ':nth-last-child'), PAT_PSEUDO_NTH_CHILD, SelectorPattern),

637 ("pseudo_nth_type", (':nth-of-type', ':nth-last-of-type'), PAT_PSEUDO_NTH_TYPE, SelectorPattern),

638 ("pseudo_lang", (':lang',), PAT_PSEUDO_LANG, SelectorPattern),

639 ("pseudo_dir", (':dir',), PAT_PSEUDO_DIR, SelectorPattern)

640 )

641 ),

642 SelectorPattern("pseudo_class_custom", PAT_PSEUDO_CLASS_CUSTOM),

643 SelectorPattern("pseudo_class", PAT_PSEUDO_CLASS),

644 SelectorPattern("pseudo_element", PAT_PSEUDO_ELEMENT),

645 SelectorPattern("amp", PAT_AMP),

646 SelectorPattern("at_rule", PAT_AT_RULE),

647 SelectorPattern("id", PAT_ID),

648 SelectorPattern("class", PAT_CLASS),

649 SelectorPattern("tag", PAT_TAG),

650 SelectorPattern("attribute", PAT_ATTR),

651 SelectorPattern("combine", PAT_COMBINE)

652 )

653

654 # Pseudos that expand to selectors

655 PSEUDO_SELECTORS = PseudoSelectorMap(

656 {

657 ':link': CSS_LINK,

658 ':any-link': CSS_LINK,

659 ':checked': CSS_CHECKED,

660 ':default': CSS_DEFAULT,

661 ':indeterminate': CSS_INDETERMINATE,

662 ':disabled': CSS_DISABLED,

663 ':enabled': CSS_ENABLED,

664 ':required': CSS_REQUIRED,

665 ':muted': CSS_MUTED,

666 ':open': CSS_OPEN,

667 ':optional': CSS_OPTIONAL,

668 ':read-only': CSS_READ_ONLY,

669 ':read-write': CSS_READ_WRITE,

670 ':in-range': CSS_IN_RANGE,

671 ':out-of-range': CSS_OUT_OF_RANGE,

672 ':placeholder-shown': CSS_PLACEHOLDER_SHOWN,

673 '<nth-of-s>': CSS_NTH_OF_S_DEFAULT

674 }

675 )

676

677 def __init__(

678 self,

679 selector: str,

680 custom: dict[str, str | ct.SelectorList] | None = None,

681 flags: int = 0

682 ) -> None:

683 """Initialize."""

684

685 self.pattern = selector.replace('\x00', '\ufffd')

686 self.flags = flags

687 self.debug = self.flags & util.DEBUG

688 self.custom = {} if custom is None else custom

689 self.count = 0

690

691 def check_count(self) -> None:

692 """Check the current selector count."""

693

694 if self.count > SELECTOR_LIMIT:

695 raise ValueError(f'Selector exceeds pseudo-class nesting limit of {SELECTOR_LIMIT}')

696

697 def parse_attribute_selector(self, sel: _Selector, m: Match[str], has_selector: bool) -> bool:

698 """Create attribute selector from the returned regex match."""

699

700 inverse = False

701 op = m.group('cmp')

702 case = util.lower(m.group('case')) if m.group('case') else None

703 ns = css_unescape(m.group('attr_ns')[:-1]) if m.group('attr_ns') else ''

704 attr = css_unescape(m.group('attr_name'))

705 is_type = False

706 pattern2 = None

707 value = ''

708

709 if case:

710 flags = (re.I if case == 'i' else 0) | re.DOTALL

711 elif util.lower(attr) == 'type':

712 flags = re.I | re.DOTALL

713 is_type = True

714 else:

715 flags = re.DOTALL

716

717 if op:

718 if m.group('value').startswith(('"', "'")):

719 value = css_unescape(m.group('value')[1:-1], True)

720 else:

721 value = css_unescape(m.group('value'))

722

723 if not op:

724 # Attribute name

725 pattern = None

726 elif op.startswith('^'):

727 # Value start with

728 # `^=` should match nothing if the value is empty, so use `(?!)` which cannot be matched.

729 value = r'(?!)' if not value else re.escape(value)

730 pattern = re.compile(r'^%s.*' % value, flags)

731 elif op.startswith('$'):

732 # Value ends with

733 # `$=` should match nothing if the value is empty, so use `(?!)` which cannot be matched.

734 value = r'(?!)' if not value else re.escape(value)

735 pattern = re.compile(r'.*?%s$' % value, flags)

736 elif op.startswith('*'):

737 # Value contains

738 # `*=` should match nothing if the value is empty, so use `(?!)` which cannot be matched.

739 value = r'(?!)' if not value else re.escape(value)

740 pattern = re.compile(r'.*?%s.*' % value, flags)

741 elif op.startswith('~'):

742 # Value contains word within space separated list

743 # `*~` should match nothing if the value is empty, so use `(?!)` which cannot be matched.

744 value = r'(?!)' if not value or RE_WS.search(value) else re.escape(value)

745 pattern = re.compile(r'.*?(?:(?<=^)|(?<=[ \t\r\n\f]))%s(?=(?:[ \t\r\n\f]|$)).*' % value, flags)

746 elif op.startswith('|'):

747 # Value starts with word in dash separated list

748 pattern = re.compile(r'^%s(?:-.*)?$' % re.escape(value), flags)

749 else:

750 # Value matches

751 pattern = re.compile(r'^%s$' % re.escape(value), flags)

752 if op.startswith('!'):

753 # Equivalent to `:not([attr=value])`

754 inverse = True

755 if is_type and pattern:

756 pattern2 = re.compile(pattern.pattern)

757

758 # Append the attribute selector

759 sel_attr = ct.SelectorAttribute(attr, ns, pattern, pattern2)

760 if inverse:

761 # If we are using `!=`, we need to nest the pattern under a `:not()`.

762 sub_sel = _Selector()

763 sub_sel.attributes.append(sel_attr)

764 not_list = ct.SelectorList([sub_sel.freeze()], True, False)

765 sel.selectors.append(not_list)

766 else:

767 sel.attributes.append(sel_attr)

768

769 has_selector = True

770 return has_selector

771

772 def parse_tag_pattern(self, sel: _Selector, m: Match[str], has_selector: bool) -> bool:

773 """Parse tag pattern from regex match."""

774

775 prefix = css_unescape(m.group('tag_ns')[:-1]) if m.group('tag_ns') else None

776 tag = css_unescape(m.group('tag_name'))

777 sel.tag = ct.SelectorTag(tag, prefix)

778 has_selector = True

779 return has_selector

780

781 def parse_pseudo_class_custom(self, sel: _Selector, m: Match[str], has_selector: bool) -> bool:

782 """

783 Parse custom pseudo class alias.

784

785 Compile custom selectors as we need them. When compiling a custom selector,

786 set it to `None` in the dictionary so we can avoid an infinite loop.

787 """

788

789 pseudo = util.lower(css_unescape(m.group('name')))

790 selector = self.custom.get(pseudo)

791 if selector is None:

792 raise SelectorSyntaxError(

793 f"Undefined custom selector '{pseudo}' found at position {m.end(0)}",

794 self.pattern,

795 m.end(0)

796 )

797

798 if not isinstance(selector, ct.SelectorList):

799 del self.custom[pseudo]

800 selector = CSSParser(

801 selector, custom=self.custom, flags=self.flags

802 ).process_selectors(flags=FLG_PSEUDO)

803 self.custom[pseudo] = selector

804

805 self.count += selector.count

806 self.check_count()

807

808 sel.selectors.append(selector)

809 has_selector = True

810 return has_selector

811

812 def parse_pseudo_class(

813 self,

814 sel: _Selector,

815 m: Match[str],

816 has_selector: bool,

817 iselector: Iterator[tuple[str, Match[str]]],

818 is_html: bool

819 ) -> tuple[bool, bool]:

820 """Parse pseudo class."""

821

822 complex_pseudo = False

823 pseudo = util.lower(css_unescape(m.group('name')))

824 if m.group('open'):

825 complex_pseudo = True

826 if complex_pseudo and pseudo in PSEUDO_COMPLEX:

827 has_selector = self.parse_pseudo_open(sel, pseudo, has_selector, iselector, m.end(0))

828 elif not complex_pseudo and pseudo in PSEUDO_SIMPLE:

829 if pseudo == ':root':

830 sel.flags |= ct.SEL_ROOT

831 elif pseudo == ':defined':

832 sel.flags |= ct.SEL_DEFINED

833 is_html = True

834 elif pseudo == ':scope':

835 sel.flags |= ct.SEL_SCOPE

836 elif pseudo == ':empty':

837 sel.flags |= ct.SEL_EMPTY

838 elif pseudo in self.PSEUDO_SELECTORS:

839 pseudo_selector = self.PSEUDO_SELECTORS[pseudo]

840 self.count += pseudo_selector.count

841 self.check_count()

842 sel.selectors.append(pseudo_selector)

843 elif pseudo == ':first-child':

844 sel.nth.append(ct.SelectorNth(1, False, 0, False, False, ct.SelectorList()))

845 elif pseudo == ':last-child':

846 sel.nth.append(ct.SelectorNth(1, False, 0, False, True, ct.SelectorList()))

847 elif pseudo == ':first-of-type':

848 sel.nth.append(ct.SelectorNth(1, False, 0, True, False, ct.SelectorList()))

849 elif pseudo == ':last-of-type':

850 sel.nth.append(ct.SelectorNth(1, False, 0, True, True, ct.SelectorList()))

851 elif pseudo == ':only-child':

852 sel.nth.extend(

853 [

854 ct.SelectorNth(1, False, 0, False, False, ct.SelectorList()),

855 ct.SelectorNth(1, False, 0, False, True, ct.SelectorList())

856 ]

857 )

858 elif pseudo == ':only-of-type':

859 sel.nth.extend(

860 [

861 ct.SelectorNth(1, False, 0, True, False, ct.SelectorList()),

862 ct.SelectorNth(1, False, 0, True, True, ct.SelectorList())

863 ]

864 )

865 has_selector = True

866 elif complex_pseudo and pseudo in PSEUDO_COMPLEX_NO_MATCH:

867 self.parse_selectors(iselector, m.end(0), FLG_PSEUDO | FLG_OPEN)

868 sel.no_match = True

869 has_selector = True

870 elif not complex_pseudo and pseudo in PSEUDO_SIMPLE_NO_MATCH:

871 sel.no_match = True

872 has_selector = True

873 elif pseudo in PSEUDO_SUPPORTED:

874 raise SelectorSyntaxError(

875 f"Invalid syntax for pseudo class '{pseudo}'",

876 self.pattern,

877 m.start(0)

878 )

879 else:

880 raise SelectorSyntaxError(

881 f"'{pseudo}' was detected as a pseudo-class and is either unsupported or invalid. "

882 "If the syntax was not intended to be recognized as a pseudo-class, please escape the colon.",

883 self.pattern,

884 m.start(0)

885 )

886

887 return has_selector, is_html

888

889 def parse_pseudo_nth(

890 self,

891 sel: _Selector,

892 m: Match[str],

893 has_selector: bool,

894 iselector: Iterator[tuple[str, Match[str]]]

895 ) -> bool:

896 """Parse `nth` pseudo."""

897

898 mdict = m.groupdict()

899 if mdict.get('pseudo_nth_child'):

900 postfix = '_child'

901 else:

902 postfix = '_type'

903 mdict['name'] = util.lower(css_unescape(mdict['name']))

904 content = util.lower(mdict.get('nth' + postfix))

905 if content == 'even':

906 # 2n

907 s1 = 2

908 s2 = 0

909 var = True

910 elif content == 'odd':

911 # 2n+1

912 s1 = 2

913 s2 = 1

914 var = True

915 else:

916 nth_parts = cast(Match[str], RE_NTH.match(content))

917 _s1 = '-' if nth_parts.group('s1') and nth_parts.group('s1') == '-' else ''

918 a = nth_parts.group('a')

919 var = a.endswith('n')

920 if a.startswith('n'):

921 _s1 += '1'

922 elif var:

923 _s1 += a[:-1]

924 else:

925 _s1 += a

926 _s2 = '-' if nth_parts.group('s2') and nth_parts.group('s2') == '-' else ''

927 if nth_parts.group('b'):

928 _s2 += nth_parts.group('b')

929 else:

930 _s2 = '0'

931 s1 = int(_s1, 10)

932 s2 = int(_s2, 10)

933

934 pseudo_sel = mdict['name']

935 if postfix == '_child':

936 if m.group('of'):

937 # Parse the rest of `of S`.

938 nth_sel = self.parse_selectors(iselector, m.end(0), FLG_PSEUDO | FLG_OPEN)

939 else:

940 # Use default `*|*` for `of S`.

941 nth_sel = self.PSEUDO_SELECTORS['<nth-of-s>']

942 self.count += nth_sel.count

943 self.check_count()

944 if pseudo_sel == ':nth-child':

945 sel.nth.append(ct.SelectorNth(s1, var, s2, False, False, nth_sel))

946 elif pseudo_sel == ':nth-last-child':

947 sel.nth.append(ct.SelectorNth(s1, var, s2, False, True, nth_sel))

948 else:

949 if pseudo_sel == ':nth-of-type':

950 sel.nth.append(ct.SelectorNth(s1, var, s2, True, False, ct.SelectorList()))

951 elif pseudo_sel == ':nth-last-of-type':

952 sel.nth.append(ct.SelectorNth(s1, var, s2, True, True, ct.SelectorList()))

953 has_selector = True

954 return has_selector

955

956 def parse_pseudo_open(

957 self,

958 sel: _Selector,

959 name: str,

960 has_selector: bool,

961 iselector: Iterator[tuple[str, Match[str]]],

962 index: int

963 ) -> bool:

964 """Parse pseudo with opening bracket."""

965

966 flags = FLG_PSEUDO | FLG_OPEN

967 if name == ':not':

968 flags |= FLG_NOT

969 elif name == ':has':

970 flags |= FLG_RELATIVE

971 elif name in (':where', ':is'):

972 flags |= FLG_FORGIVE

973

974 sel.selectors.append(self.parse_selectors(iselector, index, flags))

975 has_selector = True

976

977 return has_selector

978

979 def parse_has_combinator(

980 self,

981 sel: _Selector,

982 m: Match[str],

983 has_selector: bool,

984 selectors: list[_Selector],

985 rel_type: str,

986 index: int

987 ) -> tuple[bool, _Selector, str]:

988 """Parse combinator tokens."""

989

990 combinator = m.group('relation').strip()

991 if not combinator:

992 combinator = WS_COMBINATOR

993 if combinator == COMMA_COMBINATOR:

994 sel.rel_type = rel_type

995 selectors[-1].relations.append(sel)

996 rel_type = ":" + WS_COMBINATOR

997 selectors.append(_Selector())

998 else:

999 if has_selector:

1000 # End the current selector and associate the leading combinator with this selector.

1001 sel.rel_type = rel_type

1002 selectors[-1].relations.append(sel)

1003 elif rel_type[1:] != WS_COMBINATOR:

1004 # It's impossible to have two whitespace combinators after each other as the patterns

1005 # will gobble up trailing whitespace. It is also impossible to have a whitespace

1006 # combinator after any other kind for the same reason. But we could have

1007 # multiple non-whitespace combinators. So if the current combinator is not a whitespace,

1008 # then we've hit the multiple combinator case, so we should fail.

1009 raise SelectorSyntaxError(

1010 f'The multiple combinators at position {index}',

1011 self.pattern,

1012 index

1013 )

1014

1015 # Set the leading combinator for the next selector.

1016 rel_type = ':' + combinator

1017

1018 sel = _Selector()

1019 has_selector = False

1020 return has_selector, sel, rel_type

1021

1022 def parse_combinator(

1023 self,

1024 sel: _Selector,

1025 m: Match[str],

1026 has_selector: bool,

1027 selectors: list[_Selector],

1028 relations: list[_Selector],

1029 is_pseudo: bool,

1030 is_forgive: bool,

1031 index: int

1032 ) -> tuple[bool, _Selector]:

1033 """Parse combinator tokens."""

1034

1035 combinator = m.group('relation').strip()

1036 if not combinator:

1037 combinator = WS_COMBINATOR

1038 if not has_selector:

1039 if not is_forgive or combinator != COMMA_COMBINATOR:

1040 raise SelectorSyntaxError(

1041 f"The combinator '{combinator}' at position {index}, must have a selector before it",

1042 self.pattern,

1043 index

1044 )

1045

1046 # If we are in a forgiving pseudo class, just make the selector a "no match"

1047 if combinator == COMMA_COMBINATOR:

1048 sel.no_match = True

1049 del relations[:]

1050 selectors.append(sel)

1051 else:

1052 if combinator == COMMA_COMBINATOR:

1053 if not sel.tag and not is_pseudo:

1054 # Implied `*`

1055 sel.tag = ct.SelectorTag('*', None)

1056 sel.relations.extend(relations)

1057 selectors.append(sel)

1058 del relations[:]

1059 else:

1060 sel.relations.extend(relations)

1061 sel.rel_type = combinator

1062 del relations[:]

1063 relations.append(sel)

1064

1065 sel = _Selector()

1066 has_selector = False

1067

1068 return has_selector, sel

1069

1070 def parse_class_id(self, sel: _Selector, m: Match[str], has_selector: bool) -> bool:

1071 """Parse HTML classes and ids."""

1072

1073 selector = m.group(0)

1074 if selector.startswith('.'):

1075 sel.classes.append(css_unescape(selector[1:]))

1076 else:

1077 sel.ids.append(css_unescape(selector[1:]))

1078 has_selector = True

1079 return has_selector

1080

1081 def parse_pseudo_contains(self, sel: _Selector, m: Match[str], has_selector: bool) -> bool:

1082 """Parse contains."""

1083

1084 pseudo = util.lower(css_unescape(m.group('name')))

1085 if pseudo == ":contains":

1086 warnings.warn( # noqa: B028

1087 "The pseudo class ':contains' is deprecated, ':-soup-contains' should be used moving forward.",

1088 FutureWarning

1089 )

1090 contains_own = pseudo == ":-soup-contains-own"

1091 values = css_unescape(m.group('values'))

1092 patterns = []

1093 for token in RE_VALUES.finditer(values):

1094 if token.group('split'):

1095 continue

1096 value = token.group('value')

1097 if value.startswith(("'", '"')):

1098 value = css_unescape(value[1:-1], True)

1099 else:

1100 value = css_unescape(value)

1101 patterns.append(value)

1102 sel.contains.append(ct.SelectorContains(patterns, contains_own))

1103 has_selector = True

1104 return has_selector

1105

1106 def parse_pseudo_lang(self, sel: _Selector, m: Match[str], has_selector: bool) -> bool:

1107 """Parse pseudo language."""

1108

1109 values = m.group('values')

1110 patterns = []

1111 for token in RE_VALUES.finditer(values):

1112 if token.group('split'):

1113 continue

1114 value = token.group('value')

1115 if value.startswith(('"', "'")):

1116 value = css_unescape(value[1:-1], True)

1117 else:

1118 value = css_unescape(value)

1119

1120 patterns.append(value)

1121

1122 sel.lang.append(ct.SelectorLang(patterns))

1123 has_selector = True

1124

1125 return has_selector

1126

1127 def parse_pseudo_dir(self, sel: _Selector, m: Match[str], has_selector: bool) -> bool:

1128 """Parse pseudo direction."""

1129

1130 value = ct.SEL_DIR_LTR if util.lower(m.group('dir')) == 'ltr' else ct.SEL_DIR_RTL

1131 sel.flags |= value

1132 has_selector = True

1133 return has_selector

1134

1135 def parse_selectors(

1136 self,

1137 iselector: Iterator[tuple[str, Match[str]]],

1138 index: int = 0,

1139 flags: int = 0

1140 ) -> ct.SelectorList:

1141 """Parse selectors."""

1142

1143 # Initialize important variables

1144 sel = _Selector()

1145 selectors = []

1146 has_selector = False

1147 closed = False

1148 relations = [] # type: list[_Selector]

1149 rel_type = ":" + WS_COMBINATOR

1150 count = self.count

1151

1152 # Setup various flags

1153 is_open = bool(flags & FLG_OPEN)

1154 is_pseudo = bool(flags & FLG_PSEUDO)

1155 is_relative = bool(flags & FLG_RELATIVE)

1156 is_not = bool(flags & FLG_NOT)

1157 is_html = bool(flags & FLG_HTML)

1158 is_default = bool(flags & FLG_DEFAULT)

1159 is_indeterminate = bool(flags & FLG_INDETERMINATE)

1160 is_in_range = bool(flags & FLG_IN_RANGE)

1161 is_out_of_range = bool(flags & FLG_OUT_OF_RANGE)

1162 is_placeholder_shown = bool(flags & FLG_PLACEHOLDER_SHOWN)

1163 is_forgive = bool(flags & FLG_FORGIVE)

1164

1165 # Print out useful debug stuff

1166 if self.debug: # pragma: no cover

1167 if is_pseudo:

1168 print(' is_pseudo: True')

1169 if is_open:

1170 print(' is_open: True')

1171 if is_relative:

1172 print(' is_relative: True')

1173 if is_not:

1174 print(' is_not: True')

1175 if is_html:

1176 print(' is_html: True')

1177 if is_default:

1178 print(' is_default: True')

1179 if is_indeterminate:

1180 print(' is_indeterminate: True')

1181 if is_in_range:

1182 print(' is_in_range: True')

1183 if is_out_of_range:

1184 print(' is_out_of_range: True')

1185 if is_placeholder_shown:

1186 print(' is_placeholder_shown: True')

1187 if is_forgive:

1188 print(' is_forgive: True')

1189

1190 # The algorithm for relative selectors require an initial selector in the selector list

1191 if is_relative:

1192 selectors.append(_Selector())

1193

1194 try:

1195 while True:

1196 key, m = next(iselector)

1197

1198 if key not in ('combine', 'pseudo_close'):

1199 self.count += 1

1200 self.check_count()

1201

1202 # Handle parts

1203 if key == "at_rule":

1204 raise NotImplementedError(f"At-rules found at position {m.start(0)}")

1205 elif key == "amp":

1206 sel.flags |= ct.SEL_SCOPE

1207 has_selector = True

1208 elif key == 'pseudo_class_custom':

1209 has_selector = self.parse_pseudo_class_custom(sel, m, has_selector)

1210 elif key == 'pseudo_class':

1211 has_selector, is_html = self.parse_pseudo_class(sel, m, has_selector, iselector, is_html)

1212 elif key == 'pseudo_element':

1213 raise NotImplementedError(f"Pseudo-element found at position {m.start(0)}")

1214 elif key == 'pseudo_contains':

1215 has_selector = self.parse_pseudo_contains(sel, m, has_selector)

1216 elif key in ('pseudo_nth_type', 'pseudo_nth_child'):

1217 has_selector = self.parse_pseudo_nth(sel, m, has_selector, iselector)

1218 elif key == 'pseudo_lang':

1219 has_selector = self.parse_pseudo_lang(sel, m, has_selector)

1220 elif key == 'pseudo_dir':

1221 has_selector = self.parse_pseudo_dir(sel, m, has_selector)

1222 # Currently only supports HTML

1223 is_html = True

1224 elif key == 'pseudo_close':

1225 if not has_selector:

1226 if not is_forgive:

1227 raise SelectorSyntaxError(

1228 f"Expected a selector at position {m.start(0)}",

1229 self.pattern,

1230 m.start(0)

1231 )

1232 sel.no_match = True

1233 if is_open:

1234 closed = True

1235 break

1236 else:

1237 raise SelectorSyntaxError(

1238 f"Unmatched pseudo-class close at position {m.start(0)}",

1239 self.pattern,

1240 m.start(0)

1241 )

1242 elif key == 'combine':

1243 if is_relative:

1244 has_selector, sel, rel_type = self.parse_has_combinator(

1245 sel, m, has_selector, selectors, rel_type, index

1246 )

1247 else:

1248 has_selector, sel = self.parse_combinator(

1249 sel, m, has_selector, selectors, relations, is_pseudo, is_forgive, index

1250 )

1251 elif key == 'attribute':

1252 has_selector = self.parse_attribute_selector(sel, m, has_selector)

1253 elif key == 'tag':

1254 if has_selector:

1255 raise SelectorSyntaxError(

1256 f"Tag name found at position {m.start(0)} instead of at the start",

1257 self.pattern,

1258 m.start(0)

1259 )

1260 has_selector = self.parse_tag_pattern(sel, m, has_selector)

1261 elif key in ('class', 'id'):

1262 has_selector = self.parse_class_id(sel, m, has_selector)

1263

1264 index = m.end(0)

1265 except StopIteration:

1266 pass

1267

1268 # Handle selectors that are not closed

1269 if is_open and not closed:

1270 raise SelectorSyntaxError(

1271 f"Unclosed pseudo-class at position {index}",

1272 self.pattern,

1273 index

1274 )

1275

1276 # Cleanup completed selector piece

1277 if has_selector:

1278 if not sel.tag and not is_pseudo:

1279 # Implied `*`

1280 sel.tag = ct.SelectorTag('*', None)

1281 if is_relative:

1282 sel.rel_type = rel_type

1283 selectors[-1].relations.append(sel)

1284 else:

1285 sel.relations.extend(relations)

1286 del relations[:]

1287 selectors.append(sel)

1288

1289 # Forgive empty slots in pseudo-classes that have lists (and are forgiving)

1290 elif is_forgive and (not selectors or not relations):

1291 # Handle normal pseudo-classes with empty slots like `:is()` etc.

1292 sel.no_match = True

1293 del relations[:]

1294 selectors.append(sel)

1295 has_selector = True

1296

1297 if not has_selector:

1298 # We will always need to finish a selector when `:has()` is used as it leads with combining.

1299 # May apply to others as well.

1300 raise SelectorSyntaxError(

1301 f'Expected a selector at position {index}',

1302 self.pattern,

1303 index

1304 )

1305

1306 # Some patterns require additional logic, such as default. We try to make these the

1307 # last pattern, and append the appropriate flag to that selector which communicates

1308 # to the matcher what additional logic is required.

1309 if is_default:

1310 selectors[-1].flags = ct.SEL_DEFAULT

1311 if is_indeterminate:

1312 selectors[-1].flags = ct.SEL_INDETERMINATE

1313 if is_in_range:

1314 selectors[-1].flags = ct.SEL_IN_RANGE

1315 if is_out_of_range:

1316 selectors[-1].flags = ct.SEL_OUT_OF_RANGE

1317 if is_placeholder_shown:

1318 selectors[-1].flags = ct.SEL_PLACEHOLDER_SHOWN

1319

1320 # Return selector list

1321 return ct.SelectorList([s.freeze() for s in selectors], is_not, is_html, self.count - count)

1322

1323 def selector_iter(self, pattern: str) -> Iterator[tuple[str, Match[str]]]:

1324 """Iterate selector tokens."""

1325

1326 # Ignore whitespace and comments at start and end of pattern

1327 m = RE_WS_BEGIN.search(pattern)

1328 index = m.end(0) if m else 0

1329 m = RE_WS_END.search(pattern[::-1])

1330 offset = m.end(0) if m else 0

1331 end = len(pattern) - (1 + offset)

1332

1333 if self.debug: # pragma: no cover

1334 print(f'## PARSING: {pattern!r}')

1335 while index <= end:

1336 m = None

1337 for v in self.CSS_TOKENS:

1338 m = v.match(pattern, index, self.flags)

1339 if m:

1340 name = v.get_name()

1341 if self.debug: # pragma: no cover

1342 print(f"TOKEN: '{name}' --> {m.group(0)!r} at position {m.start(0)}")

1343 index = m.end(0)

1344 yield name, m

1345 break

1346 if m is None:

1347 c = pattern[index]

1348 # If the character represents the start of one of the known selector types,

1349 # throw an exception mentioning that the known selector type is in error;

1350 # otherwise, report the invalid character.

1351 if c == '[':

1352 msg = f"Malformed attribute selector at position {index}"

1353 elif c == '.':

1354 msg = f"Malformed class selector at position {index}"

1355 elif c == '#':

1356 msg = f"Malformed id selector at position {index}"

1357 elif c == ':':

1358 msg = f"Malformed pseudo-class selector at position {index}"

1359 else:

1360 msg = f"Invalid character {c!r} position {index}"

1361 raise SelectorSyntaxError(msg, self.pattern, index)

1362 if self.debug: # pragma: no cover

1363 print('## END PARSING')

1364

1365 def process_selectors(self, index: int = 0, flags: int = 0) -> ct.SelectorList:

1366 """Process selectors."""

1367

1368 return self.parse_selectors(self.selector_iter(self.pattern), index, flags)

Coverage for /pythoncovmergedfiles/medio/medio/usr/local/lib/python3.11/site-packages/soupsieve/css_parser.py: 24%

614 statements