jodie 0.1.0__py3-none-any.whl

jodie-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,22 @@
+jodie/__init__.py,sha256=1Vbq4yQV90EfB4FcNtTl2Vry0RfIaOyZdIJX787NE3k,156
+jodie/config.py,sha256=cxDwhFKXAsXztQcIN11re1LPMA-SDd6L6zS793HXTys,3050
+jodie/constants.py,sha256=FGgE65ArdA9Sjk2tTin5hI5rhr3iRHCmUHY4cXFnPLY,888
+jodie/cli/__doc__.py,sha256=xq5E6cA6cI75SFdFPmy64ioDy_x9AbSOTfEWU6mCZMY,3099
+jodie/cli/__init__.py,sha256=NmIjHZJf4m9jlcUDVmXP2IWMUDSfkJEt0Ba73a53oQE,47
+jodie/cli/__main__.py,sha256=mF28Rt2xnU2HrMqc89eg1Ro1A-enHfrs2GlkirdHQW8,11709
+jodie/cli/preview.py,sha256=diuYvioNvQce_OQqqFEl4pxJrQTxYfTRfGA5n7A6w6U,2378
+jodie/contact/__init__.py,sha256=fvYMNKjRR081QW7glEqx-2xPhJVKQ4DKVDcVhBKoZ5U,118
+jodie/contact/contact.py,sha256=6TaXBIyeZNsjzhN1Q1Tt6KSVAzbj5XEWVX5-GIGYj6c,24572
+jodie/input/__init__.py,sha256=COtBM4zRVwaupLiKmzm_Xbby_7ULFqAnxZ79_f8WTqk,182
+jodie/input/clipboard.py,sha256=D38Mw3uRdge0ZRLZAsfZ4PCASl4_OQdUrDRzpZzZ-Xk,286
+jodie/input/signature.py,sha256=iwqjnKqfp0ym9N5X2DYdBRtu-QorlBU3m1LJKIwKI_s,1544
+jodie/input/stdin.py,sha256=xlz4jGZZtHa-CLK6Cewcu17pugRImb-bcsIeoUee8RI,196
+jodie/parsers/__init__.py,sha256=aBvotR0pnVD8u6byrKSyODRQv_zyN3VKgL2va1TnfOI,452
+jodie/parsers/base.py,sha256=uJVXMMDB9bWBBS6-L6TJvz1hsQ2uv0fNpRsszOhRDrw,1880
+jodie/parsers/parsers.py,sha256=scMNKwT4R7s0KFe_LbKH6nxCS3m4fTXbxT9iKr3lhEk,8660
+jodie/parsers/pipeline.py,sha256=RcIstg4qKV03DgVKlwtM0S6JZKs1u3f-TRA_qmZlyR8,4468
+jodie-0.1.0.dist-info/METADATA,sha256=QrFFosM0Opd-a1gGzBTQivbOkF5ISCylYkkgRqZ3NCE,6782
+jodie-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+jodie-0.1.0.dist-info/entry_points.txt,sha256=gcALVZny5Rf9XkvJHgzT_XgM8Rfv02TsI2Czj0LYVA8,86
+jodie-0.1.0.dist-info/top_level.txt,sha256=mGpLxKAloOMxcCxDh6it4IITdOFBPeyq-kaEhzjlJxA,6
+jodie-0.1.0.dist-info/RECORD,,

jodie-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

jodie-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+jodie = jodie.cli.__main__:main
+jodie-cli = jodie.cli.__main__:main

jodie-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+jodie