loadnsi 0.0.1

Utility for downloading and updating NSI fixtures

Utility for downloading and updating NSI fixtures

Project		Status
CI/CD
Quality
Package
Meta

Команда loadnsi позволяет загружать и обновлять фикстуры НСИ в которых записи имеют стабильный pk вашей внутренней системы бд.

Подготовка к запуску

1. Установка пакета

   pip install loadnsi
   

2. Создание файла переменных среды .env файл с содержимым:

   PATH_TO_LOADNSI_CONFIG=path/to/your/config/file.py
   # Требуется только если вы собираетесь использовать официальный API НСИ (Запуск команды без флага `--use_pirate_api`)
   NSI_API_USER_KEY=some-key
   

3. Создание файла конфигурации loadnsi_config.py

   NSI_FIXTURES_FOLDER = 'path/to/your/nsi/folder'
   NSI_PASSPORTS = {
       'file': 'Локальное название файла с паспортами справочников',
       'model': 'Локальное название модели с паспортами справочников',
       # Опциональные параметры (fields):
       'fields': <Iterable объект состоящий из полей паспорта (str) которые необходимо оставить в объекте паспорта>,
   }
   DICT_INTERNAL_PK = 'your pk field name *not alias*'
   PASSPORTS_REL = 'your fieldname for ForeignKey to PARENT_DICT_CLS'
   PARENT_DICT_CLS = 'your base cls modelname for dicts'
   NSI_DICTIONARIES = {
       'Локальное название файла справочника 1': {
           'model': 'Приложение.МодельСправочника1',
           'oid': 'OID Справочника 1',
           # Опциональные параметры (filter и fields):
           'filter': <Callable объект принимает справочник (dict) должен вернуть (bool) оставлять ли этот объект в списке>,
           'fields': <Iterable объект состоящий из полей справочника (str) которые необходимо оставить в объекте справочника>,
           'create_sql': <Boolean объект (bool), если True будет создан дублирующий файл справочника в SQL формате>,
       },
       'Локальное название файла справочника 2': {
           'model': 'Приложение.МодельСправочника2',
           'oid': 'OID Справочника 2',
       },
   }
   

About command

Подробности про каждую опцию команды можно узнать вызвав команду с флагом --help

Contributing

We would love you to contribute to loadnsi, pull requests are very welcome! Please see CONTRIBUTING.md for more information.