Kivy-examples 2.3.1.dev0__py3-none-any.whl

Kivy_examples-2.3.1.dev0.data/data/share/kivy-examples/widgets/label_sizing.py

@@ -0,0 +1,193 @@
+
+"""
+Label textsize
+============
+
+This example shows how to size a Label to its content (texture_size) and how
+setting text_size controls text wrapping.
+"""
+from kivy.app import App
+from kivy.clock import Clock
+from kivy.lang import Builder
+from kivy.properties import StringProperty, NumericProperty, BooleanProperty
+
+# Copied from https://en.wikipedia.org/wiki/A_Tale_of_Two_Cities
+# Published in 1859 and public domain.
+# The newline after the title will help demonstrate halign
+_example_title_text = 'A Tale of Two Cities, by Charles Dickens\n'
+_example_text = """It was the best of times, it was the worst of times,
+it was the age of wisdom, it was the age of foolishness, it was the epoch of
+belief, it was the epoch of incredulity, it was the season of Light, it was
+the season of Darkness, it was the spring of hope, it was the winter of
+despair, we had everything before us, we had nothing before us, we were all
+going direct to Heaven, we were all going direct the other way - in short,
+the period was so far like the present period, that some of its noisiest
+authorities insisted on its being received, for good or for evil, in the
+superlative degree of comparison only.
+"""
+
+# Note: Many of the Widgets (StackLayout, ToggleButton, Spinner) have
+# defaults set at the bottom of the KV, where  DemoLabel and HeadingLabel
+# are also defined.
+_kv_code = """
+BoxLayout:
+    orientation: 'vertical'
+
+    HeadingLabel:
+        text: 'These modify all demonstration Labels'
+
+    StackLayout:
+        # Button is a subclass of Label and can be sized
+        # to text in the same way
+
+        Button:
+            text: 'Reset'
+            on_press: app.reset_words()
+
+        ToggleButton:
+            text: 'Shorten'
+            on_state:
+                app.shorten=self.state=='down'
+
+        ToggleButton:
+            text: 'max_lines=3'
+            on_state:
+                app.max_lines=3 if self.state=='down' else 0
+
+        Spinner:
+            text: 'bottom'
+            values: 'bottom', 'middle', 'top'
+            on_text: app.valign=self.text
+
+        Spinner:
+            text: 'left'
+            values: 'left', 'center', 'right', 'justify'
+            on_text: app.halign=self.text
+
+    GridLayout:
+        id: grid_layout
+        cols: 2
+        height: cm(6)
+        size_hint_y: None
+
+        HeadingLabel:
+            text: "Default, no text_size set"
+
+        HeadingLabel:
+            text: 'text_size bound to size'
+
+        DemoLabel:
+            id: left_content
+            disabled_color: 0, 0, 0, 0
+
+        DemoLabel:
+            id: right_content
+            text_size: self.size
+            padding: dp(6), dp(6)
+
+    ToggleButton:
+        text: 'Disable left'
+        on_state:
+            left_content.disabled=self.state=='down'
+
+    # Need one Widget without size_hint_y: None, so that BoxLayout fills
+    # available space.
+    HeadingLabel:
+        text: 'text_size width set, size bound to texture_size'
+        text_size: self.size
+        size_hint_y: 1
+
+    DemoLabel:
+        id: bottom_content
+        # This Label wraps and expands its height to fit the text because
+        # only text_size width is set and the Label size binds to texture_size.
+        text_size: self.width, None
+        size: self.texture_size
+        padding: mm(4), mm(4)
+        size_hint_y: None
+
+# The column heading labels have their width set by the parent,
+# but determine their height from the text.
+<HeadingLabel@Label>:
+    bold: True
+    padding: dp(6), dp(4)
+    valign: 'bottom'
+    height: self.texture_size[1]
+    text_size: self.width, None
+    size_hint_y: None
+
+<ToggleButton,Button>:
+    padding: dp(10), dp(8)
+    size_hint: None, None
+    size: self.texture_size
+
+# This inherits Button and the modifications above, so reset size
+<Spinner>:
+    size: sp(68), self.texture_size[1]
+
+<DemoLabel@Label>:
+    halign: app.halign
+    valign: app.valign
+    shorten: app.shorten
+    max_lines: app.max_lines
+
+    canvas:
+        Color:
+            rgb: 68/255.0, 164/255.0, 201/255.0
+        Line:
+            rectangle: self.x, self.y, self.width, self.height
+
+<StackLayout>:
+    size_hint_y: None
+    spacing: dp(6)
+    padding: dp(6), dp(4)
+    height: self.minimum_height
+"""
+
+
+class LabelTextureSizeExample(App):
+    # All Labels use these properties, set to Label defaults
+    valign = StringProperty('bottom')
+    halign = StringProperty('left')
+    shorten = BooleanProperty(False)
+    max_lines = NumericProperty(0)
+
+    def build(self):
+        self._add_word_ev = None
+        return Builder.load_string(_kv_code)
+
+    def on_start(self):
+        widget_ids = self.root.ids
+        self.text_content_widgets = (widget_ids.left_content,
+                                     widget_ids.right_content,
+                                     widget_ids.bottom_content)
+        self.reset_words()
+
+    def reset_words(self):
+        if self._add_word_ev is not None:
+            self._add_word_ev.cancel()
+            self._add_word_ev = None
+        for content_widget in self.text_content_widgets:
+            content_widget.text = _example_title_text
+        # initialize words generator
+        self.words = (word for word in _example_text.split())
+        self.add_word()
+
+    def add_word(self, dt=None):
+        try:
+            word = next(self.words)
+        except StopIteration:
+            return
+
+        for content_widget in self.text_content_widgets:
+            content_widget.text += word + ' '
+
+        pause_time = 0.03 * len(word)
+        if word.endswith(','):
+            pause_time += 0.6
+
+        self._add_word_ev = Clock.schedule_once(self.add_word, pause_time)
+
+
+if __name__ == '__main__':
+    LabelTextureSizeExample().run()

Kivy_examples-2.3.1.dev0.data/data/share/kivy-examples/widgets/label_text_size.py

@@ -0,0 +1,49 @@
+
+'''
+Label textsize
+============
+
+This example shows how the textsize and line_height property are used
+to format label widget
+'''
+
+import kivy
+kivy.require('1.0.7')
+
+from kivy.app import App
+from kivy.uix.label import Label
+
+
+_long_text = ("""Lorem ipsum dolor sit amet, consectetur adipiscing elit. """
+    """Phasellus odio nisi, pellentesque molestie adipiscing vitae, aliquam """
+    """at tellus. Fusce quis est ornare erat pulvinar elementum ut sed """
+    """felis. Donec vel neque mauris. In sit amet nunc sit amet diam dapibus"""
+    """ lacinia. In sodales placerat mauris, ut euismod augue laoreet at. """
+    """Integer in neque non odio fermentum volutpat nec nec nulla. Donec et """
+    """risus non mi viverra posuere. Phasellus cursus augue purus, eget """
+    """volutpat leo. Phasellus sed dui vitae ipsum mattis facilisis vehicula"""
+    """ eu justo.\n\n"""
+    """Quisque neque dolor, egestas sed venenatis eget, porta id ipsum. Ut """
+    """faucibus, massa vitae imperdiet rutrum, sem dolor rhoncus magna, non """
+    """lacinia nulla risus non dui. Nulla sit amet risus orci. Nunc libero """
+    """justo, interdum eu pulvinar vel, pulvinar et lectus. Phasellus sed """
+    """luctus diam. Pellentesque non feugiat dolor. Cras at dolor velit, """
+    """gravida congue velit. Aliquam erat volutpat. Nullam eu nunc dui, quis"""
+    """ sagittis dolor. Ut nec dui eget odio pulvinar placerat. Pellentesque"""
+    """ mi metus, tristique et placerat ac, pulvinar vel quam. Nam blandit """
+    """magna a urna imperdiet molestie. Nullam ut nisi eget enim laoreet """
+    """sodales sit amet a felis.\n""")
+
+
+class LabelTextSizeTest(App):
+    def build(self):
+        z = Label(
+            text=_long_text,
+            text_size=(600, None),
+            line_height=1.5
+        )
+        return z
+
+
+if __name__ == '__main__':
+    LabelTextSizeTest().run()

Kivy_examples-2.3.1.dev0.data/data/share/kivy-examples/widgets/label_with_markup.py

@@ -0,0 +1,21 @@
+from kivy.app import App
+from kivy.lang import Builder
+
+root = Builder.load_string('''
+Label:
+    text:
+        ('[b]Hello[/b] [color=ff0099]World[/color]\\n'
+        '[color=ff0099]Hello[/color] [b]World[/b]\\n'
+        '[b]Hello[/b] [color=ff0099]World[/color]')
+    markup: True
+    font_size: '64pt'
+''')
+
+
+class LabelWithMarkup(App):
+    def build(self):
+        return root
+
+
+if __name__ == '__main__':
+    LabelWithMarkup().run()

Kivy_examples-2.3.1.dev0.data/data/share/kivy-examples/widgets/lang_dynamic_classes.py

@@ -0,0 +1,18 @@
+# Dynamic kv classes
+
+from kivy.lang import Builder
+from kivy.base import runTouchApp
+
+root = Builder.load_string('''
+<ImageButton@Button>:
+    source: None
+    Image:
+        source: root.source
+        center: root.center
+
+ImageButton:
+    source: 'kivy/data/logo/kivy-icon-512.png'
+''')
+
+
+runTouchApp(root)

Kivy_examples-2.3.1.dev0.data/data/share/kivy-examples/widgets/pagelayout.py

@@ -0,0 +1,64 @@
+from kivy.base import runTouchApp
+from kivy.lang import Builder
+
+kv = '''
+PageLayout:
+    BoxLayout:
+        canvas:
+            Color:
+                rgba: 216/255., 195/255., 88/255., 1
+            Rectangle:
+                pos: self.pos
+                size: self.size
+
+        orientation: 'vertical'
+        Label:
+            size_hint_y: None
+            height: 1.5 * self.texture_size[1]
+            text: 'page 1'
+
+        Button:
+            text: 'test'
+            on_press: print("test")
+
+    BoxLayout:
+        orientation: 'vertical'
+        canvas:
+            Color:
+                rgba: 109/255., 8/255., 57/255., 1
+            Rectangle:
+                pos: self.pos
+                size: self.size
+
+        Label:
+            text: 'page 2'
+
+        AsyncImage:
+            source: 'http://kivy.org/logos/kivy-logo-black-64.png'
+
+    GridLayout:
+        canvas:
+            Color:
+                rgba: 37/255., 39/255., 30/255., 1
+            Rectangle:
+                pos: self.pos
+                size: self.size
+
+        cols: 2
+        Label:
+            text: 'page 3'
+        AsyncImage:
+            source: 'http://kivy.org/slides/kivyandroid-thumb.jpg'
+        Button:
+            text: 'test'
+            on_press: print("test last page")
+        AsyncImage:
+            source: 'http://kivy.org/slides/kivypictures-thumb.jpg'
+        Widget
+        AsyncImage:
+            source: 'http://kivy.org/slides/particlepanda-thumb.jpg'
+'''
+
+
+if __name__ == '__main__':
+    runTouchApp(Builder.load_string(kv))

Kivy_examples-2.3.1.dev0.data/data/share/kivy-examples/widgets/popup_with_kv.py

@@ -0,0 +1,35 @@
+'''
+Example to show a Popup usage with the content from kv lang.
+'''
+from kivy.uix.popup import Popup
+from kivy.uix.button import Button
+from kivy.app import App
+from kivy.lang import Builder
+
+Builder.load_string('''
+<CustomPopup>:
+    size_hint: .5, .5
+    auto_dismiss: False
+    title: 'Hello world'
+    Button:
+        text: 'Click me to dismiss'
+        on_press: root.dismiss()
+
+''')
+
+
+class CustomPopup(Popup):
+    pass
+
+
+class TestApp(App):
+    def build(self):
+        b = Button(on_press=self.show_popup, text="Show Popup")
+        return b
+
+    def show_popup(self, b):
+        p = CustomPopup()
+        p.open()
+
+
+TestApp().run()

Kivy_examples-2.3.1.dev0.data/data/share/kivy-examples/widgets/recycleview/basic_data.py

@@ -0,0 +1,124 @@
+from random import sample, randint
+from string import ascii_lowercase
+
+from kivy.app import App
+from kivy.lang import Builder
+from kivy.uix.boxlayout import BoxLayout
+
+
+kv = """
+<Row@RecycleKVIDsDataViewBehavior+BoxLayout>:
+    canvas.before:
+        Color:
+            rgba: 0.5, 0.5, 0.5, 1
+        Rectangle:
+            size: self.size
+            pos: self.pos
+    value: ''
+    Label:
+        id: name
+    Label:
+        text: root.value
+
+<Test>:
+    canvas:
+        Color:
+            rgba: 0.3, 0.3, 0.3, 1
+        Rectangle:
+            size: self.size
+            pos: self.pos
+    rv: rv
+    orientation: 'vertical'
+    GridLayout:
+        cols: 3
+        rows: 2
+        size_hint_y: None
+        height: dp(108)
+        padding: dp(8)
+        spacing: dp(16)
+        Button:
+            text: 'Populate list'
+            on_press: root.populate()
+        Button:
+            text: 'Sort list'
+            on_press: root.sort()
+        Button:
+            text: 'Clear list'
+            on_press: root.clear()
+        BoxLayout:
+            spacing: dp(8)
+            Button:
+                text: 'Insert new item'
+                on_press: root.insert(new_item_input.text)
+            TextInput:
+                id: new_item_input
+                size_hint_x: 0.6
+                hint_text: 'value'
+                padding: dp(10), dp(10), 0, 0
+        BoxLayout:
+            spacing: dp(8)
+            Button:
+                text: 'Update first item'
+                on_press: root.update(update_item_input.text)
+            TextInput:
+                id: update_item_input
+                size_hint_x: 0.6
+                hint_text: 'new value'
+                padding: dp(10), dp(10), 0, 0
+        Button:
+            text: 'Remove first item'
+            on_press: root.remove()
+
+    RecycleView:
+        id: rv
+        scroll_type: ['bars', 'content']
+        scroll_wheel_distance: dp(114)
+        bar_width: dp(10)
+        viewclass: 'Row'
+        RecycleBoxLayout:
+            default_size: None, dp(56)
+            default_size_hint: 1, None
+            size_hint_y: None
+            height: self.minimum_height
+            orientation: 'vertical'
+            spacing: dp(2)
+"""
+
+Builder.load_string(kv)
+
+
+class Test(BoxLayout):
+
+    def populate(self):
+        self.rv.data = [
+            {'name.text': ''.join(sample(ascii_lowercase, 6)),
+             'value': str(randint(0, 2000))}
+            for x in range(50)]
+
+    def sort(self):
+        self.rv.data = sorted(self.rv.data, key=lambda x: x['name.text'])
+
+    def clear(self):
+        self.rv.data = []
+
+    def insert(self, value):
+        self.rv.data.insert(0, {
+            'name.text': value or 'default value', 'value': 'unknown'})
+
+    def update(self, value):
+        if self.rv.data:
+            self.rv.data[0]['name.text'] = value or 'default new value'
+            self.rv.refresh_from_data()
+
+    def remove(self):
+        if self.rv.data:
+            self.rv.data.pop(0)
+
+
+class TestApp(App):
+    def build(self):
+        return Test()
+
+
+if __name__ == '__main__':
+    TestApp().run()

Kivy_examples-2.3.1.dev0.data/data/share/kivy-examples/widgets/recycleview/infinite_scrolling.py

@@ -0,0 +1,143 @@
+"""
+A constantly appending log, using recycleview.
+- use variable size widgets using the key_size property to cache texture_size
+- keeps current position in scroll when new data is happened, unless the view
+  is at the very bottom, in which case it follows the log
+- works well with mouse scrolling, but less nicely when using swipes,
+  improvements welcome.
+"""
+
+from random import sample
+from string import printable
+from time import asctime
+
+from kivy.app import App
+from kivy.uix.recycleview import RecycleView
+from kivy.lang import Builder
+from kivy.properties import NumericProperty, ListProperty
+from kivy.clock import Clock
+
+
+KV = """
+#:import rgba kivy.utils.rgba
+
+<LogLabel@RelativeLayout>:
+    # using a boxlayout here allows us to have better control of the text
+    # position
+    text: ''
+    index: None
+    Label:
+        y: 0
+        x: 5
+        size_hint: None, None
+        size: self.texture_size
+        padding: dp(5), dp(5)
+        color: rgba("#3f3e36")
+        text: root.text
+        on_texture_size: app.update_size(root.index, self.texture_size)
+
+        canvas.before:
+            Color:
+                rgba: rgba("#dbeeff")
+            RoundedRectangle:
+                pos: self.pos
+                size: self.size
+                radius: dp(5), dp(5)
+
+BoxLayout:
+    orientation: 'vertical'
+    spacing: dp(2)
+
+    # a label to help understand what's happening with the scrolling
+    Label:
+        size_hint_y: None
+        height: self.texture_size[1]
+        text:
+            '''height: {height}
+            scrollable_distance: {scrollable_distance}
+            distance_to_top: {distance_to_top}
+            scroll_y: {scroll_y}
+            '''.format(
+            height=rv.height,
+            scrollable_distance=rv.scrollable_distance,
+            distance_to_top=rv.distance_to_top,
+            scroll_y=rv.scroll_y,
+            )
+
+        canvas.before:
+            Color:
+                rgba: rgba("#77b4ff")
+            RoundedRectangle:
+                pos: self.pos
+                size: self.size
+                radius: dp(5), dp(5)
+
+    FixedRecycleView:
+        id: rv
+        data: app.data
+        viewclass: 'LogLabel'
+        scrollable_distance: box.height - self.height
+
+        RecycleBoxLayout:
+            id: box
+            orientation: 'vertical'
+            size_hint_y: None
+            height: self.minimum_height
+            default_size: 0, 48
+            default_size_hint: 1, None
+            spacing: dp(1)
+            key_size: 'cached_size'
+"""
+
+
+class FixedRecycleView(RecycleView):
+    distance_to_top = NumericProperty()
+    scrollable_distance = NumericProperty()
+
+    def on_scrollable_distance(self, *args):
+        """This method maintains the position in scroll, by using the saved
+        distance_to_top property to adjust the scroll_y property. Only if we
+        are currently scrolled back.
+        """
+        if self.scroll_y > 0:
+            self.scroll_y = (
+                (self.scrollable_distance - self.distance_to_top)
+                / self.scrollable_distance
+            )
+
+    def on_scroll_y(self, *args):
+        """Save the distance_to_top everytime we scroll.
+        """
+        self.distance_to_top = (1 - self.scroll_y) * self.scrollable_distance
+
+
+class Application(App):
+    data = ListProperty()
+
+    def build(self):
+        Clock.schedule_interval(self.add_log, .1)
+        return Builder.load_string(KV)
+
+    def add_log(self, dt):
+        """Produce random text to append in the log, with the date, we don't
+        want to forget when we babbled incoherently.
+        """
+        self.data.append({
+            'index': len(self.data),
+            'text': f"[{asctime()}]: {''.join(sample(printable, 50))}",
+            'cached_size': (0, 0)
+        })
+
+    def update_size(self, index, size):
+        """Maintain the size data for a log entry, so recycleview can adjust
+        the size computation.
+        As a log entry needs to be displayed to compute its size, it's by
+        default considered to be (0, 0) which is a good enough approximation
+        for such a small widget, but you might want do give a better default
+        value if that doesn't fit your needs.
+        """
+        self.data[index]['cached_size'] = size
+
+
+if __name__ == '__main__':
+    Application().run()