| Name | kvdeveloper JSON |
| Version |
2024.1.7
JSON |
| download |
| home_page | None |
| Summary | KvDeveloper is a PyPI module designed to streamline the development of Kivy and KivyMD applications. Inspired by Expo CLI for React Native, KvDeveloper provides starter templates and essential functionalities to kickstart your projects with ease. |
| upload_time | 2024-10-31 11:07:24 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | MIT License Copyright (c) 2024 Kartavya Shukla Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
kivy
kivymd
open source
kvdeveloper
kartavya shukla
novfensec
kv
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# KvDeveloper
```csharp
_ __ ____ _
| |/ /_ _| _ \ _____ _____| | ___ _ __ ___ _ __
| ' /\ \ / / | | |/ _ \ \ / / _ \ |/ _ \| '_ \ / _ \ '__|
| . \ \ V /| |_| | __/\ V / __/ | (_) | |_) | __/ |
|_|\_\ \_/ |____/ \___| \_/ \___|_|\___/| .__/ \___|_|
|_|
```
[](https://pypi.org/project/kvdeveloper)
[](#Installation)
[](https://pepy.tech/project/kvdeveloper)
[](https://github.com/psf/black)
[](https://github.com/Novfensec/KvDeveloper/stargazers)
[](https://github.com/Novfensec/KvDeveloper/network)
[](https://github.com/Novfensec/KvDeveloper)
[](https://github.com/Novfensec/KvDeveloper/issues)
<img src="https://raw.githubusercontent.com/Novfensec/KvDeveloper/main/kvdeveloper/assets/image_library/kvdeveloper/kvdeveloper_logo256.png" height="178" align="right" padding="11"/>
<p>KvDeveloper is a PyPI module designed to streamline the development of Kivy and KivyMD applications. Inspired by Expo CLI for React Native, it offers starter templates and essential functionalities to kickstart your projects with ease. With features like predefined templates, MVC architecture support, and customizable options, KvDeveloper simplifies creating robust and organized Kivy projects. It supports Python 3.1+, Kivy 2.2.0+, and KivyMD 1.1.1+, making it a versatile tool for developers looking to enhance their Kivy development workflow.</p>
## Community and Support
[](https://discord.com/invite/U9bfkD6A4c)
[](https://stackoverflow.com/users/16486510/novfensec)
[](https://reddit.com/r/KvDeveloper)
[](https://github.com/Novfensec/KvDeveloper/discussions)
[](https://youtube.com/@NovfensecInc)
[](https://youtube.com/@KvDeveloper)
Join the KvDeveloper community to get support, share your projects, and collaborate with other developers. Here are some ways you can connect with us:
- **Discord**: Join our [KvDeveloper Community Server](https://discord.com/invite/U9bfkD6A4c).
- **Stack Overflow**: Feel free to reach out on our [Stack Overflow](https://stackoverflow.com/users/16486510/novfensec).
- **Reddit - KvDeveloper**: Feel free to join our [Reddit Community](https://reddit.com/r/KvDeveloper).
- **GitHub Discussions**: Participate in discussions and ask questions in the [GitHub Discussions](https://github.com/Novfensec/KvDeveloper/discussions) section.
- **Youtube - Admin**: Follow [@NovfensecInc](https://youtube.com/@NovfensecInc) to learn by building futuristic projects.
- **YouTube - KvDeveloper**: Follow us on YouTube [@KvDeveloper](https://youtube.com/@KvDeveloper) for updates and announcements.
[Documentation](https://novfensec.github.io/KvDeveloper.docs): Read the documentation.
If you encounter any issues or have questions, feel free to reach out to the community or submit an issue on GitHub.
## Features
- **Starter Templates**: Quickly create new Kivy and KivyMD projects with predefined templates.
- **Layouts**: Build standard screens rapidly with prebuilt designs. Add layouts to any screen with a single command, making the development process faster and more efficient.
- **MVC Structure**: Includes templates with Model-View-Controller (MVC) architecture. `(recommended KivyMD==1.1.1)`
- **Navigation and Toolbar**: Templates with built-in navigation and toolbar screens.
- **Customizable**: Easily extend and customize the templates and layouts to fit your project needs.
- **Build Workflows and Jupyter Notebooks**: Generates build workflows for github based conversions and jupyter notebooks for colab based converions.
## Installation
- Install KvDeveloper using pip:
```bash
pip install kvdeveloper
```
- Install development version using pip `(requires git installation)`:
```bash
pip install git+https://github.com/Novfensec/KvDeveloper.git@main
```
## Requirements
- **Python**>=3.9
- kivy>=2.0.0 `(recommended kivy==2.3.0)`
- kivymd>=2.0.0 `(recommended kivymd==2.0.1.dev0)`
- pillow>=10.0.0
- typer>=0.12.3
- rich>=13.7.1
- markdown2>=2.5.0
- pyqt5
- pyqtwebengine
## Usage
- Create a new KivyMD project with a blank template:
```bash
kvdeveloper create TestProject --template blank
```
- Create a new KivyMD project with navigation and toolbar with MVC architecture.:
```bash
kvdeveloper create TestProject --template nav_toolbar --structure MVC
```
- Add a screen with a specific layout (e.g., Auth type 1):
```bash
kvdeveloper add-screen TestScreen --layout auth1
```
- Add a layout to an existing screen (e.g., Home type 1):
```bash
kvdeveloper add-layout home1 --name_screen TestScreen Test1Screen
```
- Add bootstrap like customizable components to the project directly:
```bash
kvdeveloper add-component Container ResponsiveGrid ITDCard
```
- Register all custom fonts and components to Kivy bases:
```bash
kvdeveloper register
```
- Get info about the template used for the project:
```bash
kvdeveloper show-readme TestProject
```
- Generate github buildozer workflows for android conversion:
```bash
kvdeveloper config-build-setup android --external github
```
Sample Repository: [Sample-KivyMD-App](https://github.com/Novfensec/SAMPLE-KIVYMD-APP)
- Generate jupyter notebook for colab based android conversion [`Contains commands to import your app folder from your personal drive!`]:
```bash
kvdeveloper config-build-setup android --external colab
```
## Templates
- **Blank Template**: A minimal template with the basic structure.
- **Navigation Toolbar Template**: A template with navigation and toolbar screens.
<p align="center">
<img
width="800" src="https://raw.githubusercontent.com/Novfensec/KvDeveloper/main/kvdeveloper/assets/image_library/kvdeveloper/nav_toolbar.png" style="border-radius:1em"
title="kvdeveloper create MyApp --template nav_toolbar"
/>
</p>
- **Navigation Dock Template**: A template navigation and toolbar screens with BottomNavigation, HomeScreen, LoginScreen and SettingsScreen components.
<p align="center">
<img
width="800" src="https://raw.githubusercontent.com/Novfensec/KvDeveloper/main/kvdeveloper/assets/image_library/kvdeveloper/nav_dock.png" style="border-radius:1em"
title="kvdeveloper create MyApp --template nav_dock"
/>
</p>
- **MVC Architecture**: A template add-on following the MVC architecture.
## Components
Create customizable bootstrap like components directly in your project.
- **Container**: A responsive container with pre-defined padding calculations.
- **ResponsiveGrid**: A responsive grid with pre-defined column calculations.
- **ITDCard (Image Title Description Card)**: A responsive boostrap like card with image aspect-ratio calculations.
## Contributing
We welcome contributions from the community! If you're interested in contributing to KvDeveloper or its documentation, please read our [Contributing Guidelines](https://github.com/Novfensec/KvDeveloper/blob/main/CONTRIBUTING.md).
You can contribute by:
- Reporting bugs or suggesting features in the [Issues](https://github.com/Novfensec/KvDeveloper/issues) section.
- Submitting pull requests to improve the documentation or the KvDeveloper tool.
- Helping with translations or writing new guides.
For more detailed instructions, please visit our [Contributing](https://github.com/Novfensec/KvDeveloper/blob/main/CONTRIBUTING.md) page.
## Acknowledgements
[Kivy](https://github.com/kivy)
[KivyMD](https://github.com/kivymd)
## License
KvDeveloper is released under the [MIT License](https://github.com/Novfensec/KvDeveloper/blob/main/LICENSE). You're free to use, modify, and distribute this software as long as you adhere to the terms of the license.
## Contact
For any inquiries, please contact us at [novfensec@protonmail.com](mailto:novfensec@protonmail.com).
Raw data
{
"_id": null,
"home_page": null,
"name": "kvdeveloper",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "Kartavya Shukla <novfensec@protonmail.com>",
"keywords": "kivy, kivymd, open source, kvdeveloper, kartavya shukla, novfensec, kv",
"author": null,
"author_email": "Kartavya Shukla <novfensec@protonmail.com>",
"download_url": "https://files.pythonhosted.org/packages/2b/c2/4d9e7ca6cadd4ed8333f6e6dcd36adf456af17bb31a0fdb6837be57e8367/kvdeveloper-2024.1.7.tar.gz",
"platform": null,
"description": "# KvDeveloper\r\n\r\n```csharp\r\n _ __ ____ _ \r\n | |/ /_ _| _ \\ _____ _____| | ___ _ __ ___ _ __ \r\n | ' /\\ \\ / / | | |/ _ \\ \\ / / _ \\ |/ _ \\| '_ \\ / _ \\ '__|\r\n | . \\ \\ V /| |_| | __/\\ V / __/ | (_) | |_) | __/ | \r\n |_|\\_\\ \\_/ |____/ \\___| \\_/ \\___|_|\\___/| .__/ \\___|_| \r\n |_| \r\n```\r\n\r\n[](https://pypi.org/project/kvdeveloper)\r\n[](#Installation)\r\n[](https://pepy.tech/project/kvdeveloper)\r\n[](https://github.com/psf/black)\r\n\r\n[](https://github.com/Novfensec/KvDeveloper/stargazers)\r\n[](https://github.com/Novfensec/KvDeveloper/network)\r\n[](https://github.com/Novfensec/KvDeveloper)\r\n[](https://github.com/Novfensec/KvDeveloper/issues)\r\n\r\n<img src=\"https://raw.githubusercontent.com/Novfensec/KvDeveloper/main/kvdeveloper/assets/image_library/kvdeveloper/kvdeveloper_logo256.png\" height=\"178\" align=\"right\" padding=\"11\"/>\r\n\r\n<p>KvDeveloper is a PyPI module designed to streamline the development of Kivy and KivyMD applications. Inspired by Expo CLI for React Native, it offers starter templates and essential functionalities to kickstart your projects with ease. With features like predefined templates, MVC architecture support, and customizable options, KvDeveloper simplifies creating robust and organized Kivy projects. It supports Python 3.1+, Kivy 2.2.0+, and KivyMD 1.1.1+, making it a versatile tool for developers looking to enhance their Kivy development workflow.</p>\r\n\r\n## Community and Support\r\n[](https://discord.com/invite/U9bfkD6A4c)\r\n[](https://stackoverflow.com/users/16486510/novfensec)\r\n[](https://reddit.com/r/KvDeveloper)\r\n[](https://github.com/Novfensec/KvDeveloper/discussions)\r\n\r\n[](https://youtube.com/@NovfensecInc)\r\n[](https://youtube.com/@KvDeveloper)\r\n\r\nJoin the KvDeveloper community to get support, share your projects, and collaborate with other developers. Here are some ways you can connect with us:\r\n\r\n- **Discord**: Join our [KvDeveloper Community Server](https://discord.com/invite/U9bfkD6A4c).\r\n- **Stack Overflow**: Feel free to reach out on our [Stack Overflow](https://stackoverflow.com/users/16486510/novfensec).\r\n- **Reddit - KvDeveloper**: Feel free to join our [Reddit Community](https://reddit.com/r/KvDeveloper).\r\n- **GitHub Discussions**: Participate in discussions and ask questions in the [GitHub Discussions](https://github.com/Novfensec/KvDeveloper/discussions) section.\r\n- **Youtube - Admin**: Follow [@NovfensecInc](https://youtube.com/@NovfensecInc) to learn by building futuristic projects.\r\n- **YouTube - KvDeveloper**: Follow us on YouTube [@KvDeveloper](https://youtube.com/@KvDeveloper) for updates and announcements.\r\n\r\n[Documentation](https://novfensec.github.io/KvDeveloper.docs): Read the documentation.\r\n\r\nIf you encounter any issues or have questions, feel free to reach out to the community or submit an issue on GitHub.\r\n\r\n## Features\r\n- **Starter Templates**: Quickly create new Kivy and KivyMD projects with predefined templates.\r\n- **Layouts**: Build standard screens rapidly with prebuilt designs. Add layouts to any screen with a single command, making the development process faster and more efficient.\r\n- **MVC Structure**: Includes templates with Model-View-Controller (MVC) architecture. `(recommended KivyMD==1.1.1)`\r\n- **Navigation and Toolbar**: Templates with built-in navigation and toolbar screens.\r\n- **Customizable**: Easily extend and customize the templates and layouts to fit your project needs.\r\n- **Build Workflows and Jupyter Notebooks**: Generates build workflows for github based conversions and jupyter notebooks for colab based converions.\r\n\r\n## Installation\r\n- Install KvDeveloper using pip:\r\n\r\n ```bash\r\n pip install kvdeveloper\r\n ```\r\n\r\n- Install development version using pip `(requires git installation)`:\r\n\r\n ```bash\r\n pip install git+https://github.com/Novfensec/KvDeveloper.git@main\r\n ```\r\n\r\n## Requirements\r\n- **Python**>=3.9\r\n\r\n- kivy>=2.0.0 `(recommended kivy==2.3.0)`\r\n\r\n- kivymd>=2.0.0 `(recommended kivymd==2.0.1.dev0)`\r\n\r\n- pillow>=10.0.0\r\n\r\n- typer>=0.12.3\r\n\r\n- rich>=13.7.1\r\n\r\n- markdown2>=2.5.0\r\n\r\n- pyqt5\r\n\r\n- pyqtwebengine\r\n\r\n## Usage\r\n- Create a new KivyMD project with a blank template:\r\n ```bash\r\n kvdeveloper create TestProject --template blank\r\n ```\r\n\r\n- Create a new KivyMD project with navigation and toolbar with MVC architecture.:\r\n ```bash\r\n kvdeveloper create TestProject --template nav_toolbar --structure MVC\r\n ```\r\n\r\n- Add a screen with a specific layout (e.g., Auth type 1):\r\n ```bash\r\n kvdeveloper add-screen TestScreen --layout auth1\r\n ```\r\n\r\n- Add a layout to an existing screen (e.g., Home type 1):\r\n ```bash\r\n kvdeveloper add-layout home1 --name_screen TestScreen Test1Screen\r\n ```\r\n\r\n- Add bootstrap like customizable components to the project directly:\r\n ```bash\r\n kvdeveloper add-component Container ResponsiveGrid ITDCard\r\n ```\r\n\r\n- Register all custom fonts and components to Kivy bases:\r\n ```bash\r\n kvdeveloper register\r\n ```\r\n\r\n- Get info about the template used for the project:\r\n ```bash\r\n kvdeveloper show-readme TestProject\r\n ```\r\n\r\n- Generate github buildozer workflows for android conversion:\r\n ```bash\r\n kvdeveloper config-build-setup android --external github\r\n ```\r\n\r\n Sample Repository: [Sample-KivyMD-App](https://github.com/Novfensec/SAMPLE-KIVYMD-APP)\r\n\r\n- Generate jupyter notebook for colab based android conversion [`Contains commands to import your app folder from your personal drive!`]:\r\n ```bash\r\n kvdeveloper config-build-setup android --external colab\r\n ```\r\n\r\n## Templates\r\n- **Blank Template**: A minimal template with the basic structure.\r\n\r\n- **Navigation Toolbar Template**: A template with navigation and toolbar screens.\r\n <p align=\"center\">\r\n <img \r\n width=\"800\" src=\"https://raw.githubusercontent.com/Novfensec/KvDeveloper/main/kvdeveloper/assets/image_library/kvdeveloper/nav_toolbar.png\" style=\"border-radius:1em\" \r\n title=\"kvdeveloper create MyApp --template nav_toolbar\"\r\n />\r\n </p>\r\n\r\n- **Navigation Dock Template**: A template navigation and toolbar screens with BottomNavigation, HomeScreen, LoginScreen and SettingsScreen components.\r\n <p align=\"center\">\r\n <img \r\n width=\"800\" src=\"https://raw.githubusercontent.com/Novfensec/KvDeveloper/main/kvdeveloper/assets/image_library/kvdeveloper/nav_dock.png\" style=\"border-radius:1em\" \r\n title=\"kvdeveloper create MyApp --template nav_dock\"\r\n />\r\n </p>\r\n\r\n- **MVC Architecture**: A template add-on following the MVC architecture.\r\n\r\n## Components\r\nCreate customizable bootstrap like components directly in your project.\r\n\r\n- **Container**: A responsive container with pre-defined padding calculations.\r\n\r\n- **ResponsiveGrid**: A responsive grid with pre-defined column calculations.\r\n\r\n- **ITDCard (Image Title Description Card)**: A responsive boostrap like card with image aspect-ratio calculations.\r\n\r\n## Contributing\r\n\r\nWe welcome contributions from the community! If you're interested in contributing to KvDeveloper or its documentation, please read our [Contributing Guidelines](https://github.com/Novfensec/KvDeveloper/blob/main/CONTRIBUTING.md).\r\n\r\nYou can contribute by:\r\n\r\n- Reporting bugs or suggesting features in the [Issues](https://github.com/Novfensec/KvDeveloper/issues) section.\r\n- Submitting pull requests to improve the documentation or the KvDeveloper tool.\r\n- Helping with translations or writing new guides.\r\n\r\nFor more detailed instructions, please visit our [Contributing](https://github.com/Novfensec/KvDeveloper/blob/main/CONTRIBUTING.md) page.\r\n\r\n## Acknowledgements\r\n\r\n[Kivy](https://github.com/kivy)\r\n\r\n[KivyMD](https://github.com/kivymd)\r\n\r\n## License\r\n\r\nKvDeveloper is released under the [MIT License](https://github.com/Novfensec/KvDeveloper/blob/main/LICENSE). You're free to use, modify, and distribute this software as long as you adhere to the terms of the license.\r\n\r\n## Contact\r\nFor any inquiries, please contact us at [novfensec@protonmail.com](mailto:novfensec@protonmail.com).\r\n",
"bugtrack_url": null,
"license": "MIT License Copyright (c) 2024 Kartavya Shukla Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
"summary": "KvDeveloper is a PyPI module designed to streamline the development of Kivy and KivyMD applications. Inspired by Expo CLI for React Native, KvDeveloper provides starter templates and essential functionalities to kickstart your projects with ease.",
"version": "2024.1.7",
"project_urls": {
"Bug Tracker": "https://github.com/Novfensec/KvDeveloper/issues",
"Changelog": "https://github.com/Novfensec/KvDeveloper/blob/main/CHANGELOG.md",
"Documentation": "https://novfensec.github.io/KvDeveloper.docs",
"Homepage": "https://github.com/Novfensec/KvDeveloper",
"Repository": "https://github.com/Novfensec/KvDeveloper"
},
"split_keywords": [
"kivy",
" kivymd",
" open source",
" kvdeveloper",
" kartavya shukla",
" novfensec",
" kv"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1206cf968e42fffac359302e2d9af5a95878898c68e3f9905b7c41208732e319",
"md5": "a2068b018f740e74d3b3f917eb13a5ff",
"sha256": "f9fe7e37435d8b45875dfdecb6b4356750a1189ec2b5a2a5344a10a6b96eb29e"
},
"downloads": -1,
"filename": "kvdeveloper-2024.1.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a2068b018f740e74d3b3f917eb13a5ff",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 2590535,
"upload_time": "2024-10-31T11:07:19",
"upload_time_iso_8601": "2024-10-31T11:07:19.469023Z",
"url": "https://files.pythonhosted.org/packages/12/06/cf968e42fffac359302e2d9af5a95878898c68e3f9905b7c41208732e319/kvdeveloper-2024.1.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2bc24d9e7ca6cadd4ed8333f6e6dcd36adf456af17bb31a0fdb6837be57e8367",
"md5": "eb2dd3d0178b34bf09ed997290e3ef09",
"sha256": "455cb5f32f6e0ab18f0640e38ed3ea81cfbc7accb86eeaaff74aac2fac2f28c1"
},
"downloads": -1,
"filename": "kvdeveloper-2024.1.7.tar.gz",
"has_sig": false,
"md5_digest": "eb2dd3d0178b34bf09ed997290e3ef09",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 2574214,
"upload_time": "2024-10-31T11:07:24",
"upload_time_iso_8601": "2024-10-31T11:07:24.961748Z",
"url": "https://files.pythonhosted.org/packages/2b/c2/4d9e7ca6cadd4ed8333f6e6dcd36adf456af17bb31a0fdb6837be57e8367/kvdeveloper-2024.1.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-31 11:07:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Novfensec",
"github_project": "KvDeveloper",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "kvdeveloper"
}
