틴커캐드 강좌

7.오픈소스

7-1.clone

원격지의 저장소에서 소스를 가져와 참고하는 것은 쉽고도 흔한 일이다. 내 컴퓨터에 로컬 저장소를 만들고 원격지 주소에 연결한 후 pull 명령으로 당겨오면 된다. 이 작업을 한꺼번에 해 주는 명령이 clone이다. 말 그대로 원격 저장소를 내 로컬 저장소에 완전히 똑같이 복제한다.

git clone 저장소 디렉토리

복사할 저장소 주소와 디렉토리를 인수로 전달한다. 디렉토리가 없으면 만들어 주기도 하므로 부모 디렉토리에서 실행하면 편리하다. 디렉토리를 미리 만들어 놔도 상관 없지만 부모 디렉토리에서 명령을 실행해야 한다. 만약 디렉토리 안으로 이미 들어와 있다면 . 하나 찍어 주면 된다. 디렉토리를 생략하면 저장소의 이름을 사용한다.

앞에서 실습으로 만들었던 rem_game 프로젝트를 내 컴퓨터에 그대로 가져와 보자. 깃허브는 깃을 전혀 모르는 사람도 소스를 퍼 갈수 있도록 압축 전달 기능을 제공한다. Code 버튼을 클릭하여 제일 아래에 있는 Download ZIP 명령을 선택하면 가장 최근 소스를 압축 파일로 묶어 로컬로 보내준다.

파일명은 rem_game-main.zip이며 저장소 이름과 브랜치 이름으로 되어 있다. 압축을 풀어 보면 game.cpp에 실습에서 작성한 소스가 온전히 들어 있어 개발에 바포 사용할 수 있다. 단, 압축파일로 받으면 최신 버전에 대한 정적 복사본일 뿐이어서 커밋 이력은 포함되어 있지 않다.

이에 비해 clone 명령은 이력까지 모두 복제한다. rem_game을 로컬로 가져오되 StudyGit 폴더에서 다음 명령을 실행한다. 주소는 HTTPS를 사용했는데 SSH 설정이 되어 있다면 SSH 주소를 사용해도 상관없다. 남의 소스를 가져오는 경우는 주소만 알면 바로 쓸 수 있는 HTTPS가 편하다.

$ git clone https://github.com/soenmaster/rem_game.git clone_game

Cloning into 'clone_game'...

remote: Enumerating objects: 18, done.

remote: Counting objects: 100% (18/18), done.

remote: Compressing objects: 100% (9/9), done.

remote: Total 18 (delta 5), reused 12 (delta 3), pack-reused 0 (from 0)

Receiving objects: 100% (18/18), done.

Resolving deltas: 100% (5/5), done.

로컬 저장소 이름은 생략해도 되지만 앞 실습에서 rem_game 폴더를 이미 만들어 두었기 때문에 clone_game으로 이름을 따로 붙였다. 제대로 복제했는지 cd clone_game 명령으로 디렉토리 안으로 들어가 git log를 찍어 보자.

지금까지 실습했던 로그가 모두 출력되며 이는 이전의 소스까지 다 포함되어 있다는 얘기이다. 로그의 처음부터 순서대로 살펴보면 어떤 과정을 거쳐 개발했는지 속속들이 다 들여다 볼 수 있고 초기부터 소스가 발전해온 과정도 구경할 수 있다.

복제 후 개발 참여도 가능하다. 소스에 추가 기능을 작성한다고 치고 game.cpp를 수정해 보자. 저장 후 커밋하고 원격지로 전송한다. 별다른 보안 설정이 되어 있지 않고 동일 작업자임을 알 수 있으니 커밋도 잘 되고 push도 잘된다.

$ git commit -am "복제한 clone_game에서 수정"

$ git push

깃허브에서 확인해 보면 방금 푸시한 내용이 이미 반영되어 있다. 복제하면서 origin에 이미 연결 정보를 저장해 두었고 브랜치까지 맞춰져 있으므로 push 명령을 내릴 때 origin main은 생략해도 된다.

공개 저장소에서 읽는 것은 자유지만 쓰는 것은 약간의 제약이 있다. 아무나 push를 마음대로 날릴 수 있는 것은 아니다. 저장소마다 참여자 목록이 있고 권한을 관리하므로 허가받은 개발자만 커밋할 수 있다.

7-2.오픈소스

깃을 잘 몰라도 clone 명령만 쓸 수 있으면 깃허브의 모든 오픈소스를 다 가져올 수 있다. 일부 비공개용인 것도 있지만 대부분 공개되어 있어 허락을 받거나 가져가겠다는 통보조차 할 필요 없다. 다 같이 공부하자고 올려 놓은 자료라 살펴 보는건 공짜다.

어떤 소스가 있고 도움이 될만한 소스가 뭔지 정확히 찾아내는 것이 어렵다. 구글 검색으로 찾거나 chatgpt에게 물어봐도 되지만 옥석을 가려내기 쉽지 않다. 그보다는 관련 커뮤니티에서 이미 검증을 거친 사람의 조언을 받는 것이 확실하다. 깃허브 자체도 검색을 제공하는데 예를 들어 테트리스 게임을 만들고 싶다면 tetris로 검색하면 된다.

대략 수천개의 검색 결과가 나오는데 이 중에 좋아요 개수를 보고 선택하면 대체로 볼만하다. 자바스크립트로 된 소스를 구해 받아 보자. 깃허브 주소를 복사한 후 clone 명령으로 주소만 전달하면 된다.

$ git clone https://github.com/jakesgordon/javascript-tetris

자바스크립트는 웹에서 바로 실행 가능해 깃허브 사이트 안에서 결과를 바로 볼 수 있다. 물론 다운로드 받은 소스의 index.html을 실행해도 된다.

소스라고 해 봐야 index.html과 stats.js 두 개 뿐이고 이미지 하나가 포함되어 있다. 커밋 목록까지 포함한 폴더 전체는 150K이다. git log로 커밋 메시지를 살펴 보자.

$ git log

commit ff7354b8c2026d3cab0ce7f284e2650d1d3caa8a (HEAD -> master, origin/master,

origin/HEAD)

Author: Jake Gordon <jake@codeincomplete.com>

Date: Mon Jan 4 21:45:58 2016 -0800

commit c127dd5fceda8945f62d7b4f8c54a78df58577b1

Merge: 5d93c3c a844e74

Author: Jake Gordon <jake@codeincomplete.com>

Date: Sat Aug 16 10:51:47 2014 -0700

Merge pull request #1 from rbirkby/unusedcode

Remove unused syntax

...

Jake가 2011년부터 개발을 시작했고 마지막 커밋은 2016년이니 대략 10년은 넘은 프로젝트이다. 개발 중간 중간의 변화까지 다 살펴 볼 수 있다. 다음은 잘 알려진 큰 프로젝트를 받아 보자.

https://github.com/microsoft/vscode

마이크로소프트의 VS Code이다. 총 1G 용량의 소스를 다 받아 내는데 불과 3분이면 되니 우리나라 인터넷 인프라가 놀라울 따름이다. 소스는 타입스크립트로 되어 있으며 *.ts 파일이 총 5067개, 148만줄이다. 소스를 읽는 것은 가능하지만 컴파일하는 방법은 별도로 터득해야 한다.

웹브라우저나 동영상 플레이어 등도 이런 식으로 공개해 놓은 소스가 많다. 구글의 CEF는 다운로드 받는데만도 3시간이 걸릴 정도로 초대형 프로젝트이며 개인이 분석하기는 만만치 않다. 그래도 처음부터 맨땅에 헤딩하는 것보다는 비슷한 프로젝트를 받아 기본 지식을 습득하는 것이 빠르기는 하다.

다음 저장소는 내가 커스텀 키보드 제작에 사용하는 QMK 라이브러리를 관리하는 곳이다. 키보드 펌웨어 제작에 관심 있는 사람은 이 라이브러리를 받아 분석해 보면 많은 것을 배울 수 있으며 사용만 해도 고급 기능을 다 활용할 수 있다.

$ git clone https://github.com/qmk/qmk_firmware

역사가 오래되었고 참여하는 사람이 많아 로그를 보면 어마어마하다. 하루에도 몇 번씩 커밋이 올라오고 개발에 참여하는 사람도 많다. 지금도 꾸준히 업데이트하고 있으며 이런 사람들의 노력이 쌓여 커스텀 키보드가 계속 발전하는 것이다.

이상으로 깃 강좌를 마칩니다. 바쁜 일정속에 시간을 짜내 작성하느라 상세도와 친절함까지 챙기지 못해 아쉬움이 많이 남는 강좌입니다. 이 강좌로 기본을 익히신 후 더 고급 강좌를 통해 깃을 100% 활용해 보십시오. 깃을 배우고자 하는 분께 조금이나마 도움이 되었으면 좋겠습니다.