passiveaggressive 0.1.0__tar.gz

passiveaggressive-0.1.0/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to this project are documented here.
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+versioning follows [SemVer](https://semver.org/).
+
+## [0.1.0] - 2026-07-24
+
+### Added
+
+- Initial release.
+- `translate()` / `rewrite()` with six styles (`coworker`, `manager`,
+  `customer_support`, `british`, `parent`, `teacher`) and five intensity
+  levels.
+- `email()`, `subject()`, and `signoff()` helpers.
+- Deterministic output via an optional `seed` argument.
+- `passiveaggressive` CLI.
+- Full type hints (`py.typed`), 100% handcrafted templates, zero runtime
+  dependencies.

passiveaggressive-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 passiveaggressive contributors
+
+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.

passiveaggressive-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+recursive-include passiveaggressive py.typed

passiveaggressive-0.1.0/PKG-INFO

@@ -0,0 +1,220 @@
+Metadata-Version: 2.4
+Name: passiveaggressive
+Version: 0.1.0
+Summary: Convert polite messages into subtly passive-aggressive ones.
+Author: passiveaggressive contributors
+License: MIT
+Project-URL: Homepage, https://github.com/example/passiveaggressive
+Project-URL: Repository, https://github.com/example/passiveaggressive
+Project-URL: Changelog, https://github.com/example/passiveaggressive/blob/main/CHANGELOG.md
+Keywords: humor,text,office,email,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Email
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: mypy>=1.8; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: black>=24.0; extra == "dev"
+Dynamic: license-file
+
+# passiveaggressive
+
+[![CI](https://github.com/example/passiveaggressive/actions/workflows/ci.yml/badge.svg)](https://github.com/example/passiveaggressive/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/passiveaggressive.svg)](https://pypi.org/project/passiveaggressive/)
+[![Python versions](https://img.shields.io/pypi/pyversions/passiveaggressive.svg)](https://pypi.org/project/passiveaggressive/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Convert polite messages into subtly passive-aggressive ones — the kind of
+message you might get from an overly polite coworker, manager, or customer
+support rep. Funny without being mean, office-friendly, and built entirely
+from handcrafted phrase templates — no AI, no network calls, no runtime
+dependencies.
+
+```python
+>>> from passiveaggressive import translate
+>>> translate("Please update the documentation.")  # one possible output
+'Just a gentle reminder, update the documentation, if time allows. Thanks in advance.'
+```
+
+## Installation
+
+```bash
+pip install passiveaggressive
+```
+
+Or, for local development:
+
+```bash
+git clone https://github.com/example/passiveaggressive.git
+cd passiveaggressive
+pip install -e ".[dev]"
+```
+
+Requires Python 3.10+.
+
+## Usage
+
+### Basic translation
+
+```python
+from passiveaggressive import translate
+
+translate("Send me the report.")
+# "Whenever you have a moment, it would be appreciated if the report
+#  could finally be sent over."
+```
+
+### Styles
+
+Choose the personality delivering the message:
+
+```python
+translate(text, style="coworker")          # default
+translate(text, style="manager")
+translate(text, style="customer_support")
+translate(text, style="british")
+translate(text, style="parent")
+translate(text, style="teacher")
+```
+
+| Style             | Example output |
+|-------------------|-----------------|
+| `coworker`        | "Just circling back on the PR. Thanks in advance." |
+| `manager`         | "Just checking in on this again since I haven't seen an update." |
+| `customer_support`| "We wanted to follow up on your request. Much appreciated." |
+| `british`         | "Not to be a bother, but I was wondering whether this might be looked at when convenient." |
+| `parent`          | "I'll just leave this here in case anyone remembers." |
+| `teacher`         | "A gentle reminder, this was mentioned in class." |
+
+### Intensity
+
+Dial the annoyance from 1 (barely-there politeness) to 5 (maximum office
+sarcasm):
+
+```python
+translate(text, intensity=1)  # "Whenever you have a chance..."
+translate(text, intensity=3)  # "Just following up since this seems to have been overlooked."
+translate(text, intensity=5)  # "No rush at all—as always—but it would be wonderful if this
+                               #  could happen sometime this century."
+```
+
+### Randomization & determinism
+
+Repeated calls vary naturally:
+
+```python
+translate("Please review the PR.")
+# "Just circling back on the PR."
+# "Thought I'd mention this again in case it slipped through."
+# "Whenever convenient, the PR is still waiting."
+```
+
+Pass a `seed` for reproducible output:
+
+```python
+translate("Please review the PR.", seed=42)
+```
+
+### Extra functions
+
+```python
+from passiveaggressive import rewrite, email, subject, signoff
+
+rewrite(text)          # alias of translate()
+email(text)            # adds email-specific phrasing
+subject()              # e.g. "Gentle Reminder", "Following Up (Again)"
+signoff()              # e.g. "Kind regards,", "As always,"
+```
+
+## CLI
+
+Installing the package also installs the `passiveaggressive` command:
+
+```bash
+$ passiveaggressive "Please send the invoice."
+Just checking in regarding the invoice whenever convenient.
+
+$ passiveaggressive "Fix the bug" --style british --intensity 4
+$ passiveaggressive "Reply to my email" --seed 10
+```
+
+Flags:
+
+- `--style {coworker,manager,customer_support,british,parent,teacher}`
+- `--intensity {1,2,3,4,5}`
+- `--seed <int>`
+
+## API documentation
+
+### `translate(text, style="coworker", intensity=3, seed=None) -> str`
+
+Transforms `text` into a passive-aggressive message.
+
+- `text` (`str`, required) — the original message. Must be non-empty.
+- `style` (`str`) — one of the six supported styles.
+- `intensity` (`int`) — 1–5.
+- `seed` (`int | None`) — optional seed for deterministic output.
+
+Raises `TypeError` if `text` isn't a string, and `ValueError` if `text` is
+empty/whitespace, `style` is unrecognized, or `intensity` is out of range.
+
+### `rewrite(text, style="coworker", intensity=3, seed=None) -> str`
+
+Alias of `translate()`.
+
+### `email(text, style="coworker", intensity=3, seed=None) -> str`
+
+Like `translate()`, but layers in additional email-specific phrasing
+(e.g. "Looking forward to hearing from you.").
+
+### `subject(seed=None) -> str`
+
+Generates a passive-aggressive email subject line.
+
+### `signoff(seed=None) -> str`
+
+Generates a passive-aggressive email signoff.
+
+## Random examples
+
+```
+"Just circling back on the PR."
+"Thought I'd mention this again in case it slipped through."
+"Whenever convenient, the PR is still waiting."
+"The PR continues to exist, should anyone be interested."
+```
+
+## Design philosophy
+
+- Funny without being cruel
+- Predictable and reproducible (via `seed`)
+- Lightweight, pure Python, zero runtime dependencies
+- Easy to extend with additional styles or phrases
+- Beginner-friendly
+
+## Contributing
+
+New styles are the most fun thing to add. See [CONTRIBUTING.md](CONTRIBUTING.md)
+for setup instructions and the checklist to run before opening a PR.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+"# PassiveAggressive" 

passiveaggressive-0.1.0/README.md

@@ -0,0 +1,188 @@
+# passiveaggressive
+
+[![CI](https://github.com/example/passiveaggressive/actions/workflows/ci.yml/badge.svg)](https://github.com/example/passiveaggressive/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/passiveaggressive.svg)](https://pypi.org/project/passiveaggressive/)
+[![Python versions](https://img.shields.io/pypi/pyversions/passiveaggressive.svg)](https://pypi.org/project/passiveaggressive/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Convert polite messages into subtly passive-aggressive ones — the kind of
+message you might get from an overly polite coworker, manager, or customer
+support rep. Funny without being mean, office-friendly, and built entirely
+from handcrafted phrase templates — no AI, no network calls, no runtime
+dependencies.
+
+```python
+>>> from passiveaggressive import translate
+>>> translate("Please update the documentation.")  # one possible output
+'Just a gentle reminder, update the documentation, if time allows. Thanks in advance.'
+```
+
+## Installation
+
+```bash
+pip install passiveaggressive
+```
+
+Or, for local development:
+
+```bash
+git clone https://github.com/example/passiveaggressive.git
+cd passiveaggressive
+pip install -e ".[dev]"
+```
+
+Requires Python 3.10+.
+
+## Usage
+
+### Basic translation
+
+```python
+from passiveaggressive import translate
+
+translate("Send me the report.")
+# "Whenever you have a moment, it would be appreciated if the report
+#  could finally be sent over."
+```
+
+### Styles
+
+Choose the personality delivering the message:
+
+```python
+translate(text, style="coworker")          # default
+translate(text, style="manager")
+translate(text, style="customer_support")
+translate(text, style="british")
+translate(text, style="parent")
+translate(text, style="teacher")
+```
+
+| Style             | Example output |
+|-------------------|-----------------|
+| `coworker`        | "Just circling back on the PR. Thanks in advance." |
+| `manager`         | "Just checking in on this again since I haven't seen an update." |
+| `customer_support`| "We wanted to follow up on your request. Much appreciated." |
+| `british`         | "Not to be a bother, but I was wondering whether this might be looked at when convenient." |
+| `parent`          | "I'll just leave this here in case anyone remembers." |
+| `teacher`         | "A gentle reminder, this was mentioned in class." |
+
+### Intensity
+
+Dial the annoyance from 1 (barely-there politeness) to 5 (maximum office
+sarcasm):
+
+```python
+translate(text, intensity=1)  # "Whenever you have a chance..."
+translate(text, intensity=3)  # "Just following up since this seems to have been overlooked."
+translate(text, intensity=5)  # "No rush at all—as always—but it would be wonderful if this
+                               #  could happen sometime this century."
+```
+
+### Randomization & determinism
+
+Repeated calls vary naturally:
+
+```python
+translate("Please review the PR.")
+# "Just circling back on the PR."
+# "Thought I'd mention this again in case it slipped through."
+# "Whenever convenient, the PR is still waiting."
+```
+
+Pass a `seed` for reproducible output:
+
+```python
+translate("Please review the PR.", seed=42)
+```
+
+### Extra functions
+
+```python
+from passiveaggressive import rewrite, email, subject, signoff
+
+rewrite(text)          # alias of translate()
+email(text)            # adds email-specific phrasing
+subject()              # e.g. "Gentle Reminder", "Following Up (Again)"
+signoff()              # e.g. "Kind regards,", "As always,"
+```
+
+## CLI
+
+Installing the package also installs the `passiveaggressive` command:
+
+```bash
+$ passiveaggressive "Please send the invoice."
+Just checking in regarding the invoice whenever convenient.
+
+$ passiveaggressive "Fix the bug" --style british --intensity 4
+$ passiveaggressive "Reply to my email" --seed 10
+```
+
+Flags:
+
+- `--style {coworker,manager,customer_support,british,parent,teacher}`
+- `--intensity {1,2,3,4,5}`
+- `--seed <int>`
+
+## API documentation
+
+### `translate(text, style="coworker", intensity=3, seed=None) -> str`
+
+Transforms `text` into a passive-aggressive message.
+
+- `text` (`str`, required) — the original message. Must be non-empty.
+- `style` (`str`) — one of the six supported styles.
+- `intensity` (`int`) — 1–5.
+- `seed` (`int | None`) — optional seed for deterministic output.
+
+Raises `TypeError` if `text` isn't a string, and `ValueError` if `text` is
+empty/whitespace, `style` is unrecognized, or `intensity` is out of range.
+
+### `rewrite(text, style="coworker", intensity=3, seed=None) -> str`
+
+Alias of `translate()`.
+
+### `email(text, style="coworker", intensity=3, seed=None) -> str`
+
+Like `translate()`, but layers in additional email-specific phrasing
+(e.g. "Looking forward to hearing from you.").
+
+### `subject(seed=None) -> str`
+
+Generates a passive-aggressive email subject line.
+
+### `signoff(seed=None) -> str`
+
+Generates a passive-aggressive email signoff.
+
+## Random examples
+
+```
+"Just circling back on the PR."
+"Thought I'd mention this again in case it slipped through."
+"Whenever convenient, the PR is still waiting."
+"The PR continues to exist, should anyone be interested."
+```
+
+## Design philosophy
+
+- Funny without being cruel
+- Predictable and reproducible (via `seed`)
+- Lightweight, pure Python, zero runtime dependencies
+- Easy to extend with additional styles or phrases
+- Beginner-friendly
+
+## Contributing
+
+New styles are the most fun thing to add. See [CONTRIBUTING.md](CONTRIBUTING.md)
+for setup instructions and the checklist to run before opening a PR.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+"# PassiveAggressive" 

passiveaggressive-0.1.0/passiveaggressive/__init__.py

@@ -0,0 +1,21 @@
+"""passiveaggressive — turn polite messages into subtly passive-aggressive ones.
+
+>>> from passiveaggressive import translate
+>>> translate("Please update the documentation.", seed=1)  # doctest: +ELLIPSIS
+'...documentation...'
+"""
+
+from .templates import INTENSITIES, STYLES
+from .translator import email, rewrite, signoff, subject, translate
+
+__all__ = [
+    "translate",
+    "rewrite",
+    "email",
+    "subject",
+    "signoff",
+    "STYLES",
+    "INTENSITIES",
+]
+
+__version__ = "0.1.0"

passiveaggressive-0.1.0/passiveaggressive/cli.py

@@ -0,0 +1,64 @@
+"""Command-line entry point. Installed as the ``passiveaggressive`` script.
+
+Run ``passiveaggressive --help`` for the full rundown.
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+
+from .templates import INTENSITIES, STYLES
+from .translator import translate
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="passiveaggressive",
+        description="Convert a polite message into a subtly passive-aggressive one.",
+    )
+    parser.add_argument("text", help="The original, polite message to transform.")
+    parser.add_argument(
+        "--style",
+        choices=STYLES,
+        default="coworker",
+        help="Who's supposedly sending this (default: coworker).",
+    )
+    parser.add_argument(
+        "--intensity",
+        type=int,
+        choices=INTENSITIES,
+        default=3,
+        help="How annoyed they are, 1-5 (default: 3).",
+    )
+    parser.add_argument(
+        "--seed",
+        type=int,
+        default=None,
+        help="Set this to get the same output every time.",
+    )
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    """Parse args, translate, print. Returns an exit code."""
+    parser = build_parser()
+    args = parser.parse_args(argv)
+
+    try:
+        result = translate(
+            args.text,
+            style=args.style,
+            intensity=args.intensity,
+            seed=args.seed,
+        )
+    except (TypeError, ValueError) as exc:
+        print(f"Error: {exc}", file=sys.stderr)
+        return 1
+
+    print(result)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())