Merge pull request #44 from metaltoad/getScreenshotFeature

Implements saveScreenshot helper method in MinkContext

src/Behat/MinkExtension/Context/MinkContext.php

@@ -472,4 +472,21 @@ class MinkContext extends RawMinkContext implements TranslatedContextInterface
     {
         return str_replace('\\"', '"', $argument);
     }
+    
+    /**
+     * Save a screenshot of the current window to the file system.
+     *
+     * @param  string  $filename Desired filename, defaults to 
+     *   <browser_name>_<ISO 8601 date>_<randomId>.png
+     * @param  string  $filepath Desired filepath, defaults to 
+     *   upload_tmp_dir, falls back to sys_get_temp_dir()
+     */
+    public function saveScreenshot($filename = null, $filepath = null)
+    {
+        // Under Cygwin, uniqid with more_entropy must be set to true. 
+        // No effect in other environments.
+        $filename = $filename ?: sprintf('%s_%s_%s.%s', $this->getMinkParameter('browser_name'), date('c'), uniqid('', true), 'png');
+        $filepath = $filepath ? $filepath : ini_get('upload_tmp_dir') ? ini_get('upload_tmp_dir') : sys_get_temp_dir();
+        file_put_contents($filepath . '/' . $filename, $this->getSession()->getScreenshot());
+    }    
 }