2010-01-15 2 views
3

Существует множество приложений/виджетов для ссылки на PHP-функцию и даже для Ruby, но я шокирован тем, что нет ничего доступного для популярного языка, такого как Python (помимо официальной онлайн-документации).Справочник по функции Python

На самом деле нет ни одного удобного справочного виджета/приложения для Python? У меня есть книга «Pocket Reference», но виджет панели инструментов будет таким удобным!

+1

Я не уверен, что вы подразумеваете под «ссылочным виджетами/приложениями», но если вы работаете в Windows, в папке Doc Python имеется удобный файл справки .chm, если это то, что вы ищете. Это всего лишь локальная копия онлайн-справки. –

+0

Нет, я нахожусь на Mac. По виджетам я имею в виду виджет панели инструментов, но приложение я имею в виду обычное приложение, которое позволяет искать имена функций и документацию. – 3zzy

ответ

1

Библиотеки Python имеют (или должны иметь) встроенную документацию через docstrings. Кроме того, код python (в основном) очень читабельный, и чтение источника (.py или даже .c) на самом деле является предпочтительным способом для многих разработчиков получить информацию, которую они ищут, тем более, что некоторые угловые случаи могут даже не быть документированы.

Я поймал себя на том, что время от времени просматриваю источник, как если бы это был естественный шаг в поиске функциональности, потому что мне любопытно, как они решают проблему, или потому, что я считаю, что это быстрее, чем проблемы с поиском непонятных и чтение вопросов SO.

0
  1. Интерактивный интерпретатор является фантастическим справочным инструментом. dir(<identifier) перечисляет все атрибуты модуля, класса или функции. help(<identifier>) дает вам помощь по тому же самому.

  2. pydoc в командной строке - еще один отличный инструмент. Он делает для Python то, что man дает вам команды, плюс даже включает веб-сервер, который вы можете запустить, чтобы увидеть документацию в своем браузере.

-1

Я развиваюсь на Mac OS.

У меня есть вся документация Python, доступная прямо через настольное приложение.

Приложение называется Safari. I bookmark http://docs.python.org/index.html

Это доступно в качестве настольного приложения.

+2

Неужели ты никогда не воздерживаешься от саркастичности? Сарказм - самая низкая форма остроумия, разве вы не знали? Я уважаю вас, вашу репутацию и ваши возможности программирования, но, пожалуйста, прекратите обращаться с другими, как будто у них нет мозгов. Я указал в своем описании «помимо официальной документации», поэтому ваш ответ не имеет значения. Мне нужно что-то похожее на это: http://www.artissoftware.com/phpfi/ или http://www.apple.com/downloads/dashboard/developer/phpfunctionreference.html – 3zzy

+0

Рассмотрите это всего лишь мимолетную секунду. Есть небольшая возможность, что ваш вопрос трудно понять. –

+0

Также подумайте: «Но я в шоке от того, что нет ничего доступного». Это не вопрос. Это (а) оценочное суждение и (б) отрицательное. Если бы вы могли найти способ писать без оценочных суждений и негатива, было бы легче правильно разобрать ваши вопросы. Оценки отрицательных значений являются камнем преткновения. Это красный флаг. Это стиль письма, который закрывает ваш смысл. Они не добавляют никакой ценности к вопросу. –