sendgo-django 1.0.0__tar.gz

sendgo_django-1.0.0/LICENSE

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

sendgo_django-1.0.0/PKG-INFO

@@ -0,0 +1,297 @@
+Metadata-Version: 2.4
+Name: sendgo-django
+Version: 1.0.0
+Summary: Sendgo Django 확장 — 카카오 알림톡/친구톡, SMS/LMS/MMS
+Author-email: Sendgo <dev@sendgo.io>
+License: MIT
+Project-URL: Homepage, https://sendgo.io
+Project-URL: Repository, https://github.com/send-go/django
+Keywords: sendgo,django,kakao,alimtalk,sms,notification,korea
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+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
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: sendgo-python>=1.0
+Requires-Dist: Django>=4.2
+Dynamic: license-file
+
+# sendgo-django
+
+> **Django에서 카카오 알림톡, 친구톡, SMS를 가장 쉽게 발송하는 공식 Django 확장 패키지**
+
+[![PyPI](https://img.shields.io/pypi/v/sendgo-django)](https://pypi.org/project/sendgo-django/)
+[![Django](https://img.shields.io/badge/Django-4.2%2B-092E20?logo=django)](https://www.djangoproject.com)
+[![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python)](https://python.org)
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+
+`sendgo-django`는 [`sendgo-python`](https://github.com/send-go/python) 코어를 확장한 **Django 전용 패키지**입니다.
+`settings.SENDGO` 설정 기반의 클라이언트 생성, 지연 로딩 프록시(`client`), AppConfig 통합을 제공합니다.
+
+---
+
+## 목차
+
+- [설치](#설치)
+- [빠른 시작](#빠른-시작)
+- [프록시 사용법](#프록시-사용법)
+- [상세 사용법](#상세-사용법)
+  - [알림톡](#알림톡)
+  - [친구톡](#친구톡)
+  - [SMS / LMS / MMS](#sms--lms--mms)
+- [서비스 클래스 패턴](#서비스-클래스-패턴)
+- [예외 처리](#예외-처리)
+- [설정 옵션](#설정-옵션)
+- [자주 묻는 질문](#자주-묻는-질문-faq)
+
+---
+
+## 설치
+
+```bash
+pip install sendgo-django
+```
+
+`sendgo-python` 코어는 의존성으로 자동 설치됩니다.
+
+---
+
+## 빠른 시작
+
+### 1단계 — `INSTALLED_APPS` 등록 (`settings.py`)
+
+```python
+INSTALLED_APPS += ["sendgo_django"]
+```
+
+### 2단계 — `SENDGO` 설정 추가 (`settings.py`)
+
+```python
+import os
+
+SENDGO = {
+    "ACCESS_KEY": os.environ["SENDGO_ACCESS_KEY"],
+    "SECRET_KEY": os.environ["SENDGO_SECRET_KEY"],
+    "KAKAO_SENDER_KEY": os.environ.get("SENDGO_KAKAO_SENDER_KEY"),
+    "SMS_SENDER_KEY": os.environ.get("SENDGO_SMS_SENDER_KEY"),
+    "API_VERSION": "v2",
+    # "BASE_URL": "https://sendgo.io",  # 기본값
+}
+```
+
+### 3단계 — 뷰에서 알림톡 전송
+
+```python
+# views.py
+from django.http import JsonResponse
+from sendgo_django import client
+
+
+def confirm_order(request, order_id):
+    order = get_order(order_id)
+
+    client.alimtalk.send(
+        template_code="ORDER_CONFIRM_001",
+        contacts=[
+            {
+                "contact": order.phone,
+                "name": order.name,
+                "var1": order.number,
+                "var2": f"{order.total:,}원",
+            },
+        ],
+    )
+
+    return JsonResponse({"success": True})
+```
+
+---
+
+## 프록시 사용법
+
+`sendgo_django.client`는 `SimpleLazyObject` 기반 **지연 로딩 프록시**입니다.
+패키지를 임포트하는 시점에는 클라이언트를 생성하지 않고, 실제로 속성에 접근할 때
+`get_client()`를 호출합니다. 따라서 설정이 없어도 임포트만으로는 오류가 나지 않습니다.
+
+```python
+from sendgo_django import client
+
+# 알림톡 발송
+client.alimtalk.send(
+    template_code="ORDER_CONFIRM_001",
+    contacts=[{"contact": "01012345678", "var1": "ORD-001"}],
+)
+
+# SMS 발송
+client.sms.send_sms(
+    content="[인증] 인증번호: 123456",
+    contacts=[{"contact": "01012345678"}],
+)
+```
+
+명시적으로 인스턴스를 얻고 싶다면 `get_client()`를 직접 호출할 수 있습니다.
+
+```python
+from sendgo_django import get_client
+
+sendgo = get_client()
+sendgo.friendtalk.send(content="안녕하세요!", contacts=[{"contact": "01012345678"}])
+```
+
+---
+
+## 상세 사용법
+
+### 알림톡
+
+```python
+from sendgo_django import client
+
+# 다건 발송
+client.alimtalk.send(
+    template_code="ORDER_CONFIRM_001",
+    contacts=[
+        {"contact": "01011111111", "name": "홍길동", "var1": "ORD-001", "var2": "29,000원"},
+        {"contact": "01022222222", "name": "김철수", "var1": "ORD-002", "var2": "15,000원"},
+    ],
+)
+```
+
+### 친구톡
+
+```python
+from sendgo_django import client
+
+# 텍스트형
+client.friendtalk.send(
+    content="안녕하세요! 7월 한정 특가 이벤트를 확인해보세요.",
+    contacts=[{"contact": "01012345678"}],
+)
+```
+
+### SMS / LMS / MMS
+
+```python
+from sendgo_django import client
+
+# SMS (90자 이하)
+client.sms.send_sms(
+    content="[Sendgo] 인증번호: 123456 (5분 이내 입력)",
+    contacts=[{"contact": "01012345678"}],
+)
+```
+
+---
+
+## 서비스 클래스 패턴
+
+```python
+# app/services.py
+import logging
+
+from sendgo import SendgoError
+from sendgo_django import client
+
+logger = logging.getLogger(__name__)
+
+
+class NotificationService:
+    """알림 발송 로직을 캡슐화한 서비스 클래스."""
+
+    def send_order_confirm(self, phone: str, order_no: str, amount: int) -> None:
+        client.alimtalk.send(
+            template_code="ORDER_CONFIRM_001",
+            contacts=[{"contact": phone, "var1": order_no, "var2": f"{amount:,}원"}],
+        )
+
+    def send_verification_code(self, phone: str, code: str) -> None:
+        try:
+            client.alimtalk.send(
+                template_code="VERIFY_CODE_001",
+                contacts=[{"contact": phone, "var1": code}],
+            )
+        except SendgoError:
+            logger.exception("Sendgo 인증번호 발송 실패")
+            raise
+```
+
+---
+
+## 예외 처리
+
+```python
+from sendgo import SendgoError
+from sendgo_django import client
+
+try:
+    client.alimtalk.send(
+        template_code="ORDER_CONFIRM_001",
+        contacts=[{"contact": "01012345678", "var1": "ORD-001"}],
+    )
+except SendgoError as e:
+    logger.error("Sendgo 발송 실패: %s", e)
+```
+
+---
+
+## 설정 옵션
+
+`settings.SENDGO` 딕셔너리 키:
+
+| 키 | 필수 | 기본값 | 설명 |
+|----|------|--------|------|
+| `ACCESS_KEY` | ✅ | — | Sendgo 액세스 키 |
+| `SECRET_KEY` | ✅ | — | Sendgo 시크릿 키 |
+| `KAKAO_SENDER_KEY` | | `None` | 카카오 발신프로필 키 |
+| `SMS_SENDER_KEY` | | `None` | SMS 발신자 키 |
+| `API_VERSION` | | `"v2"` | API 버전 |
+| `BASE_URL` | | `"https://sendgo.io"` | API 기본 URL |
+
+`ACCESS_KEY` 또는 `SECRET_KEY`가 없으면 클라이언트 생성 시 `django.core.exceptions.ImproperlyConfigured`가 발생합니다.
+
+---
+
+## 자주 묻는 질문 (FAQ)
+
+**Q. `sendgo-python`과의 차이는 무엇인가요?**
+A. `sendgo-python`은 프레임워크 독립적인 순수 Python 코어 패키지입니다. `sendgo-django`는 이를 확장해 `settings.SENDGO` 설정 바인딩, 지연 로딩 프록시, AppConfig 통합을 추가합니다.
+
+**Q. 설정 없이 임포트하면 오류가 나나요?**
+A. 아니요. `client`는 지연 프록시이므로 임포트만으로는 오류가 없고, 실제 사용(속성 접근) 시점에 설정을 검증합니다.
+
+**Q. 테스트 시 클라이언트를 초기화하려면?**
+A. `sendgo_django.conf.reset()`을 호출하면 메모이즈된 클라이언트가 초기화됩니다.
+
+**Q. Django 4.2, 5.x를 지원하나요?**
+A. 네, `Django>=4.2`를 지원합니다.
+
+---
+
+## 관련 패키지
+
+| 언어/프레임워크 | 패키지 | GitHub |
+|----------------|--------|--------|
+| Python (순수) | `sendgo-python` | [python](https://github.com/send-go/python) |
+| Laravel | `sendgo/laravel` | [laravel](https://github.com/send-go/laravel) |
+| Spring Boot | `io.sendgo:sendgo-spring` | [spring](https://github.com/send-go/spring) |
+| Node.js | `@sendgo/node` | [node](https://github.com/send-go/node) |
+| 전체 목록 | — | [send-go GitHub 조직](https://github.com/send-go) |
+
+---
+
+## 라이선스
+
+MIT License © 2026 [Sendgo](https://sendgo.io)
+
+---
+
+*키워드: 카카오 알림톡 Django, 카카오 친구톡 Django, SMS 발송 Django, 알림톡 Django 패키지, Django 카카오 API 연동, Sendgo Django SDK*

sendgo_django-1.0.0/README.md

@@ -0,0 +1,270 @@
+# sendgo-django
+
+> **Django에서 카카오 알림톡, 친구톡, SMS를 가장 쉽게 발송하는 공식 Django 확장 패키지**
+
+[![PyPI](https://img.shields.io/pypi/v/sendgo-django)](https://pypi.org/project/sendgo-django/)
+[![Django](https://img.shields.io/badge/Django-4.2%2B-092E20?logo=django)](https://www.djangoproject.com)
+[![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python)](https://python.org)
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+
+`sendgo-django`는 [`sendgo-python`](https://github.com/send-go/python) 코어를 확장한 **Django 전용 패키지**입니다.
+`settings.SENDGO` 설정 기반의 클라이언트 생성, 지연 로딩 프록시(`client`), AppConfig 통합을 제공합니다.
+
+---
+
+## 목차
+
+- [설치](#설치)
+- [빠른 시작](#빠른-시작)
+- [프록시 사용법](#프록시-사용법)
+- [상세 사용법](#상세-사용법)
+  - [알림톡](#알림톡)
+  - [친구톡](#친구톡)
+  - [SMS / LMS / MMS](#sms--lms--mms)
+- [서비스 클래스 패턴](#서비스-클래스-패턴)
+- [예외 처리](#예외-처리)
+- [설정 옵션](#설정-옵션)
+- [자주 묻는 질문](#자주-묻는-질문-faq)
+
+---
+
+## 설치
+
+```bash
+pip install sendgo-django
+```
+
+`sendgo-python` 코어는 의존성으로 자동 설치됩니다.
+
+---
+
+## 빠른 시작
+
+### 1단계 — `INSTALLED_APPS` 등록 (`settings.py`)
+
+```python
+INSTALLED_APPS += ["sendgo_django"]
+```
+
+### 2단계 — `SENDGO` 설정 추가 (`settings.py`)
+
+```python
+import os
+
+SENDGO = {
+    "ACCESS_KEY": os.environ["SENDGO_ACCESS_KEY"],
+    "SECRET_KEY": os.environ["SENDGO_SECRET_KEY"],
+    "KAKAO_SENDER_KEY": os.environ.get("SENDGO_KAKAO_SENDER_KEY"),
+    "SMS_SENDER_KEY": os.environ.get("SENDGO_SMS_SENDER_KEY"),
+    "API_VERSION": "v2",
+    # "BASE_URL": "https://sendgo.io",  # 기본값
+}
+```
+
+### 3단계 — 뷰에서 알림톡 전송
+
+```python
+# views.py
+from django.http import JsonResponse
+from sendgo_django import client
+
+
+def confirm_order(request, order_id):
+    order = get_order(order_id)
+
+    client.alimtalk.send(
+        template_code="ORDER_CONFIRM_001",
+        contacts=[
+            {
+                "contact": order.phone,
+                "name": order.name,
+                "var1": order.number,
+                "var2": f"{order.total:,}원",
+            },
+        ],
+    )
+
+    return JsonResponse({"success": True})
+```
+
+---
+
+## 프록시 사용법
+
+`sendgo_django.client`는 `SimpleLazyObject` 기반 **지연 로딩 프록시**입니다.
+패키지를 임포트하는 시점에는 클라이언트를 생성하지 않고, 실제로 속성에 접근할 때
+`get_client()`를 호출합니다. 따라서 설정이 없어도 임포트만으로는 오류가 나지 않습니다.
+
+```python
+from sendgo_django import client
+
+# 알림톡 발송
+client.alimtalk.send(
+    template_code="ORDER_CONFIRM_001",
+    contacts=[{"contact": "01012345678", "var1": "ORD-001"}],
+)
+
+# SMS 발송
+client.sms.send_sms(
+    content="[인증] 인증번호: 123456",
+    contacts=[{"contact": "01012345678"}],
+)
+```
+
+명시적으로 인스턴스를 얻고 싶다면 `get_client()`를 직접 호출할 수 있습니다.
+
+```python
+from sendgo_django import get_client
+
+sendgo = get_client()
+sendgo.friendtalk.send(content="안녕하세요!", contacts=[{"contact": "01012345678"}])
+```
+
+---
+
+## 상세 사용법
+
+### 알림톡
+
+```python
+from sendgo_django import client
+
+# 다건 발송
+client.alimtalk.send(
+    template_code="ORDER_CONFIRM_001",
+    contacts=[
+        {"contact": "01011111111", "name": "홍길동", "var1": "ORD-001", "var2": "29,000원"},
+        {"contact": "01022222222", "name": "김철수", "var1": "ORD-002", "var2": "15,000원"},
+    ],
+)
+```
+
+### 친구톡
+
+```python
+from sendgo_django import client
+
+# 텍스트형
+client.friendtalk.send(
+    content="안녕하세요! 7월 한정 특가 이벤트를 확인해보세요.",
+    contacts=[{"contact": "01012345678"}],
+)
+```
+
+### SMS / LMS / MMS
+
+```python
+from sendgo_django import client
+
+# SMS (90자 이하)
+client.sms.send_sms(
+    content="[Sendgo] 인증번호: 123456 (5분 이내 입력)",
+    contacts=[{"contact": "01012345678"}],
+)
+```
+
+---
+
+## 서비스 클래스 패턴
+
+```python
+# app/services.py
+import logging
+
+from sendgo import SendgoError
+from sendgo_django import client
+
+logger = logging.getLogger(__name__)
+
+
+class NotificationService:
+    """알림 발송 로직을 캡슐화한 서비스 클래스."""
+
+    def send_order_confirm(self, phone: str, order_no: str, amount: int) -> None:
+        client.alimtalk.send(
+            template_code="ORDER_CONFIRM_001",
+            contacts=[{"contact": phone, "var1": order_no, "var2": f"{amount:,}원"}],
+        )
+
+    def send_verification_code(self, phone: str, code: str) -> None:
+        try:
+            client.alimtalk.send(
+                template_code="VERIFY_CODE_001",
+                contacts=[{"contact": phone, "var1": code}],
+            )
+        except SendgoError:
+            logger.exception("Sendgo 인증번호 발송 실패")
+            raise
+```
+
+---
+
+## 예외 처리
+
+```python
+from sendgo import SendgoError
+from sendgo_django import client
+
+try:
+    client.alimtalk.send(
+        template_code="ORDER_CONFIRM_001",
+        contacts=[{"contact": "01012345678", "var1": "ORD-001"}],
+    )
+except SendgoError as e:
+    logger.error("Sendgo 발송 실패: %s", e)
+```
+
+---
+
+## 설정 옵션
+
+`settings.SENDGO` 딕셔너리 키:
+
+| 키 | 필수 | 기본값 | 설명 |
+|----|------|--------|------|
+| `ACCESS_KEY` | ✅ | — | Sendgo 액세스 키 |
+| `SECRET_KEY` | ✅ | — | Sendgo 시크릿 키 |
+| `KAKAO_SENDER_KEY` | | `None` | 카카오 발신프로필 키 |
+| `SMS_SENDER_KEY` | | `None` | SMS 발신자 키 |
+| `API_VERSION` | | `"v2"` | API 버전 |
+| `BASE_URL` | | `"https://sendgo.io"` | API 기본 URL |
+
+`ACCESS_KEY` 또는 `SECRET_KEY`가 없으면 클라이언트 생성 시 `django.core.exceptions.ImproperlyConfigured`가 발생합니다.
+
+---
+
+## 자주 묻는 질문 (FAQ)
+
+**Q. `sendgo-python`과의 차이는 무엇인가요?**
+A. `sendgo-python`은 프레임워크 독립적인 순수 Python 코어 패키지입니다. `sendgo-django`는 이를 확장해 `settings.SENDGO` 설정 바인딩, 지연 로딩 프록시, AppConfig 통합을 추가합니다.
+
+**Q. 설정 없이 임포트하면 오류가 나나요?**
+A. 아니요. `client`는 지연 프록시이므로 임포트만으로는 오류가 없고, 실제 사용(속성 접근) 시점에 설정을 검증합니다.
+
+**Q. 테스트 시 클라이언트를 초기화하려면?**
+A. `sendgo_django.conf.reset()`을 호출하면 메모이즈된 클라이언트가 초기화됩니다.
+
+**Q. Django 4.2, 5.x를 지원하나요?**
+A. 네, `Django>=4.2`를 지원합니다.
+
+---
+
+## 관련 패키지
+
+| 언어/프레임워크 | 패키지 | GitHub |
+|----------------|--------|--------|
+| Python (순수) | `sendgo-python` | [python](https://github.com/send-go/python) |
+| Laravel | `sendgo/laravel` | [laravel](https://github.com/send-go/laravel) |
+| Spring Boot | `io.sendgo:sendgo-spring` | [spring](https://github.com/send-go/spring) |
+| Node.js | `@sendgo/node` | [node](https://github.com/send-go/node) |
+| 전체 목록 | — | [send-go GitHub 조직](https://github.com/send-go) |
+
+---
+
+## 라이선스
+
+MIT License © 2026 [Sendgo](https://sendgo.io)
+
+---
+
+*키워드: 카카오 알림톡 Django, 카카오 친구톡 Django, SMS 발송 Django, 알림톡 Django 패키지, Django 카카오 API 연동, Sendgo Django SDK*

sendgo_django-1.0.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sendgo-django"
+version = "1.0.0"
+description = "Sendgo Django 확장 — 카카오 알림톡/친구톡, SMS/LMS/MMS"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [{name = "Sendgo", email = "dev@sendgo.io"}]
+keywords = ["sendgo", "django", "kakao", "alimtalk", "sms", "notification", "korea"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Web Environment",
+    "Framework :: Django",
+    "Framework :: Django :: 4.2",
+    "Framework :: Django :: 5.0",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+requires-python = ">=3.10"
+dependencies = [
+    "sendgo-python>=1.0",
+    "Django>=4.2",
+]
+
+[project.urls]
+Homepage = "https://sendgo.io"
+Repository = "https://github.com/send-go/django"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["sendgo_django*"]

sendgo_django-1.0.0/sendgo_django/__init__.py

@@ -0,0 +1,37 @@
+"""
+Sendgo Django 확장 — 카카오 알림톡/친구톡, SMS/LMS/MMS
+
+Django 프로젝트에서 Sendgo 코어(`sendgo-python`)를 손쉽게 사용할 수 있도록
+설정 기반의 클라이언트 생성과 지연 로딩 프록시를 제공합니다.
+
+사용법:
+    # settings.py
+    INSTALLED_APPS += ["sendgo_django"]
+
+    SENDGO = {
+        "ACCESS_KEY": "your_access_key",
+        "SECRET_KEY": "your_secret_key",
+        "KAKAO_SENDER_KEY": "your_kakao_key",
+        "SMS_SENDER_KEY": "your_sms_key",
+        "API_VERSION": "v2",
+    }
+
+    # views.py
+    from sendgo_django import client
+
+    client.alimtalk.send(
+        template_code="ORDER_CONFIRM_001",
+        contacts=[{"contact": "01012345678", "var1": "ORD-001"}],
+    )
+"""
+
+from django.utils.functional import SimpleLazyObject
+
+from .conf import get_client
+
+# 설정이 없어도 임포트 자체는 실패하지 않도록, 실제 접근 시점에만
+# get_client()를 호출하는 지연 프록시를 제공합니다.
+client = SimpleLazyObject(get_client)
+
+__all__ = ["get_client", "client"]
+__version__ = "1.0.0"

sendgo_django-1.0.0/sendgo_django/apps.py

@@ -0,0 +1,25 @@
+import warnings
+
+from django.apps import AppConfig
+
+
+class SendgoConfig(AppConfig):
+    """Sendgo Django 확장 앱 설정."""
+
+    name = "sendgo_django"
+    verbose_name = "Sendgo 메시지 발송"
+
+    def ready(self) -> None:
+        """앱 로드 시 SENDGO 설정 존재 여부를 검증합니다.
+
+        설정이 없더라도 앱 로딩을 막지 않고 경고만 출력합니다.
+        (실제 클라이언트 생성 시점에 ImproperlyConfigured가 발생합니다.)
+        """
+        from django.conf import settings
+
+        if not getattr(settings, "SENDGO", None):
+            warnings.warn(
+                "settings.SENDGO 설정이 없습니다. "
+                "Sendgo 클라이언트를 사용하려면 SENDGO 딕셔너리를 정의하세요.",
+                stacklevel=2,
+            )

sendgo_django-1.0.0/sendgo_django/conf.py

@@ -0,0 +1,62 @@
+"""Sendgo Django 설정 로딩 및 클라이언트 생성 모듈.
+
+`settings.SENDGO` 딕셔너리를 읽어 `Sendgo` 코어 클라이언트를 생성/메모이즈합니다.
+"""
+
+from __future__ import annotations
+
+from typing import Optional
+
+from django.conf import settings
+from django.core.exceptions import ImproperlyConfigured
+from sendgo import Sendgo
+
+# 기본값
+DEFAULT_API_VERSION = "v2"
+DEFAULT_BASE_URL = "https://sendgo.io"
+
+# 메모이즈된 클라이언트 인스턴스
+_client: Optional[Sendgo] = None
+
+
+def _get_settings() -> dict:
+    """settings.SENDGO 딕셔너리를 반환합니다. 없으면 빈 딕셔너리."""
+    return getattr(settings, "SENDGO", None) or {}
+
+
+def get_client() -> Sendgo:
+    """설정 기반 Sendgo 클라이언트를 생성하고 메모이즈합니다.
+
+    ACCESS_KEY 또는 SECRET_KEY가 없으면 ImproperlyConfigured 예외를 발생시킵니다.
+    """
+    global _client
+
+    if _client is not None:
+        return _client
+
+    config = _get_settings()
+
+    access_key = config.get("ACCESS_KEY")
+    secret_key = config.get("SECRET_KEY")
+
+    if not access_key or not secret_key:
+        raise ImproperlyConfigured(
+            "Sendgo 설정이 올바르지 않습니다. "
+            "settings.SENDGO 에 ACCESS_KEY 와 SECRET_KEY 를 지정하세요."
+        )
+
+    _client = Sendgo(
+        access_key=access_key,
+        secret_key=secret_key,
+        kakao_sender_key=config.get("KAKAO_SENDER_KEY"),
+        sms_sender_key=config.get("SMS_SENDER_KEY"),
+        api_version=config.get("API_VERSION", DEFAULT_API_VERSION),
+        base_url=config.get("BASE_URL", DEFAULT_BASE_URL),
+    )
+    return _client
+
+
+def reset() -> None:
+    """메모이즈된 클라이언트를 초기화합니다. (주로 테스트용)"""
+    global _client
+    _client = None

sendgo_django-1.0.0/sendgo_django.egg-info/PKG-INFO

@@ -0,0 +1,297 @@
+Metadata-Version: 2.4
+Name: sendgo-django
+Version: 1.0.0
+Summary: Sendgo Django 확장 — 카카오 알림톡/친구톡, SMS/LMS/MMS
+Author-email: Sendgo <dev@sendgo.io>
+License: MIT
+Project-URL: Homepage, https://sendgo.io
+Project-URL: Repository, https://github.com/send-go/django
+Keywords: sendgo,django,kakao,alimtalk,sms,notification,korea
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+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
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: sendgo-python>=1.0
+Requires-Dist: Django>=4.2
+Dynamic: license-file
+
+# sendgo-django
+
+> **Django에서 카카오 알림톡, 친구톡, SMS를 가장 쉽게 발송하는 공식 Django 확장 패키지**
+
+[![PyPI](https://img.shields.io/pypi/v/sendgo-django)](https://pypi.org/project/sendgo-django/)
+[![Django](https://img.shields.io/badge/Django-4.2%2B-092E20?logo=django)](https://www.djangoproject.com)
+[![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python)](https://python.org)
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+
+`sendgo-django`는 [`sendgo-python`](https://github.com/send-go/python) 코어를 확장한 **Django 전용 패키지**입니다.
+`settings.SENDGO` 설정 기반의 클라이언트 생성, 지연 로딩 프록시(`client`), AppConfig 통합을 제공합니다.
+
+---
+
+## 목차
+
+- [설치](#설치)
+- [빠른 시작](#빠른-시작)
+- [프록시 사용법](#프록시-사용법)
+- [상세 사용법](#상세-사용법)
+  - [알림톡](#알림톡)
+  - [친구톡](#친구톡)
+  - [SMS / LMS / MMS](#sms--lms--mms)
+- [서비스 클래스 패턴](#서비스-클래스-패턴)
+- [예외 처리](#예외-처리)
+- [설정 옵션](#설정-옵션)
+- [자주 묻는 질문](#자주-묻는-질문-faq)
+
+---
+
+## 설치
+
+```bash
+pip install sendgo-django
+```
+
+`sendgo-python` 코어는 의존성으로 자동 설치됩니다.
+
+---
+
+## 빠른 시작
+
+### 1단계 — `INSTALLED_APPS` 등록 (`settings.py`)
+
+```python
+INSTALLED_APPS += ["sendgo_django"]
+```
+
+### 2단계 — `SENDGO` 설정 추가 (`settings.py`)
+
+```python
+import os
+
+SENDGO = {
+    "ACCESS_KEY": os.environ["SENDGO_ACCESS_KEY"],
+    "SECRET_KEY": os.environ["SENDGO_SECRET_KEY"],
+    "KAKAO_SENDER_KEY": os.environ.get("SENDGO_KAKAO_SENDER_KEY"),
+    "SMS_SENDER_KEY": os.environ.get("SENDGO_SMS_SENDER_KEY"),
+    "API_VERSION": "v2",
+    # "BASE_URL": "https://sendgo.io",  # 기본값
+}
+```
+
+### 3단계 — 뷰에서 알림톡 전송
+
+```python
+# views.py
+from django.http import JsonResponse
+from sendgo_django import client
+
+
+def confirm_order(request, order_id):
+    order = get_order(order_id)
+
+    client.alimtalk.send(
+        template_code="ORDER_CONFIRM_001",
+        contacts=[
+            {
+                "contact": order.phone,
+                "name": order.name,
+                "var1": order.number,
+                "var2": f"{order.total:,}원",
+            },
+        ],
+    )
+
+    return JsonResponse({"success": True})
+```
+
+---
+
+## 프록시 사용법
+
+`sendgo_django.client`는 `SimpleLazyObject` 기반 **지연 로딩 프록시**입니다.
+패키지를 임포트하는 시점에는 클라이언트를 생성하지 않고, 실제로 속성에 접근할 때
+`get_client()`를 호출합니다. 따라서 설정이 없어도 임포트만으로는 오류가 나지 않습니다.
+
+```python
+from sendgo_django import client
+
+# 알림톡 발송
+client.alimtalk.send(
+    template_code="ORDER_CONFIRM_001",
+    contacts=[{"contact": "01012345678", "var1": "ORD-001"}],
+)
+
+# SMS 발송
+client.sms.send_sms(
+    content="[인증] 인증번호: 123456",
+    contacts=[{"contact": "01012345678"}],
+)
+```
+
+명시적으로 인스턴스를 얻고 싶다면 `get_client()`를 직접 호출할 수 있습니다.
+
+```python
+from sendgo_django import get_client
+
+sendgo = get_client()
+sendgo.friendtalk.send(content="안녕하세요!", contacts=[{"contact": "01012345678"}])
+```
+
+---
+
+## 상세 사용법
+
+### 알림톡
+
+```python
+from sendgo_django import client
+
+# 다건 발송
+client.alimtalk.send(
+    template_code="ORDER_CONFIRM_001",
+    contacts=[
+        {"contact": "01011111111", "name": "홍길동", "var1": "ORD-001", "var2": "29,000원"},
+        {"contact": "01022222222", "name": "김철수", "var1": "ORD-002", "var2": "15,000원"},
+    ],
+)
+```
+
+### 친구톡
+
+```python
+from sendgo_django import client
+
+# 텍스트형
+client.friendtalk.send(
+    content="안녕하세요! 7월 한정 특가 이벤트를 확인해보세요.",
+    contacts=[{"contact": "01012345678"}],
+)
+```
+
+### SMS / LMS / MMS
+
+```python
+from sendgo_django import client
+
+# SMS (90자 이하)
+client.sms.send_sms(
+    content="[Sendgo] 인증번호: 123456 (5분 이내 입력)",
+    contacts=[{"contact": "01012345678"}],
+)
+```
+
+---
+
+## 서비스 클래스 패턴
+
+```python
+# app/services.py
+import logging
+
+from sendgo import SendgoError
+from sendgo_django import client
+
+logger = logging.getLogger(__name__)
+
+
+class NotificationService:
+    """알림 발송 로직을 캡슐화한 서비스 클래스."""
+
+    def send_order_confirm(self, phone: str, order_no: str, amount: int) -> None:
+        client.alimtalk.send(
+            template_code="ORDER_CONFIRM_001",
+            contacts=[{"contact": phone, "var1": order_no, "var2": f"{amount:,}원"}],
+        )
+
+    def send_verification_code(self, phone: str, code: str) -> None:
+        try:
+            client.alimtalk.send(
+                template_code="VERIFY_CODE_001",
+                contacts=[{"contact": phone, "var1": code}],
+            )
+        except SendgoError:
+            logger.exception("Sendgo 인증번호 발송 실패")
+            raise
+```
+
+---
+
+## 예외 처리
+
+```python
+from sendgo import SendgoError
+from sendgo_django import client
+
+try:
+    client.alimtalk.send(
+        template_code="ORDER_CONFIRM_001",
+        contacts=[{"contact": "01012345678", "var1": "ORD-001"}],
+    )
+except SendgoError as e:
+    logger.error("Sendgo 발송 실패: %s", e)
+```
+
+---
+
+## 설정 옵션
+
+`settings.SENDGO` 딕셔너리 키:
+
+| 키 | 필수 | 기본값 | 설명 |
+|----|------|--------|------|
+| `ACCESS_KEY` | ✅ | — | Sendgo 액세스 키 |
+| `SECRET_KEY` | ✅ | — | Sendgo 시크릿 키 |
+| `KAKAO_SENDER_KEY` | | `None` | 카카오 발신프로필 키 |
+| `SMS_SENDER_KEY` | | `None` | SMS 발신자 키 |
+| `API_VERSION` | | `"v2"` | API 버전 |
+| `BASE_URL` | | `"https://sendgo.io"` | API 기본 URL |
+
+`ACCESS_KEY` 또는 `SECRET_KEY`가 없으면 클라이언트 생성 시 `django.core.exceptions.ImproperlyConfigured`가 발생합니다.
+
+---
+
+## 자주 묻는 질문 (FAQ)
+
+**Q. `sendgo-python`과의 차이는 무엇인가요?**
+A. `sendgo-python`은 프레임워크 독립적인 순수 Python 코어 패키지입니다. `sendgo-django`는 이를 확장해 `settings.SENDGO` 설정 바인딩, 지연 로딩 프록시, AppConfig 통합을 추가합니다.
+
+**Q. 설정 없이 임포트하면 오류가 나나요?**
+A. 아니요. `client`는 지연 프록시이므로 임포트만으로는 오류가 없고, 실제 사용(속성 접근) 시점에 설정을 검증합니다.
+
+**Q. 테스트 시 클라이언트를 초기화하려면?**
+A. `sendgo_django.conf.reset()`을 호출하면 메모이즈된 클라이언트가 초기화됩니다.
+
+**Q. Django 4.2, 5.x를 지원하나요?**
+A. 네, `Django>=4.2`를 지원합니다.
+
+---
+
+## 관련 패키지
+
+| 언어/프레임워크 | 패키지 | GitHub |
+|----------------|--------|--------|
+| Python (순수) | `sendgo-python` | [python](https://github.com/send-go/python) |
+| Laravel | `sendgo/laravel` | [laravel](https://github.com/send-go/laravel) |
+| Spring Boot | `io.sendgo:sendgo-spring` | [spring](https://github.com/send-go/spring) |
+| Node.js | `@sendgo/node` | [node](https://github.com/send-go/node) |
+| 전체 목록 | — | [send-go GitHub 조직](https://github.com/send-go) |
+
+---
+
+## 라이선스
+
+MIT License © 2026 [Sendgo](https://sendgo.io)
+
+---
+
+*키워드: 카카오 알림톡 Django, 카카오 친구톡 Django, SMS 발송 Django, 알림톡 Django 패키지, Django 카카오 API 연동, Sendgo Django SDK*

sendgo_django-1.0.0/sendgo_django.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+sendgo_django/__init__.py
+sendgo_django/apps.py
+sendgo_django/conf.py
+sendgo_django.egg-info/PKG-INFO
+sendgo_django.egg-info/SOURCES.txt
+sendgo_django.egg-info/dependency_links.txt
+sendgo_django.egg-info/requires.txt
+sendgo_django.egg-info/top_level.txt

sendgo_django-1.0.0/sendgo_django.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

sendgo_django-1.0.0/sendgo_django.egg-info/requires.txt

@@ -0,0 +1,2 @@
+sendgo-python>=1.0
+Django>=4.2

sendgo_django-1.0.0/sendgo_django.egg-info/top_level.txt

@@ -0,0 +1 @@
+sendgo_django

sendgo_django-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+