CS.Coder · Block Folding BETA

Um nível
de cada vez.

Uma extensão para o editor de código do Delphi 11, 12 e 13.

VERSÃO BETA

O Block Folding ainda está em teste e pode ter defeitos. Ele não altera os seus arquivos-fonte, mas trabalha dentro do editor de código: salve o seu trabalho com frequência enquanto testa. Se encontrar algum problema, avise abrindo uma issue no GitHub.

O Delphi dobra rotinas, classes e regiões. O Block Folding complementa isso com os blocos de dentro da rotina: if com o else, for, while, with, try, case, repeat e, como opção, um begin..end isolado. Ele não altera o seu fonte: nada é inserido na unit e nada é gravado no arquivo.

Baixar no GitHub Como instalar

Versão beta · Delphi 11, 12 e 13 · Código aberto, licença MIT · Sem conta

Editor de código do Delphi com uma unit de exemplo: os blocos begin de um if, de um else, de um while e o bloco de um case aparecem dobrados, cada um com uma caixinha depois da primeira linha. — Blocos dobrados no editor do Delphi. A unit da imagem é o exemplo que vem com o código-fonte.

Dentro da IDENo editor de código

Do seu jeitoTeclado ou mouse

Seu códigoO fonte não é alterado

Sem custoGratuito e de código aberto

Principais funcionalidades

Leia o método.
Abra o que importa.

Um método longo fica mais fácil de ler quando você recolhe o que não está olhando agora.

Blocos de comandos

Comandos if, for, while e with, na linha do comando; case..end, try..end, repeat..until, asm..end e um begin..end isolado. O begin do if e o do else dobram em separado.

Pelo teclado

Ctrl+Alt+B dobra o bloco em volta do cursor e, na primeira linha de um bloco dobrado, abre. Ctrl+Alt+Shift+B abre todas as dobras da unit atual. Os dois atalhos podem ser trocados.

Pelo mouse

Sinais − e + ao lado do código dobram e abrem com um clique. Eles aparecem quando a dobra de código da própria IDE está desligada.

Você escolhe os blocos

Cada tipo de bloco pode ser ligado ou desligado nas configurações, assim como o texto que aparece na linha dobrada.

O fonte fica como está

Nenhum {$REGION} é inserido e o arquivo não é tocado. As dobras existem só no editor.

Junto com as dobras do Delphi

Corpo de rotina, classes e regiões continuam sendo dobrados pelo próprio Delphi. Um bloco que contém um {$REGION} não é dobrado pelo Block Folding.

No dia a dia

Como usar

Os mesmos comandos estão no menu principal, em CS.Coder > Block Folding.

Dobrar o bloco em volta do cursor	Ctrl+Alt+B
Abrir um bloco dobrado	Ctrl+Alt+B na primeira linha dele
Abrir todas as dobras da unit atual	Ctrl+Alt+Shift+B
Dobrar ou abrir com o mouse	Clique no sinal `−` ou `+` ao lado do código

As dobras valem enquanto a unit está aberta. Editar em volta e salvar mantém; fechar e reabrir a unit volta sem dobras.

Configurações

Restaurar padrões volta tudo aos valores iniciais. A tela Sobre acompanha o idioma do Windows; o menu e a janela de configurações estão em português nesta versão.

O que o Block Folding é, em detalhe

Especificações

Tipo	Pacote de design para a IDE do Delphi
Situação	Versão beta
Versões do Delphi	11 Alexandria, 12 Athens e 13 Florence
IDE	32 bits (11, 12 e 13) e 64 bits (12 e 13)
Arquivos-fonte	Não são alterados. As dobras existem só no editor, enquanto a unit está aberta
Configurações	Registro do Windows, um conjunto por versão do Delphi, em `HKEY_CURRENT_USER\Software\Embarcadero\BDS\<versão>\CSCoder\BlockFolding`
Log	`%LOCALAPPDATA%\CSCoder\BlockFolding\diagnostico.log`, um registro do que a extensão fez, para suporte. Fica só no seu computador
Rede	Não usa. Nenhum dado é coletado nem enviado
Instalação	Por usuário do Windows, sem pedir administrador
Licença	MIT, gratuito e de código aberto

Comece por aqui

Instalação

Um único download atende ao Delphi 11, 12 e 13, incluindo as IDEs de 64 bits do 12 e do 13. Os pacotes são compilados com o Delphi 11.3, 12.3 e 13.1.

Delphi 11 Alexandria	IDE de 32 bits
Delphi 12 Athens	IDE de 32 bits e de 64 bits
Delphi 13 Florence	IDE de 32 bits e de 64 bits

1
Baixe
Abra a página de Releases no GitHub, escolha a versão mais recente e, em Assets, baixe o arquivo CSCoderBlockFolding-<versão>.zip. Não escolha “Source code”: esse não traz o instalador.
2
Extraia
Descompacte o arquivo inteiro em uma pasta à sua escolha. O Install.bat precisa dos outros arquivos que vêm com ele.
3
Feche o Delphi
Feche todas as janelas do Delphi. O instalador para com um aviso se o Delphi estiver aberto.
4
Execute o Install.bat
Dê um duplo clique. Ele não pede administrador e instala para o usuário atual do Windows, em todos os Delphi compatíveis que encontrar.
5
Abra o Delphi
Os comandos ficam no menu principal da IDE, em CS.Coder > Block Folding.

Como conferir

Em Component > Install Packages, o pacote aparece marcado como “CS.Coder - Block Folding (https://www.cscoder.com.br)”. O menu CS.Coder passa a existir no menu principal da IDE.

Atualização

Baixe o zip mais novo, feche o Delphi e execute o Install.bat dele. As suas configurações são mantidas.

Quando quiser sair

Desinstalação

Feche o Delphi antes. Nenhum dos dois comandos mexe nos seus projetos.

Remover a extensão e manter as configurações

Uninstall.bat

Remove o Block Folding de todas as versões do Delphi e apaga os pacotes instalados. As configurações são mantidas, então instalar de novo traz tudo de volta.

Remover a extensão e as configurações

Uninstall.bat /data

Atenção: não há como desfazer.

Este comando apaga também as configurações do Block Folding de todas as versões do Delphi (atalhos, tipos de bloco e texto da linha dobrada) e o log de diagnóstico.

Um recurso CS.Coder para sua rotina

Seu editor.
Seu código.
Um nível de cada vez.

O pacote de instalação e o código-fonte estão no GitHub, onde o projeto se chama CS.Coder Block Folding.

BETA · GRATUITO · CÓDIGO ABERTO

Block Folding para Delphi

Versão beta 0.26.10.12a · Release no GitHub

Baixar no GitHub

Windows · Delphi 11, 12 e 13
Uso pessoal e comercial.

Versão beta, de código aberto sob a licença MIT, disponibilizada “como está” (as is).

Você pode usar, modificar e redistribuir, mantendo o aviso de copyright. Sem garantias, conforme a licença.

Resumo em portuguêsLicença completaCódigo-fonte no GitHub

Antes de começar

Dúvidas frequentes

O que significa ser uma versão beta?

O Block Folding funciona nas três versões do Delphi, mas ainda está em teste e pode ter defeitos. Salve o seu trabalho com frequência enquanto testa, e avise o que encontrar em uma issue no GitHub.

Ele altera o meu código?

Não. Nada é inserido na unit e nada é gravado no arquivo. As dobras existem só no editor.

Ele substitui a dobra de código do Delphi?

Não. O Delphi continua dobrando rotinas, classes e regiões como sempre. O Block Folding acrescenta os blocos de dentro da rotina.

As dobras ficam guardadas quando fecho a unit?

Não. Elas valem enquanto a unit está aberta. Editar em volta e salvar mantém; fechar e reabrir a unit volta sem dobras.

Em que idioma ele está?

A tela Sobre acompanha o idioma do Windows, entre português, inglês, espanhol, alemão e francês. O menu e a janela de configurações estão em português nesta versão.

Posso usar no trabalho?

Sim. O Block Folding é gratuito para uso pessoal e comercial, conforme a licença MIT.

Encontrei um problema ou tenho uma sugestão. Onde aviso?

Abra uma issue no GitHub. Contribuições por pull request são bem-vindas.

Desenvolvido por Claudio Santos · CS.Coder. Delphi e RAD Studio são marcas da Embarcadero Technologies, Inc. O Block Folding é um projeto independente: não tem vínculo com a Embarcadero, não é mantido por ela nem conta com o seu endosso.