Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/heitor-tasso/kivygo

**kivygo** é um conjunto de widgets e ferramentas para o Kivy que simplifica o desenvolvimento de aplicativos com uma abordagem centrada no design, fornecendo uma experiência de usuário mais completa.
https://github.com/heitor-tasso/kivygo
app kivy kivy-application
Last synced: 2 months ago
JSON representation
Host: GitHub
URL: https://github.com/heitor-tasso/kivygo
Owner: Heitor-Tasso
License: mit
Created: 2023-04-28T02:36:15.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2023-12-18T18:06:08.000Z (about 1 year ago)
Last Synced: 2024-10-14T06:40:32.880Z (2 months ago)
Topics: app, kivy, kivy-application
Language: Python
Homepage:
Size: 22.3 MB
Stars: 4
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project

README

        
KivyGO

====



Interfaces de usuário inovadoras facilitadas.

KivyGO é um framework [Python] de plataforma cruzada de código aberto (https://www.python.org)

utilizado para o desenvolvimento de aplicações que fazem uso de tecnologias inovadoras,

interfaces de usuário com design complexo e inovador.

KivyGO é licenciado pelo MIT, para ser utilizado em um framework

chamado Kivy [Kivy Organization](https://kivy.org/#organization).

#

![GitHub repo size](https://img.shields.io/github/repo-size/Heitor-Tasso/kivygo?style=for-the-badge)

![GitHub language count](https://img.shields.io/github/languages/count/Heitor-Tasso/kivygo?style=for-the-badge)

![GitHub forks](https://img.shields.io/github/forks/Heitor-Tasso/kivygo?style=for-the-badge)

![Bitbucket open issues](https://img.shields.io/bitbucket/issues/Heitor-Tasso/kivygo?style=for-the-badge)

![Bitbucket open pull requests](https://img.shields.io/bitbucket/pr-raw/Heitor-Tasso/kivygo?style=for-the-badge)

====

[✅ GoodPractices](#commit-pattern)


### Ajustes e melhorias

O projeto ainda está em desenvolvimento e as próximas atualizações serão voltadas nas seguintes tarefas:

- [ ] Documentação Baseado na do Kivy

- [ ] Exemplo de cada Widget e funcionalidade, em Imagem/Vídeo e Código

- [ ] Definir um theme único para o framework

- [x] Adicionar todos os créditos devidos

- [ ] Refatorar todos widgets e deixá-los no padrão do framework

- [ ] Finalizar o desenvolvimento do uix/codeinput.py

## 💻 Pré-requisitos

Antes de começar, verifique se você atendeu aos seguintes requisitos:

* Você instalou o `Python >= 3.9.7`.

* Você tem uma máquina `Windows / Linux / Mac / Android`.

## ☕ Utilizando o kivygo

Para usar o KivyGO, siga estas etapas:

 - Instale a lib pelo comando pip `pip install kivygo`.

 - Copie o código de exemplo da biblioteca e inicie.

 - Para fazer a instalação pelo github `pip install git+https://github.com/Heitor-Tasso/kivygo.git#egg=kivygo`.

## 📫 Contribuindo para o kivygo

Para contribuir com o kivygo, siga estas etapas:

1. Bifurque este repositório.

2. Crie um branch: `git checkout -b dev`.

3. Faça suas alterações e confirme-as: `git commit -m ''`

4. Envie para o branch: `git push origin dev`

5. Crie a solicitação de pull.

Como alternativa, consulte a documentação do GitHub em [como criar uma solicitação pull](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request).

# Commit Pattern

O commit semântico possui os elementos estruturais abaixo (tipos), que informam a intenção do seu commit ao utilizador(a) de seu código.

- `FEATURE`- Commits do tipo FEATURE indicam que seu trecho de código está incluindo um **novo recurso** (se relaciona com o MINOR do versionamento semântico).

- `FIXED` - Commits do tipo FIXED indicam que seu trecho de código commitado está **solucionando um problema** (bug FIXED), (se relaciona com o PATCH do versionamento semântico).

- `DOC` - Commits do tipo DOC indicam que houveram **mudanças na documentação**, como por exemplo no Readme do seu repositório. (Não inclui alterações em código).

- `TEST` - Commits do tipo TEST são utilizados quando são realizadas **alterações em testes**, seja criando, alterando ou excluindo testes unitários. (Não inclui alterações em código)

- `REQUIRE` - Commits do tipo REQUIRE são utilizados quando são realizadas modificações em **arquivos de REQUIRE e dependências**.

- `PERFORM` - Commits do tipo PERFORM servem para identificar quaisquer alterações de código que estejam relacionadas a **performance**.

- `STYLE` - Commits do tipo STYLE indicam que houveram alterações referentes a **formatações de código**, semicolons, trailing spaces, lint... (Não inclui alterações em código).

- `REFACTOR` - Commits do tipo REFACTOR referem-se a mudanças devido a **refatorações que não alterem sua funcionalidade**, como por exemplo, uma alteração no formato como é processada determinada parte da tela, mas que manteve a mesma funcionalidade, ou melhorias de performance devido a um code review.

## ☑️ Recomendações

- Adicione um título consistente com o título do conteúdo;

- Recomendamos que na primeira linha deve ter no máximo 4 palavras;

- Para descrever com detalhes, usar a descrição do commit;

- Usar um emoji no início da mensagem de commit representando sobre o commit;

- Um link precisa ser adicionado em sua forma mais autêntica, ou seja: sem encurtadores de link e links afiliados;

## 💻 Exemplos

  

    

      Comando git

      Resultado no GitHub

    

  

 

    

      

        git commit -m ":tada: Commit inicial"

      

      🎉 Commit inicial

    

    

      

        git commit -m ":books: [ DOC ] - Atualizaçao do README"

      

      📚 [ DOC ] - Atualizaçao do README

    

    

      

        git commit -m ":bug: [ FIXED ] - Loop infinito na linha 50"

      

      🐛 [ FIXED ] - Loop infinito na linha 50

    

    

      

        git commit -m ":sparkles: [ FEATURE ] - Pagina de login"

      

      ✨ [ FEATURE ] - Pagina de login

    

    

      

        git commit -m ":recycle: [ REFACTOR ] - Passando para arrow functions"

      

      ♻️ [ REFACTOR ] - Passando para arrow functions

    

    

      

        git commit -m ":zap: [ PERFORM ] - Melhoria no tempo de resposta"

      

      ⚡ [ PERFORM ] - Melhoria no tempo de resposta

    

    

      

        git commit -m ":boom: [ FIXED ] - Revertendo mudanças ineficientes"

      

      💥 [ FIXED ] - Revertendo mudanças ineficientes

    

    

      

        git commit -m ":lipstick: [ FEATURE ] - Estilizaçao CSS do formulario"

      

      💄 [ FEATURE ] - Estilizaçao CSS do formulario

    

    

      

        git commit -m ":test_tube: [ TEST ] - Criando novo teste"

      

      🧪 [ TEST ] - Criando novo teste

    

    

      

        git commit -m ":bulb: [ DOC ] - Comentários sobre a função LoremIpsum( )"

      

      💡 [ DOC ] - Comentários sobre a função LoremIpsum( )

    

  

---

# Licenças de Bibliotecas utilizadas no Projeto

Abaixo estão as informações das licenças de cada biblioteca utilizada no projeto:

## Bibliotecas com Licenças Permitidas

- **MIT License:** Utilizada em:

    - [GoTapTargetView](https://github.com/shashi278/GoTapTargetView.git)

    - [KivyShaderTransitions](https://github.com/shashi278/KivyShaderTransitions.git)

    - [NeuKivy](https://github.com/Guhan-SenSam/NeuKivy.git)

    - [kivy-gradient](https://github.com/shashi278/kivy-gradient.git)

    - [kivy-circular-progress-bar](https://github.com/TheCodeSummoner/kivy-circular-progress-bar.git)

    - [svg-anim-kivy](https://github.com/shashi278/svg-anim-kivy.git)

    - [frostedglass](https://github.com/kivy-garden/frostedglass.git)

    - [drag_n_drop](https://github.com/kivy-garden/drag_n_drop.git)

    - [garden.pizza](https://github.com/kivy-garden/garden.pizza.git)

    - [garden.rotabox](https://github.com/kivy-garden/garden.rotabox.git)

    - [garden.DynamicGridLayout](https://github.com/kivy-garden/garden.DynamicGridLayout.git)

    - [garden.segment](https://github.com/kivy-garden/garden.segment.git)

    - [garden.circularlayout](https://github.com/kivy-garden/garden.circularlayout.git)

    - [garden.navigationdrawer](https://github.com/kivy-garden/garden.navigationdrawer.git)

    - [radialslider](https://github.com/kivy-garden/radialslider.git)

    - [garden.circulardatetimepicker](https://github.com/kivy-garden/garden.circulardatetimepicker.git)

    - [garden.progressspinner](https://github.com/kivy-garden/garden.progressspinner.git)

    - [garden.joystick](https://github.com/kivy-garden/garden.joystick.git)

    - [garden.GoTab](https://github.com/kivy-garden/garden.GoTab.git)

    - [kivy-particle](https://github.com/skitoo/kivy-particle.git)

    - [gl-transitions](https://github.com/gl-transitions/gl-transitions.git)

- **GNU GENERAL PUBLIC LICENSE:** Utilizada em:

    - [Resizable-Widget-in-Kivy](https://github.com/FilipeMarch/Resizable-Widget-in-Kivy.git)

- **Nenhuma Licença** Utilizada em:

    - [kivy-pipette](https://github.com/Neizvestnyj/kivy-pipette.git)

    - [CurvyKivy](https://github.com/quitegreensky/CurvyKivy.git)

    - [kivy_shader](https://github.com/adywizard/kivy_shader.git)

    - [Kivy-Glowing-Line](https://github.com/kengoon/Kivy-Glowing-Line.git)

---

## 📝 Licença

Esse projeto está sob licença. Veja o arquivo [LICENCE](LICENSE) para mais detalhes.

---

## 🤝 Colaboradores

Agradecemos às seguintes pessoas que contribuíram para este projeto:

  

    

      

        


        _{Heitor Tasso}

      

    

  

---

Para ver quantidade de linhas do código no Visual Studio Code:

 - `(gci -include *.kv,*.py -recurse | select-string .).Count`

---

# Build to PYPI

 - `python setup.py sdist`

 - `twine upload dist/*`


[⬆ Voltar ao topo](#kivygo)