https://github.com/bamjun/fown
Tiny Python CLI for GitHub label and project automation.
https://github.com/bamjun/fown
Last synced: 5 months ago
JSON representation
Tiny Python CLI for GitHub label and project automation.
- Host: GitHub
- URL: https://github.com/bamjun/fown
- Owner: bamjun
- License: mit
- Created: 2025-05-01T07:50:25.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-27T01:19:42.000Z (9 months ago)
- Last Synced: 2025-09-27T03:19:56.558Z (9 months ago)
- Language: Python
- Size: 221 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# fown
GitHub CLI를 활용하여 GitHub 레이블과 프로젝트를 자동화하는 작은 Python CLI 도구입니다.
## 목차
- [설치 방법](#설치-방법)
- [사용 방법](#사용-방법)
- [아카이브 레포지토리 생성](#아카이브-레포지토리-생성)
- [레이블 동기화](#레이블-동기화)
- [스크립트 관리](#스크립트-관리)
- [파일 관리](#파일-관리)
- [기능](#기능)
- [auth](#auth)
- [file](#file)
- [make-fown-archive](#make-fown-archive)
- [noti](#noti)
- [요구사항](#요구사항)
- [문서](#문서)
- [라이선스](#라이선스)
설치 방법
### uvx를 이용한 사용방법
```bash
# 모든 레이블 삭제
uvx fown labels clear-all
# 기본 레이블 추가
uvx fown labels apply
```
### pip을 통한 설치
```bash
pip install fown
```
사용 방법
아카이브 레포지토리 생성
```bash
# 기본: private 레포지토리 생성
fown make-fown-archive
# public 레포지토리 생성
fown make-fown-archive --public
```
레이블 동기화
```bash
# 기본 레이블로 동기화
fown labels sync
# 아카이브 레포지토리에서 동기화
fown labels sync --archive
# gist url 로 동기화
fown labels sync --gist-url https://gist.github.com/bamjun/09cdc4efefb7abb58717025aa2ba3cfc#file-backend_github_labels-json
```
스크립트 관리
```bash
# 스크립트 실행
fown script use
# 스크립트 추가 (.sh 파일만 지원)
fown script add
# 스크립트 다운로드
fown script load
# 스크립트 삭제
fown script delete
```
파일 관리
```bash
# 파일 추가
fown file add <파일이름 or 폴더이름>
# 파일 다운로드
fown file load
# 파일 삭제
fown file delete
```
기능
- GitHub 레이블 생성, 업데이트, 동기화
- GitHub 프로젝트 자동 관리
- 설정 파일을 통한 일괄 작업
- 빠르고 간단한 설정
- GitHub CLI (`gh`) 기반 동작
auth
- GitHub 인증
---
- Github login
```bash
# Github 로그인
fown auth login
```
- Github logout
```bash
# Github 로그아웃
fown auth logout
```
- 인증 상태
```bash
# 로그인 상태
fown auth status
```
file
- 기본 레포지토리에서 파일 관리
---
```bash
# 기본 레포지토리에 파일저장
fown file add
```
```bash
# 기본 레포지토리에서 파일 다운로드
fown file load
```
```bash
# 기본 레포지토리에서 파일삭제
fown file delete
```
make-fown-archive
- 로그인한 유저의 깃허브 레포지토리에 기본 레포지토리 생성
---
```bash
# 기본 레포지토리 생성
fown make-fown-archive
```
noti
- github notifications 알림 읽음 처리
```bash
# 알림별 읽음 처리
fown noti delete
```
```bash
# 레포별 전체 알림 읽음처리
fown noti delete -r
```
```bash
# 특정레포 전체 알림 읽음 처리
fown noti delete owner/repo
```
```bash
# 특정레포 전체 알림 읽음 처리
fown noti delete owner/repo -r
```
요구사항
- Python 3.12 이상
문서
- [테스트 서버 PyPI](https://test.pypi.org/project/fown/)
- [메인 서버 PyPI](https://pypi.org/project/fown/)
- [GitHub](https://github.com/bamjun/fown)
라이선스
MIT License
# example
