Android light sensor

README.rst

@@ -28,14 +28,15 @@ GPS                                X       X
 Gravity                            X
 IR Blaster                         X
 Notifications                      X           X       X    X
-Text to speech                     X       X   X       X    X
+Text to speech 	                   X 	     X 	 X 	     X 	  X
 Email (open mail client)           X       X   X       X    X
-Vibrator                           X       X
-Sms (send messages)                X       X
+Vibrator 	                         X 	     X
+Sms (send messages) 	             X 	     X
 Compass                            X       X
-Unique ID                          X       X   X       X    X
+Unique ID 	                       X 	     X 	 X 	     X 	  X
 Gyroscope                          X       X
-Battery                            X       X   X       X    X
+Light                              X
+Battery 	                         X  	   X 	 X 	     X 	  X
 Native file chooser                            X       X    X
 Orientation                        X
 Proximity                          X

examples/light/buildozer.spec

@@ -0,0 +1,233 @@
+[app]
+
+# (str) Title of your application
+title = Plyer Light Example
+
+# (str) Package name
+package.name = plyerlight
+
+# (str) Package domain (needed for android/ios packaging)
+package.domain = org.test
+
+# (str) Source code where the main.py live
+source.dir = .
+
+# (list) Source files to include (let empty to include all the files)
+source.include_exts = py,png,jpg,kv,atlas
+
+# (list) List of inclusions using pattern matching
+#source.include_patterns = assets/*,images/*.png
+
+# (list) Source files to exclude (let empty to not exclude anything)
+#source.exclude_exts = spec
+
+# (list) List of directory to exclude (let empty to not exclude anything)
+#source.exclude_dirs = tests, bin
+
+# (list) List of exclusions using pattern matching
+#source.exclude_patterns = license,images/*/*.jpg
+
+# (str) Application versioning (method 1)
+version = 0.1
+
+# (str) Application versioning (method 2)
+# version.regex = __version__ = ['"](.*)['"]
+# version.filename = %(source.dir)s/main.py
+
+# (list) Application requirements
+# comma seperated e.g. requirements = sqlite3,kivy
+requirements = kivy,plyer
+
+# (str) Custom source folders for requirements
+# Sets custom source for any requirements with recipes
+# requirements.source.kivy = ../../kivy
+
+# (list) Garden requirements
+#garden_requirements =
+
+# (str) Presplash of the application
+#presplash.filename = %(source.dir)s/data/presplash.png
+
+# (str) Icon of the application
+#icon.filename = %(source.dir)s/data/icon.png
+
+# (str) Supported orientation (one of landscape, portrait or all)
+orientation = portrait
+
+# (list) List of service to declare
+#services = NAME:ENTRYPOINT_TO_PY,NAME2:ENTRYPOINT2_TO_PY
+
+#
+# OSX Specific
+#
+
+#
+# author = © Copyright Info
+
+#
+# Android specific
+#
+
+# (bool) Indicate if the application should be fullscreen or not
+fullscreen = 0
+
+# (list) Permissions
+#android.permissions = INTERNET
+
+# (int) Android API to use
+#android.api = 19
+
+# (int) Minimum API required
+#android.minapi = 9
+
+# (int) Android SDK version to use
+#android.sdk = 20
+
+# (str) Android NDK version to use
+#android.ndk = 9c
+
+# (bool) Use --private data storage (True) or --dir public storage (False)
+#android.private_storage = True
+
+# (str) Android NDK directory (if empty, it will be automatically downloaded.)
+#android.ndk_path =
+
+# (str) Android SDK directory (if empty, it will be automatically downloaded.)
+#android.sdk_path =
+
+# (str) ANT directory (if empty, it will be automatically downloaded.)
+#android.ant_path =
+
+# (str) python-for-android git clone directory (if empty, it will be automatically cloned from github)
+#android.p4a_dir =
+
+# (str) The directory in which python-for-android should look for your own build recipes (if any)
+#p4a.local_recipes = 
+
+# (list) python-for-android whitelist
+#android.p4a_whitelist =
+
+# (bool) If True, then skip trying to update the Android sdk
+# This can be useful to avoid excess Internet downloads or save time
+# when an update is due and you just want to test/build your package
+# android.skip_update = False
+
+# (str) Bootstrap to use for android builds (android_new only)
+# android.bootstrap = sdl2
+
+# (str) Android entry point, default is ok for Kivy-based app
+#android.entrypoint = org.renpy.android.PythonActivity
+
+# (list) List of Java .jar files to add to the libs so that pyjnius can access
+# their classes. Don't add jars that you do not need, since extra jars can slow
+# down the build process. Allows wildcards matching, for example:
+# OUYA-ODK/libs/*.jar
+#android.add_jars = foo.jar,bar.jar,path/to/more/*.jar
+
+# (list) List of Java files to add to the android project (can be java or a
+# directory containing the files)
+#android.add_src =
+
+# (str) python-for-android branch to use, if not master, useful to try
+# not yet merged features.
+#android.branch = master
+
+# (str) OUYA Console category. Should be one of GAME or APP
+# If you leave this blank, OUYA support will not be enabled
+#android.ouya.category = GAME
+
+# (str) Filename of OUYA Console icon. It must be a 732x412 png image.
+#android.ouya.icon.filename = %(source.dir)s/data/ouya_icon.png
+
+# (str) XML file to include as an intent filters in <activity> tag
+#android.manifest.intent_filters =
+
+# (list) Android additionnal libraries to copy into libs/armeabi
+#android.add_libs_armeabi = libs/android/*.so
+#android.add_libs_armeabi_v7a = libs/android-v7/*.so
+#android.add_libs_x86 = libs/android-x86/*.so
+#android.add_libs_mips = libs/android-mips/*.so
+
+# (bool) Indicate whether the screen should stay on
+# Don't forget to add the WAKE_LOCK permission if you set this to True
+#android.wakelock = False
+
+# (list) Android application meta-data to set (key=value format)
+#android.meta_data =
+
+# (list) Android library project to add (will be added in the
+# project.properties automatically.)
+#android.library_references =
+
+# (str) Android logcat filters to use
+#android.logcat_filters = *:S python:D
+
+# (bool) Copy library instead of making a libpymodules.so
+#android.copy_libs = 1
+
+#
+# iOS specific
+#
+
+# (str) Path to a custom kivy-ios folder
+#ios.kivy_ios_dir = ../kivy-ios
+
+# (str) Name of the certificate to use for signing the debug version
+# Get a list of available identities: buildozer ios list_identities
+#ios.codesign.debug = "iPhone Developer: <lastname> <firstname> (<hexstring>)"
+
+# (str) Name of the certificate to use for signing the release version
+#ios.codesign.release = %(ios.codesign.debug)s
+
+
+[buildozer]
+
+# (int) Log level (0 = error only, 1 = info, 2 = debug (with command output))
+log_level = 2
+
+# (int) Display warning if buildozer is run as root (0 = False, 1 = True)
+warn_on_root = 1
+
+# (str) Path to build artifact storage, absolute or relative to spec file
+# build_dir = ./.buildozer
+
+# (str) Path to build output (i.e. .apk, .ipa) storage
+# bin_dir = ./bin
+
+#    -----------------------------------------------------------------------------
+#    List as sections
+#
+#    You can define all the "list" as [section:key].
+#    Each line will be considered as a option to the list.
+#    Let's take [app] / source.exclude_patterns.
+#    Instead of doing:
+#
+#[app]
+#source.exclude_patterns = license,data/audio/*.wav,data/images/original/*
+#
+#    This can be translated into:
+#
+#[app:source.exclude_patterns]
+#license
+#data/audio/*.wav
+#data/images/original/*
+#
+
+
+#    -----------------------------------------------------------------------------
+#    Profiles
+#
+#    You can extend section / key with a profile
+#    For example, you want to deploy a demo version of your application without
+#    HD content. You could first change the title to add "(demo)" in the name
+#    and extend the excluded directories to remove the HD content.
+#
+#[app@demo]
+#title = My Application (demo)
+#
+#[app:source.exclude_patterns@demo]
+#images/hd/*
+#
+#    Then, invoke the command line with the "demo" profile:
+#
+#buildozer --profile demo android debug

examples/light/main.py

@@ -0,0 +1,71 @@
+from kivy.app import App
+from kivy.clock import Clock
+from kivy.lang import Builder
+from kivy.properties import NumericProperty
+from kivy.properties import ObjectProperty
+from kivy.uix.boxlayout import BoxLayout
+
+
+Builder.load_string('''
+#:import light plyer.light
+<LightInterface>:
+    light: light
+    orientation: 'vertical'
+    padding: '50dp'
+    spacing: '50dp'
+
+    BoxLayout:
+        orientation: 'horizontal'
+        size_hint_y: 0.3
+        Button:
+            id: button_enable
+            text: 'Enable'
+            disabled: False
+            on_release:
+                root.enable()
+                button_disable.disabled = not button_disable.disabled
+                button_enable.disabled = not button_enable.disabled
+        Button:
+            id: button_disable
+            text: 'Disable'
+            disabled: True
+            on_release:
+                root.disable()
+                button_disable.disabled = not button_disable.disabled
+                button_enable.disabled = not button_enable.disabled
+
+    Label:
+        text: 'Current illumination:' + str(root.illumination) + ' lx.'
+
+
+''')
+
+
+class LightInterface(BoxLayout):
+    '''Root Widget.'''
+
+    light = ObjectProperty()
+    illumination = NumericProperty()
+
+    def enable(self):
+        self.light.enable()
+        Clock.schedule_interval(self.get_illumination, 1 / 20.)
+
+    def disable(self):
+        self.light.disable()
+        Clock.unschedule(self.get_illumination)
+
+    def get_illumination(self, dt):
+        self.illumination = self.light.illumination or self.illumination
+
+
+class LightApp(App):
+
+    def build(self):
+        return LightInterface()
+
+    def on_pause(self):
+        return True
+
+if __name__ == '__main__':
+    LightApp().run()

plyer/__init__.py

@@ -6,8 +6,8 @@
 
 __all__ = ('accelerometer', 'audio', 'barometer', 'battery', 'call', 'camera',
            'compass', 'email', 'filechooser', 'flash', 'gps', 'gravity',
-           'gyroscope', 'irblaster', 'orientation', 'notification', 'proximity',
-           'sms', 'tts', 'uniqueid', 'vibrator', 'wifi')
+           'gyroscope', 'irblaster', 'light', 'orientation', 'notification',
+           'proximity', 'sms', 'tts', 'uniqueid', 'vibrator', 'wifi')
 
 __version__ = '1.2.5dev'
 
@@ -54,6 +54,9 @@
 #: IrBlaster proxy to :class:`plyer.facades.IrBlaster`
 irblaster = Proxy('irblaster', facades.IrBlaster)
 
+#: Light proxy to :class:`plyer.facades.Light`
+light = Proxy('light', facades.Light)
+
 #: Orientation proxy to :class:`plyer.facades.Orientation`
 orientation = Proxy('orientation', facades.Orientation)
 

plyer/facades/__init__.py

@@ -8,8 +8,8 @@
 
 __all__ = ('Accelerometer', 'Audio', 'Barometer', 'Battery', 'Call', 'Camera',
            'Compass', 'Email', 'FileChooser', 'GPS', 'Gravity', 'Gyroscope',
-           'IrBlaster', 'Orientation', 'Notification', 'Proximity', 'Sms',
-           'TTS', 'UniqueID', 'Vibrator', 'Wifi', 'Flash')
+           'IrBlaster', 'Light', 'Orientation', 'Notification', 'Proximity',
+           'Sms', 'TTS', 'UniqueID', 'Vibrator', 'Wifi', 'Flash')
 
 from plyer.facades.accelerometer import Accelerometer
 from plyer.facades.audio import Audio
@@ -20,16 +20,17 @@
 from plyer.facades.compass import Compass
 from plyer.facades.email import Email
 from plyer.facades.filechooser import FileChooser
+from plyer.facades.flash import Flash
 from plyer.facades.gps import GPS
 from plyer.facades.gravity import Gravity
 from plyer.facades.gyroscope import Gyroscope
 from plyer.facades.irblaster import IrBlaster
+from plyer.facades.light import Light
 from plyer.facades.proximity import Proximity
 from plyer.facades.orientation import Orientation
 from plyer.facades.notification import Notification
 from plyer.facades.sms import Sms
 from plyer.facades.tts import TTS
 from plyer.facades.uniqueid import UniqueID
 from plyer.facades.vibrator import Vibrator
-from plyer.facades.flash import Flash
 from plyer.facades.wifi import Wifi