Metadata-Version: 2.4
Name: scom-debug-helper
Version: 0.1.1
Summary: Playwright-based web debugging automation helper
Author-email: Yunji Jang <yunji.jang1@concentrix.com>
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: playwright<2.0.0,>=1.40.0
Requires-Dist: click>=8.0.0
Dynamic: license-file

# Scom Debug Helper (v0.1.1)

웹 페이지 자동 클릭 및 분석 도구

## 기본 가이드

### 1. 최초 설치
```bash
pip install scom-debug-helper
playwright install chromium
```

### 2. 프로젝트 생성
아래 명령어 실행 후 프롬프트에 따라 정보를 입력해 주세요.

```bash
debug-helper setup
```

### 3. URL 입력
생성된 프로젝트 폴더에서 `urls.csv` 파일을 열어 URL 목록 입력해 주세요.

```
https://www.samsung.com/uk/
https://www.samsung.com/uk/smartphones/
```

### 4. 타겟 선택자 변경 (optional)
생성된 프로젝트 폴더에서 `selector.csv`, `exclude.csv` 파일을 수정하여 기본 선택자 또는 제외할 선택자를 수정할 수 있습니다. CSS 문법을 참고하여 작성해 주세요.

### 5. 실행
VS Code 터미널(Ctrl+\`) 또는 명령 프롬프트에서 아래 명령어로 실행합니다. 결과는 `output` 폴더에 저장됩니다.
`{프로젝트 폴더 경로}`에 생성한 프로젝트 폴더의 경로를 복사하여 넣어 주세요.

```bash
cd {프로젝트 폴더 경로}
debug-helper run
```
<br>

## 명령어

```bash
# 프로젝트 생성
debug-helper setup

# 실행
debug-helper run

## 특정 컴포넌트만 실행
debug-helper run --only-components {컴포넌트명}

# 컴포넌트 관리 (조회/생성/검증)
debug-helper components list
debug-helper components create {컴포넌트명}
debug-helper components validate {컴포넌트명}.py

# 버전 확인
debug-helper --version

# 도움말
debug-helper --help
```

## 추가 예정 기능
- SEC 사이트 수집 로직 추가
- 실행 로그 저장 및 디버그 버전 추가
- 내장 가이드 문서 추가 및 도움말 개선
- 수집 데이터 중간 저장
