1#!/usr/bin/env python3
2"""
3
4"""
5# Imports:
6from __future__ import annotations
7
8# ##-- stdlib imports
9import datetime
10import enum
11import functools as ftz
12import itertools as itz
13import logging as logmod
14import pathlib as pl
15import re
16import time
17import types
18import collections
19import contextlib
20import hashlib
21from copy import deepcopy
22from uuid import UUID, uuid1
23from weakref import ref
24import atexit # for @atexit.register
25import faulthandler
26# ##-- end stdlib imports
27
28# ##-- types
29# isort: off
30import abc
31import collections.abc
32from typing import TYPE_CHECKING, cast, assert_type, assert_never
33from typing import Generic, NewType
34# Protocols:
35from typing import Protocol, runtime_checkable
36# Typing Decorators:
37from typing import no_type_check, final, override, overload
38# from dataclasses import InitVar, dataclass, field
39# from pydantic import BaseModel, Field, model_validator, field_validator, ValidationError
40
41if TYPE_CHECKING:
42 from jgdv import Maybe
43 from typing import Final
44 from typing import ClassVar, Any, LiteralString
45 from typing import Never, Self, Literal
46 from typing import TypeGuard
47 from collections.abc import Iterable, Iterator, Callable, Generator
48 from collections.abc import Sequence, Mapping, MutableMapping, Hashable
49
50##--|
51
52# isort: on
53# ##-- end types
54
55##-- logging
56logging = logmod.getLogger(__name__)
57##-- end logging
58
59# Vars:
60OBRACE : Final[str] = "{"
61CBRACE : Final[str] = "}"
62AUTHOR_K : Final[str] = "author"
63EDITOR_K : Final[str] = "editor"
64JOIN_STR : Final[str] = " and "
65
66NAME_WHITESPACE : Final[set] = set(" ~\r\n\t")
67
68# Body:
69
[docs]
70class NameSplitState_e(enum.IntEnum):
71 start_ws = enum.auto()
72 end_ws = enum.auto()
73 find_a = enum.auto()
74 find_n = enum.auto()
75 find_d = enum.auto()
76 next_word = enum.auto()