Перевод документации к модулю inspect

inspect — Инспекция “живых” объектов

2.x/stdlib - parser. Документация

parser — Доступ к распарсенным деревьям Python

Перевод документации Sphinx. Разметка уровня параграфа + Вставка кода

• Разметка уровня параграфа
• Разметка содержания
• Словарь
• Отображение формальной грамматики
• Показ примеров кода
  • Номера строк
  • Включения

Доступный перевод по Sphinx

• Вызов sphinx-build
  • Опции Makefile
• Вызов sphinx-apidoc
• Содержание (TOC tree)
  • Специальные имена

Переезд

Поскольку большинство документации написано для Sphinx, то и переводить её удобнее в reST. В связи с этим, а так же с тем, что у меня появился хостинг, тексты я буду класть на python-lab.ru, а сюда вывешивать только обновления.
Сейчас там появилось описание библиотеки json и скоро начнёт появляться документация для Sphinx

Скачивание файла с Google Docs и преобразование ods в csv

Возникла передо мной такая задача: мы храним таблицу соответсвия мака, ip и имени ПК в гуглодоксе, она и поддерживается в актуальном состоянии. DHCP сервер работает на FreeBSD, соответственно файл с настройками сервера вполне себе текстовый. И чтобы не обновлять данные и там и там был сделан скриптик. Наверняка можно было бы сделать проще, в некоторых случаях даже понятно как (например в функции csv2dhcp), но для небольшой таблицы я заморачиваться не стал.

Для работы понадобится pyquery и второй питон (считаем, что это у Вас уже есть). Кроме того, нам нужна библиотека для доступа к Google API.

Запуск MoinMoin2.0 под Apache22 на FreeBSD9

Предполагается, что moin2 расположен в /home/ishayahu/moin-2.0

Для начала нам надо установить сам апач и mod_wsgi, чтобы он мог работать с Flask (я использую для этого portmaster (/usr/ports/ports-mgmt/portmaster)):

#portmaster www/apache22 www/mod_wsgi

Далее создаём файл moin-2.0/moinmoin2.wsgi, чтобы апач мог запускать Flask приложение:

#для работы mod_wsgi, так как он блокирует sys.stdout

import sys

sys.stdout=sys.stderr

# Собственно для Flask

from MoinMoin.app import create_app

application = create_app('/home/ishayahu/moin-2.0/wikiconfig.py')

Теперь будем настроивать апач. Создадим конфигурацию виртульного хоста: файл /usr/local/etc/apache22/Includes/wiki.local.conf

<VirtualHost *:80>

    ServerAdmin meoc-it@mail.ru

    DocumentRoot /home/ishayahu/moin-2.0

    ServerName wiki.local

    ServerAlias www.wiki.local

    ErrorLog /home/ishayahu/wiki.local-error_log

    CustomLog /home/ishayahu/wiki.local-access_log combined

    WSGIDaemonProcess moinmoin2 user=ishayahu group=ishayahu threads=5

    WSGIScriptAlias / /home/ishayahu/moin-2.0/moinmoin2.wsgi

    <Directory /home/ishayahu/moin-2.0>

        WSGIProcessGroup moinmoin2

        WSGIApplicationGroup %{GLOBAL}

        Order deny,allow

        Allow from all

    </Directory>

</VirtualHost>

Настроиваем запуск вики как сервиса. Создаём файл для запуска апача в виртуальном окружении (нужно виртуальное окнужение для работы moin; не забыть chmod +x /root/start_wiki) /root/start_wiki:

#!/bin/bash

source /home/ishayahu/moin-2.0/env/bin/activate

/usr/local/etc/rc.d/apache22 onestart

Создаём файл для регистрации вики как сервиса /etc/rc.d/wiki (не забыть chmod +x /etc/rc.d/wiki):

#!/bin/sh

#

# PROVIDE: wiki

# REQUIRE: LOGIN

# KEYWORD: shutdown

. /etc/rc.subr

name="wiki"

start_cmd="${name}_start"

stop_cmd="/usr/local/etc/rc.d/apache22 stop"

wiki_start()

{

    /bin/bash /root/start_wiki

}

load_rc_config $name

run_rc_command "$1"

И в /etc/rc.conf:

wiki_enable="YES"