10 releases (stable)
2.0.0 | May 1, 2024 |
---|---|
1.2.2 | May 1, 2024 |
1.2.1 | Jul 17, 2022 |
1.1.0 | Apr 11, 2022 |
0.1.1 | Mar 5, 2022 |
#32 in Internationalization (i18n)
562 downloads per month
75KB
2K
SLoC
ogk - cli tool for open.go.kr
정보공개포털 계정이 있고 플랫폼을 자주 사용하는 사용자라면 공식웹사이트보다 편리하게 데이터 및 파일을 관리할 수 있도록 돕기 위한 프로젝트입니다.
후원하기
설치하기
: 현재 ogk
는 Homebrew 혹은 Cargo를 통해서 설치가 가능합니다.
homebrew
brew tap opengirok/ogk
brew install ogk
cargo
cargo install ogk
설정하기
# 1. 계정 설정
# 정보공개플랫폼 계정 설정(open.go.kr에 등록된 계정이어야 합니다.)
ogk auth login --username <username> --password <password>
# 2. 파일 관리 설정
# 내컴퓨터에 저장할 파일 위치를 지정합니다.
# 기본값: ~/.ogk/.data
ogk config files --local-repository /Path/to/local/repository
# 3.에서 생성한 원격저장소 주소를 지정합니다.
# 현재 버전(v0.1)에서는 원격저장소가 반드시 지정되어야 파일 관리가 가능합니다.
# 예: ogk config files --remote-repository hoonyland/data
ogk config files --remote-repository <user_or_org-name/repository_name>
# 3. supabase (데이터베이스) 설정
# [Supabase 설정하기](docs/supabase.md) 문서를 참고하여 Supabase 설정을 먼저 완료하시길 바랍니다.
# 위 설정 후 Supabase에서 발급받은 host, api key를 등록합니다.
ogk config sync --supabase-host https://****.supabase.co
ogk config sync --supabase-api-key ****
# 4. SLACK 알림 설정
# Slack Webhook을 생성한 뒤 URL을 설정합니다.
# 각 명령 뒤에 `--with-slack-notification true` 를 붙이면 슬랙 알림이 함께 갑니다.
ogk config integration --slack-webhook-url https://****.slack.com
파일 관리를 위한 요구사항
사용하기
1. 조회하기
- 날짜 & 페이지 단위 조회
ogk fetch bills --from 2021-01-01 --to 2020-12-31 --page 1
2. 파일 다운로드
: 설정하기에서 파일관리를 위한 설정이 선행되어야 합니다.
ogk download --from 2021-01-01 --to 2021-12-31
3. 데이터 조회 및 저장하기
: 설정하기에서 supabase 등록 및 설정이 선행되어야 합니다.
# 1. 기본 조회 및 저장
ogk sync --from 2021-01-01 --to 2021-12-31
# 2. 현재 설정된 Supabase 데이터베이스에서 통지완료되지 않은 건들만 새로 업데이트
# `--from`과 `--to` 옵션을 지정하지 않습니다.
ogk sync
TroubleShooting
- ubuntu 환경에서는
pkg-config
,libssl-dev
설치가 필요합니다.sudo apt-get install pkg-config libssl-dev
Roadmap
1. 계정 보안
- open.go.kr 계정 관리 보안 강화
외부 라이브러리
기여자
License
Dependencies
~25–38MB
~630K SLoC