From 28eee064e5c7256ef98f290628f81032b681fb2d Mon Sep 17 00:00:00 2001
From: Paul Barton <pablo.barton@gmail.com>
Date: Sat, 24 May 2014 00:50:35 -0400
Subject: [PATCH] Adding filetranscriber to examples

---
 examples/filetranscriber.py | 77 +++++++++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100644 examples/filetranscriber.py

diff --git a/examples/filetranscriber.py b/examples/filetranscriber.py
new file mode 100644
index 0000000..fcf6ed0
--- /dev/null
+++ b/examples/filetranscriber.py
@@ -0,0 +1,77 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+FileTranscriber
+
+A small utility that simulates user typing to aid plaintext file transcription
+in limited environments
+
+Usage:
+  transcribe <file> [--interval=<time>] [--pause=<time>]
+  transcribe (--help | --version)
+
+Options:
+  -v --version          show program's version number and exit
+  -h --help             show this help message and exit
+  -i --interval=<time>  Interval between keystrokes (in seconds). Typing too
+                        quickly may break applications processing the
+                        keystrokes. [default: 0.1]
+  -p --pause=<time>     How long the script should wait before starting (in
+                        seconds). Increase this if you need more time to enter
+                        the typing field. [default: 5]
+"""
+
+#This script copied from https://github.com/SavinaRoja/FileTranscriber
+#Check there for updates
+
+from docopt import docopt
+from pykeyboard import PyKeyboard
+from pymouse import PyMouseEvent
+import time
+import sys
+
+
+#Hack to make input work for both Python 2 and Python 3
+try:
+    input = raw_input
+except NameError:
+    pass
+
+
+class AbortMouse(PyMouseEvent):
+    def click(self, x, y, button, press):
+        if press:
+            self.stop()
+
+
+def main():
+    #Get an instance of PyKeyboard, and our custom PyMouseEvent
+    keyboard = PyKeyboard()
+    mouse = AbortMouse()
+
+    input('Press Enter when ready.')
+    print('Typing will begin in {0} seconds...'.format(opts['--pause']))
+    time.sleep(opts['--pause'])
+
+    mouse.start()
+    with open(opts['<file>'], 'r') as readfile:
+        for line in readfile:
+            if not mouse.state:
+                print('Typing aborted!')
+                break
+            keyboard.type_string(line, opts['--interval'])
+
+if __name__ == '__main__':
+    opts = docopt(__doc__, version='0.2.1')
+    try:
+        opts['--interval'] = float(opts['--interval'])
+    except ValueError:
+        print('The value of --interval must be a number')
+        sys.exit(1)
+    try:
+        opts['--pause'] = float(opts['--pause'])
+    except ValueError:
+        print('The value of --pause must be a number')
+        sys.exit(1)
+    main()
\ No newline at end of file