mrubyc-debugger 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7a7b82d4f4c99cd5427745effca6e826b876af4254f92fcfcb6fd4b709e9f796
+  data.tar.gz: 3ab9373b7fc3d800a98d6c464b0567d0ffd4767534c95a60a26d7cc6090e1648
+SHA512:
+  metadata.gz: 3689776d413b99e8283dc2cfab9aa217be888465ab5a3b318724fd3801636b87f4ca7ed8a93f64e9e45a68481b6dc266d2459855f5165294db9edf7b81177c0b
+  data.tar.gz: 7502349094bebaed003674d31be0633fc63edcbc1f4d3531446a98ade36691792aec2662e5698cfddeaa0dd2c40a6cf09392a6e537adedd9fdf55572c7064897

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,7 @@
+---
+sudo: false
+language: ruby
+cache: bundler
+rvm:
+  - 2.6.0
+before_install: gem install bundler -v 1.17.2

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at hitoshi.hasumi@monstar-lab.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in mrubyc-debugger.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,39 @@
+PATH
+  remote: .
+  specs:
+    mrubyc-debugger (0.1.0)
+      curses (~> 1.2)
+      thor (~> 0.20)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    curses (1.2.5)
+    diff-lcs (1.3)
+    rake (10.5.0)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.0)
+    thor (0.20.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 2.0)
+  mrubyc-debugger!
+  rake (~> 10.0)
+  rspec (~> 3.0)
+
+BUNDLED WITH
+   2.0.1

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 HASUMI Hitoshi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,92 @@
+# mrubyc-debugger
+
+mrubyc-debugger is a TUI (test user interface) for developing [mruby/c](https://github.com/mrubyc/mrubyc) application. It runs mruby/c loops as CRuby Threads on your terminal.
+
+'loop' is, in short, infinite loop like `while true; hoge(); end` .
+
+Caution: This gem is still experimental and not released yet.
+
+## Demo
+
+![demo](https://raw.githubusercontent.com/wiki/hasumikin/mrubyc-debugger/images/demo-2.gif)
+
+## Usage
+
+- h:←, j:↓, k:↑, l:→ move the cursor to select a line
+- SPACE toggles on and off of a breakpoint on the line which the cursor points
+
+## Features
+
+- TUI (text user interface) powered by [Curses](https://github.com/ruby/curses)
+- Visualize your loops, their local variables and debug printing of `puts`
+- Originally mrubyc-debugger was designed for the sake of mruby/c application. But you may be able to use it to see CRuby's multi threads program, especially for learning Thread class
+
+## Features in future (possibly)
+
+- Much more colorful. Like syntax highlighting
+- Cooperation with [mrubyc-test](https://github.com/hasumikin/mrubyc-test)
+  - Using stub and mock declarations in test cases to simulate an integrated circumstance
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'mrubyc-debugger'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install mrubyc-debugger
+
+## Usage
+
+Assuming you are using [mrubyc-utils](https://github.com/hasumikin/mrubyc-utils) to manage your project and [rbenv](https://github.com/rbenv/rbenv) to manage Ruby versions.
+This means you have `.mrubycconfig` file in your top directory of your project.
+
+Besides, you have to locate mruby loop files that are the target of debugging like `mrblib/loops/main.rb`
+
+This is an example of ESP32 project:
+
+```
+~/your_project $ tree
+.
+├── .mrubycconfig                # Created by mrubyc-utils
+├── Makefile
+├── build
+├── components
+├── main
+├── mrblib
+│      └── models
+│            ├── class_name.rb  # models are tested by mrubyc-test
+│            └── my_class.rb    # models are tested by mrubyc-test
+│      └── loops                # Place your loop files here
+│            ├── master.rb      # A loop something like awaiting for user input
+│            └── slave.rb       # Another loop eg) BLE status observation, LED blinking, etc.
+├── mrubyc-debugger.yml          # You can configure stub methods in form of YAML
+└── sdkconfig
+```
+
+At the top directory:
+
+    $ mrubyc-debugger
+
+To make your loops slow:
+
+    $ mrubyc-debugger --delay 1
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/hasumikin/mrubyc-debugger. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Mrubyc::Debugger project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/hasumikin/mrubyc-debugger/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "mrubyc/debugger"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/mrubyc-debugger

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'mrubyc/debugger'
+
+Mrubyc::Debugger::Bootstrap.start

data/lib/mrubyc/debugger.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require "mrubyc/debugger/version"
+require "mrubyc/debugger/config"
+require "mrubyc/debugger/mrblib"
+require "mrubyc/debugger/window"
+require "thor"
+require "yaml"
+require "logger"
+
+module Mrubyc
+  module Debugger
+    class Error < StandardError; end
+
+    class Bootstrap < Thor
+      default_command :start
+
+      desc 'start', 'start debug window'
+      option :delay, type: :numeric, default: 0.1,   banner: "Each of lines have a delay of this time (unit: second)"
+      option :debug, type: :boolean, default: false, banner: "Log appears at /tmp/mrubyc-debugger.log"
+      def start
+        result = Mrubyc::Debugger::Config.check
+        unless result
+          puts "\e[31;1m"
+          puts 'Error'
+          result[:messages].each do |message|
+            puts '  ' + message
+          end
+          puts "\e[0m"
+          exit(1)
+        end
+        mrblib_dir = if File.exists?('.mrubycconfig')
+          config = YAML.load_file('.mrubycconfig')
+          config['mruby_lib_dir']
+        else
+          ENV['GEM_ENV'] == 'test' ? 'spec/fixtures/files' : 'mrblib'
+        end
+        models = Dir.glob(File.join(Dir.pwd, mrblib_dir, "models", "*.rb"))
+        loops = Dir.glob(File.join(Dir.pwd, mrblib_dir, "loops", "*.rb"))
+        if loops.size == 0
+          puts "Exit as no loop found"
+          exit(1)
+        end
+       mrblibs = {
+          models: models,
+          loops: loops
+        }
+#        Mrubyc::Debugger::Mrblib.setup_models(mrblibs[:models])
+        yaml = File.join(Dir.pwd, "mrubyc-debugger.yml")
+        stubs = if File.exists?(yaml)
+          YAML.load_file(yaml)
+        else
+          {}
+        end
+        Mrubyc::Debugger::Window.setup_models(mrblibs[:models], stubs)
+        $logger = Logger.new("/tmp/mrubyc-debugger.log")
+        $logger.level = if options[:debug]
+          Logger::DEBUG
+        else
+          Logger::INFO
+        end
+        Mrubyc::Debugger::Window.start(mrblibs, options[:delay])
+      end
+    end
+  end
+end

data/lib/mrubyc/debugger/config.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Mrubyc
+  module Debugger
+    class Config
+      class << self
+        def check
+          true
+        end
+      end
+    end
+  end
+end

data/lib/mrubyc/debugger/console.rb

@@ -0,0 +1,375 @@
+# frozen_string_literal: true
+
+require 'curses'
+
+module Mrubyc
+  module Debugger
+    class Console
+
+      include Curses
+
+      COL_A = [
+        COLOR_BLACK,
+        COLOR_BLUE,
+        COLOR_CYAN,
+        COLOR_GREEN,
+        COLOR_MAGENTA,
+        COLOR_RED,
+        COLOR_WHITE,
+        COLOR_YELLOW
+      ]
+
+      ESCDELAY = 25
+
+      def initialize(loops)
+        @srcs = []
+        loops.each do |loop|
+          src = []
+          File.open(loop, 'r') do |f|
+            f.each_line do |line|
+              src << line
+            end
+          end
+          @srcs << src
+        end
+        cbreak # raw?
+        noecho # stop echo back
+        set_escdelay ESCDELAY # response speed. default 1000
+        @cursor_pos = { x: 0, y: 1}
+        @sleepers = Array.new(@srcs.size)
+        @events = Array.new(@srcs.size)
+      end
+
+      def set_escdelay(ms)
+        Curses.ESCDELAY = ms
+      rescue NotImplementedError
+      end
+
+      def make_pair
+        # 0 can't be changed
+        no = 0
+        COL_A.each do |c0|
+          COL_A.each do |c1|
+            init_pair(no, c0, c1)
+            no += 1
+          end
+        end
+      end
+
+      def col_sample
+        max = COL_A.size
+        no = 0
+        max.times do |y|
+          max.times do |x|
+            setpos(y, x * 6)
+            s = " %03d "%no
+            attron(color_pair(no))
+            addstr(s)
+            attroff(color_pair(no))
+            no += 1
+          end
+        end
+        s = "colors: %d"%(colors)
+        setpos(12, 0)
+        addstr(s)
+        s = "color_pairs: %d"%(color_pairs)
+        setpos(13, 0)
+        addstr(s)
+      end
+
+      def show_colors
+        col_sample
+        refresh
+        getch
+      end
+
+      def color_num_by(level)
+        case level
+        when :info
+          24
+        when :debug
+          32
+        when :warn
+          56
+        when :error
+          40
+        end
+      end
+
+      def run(show_colors_at_start = false)
+        mainwin = init_screen
+        mainwin.keypad true
+        mainwin.timeout = 0
+        curs_set(0)
+        start_color
+        make_pair
+        show_colors if show_colors_at_start
+
+        begin
+          wins = []
+          num = @srcs.size
+          num.times do |i|
+            win = {}
+            win[:src] = mainwin.subwin(lines - 6, cols / num, 0, i * cols / num)
+            win[:out] = mainwin.subwin(1, cols / num, lines - 6, i * cols / num)
+            win[:var] = mainwin.subwin(5, cols / num, lines - 5, i * cols / num)
+            wins << win
+          end
+          while true
+            @key = mainwin.getch
+            handle_key
+            num.times do |i|
+              wins[i][:src].resize(lines - 6, cols / num)
+              wins[i][:out].resize(1, cols / num)
+              wins[i][:var].resize(5, cols / num)
+              unless $sleep_queues[i].empty?
+                @sleepers[i] = $sleep_queues[i].pop
+              end
+              if @sleepers[i] && @sleepers[i] < Process.clock_gettime(Process::CLOCK_MONOTONIC_RAW, :millisecond)
+                @sleepers[i] = nil
+                $threads[i].run
+              end
+              unless $debug_queues[i].empty?
+                message = $debug_queues[i].pop
+                wins[i][:out].setpos(0, 0)
+                color_num = color_num_by(message[:level])
+                wins[i][:out].addstr '|'
+                wins[i][:out].attron(color_pair color_num)
+                wins[i][:out].addstr " #{message[:level].to_s[0].upcase}) " + message[:body].ljust(wins[i][:out].maxx-6)
+                wins[i][:out].attroff(color_pair color_num)
+                wins[i][:out].addstr '|'
+                wins[i][:out].refresh
+              end
+              unless $event_queues[i].empty?
+                @events[i] = $event_queues[i].pop
+              end
+              # needs this condition in spite of being used at the first time
+              # TODO refactor
+              if @events[i]
+                threads_debug_print(i)
+                (1..(wins[i][:src].maxy - 2)).each do |y|
+                  wins[i][:src].setpos(y, 1)
+                  if !@srcs[i][y]
+                    wins[i][:src].addstr ' ' * wins[i][:src].maxx
+                  else
+                    lineno = @events[i][:lineno] - 1 # hide `using DebugQueue` line
+                    wins[i][:src].attron(A_UNDERLINE) if y == @cursor_pos[:y] && i == @cursor_pos[:x]
+                    wins[i][:src].attron(A_REVERSE) if y == lineno
+                    lineno_color = if $breakpoints.any? {|bp| bp == [i, y] }
+                      21
+                    else
+                      16
+                    end
+                    wins[i][:src].attron(color_pair lineno_color)
+                    wins[i][:src].attron(A_BOLD)
+                    wins[i][:src].addstr y.to_s.rjust(2).to_s
+                    wins[i][:src].attroff(A_BOLD)
+                    wins[i][:src].attroff(color_pair lineno_color)
+                    wins[i][:src].addstr ' ' + @srcs[i][y]
+                    wins[i][:src].attroff(A_REVERSE) if y == lineno
+                    wins[i][:src].attroff(A_UNDERLINE) if y == @cursor_pos[:y] && i == @cursor_pos[:x]
+                  end
+                end
+                wins[i][:src].box(?|,?-,?+)
+                wins[i][:src].refresh
+                if @events[i][:breakpoint]
+                  command_line(i, wins[i][:var], @events[i][:tp_binding])
+                  @events[i][:breakpoint] = nil # to avoid #sleep line remains Thread.stop
+                else
+                  vars = {}
+                  @events[i][:tp_binding].local_variables.each do |var|
+                    vars[var] = @events[i][:tp_binding].local_variable_get(var).inspect
+                  end
+                  vars.each_with_index do |(k,v),j|
+                    wins[i][:var].setpos(j+1, 2)
+                    wins[i][:var].addstr (k.to_s + ' => ' + v).ljust(wins[i][:var].maxx)
+                  end
+                  box_var_win(wins[i][:var], 16)
+                end
+              end
+            end
+            refresh
+          end
+        rescue => e
+          sleep 5
+        ensure
+          finish
+        end
+      end
+
+    private
+
+      def clear_var_win(win)
+        (1..3).each do |l|
+          win.setpos(l, 1)
+          win << " " * (win.maxx - 2)
+        end
+      end
+
+      def box_var_win(win, color)
+        win.attron(color_pair color)
+        win.box(?|,?-,?+)
+        win.attroff(color_pair color)
+        win.refresh
+      end
+
+      def command_line(i, win, tp_binding)
+        box_var_win(win, 21)
+        loop do
+          clear_var_win(win)
+          win.setpos(1, 1)
+          win << " > "
+          win.refresh
+          str = getstr_with_echo(win)
+          case str
+          when "exit"
+            clear_var_win(win)
+            win.refresh
+            resume(i)
+            return
+          when ""
+            # do nothing
+          else
+            win.setpos(2, 2)
+            win << " => "
+            index = str.index("=")
+            args = if index
+              [ str[0, index - 1].strip,
+                str[index + 1, str.size - index].strip ]
+            else
+              str.strip
+            end
+            begin
+              result = if args.is_a?(Array)
+                tp_binding.local_variable_set(args[0], eval(args[1]))
+              else
+                if tp_binding.local_variables.map(&:to_s).include?(args)
+                  tp_binding.local_variable_get(args)
+                else
+                  eval(args)
+                end
+              end
+              win << result.to_s[0, win.maxx - 7]
+            rescue => e
+              win << e.to_s[0, win.maxx - 7]
+            end
+            win.setpos(3, 2)
+            win << "Enter to continue"
+            box_var_win(win, 21)
+            loop do
+              case getch
+              when nil
+                sleep ESCDELAY / 1000.0
+              when KEY_CTRL_J # Enter
+                break
+              end
+            end
+          end
+        end
+      end
+
+      def getstr_with_echo(win)
+        str = "".dup
+        loop do
+          case (c = Curses.getch)
+          when nil
+            # ignore
+          when KEY_CTRL_J # Enter
+            break if str.size > 0
+          when String
+            win << c
+            win.refresh
+            str << c
+          when KEY_BACKSPACE
+            if str.size > 0
+              win.setpos(1, str.size + 3)
+              win << " "
+              win.setpos(1, str.size + 3)
+              win.refresh
+              str.chop!
+            end
+          end
+        end
+        str
+      end
+
+      def handle_key
+        case @key
+        when 27 # ESC
+          exit(0)
+        when "h"
+          go_left
+        when "j"
+          go_down
+        when "k"
+          go_up
+        when "l"
+          go_right
+        when " "
+          breakpoint
+        end
+      end
+
+      def resume(i)
+        $threads[i].run if $threads[i].stop?
+      end
+
+      def breakpoint
+        unless $breakpoints.delete([@cursor_pos[:x], @cursor_pos[:y]])
+          $breakpoints << [@cursor_pos[:x], @cursor_pos[:y]]
+        end
+      end
+
+      def go_left
+        @cursor_pos[:x] -= 1
+        if @cursor_pos[:x] < 0
+          @cursor_pos[:x] = @srcs.size - 1
+        end
+        rescue_overflow
+      end
+
+      def go_right
+        @cursor_pos[:x] += 1
+        if @cursor_pos[:x] >= @srcs.size
+          @cursor_pos[:x] = 0
+        end
+        rescue_overflow
+      end
+
+      def rescue_overflow
+        if @cursor_pos[:y] >= @srcs[@cursor_pos[:x]].size
+          @cursor_pos[:y] = @srcs[@cursor_pos[:x]].size - 1
+        end
+      end
+
+      def go_down
+        @cursor_pos[:y] += 1
+        if @cursor_pos[:y] >= @srcs[@cursor_pos[:x]].size
+          @cursor_pos[:y] = 1
+        end
+      end
+
+      def go_up
+        @cursor_pos[:y] -= 1
+        if @cursor_pos[:y] == 0
+          @cursor_pos[:y] = @srcs[@cursor_pos[:x]].size - 1
+        end
+      end
+
+      def finish
+        close_screen
+        system "stty sane"
+        puts "finished"
+      end
+
+      def threads_debug_print(i)
+        $logger.debug @events[i].to_s if @events[i]
+        $logger.debug $breakpoints.to_s
+        $threads.each_with_index do |thread, index|
+          $logger.debug "thread #{index}: stop? => #{thread.stop?}"
+        end
+      end
+
+    end
+  end
+end

data/lib/mrubyc/debugger/ext/debug_queue.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module DebugQueue
+  refine Kernel do
+    def puts(text)
+      if $debug_queues
+        $debug_queues[Thread.current[:index]] << {
+          level: :debug,
+          body: text
+        }
+      end
+    end
+
+    def sleep(sec)
+      current_msec = Process.clock_gettime(Process::CLOCK_MONOTONIC_RAW, :millisecond)
+      $sleep_queues[Thread.current[:index]] << (current_msec + (sec * 1000)) # wakeup at
+      Thread.stop
+    end
+  end
+end

data/lib/mrubyc/debugger/ext/kernel.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Kernel
+  def relinquish
+    sleep 0.01
+  end
+end

data/lib/mrubyc/debugger/mrblib.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Mrubyc
+  module Debugger
+    class Mrblib
+      class << self
+      end
+    end
+  end
+end

data/lib/mrubyc/debugger/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Mrubyc
+  module Debugger
+    VERSION = "0.1.0"
+  end
+end

data/lib/mrubyc/debugger/window.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+require "mrubyc/debugger/ext/kernel"
+require "mrubyc/debugger/ext/debug_queue"
+require 'mrubyc/debugger/console.rb'
+require "tempfile"
+
+module Mrubyc
+  module Debugger
+    class Window
+      class << self
+        def start(mrblibs, delay)
+          loops = mrblibs[:loops]
+          $breakpoints = []
+          $debug_queues = []
+          $event_queues = []
+          $sleep_queues = []
+          loops.size.times do
+            $debug_queues << Queue.new
+            $event_queues << Queue.new
+            $sleep_queues << Queue.new
+          end
+          $threads = []
+          temp_loops = []
+          loops.each_with_index do |loop, index|
+            tempfile = Tempfile.new
+            temp_loops << tempfile.path
+            tempfile.puts "using DebugQueue; sleep 2"
+            tempfile.puts File.read(loop)
+            tempfile.close
+            $threads << Thread.new(index) do
+              Thread.current[:index] = index
+              load temp_loops[index]
+            end
+            $debug_queues[index] << {
+              level: :info,
+              body: "loop: #{File.basename(loop)} started"
+            }
+          end
+          $threads << Thread.new do
+            console = Mrubyc::Debugger::Console.new(temp_loops)
+            console.run
+          end
+          @@mutex = Mutex.new
+          trace(temp_loops, delay).enable do
+            $threads.each do|thr|
+              thr.join
+            end
+          end
+        end
+
+        def trace(loops, delay)
+          TracePoint.new(:c_call, :call, :line) do |tp|
+            number = nil
+            caller_locations(1, 1).each do |caller_location|
+              loops.each_with_index do |loop, index|
+                if caller_location.to_s.include?(File.basename(loop))
+                  number = index
+                  break
+                end
+              end
+              if number
+                @@mutex.lock
+                event = {
+                  method_id: tp.method_id,
+                  lineno: tp.lineno,
+                  caller_location: caller_location,
+                  tp_binding: tp.binding
+                }
+                # breakpoint will be duplicated if method_id is not nil (== event is not :line)
+                if tp.method_id.nil? && $breakpoints.any?{|bp| bp == [number, tp.lineno - 1]}
+                  event[:breakpoint] = true
+                end
+                $event_queues[number].push event
+                sleep delay if tp.event == :line
+                # should stop after push event and sleep
+                Thread.stop if event[:breakpoint] == true
+                @@mutex.unlock
+              end
+            end
+          end
+        end
+
+        def setup_models(models, stubs)
+          models.each do |model|
+            load model
+            class_name = File.basename(model, '.rb').split('_').map(&:capitalize).join
+            Kernel.const_get(class_name).class_eval do
+              if stubs["classes"] && stubs["classes"][class_name] && stubs["classes"][class_name]["instance_methods"]
+                stubs["classes"][class_name]["instance_methods"].each do |m|
+                  define_method(m["name"]) do
+                    eval m["value"]
+                  end
+                end
+              end
+              def method_missing(method_name, *args)
+                if $debug_queues
+                  $debug_queues[Thread.current[:index]] << {
+                    level: :error,
+                    body: "method_missing: #{self.class}##{method_name}"
+                  }
+                else
+                  super
+                end
+              end
+            end
+          end
+        end
+
+      end
+    end
+  end
+end

data/mrubyc-debugger.gemspec

@@ -0,0 +1,32 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "mrubyc/debugger/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "mrubyc-debugger"
+  spec.version       = Mrubyc::Debugger::VERSION
+  spec.authors       = ["HASUMI Hitoshi"]
+  spec.email         = ["hasumikin@gmail.com"]
+
+  spec.summary       = %q{Debugger for mruby/c mutli tasks (threads)}
+  spec.description   = %q{mrubyc-debugger is a TUI (text user interface) tool that runs mruby/c tasks as CRuby ::Thread on your terminal}
+  spec.homepage      = "https://github.com/hasumikin/mrubyc-debugger"
+  spec.license       = "MIT"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 2.0"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+
+  spec.add_dependency "curses", "~> 1.2"
+  spec.add_dependency "thor", "~> 0.20"
+end

data/sample/.mrubycconfig

@@ -0,0 +1,2 @@
+---
+mruby_lib_dir: mrblib

data/sample/.ruby-version

@@ -0,0 +1 @@
+2.6.2

data/sample/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gem "mrubyc-debugger"

data/sample/README.md

@@ -0,0 +1,7 @@
+## How to start sample
+
+- cd [into/this/dir]
+- bundle install
+- bundle exec mrubyc-debugger
+- That's it!
+

data/sample/mrblib/loops/master.rb

@@ -0,0 +1,18 @@
+$my_obj = MyClass.new
+local_var = 0
+
+$mutex = Mutex.new
+
+while true
+  $mutex.lock()
+  puts "LOCKED"
+  sleep 3
+  $mutex.unlock()
+  if local_var > 100
+    puts $my_obj.alert
+    sleep 2
+  end
+  sleep 2
+  local_var += 1
+end
+

data/sample/mrblib/loops/slave.rb

@@ -0,0 +1,17 @@
+while !$mutex
+  relinquish()
+end
+
+while true
+  sleep 1
+  puts "trying to LOCK"
+  $mutex.lock()
+  $my_obj.still_not_defined_method
+  sleep 2
+  local_var = $my_obj.stub_method
+  sleep 2
+  puts "local_var: #{local_var}"
+  $mutex.unlock()
+  sleep 2
+end
+

data/sample/mrblib/models/my_class.rb

@@ -0,0 +1,6 @@
+class MyClass
+  attr_accessor :result
+  def alert
+    "LOOP count is over one hundred!"
+  end
+end

data/sample/mrubyc-debugger.yml

@@ -0,0 +1,6 @@
+classes:
+  MyClass:
+    instance_methods:
+      - name:  stub_method
+        value: rand(100)
+

metadata

@@ -0,0 +1,144 @@
+--- !ruby/object:Gem::Specification
+name: mrubyc-debugger
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- HASUMI Hitoshi
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2019-04-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: curses
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.20'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.20'
+description: mrubyc-debugger is a TUI (text user interface) tool that runs mruby/c
+  tasks as CRuby ::Thread on your terminal
+email:
+- hasumikin@gmail.com
+executables:
+- mrubyc-debugger
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- exe/mrubyc-debugger
+- lib/mrubyc/debugger.rb
+- lib/mrubyc/debugger/config.rb
+- lib/mrubyc/debugger/console.rb
+- lib/mrubyc/debugger/ext/debug_queue.rb
+- lib/mrubyc/debugger/ext/kernel.rb
+- lib/mrubyc/debugger/mrblib.rb
+- lib/mrubyc/debugger/version.rb
+- lib/mrubyc/debugger/window.rb
+- mrubyc-debugger.gemspec
+- sample/.mrubycconfig
+- sample/.ruby-version
+- sample/Gemfile
+- sample/README.md
+- sample/mrblib/loops/master.rb
+- sample/mrblib/loops/slave.rb
+- sample/mrblib/models/my_class.rb
+- sample/mrubyc-debugger.yml
+homepage: https://github.com/hasumikin/mrubyc-debugger
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.1
+signing_key: 
+specification_version: 4
+summary: Debugger for mruby/c mutli tasks (threads)
+test_files: []