add finger print (#252)

* add fingre print

* apply auto format

Author: KazuCocoa

appium/webdriver/mobilecommand.py

@@ -73,3 +73,4 @@ class MobileCommand(object):
     SET_CLIPBOARD = 'setClipboard'
     GET_CLIPBOARD = 'getClipboard'
     COMPARE_IMAGES = 'compareImages'
+    FINGER_PRINT = 'fingerPrint'

appium/webdriver/webdriver.py

@@ -1387,6 +1387,14 @@ def battery_info(self):
         """
         return self.execute_script('mobile: batteryInfo')
 
+    def finger_print(self, finger_id):
+        """
+        Authenticate users by using their finger print scans on supported emulators.
+
+        :param finger_id: Finger prints stored in Android Keystore system (from 1 to 10)
+        """
+        return self.execute(Command.FINGER_PRINT, {'fingerprintId': finger_id})['value']
+
     # pylint: disable=protected-access
 
     def _addCommands(self):
@@ -1505,3 +1513,5 @@ def _addCommands(self):
             ('POST', '/session/$sessionId/appium/device/get_clipboard')
         self.command_executor._commands[Command.COMPARE_IMAGES] = \
             ('POST', '/session/$sessionId/appium/compare_images')
+        self.command_executor._commands[Command.FINGER_PRINT] = \
+            ('POST', '/session/$sessionId/appium/device/finger_print')

test/functional/android/finger_print_tests.py

@@ -0,0 +1,37 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+from appium import webdriver
+import desired_capabilities
+
+
+class FingerPrintTests(unittest.TestCase):
+    def setUp(self):
+        desired_caps = desired_capabilities.get_desired_capabilities('ApiDemos-debug.apk')
+        self.driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
+
+    def tearDown(self):
+        self.driver.quit()
+
+    def test_finger_print(self):
+        result = self.driver.finger_print(1)
+        self.assertEqual(None, result)
+
+
+if __name__ == "__main__":
+    suite = unittest.TestLoader().loadTestsFromTestCase(FingerPrintTests)
+    unittest.TextTestRunner(verbosity=2).run(suite)