오픈 소스의 가치 중 일부는 새로운 플랫폼이나 언어를 시작하는 사람들에게 훌륭한 예제 코드를 제공하는 것입니다.

가장 좋은 오픈 소스 코드는 무엇이며 왜 선택을 좋아합니까? 모든 언어가 가능하지만 특히 Objective-C의 모범 사례에 관심이 있습니다.

분명히 이것은 개방형 질문이므로 잠시 동안 질문을 열어두고 어떤 종류의 답변을 얻을 수 있는지 살펴 보겠습니다.

감사!

편집 : "최고의"나는 주어진 언어 또는 플랫폼에서 관용구를 따르는 코드뿐만 아니라 코드를 "전문적"으로 만드는 부분-좋은 문서, 테스트 스위트 등을 포함하는 코드를 생각하고 있었지만 간결한 코드이지만 지나치게 간결하거나 수다스러운 코드보다 지나치게 영리하지 않은 것이 좋습니다.

수년 동안 오픈 소스 코드를 살펴본 결과 거의 모든 것에 실망했습니다.

저에게 가장 큰 자극은 대개 의견이 거의 없다는 것입니다. 종종 유일한 의견은 길고 합법적 인 저작권 표시입니다.

리눅스 커널은 파일이 어떤 용도로 사용되는지에 대한 주석이없는 예입니다 (예 : XYZ 용 드라이버는 적어도 제게 올바른 위치에 있다고 말합니다).

나는 코딩 표준이 코드 단위의 기능을 말할뿐만 아니라 이해하기 쉬운 주석을 요구하는 상용 및 방위 프로그래밍에서 왔으며 코드를 통해 알고리즘, 방법, 특성, 해킹 / 영리한 것들을 설명하는 주석 블록이 있어야합니다. , 뒤 따르는 사람이 실제 코드를 힘들게 넘어 가지 않고 수행되는 작업을 신속하게보고 파악할 수 있습니다.

아마도 도덕은 : 당신이 무엇을하고 있는지 말 해주세요.

나는 이것을 잘하는 오픈 소스 코드를 찾지 못했습니다. 좋은 코딩 관행을 배우기위한 수단으로 오픈 소스를 찾고있는 한, 황홀한 조언은 : Do n't.

Sqlite 코드베이스 에 대해 매우 좋은 소식을 들었습니다 .

내가 조사한 작은 것부터 매우 깨끗해 보입니다.

Donald Knuth는 두 권의 프로그램을 작성하여 출판인이 할 수있는 것보다 책에서 수학 공식을 더 잘 조판 할 수있었습니다.

이 두 프로그램 (최종 버전)은 Literate Programming 을 사용하여 작성되었으며 , 소스 코드의 인쇄 된 조판 버전을 만들 수있게했으며 책으로 출판되었습니다. 이것들은 내가 읽은 최고의 문서화 된 프로그램입니다!

• "컴퓨터 및 조판, 볼륨 B : TeX : 프로그램"
• "컴퓨터 및 조판, 볼륨 D : 메타 폰트 : 프로그램"

온라인으로 읽을 수는 없지만 아마존에서는 http://www.amazon.com/Computers-Typesetting-D-Metafont-Program/dp/0201134381/ 의 메타 폰트 책을 "내부로"볼 수 있습니다 .

경고 : 내용이 무겁기 때문에 각 책이 600 페이지에 달합니다.

Beautiful Code 책 은 기고자들이 오픈 소스 프로젝트의 아름다운 코드의 모범이라고 생각하는 몇 가지 샘플 로이 질문에 대답하려고합니다.

코드 점화기

OS 프로젝트에서 본 가장 깨끗하고 문서화 된 소스 코드 중 일부입니다.

나는 매우 잘 구성된 두 개의 프로젝트를 보았습니다.

1. 장고
2. 크롬 프로젝트

특히 두 번째는 몇 가지 사항에 기초하여 매우 흥미 롭습니다.

• 여러 가지 프로세스 (탭, 플러그인)에 프로세스를 사용하는 방법과 서로 맞는 방법
• 각 Windows, Mac, Linux에 고유 한 GUI가있는 다중 플랫폼
• 웹 키트 통합

또한 Postgre가 깨끗하게 작성되었다고 들었지만 (MySql과 대조적으로) 직접 읽지는 않았습니다.

리눅스 커널을위한 C 코드 가 꽤 좋다고 말하는 사람들도있다 .

(나는 그것을 이해하지 못한다! 아마도 가장 훌륭한 오픈 소스 C 프로젝트 일 것이다.)

LLVM 소스 코드가 매우 읽기 쉽다 는 것을 알았습니다 . 내가 본 것 중 가장 깨끗한 C ++라고 확신합니다. 익숙하지 않다면 기본적으로 컴파일러 구성 툴킷입니다.

• 광범위한 테스트 스위트가 있습니다. 실제로, 기능 테스트를위한 세트와 성능 테스트를위한 세트 (LLVM 자체 및 생성 된 컴파일 된 프로그램) 중 하나 이상이 있습니다.
• 코드는 주석이 잘되어 있습니다.
• 반복성이 높은 코드 (예 : 다양한 백엔드의 명령어 일치와 같은)는 상위 수준 DSL (TableGen이라고 함) 설명에서 자동 생성됩니다.
  • 또한 동일한 설명에서 여러 개의 분리 된 코드 조각을 생성 할 수 있습니다. 예를 들어 백엔드 사양은 컴파일러 백엔드의 일부로 사용되지만 어셈블러 및 디스어셈블러에도 사용됩니다.
• 꽤 좋은 문서가 있습니다.

그것은 꽤 큰 프로젝트이므로 모든 것이 어떻게 작동하는지 정확하게 이해할 수 있다고 기대하지 마십시오. 그러나 높은 수준의 개요를 얻는 것은 매우 쉽습니다.

큰 프로젝트는 아니지만 SubSonic ORM 은 해킹하기가 매우 쉽습니다. 내가 필요한 방식을 정확하게 수정할 수 있었던 최초의 실제 오픈 소스 프로젝트였습니다. 다른 사람들의 대부분은 소스를보고 벽에 머리를 부딪 혔습니다. 몇 시간 내에 PostgreSQL (SQL Server 공급자에 따라)을 부분적으로 지원했습니다. 내가 본 것 중 가장 잘 구성된 프로젝트입니다 ...하지만 많은 오픈 소스 프로젝트를 보았습니다.

첫 번째 간단한 예 : 이벤트 처리 시스템 zope.event의 코드. 다른 이벤트 리스너에게 이벤트를 전달하는 다른 이벤트 시스템을 사용했습니다. zope.event 코드를 보았을 때 페이스 팜 타임이었는데 얼마나 간단한 지 깨달았습니다.

파이썬으로 작성되었으며 다음은 전체 코드입니다.

subscribers = []

def notify(event):
    """ Notify all subscribers of ``event``.
    """
    for subscriber in subscribers:
        subscriber(event)

가입자를 추가하려면 다음을 수행하십시오.

from zope.event import subscribers
subscribers.add(MySubscriber())

내가 본 KISS의 가장 좋은 예.

더 복잡한 예 : Martian 코드 기반은 영리한 파이썬 핵을 사용하더라도 매우 훌륭하고 읽기 쉽습니다. Martian을 사용하여 빌드 된 대부분의 Grok 코드도 마찬가지입니다.

이 책을 읽으십시오 . 오픈 소스 응용 프로그램의 아키텍처 . 이 책에서 논의 된 프로젝트에서 설계 결정이 내려진 이유와 방법에 대한 비판을 제공해야합니다.

오랫동안 당신을 피할 수있는 최고를 찾는 대신, 아마도 책의 범위를 벗어난 일부 프로젝트의 디자인을 시도하고 고맙게 생각하십시오. 이를 통해 실수를 반복하지 않고 (또는 일반적으로 바퀴를 재창조하는 대신) 이러한 프로젝트의 성공을 달성하는 데 도움이 될 수 있습니다.