Metadata-Version: 2.4
Name: hastock
Version: 0.1.0
Summary: Terminal stock ticker for Korean users — 한국 주식 터미널 티커
Author: sangbomha-handh
License-Expression: MIT
Project-URL: Homepage, https://github.com/sangbomha-handh/hastock
Project-URL: Repository, https://github.com/sangbomha-handh/hastock
Project-URL: Issues, https://github.com/sangbomha-handh/hastock/issues
Keywords: stock,ticker,terminal,korean,cli
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: yfinance>=0.2
Requires-Dist: rich>=13.0
Dynamic: license-file

# hastock

한국 개발자를 위한 터미널 주식 티커. ticker의 한국 시장 대안.

![Python](https://img.shields.io/badge/python-3.10+-blue)
![License](https://img.shields.io/badge/license-MIT-green)

## 특징

- 한국(코스피) + 미국(NASDAQ/NYSE) 동시 모니터링
- 한글 기업명 표시
- 스파크라인 차트로 추이 한눈에 파악
- 등락률 색상 표시 (상승 초록 / 하락 빨강)
- 장 상태 표시 (장전, 장중, 장후)
- USD/KRW 환율 표시
- 설정 없이 바로 사용 (API 키 불필요)

## 설치

```bash
pip install hastock
```

## 사용법

```bash
hastock
```

실행하면 한국/미국 주요 종목 50개가 자동 표시됩니다.

### 명령어

타이핑하면 바로 명령 모드에 진입합니다.

| 명령어 | 설명 |
|--------|------|
| `find [검색어]` | 기업 검색 (예: `find 카카오`, `find TSLA`) |
| `add [종목코드]` | 즐겨찾기 추가 (예: `add 035720.KS`) |
| `remove [종목코드]` | 즐겨찾기 삭제 |
| `scale [기간]` | 기간 변경 (day/week/month/year) |
| `quit` | 종료 |

`ESC` — 명령 취소

### 화면 구성

```
상태   거래소   기업명          등락률        현재가      거래량   추이 →현재
장중   코스피   삼성전자        -1.49%     ₩280,250       27.9M   ▇▆▅▃▂▁▂▃▄▅·····
장전   NASDAQ   Apple          -0.64%       $310.66       42.1M   ▇▅▄▃▂▁▂▃▅▆·····
```

## 데이터 소스

Yahoo Finance (비공식 API). API 키 불필요.

## 라이선스

MIT
