Metadata-Version: 2.4
Name: kakaome
Version: 0.1.1
Summary: Send KakaoTalk messages to your own chat from the command line
License-Expression: MIT
License-File: LICENSE
Keywords: cli,kakao,kakaotalk,message
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# kakaome

카카오톡 **나에게 보내기** REST API를 사용하는 작은 Python CLI입니다.

> 비공식 프로젝트이며 Kakao Corp.와 제휴하거나 Kakao가 보증하는 제품이 아닙니다.

## 설치

```console
pipx install kakaome
```

개발 버전은 프로젝트 디렉터리에서 다음과 같이 실행할 수 있습니다.

```console
uv sync
uv run kakaome --help
```

## Kakao Developers 설정

1. 앱에서 **카카오 로그인**을 활성화합니다.
2. Redirect URI로 `http://127.0.0.1:8765/callback`을 등록합니다.
3. 동의 항목에서 **카카오톡 메시지 전송 (`talk_message`)**을 활성화합니다.
4. **제품 링크 > 웹 도메인**에 기본값인 `https://pypi.org`를 등록합니다.

REST API 키와 기본 링크를 저장하고 최초 한 번 로그인합니다.

```console
kakaome configure --rest-api-key YOUR_KEY
kakaome auth
```

Client Secret 기능을 활성화한 앱은 `--client-secret`도 지정합니다.
기본 메시지 링크는 `https://pypi.org/project/kakaome/`입니다. 다른 주소를 쓰려면
해당 도메인을 제품 링크에 등록하고 `--default-link`로 지정합니다.

## 사용

```console
kakaome send "배치 작업이 완료되었습니다."
kakaome send "결과 보기" --link https://example.com/report
kakaome send "오늘의 결과" --image-url https://example.com/result.png
```

카카오 기본 텍스트 템플릿은 링크를 필수로 요구하고 최대 200자까지 지원합니다.
`--image-url`은 인터넷에서 공개 접근 가능한 이미지여야 합니다. PDF나 ZIP 같은 로컬
파일을 카카오톡 첨부파일로 직접 업로드하는 기능은 공식 나에게 보내기 REST API에서
지원하지 않습니다.

설정과 OAuth 토큰은 Windows의 `%APPDATA%\kakaome\config.json` 또는 다른
운영체제의 `~/.config/kakaome/config.json`에 저장됩니다. 경로는
`KAKAOME_CONFIG` 환경 변수로 바꿀 수 있습니다.

## 배포 빌드

```console
uv build
uv run twine check dist/*
```
