cgreet 0.2.1__tar.gz

cgreet-0.2.1/.gitignore

@@ -0,0 +1,10 @@
+/target/
+node_modules/
+
+# Generated release outputs
+**/dist/
+**/LICENSES/
+!LICENSES/
+*.tgz
+__pycache__/
+*.egg-info/

cgreet-0.2.1/LICENSES/Apache-2.0.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

cgreet-0.2.1/LICENSES/MIT.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Julian Y. Richard Corbet
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cgreet-0.2.1/PKG-INFO

@@ -0,0 +1,116 @@
+Metadata-Version: 2.5
+Name: cgreet
+Version: 0.2.1
+Summary: Deterministic locale-correct greeting and salutation helpers. No models, no I/O: same input always yields the same output
+Project-URL: Homepage, https://github.com/corbet-labs/cgreet#readme
+Project-URL: Repository, https://github.com/corbet-labs/cgreet
+Project-URL: Issues, https://github.com/corbet-labs/cgreet/issues
+License-Expression: MIT OR Apache-2.0
+License-File: LICENSES/Apache-2.0.txt
+License-File: LICENSES/MIT.txt
+Keywords: correspondence,i18n,locale
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# cgreet
+
+**German salutations with the right titles and punctuation.**
+
+> **Release status:** 0.2.1 is being prepared. npm and Cargo currently publish 0.2.0. The compiled CommonJS/browser exports and Python/Typst release artifacts described below require the new release.
+
+[![crates.io](https://img.shields.io/crates/v/cgreet.svg)](https://crates.io/crates/cgreet) [![npm](https://img.shields.io/npm/v/@corbet-labs/cgreet.svg)](https://www.npmjs.com/package/@corbet-labs/cgreet) [![Rust API](https://docs.rs/cgreet/badge.svg)](https://docs.rs/cgreet) [![CI](https://github.com/corbet-labs/cgreet/actions/workflows/ci.yml/badge.svg)](https://github.com/corbet-labs/cgreet/actions/workflows/ci.yml)
+
+Turn an explicitly supplied honorific, academic titles, and surname into a formal salutation for Switzerland, Liechtenstein, Germany, or Austria. Deterministic rules, no model and no network calls.
+
+```js
+import { deSalutation } from '@corbet-labs/cgreet';
+
+deSalutation('Frau Dr. Müller', 'ch');
+// Sehr geehrte Frau Dr. Müller
+```
+
+## Install
+
+| Environment | Command |
+| --- | --- |
+| Rust / Cargo | `cargo add cgreet` |
+| Node.js / npm | `npm install @corbet-labs/cgreet` |
+| pnpm | `pnpm add @corbet-labs/cgreet` |
+| Yarn | `yarn add @corbet-labs/cgreet` |
+| Bun | `bun add @corbet-labs/cgreet` |
+| Deno | `deno add npm:@corbet-labs/cgreet` |
+
+The 0.2.1 JavaScript distribution includes compiled ESM, CommonJS,
+TypeScript declarations, and a standalone browser module. Node.js 20+ is
+supported; no TypeScript loader is required.
+
+```js
+// CommonJS
+const { deSalutation } = require('@corbet-labs/cgreet');
+```
+
+```html
+<script type="module">
+  import { deSalutation } from 'https://cdn.jsdelivr.net/npm/@corbet-labs/cgreet@0.2.1/dist/browser.js';
+  console.log(deSalutation('Frau Dr. Müller', 'ch'));
+</script>
+```
+
+Python wheels, source distributions, and CLI instructions are in the
+[installation guide](https://github.com/corbet-labs/cgreet/blob/main/docs/installation.md).
+JSR publication and Typst availability are listed there explicitly.
+
+## Rust
+
+```rust
+use cgreet::{de_salutation, Region};
+
+assert_eq!(de_salutation("Frau Dr. Müller", Region::Ch), "Sehr geehrte Frau Dr. Müller");
+```
+
+## Python
+
+```python
+from cgreet import de_salutation
+
+assert de_salutation("Frau Dr. Müller", "ch") == 'Sehr geehrte Frau Dr. Müller'
+```
+
+## API
+
+| Function | Purpose |
+| --- | --- |
+| `deSalutation` / `de_salutation` | Complete German salutation |
+| `salutationHonorific`, `salutationTitles`, `salutationSurname` | Parse explicitly supplied recipient details |
+| `parseRegion` / `parse_region` | Accept `ch`, `li`, `de`, or `at` |
+| `recipientSalutationWarning`, `deHonorificWarning` | Report incomplete input |
+
+Region codes are lowercase. German and Austrian salutations end with a comma; Swiss and Liechtenstein salutations do not. A recognized Professor title takes precedence over Dr. Missing honorifics or surnames produce the generic greeting. The library does not infer a person’s gender from their name.
+
+## Correspondence family
+
+| Library | Responsibility |
+| --- | --- |
+| [cletter](https://github.com/corbet-labs/cletter) | Compose the correspondence helpers |
+| [cgreet](https://github.com/corbet-labs/cgreet) | German salutations and titles |
+| [cfarewell](https://github.com/corbet-labs/cfarewell) | Locale-specific closings |
+| [cdate](https://github.com/corbet-labs/cdate) | Calendar-date formatting |
+| [cink](https://github.com/corbet-labs/cink) | Handwritten signature images |
+
+
+## Development
+
+Behavior is defined by [the locale tables](https://github.com/corbet-labs/cgreet/tree/main/tables)
+and [shared conformance vectors](https://github.com/corbet-labs/cgreet/tree/main/tests/vectors).
+Rust, JavaScript, and Python run the same vectors. CI also exercises installed
+JavaScript tarballs across package managers and operating systems, and tests
+Python wheels outside their source package.
+
+See [the release guide](https://github.com/corbet-labs/cgreet/blob/main/docs/releasing.md)
+for generation, verification, and publication commands.
+
+## License
+
+MIT OR Apache-2.0, at your option. Earlier releases through v0.1.0 retain their original FSL-1.1-ALv2 terms. See [LICENSES](https://github.com/corbet-labs/cgreet/tree/main/LICENSES).

cgreet-0.2.1/README.md

@@ -0,0 +1,100 @@
+# cgreet
+
+**German salutations with the right titles and punctuation.**
+
+> **Release status:** 0.2.1 is being prepared. npm and Cargo currently publish 0.2.0. The compiled CommonJS/browser exports and Python/Typst release artifacts described below require the new release.
+
+[![crates.io](https://img.shields.io/crates/v/cgreet.svg)](https://crates.io/crates/cgreet) [![npm](https://img.shields.io/npm/v/@corbet-labs/cgreet.svg)](https://www.npmjs.com/package/@corbet-labs/cgreet) [![Rust API](https://docs.rs/cgreet/badge.svg)](https://docs.rs/cgreet) [![CI](https://github.com/corbet-labs/cgreet/actions/workflows/ci.yml/badge.svg)](https://github.com/corbet-labs/cgreet/actions/workflows/ci.yml)
+
+Turn an explicitly supplied honorific, academic titles, and surname into a formal salutation for Switzerland, Liechtenstein, Germany, or Austria. Deterministic rules, no model and no network calls.
+
+```js
+import { deSalutation } from '@corbet-labs/cgreet';
+
+deSalutation('Frau Dr. Müller', 'ch');
+// Sehr geehrte Frau Dr. Müller
+```
+
+## Install
+
+| Environment | Command |
+| --- | --- |
+| Rust / Cargo | `cargo add cgreet` |
+| Node.js / npm | `npm install @corbet-labs/cgreet` |
+| pnpm | `pnpm add @corbet-labs/cgreet` |
+| Yarn | `yarn add @corbet-labs/cgreet` |
+| Bun | `bun add @corbet-labs/cgreet` |
+| Deno | `deno add npm:@corbet-labs/cgreet` |
+
+The 0.2.1 JavaScript distribution includes compiled ESM, CommonJS,
+TypeScript declarations, and a standalone browser module. Node.js 20+ is
+supported; no TypeScript loader is required.
+
+```js
+// CommonJS
+const { deSalutation } = require('@corbet-labs/cgreet');
+```
+
+```html
+<script type="module">
+  import { deSalutation } from 'https://cdn.jsdelivr.net/npm/@corbet-labs/cgreet@0.2.1/dist/browser.js';
+  console.log(deSalutation('Frau Dr. Müller', 'ch'));
+</script>
+```
+
+Python wheels, source distributions, and CLI instructions are in the
+[installation guide](https://github.com/corbet-labs/cgreet/blob/main/docs/installation.md).
+JSR publication and Typst availability are listed there explicitly.
+
+## Rust
+
+```rust
+use cgreet::{de_salutation, Region};
+
+assert_eq!(de_salutation("Frau Dr. Müller", Region::Ch), "Sehr geehrte Frau Dr. Müller");
+```
+
+## Python
+
+```python
+from cgreet import de_salutation
+
+assert de_salutation("Frau Dr. Müller", "ch") == 'Sehr geehrte Frau Dr. Müller'
+```
+
+## API
+
+| Function | Purpose |
+| --- | --- |
+| `deSalutation` / `de_salutation` | Complete German salutation |
+| `salutationHonorific`, `salutationTitles`, `salutationSurname` | Parse explicitly supplied recipient details |
+| `parseRegion` / `parse_region` | Accept `ch`, `li`, `de`, or `at` |
+| `recipientSalutationWarning`, `deHonorificWarning` | Report incomplete input |
+
+Region codes are lowercase. German and Austrian salutations end with a comma; Swiss and Liechtenstein salutations do not. A recognized Professor title takes precedence over Dr. Missing honorifics or surnames produce the generic greeting. The library does not infer a person’s gender from their name.
+
+## Correspondence family
+
+| Library | Responsibility |
+| --- | --- |
+| [cletter](https://github.com/corbet-labs/cletter) | Compose the correspondence helpers |
+| [cgreet](https://github.com/corbet-labs/cgreet) | German salutations and titles |
+| [cfarewell](https://github.com/corbet-labs/cfarewell) | Locale-specific closings |
+| [cdate](https://github.com/corbet-labs/cdate) | Calendar-date formatting |
+| [cink](https://github.com/corbet-labs/cink) | Handwritten signature images |
+
+
+## Development
+
+Behavior is defined by [the locale tables](https://github.com/corbet-labs/cgreet/tree/main/tables)
+and [shared conformance vectors](https://github.com/corbet-labs/cgreet/tree/main/tests/vectors).
+Rust, JavaScript, and Python run the same vectors. CI also exercises installed
+JavaScript tarballs across package managers and operating systems, and tests
+Python wheels outside their source package.
+
+See [the release guide](https://github.com/corbet-labs/cgreet/blob/main/docs/releasing.md)
+for generation, verification, and publication commands.
+
+## License
+
+MIT OR Apache-2.0, at your option. Earlier releases through v0.1.0 retain their original FSL-1.1-ALv2 terms. See [LICENSES](https://github.com/corbet-labs/cgreet/tree/main/LICENSES).

cgreet-0.2.1/cgreet/__init__.py

@@ -0,0 +1,91 @@
+"""German salutations for Switzerland, Liechtenstein, Germany, and Austria."""
+
+import re
+from typing import Literal
+
+from ._tables import TABLES
+
+Region = Literal["ch", "li", "de", "at"]
+_DE = TABLES["de"]
+_WS = re.compile(r"[\u0009-\u000d\u0020\u0085\u00a0\u1680\u2000-\u200a\u2028\u2029\u202f\u205f\u3000]+")
+_ASCII_LOWER = str.maketrans("ABCDEFGHIJKLMNOPQRSTUVWXYZ", "abcdefghijklmnopqrstuvwxyz")
+
+__all__ = ["parse_region", "region_uses_comma", "salutation_last_name",
+           "salutation_honorific", "salutation_titles", "salutation_surname",
+           "de_salutation", "recipient_salutation_warning", "de_honorific_warning"]
+
+
+def _tokens(name: str) -> list[str]:
+    return [token for token in _WS.split(name) if token]
+
+
+def _norm(token: str) -> str:
+    return token.strip(".").translate(_ASCII_LOWER)
+
+
+def parse_region(code: str) -> Region | None:
+    """Accept only the four lowercase region codes."""
+    return code if code in ("ch", "li", "de", "at") else None
+
+
+def region_uses_comma(region: Region) -> bool:
+    """Whether a German salutation ends with a comma."""
+    return region in _DE["comma_regions"]
+
+
+def salutation_last_name(name: str) -> str:
+    """Last whitespace-separated token, or an empty string."""
+    tokens = _tokens(name)
+    return tokens[-1] if tokens else ""
+
+
+def salutation_honorific(name: str) -> str:
+    """Explicit Herr/Herrn or Frau; never infer an honorific from a name."""
+    tokens = _tokens(name)
+    return _DE["honorifics"].get(_norm(tokens[0]), "") if tokens else ""
+
+
+def salutation_titles(name: str) -> list[str]:
+    """Keep recognized academic titles, with Professor taking precedence."""
+    kept = []
+    for token in _tokens(name):
+        title = _DE["titles"].get(_norm(token))
+        if title is not None and title not in kept:
+            kept.append(title)
+    for title in kept:
+        if title in _DE["sole_titles"]:
+            return [title]
+    return kept
+
+
+def salutation_surname(name: str) -> str:
+    """Last token after excluding honorifics, titles, and qualifications."""
+    return next((token for token in reversed(_tokens(name)) if _norm(token) not in _DE["filler"]), "")
+
+
+def de_salutation(name: str, region: Region) -> str:
+    """Format a German salutation, using the generic address when incomplete."""
+    if parse_region(region) is None:
+        raise ValueError("region must be ch, li, de, or at")
+    punct = "," if region_uses_comma(region) else ""
+    honorific, surname = salutation_honorific(name), salutation_surname(name)
+    if not honorific or not surname:
+        return _DE["generic"] + punct
+    titles = salutation_titles(name)
+    title_part = " " + " ".join(titles) if titles else ""
+    address = "Sehr geehrte Frau" if honorific == "frau" else "Sehr geehrter Herr"
+    return f"{address}{title_part} {surname}{punct}"
+
+
+def recipient_salutation_warning(location: str, name: str) -> str | None:
+    """Advisory for an empty recipient name."""
+    if salutation_last_name(name) == "":
+        return f"{location}: job.cl_recipient.name is empty; using generic salutation (provide a name for tailored opportunities)"
+    return None
+
+
+def de_honorific_warning(location: str, name: str) -> str | None:
+    """Advisory for a nonempty German name without a usable honorific."""
+    if salutation_last_name(name) and (not salutation_honorific(name) or not salutation_surname(name)):
+        return f'{location}: job.cl_recipient.name has no parsable Herr/Frau honorific; using generic salutation (provide e.g. "Frau Dr. Müller" for tailored opportunities)'
+    return None

cgreet-0.2.1/cgreet/__main__.py

@@ -0,0 +1,50 @@
+"""JSON command-line bridge for callers in any programming language."""
+import argparse
+import base64
+import dataclasses
+import json
+import sys
+import cgreet as api
+
+
+def _json_default(value):
+    if dataclasses.is_dataclass(value):
+        return dataclasses.asdict(value)
+    if isinstance(value, bytes):
+        return base64.b64encode(value).decode("ascii")
+    raise TypeError(f"Cannot serialize {type(value).__name__}")
+
+
+def _reject_constant(value):
+    raise ValueError(f"{value} is not a JSON number")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Call cgreet functions with JSON arguments.")
+    parser.add_argument("function", choices=api.__all__)
+    parser.add_argument("arguments", nargs="?", default="[]", help="JSON array of positional arguments or object of keyword arguments; '-' reads UTF-8 stdin")
+    args = parser.parse_args()
+    try:
+        values = json.loads(sys.stdin.buffer.read().decode("utf-8") if args.arguments == "-" else args.arguments, parse_constant=_reject_constant)
+        if not isinstance(values, (list, dict)):
+            raise ValueError("arguments must be a JSON array or object")
+        # Image operations accept the JSON object returned by normalize.
+        if args.function in ("exceeds_limits", "scale_to_fit", "signature_size"):
+            raw = values[0] if isinstance(values, list) else values["image"]
+            if isinstance(raw, dict):
+                raw = dict(raw)
+                raw["bytes"] = base64.b64decode(raw["bytes"], validate=True)
+                image = api.DecodedImage(**raw)
+                if isinstance(values, list):
+                    values[0] = image
+                else:
+                    values["image"] = image
+        fn = getattr(api, args.function)
+        result = fn(*values) if isinstance(values, list) else fn(**values)
+        print(json.dumps(result, default=_json_default, ensure_ascii=True, allow_nan=False))
+    except (ValueError, TypeError, KeyError, IndexError, AttributeError, OverflowError) as error:
+        parser.error(str(error))
+
+
+if __name__ == "__main__":
+    main()

cgreet-0.2.1/cgreet/_tables.py

@@ -0,0 +1,38 @@
+# Generated by scripts/sync-python.py; edit tables/*.json instead.
+TABLES = {'de': {'locale': 'de',
+        'source_norms': 'SN 010130 for ch/li, DIN 5008 for de/at (at follows DIN since ÖNORM A '
+                        '1080 was withdrawn in 2018)',
+        'honorifics': {'frau': 'frau', 'herr': 'herr', 'herrn': 'herr'},
+        'titles': {'dr': 'Dr.',
+                   'prof': 'Professor',
+                   'professor': 'Professor',
+                   'dipl-ing': 'Dipl.-Ing.',
+                   'dipling': 'Dipl.-Ing.',
+                   'mag': 'Mag.',
+                   'magister': 'Mag.',
+                   'dipl.-ing': 'Dipl.-Ing.',
+                   'dipl.ing': 'Dipl.-Ing.'},
+        'sole_titles': ['Professor'],
+        'filler': ['herr',
+                   'herrn',
+                   'frau',
+                   'mr',
+                   'mrs',
+                   'ms',
+                   'miss',
+                   'dr',
+                   'prof',
+                   'professor',
+                   'dipl-ing',
+                   'dipling',
+                   'mag',
+                   'magister',
+                   'phd',
+                   'ma',
+                   'ba',
+                   'bsc',
+                   'msc',
+                   'dipl.-ing',
+                   'dipl.ing'],
+        'comma_regions': ['de', 'at'],
+        'generic': 'Sehr geehrte Damen und Herren'}}

cgreet-0.2.1/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["hatchling>=1.27,<2"]
+build-backend = "hatchling.build"
+
+[project]
+name = "cgreet"
+version = "0.2.1"
+description = "Deterministic locale-correct greeting and salutation helpers. No models, no I/O: same input always yields the same output"
+readme = "README.md"
+license = "MIT OR Apache-2.0"
+license-files = ["LICENSES/*"]
+requires-python = ">=3.10"
+keywords = ["i18n", "correspondence", "locale"]
+classifiers = ["Programming Language :: Python :: 3", "Operating System :: OS Independent"]
+
+
+[project.urls]
+Homepage = "https://github.com/corbet-labs/cgreet#readme"
+Repository = "https://github.com/corbet-labs/cgreet"
+Issues = "https://github.com/corbet-labs/cgreet/issues"
+
+[project.scripts]
+cgreet = "cgreet.__main__:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["cgreet"]

cgreet-0.2.1/scripts/conformance.py

@@ -0,0 +1,56 @@
+"""Run canonical vectors against either the source port or an installed wheel."""
+import base64
+import importlib
+import json
+from pathlib import Path
+import sys
+
+ROOT = Path(__file__).resolve().parents[2]
+if "--installed" not in sys.argv:
+    sys.path.insert(0, str(ROOT / "py"))
+api = importlib.import_module("cgreet")
+
+ARGUMENTS = {
+    "region_parse": ["input"], "region_uses_comma": ["input"],
+    "salutation_last_name": ["input"], "salutation_honorific": ["input"],
+    "salutation_titles": ["input"], "salutation_surname": ["input"],
+    "de_salutation": ["input", "region"],
+    "recipient_salutation_warning": ["location", "input"],
+    "de_honorific_warning": ["location", "input"],
+    "closing": ["locale", "override"], "available_locales": [],
+    "long_date": ["locale", "year", "month", "day"],
+    "medium_date": ["locale", "year", "month", "day"],
+    "short_date": ["locale", "year", "month", "day"],
+    "month_year": ["locale", "year", "month"], "is_supported": ["locale"],
+    "supported_formats": [], "normalize": ["input"],
+    "exceeds_limits": ["image", "max_pixels"], "scale_to_fit": ["image", "max_pixels"],
+    "signature_size": ["image", "height_pt", "max_width_pt"],
+    "image_snippet": ["path", "height_pt", "width_pt"],
+    "resolve_locale": ["language", "location"],
+    "opening": ["locale", "person", "override"],
+    "subject": ["locale", "title", "prefix_override"],
+    "salutation": ["locale", "person"], "apply_ortho": ["locale", "text"],
+    "warnings": ["location", "locale", "person"],
+}
+
+files = sorted((ROOT / "tests/vectors").glob("*.json"))
+assert files, "No conformance vectors"
+count = 0
+for file in files:
+    for vector in json.loads(file.read_text(encoding="utf-8")):
+        name = vector["fn"]
+        values = dict(vector)
+        if "fixture" in vector:
+            values["input"] = base64.b64encode((ROOT / "tests/fixtures" / vector["fixture"]).read_bytes()).decode("ascii")
+            if name != "normalize":
+                values["image"] = api.normalize(values["input"])
+        fn = getattr(api, "parse_region" if name == "region_parse" else name)
+        actual = fn(*(values.get(key) for key in ARGUMENTS[name]))
+        if name == "normalize" and actual is not None:
+            actual = {key: getattr(actual, key) for key in ("mime", "width", "height")}
+        if isinstance(actual, tuple):
+            actual = list(actual)
+        if actual != vector["expected"]:
+            raise AssertionError(f"{file.name} :: {vector['name']}: {actual!r} != {vector['expected']!r}")
+        count += 1
+print(f"Python cgreet: {count} vectors passed across {len(files)} files")

cgreet-0.2.1/scripts/consumer.py

@@ -0,0 +1,104 @@
+"""Verify wheel/sdist contents and installed Python/console entrypoints.
+
+Run with the interpreter in a fresh environment containing the wheel and its
+declared dependencies. This script never adds the source package to sys.path.
+"""
+import argparse
+import base64
+from email.parser import BytesParser
+import importlib
+import importlib.metadata
+import json
+import os
+from pathlib import Path
+import subprocess
+import sys
+import tarfile
+import tempfile
+import zipfile
+
+ROOT = Path(__file__).resolve().parents[2]
+PACKAGES = [path.name for path in (ROOT / "py").iterdir() if (path / "__init__.py").is_file()]
+if len(PACKAGES) != 1:
+    raise RuntimeError("Expected exactly one source package")
+NAME = PACKAGES[0]
+CASES = {
+    "cgreet": ("de_salutation", ["Frau Dr. Müller", "ch"],
+               {"name": "Frau Dr. Müller", "region": "ch"}, "Sehr geehrte Frau Dr. Müller"),
+    "cfarewell": ("closing", ["DE-LI"], {"locale": "DE-LI"}, "Freundliche Grüsse"),
+    "cdate": ("long_date", ["EN-GB", 2026, 9, 7],
+              {"locale": "EN-GB", "year": 2026, "month": 9, "day": 7}, "7 September 2026"),
+    "cink": ("image_snippet", ["signature.png", 20],
+             {"path": "signature.png", "height_pt": 20}, '#image("signature.png", height: 20pt)'),
+    "cletter": ("salutation", ["DE-LI", "Frau Dr. Müller"],
+                {"locale": "DE-LI", "name": "Frau Dr. Müller"}, "Sehr geehrte Frau Dr. Müller"),
+}
+
+
+def check(condition, message):
+    if not condition:
+        raise AssertionError(message)
+
+
+parser = argparse.ArgumentParser(description=__doc__)
+parser.add_argument("--wheel", type=Path, required=True)
+parser.add_argument("--sdist", type=Path, required=True)
+args = parser.parse_args()
+licenses = {path.name: path.read_bytes() for path in (ROOT / "LICENSES").iterdir() if path.is_file()}
+check(bool(licenses), "Source licenses are missing")
+with zipfile.ZipFile(args.wheel) as wheel:
+    files = wheel.namelist()
+    check(f"{NAME}/py.typed" in files, "Wheel is missing py.typed")
+    metadata_paths = [path for path in files if path.endswith(".dist-info/METADATA")]
+    check(len(metadata_paths) == 1, "Expected one wheel distribution")
+    metadata = BytesParser().parsebytes(wheel.read(metadata_paths[0]))
+    check(metadata["Name"] == NAME, "Wheel package name differs from repository")
+    for name, expected in licenses.items():
+        check(any(path.endswith("/LICENSES/" + name) and wheel.read(path) == expected for path in files),
+              f"Wheel is missing the original {name}")
+with tarfile.open(args.sdist, "r:gz") as sdist:
+    files = {member.name: member for member in sdist.getmembers() if member.isfile()}
+    for name, expected in licenses.items():
+        check(any(path.endswith("/LICENSES/" + name) and sdist.extractfile(member).read() == expected
+                  for path, member in files.items()), f"Source distribution is missing {name}")
+
+distribution = importlib.metadata.distribution(NAME)
+check(distribution.version == metadata["Version"], "Installed version differs from wheel")
+check(any(entry.group == "console_scripts" and entry.name == NAME and entry.value == f"{NAME}.__main__:main"
+          for entry in distribution.entry_points), "Missing console entrypoint metadata")
+api = importlib.import_module(NAME)
+check(not Path(api.__file__).resolve().is_relative_to(ROOT / "py"), "Imported source tree instead of installed wheel")
+entrypoint = Path(sys.executable).parent / (NAME + (".exe" if os.name == "nt" else ""))
+check(entrypoint.is_file(), "Installer did not create the console entrypoint")
+function, positional, keywords, expected = CASES[NAME]
+
+with tempfile.TemporaryDirectory(prefix=f"{NAME}-python-consumer-") as cwd:
+    def call(command, function, values, *, stdin=False, valid=True):
+        payload = values if isinstance(values, str) else json.dumps(values, ensure_ascii=False)
+        result = subprocess.run(command + [function, "-" if stdin else payload],
+                                input=payload if stdin else None, cwd=cwd, text=True,
+                                encoding="utf-8", capture_output=True, timeout=30)
+        if valid:
+            check(result.returncode == 0, result.stderr)
+            return json.loads(result.stdout)
+        check(result.returncode == 2 and not result.stdout and "Traceback" not in result.stderr,
+              f"Invalid arguments did not produce a clean CLI error: {result}")
+
+    for command in ([sys.executable, "-m", NAME], [str(entrypoint)]):
+        check(call(command, function, positional) == expected, "Positional JSON invocation failed")
+        check(call(command, function, keywords, stdin=True) == expected, "Keyword/stdin invocation failed")
+        call(command, function, "null", valid=False)
+        call(command, function, "[NaN]", valid=False)
+        call(command, function, [], valid=False)
+    if NAME in ("cink", "cletter"):
+        encoded = base64.b64encode(b'<svg xmlns="http://www.w3.org/2000/svg"/>').decode("ascii")
+        decoded = call([str(entrypoint)], "normalize", [encoded])
+        check(decoded["bytes"] == encoded and decoded["mime"] == "svg", "Image JSON output lost encoded bytes")
+        check(call([str(entrypoint)], "signature_size", {"image": decoded, "height_pt": 20}) is None,
+              "Image JSON output cannot be used as a subsequent input")
+        raster = {"mime": "png", "width": 1, "height": 1, "bytes": ""}
+        check(call([str(entrypoint)], "signature_size", {"image": raster, "height_pt": 10**400}) is None,
+              "An unrepresentable height escaped the JSON bridge")
+        check(call([str(entrypoint)], "signature_size", {"image": raster, "height_pt": 20, "max_width_pt": 10**400}) is None,
+              "An unrepresentable maximum width escaped the JSON bridge")
+print(f"Python {NAME}: installed module, console JSON calls, wheel/sdist licenses and metadata passed")