Metadata-Version: 2.5
Name: siwon-pokemon-package-2026
Version: 1.0.0
Summary: Pokemon classification package by region and custom type groups
Author: Siwon Song
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# Pokemon Package

고급파이썬데이터분석 과제를 위해 제작한 Python 패키지입니다.

이 패키지는 포켓몬을 지역과 사용자 정의 타입군을 기준으로
계층적으로 분류하여 구성하였습니다.

## 패키지 구조

    Pokemon
    └── Region
        └── Type Group
            └── Pokemon Module

## 지역 분류

총 10개의 지역을 기준으로 포켓몬을 분류하였습니다.

- Kanto (관동)
- Johto (성도)
- Hoenn (호연)
- Sinnoh (신오)
- Unova (하나)
- Kalos (칼로스)
- Alola (알로라)
- Galar (가라르)
- Hisui (히스이)
- Paldea (팔데아)

## 타입군 분류

기존 포켓몬의 속성과 특수 분류를 과제 목적에 맞게
다음과 같이 5개의 타입군으로 재분류하였습니다.

### 1. 원소 타입 (Elemental)

- 불꽃
- 물
- 풀
- 전기

### 2. 필드·자연 타입 (Field & Nature)

- 노말
- 비행
- 벌레
- 독

### 3. 물리·대지 타입 (Physical & Earth)

- 격투
- 땅
- 바위
- 강철
- 얼음

### 4. 신비·이계 타입 (Mystic & Otherworld)

- 에스퍼
- 고스트
- 악
- 페어리

### 5. 용·신화 타입 (Dragon & Mythic)

- 드래곤
- 전설 포켓몬
- 환상 포켓몬
- 패러독스 포켓몬

## 사용 예시

    from pokemon.kanto.elemental.pikachu import introduce

    introduce()

실행 결과:

    Pikachu is a representative Pokemon from the Kanto region, classified in the Elemental group.

## 패키지 설계

본 패키지는 다음과 같은 3단계 계층 구조로 설계되었습니다.

1. 지역
2. 사용자 정의 타입군
3. 개별 포켓몬 모듈

각 포켓몬 모듈에는 introduce() 함수 1개가 포함되어 있으며,
해당 포켓몬이 속한 지역과 타입군 정보를 출력합니다.

## 분류 기준

본 프로젝트의 타입군은 포켓몬의 공식 타입 분류 체계를
그대로 사용하는 것이 아니라 Python 패키지와 서브패키지의
계층 구조를 표현하기 위해 교육 목적으로 재구성한
사용자 정의 분류 체계입니다.

복수 타입이나 특수 분류에 해당하는 포켓몬은
패키지 구조의 일관성을 유지하기 위해 하나의 대표 타입군에
배정하였습니다.

## 프로젝트 목적

이 프로젝트의 목적은 Python의 패키지, 서브패키지,
모듈 구조를 이해하고 이를 실제 계층형 분류에 적용하는 것입니다.

포켓몬을 지역과 타입군으로 단계적으로 분류함으로써
Python 패키지의 계층 구조를 직관적으로 표현하였습니다.

## Disclaimer

Pokemon 관련 명칭 및 개념의 권리는 해당 권리자에게 있으며,
본 패키지는 과제 수행을 위해 제작되었습니다.
