Class Log¶

log(studio)

level = ‘studio’/’project’

Данные хранимые в БД (имя столбца : тип данных):

# level: project
# file_name: .tasks_logs.db
# table_name: [asset id]:[activity name]:logs
logs_keys = {
  'version': 'text',              # hex 4 символа
  'date_time': 'timestamp',       # время и дата записи
  'activity': 'text',             # ативити задачи
  'task_name': 'text',            # имя задачи
  'action': 'text',               # тип записи из log.log_actions
  'artist': 'text',               # nik_name артиста, кто делает запись
  'description': 'text',          # коментарий
  'source': 'json',               # для push - версия коммита источника (в случае sketch - список версий по всем веткам, порядок совпадает с порядком записи веток в branch), для publish - версия push источника.
  'branch' : 'text',              # ветка - в случае push, publish (для sketch - список веток).
  'time' : 'integer',             # время затраченное на commit, ед. измерения секунда.
  }

# level: studio
# file_name: .artists_logs.db
# table_name: [nik name]_tasks_logs
artists_logs_keys = {
  'project_name': 'text',
  'task_name': 'text',
  'full_time': 'integer',         # суммарное время затраченое артистом на задачу, ед. измерения секунда. Суммируется при каждом коммите.
  'price': 'real',                # сумма начисленная за выполнение задачи. вносится по принятию задачи.
  'start': 'timestamp',           # дата-время создания записи, запись создаётся при первом open задачи.
  'finish': 'timestamp',          # дата-время принятия задачи.
  }

Создание экземпляра класса:¶

import edit_db as db

project = db.project()
asset = db.asset(project)
task = db.task(asset)

log = db.log(task) # task - обязательный параметр при создании экземпляра log
# доступ ко всем параметрам и методам принимаемого экземпляра task - через log.task

Атрибуты¶

log_actions:	(list) - [‘commit’, ‘push’, ‘publish’, ‘open’, ‘report’,’recast’ , ‘change_artist’, ‘close’, ‘done’, ‘return_a_job’, ‘send_to_outsource’, ‘load_from_outsource’]
task:	(task) - экземпляр Class Task принимаемый при создании экземпляра класса, содержит все атрибуты и методы Class Task.

Методы¶

Tasks logs¶

write_log(logs_keys[, artist_ob=False])¶

запись лога активити задачи.

Note

self.task - должен быть инициализирован

Параметры:

logs_keys (dict) - словарь по studio.logs_keys - обязательные ключи: description, version, action
artist_ob (bool/artist) - если False - значит создаётся новый объект artist() и определяется текущий пользователь
return - (True, ‘Ok!’) или (False, comment)

read_log([action=False])¶

чтение лога активити задачи.

Note

заполняет атрибут класса self.task.branches

Параметры:

action (bool / str / list) если False - то возврат для всех action, если list - то будет использован оператор WHERE OR тоесть возврат по всем перечисленным экшенам.
branch (bool / str / unicode) - фильтр по веткам, если False - то вернёт логи для всех веток.
return - (True, ([список словарей логов, сотрирован по порядку], [список наименований веток])) или (False, comment)

get_push_logs([task_data=False, time_to_str = False])¶

возврат списка push логов для задачи.

Note

Возможно устаревшая

Параметры:

task_data (bool/dict) - если False - значит читается self.task лучше не использовать
time_to_str (bool) - если True - то преобразует дату в строку
return - (True, ([список словарей логов, сотрирован по порядку], [список наименований веток])) или (False, comment)

Artists logs¶

artist_start_log([artist_ob=False])¶

создание, при отсутствии, лога артиста по данной задаче, заполнение artist_log.start

Параметры:

artist_ob (bool/artist) - если False - значит создаётся новый объект artist и определяется текущий пользователь.
return - (True, ‘ok!’) или (False, comment)

artist_read_log([all=False, artist_ob=False])¶

чтение логов артиста.

Параметры:

all (bool) - если True - то все логи этого артиста, если False - То только по этой задаче.
artist_ob (bool/artist) - если False - значит создаётся новый объект artist и определяется текущий пользователь.
return:
- all = True - (True, [список логов - словари])
- all = False - (True, {log})
- или (False, coment)

artist_write_log(keys[, artist_ob=False])¶

внесение изменений в лог артиста по задаче (кроме параметров из no_editable_keys)

Параметры:

keys (dict) - словарь данных на замену по ключам artists_logs_keys
artist_ob (bool/artist) - если False - значит создаётся новый объект artist и определяется текущий пользователь.
return - (True, ‘ok!’) или (False, comment)

artist_add_full_time(time[, artist_ob=False])¶

добавление временик full_time.

time (float) - время затраченное на commit (секунды)
artist_ob (bool/artist) - если False - значит создаётся новый объект artist и определяется текущий пользователь.
return - (True, ‘ok!’) или (False, comment)

Cameras logs¶

camera_write_log(artist_ob, comment, version[, task_data=False])¶

запись лога для сохраняемой камеры шота.

Параметры:

artist_ob - (artist) - объект artist, его никнейм записывается в лог
comment (str) - комментарий
version (str/int) - номер версии <= 9999 ``возможно должно быть автоопределение ``
task_data (bool/dict) - если False - значит читается self.task лучше не использовать
return - (True, ‘Ok!’) или (False, comment)

camera_read_log([task_data=False])¶

чтение логов камеры шота.

Параметры:

task_data (bool/dict) - если False - значит читается self.task лучше не использовать
return - (True, [{camera_log}, … ]) (возвращаемый список сортирован по порядку) или (False, comment)

Playblasts logs¶

playblast_write_log(artist_ob, comment, version[, task_data=False])¶

запись лога создаваемого плейбласта шота.

Параметры:

artist_ob - (artist) - объект artist, его никнейм записывается в лог
comment (str) - комментарий
version (str/int) - номер версии <= 9999 ``возможно должно быть автоопределение ``
task_data (bool/dict) - если False - значит читается self.task лучше не использовать
return - (True, ‘Ok!’) или (False, comment)

playblast_read_log([task_data=False])¶

чтение логов плейбластов шота.

Параметры:

task_data (bool/dict) - если False - если False - значит читается self.task лучше не использовать
return - (True, [{playblast_log}, … ]) (возвращаемый список сортирован по порядку) или (False, comment)