협업 중...

작업

지난 몇 주 동안 우리는 .txt 파일을 가져와 HTML 마크업으로 변환할 정적 사이트 생성기를 만드는 수업을 받았습니다. 저는 Python에서 작업하기로 선택했고 출력 디렉터리를 지정하고 .txt 파일의 첫 줄에서 H1 및 제목을 구문 분석하는 기능을 추가했습니다.

함께할 동료학생 찾기

우리 오픈 소스 개발 과정의 모든 학생들이 같은 여유를 가지고 있고 우리 중 많은 사람들이 거기에 게시하는 것이 매우 편안하고 협력할 사람을 찾고 도움을 요청할 수 있다는 점을 감안할 때 매우 빠르고 쉽습니다. Ivan과 Maxim은 슬랙 채널에서 찾은 두 사람이며 서로의 코드를 동료 검토했습니다.

협업 시작

첫 번째 릴리스에 대한 작업 시간이 끝나감에 따라 우리 중 많은 사람들이 자체 버전의 도구 개발 단계가 매우 다양하다는 것이 여전히 분명합니다. 처음에는 Ivan Gabrovsky와 함께 작업하려고 했지만 이 단계에서는 그의 코드를 테스트할 수 없지만 그의 초기 README.md에 세부 정보가 부족하다고 언급했으며 추가 커밋에서 테스트할 것입니다. 그는 내 코드를 살펴보고 자신의 컴퓨터에서 작동하도록 시도할 만큼 친절했습니다. 그는 Apple 컴퓨터를 사용하고 있고 저는 Windows 컴퓨터에서 작업하고 있습니다. 그는 내 코드의 일부에 있는 인코딩 기능이 작동하지 않거나 그 효과가 있다고 말하는 향후 조사해야 할 오류를 발견했습니다. 나는 그것을 복제하고 디버깅할 수 없었고, 공동 작업을 시작한 다른 학생도 마찬가지였지만 계속 지켜볼 것입니다.

Ivan이 현재 작업하고 있는 코드에 내가 너무 많이 기여할 수 없다는 점을 감안하여 Maxim의 코드를 살펴보고 그의 노드 프로젝트에서 오래된 것으로 보이는 종속성과 같은 몇 가지 문제를 제기했습니다.

내 첫 번째 닫힌 문제

https://github.com/sfrunza13/SiteGenerationTool/issues/1
Maxim은 내 코드에서 내가 복제할 수 있는 다른 오류를 발견했고 그가 문제를 제기하자 즉시 수정했습니다. 내 사이트 생성기에서 dist 폴더가 항상 생성되는 것은 아닙니다. 프로젝트 구조에 dist 폴더가 없고 지정된 출력이 없는 경우 이전 디렉터리를 삭제하려는 시도와 동일한 try catch에 있기 때문에 오류가 발생합니다. 이 문제를 해결하기 위해 해당 try catch에서 제거했으며 이제 이전 디렉터리 삭제에 오류가 있어도(예를 들어 거기에 없다고 가정함) 여전히 동일한 이름으로 새 디렉터리를 생성합니다.

try:

        shutil.rmtree(SiteGen.output)
        os.mkdir(SiteGen.output)
    except OSError as error:
        print(error)

대

    try:

        shutil.rmtree(SiteGen.output)

    except OSError as error:
        print(error)

    os.mkdir(SiteGen.output)

내가 배운 것

서로의 컴퓨터에서 실행되는 항목을 얻는 것은 어렵습니다. README.md는 프로그램을 테스트하는 사람들이 작가만큼 기술에 정통하더라도 처음에 예상했던 것보다 더 많은 세부 정보를 포함해야 합니다. 또한 두 경우 모두에서 문제가 즉시 발생하는 것을 보고 그렇게 하는 것이 매우 유익하다는 것을 배웠습니다. 하나는 복제하고 수정할 수 있을 만큼 운이 좋았고 다른 하나는 그렇게 많지는 않지만 우리는 거기에 도달할 것입니다.