깃허브를 활용한 다양한 도구 개발 [개발 워크플로 최적화]
- 원서명Building Tools with GitHub: Customize Your Workflow (ISBN 978-1491933503)
- 지은이크리스 도슨(Chris Dawson), 벤 스트라우브(Ben Straub)
- 옮긴이김영기, 곽서연
- ISBN : 9791161752273
- 30,000원
- 2018년 10월 29일 펴냄 (절판)
- 페이퍼백 | 412쪽 | 188*235mm
- 시리즈 : 오픈소스 프로그래밍
판매처
- 현재 이 도서는 구매할 수 없습니다.
책 소개
소스 코드 파일은 여기에서 내려 받으실 수 있습니다.
요약
GitHub의 활용에 대한 가이드로 소프트웨어 도구를 개발하기 위해 GitHub 워크플로우를 최적화하는 방법을 보여준다. 각 장에 있는 실습 내용은 다양한 GitHub를 활용해 애플리케이션을 개발하는 데 도움이 되는 사항을 다루고 있다.
GitHub에 익숙한 숙련된 프로그래머라면 GitHub API의 활용 방법과 Jekyll(사이트 빌더), Hubot(Node JS 챗봇) 및 Gollum(위키) 같은 오픈소스 도구의 학습을 통해 GitHub를 활용하는 방법을 학습하게 될 것이다.
이 책에서 다루는 내용
█ Gist API 명령행 도구와 루비의 Octokit API 클라이언트로 간단한 루비 서버 구축
█ 이미지 관리 애플리케이션을 만들기 위한 Gollum 명령행 도구 활용
█ GitHub 검색을 위한 파이썬 GUI 도구 작성
█ 서드파티 도구와 자체 코드 사이의 상호 작용에 관한 문서화
█ Jekyll을 이용해 GitHub 저장소 자료를 갖고 완전한 기능을 갖는 블로그 생성
█ Jekyll 저장소 내의 정보를 읽고 쓰는 안드로이드용 모바일 애플리케이션 작성
█ GitHub에 완전한 단일 페이지 자바스크립트 애플리케이션 호스팅
█ Hubot을 사용한 풀 리퀘스트 리뷰 자동화
이 책의 대상 독자
깃이나 GitHub를 사용해온 사람들과 관련된 기술을 “레벨 업(level-up)”하길 원하는 사람들에게 흥미로운 정보의 소스가 될 것이다. GitHub나 깃을 사용해본 경험이 없는 사람들은 이러한 기술을 소개하는 책으로 시작해야 한다.
이 책을 읽기 위해 전문적인 프로그래머가 될 필요는 없지만, 어느 정도 프로그래밍에 대한 경험이 있어야 하며, 적어도 하나 이상의 언어에 익숙해야 한다.
독자는 HTTP 프로토콜의 기본 사항을 이해하고 있어야 한다. GitHub 팀은 GitHub API에 대해 매우 표준적인 RESTful 접근 방법을 사용한다. 독자들은 GET 요청과 POST 요청 사이의 차이점과 최소한 HTTP 상태 코드가 무엇을 의미하는지 이해하고 있어야 한다.
이 책은 재미있고 강력한 도구를 작성하는 기반이 되며, 면밀히 검토되고 잘 설계된 그리고 잘 테스트된 웹 API를 생성하는 방법에 대해 가이드를 제공한다. 다른 웹 API에 대해 익숙하다면 이 책의 내용을 쉽게 이해할 수 있다. 웹 API를 광범위하게 사용해보지 않았지만 다른 유형의 API를 사용한 경험이 있다면 아무런 걱정할 필요가 없다.
이 책의 구성
1장, ‘기본 GitHub API’에서는 먼저 명령행 HTTP 클라이언트인 cURL을 통해 API에 대해 살펴본다. 응답 형식과 명령행에서 응답을 파싱하는 방법에 대해 알아보고, 문서 인증 방법도 살펴본다. 1장은 제시된 기술로 애플리케이션을 작성하지 않는 유일한 장이다.
2장, ‘Gists와 Gist API’에서는 명령행 도구와 루비 언어 “Octokit” API 클라이언트 그리고 Gist API에 대해 다룬다. 그 후, 이 API를 사용해 gist를 저장하고 gist를 표시하는 간단한 루비(Ruby) 서버를 구축한다.
3장, ‘골룸과 깃허브 위키’에서는은 골룸 명령행 도구와 깃 저장소에 접근하기 위해 C 언어를 바인딩하는 Grit가 지원하는 루비 라이브러리(gem)의 사용법에 대해 설명한다. 또한 깃 저장소 형식에 대한 일부 내용과 깃 저장소 내부에 대규모 파일을 저장하는 방법도 확인한다. 이러한 정보를 사용하기 위해 깃 명령행 도구의 사용 방법을 살펴보고 골룸과 Grit 라이브러리를 사용해 일반적인 골룸 위키로 동작하는 GitHub에 게시할 수 있는 이미지 관리 도구를 만든다.
4장, ‘파이썬과 Search API’에서는 검색 API와 파이썬을 이용해 GitHub상의 저장소를 검색하기 위한 GUI 도구를 작성한다.
5장, ‘.NET과 Commit Status API’에서는은 서드파티 도구와 자체 코드 사이의 상호 작용을 문서화하는 상대적으로 새로운 분야를 다룬다. 5장에서는 C#과 Nancy .NET GitHub API 라이브러리를 이용해 애플리케이션을 작성한다.
GitHub는 특별하게 구성된 저장소를 푸시하는 경우, 워드프레스(Wordpress) 사이트처럼 완전한 기능을 갖춘 블로그를 호스팅한다(물론, 복잡성 부분은 제외한다).
6장, ‘루비와 지킬 블로그’에서는 저장소 형식을 지정하는 방법, 지킬에서 마크다운을 이용하는 방법, 리퀴드(Liquid) 템플릿이 제공하는 프로그래밍 방식의 루핑 구문(looping constructs)을 사용하는 방법에 대해 살펴본다.
그리고 루비를 사용해 지킬 형식으로 인터넷 아카이브로부터 전체 사이트를 가져오는import 방법도 살펴본다. API나 제3자 공개 정보를 사용하는 경우에 유용한 기술 캐싱을 사용해 사이트를 개별로 색인화(spider1)하는 방법도 보여준다.
7장, ‘안드로이드와 Git Data API’에서는 안드로이드 OS를 대상으로 하는 모바일 애플리케이션을 생성한다. 우리의 애플리케이션은 API의 깃 Data 섹션에서 지킬 저장소에 정보를 읽고 쓴다. 그리고 Calabash UI 테스팅 도구를 사용해 GitHub API 응답을 확인하는 안드로이드 전용 사용자 인터페이스 테스트의 작성 방법도 살펴본다.
8장, ‘커피스크립트, 휴봇 그리고 Activity API’ 휴봇은 기술 분야 전문가들이 데브옵스(DevOps)를 넘어 챗옵스(ChatOps)라 불리는 새로운 영역으로 이동할 수 있도록 해주는 자바스크립트(NodeJS) 챗 로봇이다. 8장은 API의 액티비티(Activity)와 풀 리퀘스트(Pull Request) 사용에 대해 설명한다. 또한 GitHub 알림을 시뮬레이션하는 방법과 테스트 가능한 휴봇의 확장 기능 작성법도 살펴본다(자바스크립트 코드로 작성하는 경우, 때때로 문제가 된다). 이러한 모든 사항을 활용하면 리뷰 요청에 대한 풀 리퀘스트 할당을 자동화하는 로봇을 만들 수 있다.
9장, ‘자바스크립트와 Git Data API’에서는 GitHub에서 전체 “단일 페이지 애플리케이션(single-page application)”을 호스팅할 수 있다는 사실을 알고 있을까? 자바스크립트로 작성하고, GitHub에 호스팅된 플랫 파일 데이터베이스를 기반으로 하는 커피숍 정보 앱의 구축 방법에 대해 살펴본다. 여기서 중요한 점은 필요한 경우에 GitHub API를 스텁으로 대체하는 mocks out 테스트 가능한 자바스크립트 애플리케이션의 작성 방법을 살펴보는 것이다.
목차
목차
- 1장. 기본 GitHub API
- cURL
- 연속적인 API 경로 살펴보기
- JSON 형식
- 명령행에서 JSON 파싱
- cURL을 위한 디버깅 스위치
- 중요 헤더들
- Hypermedia API 따르기
- 인증
- 사용자 이름 및 암호 인증
- OAuth
- 상태 코드
- 성공(200 또는 201)
- 형식에 맞지 않는 JSON(400)
- 부적절한 JSON(442)
- 성공적인 생성(201)
- 아무 변경 없음(304)
- GitHub API 전송률 제한
- 전송률 제한 확인
- 전송률 제한 회피를 위한 조건부 요청
- 웹에서 콘텐츠 접근
- JSON-P
- CORS 지원
- 응답 콘텐츠 형식 지정
- 요약
- 2장. Gists와 Gist API
- 간편한 코드 공유
- Gists는 저장소다
- HTML 내부로 임베드하기
- 지킬 블로그에 퍼가기
- 명령행으로 생성하는 Gist
- 완전히 동작하는 앱으로서의 Gists
- Gists를 렌더링하는 Gists
- Gist API에 더 깊이 들어가기
- Octokit의 하이퍼미디어 데이터 사용하기
- 요약
- 3장. 골룸과 깃허브 위키
- “스미골 이야기 ...”
- 저장소에 연결된 위키
- 마크업과 구조
- “스미골 이야기 ...”
- 골룸 해킹
- 골룸 편집기의 시작점
- 프로그래밍 방식의 이미지 처리
- Rugged 라이브러리 사용하기
- 이미지 저장을 위한 최적화
- 깃허브 리뷰
- 리비전 내비게이션 개선
- 컴포넌트 웹페이지 사이의 링크 수정요약
- Search API 일반 원칙
- 인증
- 결과 형식
- 검색 연산자 및 한정자
- 정렬
- Search API 세부 사항
- 저장소 검색
- 코드 검색
- 이슈 검색
- 사용자 검색
- 예제 애플리케이션
- 사용자 흐름
- 파이썬
- AGitHub
- WxPython
- PyInstaller
- 코드
- 깃 인증 헬퍼
- 윈도우 생성과 인터페이스
- 깃허브 로그인
- 깃허브 검색
- 결과 표시
- 패키징
- 요약
- API
- 원시 상태
- 결합 상태
- 상태 생성
- 애플리케이션 작성
- 라이브러리
- 개발 환경
- 요청 보내기
- OAuth Flow
- 상태 핸들러
- 요약
- 지킬에 대한 학습과 웹사이트 구축
- 지킬 소개
- 로컬에서 지킬 운영하기
- 지킬 블로그 시작하기
- YFM
- 지킬 마크업
- 지킬 명령어 사용하기
- 지킬의 개인 정보보호 수준
- 테마
- 깃허브에 게시하기
- 자체 도메인에 호스팅
- DNS 설정
- 다른 블로그에서 가져오기
- 워드프레스에서 가져오기
- 워드프레스 대안 도구에서 내보내기
- 지킬 블로그로 웹사이트 스크랩하기
- 지킬 스크랩 전략
- 설정
- 제목 스크랩하기
- 루비와의 상호 작용 정비하기
- 테스트 작성과 캐싱
- 지킬 게시물 작성하기
- 지킬 명령행 도구 사용하기
- 리퀴드 마크업을 이용한 마스터 색인 파일
- 본문과 작성자 스크랩하기
- 지킬 게시물에 이미지 추가하기
- 스타일 커스터마이징
- 깃허브 “포크”를 통한 기여자 초대하기
- 깃허브에 블로그 게시하기
- 요약
- 설치
- 지킬 블로그 생성
- 안드로이드 개발 도구
- 새로운 프로젝트 생성
- 그래이들 빌드 파일 편집하기
- 기본 안드로이드 Main
- 안드로이드 자동화 테스트
- 깃허브 클라이언트에 대한 단위 테스트
- 안드로이드 UI 테스트
- 애플리케이션 구현
- 깃허브에 로그인하기 위한 코드
- 깃허브와 대화하기 위한 코드
- 블로그 콘텐츠 작성
- 깃허브 서비스
- 저장소와 브랜치의 Base SHA
- blob 생성하기
- 트리 생성하기
- 커밋 생성하기
- 마스터 리소스 업데이트하기
- 모든 테스트 통과하기
- 요약
- Activity API
- PR 만족 보장을 위한 계획
- 고려 사항과 제한 사항
- 바닐라 휴봇 생성
- 슬랙 계정 생성
- 로컬에서 휴봇 실행하기
- 헤로쿠 설치
- 헤로쿠 설정
- Activity API 개요
- 휴봇 확장 기능 작성
- 풀 리퀘스트를 통한 코드 리뷰
- 이벤트 등록을 위한 OAuth 토큰 사용
- 실제 풀 리퀘스트 트리거하기
- HTTP를 통한 게시 요청으로 PR 알림 처리하기
- 요약
- 깃허브에서 커피숍 데이터베이스 만들기
- 설정
- 호스트 이름 매핑
- 지원 라이브러리 추가
- GitHub.js를 사용하는 AngularJS 애플리케이션
- 애플리케이션 데이터 구조 시각화
- 테스트 가능한 앱으로 만들기
- 테스트 데이터
- CoffeeTech.js
- 지오코딩 지원
- 도시 데이터
- 로그인 추가
- 이미 오류가 있다면?
- 사용자가 보고한 데이터의 표시
- 사용자 제공 데이터
- 풀 리퀘스트 수락하기
- 안전한 로그인 구현
- 인증에는 서버가 필요하다
- Firebase로 인증 수정
- Firebase 테스트
- Firebase 로그인 구현하기
- 요약
- 설치
- 관리
- 엔드포인트
- 완전한 호스트 이름 대 마운트 포인트
- 명령행 클라이언트 도구: cURL
- Client 라이브러리를 사용하는 요청 예제
- Management API
- 문서화
- 깃허브와 루비
- 루비 설치
- 중요한 루비와 RVM 개념들
- 루비 설치 시 발생 가능한 잠재적인 문제들
- 깃허브와 NodeJS
- NodeJS 설치
- NVM
- package.json
- 명령행 기본 사항과 셸
- 셸 명령어
- 명령어에 변수 제공
- 명령어를 여러 라인으로 나누기
- 연속적인 명령어에 대한 출력의 파이프 처리