diff options
author | CoprDistGit <infra@openeuler.org> | 2023-04-12 01:57:48 +0000 |
---|---|---|
committer | CoprDistGit <infra@openeuler.org> | 2023-04-12 01:57:48 +0000 |
commit | 5032d799a0e66e46b2103f35f4fd69e5f6585ff0 (patch) | |
tree | 17ab6852051f5bb01f519eb0a1e31c2cc98648db | |
parent | 8d32d3c71a99fc154348e6fb454e18c703fdfe9f (diff) |
automatic import of python-kivymd
-rw-r--r-- | .gitignore | 1 | ||||
-rw-r--r-- | python-kivymd.spec | 945 | ||||
-rw-r--r-- | sources | 1 |
3 files changed, 947 insertions, 0 deletions
@@ -0,0 +1 @@ +/kivymd-1.1.1.tar.gz diff --git a/python-kivymd.spec b/python-kivymd.spec new file mode 100644 index 0000000..0e4fcde --- /dev/null +++ b/python-kivymd.spec @@ -0,0 +1,945 @@ +%global _empty_manifest_terminate_build 0 +Name: python-kivymd +Version: 1.1.1 +Release: 1 +Summary: Set of widgets for Kivy inspired by Google's Material Design +License: MIT +URL: https://github.com/kivymd/KivyMD +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/35/55/d979644cdc9070a9611ab023db986aa0d540fc8f5fdd2c0f49eaef558751/kivymd-1.1.1.tar.gz +BuildArch: noarch + + +%description +# KivyMD [1.1.0](https://kivymd.readthedocs.io/en/latest/changelog/index.html) + +<img align="right" height="256" src="https://github.com/kivymd/internal/raw/main/logo/kivymd_logo_blue.png"/> + +KivyMD is a collection of Material Design compliant widgets for use with +[Kivy](http://kivy.org), a framework for cross-platform, touch-enabled +graphical applications. + +The project's goal is to approximate Google's +[Material Design spec](https://material.io/design/introduction/) as close as +possible without sacrificing ease of use. This library is a fork of the +[KivyMD project](https://gitlab.com/kivymd/KivyMD). We found the strength and +brought this project to a new level. + +Join the project! Just fork the project, branch out and submit a pull request +when your patch is ready. If any changes are necessary, we'll guide you through +the steps that need to be done via PR comments or access to your for may be +requested to outright submit them. + +If you wish to become a project developer (permission to create branches on the +project without forking for easier collaboration), have at least one PR +approved and ask for it. If you contribute regularly to the project the role +may be offered to you without asking too. + +[](https://pypi.org/project/kivymd) +[](#Installation) +[](https://pepy.tech/project/kivymd) +[](https://github.com/psf/black) + +[](https://discord.gg/wu3qBST) +[](https://twitter.com/KivyMD) +[](https://www.youtube.com/c/KivyMD) +[](https://habr.com/ru/users/kivymd/posts) +[](https://stackoverflow.com/tags/kivymd) +[](https://opencollective.com/kivymd) + +[](https://coveralls.io/github/kivymd/KivyMD) +[](https://github.com/kivymd/KivyMD/actions?query=workflow%3ABuild) +[](https://github.com/kivymd/KivyMD/actions?query=workflow%3ATest) +[](https://kivymd.readthedocs.io) +[](https://github.com/kivymd/KivyMD) + +## Installation + +```bash +pip install kivymd==1.1.0 +``` + +### Dependencies: + +- [Kivy](https://github.com/kivy/kivy) >= 2.0.0 ([Installation](https://kivy.org/doc/stable/gettingstarted/installation.html)) +- [Python 3.7+](https://www.python.org/) +- [Pillow](https://github.com/python-pillow/Pillow/) (for [MDColorPicker](https://kivymd.readthedocs.io/en/latest/components/colorpicker/) class) + +### How to install + +Command [above](#installation) will install latest release version of KivyMD from +[PyPI](https://pypi.org/project/kivymd). + +If you want to install development version from +[master](https://github.com/kivymd/KivyMD/tree/master/) +branch, you should specify link to zip archive: + +```bash +pip install https://github.com/kivymd/KivyMD/archive/master.zip +``` + +**_Tip_**: Replace `master.zip` with `<commit hash>.zip` (eg `51b8ef0.zip`) to +download KivyMD from specific commit. + +Also you can install manually from sources. Just clone the project and run pip: + +```bash +git clone https://github.com/kivymd/KivyMD.git --depth 1 +cd KivyMD +pip install . +``` + +**_Speed Tip_**: If you don't need full commit history (about 1.14 GiB), you can +use a shallow clone (`git clone https://github.com/kivymd/KivyMD.git --depth 1`) +to save time. If you need full commit history, then remove `--depth 1`. + +### How to use with [Buildozer](https://github.com/kivy/buildozer) + +```ini +requirements = kivy==2.1.0, kivymd==1.1.0, sdl2_ttf == 2.0.15, pillow +``` + +This will download latest release version of KivyMD from [PyPI](https://pypi.org/project/kivymd). + +If you want to use development version from [master](https://github.com/kivymd/KivyMD/tree/master/) +branch, you should specify link to zip archive: + +```ini +requirements = kivy==2.1.0, https://github.com/kivymd/KivyMD/archive/master.zip +``` + +Do not forget to run `buildozer android clean` or remove `.buildozer` directory +before building if version was updated (Buildozer doesn't update already +downloaded packages). + +#### On Linux + +- Use Buildozer [directly](https://github.com/kivy/buildozer#installing-buildozer-with-target-python-3-default) + or via [Docker](https://github.com/kivy/buildozer/blob/master/Dockerfile). + +#### On Windows 10 + +- Install [Ubuntu WSL](https://ubuntu.com/wsl) and follow [Linux steps](#On-Linux). + +#### On Windows without WSL + +- Install VirtualBox and follow steps from +[here](https://github.com/kivymd/KivyMD/blob/9b969f39d8bb03c73de105b82e66de3820020eb9/README.md#building-with-vm). + +#### Build automatically via GitHub Actions + +- Use [ArtemSBulgakov/buildozer-action@v1](https://github.com/ArtemSBulgakov/buildozer-action) + to build your packages automatically on push or pull request. +- See [full workflow example](https://github.com/ArtemSBulgakov/buildozer-action#full-workflow). + +### How to use with [kivy-ios](https://github.com/kivy/kivy-ios) + +```bash +toolchain build python3 kivy pillow +toolchain pip install --no-deps kivymd +``` + +## Documentation + +- See documentation at https://kivymd.readthedocs.io +- Wiki with examples of using KivyMD widgets: https://github.com/kivymd/KivyMD/wiki + +### Demos + +<p align="center"> + <a href="https://www.youtube.com/watch?v=4er9b6TH_TA"> + <img + width="600" + src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/preview-kitchen-sink.png" + title="Click to watch demo application of the KivyMD library widgets" + > + </a> +</p> + +[Kitchen sink](https://github.com/kivymd/KitchenSink) app demonstrates every KivyMD widget. +You can see how to use widget in code of app. + +### Comparison of Flutter & KivyMD + +| Sky View Concept | Healthy Food Delivery | +:-------------------------:|:-------------------------: +<a href="https://www.youtube.com/watch?v=xvi2D1c4mfQ"><img src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/preview-youtube-1.png" title="Click to watch it on YouTube"></a> | <a href="https://www.youtube.com/watch?v=P-ylDDm4TJM"><img src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/preview-youtube-2.png" title="Click to watch it on YouTube"></a> +| Asics Shoes Concept | Facebook Desktop Redesign | +<a href="https://www.youtube.com/watch?v=ehuXPgun0k0"><img src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/preview-youtue.png" title="Click to watch it on YouTube"></a> | <a href="https://www.youtube.com/watch?v=ZNBQib6Hk4s"><img src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/preview-youtue-3.png" title="Click to watch it on YouTube"></a> + +## Use MVC and Hot Reload + +<p align="center"> + <a href="https://www.youtube.com/watch?v=JLBrgoSSeTU&t"> + <img + img width="600" + src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/hot-reload-preview-youtube.png" + title='Click to watch video on YouTube' + > + </a> +</p> + +## Support + +If you need assistance or you have a question, you can ask for help on our mailing list: + +- **Discord server:** https://discord.gg/wu3qBST (English #support, Russian #ru-support) +- **StackOverflow tag:** [kivymd](https://stackoverflow.com/tags/kivymd) +- **Email:** kivydevelopment@gmail.com + +## Settings + +#### [Syntax highlighting and auto-completion for Kivy/KivyMD .kv files in PyCharm/Intellij IDEA](https://github.com/noembryo/KV4Jetbrains) + +## Promo Video + +<p align="center"> + <a href="https://www.youtube.com/watch?v=crt8wA4Q5eU"> + <img + img width="600" + src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/prevideo.png" + title='Click to watch video on YouTube' + > + </a> +</p> + +## Contributing + +We always welcome your [Bug reports](https://github.com/kivymd/KivyMD/issues/new?template=bug_report.md), +[Feature requests](https://github.com/kivymd/KivyMD/issues/new?template=feature_request.md) +and [Pull requests](https://github.com/kivymd/KivyMD/pulls)! +Check out [CONTRIBUTING.md](https://github.com/kivymd/.github/blob/master/.github/CONTRIBUTING.md) +and feel free to improve KivyMD. + +### Setup environment + +We recommend you to use PyCharm to work with KivyMD code. Install +[Kivy](https://kivy.org/doc/stable/gettingstarted/installation.html) and +development dependencies to your virtual environment: + +```bash +pip install -e .[dev,docs] +pre-commit install +``` + +Format all files and run tests: + +```bash +pre-commit run --all-files +pytest kivymd/tests --timeout=600 --cov=kivymd --cov-report=term +``` + +pre-commit will format modified files with Black and sort imports with isort. + +## Sister projects + +<img align="left" width="128" src="https://github.com/kivymd/internal/raw/main/logo/kivymd_extensions.png"/> + +## KivyMD Extensions + +Additional extensions for the KivyMD library. + +https://github.com/kivymd-extensions + +<img align="left" width="128" src="https://github.com/kivymd/internal/raw/main/logo/kivymdbuilder.png"/> + +## KivyMDBuilder + +Build apps visually. + +https://github.com/kivymd/KivyMDBuilder + + +## License + +- KivyMD is released under the terms of the + [MIT License](https://github.com/kivymd/KivyMD/blob/master/LICENSE), + same as [Kivy](https://github.com/kivy/kivy/blob/master/LICENSE). +- [Roboto font](https://fonts.google.com/specimen/Roboto) + is licensed and distributed under the terms of the + [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0). +- [Iconic font](https://github.com/Templarian/MaterialDesign-Webfont) by the + [Material Design Icons](https://materialdesignicons.com/) community covered by + [SIL Open Font License 1.1](http://scripts.sil.org/cms/scripts/page.php?item_id=OFL_web) + +## Contributors + +### KivyMD Team + +They spent a lot of time to improve KivyMD. + +- Yuri Ivanov [@HeaTTheatR](https://github.com/HeaTTheatR) - Core developer +- Artem Bulgakov [@ArtemSBulgakov](https://github.com/ArtemSBulgakov) - Technical administrator, contributor +- Andrés Rodríguez [@mixedCase](https://github.com/mixedCase) - First author of KivyMD project, contributor + +### Code Contributors + +This project exists thanks to all the people who contribute. +*[How to contribute](#Contributing)* + +<a href="https://github.com/kivymd/KivyMD/graphs/contributors"> + <img src="https://opencollective.com/kivymd/contributors.svg?width=890&button=false"/> +</a> + +### Financial Contributors + +[Become a financial contributor](https://opencollective.com/kivymd#section-contribute) +on OpenCollective and help us sustain our community. + +#### Gold Sponsors + +[Become a Gold Sponsor](https://opencollective.com/kivymd/contribute/gold-sponsor-16160) +and get your logo on our Readme with a link to your website. + +<!-- FIXME: sponsors are not displayed --> + +<a href="https://opencollective.com/peter-surda?requireActive=false" target="_blank"><img src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/gold-sponsor-1.png?requireActive=false"></a> + +#### Backers + +[Become a Backer](https://opencollective.com/kivymd/contribute/backer-16159) if you want to help develop this project. + +<a href="https://opencollective.com/kivymd#backers" target="_blank"> + <img src="https://opencollective.com/kivymd/backers.svg?width=890"> +</a> + + +%package -n python3-kivymd +Summary: Set of widgets for Kivy inspired by Google's Material Design +Provides: python-kivymd +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-kivymd +# KivyMD [1.1.0](https://kivymd.readthedocs.io/en/latest/changelog/index.html) + +<img align="right" height="256" src="https://github.com/kivymd/internal/raw/main/logo/kivymd_logo_blue.png"/> + +KivyMD is a collection of Material Design compliant widgets for use with +[Kivy](http://kivy.org), a framework for cross-platform, touch-enabled +graphical applications. + +The project's goal is to approximate Google's +[Material Design spec](https://material.io/design/introduction/) as close as +possible without sacrificing ease of use. This library is a fork of the +[KivyMD project](https://gitlab.com/kivymd/KivyMD). We found the strength and +brought this project to a new level. + +Join the project! Just fork the project, branch out and submit a pull request +when your patch is ready. If any changes are necessary, we'll guide you through +the steps that need to be done via PR comments or access to your for may be +requested to outright submit them. + +If you wish to become a project developer (permission to create branches on the +project without forking for easier collaboration), have at least one PR +approved and ask for it. If you contribute regularly to the project the role +may be offered to you without asking too. + +[](https://pypi.org/project/kivymd) +[](#Installation) +[](https://pepy.tech/project/kivymd) +[](https://github.com/psf/black) + +[](https://discord.gg/wu3qBST) +[](https://twitter.com/KivyMD) +[](https://www.youtube.com/c/KivyMD) +[](https://habr.com/ru/users/kivymd/posts) +[](https://stackoverflow.com/tags/kivymd) +[](https://opencollective.com/kivymd) + +[](https://coveralls.io/github/kivymd/KivyMD) +[](https://github.com/kivymd/KivyMD/actions?query=workflow%3ABuild) +[](https://github.com/kivymd/KivyMD/actions?query=workflow%3ATest) +[](https://kivymd.readthedocs.io) +[](https://github.com/kivymd/KivyMD) + +## Installation + +```bash +pip install kivymd==1.1.0 +``` + +### Dependencies: + +- [Kivy](https://github.com/kivy/kivy) >= 2.0.0 ([Installation](https://kivy.org/doc/stable/gettingstarted/installation.html)) +- [Python 3.7+](https://www.python.org/) +- [Pillow](https://github.com/python-pillow/Pillow/) (for [MDColorPicker](https://kivymd.readthedocs.io/en/latest/components/colorpicker/) class) + +### How to install + +Command [above](#installation) will install latest release version of KivyMD from +[PyPI](https://pypi.org/project/kivymd). + +If you want to install development version from +[master](https://github.com/kivymd/KivyMD/tree/master/) +branch, you should specify link to zip archive: + +```bash +pip install https://github.com/kivymd/KivyMD/archive/master.zip +``` + +**_Tip_**: Replace `master.zip` with `<commit hash>.zip` (eg `51b8ef0.zip`) to +download KivyMD from specific commit. + +Also you can install manually from sources. Just clone the project and run pip: + +```bash +git clone https://github.com/kivymd/KivyMD.git --depth 1 +cd KivyMD +pip install . +``` + +**_Speed Tip_**: If you don't need full commit history (about 1.14 GiB), you can +use a shallow clone (`git clone https://github.com/kivymd/KivyMD.git --depth 1`) +to save time. If you need full commit history, then remove `--depth 1`. + +### How to use with [Buildozer](https://github.com/kivy/buildozer) + +```ini +requirements = kivy==2.1.0, kivymd==1.1.0, sdl2_ttf == 2.0.15, pillow +``` + +This will download latest release version of KivyMD from [PyPI](https://pypi.org/project/kivymd). + +If you want to use development version from [master](https://github.com/kivymd/KivyMD/tree/master/) +branch, you should specify link to zip archive: + +```ini +requirements = kivy==2.1.0, https://github.com/kivymd/KivyMD/archive/master.zip +``` + +Do not forget to run `buildozer android clean` or remove `.buildozer` directory +before building if version was updated (Buildozer doesn't update already +downloaded packages). + +#### On Linux + +- Use Buildozer [directly](https://github.com/kivy/buildozer#installing-buildozer-with-target-python-3-default) + or via [Docker](https://github.com/kivy/buildozer/blob/master/Dockerfile). + +#### On Windows 10 + +- Install [Ubuntu WSL](https://ubuntu.com/wsl) and follow [Linux steps](#On-Linux). + +#### On Windows without WSL + +- Install VirtualBox and follow steps from +[here](https://github.com/kivymd/KivyMD/blob/9b969f39d8bb03c73de105b82e66de3820020eb9/README.md#building-with-vm). + +#### Build automatically via GitHub Actions + +- Use [ArtemSBulgakov/buildozer-action@v1](https://github.com/ArtemSBulgakov/buildozer-action) + to build your packages automatically on push or pull request. +- See [full workflow example](https://github.com/ArtemSBulgakov/buildozer-action#full-workflow). + +### How to use with [kivy-ios](https://github.com/kivy/kivy-ios) + +```bash +toolchain build python3 kivy pillow +toolchain pip install --no-deps kivymd +``` + +## Documentation + +- See documentation at https://kivymd.readthedocs.io +- Wiki with examples of using KivyMD widgets: https://github.com/kivymd/KivyMD/wiki + +### Demos + +<p align="center"> + <a href="https://www.youtube.com/watch?v=4er9b6TH_TA"> + <img + width="600" + src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/preview-kitchen-sink.png" + title="Click to watch demo application of the KivyMD library widgets" + > + </a> +</p> + +[Kitchen sink](https://github.com/kivymd/KitchenSink) app demonstrates every KivyMD widget. +You can see how to use widget in code of app. + +### Comparison of Flutter & KivyMD + +| Sky View Concept | Healthy Food Delivery | +:-------------------------:|:-------------------------: +<a href="https://www.youtube.com/watch?v=xvi2D1c4mfQ"><img src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/preview-youtube-1.png" title="Click to watch it on YouTube"></a> | <a href="https://www.youtube.com/watch?v=P-ylDDm4TJM"><img src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/preview-youtube-2.png" title="Click to watch it on YouTube"></a> +| Asics Shoes Concept | Facebook Desktop Redesign | +<a href="https://www.youtube.com/watch?v=ehuXPgun0k0"><img src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/preview-youtue.png" title="Click to watch it on YouTube"></a> | <a href="https://www.youtube.com/watch?v=ZNBQib6Hk4s"><img src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/preview-youtue-3.png" title="Click to watch it on YouTube"></a> + +## Use MVC and Hot Reload + +<p align="center"> + <a href="https://www.youtube.com/watch?v=JLBrgoSSeTU&t"> + <img + img width="600" + src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/hot-reload-preview-youtube.png" + title='Click to watch video on YouTube' + > + </a> +</p> + +## Support + +If you need assistance or you have a question, you can ask for help on our mailing list: + +- **Discord server:** https://discord.gg/wu3qBST (English #support, Russian #ru-support) +- **StackOverflow tag:** [kivymd](https://stackoverflow.com/tags/kivymd) +- **Email:** kivydevelopment@gmail.com + +## Settings + +#### [Syntax highlighting and auto-completion for Kivy/KivyMD .kv files in PyCharm/Intellij IDEA](https://github.com/noembryo/KV4Jetbrains) + +## Promo Video + +<p align="center"> + <a href="https://www.youtube.com/watch?v=crt8wA4Q5eU"> + <img + img width="600" + src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/prevideo.png" + title='Click to watch video on YouTube' + > + </a> +</p> + +## Contributing + +We always welcome your [Bug reports](https://github.com/kivymd/KivyMD/issues/new?template=bug_report.md), +[Feature requests](https://github.com/kivymd/KivyMD/issues/new?template=feature_request.md) +and [Pull requests](https://github.com/kivymd/KivyMD/pulls)! +Check out [CONTRIBUTING.md](https://github.com/kivymd/.github/blob/master/.github/CONTRIBUTING.md) +and feel free to improve KivyMD. + +### Setup environment + +We recommend you to use PyCharm to work with KivyMD code. Install +[Kivy](https://kivy.org/doc/stable/gettingstarted/installation.html) and +development dependencies to your virtual environment: + +```bash +pip install -e .[dev,docs] +pre-commit install +``` + +Format all files and run tests: + +```bash +pre-commit run --all-files +pytest kivymd/tests --timeout=600 --cov=kivymd --cov-report=term +``` + +pre-commit will format modified files with Black and sort imports with isort. + +## Sister projects + +<img align="left" width="128" src="https://github.com/kivymd/internal/raw/main/logo/kivymd_extensions.png"/> + +## KivyMD Extensions + +Additional extensions for the KivyMD library. + +https://github.com/kivymd-extensions + +<img align="left" width="128" src="https://github.com/kivymd/internal/raw/main/logo/kivymdbuilder.png"/> + +## KivyMDBuilder + +Build apps visually. + +https://github.com/kivymd/KivyMDBuilder + + +## License + +- KivyMD is released under the terms of the + [MIT License](https://github.com/kivymd/KivyMD/blob/master/LICENSE), + same as [Kivy](https://github.com/kivy/kivy/blob/master/LICENSE). +- [Roboto font](https://fonts.google.com/specimen/Roboto) + is licensed and distributed under the terms of the + [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0). +- [Iconic font](https://github.com/Templarian/MaterialDesign-Webfont) by the + [Material Design Icons](https://materialdesignicons.com/) community covered by + [SIL Open Font License 1.1](http://scripts.sil.org/cms/scripts/page.php?item_id=OFL_web) + +## Contributors + +### KivyMD Team + +They spent a lot of time to improve KivyMD. + +- Yuri Ivanov [@HeaTTheatR](https://github.com/HeaTTheatR) - Core developer +- Artem Bulgakov [@ArtemSBulgakov](https://github.com/ArtemSBulgakov) - Technical administrator, contributor +- Andrés Rodríguez [@mixedCase](https://github.com/mixedCase) - First author of KivyMD project, contributor + +### Code Contributors + +This project exists thanks to all the people who contribute. +*[How to contribute](#Contributing)* + +<a href="https://github.com/kivymd/KivyMD/graphs/contributors"> + <img src="https://opencollective.com/kivymd/contributors.svg?width=890&button=false"/> +</a> + +### Financial Contributors + +[Become a financial contributor](https://opencollective.com/kivymd#section-contribute) +on OpenCollective and help us sustain our community. + +#### Gold Sponsors + +[Become a Gold Sponsor](https://opencollective.com/kivymd/contribute/gold-sponsor-16160) +and get your logo on our Readme with a link to your website. + +<!-- FIXME: sponsors are not displayed --> + +<a href="https://opencollective.com/peter-surda?requireActive=false" target="_blank"><img src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/gold-sponsor-1.png?requireActive=false"></a> + +#### Backers + +[Become a Backer](https://opencollective.com/kivymd/contribute/backer-16159) if you want to help develop this project. + +<a href="https://opencollective.com/kivymd#backers" target="_blank"> + <img src="https://opencollective.com/kivymd/backers.svg?width=890"> +</a> + + +%package help +Summary: Development documents and examples for kivymd +Provides: python3-kivymd-doc +%description help +# KivyMD [1.1.0](https://kivymd.readthedocs.io/en/latest/changelog/index.html) + +<img align="right" height="256" src="https://github.com/kivymd/internal/raw/main/logo/kivymd_logo_blue.png"/> + +KivyMD is a collection of Material Design compliant widgets for use with +[Kivy](http://kivy.org), a framework for cross-platform, touch-enabled +graphical applications. + +The project's goal is to approximate Google's +[Material Design spec](https://material.io/design/introduction/) as close as +possible without sacrificing ease of use. This library is a fork of the +[KivyMD project](https://gitlab.com/kivymd/KivyMD). We found the strength and +brought this project to a new level. + +Join the project! Just fork the project, branch out and submit a pull request +when your patch is ready. If any changes are necessary, we'll guide you through +the steps that need to be done via PR comments or access to your for may be +requested to outright submit them. + +If you wish to become a project developer (permission to create branches on the +project without forking for easier collaboration), have at least one PR +approved and ask for it. If you contribute regularly to the project the role +may be offered to you without asking too. + +[](https://pypi.org/project/kivymd) +[](#Installation) +[](https://pepy.tech/project/kivymd) +[](https://github.com/psf/black) + +[](https://discord.gg/wu3qBST) +[](https://twitter.com/KivyMD) +[](https://www.youtube.com/c/KivyMD) +[](https://habr.com/ru/users/kivymd/posts) +[](https://stackoverflow.com/tags/kivymd) +[](https://opencollective.com/kivymd) + +[](https://coveralls.io/github/kivymd/KivyMD) +[](https://github.com/kivymd/KivyMD/actions?query=workflow%3ABuild) +[](https://github.com/kivymd/KivyMD/actions?query=workflow%3ATest) +[](https://kivymd.readthedocs.io) +[](https://github.com/kivymd/KivyMD) + +## Installation + +```bash +pip install kivymd==1.1.0 +``` + +### Dependencies: + +- [Kivy](https://github.com/kivy/kivy) >= 2.0.0 ([Installation](https://kivy.org/doc/stable/gettingstarted/installation.html)) +- [Python 3.7+](https://www.python.org/) +- [Pillow](https://github.com/python-pillow/Pillow/) (for [MDColorPicker](https://kivymd.readthedocs.io/en/latest/components/colorpicker/) class) + +### How to install + +Command [above](#installation) will install latest release version of KivyMD from +[PyPI](https://pypi.org/project/kivymd). + +If you want to install development version from +[master](https://github.com/kivymd/KivyMD/tree/master/) +branch, you should specify link to zip archive: + +```bash +pip install https://github.com/kivymd/KivyMD/archive/master.zip +``` + +**_Tip_**: Replace `master.zip` with `<commit hash>.zip` (eg `51b8ef0.zip`) to +download KivyMD from specific commit. + +Also you can install manually from sources. Just clone the project and run pip: + +```bash +git clone https://github.com/kivymd/KivyMD.git --depth 1 +cd KivyMD +pip install . +``` + +**_Speed Tip_**: If you don't need full commit history (about 1.14 GiB), you can +use a shallow clone (`git clone https://github.com/kivymd/KivyMD.git --depth 1`) +to save time. If you need full commit history, then remove `--depth 1`. + +### How to use with [Buildozer](https://github.com/kivy/buildozer) + +```ini +requirements = kivy==2.1.0, kivymd==1.1.0, sdl2_ttf == 2.0.15, pillow +``` + +This will download latest release version of KivyMD from [PyPI](https://pypi.org/project/kivymd). + +If you want to use development version from [master](https://github.com/kivymd/KivyMD/tree/master/) +branch, you should specify link to zip archive: + +```ini +requirements = kivy==2.1.0, https://github.com/kivymd/KivyMD/archive/master.zip +``` + +Do not forget to run `buildozer android clean` or remove `.buildozer` directory +before building if version was updated (Buildozer doesn't update already +downloaded packages). + +#### On Linux + +- Use Buildozer [directly](https://github.com/kivy/buildozer#installing-buildozer-with-target-python-3-default) + or via [Docker](https://github.com/kivy/buildozer/blob/master/Dockerfile). + +#### On Windows 10 + +- Install [Ubuntu WSL](https://ubuntu.com/wsl) and follow [Linux steps](#On-Linux). + +#### On Windows without WSL + +- Install VirtualBox and follow steps from +[here](https://github.com/kivymd/KivyMD/blob/9b969f39d8bb03c73de105b82e66de3820020eb9/README.md#building-with-vm). + +#### Build automatically via GitHub Actions + +- Use [ArtemSBulgakov/buildozer-action@v1](https://github.com/ArtemSBulgakov/buildozer-action) + to build your packages automatically on push or pull request. +- See [full workflow example](https://github.com/ArtemSBulgakov/buildozer-action#full-workflow). + +### How to use with [kivy-ios](https://github.com/kivy/kivy-ios) + +```bash +toolchain build python3 kivy pillow +toolchain pip install --no-deps kivymd +``` + +## Documentation + +- See documentation at https://kivymd.readthedocs.io +- Wiki with examples of using KivyMD widgets: https://github.com/kivymd/KivyMD/wiki + +### Demos + +<p align="center"> + <a href="https://www.youtube.com/watch?v=4er9b6TH_TA"> + <img + width="600" + src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/preview-kitchen-sink.png" + title="Click to watch demo application of the KivyMD library widgets" + > + </a> +</p> + +[Kitchen sink](https://github.com/kivymd/KitchenSink) app demonstrates every KivyMD widget. +You can see how to use widget in code of app. + +### Comparison of Flutter & KivyMD + +| Sky View Concept | Healthy Food Delivery | +:-------------------------:|:-------------------------: +<a href="https://www.youtube.com/watch?v=xvi2D1c4mfQ"><img src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/preview-youtube-1.png" title="Click to watch it on YouTube"></a> | <a href="https://www.youtube.com/watch?v=P-ylDDm4TJM"><img src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/preview-youtube-2.png" title="Click to watch it on YouTube"></a> +| Asics Shoes Concept | Facebook Desktop Redesign | +<a href="https://www.youtube.com/watch?v=ehuXPgun0k0"><img src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/preview-youtue.png" title="Click to watch it on YouTube"></a> | <a href="https://www.youtube.com/watch?v=ZNBQib6Hk4s"><img src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/preview-youtue-3.png" title="Click to watch it on YouTube"></a> + +## Use MVC and Hot Reload + +<p align="center"> + <a href="https://www.youtube.com/watch?v=JLBrgoSSeTU&t"> + <img + img width="600" + src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/hot-reload-preview-youtube.png" + title='Click to watch video on YouTube' + > + </a> +</p> + +## Support + +If you need assistance or you have a question, you can ask for help on our mailing list: + +- **Discord server:** https://discord.gg/wu3qBST (English #support, Russian #ru-support) +- **StackOverflow tag:** [kivymd](https://stackoverflow.com/tags/kivymd) +- **Email:** kivydevelopment@gmail.com + +## Settings + +#### [Syntax highlighting and auto-completion for Kivy/KivyMD .kv files in PyCharm/Intellij IDEA](https://github.com/noembryo/KV4Jetbrains) + +## Promo Video + +<p align="center"> + <a href="https://www.youtube.com/watch?v=crt8wA4Q5eU"> + <img + img width="600" + src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/prevideo.png" + title='Click to watch video on YouTube' + > + </a> +</p> + +## Contributing + +We always welcome your [Bug reports](https://github.com/kivymd/KivyMD/issues/new?template=bug_report.md), +[Feature requests](https://github.com/kivymd/KivyMD/issues/new?template=feature_request.md) +and [Pull requests](https://github.com/kivymd/KivyMD/pulls)! +Check out [CONTRIBUTING.md](https://github.com/kivymd/.github/blob/master/.github/CONTRIBUTING.md) +and feel free to improve KivyMD. + +### Setup environment + +We recommend you to use PyCharm to work with KivyMD code. Install +[Kivy](https://kivy.org/doc/stable/gettingstarted/installation.html) and +development dependencies to your virtual environment: + +```bash +pip install -e .[dev,docs] +pre-commit install +``` + +Format all files and run tests: + +```bash +pre-commit run --all-files +pytest kivymd/tests --timeout=600 --cov=kivymd --cov-report=term +``` + +pre-commit will format modified files with Black and sort imports with isort. + +## Sister projects + +<img align="left" width="128" src="https://github.com/kivymd/internal/raw/main/logo/kivymd_extensions.png"/> + +## KivyMD Extensions + +Additional extensions for the KivyMD library. + +https://github.com/kivymd-extensions + +<img align="left" width="128" src="https://github.com/kivymd/internal/raw/main/logo/kivymdbuilder.png"/> + +## KivyMDBuilder + +Build apps visually. + +https://github.com/kivymd/KivyMDBuilder + + +## License + +- KivyMD is released under the terms of the + [MIT License](https://github.com/kivymd/KivyMD/blob/master/LICENSE), + same as [Kivy](https://github.com/kivy/kivy/blob/master/LICENSE). +- [Roboto font](https://fonts.google.com/specimen/Roboto) + is licensed and distributed under the terms of the + [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0). +- [Iconic font](https://github.com/Templarian/MaterialDesign-Webfont) by the + [Material Design Icons](https://materialdesignicons.com/) community covered by + [SIL Open Font License 1.1](http://scripts.sil.org/cms/scripts/page.php?item_id=OFL_web) + +## Contributors + +### KivyMD Team + +They spent a lot of time to improve KivyMD. + +- Yuri Ivanov [@HeaTTheatR](https://github.com/HeaTTheatR) - Core developer +- Artem Bulgakov [@ArtemSBulgakov](https://github.com/ArtemSBulgakov) - Technical administrator, contributor +- Andrés Rodríguez [@mixedCase](https://github.com/mixedCase) - First author of KivyMD project, contributor + +### Code Contributors + +This project exists thanks to all the people who contribute. +*[How to contribute](#Contributing)* + +<a href="https://github.com/kivymd/KivyMD/graphs/contributors"> + <img src="https://opencollective.com/kivymd/contributors.svg?width=890&button=false"/> +</a> + +### Financial Contributors + +[Become a financial contributor](https://opencollective.com/kivymd#section-contribute) +on OpenCollective and help us sustain our community. + +#### Gold Sponsors + +[Become a Gold Sponsor](https://opencollective.com/kivymd/contribute/gold-sponsor-16160) +and get your logo on our Readme with a link to your website. + +<!-- FIXME: sponsors are not displayed --> + +<a href="https://opencollective.com/peter-surda?requireActive=false" target="_blank"><img src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/gold-sponsor-1.png?requireActive=false"></a> + +#### Backers + +[Become a Backer](https://opencollective.com/kivymd/contribute/backer-16159) if you want to help develop this project. + +<a href="https://opencollective.com/kivymd#backers" target="_blank"> + <img src="https://opencollective.com/kivymd/backers.svg?width=890"> +</a> + + +%prep +%autosetup -n kivymd-1.1.1 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-kivymd -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Wed Apr 12 2023 Python_Bot <Python_Bot@openeuler.org> - 1.1.1-1 +- Package Spec generated @@ -0,0 +1 @@ +d86c15615fd1f49253cbcbe9c21ea65d kivymd-1.1.1.tar.gz |