summaryrefslogtreecommitdiff
path: root/lib/lua-repl/repl/sync.lua
diff options
context:
space:
mode:
Diffstat (limited to 'lib/lua-repl/repl/sync.lua')
-rw-r--r--lib/lua-repl/repl/sync.lua46
1 files changed, 46 insertions, 0 deletions
diff --git a/lib/lua-repl/repl/sync.lua b/lib/lua-repl/repl/sync.lua
new file mode 100644
index 00000000..a422ed4b
--- /dev/null
+++ b/lib/lua-repl/repl/sync.lua
@@ -0,0 +1,46 @@
+-- Copyright (c) 2011-2015 Rob Hoelz <rob@hoelz.ro>
+--
+-- 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.
+
+local repl = require 'repl'
+local sync_repl = repl:clone()
+local error = error
+
+-- @class repl.sync
+--- This module implements a synchronous REPL. It provides
+--- a run() method for actually running the REPL, and requires
+--- that implementors implement the lines() method.
+
+--- Run a REPL loop in a synchronous fashion.
+-- @name repl.sync:run
+function sync_repl:run()
+ self:prompt(1)
+ for line in self:lines() do
+ local level = self:handleline(line)
+ self:prompt(level)
+ end
+ self:shutdown()
+end
+
+--- Returns an iterator that yields lines to be evaluated.
+-- @name repl.sync:lines
+-- @return An iterator.
+function sync_repl:lines()
+ error 'You must implement the lines method'
+end
+
+return sync_repl