pycdc 0.1.0__py3-none-any.whl

pycdc/__init__.py

@@ -0,0 +1,8 @@
+"""pycdc: Please Your Customer Direct Connect — CRM gift idea finder."""
+
+__version__ = "0.1.0"
+
+from .client import GiftFinder
+from .models import GiftIdea, Occasion, Budget, CustomerProfile
+
+__all__ = ["GiftFinder", "GiftIdea", "Occasion", "Budget", "CustomerProfile"]

pycdc/catalog.py

@@ -0,0 +1,95 @@
+"""Built-in gift catalog with curated ideas by occasion and budget."""
+
+from __future__ import annotations
+
+from .models import GiftIdea, Occasion, Budget
+
+# Curated gift catalog
+CATALOG: list[GiftIdea] = [
+    # Token gifts
+    GiftIdea("Handwritten Thank You Card", "Premium card with personal note", "$5-10",
+             Budget.TOKEN, Occasion.THANK_YOU, category="stationery",
+             personalization_tip="Reference a specific project or win you shared"),
+    GiftIdea("Custom Sticker Pack", "Branded fun stickers for their laptop", "$8-12",
+             Budget.TOKEN, Occasion.ONBOARDING, category="swag",
+             personalization_tip="Include their company logo alongside yours"),
+    GiftIdea("Artisan Coffee Sampler", "4-pack of single-origin coffee", "$12-15",
+             Budget.TOKEN, Occasion.REFERRAL, category="food",
+             personalization_tip="Add a note: 'Thanks a latte for the referral'"),
+
+    # Modest gifts
+    GiftIdea("Desk Plant Kit", "Low-maintenance succulent in branded pot", "$20-35",
+             Budget.MODEST, Occasion.ONBOARDING, category="office",
+             personalization_tip="Choose a plant that matches their office aesthetic"),
+    GiftIdea("Book — Their Industry", "Bestseller relevant to their field", "$15-30",
+             Budget.MODEST, Occasion.MILESTONE, category="books",
+             personalization_tip="Write a note inside the cover about why you picked it"),
+    GiftIdea("Gourmet Cookie Box", "Assorted artisan cookies, 12-pack", "$25-40",
+             Budget.MODEST, Occasion.HOLIDAY, category="food",
+             personalization_tip="Check for dietary restrictions first"),
+    GiftIdea("Charity Donation in Their Name", "Donation to a cause they care about", "$25-50",
+             Budget.MODEST, Occasion.THANK_YOU, category="charity",
+             personalization_tip="Pick a cause related to their stated values or interests"),
+
+    # Standard gifts
+    GiftIdea("Premium Bluetooth Speaker", "Compact high-quality speaker", "$60-100",
+             Budget.STANDARD, Occasion.CLOSING_DEAL, category="tech",
+             personalization_tip="Engrave their initials or a short message"),
+    GiftIdea("Wine & Cheese Hamper", "Curated selection with tasting notes", "$75-120",
+             Budget.STANDARD, Occasion.ANNIVERSARY, category="food",
+             personalization_tip="Include wines from their home region if possible"),
+    GiftIdea("Spa Gift Card", "Relaxation package at a local spa", "$80-150",
+             Budget.STANDARD, Occasion.RENEWAL, category="experience",
+             personalization_tip="'Celebrating another year of partnership — you deserve a break'"),
+    GiftIdea("Custom Illustration", "Commissioned portrait or office artwork", "$50-120",
+             Budget.STANDARD, Occasion.MILESTONE, category="art",
+             personalization_tip="Commission art of their office building or team mascot"),
+
+    # Premium gifts
+    GiftIdea("Weekend Getaway Voucher", "Hotel voucher for a weekend escape", "$200-400",
+             Budget.PREMIUM, Occasion.CLOSING_DEAL, category="experience",
+             personalization_tip="Pick a destination near their city or a place they've mentioned"),
+    GiftIdea("Noise-Cancelling Headphones", "Sony or Bose premium headphones", "$250-350",
+             Budget.PREMIUM, Occasion.RENEWAL, category="tech",
+             personalization_tip="Great for clients who travel frequently"),
+    GiftIdea("Leather Portfolio Set", "Handcrafted leather notebook + pen", "$150-300",
+             Budget.PREMIUM, Occasion.PROMOTION, category="luxury",
+             personalization_tip="Monogram with their initials"),
+
+    # VIP gifts
+    GiftIdea("Private Dining Experience", "Chef's table dinner for two", "$500-800",
+             Budget.VIP, Occasion.ANNIVERSARY, category="experience",
+             personalization_tip="Invite them personally — make it a relationship-building event"),
+    GiftIdea("Custom Watch Engraving", "Premium watch with personalized engraving", "$500-1500",
+             Budget.VIP, Occasion.MILESTONE, category="luxury",
+             personalization_tip="Engrave the date of your first deal together"),
+    GiftIdea("Team Offsite Sponsorship", "Fund a team activity for their company", "$1000+",
+             Budget.VIP, Occasion.RENEWAL, category="experience",
+             personalization_tip="Offer to cover an escape room, cooking class, or wine tasting"),
+]
+
+
+def search_catalog(*, occasion: Occasion | None = None, budget: Budget | None = None,
+                   query: str = "", interests: list[str] | None = None) -> list[GiftIdea]:
+    """Search the built-in catalog."""
+    results = list(CATALOG)
+
+    if occasion:
+        results = [g for g in results if g.occasion == occasion]
+    if budget:
+        results = [g for g in results if g.budget == budget]
+    if query:
+        q = query.lower()
+        results = [g for g in results if q in g.name.lower() or q in g.description.lower()
+                   or q in g.category.lower()]
+    if interests:
+        interest_set = {i.lower() for i in interests}
+        scored = []
+        for g in results:
+            text = f"{g.name} {g.description} {g.category}".lower()
+            matches = sum(1 for i in interest_set if i in text)
+            g.score = matches / len(interest_set) if interest_set else 0
+            scored.append(g)
+        results = sorted(scored, key=lambda g: g.score, reverse=True)
+
+    return results

pycdc/cli.py

@@ -0,0 +1,88 @@
+"""CLI for pycdc."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+
+
+def main(argv: list[str] | None = None) -> None:
+    parser = argparse.ArgumentParser(
+        prog="pycdc",
+        description="Please Your Customer Direct Connect — find CRM gift ideas",
+    )
+    sub = parser.add_subparsers(dest="command")
+
+    # Search
+    search_p = sub.add_parser("search", help="Search for gift ideas")
+    search_p.add_argument("query", nargs="?", default="", help="Search keyword")
+    search_p.add_argument("--occasion", choices=[o.value for o in _occasions()])
+    search_p.add_argument("--budget", choices=[b.value for b in _budgets()])
+    search_p.add_argument("--no-web", action="store_true", help="Skip web search")
+    search_p.add_argument("--json", action="store_true")
+
+    # Recommend
+    rec_p = sub.add_parser("recommend", help="Get recommendations for a customer")
+    rec_p.add_argument("--name", required=True)
+    rec_p.add_argument("--company", default="")
+    rec_p.add_argument("--deal-value", type=float, default=0)
+    rec_p.add_argument("--interests", nargs="*", default=[])
+    rec_p.add_argument("--occasion", default="thank_you")
+
+    # List occasions
+    sub.add_parser("occasions", help="List all occasions")
+    sub.add_parser("budgets", help="List all budget tiers")
+
+    args = parser.parse_args(argv)
+
+    if args.command == "search":
+        from .client import GiftFinder
+        from .models import Occasion, Budget
+        finder = GiftFinder(enable_web=not args.no_web)
+        occasion = Occasion(args.occasion) if args.occasion else None
+        budget = Budget(args.budget) if args.budget else None
+        ideas = finder.find(occasion=occasion, budget=budget, query=args.query)
+        if args.json:
+            print(json.dumps([i.to_dict() for i in ideas], indent=2))
+        else:
+            for i in ideas:
+                print(f"  [{i.budget.value:>8}] {i.name}")
+                print(f"           {i.price_range} — {i.description[:60]}")
+                if i.personalization_tip:
+                    print(f"           Tip: {i.personalization_tip}")
+                print()
+
+    elif args.command == "recommend":
+        from .client import GiftFinder
+        from .models import CustomerProfile, Occasion
+        customer = CustomerProfile(
+            name=args.name, company=args.company,
+            deal_value=args.deal_value, interests=args.interests)
+        finder = GiftFinder()
+        print(finder.summary_for(customer))
+
+    elif args.command == "occasions":
+        for o in _occasions():
+            print(f"  {o.value}")
+
+    elif args.command == "budgets":
+        for b in _budgets():
+            low, high = b.range
+            print(f"  {b.value:>8}  ${low}-${high}")
+
+    else:
+        parser.print_help()
+
+
+def _occasions():
+    from .models import Occasion
+    return list(Occasion)
+
+def _budgets():
+    from .models import Budget
+    return list(Budget)
+
+
+if __name__ == "__main__":
+    main()

pycdc/client.py

@@ -0,0 +1,148 @@
+"""GiftFinder — main client that combines catalog search with web search."""
+
+from __future__ import annotations
+
+import asyncio
+from dataclasses import dataclass
+
+import httpx
+
+from .models import GiftIdea, Occasion, Budget, CustomerProfile
+from .catalog import search_catalog, CATALOG
+
+
+@dataclass
+class GiftFinder:
+    """Search for CRM gift ideas from built-in catalog and the web.
+
+    Parameters
+    ----------
+    enable_web : bool
+        Whether to also search the web for ideas (default True).
+    """
+
+    enable_web: bool = True
+
+    def find(self, *, occasion: Occasion | None = None, budget: Budget | None = None,
+             query: str = "", customer: CustomerProfile | None = None) -> list[GiftIdea]:
+        """Find gift ideas matching criteria.
+
+        Searches the built-in catalog and optionally the web.
+        """
+        interests = customer.interests if customer else None
+
+        # Catalog results
+        results = search_catalog(occasion=occasion, budget=budget,
+                                 query=query, interests=interests)
+
+        # Boost score for customer tier match
+        if customer and budget is None:
+            tier_budget = {
+                "enterprise": Budget.VIP,
+                "business": Budget.PREMIUM,
+                "professional": Budget.STANDARD,
+                "starter": Budget.MODEST,
+            }
+            preferred = tier_budget.get(customer.tier, Budget.STANDARD)
+            for g in results:
+                if g.budget == preferred:
+                    g.score += 0.3
+
+        # Web search (if enabled)
+        if self.enable_web and (query or (customer and customer.interests)):
+            web_results = asyncio.run(self._web_search(
+                query=query, occasion=occasion, budget=budget, customer=customer))
+            results.extend(web_results)
+
+        # Sort by score descending
+        results.sort(key=lambda g: g.score, reverse=True)
+        return results
+
+    def recommend(self, customer: CustomerProfile, occasion: Occasion) -> list[GiftIdea]:
+        """Smart recommendations based on customer profile and occasion."""
+        # Determine budget from customer tier
+        tier_budget = {
+            "enterprise": Budget.VIP,
+            "business": Budget.PREMIUM,
+            "professional": Budget.STANDARD,
+            "starter": Budget.MODEST,
+        }
+        budget = tier_budget.get(customer.tier, Budget.STANDARD)
+
+        ideas = self.find(occasion=occasion, budget=budget, customer=customer)
+
+        # Further personalize tips
+        for idea in ideas:
+            if customer.name and idea.personalization_tip:
+                idea.personalization_tip = (
+                    f"For {customer.name}: {idea.personalization_tip}"
+                )
+
+        return ideas[:5]
+
+    async def _web_search(self, *, query: str, occasion: Occasion | None,
+                          budget: Budget | None, customer: CustomerProfile | None) -> list[GiftIdea]:
+        """Search the web for gift ideas (uses DuckDuckGo instant answers)."""
+        search_terms = []
+        if query:
+            search_terms.append(query)
+        if occasion:
+            search_terms.append(f"{occasion.value} gift")
+        if budget:
+            low, high = budget.range
+            search_terms.append(f"${low}-${high}")
+        if customer and customer.interests:
+            search_terms.extend(customer.interests[:2])
+        search_terms.append("corporate gift idea")
+
+        search_query = " ".join(search_terms)
+
+        async with httpx.AsyncClient() as client:
+            try:
+                resp = await client.get(
+                    "https://api.duckduckgo.com/",
+                    params={"q": search_query, "format": "json", "no_html": 1},
+                    timeout=10,
+                )
+                resp.raise_for_status()
+                data = resp.json()
+
+                results = []
+                for topic in data.get("RelatedTopics", [])[:5]:
+                    text = topic.get("Text", "")
+                    url = topic.get("FirstURL", "")
+                    if text:
+                        results.append(GiftIdea(
+                            name=text[:60],
+                            description=text,
+                            price_range="varies",
+                            budget=budget or Budget.STANDARD,
+                            occasion=occasion or Occasion.CUSTOM,
+                            source_url=url,
+                            category="web-suggestion",
+                            score=0.3,
+                        ))
+                return results
+            except Exception:
+                return []
+
+    def summary_for(self, customer: CustomerProfile) -> str:
+        """Print a customer gift strategy summary."""
+        lines = [
+            f"Gift Strategy for {customer.name}",
+            f"  Company: {customer.company} ({customer.industry})",
+            f"  Tier: {customer.tier} (deal value: ${customer.deal_value:,.0f})",
+            f"  Interests: {', '.join(customer.interests) or 'unknown'}",
+            f"  Relationship: {customer.relationship_length_months} months",
+            "",
+        ]
+
+        for occasion in [Occasion.RENEWAL, Occasion.HOLIDAY, Occasion.THANK_YOU]:
+            recs = self.recommend(customer, occasion)
+            if recs:
+                lines.append(f"  [{occasion.value.upper()}]")
+                for r in recs[:2]:
+                    lines.append(f"    • {r.name} ({r.price_range}) — {r.personalization_tip}")
+                lines.append("")
+
+        return "\n".join(lines)

pycdc/models.py

@@ -0,0 +1,91 @@
+"""Core models for customer profiles, occasions, and gift ideas."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from enum import Enum
+from typing import Any
+
+
+class Occasion(str, Enum):
+    ONBOARDING = "onboarding"
+    RENEWAL = "renewal"
+    BIRTHDAY = "birthday"
+    HOLIDAY = "holiday"
+    MILESTONE = "milestone"
+    THANK_YOU = "thank_you"
+    APOLOGY = "apology"
+    REFERRAL = "referral"
+    ANNIVERSARY = "anniversary"
+    CLOSING_DEAL = "closing_deal"
+    PROMOTION = "promotion"
+    CUSTOM = "custom"
+
+
+class Budget(str, Enum):
+    TOKEN = "token"           # $0-15
+    MODEST = "modest"         # $15-50
+    STANDARD = "standard"     # $50-150
+    PREMIUM = "premium"       # $150-500
+    VIP = "vip"               # $500+
+
+    @property
+    def range(self) -> tuple[int, int]:
+        return {
+            "token": (0, 15),
+            "modest": (15, 50),
+            "standard": (50, 150),
+            "premium": (150, 500),
+            "vip": (500, 10000),
+        }[self.value]
+
+
+@dataclass
+class CustomerProfile:
+    """Profile of a customer for personalized gift recommendations."""
+    name: str
+    company: str = ""
+    role: str = ""
+    industry: str = ""
+    interests: list[str] = field(default_factory=list)
+    location: str = ""
+    relationship_length_months: int = 0
+    deal_value: float = 0.0
+    notes: str = ""
+
+    @property
+    def tier(self) -> str:
+        if self.deal_value >= 100_000:
+            return "enterprise"
+        elif self.deal_value >= 10_000:
+            return "business"
+        elif self.deal_value >= 1_000:
+            return "professional"
+        return "starter"
+
+
+@dataclass
+class GiftIdea:
+    """A single gift recommendation."""
+    name: str
+    description: str
+    price_range: str
+    budget: Budget
+    occasion: Occasion
+    source_url: str = ""
+    category: str = ""
+    personalization_tip: str = ""
+    score: float = 0.0  # relevance score 0-1
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "name": self.name,
+            "description": self.description,
+            "price_range": self.price_range,
+            "budget": self.budget.value,
+            "occasion": self.occasion.value,
+            "source_url": self.source_url,
+            "category": self.category,
+            "personalization_tip": self.personalization_tip,
+            "score": self.score,
+        }

pycdc-0.1.0.dist-info/METADATA

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: pycdc
+Version: 0.1.0
+Summary: Please Your Customer Direct Connect — search the web for CRM gift ideas and client appreciation strategies
+Project-URL: Homepage, https://github.com/brnv/pycdc
+Author-email: Artem <brnv@canva.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: appreciation,client-relations,crm,customer,direct-connect,gifts
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial :: Point-Of-Sale
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Description-Content-Type: text/markdown
+
+# pycdc
+
+**P**lease **Y**our **C**ustomer **D**irect **C**onnect — a library to search the web and get gift ideas for CRM client appreciation.
+
+## Installation
+
+```bash
+pip install pycdc
+```
+
+## Usage
+
+```python
+from pycdc import GiftFinder, CustomerProfile, Occasion, Budget
+
+finder = GiftFinder()
+
+# Simple search
+ideas = finder.find(occasion=Occasion.RENEWAL, budget=Budget.STANDARD)
+
+# Customer-aware recommendations
+customer = CustomerProfile(
+    name="Sarah Chen",
+    company="Acme Corp",
+    deal_value=50_000,
+    interests=["coffee", "hiking", "tech"],
+    relationship_length_months=18,
+)
+recs = finder.recommend(customer, Occasion.ANNIVERSARY)
+for r in recs:
+    print(f"{r.name} ({r.price_range}) — {r.personalization_tip}")
+
+# Full gift strategy
+print(finder.summary_for(customer))
+```
+
+## CLI
+
+```bash
+pycdc search "tech" --budget premium
+pycdc search --occasion holiday --budget modest --json
+pycdc recommend --name "Sarah Chen" --company "Acme" --deal-value 50000 --interests coffee hiking
+pycdc occasions
+pycdc budgets
+```
+
+## License
+
+MIT

pycdc-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+pycdc/__init__.py,sha256=BxoSWqQiqB_RR_jXC6KLVeCyGqBg61krKEMCxgleqDE,273
+pycdc/catalog.py,sha256=kbc8gYHY2To0kuazivw-dtJYZxqfg0eY5txG1rs-aWY,5451
+pycdc/cli.py,sha256=hteAWAtIogf9LlM7ptfzf1tEyKDqdq7SYSGNNgmVw8w,2998
+pycdc/client.py,sha256=v89u4VBd2wVu0XtnZeHtjhLuZr6jokkWGVZTOY-ZZVA,5604
+pycdc/models.py,sha256=MOcYGwm3Fa_Cu0dlvQnWvyOh_Ln5jfpcHJTpJD1JoEA,2407
+pycdc-0.1.0.dist-info/METADATA,sha256=jyUuv8yK85Jf99bMnU7RjyMWBw4e6oSJ5f7nmDZtj0s,1786
+pycdc-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+pycdc-0.1.0.dist-info/entry_points.txt,sha256=nF0QyD7wOpajs7KI3BME8dyf6-aGLudjnNTvFkhowWU,41
+pycdc-0.1.0.dist-info/licenses/LICENSE,sha256=2vTtTMBZTlDHJyeU3ehwS7VdCCnprwCnVvv2q52NUJ8,1062
+pycdc-0.1.0.dist-info/RECORD,,

pycdc-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

pycdc-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pycdc = pycdc.cli:main

pycdc-0.1.0.dist-info/licenses/LICENSE

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