Краткое описание пакета
=======================

Пакет разработан для просмотра дерева объектов в Zope3 и передачу
значений их атрибутов на редактирование внешней утилите. Помимо библиотеки,
предоставляет одну утилиту:

    ngxmlrpcscan
        Утилита, которая сканирует дерево объектов в Zope3, после
        того как там установлен модуль ng.xmlrpcscan.

        Формат вызова::

            ngxmlrpcscan [<КЛЮЧИ>] <URL> [<ATTRIBUTE>  ...]

        Ключи:
        
            -v
                Выводить трассировку;
                
            -p
                Делать паузу перед каждым запуском внешней программы;
                
                
            -c <CLASSNAME>
                Проверять что объект является объектом этого класса;
                
            -s  
                Сохранять атрибут после запуска внешней программы;

            -i <INTERFACE>
                Приводить объект к этому интерфейсу (если приводится);

            -n
                Не проводить рекурсивный просмотр объектов, отредактировать
                текущий и все.

            -e
                Запустить указанную командную строку (иначе печатается
                полученный атрибут).  В коомандной строке вместо %(name)s
                будет подставлено имя файла на диске, в котором сохранен
                атрибут. Предполагается, что запускаемая программа читает и
                сохраняет данные в этом атрибуте.

                
        Параметры:
        
            <URL>
                URL с которого начинается просмотр дерева объектов,
                если требуется авторизация - в URL указывается логин
                и пароль;
                
            <ATTRIBUTE>
                Просто атрибут. Должен быть доступен через указанный интерфейс.
                
        Пример запуска::
        
            ngxmlrpcscan.py -s -p -v \
                -i zope.app.folder.folder.Folder
                -с zope.dublincore.interfaces.IZopeDublinCore \
                -e "joe  %(name)s "
                http://theman:12345678@localhost:8080/Root/Main \
                 title description        
                
        Этот пример будет запускать программу joe что бы редактировать все
        атрибуты title и description через IZopeDublinCore (метаинформацию)
        
        Пример запуска для одного объекта::
        
            ngxmlrpcscan -v  -e -n \
                http://theman:12345678@localhost:8080/Root/Main \
                "joe '%(name)s'" body 

        Так можно удобно отредактировать один единственный атрибут. В вашем
        любимом редакторе.
                                                                                                    
        Кроме того, программа может использоваться для отладки адаптеров.
        