From 5032d799a0e66e46b2103f35f4fd69e5f6585ff0 Mon Sep 17 00:00:00 2001 From: CoprDistGit Date: Wed, 12 Apr 2023 01:57:48 +0000 Subject: automatic import of python-kivymd --- python-kivymd.spec | 945 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 945 insertions(+) create mode 100644 python-kivymd.spec (limited to 'python-kivymd.spec') 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) + + + +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. + +[![PyPI version](https://img.shields.io/pypi/v/kivymd.svg)](https://pypi.org/project/kivymd) +[![Supported Python versions](https://img.shields.io/pypi/pyversions/kivymd.svg)](#Installation) +[![Downloads](https://pepy.tech/badge/kivymd)](https://pepy.tech/project/kivymd) +[![Code style: Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) + +[![Discord](https://img.shields.io/discord/566880874789076992?logo=discord)](https://discord.gg/wu3qBST) +[![Twitter](https://img.shields.io/twitter/follow/KivyMD?label=follow&logo=twitter&style=flat&color=brightgreen)](https://twitter.com/KivyMD) +[![YouTube](https://img.shields.io/static/v1?label=subscribe&logo=youtube&logoColor=ff0000&color=brightgreen&message=4.2k)](https://www.youtube.com/c/KivyMD) +[![Habr](https://img.shields.io/static/v1?label=habr&message=ru&logo=habr&color=brightgreen)](https://habr.com/ru/users/kivymd/posts) +[![StackOverflow](https://img.shields.io/static/v1?label=stackoverflow%20tag&logo=stackoverflow&logoColor=fe7a16&color=brightgreen&message=kivymd)](https://stackoverflow.com/tags/kivymd) +[![Open Collective](https://img.shields.io/opencollective/all/kivymd?label=financial%20contributors&logo=open-collective)](https://opencollective.com/kivymd) + +[![Coverage status](https://coveralls.io/repos/github/kivymd/KivyMD/badge.svg)](https://coveralls.io/github/kivymd/KivyMD) +[![Build workflow](https://github.com/kivymd/KivyMD/workflows/Build/badge.svg?branch=master)](https://github.com/kivymd/KivyMD/actions?query=workflow%3ABuild) +[![Test workflow](https://github.com/kivymd/KivyMD/workflows/Test/badge.svg?branch=master)](https://github.com/kivymd/KivyMD/actions?query=workflow%3ATest) +[![Documentation status](https://readthedocs.org/projects/kivymd/badge/?version=latest)](https://kivymd.readthedocs.io) +[![Repository size](https://img.shields.io/github/repo-size/kivymd/kivymd.svg)](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 `.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 + +

+ + + +

+ +[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 | +:-------------------------:|:-------------------------: + | +| Asics Shoes Concept | Facebook Desktop Redesign | + | + +## Use MVC and Hot Reload + +

+ + + +

+ +## 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 + +

+ + + +

+ +## 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 + + + +## KivyMD Extensions + +Additional extensions for the KivyMD library. + +https://github.com/kivymd-extensions + + + +## 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)* + + + + + +### 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. + + + + + +#### Backers + +[Become a Backer](https://opencollective.com/kivymd/contribute/backer-16159) if you want to help develop this project. + + + + + + +%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) + + + +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. + +[![PyPI version](https://img.shields.io/pypi/v/kivymd.svg)](https://pypi.org/project/kivymd) +[![Supported Python versions](https://img.shields.io/pypi/pyversions/kivymd.svg)](#Installation) +[![Downloads](https://pepy.tech/badge/kivymd)](https://pepy.tech/project/kivymd) +[![Code style: Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) + +[![Discord](https://img.shields.io/discord/566880874789076992?logo=discord)](https://discord.gg/wu3qBST) +[![Twitter](https://img.shields.io/twitter/follow/KivyMD?label=follow&logo=twitter&style=flat&color=brightgreen)](https://twitter.com/KivyMD) +[![YouTube](https://img.shields.io/static/v1?label=subscribe&logo=youtube&logoColor=ff0000&color=brightgreen&message=4.2k)](https://www.youtube.com/c/KivyMD) +[![Habr](https://img.shields.io/static/v1?label=habr&message=ru&logo=habr&color=brightgreen)](https://habr.com/ru/users/kivymd/posts) +[![StackOverflow](https://img.shields.io/static/v1?label=stackoverflow%20tag&logo=stackoverflow&logoColor=fe7a16&color=brightgreen&message=kivymd)](https://stackoverflow.com/tags/kivymd) +[![Open Collective](https://img.shields.io/opencollective/all/kivymd?label=financial%20contributors&logo=open-collective)](https://opencollective.com/kivymd) + +[![Coverage status](https://coveralls.io/repos/github/kivymd/KivyMD/badge.svg)](https://coveralls.io/github/kivymd/KivyMD) +[![Build workflow](https://github.com/kivymd/KivyMD/workflows/Build/badge.svg?branch=master)](https://github.com/kivymd/KivyMD/actions?query=workflow%3ABuild) +[![Test workflow](https://github.com/kivymd/KivyMD/workflows/Test/badge.svg?branch=master)](https://github.com/kivymd/KivyMD/actions?query=workflow%3ATest) +[![Documentation status](https://readthedocs.org/projects/kivymd/badge/?version=latest)](https://kivymd.readthedocs.io) +[![Repository size](https://img.shields.io/github/repo-size/kivymd/kivymd.svg)](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 `.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 + +

+ + + +

+ +[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 | +:-------------------------:|:-------------------------: + | +| Asics Shoes Concept | Facebook Desktop Redesign | + | + +## Use MVC and Hot Reload + +

+ + + +

+ +## 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 + +

+ + + +

+ +## 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 + + + +## KivyMD Extensions + +Additional extensions for the KivyMD library. + +https://github.com/kivymd-extensions + + + +## 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)* + + + + + +### 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. + + + + + +#### Backers + +[Become a Backer](https://opencollective.com/kivymd/contribute/backer-16159) if you want to help develop this project. + + + + + + +%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) + + + +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. + +[![PyPI version](https://img.shields.io/pypi/v/kivymd.svg)](https://pypi.org/project/kivymd) +[![Supported Python versions](https://img.shields.io/pypi/pyversions/kivymd.svg)](#Installation) +[![Downloads](https://pepy.tech/badge/kivymd)](https://pepy.tech/project/kivymd) +[![Code style: Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) + +[![Discord](https://img.shields.io/discord/566880874789076992?logo=discord)](https://discord.gg/wu3qBST) +[![Twitter](https://img.shields.io/twitter/follow/KivyMD?label=follow&logo=twitter&style=flat&color=brightgreen)](https://twitter.com/KivyMD) +[![YouTube](https://img.shields.io/static/v1?label=subscribe&logo=youtube&logoColor=ff0000&color=brightgreen&message=4.2k)](https://www.youtube.com/c/KivyMD) +[![Habr](https://img.shields.io/static/v1?label=habr&message=ru&logo=habr&color=brightgreen)](https://habr.com/ru/users/kivymd/posts) +[![StackOverflow](https://img.shields.io/static/v1?label=stackoverflow%20tag&logo=stackoverflow&logoColor=fe7a16&color=brightgreen&message=kivymd)](https://stackoverflow.com/tags/kivymd) +[![Open Collective](https://img.shields.io/opencollective/all/kivymd?label=financial%20contributors&logo=open-collective)](https://opencollective.com/kivymd) + +[![Coverage status](https://coveralls.io/repos/github/kivymd/KivyMD/badge.svg)](https://coveralls.io/github/kivymd/KivyMD) +[![Build workflow](https://github.com/kivymd/KivyMD/workflows/Build/badge.svg?branch=master)](https://github.com/kivymd/KivyMD/actions?query=workflow%3ABuild) +[![Test workflow](https://github.com/kivymd/KivyMD/workflows/Test/badge.svg?branch=master)](https://github.com/kivymd/KivyMD/actions?query=workflow%3ATest) +[![Documentation status](https://readthedocs.org/projects/kivymd/badge/?version=latest)](https://kivymd.readthedocs.io) +[![Repository size](https://img.shields.io/github/repo-size/kivymd/kivymd.svg)](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 `.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 + +

+ + + +

+ +[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 | +:-------------------------:|:-------------------------: + | +| Asics Shoes Concept | Facebook Desktop Redesign | + | + +## Use MVC and Hot Reload + +

+ + + +

+ +## 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 + +

+ + + +

+ +## 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 + + + +## KivyMD Extensions + +Additional extensions for the KivyMD library. + +https://github.com/kivymd-extensions + + + +## 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)* + + + + + +### 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. + + + + + +#### Backers + +[Become a Backer](https://opencollective.com/kivymd/contribute/backer-16159) if you want to help develop this project. + + + + + + +%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 - 1.1.1-1 +- Package Spec generated -- cgit v1.2.3