Một phần giá trị của Nguồn mở là cung cấp mã ví dụ tuyệt vời cho những người bắt đầu với một nền tảng hoặc ngôn ngữ mới.

Mã nguồn mở tốt nhất bạn gặp phải là gì và tại sao bạn thích lựa chọn của mình? Bất kỳ ngôn ngữ nào cũng được, nhưng tôi đặc biệt quan tâm đến các ví dụ tốt nhất về Objective-C mà bạn có thể chỉ ra.

Rõ ràng đây là một câu hỏi mở, vì vậy tôi sẽ để câu hỏi mở trong một thời gian và xem những loại câu trả lời chúng tôi nhận được.

Cảm ơn!

EDIT: Đối với "tốt nhất" tôi đã nghĩ đến mã theo các thành ngữ trong ngôn ngữ hoặc nền tảng nhất định, cũng như bao gồm các phần tạo mã "chuyên nghiệp" - tài liệu tốt, bộ kiểm tra, v.v. Mã đó ngắn gọn, nhưng không quá thông minh được ưu tiên cho mã rất ngắn gọn hoặc trò chuyện.

Tôi phải nói rằng đã xem xét các bit của mã nguồn mở trong nhiều năm qua, tôi đã rất thất vọng với khá nhiều về nó.

Sự khó chịu chính đối với tôi là thường có rất ít bình luận, thường thì những bình luận duy nhất là một số thông báo bản quyền dài và hợp pháp.

Hạt nhân linux là một ví dụ trong đó các tệp thường không có bình luận trong đó cho biết mục đích của chúng là gì (ví dụ: trình điều khiển cho XYZ ít nhất sẽ cho tôi biết tôi đang ở đúng vị trí).

Tôi đến từ lập trình thương mại và quốc phòng nơi các tiêu chuẩn mã hóa đòi hỏi những nhận xét rõ ràng hợp lý không chỉ để nói đơn vị mã làm gì, mà thông qua mã phải có các khối nhận xét mô tả thuật toán, phương pháp, đặc thù, hack / điều thông minh , tất cả để bất cứ ai đến sau đều có thể nhìn và tìm ra NHANH CHÓNG những gì đang được thực hiện thay vì siêng năng lội qua mã thực tế.

Có lẽ đạo đức là: Hãy nói cho tôi biết bạn đang làm gì, đừng bắt tôi phải tìm ra nó.

Tôi đã không tìm thấy BẤT K code mã nguồn mở nào làm tốt điều này. Theo như tìm kiếm nguồn mở như một phương tiện để học các thực hành mã hóa tốt, lời khuyên vàng da của tôi là: Đừng.

Tôi đã nghe những điều rất hay về cơ sở mã hóa Sqlite .

Từ nhỏ tôi đã nhìn vào nó, nó trông rất sạch sẽ.

Donald Knuth đã viết hai chương trình để giúp anh ta sắp xếp các công thức toán học của mình trong các cuốn sách của mình tốt hơn so với nhà xuất bản của anh ta có thể.

Hai chương trình này (trong phiên bản cuối cùng của chúng) được viết bằng Lập trình Văn học , cho phép tạo ra một phiên bản in, sắp chữ của mã nguồn và chúng được xuất bản thành sách. Đây chỉ đơn giản là những chương trình tài liệu tốt nhất mà tôi từng đọc!

• "Máy tính & sắp chữ, Tập B: TeX: Chương trình"
• "Máy tính & sắp chữ, Tập D: Metafont: Chương trình"

Chúng không có sẵn để đọc trực tuyến, nhưng Amazon cũng cho phép bạn "Nhìn vào bên trong" cuốn sách Metafont tại http://www.amazon.com/Computers-Typesetting-D-Metafont-Program/dp/0201134381/

Cảnh báo: Đó là một thứ nặng nề, đó là lý do tại sao mỗi cuốn sách chạy ở 600 trang.

Cuốn sách Beautiful Code cố gắng trả lời câu hỏi này bằng một số mẫu về những gì người đóng góp nghĩ là mẫu mực của mã đẹp từ các dự án nguồn mở.

CodeIgniter

Một số mã nguồn tài liệu tốt nhất, sạch nhất mà tôi đã thấy từ một dự án hệ điều hành.

Tôi đã thấy 2 dự án có cấu trúc rất tốt:

1. Django
2. Dự án Chromium

Đặc biệt, thứ hai là rất thú vị dựa trên một vài điều:

• Cách nó sử dụng các quy trình cho nhiều thứ (tab, trình cắm) và cách nó khớp với nhau
• đa nền tảng với GUI gốc cho từng Windows, Mac, Linux
• tích hợp web-kit

Ngoài ra, tôi nghe nói Postgre được viết sạch sẽ (trái ngược với MySql), nhưng tôi đã không tự đọc nó.

Một số người nói rằng mã C cho Linux Kernel khá tốt.

(Không phải tôi hiểu điều đó! Đây có thể là dự án C nguồn mở được viết tốt nhất xung quanh.)

Tôi đã tìm thấy mã nguồn LLVM rất dễ đọc. Tôi khá chắc chắn rằng đó là C ++ sạch nhất tôi từng thấy. Nếu bạn không quen thuộc với nó, về cơ bản nó là một bộ công cụ xây dựng trình biên dịch.

• Nó có một bộ thử nghiệm rộng rãi. Thực tế, nó có ít nhất hai: một bộ cho các tính năng thử nghiệm và một cho hiệu năng thử nghiệm (của chính LLVM cũng như các chương trình được biên dịch mà nó tạo ra).
• Các mã được bình luận tốt.
• Mã lặp lại cao (như khớp lệnh trong các phụ trợ khác nhau) được tạo tự động từ mô tả DSL cấp cao hơn (gọi là TableGen).
  • Điều này cũng cho phép tạo ra nhiều đoạn mã rời rạc từ cùng một mô tả. Ví dụ, đặc tả phụ trợ được sử dụng như một phần của phụ trợ trình biên dịch, nhưng cũng dành cho trình biên dịch và trình dịch ngược.
• Nó có tài liệu khá tốt.

Tuy nhiên, đây là một dự án khá lớn, vì vậy đừng hy vọng có thể nhanh chóng hiểu chính xác mọi thứ hoạt động như thế nào. Nhưng nó sẽ khá dễ dàng để có được một cái nhìn tổng quan cấp cao.

Đó không phải là một dự án lớn, nhưng ORS SubSonic cực kỳ dễ dàng để tôi hack. Đó là dự án nguồn mở thực sự đầu tiên tôi có thể sửa đổi chính xác những gì tôi cần. Hầu hết những người khác cuối cùng tôi nhìn vào nguồn và đập đầu vào tường. Tôi đã có nó hỗ trợ một phần PostgreSQL (dựa trên điều nhà cung cấp SQL Server) trong vài giờ. Đó là dự án được tổ chức tốt nhất mà tôi từng thấy ... mặc dù không nói rằng tôi đã xem xét rất nhiều dự án nguồn mở.

Đầu tiên là một ví dụ đơn giản: Mã cho hệ thống xử lý sự kiện zope.event. Tôi đã sử dụng các hệ thống sự kiện khác, đã gửi các sự kiện đến những người nghe sự kiện khác nhau. Khi tôi nhìn thấy mã zope.event, đó là thời gian facepalm, khi tôi nhận ra một số thứ có thể đơn giản như thế nào.

Nó được viết bằng Python và đây là toàn bộ mã:

subscribers = []

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

Để thêm một thuê bao, bạn làm điều này:

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

Ví dụ tốt nhất về KISS tôi đã thấy.

Sau đó, một ví dụ phức tạp hơn: Cơ sở mã sao Hỏa rất đẹp và dễ đọc, mặc dù nó sử dụng một số hack Python thông minh. Điều tương tự cũng xảy ra với hầu hết mã của Grok, được xây dựng bằng Martian.

Xem xét việc đọc cuốn sách này Kiến trúc của các ứng dụng nguồn mở . Nó sẽ cung cấp cho bạn một bài phê bình về lý do tại sao và làm thế nào các quyết định thiết kế đã được thực hiện trong các dự án được thảo luận trong cuốn sách.

Thay vì tìm kiếm thứ tốt nhất, thứ có thể trốn tránh bạn lâu dài, hãy thử và đánh giá cao thiết kế của một số dự án, có lẽ vượt quá phạm vi của cuốn sách. Điều đó có thể giúp bạn xây dựng dựa trên những thành công của các dự án này thay vì lặp lại sai lầm của họ (hoặc, như cách gọi phổ biến, phát minh lại bánh xe).