예시별 cm find

모든 버전 관리 시스템에서는 사용 방법이나 변경 중인 파일에 관한 정보 또는 단순히 특정 변경사항이나 특정 브랜치 검색에 관한 정보가 자주 필요합니다.

이때 가장 좋은 방법이 쿼리를 사용하는 것입니다. 이러한 이유로 Plastic SCM을 만들 때, 체인지 세트, 브랜치, 레이블, 병합, 코드 검토 등과 관련된 특정 정보를 얻을 수 있는 명령인 cm find라는 매우 강력한 쿼리 시스템을 추가했습니다.

find 명령은 GUI에서 뷰를 커스터마이즈할 때도 사용이 가능합니다.

이 자료에서는 cm find 명령으로 처리될 수 있는 몇 가지 시나리오를 예로 다룹니다. 해당 예들은 Plastic SCM 설치 시 수행 가능한 작업의 작은 하위 집합으로서 각 예마다 질문, 단계별 해결책 및 반환되는 정보에 대한 이해를 돕는 예상 출력이 포함되어 있습니다.

사용자가 일정 기간 동안 생성한 브랜치를 검색하고, 검색된 브랜치를 특정 속성별로 필터링할 수 있습니다.

사용 가능한 모든 브랜치를 가져오기 시작합니다.

사용자별로 필터링하여 원하는 브랜치를 찾습니다.

사용자를 기준으로 필터링하고 나면 이제 이 스프린트와 관련된 브랜치만 필요로 하므로 특정 날짜 이후에 생성된 브랜치를 찾습니다.

형식이 지정된 출력을 사용할 수 있습니다.

마지막으로 특정 속성을 찾습니다. 내부적인 기능 라이프사이클에 따르면 각 브랜치는 주 브랜치에서 이를 통합하기 전에 테스트를 통과해야 합니다.

브랜치가 "테스트"를 통과하면 속성이 "passed"로 설정되므로 속성 이름과 속성 값을 기준으로 필터링합니다.

다음 테이블은 현재 cm find branch 명령과 함께 사용할 수 있는 여러 가지 필터링 옵션을 보여 줍니다.

* 조건 date는 브랜치 뷰의 생성일 열에 해당합니다.

상수를 이용하는 날짜별 필터링 방법을 알아보십시오.

이 테이블은 현재 cm find branch 명령과 함께 사용할 수 있는 여러 가지 출력 옵션을 보여 줍니다.

체인지 세트에 대한 많은 정보를 찾을 수 있으며, 코멘트도 그러한 검색 대상에 포함됩니다. 간략한 정보의 경우 cm log를 사용하고 직접 필터링(셸 명령 사용)하거나 cm find를 사용하여 해당 작업을 수행할 수 있습니다.

이 샘플에서는 브랜치에 속하는 모든 체인지 세트의 날짜와 코멘트를 가져옵니다.

모든 체인지 세트를 볼 수 있으며. 이제 "solution"이라는 단어를 찾고 여기에서 쉽게 확인할 수 있습니다. 단, 체인지 세트의 수가 수백 개나 된다면 느리고 지루한 작업이 될 수 있습니다. 특정 단어로 필터링하는 경우, 코멘트 전체를 찾는 것이 아니므로 정확한 검색을 위해 SQL 구문인 LIKE와 %를 사용합니다.

다음 명령을 사용하여 복제 날짜별로 체인지 세트를 쿼리할 수 있습니다. 최신 복제 날짜를 어떻게 얻는지에 대한 내용은 추후에 확인할 수 있습니다.

returnparent를 사용하면 특정 체인지 세트나 개정의 부모를 가져올 수 있습니다. 이 체인지 세트 이전에 어떤 작업이 이루어졌는지 알고 싶다면 간단히 다음과 같이 요청하면 됩니다.

다음 테이블은 현재 cm find changeset 명령과 함께 사용할 수 있는 여러 가지 필터링 옵션을 보여 줍니다.

* 조건 changesetid, date 및 owner는 체인지 세트 뷰에서 각각 이름 , 생성일 및 작성자 열에 해당합니다.

상수를 이용하는 날짜별 필터링 방법을 알아보십시오.

이 테이블은 현재 cm find changeset 명령과 함께 사용할 수 있는 여러 가지 출력 옵션을 보여 줍니다.

브랜치가 있으면 모든 복제 작업을 시작부터 시간순으로 확인할 수 있습니다.

마지막 날짜만 확인하고 싶다면 날짜별로 검색을 필터링한 뒤 Powershell 또는 bash를 사용하여 마지막 행을 선택하면 됩니다.

Powershell:

Bash:

결과:

다음 테이블은 현재 cm find replicationlog 명령과 함께 사용할 수 있는 여러 가지 필터링 옵션을 보여 줍니다.

상수를 이용하는 날짜별 필터링 방법을 알아보십시오.

이 테이블은 현재 cm find replicationlog 명령과 함께 사용할 수 있는 여러 가지 출력 옵션을 보여 줍니다.

다음과 같이 모든 레이블을 가져올 수 있습니다.

또한 특정 브랜치에서 생성된 모든 레이블을 가져올 수 있습니다.

codice에서 개발용 주 브랜치와 현재 및 이전 버전을 지원하는 "Fix" 브랜치를 유지하므로 특정 릴리스가 포함된 브랜치를 찾을 수 있습니다.

위에서 확인할 수 있듯 BL237 레이블은 main 브랜치에 있습니다.

레이블 일자를 가져오고 나중에 해당 브랜치에서 해당 기간에 생성된 체인지 세트를 요청할 수 있습니다. 2개 이상의 레이블에서 정보를 가져오는 작업은 매우 간단합니다.

다음 테이블은 현재 cm find label 명령과 함께 사용할 수 있는 여러 가지 필터링 옵션을 보여 줍니다.

* 조건 date는 레이블 뷰의 생성일 열에 해당합니다.

상수를 이용하는 날짜별 필터링 방법을 알아보십시오.

이 테이블은 현재 cm find label 명령과 함께 사용할 수 있는 여러 가지 출력 옵션을 보여 줍니다.

브랜치, 체인지 세트, 레이블에 구분 없이 속성을 적용할 수 있습니다. 첫 번째로 필요한 사항은 객체 ID입니다. 브랜치를 쿼리할 때 ID를 지정하여 속성을 가져올 수 있습니다.

속성을 가져온 후에는 다음 명령을 사용하여 속성 목록을 가져올 수 있습니다.

이 경우, 속성 이름은 "status"이며, 속성 값은 "Passed"입니다.

Powershell 스크립팅을 사용하여 두 명령을 조합할 수 있습니다.

bash 스크립팅을 사용할 수도 있습니다.

출력 결과는 전과 동일합니다.

또한 다음 쿼리를 실행하여 같은 결과를 얻을 수 있습니다.

일부 객체에 특정 속성을 설정했다고 가정해 보겠습니다(이번 경우, 테스트 "status"). 객체에 포함된 사항과 관계없이 이러한 속성을 쿼리할 수 있습니다.

다음 테이블은 현재 cm find attributes 명령과 함께 사용할 수 있는 여러 가지 필터링 옵션을 보여 줍니다.

* 조건date 및 type은 속성 뷰에서 각각 생성일 및 이름 열에 해당합니다.

상수를 이용하는 날짜별 필터링 방법을 알아보십시오.

이 테이블은 현재 cm find attributes 명령과 함께 사용할 수 있는 여러 가지 출력 옵션을 보여 줍니다.

이제 이전 샘플에서 가져온 특정 체인지 세트에서 변경이 있는 파일에 대해 더 알고자 하는 경우 이러한 목적에는 find revision을 사용할 수 있습니다.

파일 및 폴더 경로만 필요하므로 커스텀 형식을 지정합니다.

일부 명령줄의 도움(Linux의 경우 grep, Windows Powershell의 경우 where)을 받아 폴더를 기준으로 필터링할 수도 있습니다.

Powershell:

Bash:

이 경우 출력 형태는 다음과 같습니다.

모든 체인지 세트에서 검색하여 브랜치의 개정 정보를 가져올 수도 있습니다. 일정 기간에 브랜치에서 변경된 모든 항목을 가져올 수 있습니다.

나중에 해당 정보를 필터링하기 위해 자주 사용하는 셸 툴(이 경우 Powershell)을 사용할 수 있습니다.

Bash를 선호하는 경우 명령줄은 다음과 같습니다.

예상되는 출력은 다음과 같습니다.

다음 테이블은 현재 cm find revisions 명령과 함께 사용할 수 있는 여러 가지 필터링 옵션을 보여 줍니다.

상수를 이용하는 날짜별 필터링 방법을 알아보십시오.

이 테이블은 현재 cm find revisions 명령과 함께 사용할 수 있는 여러 가지 출력 옵션을 보여 줍니다.

병합은 어떨까요? 특정 브랜치나 체인지 세트에서 이루어진 병합을 추적할 수 있습니다.

브랜치가 통합된 위치를 알고 싶다면 다음 명령을 입력하면 됩니다.

특정 브랜치에 어떤 브랜치가 통합되었는지 파악하기 위해 사용하는 명령은 다음과 같습니다.

이전 명령을 사용하면 형식 플래그를 사용해 브랜치 이름만 반환하여 출력을 커스터마이즈할 수도 있습니다. 그러한 방식으로 사용할 때 두 번째 명령은 예를 들어 다음과 같습니다.

또는:

find merge는 모든 병합 유형(일반 병합, 체리픽된 병합, 차감식 병합)을 반환합니다.

따라서 일정한 간격으로 지정된 브랜치에 병합할 수 있습니다.

두 개의 쿼리(브랜치 찾기, 병합 찾기)와 일부 Powershell 해킹을 활용하여 답변을 드릴 수 있습니다. 이 코드를 PS1 파일에 넣고 Powershell 콘솔에서 실행합니다.

다음은 샘플 출력입니다.

이 코드로 다음 작업을 수행합니다.

1. 이 스프린트에서 모든 브랜치를 찾습니다.
2. 이 스프린트에서 모든 병합을 찾아 소스 브랜치만 반환합니다.
3. $allbranches 출력의 형식을 변경하여 두 목록의 형식이 일치하도록 합니다.
4. "병합" 목록에 allBranches 목록의 브랜치가 포함되어 있는지 확인합니다. 포함되어 있지 않다면 브랜치가 통합되지 않은 것입니다.

bash 셸에는 다음과 같은 동등한 코드가 있습니다.

이 코드는 다음을 수행합니다.

1. 스프린트에 속한 모든 브랜치를 찾습니다.
2. 스프린트에 속한 모든 병합을 찾아 소스 브랜치만 반환합니다.
3. 병합된 브랜치 목록에 없었던 모든 브랜치를 스프린트에서 출력합니다.

다음 시나리오를 살펴보겠습니다.

우리가 찾는 브랜치는 다른 브랜치에 통합되었으나(따라서 같은 브랜치로의 병합은 삭제해야 함) 통합 대기 중인 체인지 세트(그림의 주황색 체인지 세트)가 있는 브랜치입니다. 단일 쿼리를 사용한 뒤 일부 Powershell 코드로 후처리를 하면 완전히 통합되지 않는 브랜치를 알 수 있습니다.

다음은 샘플 출력입니다.

이 코드로 다음 작업을 수행합니다.

1. 모든 병합과 특정 날짜 이후에 완료된 소스 체인지 세트를 가져옵니다.
2. 원본과 대상이 같은 병합을 필터링합니다.
3. 이미 병합된 목록을 삭제하기 위해 해당 병합만 포함된 목록을 가져옵니다.
4. find branches 출력의 형식을 find merge 형식과 일치하도록 변경합니다.
5. 해당 간격으로 병합이 완료되었으나 병합 대기 중인 체인지 세트가 있는 브랜치를 비교 및 필터링합니다.

bash를 사용하는 경우 다음과 같이 다른 방법을 사용할 수 있습니다.

수행할 작업은 다음과 같습니다.

1. 특정 날짜 이후에 수행된 소스 체인지 세트가 표시되도록 파일에 모든 병합을 작성하고, 동시에 다른 파일에 모든 소스 병합 브랜치를 작성합니다.
2. 브랜치 이름 및 체인지 세트별로 모든 기존 브랜치에서 반복하여 첫 번째 파일에는 표시되지 않지만(병합 소스 브랜치 및 체인지 세트) 두 번째 파일에는 표시되는(병합 대기 중인 체인지 세트가 있다는 뜻) 브랜치만 출력합니다.
3. 마지막으로, 임시 파일을 삭제합니다.

다음 시나리오를 살펴보겠습니다.

버전 1.0으로 직접적으로 또는 간접적으로 통합된 브랜치를 알고자 합니다. 이전과 마찬가지로 데이터를 필터링하려면 서버에 대한 단일 쿼리와 powershell 기능이 필요합니다. 이번 특정 샘플에서는 /main에서 통합된 모든 브랜치를 가져오려고 합니다.

샘플 출력은 다음과 같으며 브랜치 12299가 릴리스 4.3.39.406에 간접적으로 통합되었음을 알 수 있습니다.

스크립트에 대한 간략한 설명입니다.

1. 이전과 마찬가지로 목록을 가져오고 중복을 제거합니다.
2. 대상 브랜치, 빈 방문 목록 및 깊이를 표시하는 데 도움이 되는 마커와 함께 ListAll 함수를 호출합니다. 코드에 이 값을 사용하지 않으므로 이 함수의 출력은 null로 파이핑되며, 사용하는 경우에는 값이 표시됩니다.
3. ListAll 함수 내부에서 대상 창과의 대상 일치 판정을 수행하는 병합을 찾으려고 합니다.
4. 일치하는 경우 항목을 visited 목록에 추가하고 병합 소스를 사용할 때 ListAll을 반복적으로 호출합니다.
5. 재귀 함수가 반환하고 나면 함수의 반환 값에 따라 방문 목록을 업데이트합니다.

Bash에서는 다음 스크립트를 사용하여 동일한 작업을 수행할 수 있습니다.

이 스크립트에 대한 간략한 설명은 다음과 같습니다.

1. 병합 목록을 가져와 중복 항목을 제거하고 목록을 파일에 저장합니다.
2. 두 보조 파일을 준비합니다.
   1. old_targets: 찾은 모든 대상 브랜치를 저장합니다.
   2. targets: 찾는 소스가 있는 대상 브랜치를 포함합니다.
3. 이제 대상 브랜치가 목록 파일에 대상으로 있는지 확인합니다. 그러한 경우 이전에 적용되지 않았다면 다음번에 병합 소스 브랜치를 저장합니다. 또한 이를 화면에 출력합니다.
4. 깊이 수준을 높이고 대상 목록을 전환합니다. 새 대상 목록이 현재 대상 목록이 되고 현재 목록이 "이미 사용됨" 목록에 추가됩니다.
5. 마지막으로, 환경을 원래대로 두는 정리 작업만 남았습니다.

다음 테이블은 현재 cm find merge 명령과 함께 사용할 수 있는 여러 가지 필터링 옵션을 보여 줍니다.

상수를 이용하는 날짜별 필터링 방법을 알아보십시오.

이 테이블은 현재 cm find merge 명령과 함께 사용할 수 있는 여러 가지 출력 옵션을 보여 줍니다.

통합 코드 검토 기능을 사용하면 검토 상태에 대한 정보를 얻을 수 있습니다. 이 샘플에서는 내 검토(문자 그대로 '나'에게 할당된 검토로, 이때 '나'는 현재 사용자)의 수신이 시작되었습니다. 앞에서와 마찬가지로 사용자 이름도 넣을 수 있습니다.

나중에 특정 상태의 검토(1 = 승인됨)로 결과의 범위를 지정할 수 있습니다.

마지막으로, 특정 기간 내에 검토를 완료합니다.

해당 특정 기간 및 조건을 가진 검토들과 비교하고자 합니다.

이 두 개의 쿼리를 사용하면 스프린트에 대해 전체 검토 중 승인된 검토의 비율을 얻을 수 있습니다.

다음 테이블은 현재 cm find review 명령과 함께 사용할 수 있는 여러 가지 필터링 옵션을 보여 줍니다.

* 조건date 및 targetid는 코드 검토 뷰에서 각각 생성일 및 검토된 오브젝트 열에 해당합니다.

상수를 이용하는 날짜별 필터링 방법을 알아보십시오.

이 테이블은 현재 cm find review 명령과 함께 사용할 수 있는 여러 가지 출력 옵션을 보여 줍니다.

작년에 팀원이 생성한 임시 저장을 찾을 수 있습니다.

다음 테이블은 현재 cm find shelve 명령과 함께 사용할 수 있는 여러 가지 필터링 옵션을 제시합니다.

상수를 이용하는 날짜별 필터링 방법을 알아보십시오.

이 테이블은 현재 cm find shelve 명령과 함께 사용할 수 있는 여러 가지 출력 옵션을 보여 줍니다.

이 자료에서 지금까지는 출력을 커스터마이즈하는 방법을 살펴봤습니다. 그런데 추후 분석을 위해 출력을 XML로 설정하여 파일로 저장하는 방법도 있습니다. 이를 위해 다음 명령을 실행합니다.

다음 XML 콘텐츠를 생성합니다.

<?xml version="1.0" encoding="utf-8" ?>
<PLASTICQUERY>
  <REVISION>
    <ID>426098</ID>
    <COMMENT></COMMENT>
    <DATE>07/06/2013 16:00:09</DATE>
    <OWNER>roberto</OWNER>
    <TYPE>dir</TYPE>
    <SIZE>0</SIZE>
    <CHANGESET>16716</CHANGESET>
    <PARENT>426069</PARENT>
    <ITEM>d:\linked_replicated\</ITEM>
    <ITEMID>2</ITEMID>
    <BRANCH>br:/main/Fix-4.1/scm12863</BRANCH>
    <PATH>d:\linked_replicated\</PATH>
    <REPOSITORY>codice</REPOSITORY>
    <REPNAME>codice</REPNAME>
    <REPSERVER>localhost:8087</REPSERVER>
    <HASH>kWJO1fm+7RCiZZcgSjM4/Q==</HASH>
  </REVISION>
  <REVISION>
    <ID>426092</ID>
    <COMMENT></COMMENT>
    <DATE>07/06/2013 16:00:09</DATE>
    <OWNER>roberto</OWNER>
    <TYPE>txt</TYPE>
    <SIZE>78238</SIZE>
    <CHANGESET>16716</CHANGESET>
    <PARENT>426056</PARENT>
    <ITEM>d:\linked_replicated\01nerva\src\client\plastic\ActionMenuManager.cs</ITEM>
    <ITEMID>37736</ITEMID>
    <BRANCH>br:/main/Fix-4.1/scm12863</BRANCH>
    <PATH>d:\linked_replicated\01nerva\src\client\plastic\ActionMenuManager.cs</PATH>
    <REPOSITORY>codice</REPOSITORY>
    <REPNAME>codice</REPNAME>
    <REPSERVER>localhost:8087</REPSERVER>
    <HASH>FXmLNV7B9Et1wTGqULWpgQ==</HASH>
  </REVISION>
</PLASTICQUERY>
  

이 콘텐츠는 나중에 Excel과 같은 툴로 임포트하여 간단하고 편리하게 통계를 얻을 수 있습니다.

리포지토리에 있는 모든 체인지 세트의 정보를 확인한다고 가정할 때 다음과 같은 명령을 실행할 수 있습니다.

그런 다음 Excel에 출력을 로드할 수 있습니다. 결과는 다음과 같습니다.

Excel에는 더 많은 통계를 제공하는 PivotTable이라고 하는 매우 유용한 유틸리티가 포함되어 있습니다.

Exel의 필터 및 정렬 기능을 사용하여 체인지 세트 사용자를 그룹화하고 해당 통계를 그래프로 변환할 수 있습니다.

또한 브랜치별로 그룹화가 가능합니다. 브랜치별로 그룹화할 경우 각 브랜치별로 기여한 사용자 수와 각 사용자가 생성한 체인지 세트의 개수를 확인할 수 있습니다.

find 명령에는 각 객체에 대한 기본 출력이 포함되지만 앞서 살펴본 바와 같이 커스텀 출력 옵션을 정의하고, --xml 속성의 XML 형식을 사용하여 결과를 검색하고, 추후 분석을 위해 --file 속성의 파일에 결과를 저장할 수 있습니다.

일반 구문은 다음과 같습니다.

이 경우:

• object는 브랜치, 속성, 체인지 세트, 레이블, 병합, 검토, 개정, 사용자 등을 포함하고 있는 시스템 내의 거의 모든 객체가 될 수 있습니다.
• conditions는 객체에 따라 달라집니다. cm showfindobjects 명령을 입력하여 조건과 사용 가능한 모든 객체를 얻을 수 있습니다.
• on repositories 인수를 사용하면 현재 워크스페이스와 일치 또는 불일치할 수 있는 한 개 이상의 리포지토리에서 정보를 얻을 수 있습니다. 이동 대상 폴더(워크스페이스 내, 다른 워크스페이스, 워크스페이스가 없는 폴더 등) 및 유형에는 제한이 없습니다. cm find revisions "where branch = 'main/scm12800' on repositories 'codice@localhost:8087'" --nototal 423620 27/05/2013 13:25:53 dirRoberto d:\linked_replicated\#br:/main/scm12800#16582 423621 27/05/2013 13:25:53 dirRoberto d:\linked_replicated\01nerva#br:/main/scm12800#16582 423622 27/05/2013 13:25:53 dirRoberto d:\linked_replicated\01nerva\src#br:/main/scm12800#16582

  해당 리포지토리에 대한 쿼리 권한만 있으면 이 작업이 가능합니다.

  리포지토리뿐만 아니라 서버가 여러 개일 때에도 한꺼번에 쿼리할 수 있습니다. 예:

  cm find "changesets where date >= '2017/11/17' on repositories 'documentation/plasticdocu@localhost:8087','codice@codice@cloud'" --nototal 68621 1451 /main/scm21135 11/20/2017 3:32:31 PM maria documentation/plasticdocu Added documentation about the EOL conversion mechanism. 4821759 132324 /main/SCM21120 11/20/2017 1:41:45 PM pablo codice Added missing config file 4821840 132326 /main/scm21149/scm21150 11/20/2017 1:54:35 PM vsanchezm@codicesoftware.com codice Fix HAL FAILED - Conflicts and user intervention required. Rebase from main. 4821941 132333 /main 11/20/2017 2:38:28 PM hal codice HAL: merged /main/scm21076/scm21084/scm21093 : GTK Gluon: add pending changes view
• 앞서 살펴본 바와 같이 options를 사용하여 출력 옵션을 지정할 수 있습니다(--format , --xml 또는 --file).

날짜로 필터링할 때 시스템의 현지화 설정을 준수하는 날짜 형식을 사용할 수 있습니다. 사용하는 컴퓨터의 날짜 표시 방식이 'MM-dd-yyyy' 형식이라면, 쿼리 시 '12-31-2019'와 같은 형식의 날짜를 사용할 수 있습니다.

다음 상수를 사용하여 쿼리를 간소화할 수도 있습니다.

• 'today': 오늘 날짜
• yesterday': 어제 날짜
• this week': 금주 월요일 날짜
• this month': 이번 달 1일
• this year': 이번 연도 1월 1일
• one day ago': 현재 날짜의 하루 전
• one week ago': 현재 날짜의 7일 전
• one month ago': 현재 날짜의 1개월 전
• n days ago': 현재 날짜의 'n'일 전
• n months ago': 현재 날짜의 'n'개월 전
• n years ago': 현재 날짜의 'n'년 전

다음 where 절은 date 필드 유형에서 유효합니다.

• (...) where date > 'today' (...)
• (...) where date < 'yesterday' (...)
• (...) where date > 'this week' (...)
• (...) where date > 'this month' (...)
• (...) where date < 'one day ago' and date > '3 days ago' (...)
• (...) where date < 'one week ago' and date > '3 weeks ago' (...)
• (...) where date < 'one month ago' and date > '3 months ago' (...)
• (...) where date > '1 year ago' (...)

2019년 12월 10일

2018년 12월 7일

2017년 11월 20일

2014년 7월 1일