Reference

Herein find documentation for the gory details of nominally.

API

nominally.api.parse_name(s: str) → Dict[str, Any]

Parse into Name, return core name attributes as a dict.

This is the simplest function interface to nominally.

nominally.api.cli(arguments: Optional[Sequence[str]] = None) → int

Simple CLI with a minimal set of options.

1. Report of a single name (parse into details).

2. Help via usage information. [help, -h, –help]

3. Version information. [-V, –version]

nominally.api.cli_help() → int

Output help for command line usage

nominally.api.cli_report(raw_name: str, details: bool = True) → int

Parse into Name, output (core or report) attributes.

nominally.api.cli_version() → int

Output version info and script location

Name

class nominally.parser.Name(raw: str = '')

A personal name, separated and simplified into component parts.

detail

classmethod clean(s: str, *, condense: bool = False, final: bool = False) → str

Clean this string to the simplest possible representation (but no simpler).

Note

Assumes that any nicknames have already been removed, along with anything else that would depend on special characters (other than commas).

static strip_pointlessness(s: str) → str

__eq__(other: Any) → bool

If Name is parsable and object dicts are identical, consider it equal.

__str__() → str

Output format: “last, title first middle suffix (nickname)”

• “organs, mr harry x, jr (snapper)”

• “organs, mr harry x, jr”

• “organs, mr harry x”

• “organs, harry x”

• “organs, harry”

• etc.

property parsable

Return true if any valid name values were created.

property raw

Return the original input string.

property cleaned

Return some set of cleaned string parts.

first

last

middle

nickname

report() → Dict[str, Any]

Return a more-or-less complete parsing dict.

suffix

title