Module: TrelloBackupRenderer::Parsing

Includes:
Models
Included in:
TrelloBackupRenderer
Defined in:
lib/trello_backup_renderer/parsing.rb

Instance Method Summary collapse

Instance Method Details

#find_board_json_file(dir) ⇒ Object

Raises:



75
76
77
78
79
 
# File 'lib/trello_backup_renderer/parsing.rb', line 75

def find_board_json_file(dir)
  board_file_paths = Dir.glob(File.join(dir, '*_full.json')).to_a
  raise Error, "Expected one <board_name>_full.json file in: #{dir}" unless board_file_paths.count == 1
  board_file_paths.first
end

#load_attachment_paths(dir) ⇒ Object 



59
60
61
62
63
64
65
66
67
68
69
 
# File 'lib/trello_backup_renderer/parsing.rb', line 59

def load_attachment_paths(dir)
  paths = {}
  Dir.glob(File.join(dir, '*_*', '*_*', 'attachments', '*')) do |path|
    if File.file?(path) && match = /\A\d+_(?<id>[a-z0-9]+).*\z/.match(File.basename(path))
      # I'm just assuming the attachment IDs are globally unique rather than scoped to the card,
      # although I wasn't able to confirm this in the API docs.
      paths[match[:id]] = path
    end
  end
  paths
end

#load_board_dir(dir) ⇒ Object

Raises:



81
82
83
84
85
86
87
 
# File 'lib/trello_backup_renderer/parsing.rb', line 81

def load_board_dir(dir)
  raise Error, "Not a directory: #{dir}" unless File.directory?(dir)
  board_file_path = find_board_json_file(dir)
  board_json = JSON.parse(File.read(board_file_path))
  attachment_paths = relativize_attachment_paths(load_attachment_paths(dir), dir)
  parse_board_json(board_json, attachment_paths)
end

#parse_board_json(board_json, attachment_paths) ⇒ Object 



50
51
52
53
54
55
56
57
 
# File 'lib/trello_backup_renderer/parsing.rb', line 50

def parse_board_json(board_json, attachment_paths)
  attachments_by_id = attachment_paths.transform_values { |path| Attachment.new(path: path) }
  comments = (board_json['actions'] || []).map { |action_json| parse_comment_json(action_json) }.compact
  cards = (board_json['cards'] || []).map { |card_json| parse_card_json(card_json, attachments_by_id, comments) }
  Board.new(
    lists: (board_json['lists'] || []).map { |list_json| parse_list_json(list_json, cards) }
  )
end

#parse_card_json(card_json, attachments_by_id, comments) ⇒ Object 



24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
 
# File 'lib/trello_backup_renderer/parsing.rb', line 24

def parse_card_json(card_json, attachments_by_id, comments)
  cover_id_attachment = card_json.fetch('cover', {})['idAttachment']

  Card.new(
    closed: card_json['closed'],
    comments: comments.select { |comment| comment.id_card == card_json['id'] },
    cover_attachment: attachments_by_id[cover_id_attachment],
    desc: (card_json['desc'] if card_json['desc'] && !card_json['desc'].empty?),
    id: card_json['id'],
    id_list: card_json['idList'],
    labels: (card_json['labels'] || []).map { |label_json| parse_label_json(label_json) },
    name: card_json['name'],
    pos: card_json['pos']
  )
end

#parse_comment_json(action_json) ⇒ Object 



7
8
9
10
11
12
13
14
15
 
# File 'lib/trello_backup_renderer/parsing.rb', line 7

def parse_comment_json(action_json)
  return nil unless action_json['type'] == 'commentCard'
  Comment.new(
    creator_full_name: action_json['memberCreator']['fullName'],
    date: action_json['date'],
    id_card: action_json['data']['card']['id'],
    text: action_json['data']['text']
  )
end

#parse_label_json(label_json) ⇒ Object 



17
18
19
20
21
22
 
# File 'lib/trello_backup_renderer/parsing.rb', line 17

def parse_label_json(label_json)
  Label.new(
    color: label_json['color'],
    name: label_json['name']
  )
end

#parse_list_json(list_json, cards) ⇒ Object 



40
41
42
43
44
45
46
47
48
 
# File 'lib/trello_backup_renderer/parsing.rb', line 40

def parse_list_json(list_json, cards)
  List.new(
    cards: (cards.select { |card| card.id_list == list_json['id'] }),
    closed: list_json['closed'],
    id: list_json['id'],
    name: list_json['name'],
    pos: list_json['pos']
  )
end

#relativize_attachment_paths(paths, base_dir) ⇒ Object 



71
72
73
 
# File 'lib/trello_backup_renderer/parsing.rb', line 71

def relativize_attachment_paths(paths, base_dir)
  paths.transform_values { |path| path.sub(/\A#{Regexp.quote(base_dir)}\/?/, '')}
end