kivy-garden

library0.1.5pypypiunverified

Kivy Garden is a project and command-line tool that centralizes user-contributed add-ons, called "flowers," for the Kivy framework. These "flowers" are typically distributed as separate PyPI packages under the `kivy_garden.*` namespace (e.g., `kivy_garden.mapview`). The `kivy-garden` tool facilitates the management and installation of both legacy and modern pip-installable Kivy extensions. It is currently at version 0.1.5 and provides utilities for Kivy developers to extend their applications with community-contributed widgets and tools.

web-framework

pip install kivy-garden

package ↗

INSTALL

IMPORT

SIG · KIVY-GARDEN

kivy-garden

web-frameworkpythonv0.1.5

Install

1.8s avg

Import

—

Disk

42MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.1.5 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.940 runs

installs and imports cleanly · install 0.0s · import 0.000s · 65.8MB

glibc

py 3.10–3.940 runs

installs and imports cleanly · install 1.8s · import 0.000s · 22MB

42MB installed

● package 42MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

MapView

✓ from kivy_garden.mapview import MapView

✗ from kivy_garden.mapview import MapView

This quickstart demonstrates how to create a simple Kivy application displaying an interactive map using the `kivy_garden.mapview` 'flower'. It initializes a MapView widget and places a marker on it, showcasing the standard import and usage pattern for modern Kivy Garden components.

from kivy.app import App from kivy.uix.boxlayout import BoxLayout from kivy_garden.mapview import MapView, MapMarker from kivy.core.window import Window # Ensure kivy_garden.mapview is installed: pip install kivy_garden.mapview class MapApp(App): def build(self): Window.size = (800, 600) box = BoxLayout(orientation='vertical') # Initialize MapView with example coordinates mapview = MapView(zoom=11, lat=50.6394, lon=3.057) # Add a marker to the map marker = MapMarker(lat=50.6394, lon=3.057, source="atlas://kivy_atlas/data/images/defaulttheme/star") mapview.add_marker(marker) box.add_widget(mapview) return box if __name__ == '__main__': MapApp().run()

kivy-garden --version

Debug

Known issues

breakingKivy 1.11.0 introduced a significant shift in the Kivy Garden structure. Newer 'flowers' are designed to be installed via `pip install kivy_garden.flower_name` and imported from `kivy_garden.*`. While the legacy `garden install flower_name` command still functions for older modules, new development and support primarily target the pip-installable package format.

fix

For new projects, prioritize `pip install kivy_garden.flower_name` and `from kivy_garden.flower_name import ...`. For existing legacy projects, ensure `kivy-garden` is installed and use the `garden` command or migrate flowers to the new format if possible.

affects: Kivy >= 1.11.0, kivy-garden >= 0.1.0

gotchaKivy Garden 'flowers' are community-contributed and are not actively monitored or officially supported by the core Kivy developers. Their stability, maintenance, and adherence to Kivy's latest versions can vary significantly between individual 'flowers'.

fix

Always check the specific 'flower's' GitHub repository or documentation for its status, last update, and compatibility. Use at your own risk and consider contributing or forking if a critical 'flower' becomes unmaintained.

affects: All versions

gotchaWhen packaging Kivy applications for mobile platforms (e.g., Android with Buildozer) that use Kivy Garden 'flowers', merely installing `kivy-garden` is insufficient. Each specific `kivy_garden.flower_name` package must be explicitly listed in the `requirements` section of your `buildozer.spec` file, or installed using `garden install --app flower_name` during the build process, to ensure it's bundled with your application.

fix

In `buildozer.spec`, add `kivy_garden.flower_name` to the `requirements` list (e.g., `requirements = python3,kivy,kivy_garden.mapview`). Alternatively, for legacy flowers, use `garden install --app flower_name` from your app directory.

affects: All versions when packaging for mobile

Upgrade

Version history

0.1.5latest on PyPI · released Mar 23, 2022

Audit

Dependencies

kivyrequiredKivy Garden provides extensions for the Kivy framework. Kivy is a mandatory dependency for using any Kivy Garden 'flower'.

Agent activity

22 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/kivy-garden/ ↗