c-starter

Este repositório demonstra como utilizar a linguagem C no Visual Studio Code (VSCode), proporcionando uma boa experiência de desenvolvimento com exemplos práticos, configuração de ambiente e dicas de produtividade. O projeto exibe mensagens em um balão de fala acompanhado de uma vaca em arte ASCII, similar ao cowsay.

Instalação das dependências

Linux (Debian/Ubuntu)

Antes de compilar, instale as dependências necessárias:

sudo apt update
sudo apt install clang-format clang-tidy clangd build-essential

Windows 11 (via Chocolatey)

A seguir, um passo-a-passo enxuto e totalmente via linha de comando (PowerShell):

1. Pré-requisito: ter o Chocolatey instalado
   Caso ainda não tenha, veja as instruções oficiais em https://chocolatey.org/install.

2. Instalar o GCC (via MinGW-w64) e o Make
   Abra um PowerShell como Administrador e execute:

   choco install mingw -y
   choco install make  -y

   • O pacote mingw instala o GCC (gcc, g++, etc.) no Windows.
   • O pacote make traz o GNU Make para uso no PowerShell.

3. Verificar as versões instaladas

   gcc   --version
   make  --version

4. Instalar LLVM/Clang
   Abra um PowerShell como Administrador e execute:

   choco install llvm -y

   Isso vai baixar e instalar a versão mais recente do LLVM, com:

   • clang, clang-cl, clang++
   • clang-format
   • clang-tidy
   • clangd
   • lld, llvm-objdump…

5. Verificar as versões instaladas do LLVM/Clang

   clang-format --version
   clang-tidy  --version
   clangd      --version

Como compilar

O projeto utiliza o compilador gcc por padrão, definido na variável CC do Makefile. Caso prefira, você pode facilmente alterar o compilador editando o arquivo Makefile ou passando a variável como parâmetro na linha de comando, por exemplo:

# Usa o gcc (padrão)
make build

# Usa o clang
make CC=clang build

O executável será gerado em bin/vaca.

Como usar

Execute o programa passando a mensagem desejada como argumento:

./bin/vaca "Sua mensagem aqui"

Exemplo de saída:

  Olá, mundo!
   \   ^__^
    \  (oo)\_______
       (__)\       )\/\
           ||----w |
           ||     ||

Se nenhum argumento for fornecido, o programa exibirá uma mensagem de erro.

Limpeza

Para remover o executável gerado:

make clean

Formatação do código

Para formatar o código-fonte automaticamente:

make format

Estrutura do projeto

├── bin
│   └── vaca
├── .clang-format
├── .clang-tidy
├── compile_flags.txt
├── .gitignore
├── include
│   └── vaca
│       └── vacaDiz.h
├── Makefile
├── README.md
├── src
│   ├── main.c
│   └── vacaDiz.c
└── .vscode
    ├── extensions.json
    ├── settings.json
    └── tasks.json

Este projeto já está configurado para uso no Visual Studio Code (VSCode), incluindo arquivos de configuração e tarefas em .vscode/. No entanto, o uso do VSCode não é obrigatório — você pode compilar e utilizar o projeto normalmente via terminal.

---

Desenvolvido para fins didáticos.

Referências

• .gitignore para C
• clang-tidy
• clang-format
• clangd e clangd compile-commands (compile_flags.txt)
• GNU Makefile Manual

Sugestões de leitura

Para aprofundar seus conhecimentos e facilitar o desenvolvimento em C, confira também:

• C Language – cppreference.com
  Referência moderna e completa da linguagem C.
• Linux man-pages
  (Linux) Documentação oficial das chamadas de sistema, funções de biblioteca e mais.
• The GNU C Manual
  Guia detalhado de extensão da linguagem e práticas recomendadas pelo GNU.