Number lines

Quem aprendeu a programar nos anos 1980 conhece números de linha num sentido completamente diferente: em BASIC, cada linha de código precisava de um número explícito — `10 PRINT 'OLÁ'`, `20 GOTO 10`. Não era opcional; era a sintaxe da linguagem. O número de linha era o endereço da instrução, e `GOTO 100` significava literalmente saltar para a linha 100. Isso tornava a refatoração um pesadelo: inserir uma nova linha entre 10 e 20 exigia renumerar tudo, o que levou ao surgimento de convenções como usar múltiplos de 10 para deixar espaço. Editores modernos de BASIC chegaram a ter um comando `RENUM` que renumerava automaticamente o arquivo inteiro. Quando as linguagens estruturadas como C e Pascal substituíram o BASIC como linguagem de ensino nos anos 1990, os números de linha sumiram da sintaxe — mas continuaram indispensáveis como metadados de ferramenta.

Hoje os números de linha são onipresentes como sistema de referência. O formato de saída do `grep -n` inclui o número da linha para cada correspondência — é a diferença entre encontrar no arquivo e encontrar na linha 347 do arquivo. Mensagens de erro de compiladores e interpretadores como GCC, Python e rustc sempre incluem linha e coluna: `TypeError: unsupported operand type(s) for +: 'int' and 'str' (line 23)`. O formato de diff unificado do `git diff` usa cabeçalhos como `@@ -15,7 +15,9 @@` para indicar quais linhas foram alteradas — e revisores de pull request no GitHub e GitLab clicam em números de linha para adicionar comentários inline. Editores como VS Code e Vim têm comandos como `:23` que levam o cursor diretamente a uma linha específica.

Esta ferramenta resolve o problema inverso: você tem um bloco de texto sem numeração e precisa adicionar números para criar um documento referenciável. Casos de uso práticos: transformar uma lista de termos ou itens em formato numerado para incluir em documentação técnica; preparar pseudocódigo ou roteiro de apresentação com números de etapa; adicionar prefixos de linha a logs para criar referências cruzadas; criar exercícios ou provas com questões numeradas a partir de um rascunho. O separador e a largura de padding são configuráveis — `001.`, `1:`, `1 -` — dependendo do contexto onde o output será usado.

Anyone who learned programming in the 1980s knows line numbers in a completely different sense: in BASIC, every line of code required an explicit number — `10 PRINT 'HELLO'`, `20 GOTO 10`. It was not optional; it was the syntax of the language. The line number was the address of the instruction, and `GOTO 100` literally meant jump to line 100. This made refactoring a nightmare: inserting a new line between 10 and 20 required renumbering everything, which gave rise to conventions like using multiples of 10 to leave room. Modern BASIC editors even introduced a `RENUM` command that automatically renumbered the entire file. When structured languages like C and Pascal replaced BASIC as the teaching language in the 1990s, line numbers disappeared from syntax — but remained indispensable as tool metadata.

Today line numbers are ubiquitous as a reference system. The `grep -n` output format includes the line number for each match — the difference between found it in the file and found it at line 347 of the file. Error messages from compilers and interpreters like GCC, Python, and rustc always include line and column: `TypeError: unsupported operand type(s) for +: 'int' and 'str' (line 23)`. The unified diff format from `git diff` uses headers like `@@ -15,7 +15,9 @@` to indicate which lines changed — and pull request reviewers on GitHub and GitLab click on line numbers to add inline comments. Editors like VS Code and Vim have commands like `:23` that jump the cursor directly to a specific line.

This tool solves the inverse problem: you have a block of text without numbering and need to add numbers to create a referenceable document. Practical use cases: turning a list of terms or items into numbered format for technical documentation; preparing pseudocode or a presentation script with step numbers; adding line prefixes to log output to create cross-references; creating exercises or exams with numbered questions from a draft. The separator and padding width are configurable — `001.`, `1:`, `1 -` — depending on the context where the output will be used.

Quien aprendió a programar en los años ochenta conoce los números de línea en un sentido completamente diferente: en BASIC, cada línea de código necesitaba un número explícito — `10 PRINT 'HOLA'`, `20 GOTO 10`. No era opcional; era la sintaxis del lenguaje. El número de línea era la dirección de la instrucción, y `GOTO 100` significaba literalmente saltar a la línea 100. Esto hacía que refactorizar fuera una pesadilla: insertar una nueva línea entre 10 y 20 obligaba a renumerar todo, lo que dio lugar a convenciones como usar múltiplos de 10 para dejar espacio. Los editores modernos de BASIC llegaron a incorporar un comando `RENUM` que renumeraba automáticamente todo el archivo. Cuando los lenguajes estructurados como C y Pascal sustituyeron al BASIC como lenguaje de enseñanza en los años noventa, los números de línea desaparecieron de la sintaxis — pero siguieron siendo indispensables como metadatos de herramienta.

Hoy los números de línea son ubicuos como sistema de referencia. El formato de salida de `grep -n` incluye el número de línea de cada coincidencia — la diferencia entre lo encontré en el archivo y lo encontré en la línea 347 del archivo. Los mensajes de error de compiladores e intérpretes como GCC, Python y rustc siempre incluyen línea y columna: `TypeError: unsupported operand type(s) for +: 'int' and 'str' (line 23)`. El formato de diff unificado de `git diff` usa encabezados como `@@ -15,7 +15,9 @@` para indicar qué líneas cambiaron — y los revisores de pull request en GitHub y GitLab hacen clic en los números de línea para añadir comentarios inline. Editores como VS Code y Vim tienen comandos como `:23` que llevan el cursor directamente a una línea específica.

Esta herramienta resuelve el problema inverso: tienes un bloque de texto sin numerar y necesitas añadir números para crear un documento referenciable. Casos de uso prácticos: convertir una lista de términos o ítems a formato numerado para documentación técnica; preparar pseudocódigo o guión de presentación con números de paso; añadir prefijos de línea a logs para crear referencias cruzadas; crear ejercicios o exámenes con preguntas numeradas a partir de un borrador. El separador y el ancho de relleno son configurables — `001.`, `1:`, `1 -` — según el contexto en que se usará el resultado.