Частина цінності Open Source полягає у наданні чудового прикладу коду людям, які розпочинають роботу з новою платформою чи мовою.

Який найкращий відкритий код, з яким ви стикалися, і чому вам подобається ваш вибір? Буде мова будь-якою мовою, але мене особливо цікавлять найкращі приклади Objective-C, які ви можете вказати.

Очевидно, що це питання відкритого типу, тому я залишу питання відкритим на деякий час і побачу, які типи відповідей ми отримуємо.

Спасибі!

EDIT: Для "кращих" я думав про код, який відповідає ідіомам даної мови чи платформи, а також включав частини, які роблять код "професійним" - хороша документація, набір тестувань тощо. Код є стислим, але не надто розумний віддається перевагу дуже лаконічному або балаканиному коду.

Я мушу сказати, що переглянувши біти відкритого коду протягом багатьох років, я був дуже розчарований в значній мірі все це.

Головне роздратування для мене полягає в тому, що коментарів, як правило, дуже мало, часто єдині коментарі - це довгі і легалістичні повідомлення про авторські права.

Ядро Linux - це приклад, коли у файлах часто навіть немає коментарів, які говорять, для чого вони служать (наприклад, драйвер для XYZ хоча б сказав мені, що я приблизно в потрібному місці).

Я прийшов з комерційного та оборонного програмування, де стандарти кодування вимагають розумних зрозумілих коментарів не просто для того, щоб сказати, що робить кодова одиниця, але і поза кодом повинні бути блоки коментарів, що описують алгоритми, методи, особливості, хакі / розумні речі , все так, що той, хто звертається за собою, зможе швидше подивитися і зрозуміти, що робиться, а не старанно перебираючи фактичний код.

Можливо, мораль така: Скажи мені, що ти робиш, не змушуй мене це зрозуміти.

Я не знайшов жодного відкритого коду, який би це зробив добре. Що стосується того, щоб шукати відкритий код як засіб вивчення хороших практик кодування, мій пожовклий рада: Не.

Я чув дуже гарні речі про кодову базу Sqlite .

З маленького, що я в це заглянув, це виглядає дуже чисто.

Дональд Кнут написав дві програми, які допомогли йому набрати математичні формули у своїх книгах краще, ніж міг видавець.

Ці дві програми (у їх остаточній версії) були написані за допомогою грамотного програмування, що дозволило створити друковану, набрану версію вихідного коду, і вони були опубліковані як книги. Це просто найкращі документально підтверджені програми, які я коли-небудь читав!

• "Комп'ютери та набір тексту, Том B: TeX: Програма"
• "Комп'ютери та набір тексту, Том D: Метафонт: Програма"

Вони не доступні для читання в Інтернеті, але Amazon дозволяє вам також "заглянути всередину" книги Metafont за адресою http://www.amazon.com/Computers-Typesetting-D-Metafont-Program/dp/0201134381/

Попередження: Це важкі речі, тому кожна книга працює на 600 сторінках.

Книга Beautiful Code намагається відповісти на це запитання кількома зразками того, що, як вважають учасники, є зразком прекрасного коду з проектів з відкритим кодом.

CodeIgniter

Деякі з найчистіших, найкраще задокументованих вихідних кодів, які я бачив у проекті ОС.

Я бачив 2 добре структуровані проекти:

1. Джанго
2. Хромовий проект

Тим більше, другий дуже цікавий на основі кількох речей:

• Як він використовує процеси для багатьох речей (вкладки, плагіни) і як вони поєднуються разом
• мультиплатформа з рідним графічним інтерфейсом для кожного Windows, Mac, Linux
• інтеграція веб-набору

Також я чув, що Postgre написаний чисто (на відміну від MySql), але я сам не читав цього.

Деякі кажуть, що код С для ядра Linux досить проклятий.

(Не те, що я розумію в цьому! Це, можливо, найкраще написаний проект C з відкритим кодом.)

Я знайшов вихідний код LLVM дуже читабельним. Я впевнений, що це найчистіший C ++, який я бачив. Якщо ви не знайомі з цим, це в основному інструментарій побудови компілятора.

• Він має широкий набір тестів. Насправді, у нього є щонайменше два: один набір для тестування функцій і один для тестування продуктивності (як самого LLVM, так і компільованих програм, які він генерує).
• Код добре коментується.
• Високо повторюваний код (наприклад, відповідність інструкцій у різних пакетах) автоматично генерується з опису DSL вищого рівня (називається TableGen).
  • Це також дозволяє генерувати декілька невід'ємних фрагментів коду з одного опису. Наприклад, специфікація резервного сервера використовується як частина резервного пакета компілятора, а також для збирачів і розбиральників.
• Має досить гарну документацію.

Хоча це досить великий проект, тому не сподівайтеся, що зможете швидко зрозуміти, як все працює. Але огляд на високому рівні повинен бути досить легким.

Це не величезний проект, але SubSonic ORM мені надзвичайно легко зламати. Це був перший реальний проект з відкритим кодом, який я зміг точно змінити, як мені потрібно. Більшість інших я, нарешті, дивився на джерело і стукав головою об стіну. У мене він частково підтримував PostgreSQL (ґрунтуючись на речі постачальника SQL Server) протягом декількох годин. Це найбільш добре організований проект, який я бачив досі ... хоча і не сказати, що я переглядав багато проектів з відкритим кодом.

Спочатку простий приклад: Код для системи обробки подій zope.event. Я використовував інші системи подій, які посилали події різним слухачам подій. Коли я побачив код zope.event, це був час facepalm, коли я зрозумів, як деякі речі можуть бути простими.

Він написаний Python, і ось код у повному обсязі:

subscribers = []

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

Щоб додати абонента, зробіть це:

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

Найкращий приклад KISS, який я бачив.

Тоді складніший приклад: Марсіанська база коду дуже приємна і проста для читання, навіть якщо вона використовує деякі розумні хаки Python. Те ж саме стосується більшості коду Grok, який побудований за допомогою Марсіана.

Поміркуйте, прочитавши цю книгу "Архітектура програм з відкритим кодом" . Це повинно дати вам критику, чому і як приймалися проектні рішення в проектах, про які йдеться в книзі.

Замість того, щоб шукати найкращого, яке може вам довго ухилятися, спробуйте і оцініть дизайн деяких проектів, можливо, поза рамками книги. Це може допомогти вам наростити успіхи цих проектів замість того, щоб повторювати свої помилки (або, як прийнято називати, винаходити колесо).