github
2.3.0
인용 : Haghish, EF (2020). GitHub에서 Stata 통계 소프트웨어를 개발, 유지 관리 및 호스팅합니다. Stata 저널, 20(4), 931-951.
github 이전 패키지 릴리스를 포함하여 GitHub에서 Stata 패키지를 검색하고 설치하기 위한 Stata 모듈입니다. 이는 search , findit , ssc 와 같은 여러 Stata 명령의 조합이지만 대신 GitHub에서 호스팅되는 Stata 패키지를 관리하기 위해 만들어졌습니다. 또한 이 패키지는 다른 곳에서는 Stata 사용자가 사용할 수 없는 버전 제어를 위한 새로운 기능을 제공합니다(예를 들어, 패키지를 사용하면 이전 소프트웨어로 수행된 분석을 재현하기 위해 이전 Stata 패키지 릴리스를 설치할 수 있습니다).
뉴스 : gitget 명령을 소개합니다. gitget 패키지 설치 및 업데이트를 더욱 단순화합니다. 이는 GitHub의 모든 기존 Stata 패키지에 대한 데이터베이스를 제공합니다. 이를 통해 GitHub에서 호스팅되고 gitget 으로 알려진 패키지를 설치할 수 있습니다. 간단히 입력하면 됩니다.
gitget packagename
gitget 명령은 GitHub의 전체 Stata 패키지 목록을 사용하여 프로젝트의 URL을 식별합니다. 이 목록은 Stata 패키지를 검색하는 검색 프로그램을 사용하여 프로그래밍 방식으로 생성됩니다. 먼저, 모든 Stata 저장소가 식별되어 repolist.dta 에 저장됩니다. 다음으로, 설치 가능한 패키지가 추출되어 컴퓨터에 패키지와 함께 설치되는 gitget.dta 에 저장됩니다. 아카이브의 전체 목록은 이 저장소 내에서 미리 볼 수도 있습니다.
목차
gitget 명령으로 인식되는 Stata 패키지 목록 최근 몇 년 동안 Stata 사용자들은 아래 그림과 같이 Stata 코드 및 데이터 세트 공유, 통계 소프트웨어 개발, Stata 패키지 호스팅을 위해 GitHub를 점점 더 많이 사용하고 있습니다. 이는 Stata 커뮤니티와 연구 투명성을 증진하는 모든 사람들에게 참으로 좋은 소식입니다! github 모듈은 Stata 패키지 검색, 설치, 관리, 구축까지 용이하게 해줍니다. 또한 개발 버전을 설치하거나 안정적인 패키지 릴리스를 설치할 수도 있습니다. 또한 자동으로 설치될 패키지 종속성을 지정할 수 있으므로 GitHub가 Stata 사용자와 개발자에게 더욱 매력적입니다. 여기에서는 github 패키지를 설치하고 사용하는 방법을 빠르게 보여줍니다.
github 모듈 설치 다음 코드를 실행하여 최신 버전의 github 명령을 설치할 수 있습니다.
net install github, from("https://haghish.github.io/github/")
패키지의 일반적인 구문은 다음과 같이 요약될 수 있습니다.
github [subcommand] [...]
[ 하위 명령 ]은 다음과 같습니다.
| 하위 명령 | 설명 |
|---|---|
search | GitHub에서 Stata 패키지를 찾습니다. |
findfile | GitHub의 모든 Stata 패키지 중에서 파일을 검색합니다. |
install | GitHub에서 패키지를 설치합니다. |
list | github 과 함께 설치된 패키지에 대한 정보를 제공합니다. |
query | 패키지의 모든 이전 릴리스를 나열합니다. |
check | 저장소가 설치 가능한지 테스트합니다. |
uninstall | Stata에서 패키지를 제거합니다. |
update | GitHub에서 패키지 업데이트 |
version | 설치된 패키지의 버전을 반환합니다. |
[ ... ]는 지정된 하위 명령을 기반으로 사용자 이름/저장소 또는 패키지 이름 이 될 수 있습니다.
패키지를 설치하려면 GitHub 사용자 이름과 저장소 이름만 있으면 됩니다. 슬래시로 구분된 사용자 이름과 저장소 이름의 조합은 저장소에 필요한 URL을 제공합니다. 예를 들어 https://github.com/haghish/markdoc에서 호스팅되는 MarkDoc 패키지를 설치하려면 다음을 입력하면 충분합니다.
github install haghish/markdoc [, stable version("")]
github 패키지에는 GitHub에서 호스팅되는 Stata 패키지의 전체 목록에 대한 데이터베이스가 포함되어 있습니다. 따라서 패키지 이름만 지정하여 패키지를 설치할 수도 있습니다. github install 래퍼인 gitget 명령은 패키지 이름을 묻는 방식으로만 GitHub에서 Stata 패키지를 설치하거나 업데이트할 수 있습니다.
gitget packagename [, stable version("")]
예를 들어, markdoc 패키지를 설치하려는 경우 gitget markdoc 입력하는 것은 github install haghish/markdoc 입력하는 것과 같습니다. GitHub에 호스팅된 Stata 패키지 목록을 검사하려면 gitget.dta 데이터 세트를 참조하세요.
| 옵션 | 설명 |
|---|---|
stable | 패키지의 최신 안정 릴리스 버전을 설치합니다. |
version(str) | 지정된 릴리스 버전을 설치합니다. |
하나 또는 여러 개의 키워드를 사용하여 GitHub에서 Stata 패키지를 검색할 수 있습니다. 이는 Stata의 search 또는 findit 명령과 유사하지만 대신 GitHub 패키지 검색에만 사용됩니다.
github search weaver
GitHub API를 효과적으로 검색하는 것은 매우 중요합니다. 이를 위해 패키지에는 검색 범위를 좁히거나 다른 소스를 포함하도록 확장하는 데 사용할 수 있는 구문을 보여주는 검색 GUI가 포함되어 있습니다. search 명령은 net 명령에서 호스팅되는 패키지의 출시 날짜도 분석하는데, 이는 매우 유용한 기능입니다. GUI를 시작하려면 다음을 입력하십시오.
db github
예를 들어, github search 명령을 사용하여 markdoc 패키지를 검색하면 다음과 같은 출력이 표시됩니다.
github 에는 컴퓨터에 설치된 패키지를 추적하는 내장 데이터베이스가 있으며 물론 컴퓨터에 설치된 패키지 버전도 알려줍니다. 버전은 개발자가 지정한 패키지의 고유 릴리스 태그에서 가져옵니다. 설치된 패키지를 list 하고 이에 대한 유용한 정보를 얻을 수 있습니다. 또한 이 명령은 GitHub 패키지에 사용 가능한 업데이트가 있는지 알려줍니다 . 예를 들어 아래 출력에서는 두 개의 패키지에 사용할 수 있는 업데이트가 있음을 알 수 있습니다. (update) 링크를 클릭하여 패키지를 최신 릴리스로 업데이트할 수도 있습니다.
. github list
모든 패키지를 설치할 수 있는 것은 아닙니다. Stata 저장소를 설치하려면 toc 및 pkg 파일이 있어야 합니다. check 하위 명령을 사용하면 패키지가 설치 가능한지 여부를 확인할 수 있습니다.
github check haghish/markdoc
GitHub에서 Stata 패키지를 검색하는 데 사용되는
github search명령은 설치할 수 없는 Stata 저장소를 닫는 경향이 있기 때문에 이는 주의해야 할 중요한 사항입니다. 즉, 저장소에 이러한 파일이 포함되어 있지 않으면 검색에서all옵션을 지정하지 않는 한 Stata 패키지로 간주되지 않습니다(검색 GUI에서 설치할 수 없는 GitHub 저장소 표시 옵션을 확인하세요). 그러나github패키지에는 이러한 파일을 빌드하기 위한 GUI도 포함되어 있습니다.github과 함께 제공되는 GUI를 사용하면 저장소에 대한 이러한 파일을 쉽게 빌드할 수 있습니다(아래 참조).
패키지를 설치하려면 uninstall 하위 명령과 패키지 이름을 차례로 사용합니다. 예를 들어:
github uninstall markdoc
GitHub에서는 패키지 버전을 무제한으로 보관할 수 있습니다. github 명령에는 패키지 버전을 지정하는 옵션이 있어 이전 패키지 버전을 설치할 수 있습니다. 예를 들어, 이전 버전의 MarkDoc 패키지를 설치하려면 3.8.0 이라고 말하세요. 다음을 입력할 수 있습니다:
github install haghish/markdoc , version("3.8.0")
그런데 패키지 버전을 볼 수 있었나요? GitHub에는 소프트웨어의 모든 이전 릴리스를 나열하는 릴리스 탭이 있습니다( 예를 들어 MarkDoc의 이전 릴리스 참조 ). 그러나 좋은 소식은 github Stata 결과 창에 모든 이전 릴리스를 나열하는 하위 명령이 있고 한 번의 마우스 클릭으로 그 중 하나( 지정된 경우 해당 특정 버전에 대한 패키지 종속성 포함 )를 설치할 수 있다는 것입니다. 프로그래밍 방식으로. 그렇게 하려면 다음을 입력하십시오.
github query username/repository
예를 들어, MarkDoc 의 이전 릴리스를 나열하려면 다음을 입력하십시오.
. github query haghish/markdoc
----------------------------------------
Version Release Date Install
----------------------------------------
3.8.5 2016-10-16 Install
3.8.4 2016-10-13 Install
3.8.3 2016-10-03 Install
3.8.2 2016-10-01 Install
3.8.1 2016-09-29 Install
3.8.0 2016-09-24 Install
3.7.9 2016-09-20 Install
3.7.8 2016-09-19 Install
3.7.7 2016-09-18 Install
3.7.6 2016-09-13 Install
3.7.5 2016-09-08 Install
3.7.4 2016-09-07 Install
3.7.3 2016-09-06 Install
3.7.2 2016-09-05 Install
3.7.0 2016-08-23 Install
3.6.9 2016-08-16 Install
3.6.7 2016-02-27 Install
----------------------------------------
MarkDoc 과 같은 동적 문서화 소프트웨어로 분석을 작성할 때 분석에 사용되는 패키지 버전을 보고해야 합니다. version 하위 명령 뒤에 다음을 사용하여 프로그래밍 방식으로 설치된 패키지의 버전을 얻을 수 있습니다.
. github version markdoc
3.8.0
github list 명령은 이미 설치된 패키지의 버전을 표시하고 사용 가능한 최신 버전이 있는지 확인하기 때문에 이 명령은 다른 용도로 사용되지 않습니다.
일부 패키지는 다른 패키지에 의존합니다. github 명령을 사용하면 특정 버전 유무에 관계없이 패키지 종속성을 설치할 수 있습니다. 그렇게 하려면:
dependency.do 라는 파일을 만들어 저장소에 포함시킵니다.github 명령을 사용하여 패키지 종속성을 설치하고 필요한 버전도 지정하세요.github 명령은 패키지를 설치한 후 dependency.do 찾아 저장소에서 찾으면 실행합니다. 예를 들어 MarkDoc 패키지에는 종속성 파일을 생성하는 방법의 예가 될 수 있는 dependency.do 파일이 있습니다 . 당연히 dependenc.do 파일은 github install 명령으로만 실행 가능합니다.
github 패키지에는 GitHub에서 호스팅되는 패키지 내에 설치된 모든 파일의 데이터베이스가 포함되어 있습니다. 이는 개발자가 다른 개발자가 사용하는 이름으로 파일을 생성하지 않도록 하는 중요한 기능입니다. 이러한 패키지는 동일한 시스템에 함께 설치할 수 없기 때문입니다( 프로그램 이름 에도 문제가 있음). github 패키지를 사용하면 개발자는 이전에 패키지에서 특정 이름이 사용되었는지 확인할 수 있습니다.
findfile 하위 명령은 githubfiles.dta (패키지와 함께 설치됨)를 검색하고, 발견되면 해당 파일이 포함된 저장소를 가리킵니다. 예를 들어 "dy"라는 키워드가 있는 파일을 검색하면 다음과 같은 결과가 나타납니다.
. github findfile dy
---------------------------------
Searching githubfiles database
---------------------------------
dynpandoc.ado
dynpandoc.sthlp
dynamicPage1.mata
---------------------------------
결과 창에서 해당 파일을 클릭하면 해당 파일에 대한 링크도 포함됩니다.
ado 파일과 Stata 도움말 파일을 만들었다고 가정해 보세요. 저장소를 설치 가능하게 만드는 방법은 무엇입니까? stata.toc 및 packagename.pkg 파일을 수동으로 생성하고 필요한 정보, 설치해야 하는 파일 등을 지정해야 합니다. github 패키지에는 엄격한 레이아웃을 사용하여 패키지 설치를 생성하는 make GUI가 도입되었습니다. 설치하려는 파일을 선택하고, 필요한 정보를 지정하고, toc 및 pkg 파일을 준비하면 됩니다. 그런 다음 이 파일을 저장소에 복사하자마자 설치할 수 있습니다!
작업 디렉터리를 저장소 경로로 변경한 후 GUI를 실행하고 다음을 입력합니다.
db make
필요한 정보를 기록하고 설치해야 할 파일을 선택하십시오. 확인을 누르고 즐기세요!
gitget 명령으로 인식되는 Stata 패키지 목록 gitget 데이터 세트는 github 패키지와 함께 다운로드됩니다. 이 데이터 세트는 매월 업데이트됩니다. gitget 패키지의 전체 목록을 보려면 여기를 클릭하세요.
EF 하기쉬
의료생체측정 및 의료정보학 센터
독일 프라이부르크대학교
@하기쉬
