Итоги — Парсер файлов

Часть раздела Объектно-ориентированное программирование путешествия по GO на Coddy. Урок 58 из 107.

Задание

Легко

Давайте создадим парсер конфигурационных файлов, который объединит все техники обработки ошибок из этой главы. Ваш парсер будет обрабатывать несколько сценариев сбоев с использованием пользовательских типов ошибок, сигнальных ошибок (sentinel errors), оборачивания ошибок и правильной очистки ресурсов с помощью defer.

Вы организуете свой код в трех файлах:

errors.go: Определите инфраструктуру ошибок для парсера.
Создайте две сигнальные ошибки:
- ErrEmptyContent с сообщением "file content is empty"
- ErrInvalidFormat с сообщением "invalid configuration format"
Создайте пользовательский тип ошибки ParseError с полями Line (int) и Message (string). Его метод Error() должен возвращать: parse error at line [Line]: [Message]
parser.go: Создайте парсер конфигурации с многоуровневой обработкой ошибок.
Создайте структуру ConfigParser с логическим полем parsed для отслеживания успешного завершения парсинга.

Реализуйте следующие методы:
- NewConfigParser() *ConfigParser — создает новый парсер с полем parsed, установленным в false
- ParseLine(lineNum int, line string) error — проверяет одну строку. Если строка не содержит символа =, возвращает *ParseError с номером строки и сообщением "missing key-value separator". В противном случае возвращает nil.
- Parse(content string) error — основной метод парсинга, который:
  - Возвращает ErrEmptyContent, если содержимое пустое
  - Возвращает ErrInvalidFormat, если содержимое не содержит хотя бы одного символа новой строки
  - Разбивает содержимое по символам новой строки и вызывает ParseLine для каждой строки (номера строк начинаются с 1)
  - Если ParseLine возвращает ошибку, оборачивает ее с помощью "parsing configuration: %w" и возвращает результат
  - Устанавливает parsed в true при успехе и возвращает nil
- Status() string — возвращает "ready", если parsed равно true, иначе "not parsed"
main.go: Считайте содержимое конфигурации и продемонстрируйте комплексную проверку ошибок.
Считайте две строки ввода, которые вместе образуют содержимое конфигурации (объедините их символом новой строки). Используйте defer, чтобы всегда выводить статус парсера в конце, независимо от успеха или неудачи.

После попытки парсинга проверьте любую возникшую ошибку, используя как errors.Is(), так и errors.As(), чтобы предоставить конкретную обратную связь в зависимости от того, что пошло не так.

Будут предоставлены следующие входные данные:

Строка 1: Первая строка содержимого конфигурации
Строка 2: Вторая строка содержимого конфигурации

Обрабатывайте ошибки со специфическими сообщениями:

Если errors.Is() находит ErrEmptyContent: выведите Error: No configuration provided
Если errors.Is() находит ErrInvalidFormat: выведите Error: Configuration must have multiple lines
Если errors.As() находит *ParseError: выведите полную обернутую ошибку, затем на новой строке выведите Fix line [Line]: [Message]
Если парсинг прошел успешно: выведите Configuration parsed successfully

После обработки результата (успеха или ошибки) отложенный статус должен быть выведен на новой строке: Parser status: [status]

Например, для ввода host=localhost и port=8080 ваш вывод должен быть:

Configuration parsed successfully
Parser status: ready

А для ввода host=localhost и invalid line ваш вывод должен быть:

parsing configuration: parse error at line 2: missing key-value separator
Fix line 2: missing key-value separator
Parser status: not parsed

Попробуйте сами

package main

import (
	"bufio"
	"errors"
	"fmt"
	"os"
)

func main() {
	reader := bufio.NewReader(os.Stdin)
	
	// Чтение первой строки конфигурации
	line1, _ := reader.ReadString('\n')
	line1 = line1[:len(line1)-1] // Удаление завершающего символа новой строки
	
	// Чтение второй строки конфигурации
	line2, _ := reader.ReadString('\n')
	if len(line2) > 0 && line2[len(line2)-1] == '\n' {
		line2 = line2[:len(line2)-1]
	}
	
	// Объединение двух строк символом новой строки для формирования содержимого конфигурации
	content := line1 + "\n" + line2
	
	// Создание нового парсера
	parser := NewConfigParser()
	
	// TODO: Используйте defer, чтобы всегда выводить статус парсера в конце
	// Формат: "Parser status: [status]"
	
	// TODO: Попытайтесь выполнить парсинг содержимого
	
	// TODO: Обработайте ошибки с помощью errors.Is() и errors.As()
	// - Если errors.Is() находит ErrEmptyContent: выведите "Error: No configuration provided"
	// - Если errors.Is() находит ErrInvalidFormat: выведите "Error: Configuration must have multiple lines"
	// - Если errors.As() находит *ParseError: выведите полную обернутую ошибку,
	//   затем на новой строке выведите "Fix line [Line]: [Message]"
	// - Если парсинг прошел успешно: выведите "Configuration parsed successfully"
	
	_ = errors.Is // подсказка: используйте errors.Is для сигнальных ошибок
	_ = errors.As // подсказка: используйте errors.As для пользовательских типов ошибок
	_ = fmt.Println
}