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.

✅ GoodPractices

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
• 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 '<mensagem_commit>'
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.

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

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
  • KivyShaderTransitions
  • NeuKivy
  • kivy-gradient
  • kivy-circular-progress-bar
  • svg-anim-kivy
  • frostedglass
  • drag_n_drop
  • garden.pizza
  • garden.rotabox
  • garden.DynamicGridLayout
  • garden.segment
  • garden.circularlayout
  • garden.navigationdrawer
  • radialslider
  • garden.circulardatetimepicker
  • garden.progressspinner
  • garden.joystick
  • garden.GoTab
  • kivy-particle
  • gl-transitions

• GNU GENERAL PUBLIC LICENSE: Utilizada em:

  • Resizable-Widget-in-Kivy

• Nenhuma Licença Utilizada em:

  • kivy-pipette
  • CurvyKivy
  • kivy_shader
  • Kivy-Glowing-Line

📝 Licença

Esse projeto está sob licença. Veja o arquivo LICENCE 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

Hoje, com o uv, o processo padrão é este:

1. Gere o pacote (sdist + wheel)

uv build

Isso cria os arquivos dentro de dist/.

2. Envie para o PyPI Você pode usar ou o próprio uv ou o twine.

Com o uv (mais atual):

uv publish --token <seu_token>

Ou com twine (funciona igual):

twine upload dist/*

⬆ Voltar ao topo