dgsw-classroom

dgsw-classroom

대구소프트웨어마이스터고 학생을 위한 Google Classroom CLI. Claude Code 플러그인으로 설치하면 자연어로 과제 조회/제출이 가능합니다.

기능

• 수업 목록 조회
• 과제 목록 및 상세 조회
• 과제 제출 (링크 첨부 가능)
• 과제 회수
• Claude Code 스킬 연동

설치

Claude Code 플러그인으로 설치 (권장)

마켓플레이스 추가:

/plugin marketplace add tumblecat44/DGSW-life-AI-Native

플러그인 설치:

/plugin install dgsw-classroom@dgsw-classroom-marketplace

또는 Git URL로 직접:

/plugin marketplace add https://github.com/tumblecat44/DGSW-life-AI-Native.git

설치 후 초기 설정:

/dgsw-classroom:classroom-setup

OAuth JSON 파일 경로만 알려주면 패키지 설치 + 인증을 자동으로 처리합니다.

수동 설치

git clone https://github.com/tumblecat44/DGSW-life-AI-Native.git
cd DGSW-life-AI-Native
pip3 install google-api-python-client google-auth-oauthlib google-auth-httplib2

GCP OAuth 설정 (필수)

1. Google Cloud Console 접속 (학교 계정)
2. 프로젝트 생성 또는 선택
3. API 및 서비스 > 라이브러리 → Google Classroom API 활성화
4. API 및 서비스 > OAuth 동의 화면 설정
   • 사용자 유형: 내부 (학교 Workspace 계정)
   • 범위 추가:
     • classroom.courses.readonly
     • classroom.coursework.me
     • classroom.coursework.students.readonly
5. API 및 서비스 > 사용자 인증 정보 > + 만들기 > OAuth 클라이언트 ID
   • 유형: 데스크톱 앱
   • JSON 다운로드

사용법

Claude Code 스킬

/dgsw-classroom:classroom          # 과제 관리
/dgsw-classroom:classroom-setup    # 초기 설정

자연어로도 가능:

• "과제 확인해줘" → 수업별 과제 목록
• "웹사이트 제작 과제 제출해줘" → 해당 수업 과제 제출

CLI 직접 사용

# 수업 목록
python3 classroom/classroom.py courses

# 과제 목록
python3 classroom/classroom.py assignments <수업ID 또는 수업이름>

# 과제 상세
python3 classroom/classroom.py detail <수업ID> <과제ID>

# 과제 제출
python3 classroom/classroom.py submit <수업ID> <과제ID>

# 링크 첨부하고 제출
python3 classroom/classroom.py submit <수업ID> <과제ID> --link https://github.com/user/repo

# 제출 취소
python3 classroom/classroom.py reclaim <수업ID> <과제ID>

주의사항

• credentials.json과 token.pickle은 개인 인증 정보입니다. 절대 git에 올리지 마세요.
• 학교 IT 관리자가 API를 차단한 경우 403 오류가 발생할 수 있습니다.

License

MIT