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

kivy/extras/highlight.py

@@ -0,0 +1,52 @@
+'''Pygments lexer for kv language
+'''
+from pygments.lexer import RegexLexer, bygroups, using
+from pygments.lexers.agile import PythonLexer
+from pygments import highlight
+from pygments.token import Comment, Text, Name, Punctuation, Operator
+from pygments.formatters import get_formatter_by_name
+import sys
+
+
+class KivyLexer(RegexLexer):
+    name = 'Kivy'
+    aliases = ['kivy', 'kv']
+    filenames = ['*.kv']
+    tokens = {
+        'root': [
+            (r'#:.*?$', Comment.Preproc),
+            (r'#.*?$', using(PythonLexer)),
+            (r'\s+', Text),
+            (r'<.+>', Name.Namespace),
+            (r'(\[)(\s*)(.*?)(\s*)(@)',
+                bygroups(Punctuation, Text, Name.Class, Text, Operator),
+                'classList'),
+            (r'[A-Za-z][A-Za-z0-9]*$', Name.Attribute),
+            (r'(.*?)(\s*)(:)(\s*)$',
+                bygroups(Name.Class, Text, Punctuation, Text)),
+            (r'(.*?)(\s*)(:)(\s*)(.*?)$',
+                bygroups(Name.Attribute, Text, Punctuation, Text,
+                using(PythonLexer))),
+            (r'[^:]+?$', using(PythonLexer))],
+        'classList': [
+            (r'(,)(\s*)([A-Z][A-Za-z0-9]*)',
+                bygroups(Punctuation, Text, Name.Class)),
+            (r'(\+)(\s*)([A-Z][A-Za-z0-9]*)',
+                bygroups(Operator, Text, Name.Class)),
+            (r'\s+', Text),
+            (r'[A-Z][A-Za-z0-9]*', Name.Class),
+            (r'\]', Punctuation, '#pop')]}
+
+
+if __name__ == '__main__':
+    ''' This lexer will highlight .kv file. The first argument is the source
+    file, the second argument is the format of the destination and the third
+    argument is the output filename
+    '''
+    if len(sys.argv) != 4:
+        raise Exception('Three arguments expected, found %s' %
+            (len(sys.argv) - 1))
+    k = KivyLexer()
+    with open(sys.argv[1], 'r') as fd:
+        with open(sys.argv[3], 'w') as out:
+            highlight(fd.read(), k, get_formatter_by_name(sys.argv[2]), out)

kivy/factory.py

@@ -0,0 +1,190 @@
+'''
+Factory object
+==============
+
+The factory can be used to automatically register any class or module
+and instantiate classes from it anywhere in your project. It is an
+implementation of the
+`Factory Pattern <http://en.wikipedia.org/wiki/Factory_pattern>`_.
+
+The class list and available modules are automatically generated by setup.py.
+
+Example for registering a class/module::
+
+    >>> from kivy.factory import Factory
+    >>> Factory.register('Widget', module='kivy.uix.widget')
+    >>> Factory.register('Vector', module='kivy.vector')
+
+Example of using the Factory::
+
+    >>> from kivy.factory import Factory
+    >>> widget = Factory.Widget(pos=(456,456))
+    >>> vector = Factory.Vector(9, 2)
+
+Example using a class name::
+
+    >>> from kivy.factory import Factory
+    >>> Factory.register('MyWidget', cls=MyWidget)
+
+By default, the first classname you register via the factory is permanent.
+If you wish to change the registered class, you need to unregister the
+classname before you re-assign it::
+
+    >>> from kivy.factory import Factory
+    >>> Factory.register('MyWidget', cls=MyWidget)
+    >>> widget = Factory.MyWidget()
+    >>> Factory.unregister('MyWidget')
+    >>> Factory.register('MyWidget', cls=CustomWidget)
+    >>> customWidget = Factory.MyWidget()
+'''
+
+__all__ = ('Factory', 'FactoryBase', 'FactoryException')
+
+import copy
+import importlib
+from kivy.logger import Logger
+from kivy.context import register_context
+
+
+class FactoryException(Exception):
+    pass
+
+
+class FactoryBase(object):
+
+    def __init__(self):
+        super(FactoryBase, self).__init__()
+        self.classes = {}
+
+    @classmethod
+    def create_from(cls, factory):
+        """Creates a instance of the class, and initializes to the state of
+        ``factory``.
+
+        :param factory: The factory to initialize from.
+        :return: A new instance of this class.
+        """
+        obj = cls()
+        obj.classes = copy.copy(factory.classes)
+        return obj
+
+    def is_template(self, classname):
+        '''Return True if the classname is a template from the
+        :class:`~kivy.lang.Builder`.
+
+        .. versionadded:: 1.0.5
+        '''
+        if classname in self.classes:
+            return self.classes[classname]['is_template']
+        else:
+            return False
+
+    def register(self, classname, cls=None, module=None, is_template=False,
+                 baseclasses=None, filename=None, warn=False):
+        '''Register a new classname referring to a real class or
+        class definition in a module. Warn, if True will emit a warning message
+        when a class is re-declared.
+
+        .. versionchanged:: 1.9.0
+            `warn` was added.
+
+        .. versionchanged:: 1.7.0
+            :attr:`baseclasses` and :attr:`filename` added
+
+        .. versionchanged:: 1.0.5
+            :attr:`is_template` has been added in 1.0.5.
+        '''
+        if cls is None and module is None and baseclasses is None:
+            raise ValueError(
+                'You must specify either cls= or module= or baseclasses =')
+        if classname in self.classes:
+            if warn:
+                info = self.classes[classname]
+                Logger.warning('Factory: Ignored class "{}" re-declaration. '
+                'Current -  module: {}, cls: {}, baseclass: {}, filename: {}. '
+                'Ignored -  module: {}, cls: {}, baseclass: {}, filename: {}.'.
+                format(classname, info['module'], info['cls'],
+                       info['baseclasses'], info['filename'], module, cls,
+                       baseclasses, filename))
+            return
+        self.classes[classname] = {
+            'module': module,
+            'cls': cls,
+            'is_template': is_template,
+            'baseclasses': baseclasses,
+            'filename': filename}
+
+    def unregister(self, *classnames):
+        '''Unregisters the classnames previously registered via the
+        register method. This allows the same classnames to be re-used in
+        different contexts.
+
+        .. versionadded:: 1.7.1
+        '''
+        for classname in classnames:
+            if classname in self.classes:
+                self.classes.pop(classname)
+
+    def unregister_from_filename(self, filename):
+        '''Unregister all the factory objects related to the filename passed in
+        the parameter.
+
+        .. versionadded:: 1.7.0
+        '''
+        to_remove = [x for x in self.classes
+                     if self.classes[x]['filename'] == filename]
+        for name in to_remove:
+            del self.classes[name]
+
+    def __getattr__(self, name):
+        classes = self.classes
+        if name not in classes:
+            if name[0] == name[0].lower():
+                # if trying to access attributes like checking for `bind`
+                # then raise AttributeError
+                raise AttributeError(
+                    'First letter of class name <%s> is in lowercase' % name)
+            raise FactoryException('Unknown class <%s>' % name)
+
+        item = classes[name]
+        cls = item['cls']
+
+        # No class to return, import the module
+        if cls is None:
+            if item['module']:
+                module = importlib.__import__(
+                    name=item['module'],
+                    fromlist='*',
+                    level=0  # force absolute
+                )
+                if not hasattr(module, name):
+                    raise FactoryException(
+                        'No class named <%s> in module <%s>' % (
+                            name, item['module']))
+                cls = item['cls'] = getattr(module, name)
+
+            elif item['baseclasses']:
+                rootwidgets = []
+                for basecls in item['baseclasses'].split('+'):
+                    rootwidgets.append(Factory.get(basecls))
+                cls = item['cls'] = type(str(name), tuple(rootwidgets), {})
+
+            else:
+                raise FactoryException('No information to create the class')
+
+        return cls
+
+    get = __getattr__
+
+
+#: Factory instance to use for getting new classes
+Factory: FactoryBase = register_context('Factory', FactoryBase)
+
+# Now import the file with all registers
+# automatically generated by build_factory
+import kivy.factory_registers  # NOQA
+Logger.info('Factory: %d symbols loaded' % len(Factory.classes))
+
+if __name__ == '__main__':
+    Factory.register('Vector', module='kivy.vector')
+    Factory.register('Widget', module='kivy.uix.widget')

kivy/factory_registers.py

@@ -0,0 +1,201 @@
+# Auto-generated file by setup.py build_factory
+
+from kivy.factory import Factory
+
+r = Factory.register
+r('Animation', module='kivy.animation')
+r('AnimationTransition', module='kivy.animation')
+r('ExceptionHandler', module='kivy.base')
+r('Cache', module='kivy.cache')
+r('ClockBase', module='kivy.clock')
+r('ColorPicker', module='kivy.uix.colorpicker')
+r('ColorWheel', module='kivy.uix.colorpicker')
+r('ConfigParser', module='kivy.config')
+r('EventDispatcher', module='kivy.event')
+r('Observable', module='kivy.event')
+r('FactoryException', module='kivy.factory')
+r('Gesture', module='kivy.gesture')
+r('GestureDatabase', module='kivy.gesture')
+r('GesturePoint', module='kivy.gesture')
+r('GestureStroke', module='kivy.gesture')
+r('Parser', module='kivy.lang.parser')
+r('LoaderBase', module='kivy.loader')
+r('ProxyImage', module='kivy.loader')
+r('LoggerHistory', module='kivy.logger')
+r('NumericProperty', module='kivy.properties')
+r('StringProperty', module='kivy.properties')
+r('ListProperty', module='kivy.properties')
+r('ObjectProperty', module='kivy.properties')
+r('BooleanProperty', module='kivy.properties')
+r('BoundedNumericProperty', module='kivy.properties')
+r('OptionProperty', module='kivy.properties')
+r('ReferenceListProperty', module='kivy.properties')
+r('AliasProperty', module='kivy.properties')
+r('NumericProperty', module='kivy.properties')
+r('DictProperty', module='kivy.properties')
+r('VariableListProperty', module='kivy.properties')
+r('ConfigParserProperty', module='kivy.properties')
+r('ColorProperty', module='kivy.properties')
+r('Property', module='kivy.properties')
+r('SafeList', module='kivy.utils')
+r('Vector', module='kivy.vector')
+r('Color', module='kivy.graphics.context_instructions')
+r('BindTexture', module='kivy.graphics.context_instructions')
+r('PushMatrix', module='kivy.graphics.context_instructions')
+r('PopMatrix', module='kivy.graphics.context_instructions')
+r('Rotate', module='kivy.graphics.context_instructions')
+r('Scale', module='kivy.graphics.context_instructions')
+r('Translate', module='kivy.graphics.context_instructions')
+r('Transform', module='kivy.graphics.context_instructions')
+r('MatrixInstruction', module='kivy.graphics.context_instructions')
+r('Fbo', module='kivy.graphics.fbo')
+r('Instruction', module='kivy.graphics.instructions')
+r('InstructionGroup', module='kivy.graphics.instructions')
+r('ContextInstruction', module='kivy.graphics.instructions')
+r('VertexInstruction', module='kivy.graphics.instructions')
+r('Canvas', module='kivy.graphics.instructions')
+r('CanvasBase', module='kivy.graphics.instructions')
+r('Callback', module='kivy.graphics.instructions')
+r('RenderContext', module='kivy.graphics.instructions')
+r('Shader', module='kivy.graphics.shader')
+r('Texture', module='kivy.graphics.texture')
+r('TextureRegion', module='kivy.graphics.texture')
+r('Matrix', module='kivy.graphics.transformation')
+r('VBO', module='kivy.graphics.vbo')
+r('VertexBatch', module='kivy.graphics.vbo')
+r('StencilPush', module='kivy.graphics.stencil_instructions')
+r('StencilPop', module='kivy.graphics.stencil_instructions')
+r('StencilUse', module='kivy.graphics.stencil_instructions')
+r('StencilUnUse', module='kivy.graphics.stencil_instructions')
+r('ScissorPush', module='kivy.graphics.scissor_instructions')
+r('ScissorPop', module='kivy.graphics.scissor_instructions')
+r('Triangle', module='kivy.graphics.vertex_instructions')
+r('Quad', module='kivy.graphics.vertex_instructions')
+r('Rectangle', module='kivy.graphics.vertex_instructions')
+r('RoundedRectangle', module='kivy.graphics.vertex_instructions')
+r('BorderImage', module='kivy.graphics.vertex_instructions')
+r('Ellipse', module='kivy.graphics.vertex_instructions')
+r('Line', module='kivy.graphics.vertex_instructions')
+r('SmoothLine', module='kivy.graphics.vertex_instructions')
+r('SmoothEllipse', module='kivy.graphics.vertex_instructions')
+r('SmoothRectangle', module='kivy.graphics.vertex_instructions')
+r('SmoothRoundedRectangle', module='kivy.graphics.vertex_instructions')
+r('SmoothTriangle', module='kivy.graphics.vertex_instructions')
+r('SmoothQuad', module='kivy.graphics.vertex_instructions')
+r('Point', module='kivy.graphics.vertex_instructions')
+r('Bezier', module='kivy.graphics.vertex_instructions')
+r('Mesh', module='kivy.graphics.vertex_instructions')
+r('Svg', module='kivy.graphics.svg')
+r('BoxShadow', module='kivy.graphics.boxshadow')
+r('MotionEventFactory', module='kivy.input.factory')
+r('MotionEventProvider', module='kivy.input.provider')
+r('Shape', module='kivy.input.shape')
+r('ShapeRect', module='kivy.input.shape')
+r('ActionBar', module='kivy.uix.actionbar')
+r('ActionItem', module='kivy.uix.actionbar')
+r('ActionButton', module='kivy.uix.actionbar')
+r('ActionToggleButton', module='kivy.uix.actionbar')
+r('ActionCheck', module='kivy.uix.actionbar')
+r('ActionSeparator', module='kivy.uix.actionbar')
+r('ActionDropDown', module='kivy.uix.actionbar')
+r('ActionGroup', module='kivy.uix.actionbar')
+r('ActionOverflow', module='kivy.uix.actionbar')
+r('ActionView', module='kivy.uix.actionbar')
+r('ContextualActionView', module='kivy.uix.actionbar')
+r('AnchorLayout', module='kivy.uix.anchorlayout')
+r('BoxLayout', module='kivy.uix.boxlayout')
+r('GridLayout', module='kivy.uix.gridlayout')
+r('PageLayout', module='kivy.uix.pagelayout')
+r('Accordion', module='kivy.uix.accordion')
+r('AccordionItem', module='kivy.uix.accordion')
+r('Button', module='kivy.uix.button')
+r('ButtonBehavior', module='kivy.uix.behaviors.button')
+r('ToggleButtonBehavior', module='kivy.uix.behaviors.togglebutton')
+r('DragBehavior', module='kivy.uix.behaviors.drag')
+r('FocusBehavior', module='kivy.uix.behaviors.focus')
+r('CompoundSelectionBehavior', module='kivy.uix.behaviors.compoundselection')
+r('KNSpaceBehavior', module='kivy.uix.behaviors.knspace')
+r('CodeNavigationBehavior', module='kivy.uix.behaviors.codenavigation')
+r('TouchRippleBehavior', module='kivy.uix.behaviors.touchripple')
+r('TouchRippleButtonBehavior', module='kivy.uix.behaviors.touchripple')
+r('EmacsBehavior', module='kivy.uix.behaviors.emacs')
+r('CoverBehavior', module='kivy.uix.behaviors.cover')
+r('Bubble', module='kivy.uix.bubble')
+r('BubbleButton', module='kivy.uix.bubble')
+r('Camera', module='kivy.uix.camera')
+r('Carousel', module='kivy.uix.carousel')
+r('CodeInput', module='kivy.uix.codeinput')
+r('CheckBox', module='kivy.uix.checkbox')
+r('DropDown', module='kivy.uix.dropdown')
+r('EffectWidget', module='kivy.uix.effectwidget')
+r('FloatLayout', module='kivy.uix.floatlayout')
+r('RelativeLayout', module='kivy.uix.relativelayout')
+r('ScatterLayout', module='kivy.uix.scatterlayout')
+r('ScatterPlaneLayout', module='kivy.uix.scatterlayout')
+r('FileChooserListView', module='kivy.uix.filechooser')
+r('FileChooserIconView', module='kivy.uix.filechooser')
+r('FileChooser', module='kivy.uix.filechooser')
+r('Image', module='kivy.uix.image')
+r('AsyncImage', module='kivy.uix.image')
+r('Label', module='kivy.uix.label')
+r('Layout', module='kivy.uix.layout')
+r('ModalView', module='kivy.uix.modalview')
+r('ProgressBar', module='kivy.uix.progressbar')
+r('Popup', module='kivy.uix.popup')
+r('Scatter', module='kivy.uix.scatter')
+r('ScatterPlane', module='kivy.uix.scatter')
+r('ScrollView', module='kivy.uix.scrollview')
+r('Settings', module='kivy.uix.settings')
+r('Slider', module='kivy.uix.slider')
+r('Screen', module='kivy.uix.screenmanager')
+r('ScreenManager', module='kivy.uix.screenmanager')
+r('Spinner', module='kivy.uix.spinner')
+r('Splitter', module='kivy.uix.splitter')
+r('StackLayout', module='kivy.uix.stacklayout')
+r('StencilView', module='kivy.uix.stencilview')
+r('Switch', module='kivy.uix.switch')
+r('TabbedPanel', module='kivy.uix.tabbedpanel')
+r('TabbedPanelHeader', module='kivy.uix.tabbedpanel')
+r('TextInput', module='kivy.uix.textinput')
+r('ToggleButton', module='kivy.uix.togglebutton')
+r('TreeView', module='kivy.uix.treeview')
+r('TreeViewLabel', module='kivy.uix.treeview')
+r('TreeViewNode', module='kivy.uix.treeview')
+r('ShaderTransition', module='kivy.uix.screenmanager')
+r('SlideTransition', module='kivy.uix.screenmanager')
+r('SwapTransition', module='kivy.uix.screenmanager')
+r('WipeTransition', module='kivy.uix.screenmanager')
+r('FadeTransition', module='kivy.uix.screenmanager')
+r('Sandbox', module='kivy.uix.sandbox')
+r('Video', module='kivy.uix.video')
+r('VideoPlayer', module='kivy.uix.videoplayer')
+r('VideoPlayerVolume', module='kivy.uix.videoplayer')
+r('VideoPlayerStop', module='kivy.uix.videoplayer')
+r('VideoPlayerPlayPause', module='kivy.uix.videoplayer')
+r('VideoPlayerProgressBar', module='kivy.uix.videoplayer')
+r('VKeyboard', module='kivy.uix.vkeyboard')
+r('Widget', module='kivy.uix.widget')
+r('WidgetException', module='kivy.uix.widget')
+r('RstDocument', module='kivy.uix.rst')
+r('KineticEffect', module='kivy.effects.kinetic')
+r('ScrollEffect', module='kivy.effects.scroll')
+r('DampedScrollEffect', module='kivy.effects.dampedscroll')
+r('OpacityScrollEffect', module='kivy.effects.opacityscroll')
+r('Recognizer', module='kivy.multistroke')
+r('MultistrokeGesture', module='kivy.multistroke')
+r('UnistrokeTemplate', module='kivy.multistroke')
+r('ProgressTracker', module='kivy.multistroke')
+r('GestureSurface', module='kivy.uix.gesturesurface')
+r('GestureContainer', module='kivy.uix.gesturesurface')
+r('RecycleViewBehavior', module='kivy.uix.recycleview.__init__')
+r('RecycleView', module='kivy.uix.recycleview.__init__')
+r('LayoutSelectionBehavior', module='kivy.uix.recycleview.layout')
+r('RecycleLayoutManagerBehavior', module='kivy.uix.recycleview.layout')
+r('RecycleDataViewBehavior', module='kivy.uix.recycleview.views')
+r('RecycleKVIDsDataViewBehavior', module='kivy.uix.recycleview.views')
+r('RecycleDataAdapter', module='kivy.uix.recycleview.views')
+r('RecycleDataModelBehavior', module='kivy.uix.recycleview.datamodel')
+r('RecycleDataModel', module='kivy.uix.recycleview.datamodel')
+r('RecycleLayout', module='kivy.uix.recyclelayout')
+r('RecycleGridLayout', module='kivy.uix.recyclegridlayout')
+r('RecycleBoxLayout', module='kivy.uix.recycleboxlayout')

kivy/garden/__init__.py

@@ -0,0 +1,186 @@
+'''
+Garden
+======
+
+.. versionadded:: 1.7.0
+
+.. versionchanged:: 1.11.1
+
+Garden is a project to centralize addons for Kivy maintained by users. You can
+find more information at `Kivy Garden <http://kivy-garden.github.io/>`_. All
+the garden packages are centralized on the `kivy-garden Github
+<https://github.com/kivy-garden>`_ repository.
+
+.. warning::
+
+    The garden flower widgets are contributed by regular users such as
+    yourself. The kivy developers do not take any responsibility for the code
+    hosted in the garden organization repositories - we do not actively monitor
+    the flower repos. Please use at your own risk.
+
+Update to garden structure
+--------------------------
+
+Starting with the kivy 1.11.0 release, kivy has
+`shifted <https://github.com/kivy/kivy/wiki/Moving-kivy.garden.xxx-to-kivy_\
+garden.xxx-and-kivy.deps.xxx-to-kivy_deps.xxx>`_ from using the garden legacy
+tool that installs flowers with `garden install flower` where the flower
+does not have a proper python package structure to flowers that can be
+installed with pip and uploaded to pypi. Kivy supports the legacy garden
+flowers side by side with the newer packages so the garden tool and legacy
+flowers will be able to be used indefinitely. But we will only provide support
+for the newer packages format in the future.
+
+For garden package maintainers - for a guide how to migrate your garden package
+from the legacy structure `garden.flower` to the newer `flower` structure used
+with the pip, see `this guide
+<https://kivy-garden.github.io/#guideformigratingflowersfromlegacystructure>`_.
+
+We hope most garden packages will be converted to the newer format to help
+with installation.
+
+General Usage Guidelines
+------------------------
+
+To use a kivy garden flower, first check if the flower is in the legacy format.
+If the flower name is in the format of `garden.flower`, such as
+`garden.graph <https://github.com/kivy-garden/garden.graph>`_ it is a legacy
+flower. If it is just `flower` such as
+`graph <https://github.com/kivy-garden/graph>`_ it is in the present format.
+If it is in the legacy format see `Legacy garden tool instructions`_ for how to
+install and use it. Otherwise, continue with the guide below.
+
+Garden flowers can now be installed with the `pip` tool like a normal python
+package. Given a flower that you want to install, lets use
+`graph <https://github.com/kivy-garden/graph>`_ as an example. You can install
+master directly from github with::
+
+    python -m pip install \
+https://github.com/kivy-garden/graph/archive/master.zip
+
+Look under the repository's releases tab if you'd like to install a specific
+release or a pre-compiled wheel, if the flower has any. Then use the url with
+`pip`.
+
+Or you can automatically install it using garden's pypi server with::
+
+    python -m pip install kivy_garden.graph \
+--extra-index-url https://kivy-garden.github.io/simple/
+
+To permanently add our garden server to your pip configuration so that you
+don't have to specify it with `--extra-index-url`, add::
+
+    [global]
+    timeout = 60
+    index-url = https://kivy-garden.github.io/simple/
+
+to your `pip.conf <https://pip.pypa.io/en/stable/user_guide/#config-file>`_.
+
+If the flower maintainer has uploaded the flower to
+`pypi <https://pypi.org/>`_, you can just install it with
+`pip install kivy_garden.flower`.
+
+
+Legacy garden tool instructions
+-------------------------------
+
+Garden is now distributed as a separate Python module, kivy-garden. You can
+install it with pip::
+
+    pip install kivy-garden
+
+The garden module does not initially include any packages. You can download
+them with the garden tool installed by the pip package::
+
+    # Installing a garden package
+    garden install graph
+
+    # Upgrade a garden package
+    garden install --upgrade graph
+
+    # Uninstall a garden package
+    garden uninstall graph
+
+    # List all the garden packages installed
+    garden list
+
+    # Search new packages
+    garden search
+
+    # Search all the packages that contain "graph"
+    garden search graph
+
+    # Show the help
+    garden --help
+
+All the garden packages are installed by default in `~/.kivy/garden`.
+
+.. Note:: In previous versions of Kivy, garden was a tool at
+          kivy/tools/garden. This no longer exists, but the
+          kivy-garden module provides exactly the same functionality.
+
+Packaging
+~~~~~~~~~
+
+If you want to include garden packages in your application, you can add `--app`
+to the `install` command. This will create a `libs/garden` directory in your
+current directory which will be used by `kivy.garden`.
+
+For example::
+
+    cd myapp
+    garden install --app graph
+
+
+'''
+
+__path__ = 'kivy.garden'
+
+import importlib.util
+from importlib.abc import MetaPathFinder
+import sys
+from os.path import dirname, join, realpath, exists, abspath
+from kivy import kivy_home_dir
+from kivy.utils import platform
+import kivy
+
+#: system path where garden modules can be installed
+garden_system_dir = join(kivy_home_dir, 'garden')
+garden_kivy_dir = abspath(join(dirname(kivy.__file__), 'garden'))
+
+#: application path where garden modules can be installed
+if getattr(sys, 'frozen', False) and getattr(sys, '_MEIPASS', False):
+    garden_app_dir = join(realpath(sys._MEIPASS), 'libs', 'garden')
+else:
+    garden_app_dir = join(realpath(dirname(sys.argv[0])), 'libs', 'garden')
+#: Fixes issue #4030 in kivy where garden path is incorrect on iOS
+if platform == "ios":
+    from os.path import join, dirname
+    import __main__
+    main_py_file = __main__.__file__
+    garden_app_dir = join(dirname(main_py_file), 'libs', 'garden')
+
+
+class GardenImporter(MetaPathFinder):
+
+    def find_spec(self, fullname, path, target=None):
+        if path != "kivy.garden":
+            return None
+
+        moddir = join(
+            garden_kivy_dir, fullname.split(".", 2)[-1], "__init__.py"
+        )
+        if exists(moddir):
+            return importlib.util.spec_from_file_location(fullname, moddir)
+
+        modname = fullname.split(".", 1)[-1]
+        for directory in (garden_app_dir, garden_system_dir):
+            moddir = join(directory, modname, "__init__.py")
+            if exists(moddir):
+                return importlib.util.spec_from_file_location(fullname, moddir)
+
+        return None
+
+
+# insert the garden importer as ultimate importer
+sys.meta_path.append(GardenImporter())