@lcmartinsfilho’s Blog do Luiz - Categories

Testando a criação de posts no iPad (segunda vez)

Luiz Carlos Martins Filho — Thu, 10 Sep 2026 23:23:00 +0000

Dessa vez clonei o repo do meu Github Pages dentro do iSH e editei o arquivo diretamente no terminal pelo neovim, commitei e pushei para o repo. Me pareceu muito mais ergonômico e prático do que usar a interface do Github, sem falar que funciona completamente off-line.

Testando a criação de posts no iPad

Luiz Carlos Martins Filho — Thu, 10 Sep 2026 23:00:00 +0000

Estou na academia, num café próximo à entrada, testando a viabilidade de criar posts em meu blog usando o iPad com o teclado. Se o app do Github não funcionar ou não for ergonômico o suficiente, ainda posso testar o iSH ou coisa parecida para fazer modificações locais. Aliás, acho que clonar o repositório do blog por lá e usar o neovim talvez seja a alternativa mais interessante.

Esse post escrevi dentro do próprio app do Github, criando o arquivo diretamente nele e commitando diretamente na main.

Correção de texto com Harper

Luiz Carlos Martins Filho — Sun, 18 Jan 2026 00:00:00 +0000

Luiz recentemente recebeu uma recomendação sobre Harper, uma nova ferramenta de verificação gramatical desenvolvida pela Automattic usando Rust.

O repositório do projeto descreve Harper como atendendo aos requisitos específicos do desenvolvedor: ele é o verificador gramatical que atende às necessidades, analisando documentos em milissegundos com um consumo mínimo de memória.

Características principais

Desempenho rápido: análise em nível de milissegundos
Baixo consumo de memória: menos de 1/50 do uso do LanguageTool
Privacidade completa: funciona localmente, sem enviar dados para servidores
Compatibilidade com WebAssembly: pode ser executado em múltiplas plataformas

Instalação

A instalação é simples através das lojas de extensões para:

Navegadores web
Visual Studio Code
Obsidian

Para outras plataformas, documentação abrangente está disponível em writewithharper.com/docs/about.

Links úteis

Sincronizando seu Obsidian

Luiz Carlos Martins Filho — Sat, 17 Jan 2026 14:15:00 +0000

Existem várias formas de sincronizar o Obsidian, mas decidi documentar o método que escolhi, tanto para não esquecer os detalhes no futuro quanto para ajudar quem também busca uma solução própria de sincronização.

Para esse projeto, usaremos o plugin Obsidian LiveSync:

vrtmrz/obsidian-livesync

Criando uma VPS no MagaluCloud

Para o servidor, criarei uma VPS no MagaluCloud. Vou fazer o mesmo processo de forma manual, pelo console, mas é possível fazer tudo utilizando o mgc (MagaluCloud cli).

Abra o console. Para criar uma nova máquina virtual, clique em Virtual Machines:

Na página de Virtual Machines, clique em Criar Instância:

Selecione a Zona de Disponibilidade desejada (nesse exemplo, escolhi a br-se1-a) e também o Sistema Operacional. Aqui vou de Debian 13 LTS:

Para o servidor, podemos ir com a opção mais barata! Escolhi a instância com 1 vCPU e 1 GB de RAM (BV1-1-20). O único detalhe é o espaço; por segurança, escolhi um disco local de 20 GB.

Não se esqueça de deixar marcada a opção para atribuir endereço de IPv4 público para a instância. Para acessar a máquina, selecione uma chave SSH existente (se já tiver uma). Do contrário, insira uma chave pública nova. Se não ainda não tiver uma, a documentação pode ajudar. Guarde as chaves geradas com cuidado, pois perdê-las impedirá o acesso à máquina! Por fim, dê um nome ilustrativo à instância e clique em Criar instância.

Configurando o servidor

Acesse o servidor recém criado com ssh:

ssh debian@seu-ip-aqui.com

Para esse projeto, precisaremos do Docker instalado. O passo a passo de instalação foi retirado da documentação do projeto. Rode individualmente cada comando abaixo para adicionar o repositório do Docker ao seu servidor:

# Add Docker's official GPG key:
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

Depois de adicionar o repositório oficial do Docker com os comandos acima, instale as ferramentas necessárias:

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Com o Docker instalado, crie um diretório para separar seus dados e configurações:

mkdir -p ~/obsidian-livesync/{couchdb-data,config}
cd ~/obsidian-livesync

Crie o arquivo ~/obsidian-livesync/config/local.ini e adicione as seguintes configurações:

[couchdb]
single_node=true
max_document_size = 50000000 ; 50MB (Adjust based on your note size needs)

[chttpd]
require_valid_user = true
max_http_request_size = 4294967296 ; 4GB (Necessary for large sync batches)
enable_cors = true

[chttpd_auth]
require_valid_user = true
authentication_redirect = /_utils/session.html

[httpd]
WWW-Authenticate = Basic realm="administrator"
enable_cors = true

[cors]
origins = app://obsidian.md,capacitor://localhost,http://localhost
credentials = true
headers = accept, authorization, content-type, origin, referer
methods = GET, PUT, POST, HEAD, DELETE
max_age = 3600

Para instalar o CouchDB, usaremos um docker compose:

version: '3.8'

services:
 couchdb:
 image: couchdb:latest
 container_name: livesync-couchdb
 restart: always
 environment:
 - COUCHDB_USER=admin
 - COUCHDB_PASSWORD=YOUR_STRONG_PASSWORD_HERE
 volumes:
 - ./couchdb-data:/opt/couchdb/data
 - ./config/local.ini:/opt/couchdb/etc/local.d/local.ini
 ports:
 - "127.0.0.1:5984:5984" # Expose only to localhost, Caddy handles external traffic

 caddy:
 image: caddy:latest
 container_name: livesync-caddy
 restart: always
 ports:
 - "80:80"
 - "443:443"
 volumes:
 - ./Caddyfile:/etc/caddy/Caddyfile
 - caddy_data:/data
 - caddy_config:/config
 depends_on:
 - couchdb

volumes:
 caddy_data:
 caddy_config:

Não se esqueça de alterar a senha de seu banco no arquivo anterior. Escolha uma senha forte!

Para lidar com proxy reverso e certificado digital, usaremos o Caddy. Crie o arquivo ~/obsidian-livesync/Caddyfile e adicione as seguintes configurações, ajustando o domínio:

obsidian.yourdomain.com {
reverse_proxy couchdb:5984
}

Suba a stack com:

docker compose up -d

Agora vamos criar um banco de dados chamado obsidian. Você é livre para usar qualquer nome aqui:

curl -X PUT -u admin http://127.0.0.1:5984/obsidian

Entre com o nome de usuário e senha definidos no arquivo ~/obsidian-livesync/config/local.ini.

Configurando o cliente

Instale o Plugin Self-hosted LiveSync após ativar os Community Plugins.

Setup Wizard:

Abra as Plugin Settings
Selecione Remote Database Configuration
Configure os seguintes campos:
- URI: https://obsidian.yourdomain.com
- Username: admin
- Password: YOUR_STRONG_PASSWORD_HERE
- Database Name: obsidian
- End-to-End Encryption: Enabled (Recomendado! Será usada uma nova senha para encriptação!)
Teste: Clique “Test Connection”. Se tiver sucesso, aplique as configurações.

Tips for Contributing to Open Source

Luiz Carlos Martins Filho — Wed, 01 Oct 2025 09:45:00 +0000

Tips for Contributing to Open Source

Open-source contributions are rewarding, but can feel intimidating. Here are practical tips for making meaningful contributions.

Start Small

Don’t try to solve the hardest problems first:

Look for issues labeled good first issue or help wanted
Fix typos and improve documentation
Add tests for existing functionality
Improve error messages

Read the Guidelines

Every project has contribution guidelines. Read them!

CONTRIBUTING.md
CODE_OF_CONDUCT.md
PULL_REQUEST_TEMPLATE.md

Understanding these saves time for both you and maintainers.

Communicate Early

Before investing significant time, discuss your approach:

Interested in tackling #123. Here's my plan:
1. Refactor X to use Y approach
2. Add tests for edge cases
3. Update documentation

Does this align with the project's direction?

Write Good Commits

Clear commits help maintainers review your code:

Add caching layer to improve performance

- Implement LRU cache for frequently accessed data
- Add cache configuration options
- Include benchmarks showing 40% improvement
- Update documentation with caching details

Fixes #456

Test Your Changes

Ensure your code:

✅ Passes existing tests
✅ Includes new tests for new features
✅ Works on different platforms/versions
✅ Doesn’t introduce performance regressions

Be Patient and Respectful

Maintainers are volunteers. They may take time to review:

Follow up respectfully after a week
Address feedback promptly
Don’t take rejection personally

Tools and Resources

Your First PR

Remember: everyone started with their first contribution. Take that step, and you’ll be amazed at how welcoming the community can be!

Building CLI Tools That Users Love

Luiz Carlos Martins Filho — Mon, 22 Sep 2025 14:15:00 +0000

Building CLI Tools That Users Love

Command-line tools are a developer’s best friend. A well-designed CLI can significantly improve productivity and developer experience. Here are some best practices.

Principle 1: Clear Help Text

Always provide comprehensive help documentation:

$ mytool --help
Usage: mytool [OPTIONS] [COMMAND]

A powerful CLI tool for developers

Commands:
 build Build your project
 test Run tests
 deploy Deploy to production
 help Print this message

Options:
 -h, --help Print help
 -v, --version Print version

Principle 2: Sensible Defaults

Users shouldn’t need to specify every option. Use smart defaults:

# Good - works with sensible defaults
$ mytool build

# Still flexible - can override defaults
$ mytool build --target release --jobs 8

Principle 3: Useful Error Messages

Error messages should guide users toward solutions:

Error: Config file not found at ~/.mytool/config.yaml

Did you mean to:
 1. Create a config: mytool init
 2. Specify a custom path: mytool --config /path/to/config.yaml

Principle 4: Progress Feedback

Long-running operations should provide feedback:

$ mytool deploy
[████████░░] Building... (60%)
[██████████] Testing... (100%)
[██████████] Deploying... (100%)
✓ Deployment successful

Tool Recommendations

Rust: clap for argument parsing, indicatif for progress bars
Python: click or typer for CLI frameworks
Go: cobra or urfave/cli for CLI applications

Conclusion

Great CLI tools are invisible—users can accomplish their goals without thinking about the tool itself. Focus on clarity, consistency, and helpful feedback.

Getting Started with Rust

Luiz Carlos Martins Filho — Mon, 15 Sep 2025 10:30:00 +0000

Getting Started with Rust

Rust is a systems programming language that runs blazingly fast, prevents segfaults, and guarantees thread safety. In this post, we’ll explore the fundamentals of getting started with Rust.

Installation

The easiest way to install Rust is using rustup:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Your First Program

Create a new project with Cargo:

cargo new hello_world
cd hello_world

Edit src/main.rs:

fn main() {
 println!("Hello, world!");
}

Run your program:

cargo run

Key Concepts

Ownership

Rust’s most distinctive feature is its ownership system. Every value in Rust has a single owner, and when the owner is dropped, the value is freed.

Borrowing

Instead of moving ownership, you can borrow values:

fn len(s: &String) -> usize {
 s.len()
}

Pattern Matching

Rust’s match expression is incredibly powerful:

match number {
 0 => println!("Zero"),
 1..=5 => println!("One to five"),
 _ => println!("Greater than five"),
}

Next Steps

Read The Rust Book
Practice on Exercism
Join the Rust Community

Happy coding!

JavaScript is (too) liberal

Luiz Carlos Martins Filho — Sat, 26 Jul 2025 00:00:00 +0000

JavaScript é uma linguagem notavelmente permissiva, o que pode ser tanto uma bênção quanto uma maldição para desenvolvedores. Esta publicação explora os aspectos liberais da linguagem e suas implicações para a qualidade do código e experiência do desenvolvedor.

Mais conteúdo em breve…

Repositório de ideias

Luiz Carlos Martins Filho — Sat, 12 Jul 2025 00:00:00 +0000

Este blog funciona como um repositório de tudo quanto estou lendo, pensando ou que me interessa. É um retorno à tradição dos blogs pessoais da era anterior às redes sociais, onde cada pessoa mantinha seu próprio espaço na internet.

O propósito

Em um mundo dominado por algoritmos e feeds infinitos, há algo especial em manter um espaço genuinamente pessoal. Um lugar onde ideias podem ser exploradas livremente, sem preocupação com engagement ou alcance. Apenas pensamentos, leituras e reflexões.

Bem-vindo ao Blog do Luiz!

Coming soon

Luiz Carlos Martins Filho — Fri, 11 Jul 2025 00:00:00 +0000

Bem-vindo ao Blog do Luiz!

Este é o primeiro post do blog, que ainda está em desenvolvimento. Coisas estarão em funcionamento muito em breve, mas você pode se inscrever no meio do caminho se quiser ficar atualizado e receber emails quando novo conteúdo for publicado!

Obrigado pelo interesse! 🙌