jodie 0.1.0__tar.gz

jodie-0.1.0/PKG-INFO

@@ -0,0 +1,216 @@
+Metadata-Version: 2.4
+Name: jodie
+Version: 0.1.0
+Summary: Jodie lets you add contacts to Contacts.app on macOS from command line
+Author-email: austin <tips@cia.lol>
+License: MIT
+Project-URL: Homepage, https://github.com/austinogilvie/jodie
+Project-URL: Repository, https://github.com/austinogilvie/jodie
+Project-URL: Issues, https://github.com/austinogilvie/jodie/issues
+Keywords: macOS,Contacts.app,Contact management,Contacts,command line tool,CLI
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Email :: Address Book
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: docopt~=0.6.2
+Requires-Dist: nameparser==1.1.3
+Requires-Dist: tomli>=2.0; python_version < "3.11"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+
+# Jodie
+
+A command line tool to quickly save new contacts to Contacts.app on macOS.
+
+Named for [Jodie Foster](https://en.wikipedia.org/wiki/Jodie_Foster) for her stellar performance in [Contact](https://en.wikipedia.org/wiki/Contact_(1997_American_film)).
+
+![Jodie Foster in Contact](jodie-foster-contact.gif)
+
+## Installation
+
+```bash
+git clone git@github.com:austinogilvie/jodie.git
+cd jodie
+pip install .
+```
+
+After installation, both `jodie` and `jodie-cli` commands are available.
+
+## Quick Start
+
+```bash
+# Smart parsing (default) - jodie figures out what's what
+jodie new "John Doe" john@acme.com "Acme Inc" "CEO"
+
+# Preview before saving
+jodie new "John Doe" john@acme.com --dry-run
+
+# Parse from clipboard (copy an email signature first)
+jodie new --paste
+
+# Parse from stdin
+echo "John Doe <john@acme.com>" | jodie new --stdin
+```
+
+## Usage
+
+```
+jodie - Manage macOS Contacts.app from command line!
+
+Usage:
+    jodie new TEXT... [options]
+    jodie new [options]
+    jodie new --paste [options]
+    jodie new --stdin [options]
+    jodie new --explicit EMAIL NAME [COMPANY] [TITLE]
+
+Arguments:
+    TEXT          Text for jodie to parse intelligently (default mode).
+    EMAIL         Email address (used with --explicit).
+    NAME          Full name (used with --explicit).
+    COMPANY       Company name (used with --explicit).
+    TITLE         Job title (used with --explicit).
+
+Options:
+    --explicit                      Use strict positional parsing.
+    --paste                         Read input from clipboard (pbpaste).
+    --stdin                         Read input from stdin (pipe/heredoc).
+    -D --dry-run                    Preview parsed fields without saving.
+
+    -E EMAIL --email=EMAIL          Email address.
+    -F FIRST --first=FIRST          First name.
+    -L LAST --last=LAST             Last name.
+    -U NAME --full-name=NAME        Full name (or use --name).
+    -P PHONE --phone=PHONE          Phone number.
+    -T TITLE --title=TITLE          Job title.
+    -C COMPANY --company=COMPANY    Company name.
+    -W URL --websites=URL           Comma-separated website URLs.
+    --linkedin=URL                  LinkedIn URL (auto-labeled).
+
+    -H --help                       Show this screen.
+    -V --version                    Show version.
+```
+
+## Examples
+
+### Smart Parsing (Default)
+
+Just pass the information in any order - jodie figures it out:
+
+```bash
+jodie new "John Doe" john@acme.com "Acme Inc" "CEO" "https://linkedin.com/in/johndoe"
+```
+
+### Preview with --dry-run
+
+See what jodie parsed before saving:
+
+```bash
+jodie new "John Doe" john@acme.com "Acme Inc" --dry-run
+```
+
+Output:
+```
+┌─────────────────────────────────────────────────────────┐
+│                     Contact Preview                     │
+├──────────────┬──────────────────────┬───────────────────┤
+│ Field        │ Value                │ Source            │
+├──────────────┼──────────────────────┼───────────────────┤
+│ First Name   │ John                 │ parsed (100%)     │
+│ Last Name    │ Doe                  │ parsed (100%)     │
+│ Email        │ john@acme.com        │ parsed (100%)     │
+│ Company      │ Acme Inc             │ parsed (100%)     │
+└──────────────┴──────────────────────┴───────────────────┘
+
+Run without --dry-run to save this contact.
+```
+
+### Parse Email Signatures from Clipboard
+
+Copy an email signature to your clipboard, then:
+
+```bash
+jodie new --paste --dry-run
+```
+
+Jodie handles common signature formats:
+- Strips pronouns (he/him, she/her, they/them)
+- Splits on bullet separators (•, |, —)
+- Filters out reply headers and forwarded message noise
+- Infers company from email domain
+
+### Parse from Stdin
+
+Pipe text directly:
+
+```bash
+echo "Jane Smith <jane@startup.io> | CEO | Startup Inc" | jodie new --stdin
+```
+
+Or use a heredoc:
+
+```bash
+jodie new --stdin << 'EOF'
+Jane Smith
+CEO, Startup Inc
+jane@startup.io
+415-555-1234
+https://linkedin.com/in/janesmith
+EOF
+```
+
+### Explicit Flags
+
+For full control, use explicit flags:
+
+```bash
+jodie new \
+    --first "John" \
+    --last "Doe" \
+    --email "john@acme.com" \
+    --phone "+1 555 555 5555" \
+    --title "CEO" \
+    --company "Acme Inc" \
+    --linkedin "https://linkedin.com/in/johndoe" \
+    --websites "https://acme.com,https://github.com/johndoe"
+```
+
+### Strict Positional Mode
+
+If you prefer explicit ordering (email first, then name, company, title):
+
+```bash
+jodie new --explicit john@acme.com "John Doe" "Acme Inc" "CEO"
+```
+
+Note: `--explicit` mode doesn't support `--dry-run`. Use smart parsing with `--dry-run` to preview first.
+
+## Flag Aliases
+
+For convenience, these aliases are supported:
+
+| Primary | Aliases |
+|---------|---------|
+| `--first` | `--first-name`, `--firstname` |
+| `--last` | `--last-name`, `--lastname` |
+| `--full-name` | `--name` |
+| `--websites` | `--website` |
+
+## Known Limitations
+
+- **Notes field**: Currently disabled due to macOS entitlement requirements. Will be re-enabled in a future update.
+
+## License
+
+MIT

jodie-0.1.0/README.md

@@ -0,0 +1,185 @@
+# Jodie
+
+A command line tool to quickly save new contacts to Contacts.app on macOS.
+
+Named for [Jodie Foster](https://en.wikipedia.org/wiki/Jodie_Foster) for her stellar performance in [Contact](https://en.wikipedia.org/wiki/Contact_(1997_American_film)).
+
+![Jodie Foster in Contact](jodie-foster-contact.gif)
+
+## Installation
+
+```bash
+git clone git@github.com:austinogilvie/jodie.git
+cd jodie
+pip install .
+```
+
+After installation, both `jodie` and `jodie-cli` commands are available.
+
+## Quick Start
+
+```bash
+# Smart parsing (default) - jodie figures out what's what
+jodie new "John Doe" john@acme.com "Acme Inc" "CEO"
+
+# Preview before saving
+jodie new "John Doe" john@acme.com --dry-run
+
+# Parse from clipboard (copy an email signature first)
+jodie new --paste
+
+# Parse from stdin
+echo "John Doe <john@acme.com>" | jodie new --stdin
+```
+
+## Usage
+
+```
+jodie - Manage macOS Contacts.app from command line!
+
+Usage:
+    jodie new TEXT... [options]
+    jodie new [options]
+    jodie new --paste [options]
+    jodie new --stdin [options]
+    jodie new --explicit EMAIL NAME [COMPANY] [TITLE]
+
+Arguments:
+    TEXT          Text for jodie to parse intelligently (default mode).
+    EMAIL         Email address (used with --explicit).
+    NAME          Full name (used with --explicit).
+    COMPANY       Company name (used with --explicit).
+    TITLE         Job title (used with --explicit).
+
+Options:
+    --explicit                      Use strict positional parsing.
+    --paste                         Read input from clipboard (pbpaste).
+    --stdin                         Read input from stdin (pipe/heredoc).
+    -D --dry-run                    Preview parsed fields without saving.
+
+    -E EMAIL --email=EMAIL          Email address.
+    -F FIRST --first=FIRST          First name.
+    -L LAST --last=LAST             Last name.
+    -U NAME --full-name=NAME        Full name (or use --name).
+    -P PHONE --phone=PHONE          Phone number.
+    -T TITLE --title=TITLE          Job title.
+    -C COMPANY --company=COMPANY    Company name.
+    -W URL --websites=URL           Comma-separated website URLs.
+    --linkedin=URL                  LinkedIn URL (auto-labeled).
+
+    -H --help                       Show this screen.
+    -V --version                    Show version.
+```
+
+## Examples
+
+### Smart Parsing (Default)
+
+Just pass the information in any order - jodie figures it out:
+
+```bash
+jodie new "John Doe" john@acme.com "Acme Inc" "CEO" "https://linkedin.com/in/johndoe"
+```
+
+### Preview with --dry-run
+
+See what jodie parsed before saving:
+
+```bash
+jodie new "John Doe" john@acme.com "Acme Inc" --dry-run
+```
+
+Output:
+```
+┌─────────────────────────────────────────────────────────┐
+│                     Contact Preview                     │
+├──────────────┬──────────────────────┬───────────────────┤
+│ Field        │ Value                │ Source            │
+├──────────────┼──────────────────────┼───────────────────┤
+│ First Name   │ John                 │ parsed (100%)     │
+│ Last Name    │ Doe                  │ parsed (100%)     │
+│ Email        │ john@acme.com        │ parsed (100%)     │
+│ Company      │ Acme Inc             │ parsed (100%)     │
+└──────────────┴──────────────────────┴───────────────────┘
+
+Run without --dry-run to save this contact.
+```
+
+### Parse Email Signatures from Clipboard
+
+Copy an email signature to your clipboard, then:
+
+```bash
+jodie new --paste --dry-run
+```
+
+Jodie handles common signature formats:
+- Strips pronouns (he/him, she/her, they/them)
+- Splits on bullet separators (•, |, —)
+- Filters out reply headers and forwarded message noise
+- Infers company from email domain
+
+### Parse from Stdin
+
+Pipe text directly:
+
+```bash
+echo "Jane Smith <jane@startup.io> | CEO | Startup Inc" | jodie new --stdin
+```
+
+Or use a heredoc:
+
+```bash
+jodie new --stdin << 'EOF'
+Jane Smith
+CEO, Startup Inc
+jane@startup.io
+415-555-1234
+https://linkedin.com/in/janesmith
+EOF
+```
+
+### Explicit Flags
+
+For full control, use explicit flags:
+
+```bash
+jodie new \
+    --first "John" \
+    --last "Doe" \
+    --email "john@acme.com" \
+    --phone "+1 555 555 5555" \
+    --title "CEO" \
+    --company "Acme Inc" \
+    --linkedin "https://linkedin.com/in/johndoe" \
+    --websites "https://acme.com,https://github.com/johndoe"
+```
+
+### Strict Positional Mode
+
+If you prefer explicit ordering (email first, then name, company, title):
+
+```bash
+jodie new --explicit john@acme.com "John Doe" "Acme Inc" "CEO"
+```
+
+Note: `--explicit` mode doesn't support `--dry-run`. Use smart parsing with `--dry-run` to preview first.
+
+## Flag Aliases
+
+For convenience, these aliases are supported:
+
+| Primary | Aliases |
+|---------|---------|
+| `--first` | `--first-name`, `--firstname` |
+| `--last` | `--last-name`, `--lastname` |
+| `--full-name` | `--name` |
+| `--websites` | `--website` |
+
+## Known Limitations
+
+- **Notes field**: Currently disabled due to macOS entitlement requirements. Will be re-enabled in a future update.
+
+## License
+
+MIT

jodie-0.1.0/jodie/__init__.py

@@ -0,0 +1,5 @@
+#!/usr/bin/env python3
+# jodie/__init__.py
+
+from jodie import contact, parsers
+from jodie.cli.__doc__ import __version__, __description__, __url__, __doc__

jodie-0.1.0/jodie/cli/__doc__.py

@@ -0,0 +1,61 @@
+#!/usr/bin/env python3
+# jodie/cli/__doc__.py
+"""jodie - Manage macOS Contacts.app from command line!
+
+Usage:
+    jodie new TEXT... [options]
+    jodie new [options]
+    jodie new --auto TEXT... [options]
+    jodie new --paste [options]
+    jodie new --stdin [options]
+    jodie new --explicit EMAIL NAME [COMPANY] [TITLE] [NOTE...]
+    jodie parse [options] TEXT
+
+Arguments:
+    TEXT                                Text for jodie to parse intelligently (default mode).
+    EMAIL                               Email address (used with --explicit).
+    NAME                                Full name (used with --explicit).
+    COMPANY                             Company name (used with --explicit).
+    TITLE                               Job title (used with --explicit).
+    NOTE                                Note text (used with --explicit).
+
+Options:
+    --explicit                          Use strict positional parsing (EMAIL NAME COMPANY TITLE NOTE).
+    -A --auto                           Smart parsing mode (default, kept for backward compatibility).
+    -C COMPANY --company=COMPANY        Company name.
+    -E EMAIL --email=EMAIL              Email.
+    -F FIRST --first=FIRST              First name.
+    --first-name=FIRST                  First name (alias for --first).
+    --firstname=FIRST                   First name (alias for --first).
+    -L LAST --last=LAST                 Last name.
+    --last-name=LAST                    Last name (alias for --last).
+    --lastname=LAST                     Last name (alias for --last).
+    -U NAME --full-name=NAME            Full name.
+    --name=NAME                         Full name (alias for --full-name).
+    -N NOTE --note=NOTE                 Any text you want to save in the `Note` field in Contacts.app.
+    --notes=NOTE                        Note text (alias for --note).
+    -P PHONE --phone=PHONE              Phone.
+    -T TITLE --title=TITLE              Job title.
+    -X TEXT  --text=TEXT                Text for jodie to try her best to parse semi-intelligently if she can.
+    -W WEBSITES --websites=WEBSITES     Comma-separated list of websites/URLs.
+    --website=WEBSITES                  Website URLs (alias for --websites).
+    --linkedin=URL                      LinkedIn profile URL (auto-labeled as LinkedIn).
+    -D --dry-run                        Preview parsed fields without saving.
+    -H --help                           Show this screen.
+    -V --version                        Show version.
+    --paste                             Read input from clipboard (pbpaste).
+    --stdin                             Read input from stdin (pipe/heredoc).
+
+"""
+
+__version__     = '0.1.0'
+__title__       = "jodie"
+__license__     = "MIT"
+__description__ = "Jodie lets you add contacts to Contacts.app on macOS from command line"
+__keywords__    = "macOS Contacts.app Contact management Contacts command line tool CLI"
+__author__      = "austin"
+__email__       = "tips@cia.lol"
+__url__         = "https://github.com/austinogilvie/jodie"
+
+
+__all__ = ['__version__', '__description__', '__url__', '__doc__']

jodie-0.1.0/jodie/cli/__init__.py

@@ -0,0 +1,2 @@
+#!/usr/bin/env python3
+# jodie/cli/__init__.py