Giter Club home page Giter Club logo

como-contribuir-com-o-powergrid's Introduction

PowerGrid Logo


Como contribuir com o PowerGrid

O objetivo desse documento é facilitar a colaboração com PowerGrid.

1) Fazer o fork do projeto

Para isso, basta acessar a página do nosso repositório em PowerGrid e clicar no botão Fork:

No final você terá algo como https://github.com/cpereiraweb/livewire-powergrid.
Obs: Se você estiver associado à uma equipe ou organização no Github, você deverá confirmar em qual conta você deseja criar o fork.

2) Clonar o repositório em sua máquina

Selecione uma pasta em seu computador para fazer o fork do projeto:

3) Crie um novo branch e faça o push para seu repositório

Acesse o diretório do repositório:

cd livewire-powergrid

Crie um novo branch (usei o meu nome de usuário aqui para exemplificar):

git checkout -b cpereiraweb

Você precisa fazer o push desse branch para o seu servidor. Como sugestão, crie um arquivo TODO.md na raiz do projeto, adicione-o e faça o commit:

touch TODO.md
git add .
git commit -m "Added TODO.md"
git push origin cpereiraweb  # Use o nome do seu branch aqui, ok?

4) Adicione o PowerGrid ao seu projeto Laravel

Acesse a pasta do seu projeto Laravel e faça a instalação do componente, como descrito na documentação:

composer require power-components/livewire-powergrid

5) Configure o composer para usar o seu clone do PowerGrid

Você vai precisar informar ao composer duas coisas: que quer usar uma versão de desenvolvimento do pacote e onde está essa versão. Isso é simples: Abra o composer.json e identifique a linha de requisição do PowerGrid:

"power-components/livewire-powergrid": "^1.0",

Tomando por base o que eu fiz até aqui, vou configurar a versão. Ela deve ser dev-+o-nome-do-meu-branch. No meu caso, dev-cpereiraweb:

"power-components/livewire-powergrid": "dev-cpereiraweb",

O segundo passo é informar onde está esse repositório. Para isso acrescentamos a seção repositories ao nosso composer.json.
Há pelo menos duas maneiras de fazer isso: usando a URL do seu repositório no Github ou indicar o caminho dele na sua máquina.

Veja o trecho abaixo para usar o repositório no Github:

        ...
        "spatie/laravel-ray": "^1.17",
        "wulfheart/pretty_routes": "^0.2.0"
    },
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/cpereiraweb/livewire-powergrid.git"
        }
    ],
    "autoload": {
        ...

E agora veja como fica usando o caminho do seu repositório local (onde você o clonou). No meu caso, a pasta onde clonei o repositório localmente é Z:\Code\forks\PowerComponents\livewire-powergrid:

        ...
        "spatie/laravel-ray": "^1.17",
        "wulfheart/pretty_routes": "^0.2.0"
    },
    "repositories": [
        {
            "type": "path",
            "url": "Z:\\Code\\forks\\PowerComponents\\livewire-powergrid"
        }
    ],
    "autoload": {
        ...

Observação: meu ambiente é Windows 10. Se você usa WSL, Docker, Linux ou MacOS, lembre-se de usar o caminho adequado ao seu sistema, que deve ser algo como /home/cpereiraweb/code/forks/PowerComponents/livewire-powergrid, por exemplo.

6) Executar o composer update

Agora é só rodar o comando composer update no seu projeto Laravel para ele atualizar as referências. Veja o resultado abaixo (usando o link do seu repositório no Github):
 

 
A imagem mostra o uso dos commits do meu repositório. Eu havia instalado primeiramente o commit 219cdd8. Na imagem acima, foi atualizado para o commit 65ae610.
 

Mas se você configurou para usar o repositório localmente, o resultado será esse:
 

 
Você pode observar acima que ele remove a versão Github do meu repositório e instala a versão local. Com isso, as indicações do commit desaparecem. Desta maneira eu não preciso mais fazer push do meu fork nem composer update no meu projeto Laravel, tornando o processo mais dinâmico.

Tudo pronto!

Agora é só seguir o fluxo de qualquer projeto Git: faça as alterações no seu fork e faça o push para o Github. No diretório do seu projeto Laravel, rode o composer update para atualizar o código no seu projeto. Sem POG(Programação Orientada à Gambiarras)! Grande abraço!

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.