trellodon 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bf1b8715b6cbad2c1bd3ab4fce72198a442380cf4f2d7bb39c55928ef72b032f
-  data.tar.gz: 2caa2a3a24fe463cc1cb730a3aad68928323ec0fea04fea8e3a0f10ebf051ea7
+  metadata.gz: a61911e92509a77f13aa90f9f56c14d038dbe443b4e1063d28f66b6745b04432
+  data.tar.gz: '079609a773107e786a7d795fe7d23564ded2aa66e8d587a6fd22b4e288e15478'
 SHA512:
-  metadata.gz: b50b3279f7a9e787b2f2e718109902a9cda88729f7d7b330aa5db9db944f913af33d6f26fab7b1f6c4d2866a1241d62d99c4dbe989ea468499bcaaa4908a153f
-  data.tar.gz: 52d86ebd0b43ad0b064facbfb66332623422b2c688eff732188b7ea2ce8baba2842a331a941e1aafb410f114c31aef3ec80f7588b7f6a07808070019f9eb12ba
+  metadata.gz: 617119b48c1f2385c87d57ffd2683933097ed1aae11a51577f65e16012ab1f58b65187f57884123ed04ba522797925826e3cf202e7d4dad9d1fd63a3d736bcef
+  data.tar.gz: 30c1f1bcb2df2c69a3c8d0cebc93a597f16d2207d33bef979670134d306bd0173cc97948f38f739cf1d6b5eef0a7a602112fb0de40021d078d0188280ca4d039

data/CHANGELOG.md

@@ -1,5 +1,31 @@
-## [Unreleased]
+# Change log
+
+## [master]
+
+## [0.3.0] - 2022-04-12 🚀🚀🚀
+
+- Handle missing members. ([@palkan][])
+
+- Use inline scheduler by default. ([@palkan][])
+
+- Replace `--sync` with `--concurrency=0`. ([@palkan][])
+
+## [0.2.1] - 2022-04-12 🚀
+
+- Misc changes.
+
+## [0.2.0] - 2022-04-12
+
+- Store Trello API creds locally for avoid asking it before execution ([@fargelus][]).
+- Download attachments, human names in comments, rename index.md to README.md ([@rinasergeeva][]).
+- Added minimal project README.md ([@rinasergeeva][], [@fargelus][]).
+- --sync param for switch to `Schedulers::Inline` in CLI ([@fargelus][]).
+- Concurrent scheduler with customizable thread pool size ([@fargelus][]).
+- Checklists support ([@rinasergeeva][]).
 
 ## [0.1.0] - 2022-04-07
 
 - Initial release
+
+[@fargelus]: https://github.com/fargelus
+[@rinasergeeva]: https://github.com/rinasergeeva

data/README.md

@@ -1,3 +1,92 @@
-# trellodon
+![Build](https://github.com/evilmartians/trellodon/workflows/Build/badge.svg)
+[![Gem Version](https://badge.fury.io/rb/trellodon.svg)](https://rubygems.org/gems/trellodon)
 
-Dump Trello boards to your file system
+# Trellodon
+
+A Ruby tool to export a Trello board and convert it into a set of folders and markdown files, corresponding to lists and cards on the board. For each card, you’ll get the basic details such as:
+
+* Name
+* Description
+* Labels
+* Comments
+* Attachments
+
+<img src="https://evilmartians.com/badges/sponsored-by-evil-martians.svg" alt="Sponsored by Evil Martians" width="236" height="54"></a>
+
+## Installation
+
+```
+gem install trellodon
+```
+
+## Prerequisites
+
+Trellodon needs two secret codes to download your boards:
+
+* Trello API key
+* Authentication token
+
+To generate them, go to the [trello.com/app-key](https://trello.com/app-key) page and follow the instructions.
+
+## Usage
+
+```sh
+Usage: trellodon dump [options]
+Options:
+        --board VALUE                Board URL or ID
+        --out VALUE                  Destination folder path
+        --concurrency VALUE          Amount of processing threads (default: 4). Set to 0 to execute API requests in-line
+        --clear-auth                 Remove saved api credentials
+    -v, --version                    Print current version
+    -h, --help                       Print help
+```
+
+### Detailed example
+
+Suppose we have a Trello board called `projects` with lists `Brainstorm`, `TODO`, `DOING`, `DONE`. Lists contains own cards.<br>
+All Trello boards have its own id this id requires Trellodon to fetch board via Trello API.
+You can find this id in two ways:
+
+* In URL `https://trello.com/b/{id}/projects` your Trello board id will be placed as `{id}` in example;
+* Put `.json` in your board URL like this `https://trello.com/b/{id}/projects.json` id field in json output is what you need;
+
+You can also paste whole board URL and Trellodon will parse it correctly.<br>
+After launch Trellodon creates follow output in specified folder:
+
+```sh
+projects/
+  Brainstorm/
+    first_card_title/
+       README.md
+       attachments/
+         image.png
+  TODO/
+    first_card_title/
+       README.md
+       attachments/
+         report.docx
+  ...
+```
+
+Each card has follow output format:
+
+```md
+---
+title: card_title
+last_updated_at: 2022-03-16 16:28:39 UTC
+labels: Test
+---
+
+# card_title
+
+## Description
+Some card description
+
+## Comments
+** John Doe @doe at 2022-03-16 16:28:39 UTC**
+
+## Attachments
+### Image.png
+**date**: 2022-03-16
+**url**: https://trello.com/1/cards/#{card_id}/attachments/#{attachment.id}/download/image.png
+```

data/lib/{trellodon/api_executor.rb → .rbnext/2.7/trellodon/executor.rb}

@@ -1,10 +1,7 @@
 # frozen_string_literal: true
 
-require "trellodon/api_client"
-require "trellodon/config"
-
 module Trellodon
-  class APIExecutor
+  class Executor
     BOARD_ID_REGEX = /\/b\/([^\/]+)\//
     private_constant :BOARD_ID_REGEX
 
@@ -16,7 +13,7 @@ module Trellodon
       @scheduler = scheduler
       check_credentials!
 
-      @api_client = APIClient.new(api_key: @api_key, api_token: @api_token)
+      @client = Client.new(api_key: @api_key, api_token: @api_token)
     end
 
     def download(board_pointer)
@@ -25,13 +22,13 @@ module Trellodon
       startup_time = Time.now
       logger.debug "Fetching board 🚀️️"
       board = scheduler.post do
-        api_client.fetch_board(board_id).tap { formatter.board_added(_1) }
+        client.fetch_board(board_id).tap { |_1| formatter.board_added(_1) }
       end.value
 
-      logger.debug "Fetching cards in board with comments and attachments 🐢"
+      logger.debug "Fetching #{board.card_ids.size} cards from the board with comments and attachments 🐢"
       board.card_ids.map do |card_id|
         scheduler.post do
-          api_client.fetch_card(card_id).tap { formatter.card_added(_1) }
+          client.fetch_card(card_id).tap { |_1| formatter.card_added(_1) }
         end
       end.map(&:value)
 
@@ -41,7 +38,7 @@ module Trellodon
 
     private
 
-    attr_reader :api_client, :board_id, :logger, :scheduler, :formatter
+    attr_reader :client, :board_id, :logger, :scheduler, :formatter
 
     def check_credentials!
       return if @api_key.to_s.size.positive? && @api_token.to_s.size.positive?

data/lib/.rbnext/3.0/trellodon/client.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+require "trello"
+require "trellodon/entities"
+
+module Trellodon
+  class Client
+    class DeletedMember < Struct.new(:id)
+      def full_name ;  "[DELETED]"; end
+
+      def username ;  "__deleted__"; end
+    end
+
+    def initialize(api_key:, api_token:, logger: Config.logger)
+      @logger = logger
+      @client = Trello::Client.new(
+        developer_public_key: api_key,
+        member_token: api_token
+      )
+      @members = {}
+    end
+
+    def fetch_board(board_id)
+      retrying do
+        board = @client.find(:boards, board_id)
+
+        Board.new(
+          id: board.id,
+          short_id: board.short_url.chars.last(8).join,
+          name: board.name,
+          lists: lists_from(board),
+          card_ids: @client.find_many(Trello::Card, "/boards/#{board_id}/cards", fields: "id").map(&:id),
+          last_activity_date: board.last_activity_date
+        )
+      end
+    end
+
+    def fetch_card(card_id)
+      retrying do
+        card = @client.find(:cards, card_id)
+
+        Card.new(
+          id: card.id,
+          short_id: card.short_url.chars.last(8).join,
+          name: card.name,
+          desc: card.desc,
+          labels: card.labels.map(&:name),
+          list_id: card.list_id,
+          comments: comments_from(card),
+          attachments: attachments_from(card),
+          checklists: checklists_from(card),
+          last_activity_date: card.last_activity_date
+        )
+      end
+    end
+
+    private
+
+    attr_reader :logger
+
+    def retrying(&block)
+      attempt = 0
+      begin
+        block.call
+      rescue Trello::Error => err
+        raise unless err.status_code == 429
+        attempt += 1
+        cooldown = 2**attempt + rand(2**attempt) - 2**(attempt - 1)
+        logger.warn "API limit exceeded, cool down for #{cooldown}s"
+        sleep cooldown
+        retry
+      end
+    end
+
+    def comments_from(card)
+      card.comments.map do |comment|
+        Comment.new(
+          text: comment.data["text"],
+          date: comment.date,
+          creator: member_from(comment)
+        )
+      end
+    end
+
+    def attachments_from(card)
+      card.attachments.map do |attach|
+        Attachment.new(
+          file_name: attach.file_name,
+          mime_type: attach.mime_type,
+          bytes: attach.bytes,
+          date: attach.date,
+          name: attach.name,
+          is_upload: attach.is_upload,
+          headers: attach.is_upload ? {"Authorization" => "OAuth oauth_consumer_key=\"#{@client.configuration.developer_public_key}\", oauth_token=\"#{@client.configuration.member_token}\""} : {},
+          url: attach.url
+        )
+      end
+    end
+
+    def lists_from(board)
+      board.lists.map do |list|
+        List.new(
+          id: list.id,
+          name: list.name,
+          short_id: board.short_url.chars.last(8).join
+        )
+      end
+    end
+
+    def checklists_from(card)
+      card.checklists.map do |checklist|
+        Checklist.new(
+          id: checklist.id,
+          name: checklist.name,
+          items: checklist_items_from(checklist)
+        )
+      end
+    end
+
+    def checklist_items_from(checklist)
+      checklist.items.map do |item|
+        ChecklistItem.new(
+          id: item.id,
+          name: item.name,
+          state: item.state
+        )
+      end
+    end
+
+    def member_from(comment)
+      return @members[comment.creator_id] if @members.has_key? comment.creator_id
+
+      member =
+        begin
+          @client.find(:members, comment.creator_id)
+        rescue Trello::Error => err
+          raise unless err.status_code == 404
+
+          DeletedMember.new(comment.creator_id)
+        end
+
+      @members[comment.creator_id] = Member.new(
+        id: member.id,
+        full_name: member.full_name,
+        username: member.username
+      )
+    end
+  end
+end

data/lib/.rbnext/3.1/trellodon/schedulers/concurrent.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "trellodon/schedulers/base"
+require "concurrent"
+
+module Trellodon
+  module Schedulers
+    class Concurrent < Base
+      using RubyNext
+
+      DEFAULT_MAX_THREADS = 4
+
+      attr_reader :max_threads
+
+      def initialize(threads_count = DEFAULT_MAX_THREADS)
+        @max_threads = threads_count
+      end
+
+      def post(&block)
+        ::Concurrent::Future.execute(executor: executor, &block)
+      end
+
+      private
+
+      def executor
+        ::Concurrent::FixedThreadPool.new(max_threads)
+      end
+    end
+  end
+end

data/lib/trellodon/cli.rb

@@ -1,36 +1,34 @@
 # frozen_string_literal: true
 
 require "trellodon"
-
 require "tty-prompt"
+require "fileutils"
 
 module Trellodon
   class CLI
-    class Prompt
-      def initialize
-        @prompt = TTY::Prompt.new
-      end
+    class Prompt < TTY::Prompt
+      include Singleton
 
       def ask_api_key
-        @prompt.mask(
+        mask(
           "Provide your Developer API Key (see https://trello.com/app-key):"
         ) { |q| q.required true }
       end
 
       def ask_api_token
-        @prompt.mask(
+        mask(
           "Provide your API token:"
         ) { |q| q.required true }
       end
 
       def ask_board
-        @prompt.ask("Which board would you like to dump? (URL or ID)") do |q|
+        ask("Which board would you like to dump? (URL or ID)") do |q|
           q.required true
         end
       end
 
       def ask_folder
-        @prompt.ask("Destination folder?", default: "./")
+        ask("Destination folder?", default: "./")
       end
     end
 
@@ -44,10 +42,15 @@ module Trellodon
         out: "Destination folder path"
       )
 
-      extend_options do |opts, _|
-        opts.banner = "Usage: trellodon dump\n"\
+      extend_options do |opts, config|
+        opts.banner = "Usage: trellodon dump \e[34m[options]\e[0m\n"\
                       "Options:\n"
 
+        opts.on("--concurrency VALUE", "Amount of processing threads (default: 4)")
+        opts.on("--clear-auth", "Remove saved api credentials") do
+          config.reload(api_token: nil, api_key: nil)
+        end
+
         opts.on_tail("-v", "--version", "Print current version") do
           puts Trellodon::VERSION
           exit
@@ -59,8 +62,25 @@ module Trellodon
         end
       end
 
+      def resolve_config_path(_, _)
+        config_path
+      end
+
+      def config_path
+        File.join(Dir.home, ".config", "#{config_name}.yml")
+      end
+
+      def update_config_file!
+        dir = File.dirname(config_path)
+        FileUtils.mkdir_p(dir) unless File.exist?(dir)
+
+        yml = "api_token: #{api_token}\n"\
+              "api_key: #{api_key}"
+        File.write(config_path, yml)
+      end
+
       private def prompt
-        @prompt ||= Prompt.new
+        Prompt.instance
       end
 
       def api_key
@@ -82,34 +102,65 @@ module Trellodon
 
     def initialize
       @config = Config.new
+      @scheduler = Schedulers::Inline.new
     end
 
     def run
       check_command!
 
-      executor = Trellodon::APIExecutor.new(
+      need_to_fill_config = config.to_h[:api_key].nil?
+
+      executor = Trellodon::Executor.new(
         api_key: config.api_key,
         api_token: config.api_token,
         formatter: Trellodon::Formatters::Markdown.new(output_dir: config.out),
-        scheduler: Schedulers::Threaded.new
+        scheduler: scheduler
       )
+
+      ask_save_credentials if need_to_fill_config
+
       executor.download(config.board)
     end
 
     private
 
-    attr_reader :config
+    attr_reader :config, :scheduler
+
+    def prompt
+      Prompt.instance
+    end
 
     def check_command!
-      command, = config.option_parser.permute!(ARGV)
+      params = {}
+      command, = config.option_parser.parse!(ARGV, into: params)
       unless command
         puts config.option_parser.help
         exit
       end
 
-      return if command == "dump"
+      if command == "dump"
+        change_scheduler(params) if params.key?(:sync) || params.key?(:concurrency)
+        return
+      end
 
       raise "Unknown command: #{command}. Available commands: dump"
     end
+
+    def ask_save_credentials
+      answer = prompt.yes?("Would you like to save api creds so next time trellodon won't asking it?", default: true)
+      config.update_config_file! if answer
+    end
+
+    def change_scheduler(params)
+      return unless params[:concurrency]
+
+      threads = Integer(params[:concurrency])
+
+      return @scheduler = Schedulers::Inline.new if threads.zero?
+
+      raise "Value of concurrency option must be integer and greater than zero" unless threads.positive?
+
+      @scheduler = Schedulers::Concurrent.new(threads)
+    end
   end
 end

data/lib/trellodon/{api_client.rb → client.rb}

@@ -1,17 +1,23 @@
 # frozen_string_literal: true
 
 require "trello"
-
 require "trellodon/entities"
 
 module Trellodon
-  class APIClient
+  class Client
+    class DeletedMember < Struct.new(:id)
+      def full_name = "[DELETED]"
+
+      def username = "__deleted__"
+    end
+
     def initialize(api_key:, api_token:, logger: Config.logger)
       @logger = logger
       @client = Trello::Client.new(
         developer_public_key: api_key,
         member_token: api_token
       )
+      @members = {}
     end
 
     def fetch_board(board_id)
@@ -42,6 +48,7 @@ module Trellodon
           list_id: card.list_id,
           comments: comments_from(card),
           attachments: attachments_from(card),
+          checklists: checklists_from(card),
           last_activity_date: card.last_activity_date
         )
       end
@@ -57,15 +64,10 @@ module Trellodon
         block.call
       rescue Trello::Error => err
         raise unless err.status_code == 429
-
         attempt += 1
-
         cooldown = 2**attempt + rand(2**attempt) - 2**(attempt - 1)
-
         logger.warn "API limit exceeded, cool down for #{cooldown}s"
-
         sleep cooldown
-
         retry
       end
     end
@@ -75,7 +77,7 @@ module Trellodon
         Comment.new(
           text: comment.data["text"],
           date: comment.date,
-          creator_id: comment.creator_id
+          creator: member_from(comment)
         )
       end
     end
@@ -86,6 +88,10 @@ module Trellodon
           file_name: attach.file_name,
           mime_type: attach.mime_type,
           bytes: attach.bytes,
+          date: attach.date,
+          name: attach.name,
+          is_upload: attach.is_upload,
+          headers: attach.is_upload ? {"Authorization" => "OAuth oauth_consumer_key=\"#{@client.configuration.developer_public_key}\", oauth_token=\"#{@client.configuration.member_token}\""} : {},
           url: attach.url
         )
       end
@@ -100,5 +106,44 @@ module Trellodon
         )
       end
     end
+
+    def checklists_from(card)
+      card.checklists.map do |checklist|
+        Checklist.new(
+          id: checklist.id,
+          name: checklist.name,
+          items: checklist_items_from(checklist)
+        )
+      end
+    end
+
+    def checklist_items_from(checklist)
+      checklist.items.map do |item|
+        ChecklistItem.new(
+          id: item.id,
+          name: item.name,
+          state: item.state
+        )
+      end
+    end
+
+    def member_from(comment)
+      return @members[comment.creator_id] if @members.has_key? comment.creator_id
+
+      member =
+        begin
+          @client.find(:members, comment.creator_id)
+        rescue Trello::Error => err
+          raise unless err.status_code == 404
+
+          DeletedMember.new(comment.creator_id)
+        end
+
+      @members[comment.creator_id] = Member.new(
+        id: member.id,
+        full_name: member.full_name,
+        username: member.username
+      )
+    end
   end
 end

data/lib/trellodon/entities/attachment.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Trellodon
-  Attachment = Struct.new("Attachment", :file_name, :mime_type, :bytes, :url, keyword_init: true)
+  Attachment = Struct.new("Attachment", :file_name, :mime_type, :bytes, :date, :name, :is_upload, :headers, :url, keyword_init: true)
 end

data/lib/trellodon/entities/card.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Trellodon
-  Card = Struct.new("Card", :id, :short_id, :name, :desc, :list_id, :labels, :comments, :attachments, :last_activity_date, keyword_init: true)
+  Card = Struct.new("Card", :id, :short_id, :name, :desc, :list_id, :labels, :comments, :attachments, :checklists, :last_activity_date, keyword_init: true)
 end

data/lib/trellodon/entities/checklist.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Trellodon
+  Checklist = Struct.new("Checklist", :id, :name, :items, keyword_init: true)
+end

data/lib/trellodon/entities/checklist_item.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Trellodon
+  ChecklistItem = Struct.new("ChecklistItem", :id, :name, :state, keyword_init: true) do
+    def checked?
+      state == "complete"
+    end
+  end
+end

data/lib/trellodon/entities/comment.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Trellodon
-  Comment = Struct.new("Comment", :text, :date, :creator_id, keyword_init: true)
+  Comment = Struct.new("Comment", :text, :date, :creator, keyword_init: true)
 end

data/lib/trellodon/entities/member.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Trellodon
+  Member = Struct.new("Member", :id, :full_name, :username, keyword_init: true)
+end

data/lib/trellodon/entities.rb

@@ -5,3 +5,6 @@ require "trellodon/entities/card"
 require "trellodon/entities/list"
 require "trellodon/entities/comment"
 require "trellodon/entities/attachment"
+require "trellodon/entities/checklist"
+require "trellodon/entities/checklist_item"
+require "trellodon/entities/member"

data/lib/trellodon/executor.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Trellodon
+  class Executor
+    BOARD_ID_REGEX = /\/b\/([^\/]+)\//
+    private_constant :BOARD_ID_REGEX
+
+    def initialize(api_key:, api_token:, scheduler:, formatter:, logger: Config.logger)
+      @api_key = api_key
+      @api_token = api_token
+      @formatter = formatter
+      @logger = logger
+      @scheduler = scheduler
+      check_credentials!
+
+      @client = Client.new(api_key: @api_key, api_token: @api_token)
+    end
+
+    def download(board_pointer)
+      extract_board_id(board_pointer)
+
+      startup_time = Time.now
+      logger.debug "Fetching board 🚀️️"
+      board = scheduler.post do
+        client.fetch_board(board_id).tap { formatter.board_added(_1) }
+      end.value
+
+      logger.debug "Fetching #{board.card_ids.size} cards from the board with comments and attachments 🐢"
+      board.card_ids.map do |card_id|
+        scheduler.post do
+          client.fetch_card(card_id).tap { formatter.card_added(_1) }
+        end
+      end.map(&:value)
+
+      formatter.finish
+      logger.debug "All Trello API requests finished in #{(Time.now - startup_time).to_i} seconds ⌛"
+    end
+
+    private
+
+    attr_reader :client, :board_id, :logger, :scheduler, :formatter
+
+    def check_credentials!
+      return if @api_key.to_s.size.positive? && @api_token.to_s.size.positive?
+
+      raise ArgumentError, "Missing credentials. Please fill out both api_key, api_token first."
+    end
+
+    def extract_board_id(board_pointer)
+      @board_id = if URI::DEFAULT_PARSER.make_regexp.match?(board_pointer)
+        parse_board_url(board_pointer)
+      else
+        board_pointer
+      end
+    end
+
+    def parse_board_url(board_url)
+      rel_path = URI.parse(board_url).request_uri
+      match_data = rel_path.match(BOARD_ID_REGEX)
+      raise ArgumentError, "Wrong trello board url" if match_data.nil? || match_data.size != 2
+
+      match_data[1]
+    end
+  end
+end

data/lib/trellodon/formatters/markdown.rb

@@ -9,13 +9,16 @@ module Trellodon
     class Markdown < Base
       attr_reader :output_dir
 
+      MD_FILENAME = "README.md"
+      ATTACHMENTS_DIRNAME = "attachments"
+
       def initialize(output_dir:, **opts)
         super(**opts)
         @output_dir = output_dir
       end
 
       def card_added(card)
-        card_mdfile = File.join(card_path(card), "index.md")
+        card_mdfile = File.join(card_path(card), MD_FILENAME)
         raise "File #{card_mdfile} already exists" if File.exist?(card_mdfile)
 
         File.write(card_mdfile, format_card(card))
@@ -29,7 +32,7 @@ module Trellodon
       private
 
       def card_path(card)
-        raise "Board is undefined" if @board.nil?
+        raise "Board is undefined" unless @board
         raise "List id is undefined" if card.list_id.nil? || card.list_id.empty?
         list = @board.get_list(card.list_id)
         raise "List #{card.list_id} is not found" if list.nil?
@@ -43,17 +46,16 @@ module Trellodon
       end
 
       def card_attachments_path(card)
-        attachments_dir = File.join(card_path(card), "attachments")
+        attachments_dir = File.join(card_path(card), ATTACHMENTS_DIRNAME)
         FileUtils.mkdir_p(attachments_dir) unless File.directory?(attachments_dir)
         attachments_dir
       end
 
       def download_attachments(card)
-        return # FIXME: 401 Unauthorized ???
-        return if card.attachments.nil? || card.attachments.empty? # rubocop:disable Lint/UnreachableCode
+        return if card.attachments.nil? || card.attachments.empty?
         attachments_path = card_attachments_path(card)
-        card.attachments.each do |att|
-          IO.copy_stream(URI.parse(att.url).open, File.join(attachments_path, att.file_name))
+        card.attachments.select(&:is_upload).each do |att|
+          IO.copy_stream(URI.parse(att.url).open(att.headers), File.join(attachments_path, att.file_name))
         end
       end
 
@@ -61,7 +63,9 @@ module Trellodon
         create_card_header(card) +
           create_card_title(card) +
           create_card_description(card) +
-          create_card_comments(card)
+          create_card_checklists(card) +
+          create_card_comments(card) +
+          create_card_attachments(card)
       end
 
       def create_card_header(card)
@@ -85,13 +89,35 @@ module Trellodon
         <<~EOS
 
           ## Description
+
           #{card.desc}
         EOS
       end
 
       def create_card_labels(card)
         return "" if card.labels.nil? || card.labels.empty?
-        card.labels.map { |label| "\n - " + label }.reduce(:+)
+        card.labels.map { |label| "\n - " + label }.join
+      end
+
+      def create_card_checklists(card)
+        return "" if card.checklists.nil? || card.checklists.empty?
+        <<~EOS
+
+          ## Checklists
+          #{card.checklists.map { |checklist| create_card_checklist(checklist) }.join}
+        EOS
+      end
+
+      def create_card_checklist(checklist)
+        <<~EOS
+
+          ### #{checklist.name}
+          #{checklist.items&.map { |item| create_card_checklist_item(item) }&.join}
+        EOS
+      end
+
+      def create_card_checklist_item(item)
+        "\n- [#{item.checked? ? "x" : " "}] #{item.name}"
       end
 
       def create_card_comments(card)
@@ -99,17 +125,42 @@ module Trellodon
         <<~EOS
 
           ## Comments
-          #{card.comments.map { |comment| create_card_comment(comment) }.reduce(:+)}
+          #{card.comments.map { |comment| create_card_comment(comment) }.join}
         EOS
       end
 
       def create_card_comment(comment)
         <<~EOS
 
-          **#{comment.creator_id} @ #{comment.date}**  
+          **#{comment.creator.full_name} (@#{comment.creator.username}) at #{comment.date}**  
           #{comment.text}
         EOS
       end
+
+      def create_card_attachments(card)
+        return "" if card.attachments.nil? || card.attachments.empty?
+        <<~EOS
+
+          ## Attachments
+          #{card.attachments.map { |attachment| create_card_attachment(attachment) }.join}
+        EOS
+      end
+
+      def create_card_attachment(attachment)
+        <<~EOS
+
+          ### #{attachment.name}
+
+          **date**: #{attachment.date}  
+          **url**: #{attachment.url}  
+          **local copy**: #{create_attachment_local_link(attachment)}
+        EOS
+      end
+
+      def create_attachment_local_link(attachment)
+        return "-" unless attachment.is_upload
+        "[#{attachment.file_name}](#{File.join("./", ATTACHMENTS_DIRNAME, attachment.file_name)})"
+      end
     end
   end
 end

data/lib/trellodon/schedulers/concurrent.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "trellodon/schedulers/base"
+require "concurrent"
+
+module Trellodon
+  module Schedulers
+    class Concurrent < Base
+      using RubyNext
+
+      DEFAULT_MAX_THREADS = 4
+
+      attr_reader :max_threads
+
+      def initialize(threads_count = DEFAULT_MAX_THREADS)
+        @max_threads = threads_count
+      end
+
+      def post(&block)
+        ::Concurrent::Future.execute(executor:, &block)
+      end
+
+      private
+
+      def executor
+        ::Concurrent::FixedThreadPool.new(max_threads)
+      end
+    end
+  end
+end

data/lib/trellodon/schedulers.rb

@@ -3,3 +3,4 @@
 require "trellodon/schedulers/base"
 require "trellodon/schedulers/inline"
 require "trellodon/schedulers/threaded"
+require "trellodon/schedulers/concurrent"

data/lib/trellodon/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Trellodon
-  VERSION = "0.1.0"
+  VERSION = "0.3.0"
 end

data/lib/trellodon.rb

@@ -1,8 +1,14 @@
 # frozen_string_literal: true
 
+require "ruby-next"
+
+require "ruby-next/language/setup"
+RubyNext::Language.setup_gem_load_path(transpile: true)
+
 require "trellodon/version"
 require "trellodon/config"
-require "trellodon/api_executor"
+require "trellodon/client"
+require "trellodon/executor"
 
 require "trellodon/entities"
 require "trellodon/schedulers"

metadata

@@ -1,15 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: trellodon
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - fargelus
 - rinasergeeva
+- palkan
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-04-08 00:00:00.000000000 Z
+date: 2022-04-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: anyway_config
@@ -53,12 +54,41 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ruby-next-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.15.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.15.0
 description: "\n    The main purpose of Trellodon is to make it possible to backup
   Trello boards to file system in a human-readable form (e.g., Markdown files).\n
   \ "
 email:
 - ddraudred@gmail.com
 - catherine.sergeeva@gmail.com
+- dementiev.vm@gmail.com
 executables:
 - trellodon
 extensions: []
@@ -70,22 +100,29 @@ files:
 - bin/console
 - bin/setup
 - bin/trellodon
+- lib/.rbnext/2.7/trellodon/executor.rb
+- lib/.rbnext/3.0/trellodon/client.rb
+- lib/.rbnext/3.1/trellodon/schedulers/concurrent.rb
 - lib/trellodon.rb
-- lib/trellodon/api_client.rb
-- lib/trellodon/api_executor.rb
 - lib/trellodon/cli.rb
+- lib/trellodon/client.rb
 - lib/trellodon/config.rb
 - lib/trellodon/entities.rb
 - lib/trellodon/entities/attachment.rb
 - lib/trellodon/entities/board.rb
 - lib/trellodon/entities/card.rb
+- lib/trellodon/entities/checklist.rb
+- lib/trellodon/entities/checklist_item.rb
 - lib/trellodon/entities/comment.rb
 - lib/trellodon/entities/list.rb
+- lib/trellodon/entities/member.rb
+- lib/trellodon/executor.rb
 - lib/trellodon/formatters.rb
 - lib/trellodon/formatters/base.rb
 - lib/trellodon/formatters/markdown.rb
 - lib/trellodon/schedulers.rb
 - lib/trellodon/schedulers/base.rb
+- lib/trellodon/schedulers/concurrent.rb
 - lib/trellodon/schedulers/inline.rb
 - lib/trellodon/schedulers/threaded.rb
 - lib/trellodon/version.rb