AndroidsSystemFileChooser 0.0.3__py3-none-any.whl

AndroidsSystemFileChooser-0.0.3.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mathias Lindström
+
+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.

AndroidsSystemFileChooser-0.0.3.dist-info/METADATA

@@ -0,0 +1,89 @@
+Metadata-Version: 2.2
+Name: AndroidsSystemFileChooser
+Version: 0.0.3
+Summary: Android's SystemFileChooser with Kivy
+Home-page: https://github.com/kuzeyron/AndroidsSystemFileChooser
+Author: Mathias Lindström
+License: LICENSE
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+Android's SystemFileChooser with Kivy
+=====================================
+
+*A tool that uses Android's SystemFileChooser to process materials with the set of tools from Kivy.*
+
+
+### Buildozer
+To include these tools with Buildozer just include `androidssystemfilechooser` in the requirements.
+
+
+### API
+For now it's better if you just read the source/code.  
+`JavaStream(input_stream)`  
+`SystemFileChooser(mime_type, multiple)`  
+`uri_to_extension(uri)`  
+`uri_to_filename(uri)`  
+`uri_to_stream(uri)`  
+`uri_image_to_texture(uri)`  
+
+
+### Permissions and Runtime-permissions
+You don't have to state anything.
+
+
+### Example code of use
+```
+from androidssystemfilechooser import (SystemFileChooser,
+                                       uri_image_to_texture,
+                                       uri_to_extension,
+                                       uri_to_stream)
+from kivy.app import App
+from kivy.core.image import Image as CoreImage
+from kivy.lang import Builder
+from kivy.properties import StringProperty
+from kivy.uix.button import Button
+from kivy.uix.image import Image
+
+KV = '''
+BoxLayout:
+    orientation: 'vertical'
+
+    MyTriggerButton:
+        multiple: True
+        text: 'Choose and execute results!'
+        on_release: self.trigger()
+'''
+
+
+class MyTriggerButton(SystemFileChooser, Button):
+    mime_type = StringProperty('image/*')
+
+    def on_uris(self, instance, uris):
+        for nr, uri in enumerate(uris):
+            if nr % 2 == 0:
+                with uri_to_stream(uri) as stream:
+                    image = CoreImage(stream, ext=uri_to_extension(uri))
+                texture = image.texture
+            else:
+                texture = uri_image_to_texture(uri)
+            instance.parent.add_widget(Image(texture=texture))
+        self.uris = []
+
+
+class MyApp(App):
+    def build(self):
+        return Builder.load_string(KV)
+
+
+if __name__ == '__main__':
+    MyApp().run()
+```
+
+
+### License
+MIT-Licensed.

AndroidsSystemFileChooser-0.0.3.dist-info/RECORD

@@ -0,0 +1,8 @@
+androidssystemfilechooser/__init__.py,sha256=NR9xF-XcS-mdKCebW-oG_s7uPVpWAj1MrkkDYBHV66I,344
+androidssystemfilechooser/chooser.py,sha256=MLsgpYGbb9_h9Z-5caX9-KtWiuivSJczZ2c8NPlgPrc,1943
+androidssystemfilechooser/utils.py,sha256=klxOicT6VBlOa1d9twCtfZ4TB3k7cYlqHmwOz4KV4Oc,3084
+AndroidsSystemFileChooser-0.0.3.dist-info/LICENSE,sha256=vO7WrAPOsEI6XC5xa8tBeX6ruTWMbrwffDdvp3ls0mo,1075
+AndroidsSystemFileChooser-0.0.3.dist-info/METADATA,sha256=GyOkTVlPrgJTazjTB7v-CghrBzWRSPJIRCqOsyNPS18,2404
+AndroidsSystemFileChooser-0.0.3.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+AndroidsSystemFileChooser-0.0.3.dist-info/top_level.txt,sha256=zrpwMhliKoKkJWJE-rypMlDdLZnX_jLBFZBpoQvsdMc,26
+AndroidsSystemFileChooser-0.0.3.dist-info/RECORD,,

AndroidsSystemFileChooser-0.0.3.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.8.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

AndroidsSystemFileChooser-0.0.3.dist-info/top_level.txt

@@ -0,0 +1 @@
+androidssystemfilechooser

androidssystemfilechooser/__init__.py

@@ -0,0 +1,10 @@
+from .chooser import SystemFileChooser
+from .utils import (JavaStream, uri_image_to_texture, uri_to_extension,
+                    uri_to_filename, uri_to_stream)
+
+__all__ = ('JavaStream',
+           'SystemFileChooser',
+           'uri_to_extension',
+           'uri_to_filename',
+           'uri_to_stream',
+           'uri_image_to_texture')

androidssystemfilechooser/chooser.py

@@ -0,0 +1,54 @@
+from android import activity, mActivity
+from jnius import autoclass
+from kivy.event import EventDispatcher
+from kivy.logger import Logger
+from kivy.properties import BooleanProperty, ListProperty, StringProperty
+
+__all__ = ('SystemFileChooser', )
+
+Intent = autoclass('android.content.Intent')
+REQUEST_CODE_OPEN_DOCUMENT = 1
+
+
+class SystemFileChooser(EventDispatcher):
+    '''Class to be used as a object or subclassed.'''
+
+    mime_type = StringProperty('*/*')
+    '''Mime type to be used with SystemFileChooser.'''
+
+    multiple = BooleanProperty(False)
+    '''Multiple selection with SystemFileChooser.'''
+
+    uris = ListProperty()
+    '''Collection of URI's coming from System's own FileChooser.'''
+
+    def trigger(self):
+        '''Triggers the System's own FileChooser.'''
+        activity.bind(on_activity_result=self._chooser_results)
+        intent = Intent(Intent.ACTION_GET_CONTENT)
+        intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, self.multiple)
+        intent.setType(self.mime_type)
+        mActivity.startActivityForResult(intent, REQUEST_CODE_OPEN_DOCUMENT)
+
+    def _chooser_results(self, requestcode, resultcode, intent):
+        '''Activity results triggered by the trigger itself.'''
+        activity.unbind(on_activity_result=self._chooser_results)
+
+        if resultcode != -1 or intent is None:
+            return  # return nothing because no files selected
+
+        uris = []
+
+        if requestcode == REQUEST_CODE_OPEN_DOCUMENT and resultcode == -1:
+            try:
+                if (clip_data := intent.getClipData()) is not None:
+                    for i in range(clip_data.getItemCount()):
+                        uris.append(clip_data.getItemAt(i).getUri())
+
+                elif (clip_data := intent.getData()) is not None:
+                    uris.append(clip_data)
+
+                self.uris.extend(uris)
+
+            except Exception as e:
+                Logger.error('Error getting file/s: %s', e)

androidssystemfilechooser/utils.py

@@ -0,0 +1,101 @@
+from io import RawIOBase
+
+from android import mActivity
+from jnius import autoclass
+from kivy.graphics.texture import Texture
+
+__all__ = ('JavaStream',
+           'uri_to_extension',
+           'uri_to_filename',
+           'uri_to_stream',
+           'uri_image_to_texture')
+
+BitmapFactory = autoclass('android.graphics.BitmapFactory')
+BitmapFactoryOptions = autoclass('android.graphics.BitmapFactory$Options')
+ByteBuffer = autoclass('java.nio.ByteBuffer')
+Intent = autoclass('android.content.Intent')
+MediaColumns = autoclass('android.provider.MediaStore$MediaColumns')
+MimeTypeMap = autoclass('android.webkit.MimeTypeMap')
+
+
+class JavaStream(RawIOBase):
+    '''Making the stream readable.'''
+
+    def __init__(self, input_stream):
+        self._stream = input_stream
+
+    def close(self) -> None:
+        self._stream.close()
+        super().close()
+
+    def readall(self) -> bytes:
+        self._checkClosed()
+        buffer_size = self._stream.available()
+        buffer = bytearray(buffer_size)
+        read_bytes = self.readinto(buffer)
+        return bytes(buffer[:read_bytes])
+
+    def readinto(self, buffer) -> int | None:
+        self._checkClosed()
+        read_bytes = self._stream.read(buffer)
+
+        if read_bytes < 0:  # EOF
+            return 0
+
+        return read_bytes
+
+
+def uri_to_extension(uri):
+    '''Returns the extension name from the filename using URI.'''
+    return MimeTypeMap.getFileExtensionFromUrl(uri_to_filename(uri))
+
+
+def uri_to_filename(uri):
+    '''Returns the filename from URI. On newer versions it doesn't return the
+       correct filename. But you will get the correct extension name.'''
+    cursor = mActivity.getContentResolver().query(uri, None, None, None, None)
+
+    if cursor is not None and cursor.moveToFirst():
+        filename_index = cursor.getColumnIndex(MediaColumns.DISPLAY_NAME)
+        filename = cursor.getString(filename_index) if filename_index != -1 else None
+        cursor.close()
+        return filename
+
+    return uri.getLastPathSegment()
+
+
+def uri_to_image(uri):
+    '''Open bitmap with the use of URI.'''
+    context =  mActivity.getApplicationContext()
+    resolver = context.getContentResolver()
+    stream = resolver.openInputStream(uri) 
+    bitmap = BitmapFactory.decodeStream(stream) 
+
+    return bitmap
+
+
+def uri_to_stream(uri):
+    '''Opens by URI the FileInputStream with JavaStream.'''
+    resolver = mActivity.getContentResolver()
+    stream = resolver.openInputStream(uri)
+
+    return JavaStream(stream)
+
+
+def uri_image_to_texture(uri):
+    '''Using URI to load the selected image and convert 
+       the image to pixels. Returns texture and size.'''
+    bitmap = uri_to_image(uri)
+    bitmap_size = bitmap.getWidth(), bitmap.getHeight()
+
+    buffer = ByteBuffer.allocateDirect(bitmap.getByteCount())
+    bitmap.copyPixelsToBuffer(buffer)
+    bitmap.recycle()
+
+    texture = Texture.create(bitmap_size, colorfmt='rgba')
+    texture.blit_buffer(bytes(buffer.array()),
+                        colorfmt='rgba',
+                        bufferfmt='ubyte')
+    texture.flip_vertical()
+
+    return texture