Скачать gosax - скачать исходный код gosax

gosax

Другой исходный код

1.0.0

Скачать

госакс

gosax — это библиотека Go для анализа XML SAX (Simple API for XML), поддерживающая функцию только для чтения. Эта библиотека предназначена для эффективного и бережного к памяти синтаксического анализа XML, черпая вдохновение из различных источников для обеспечения производительного синтаксического анализатора.

Функции

Анализ SAX только для чтения : потоковая передача и обработка XML-документов без загрузки всего документа в память.
Эффективный синтаксический анализ : для высокой производительности используются методы, основанные на quick-xml и pkg/json .
SWAR (SIMD Within A Register) : оптимизация для быстрой обработки текста, вдохновленная memchr .
Совместимость с кодированием/xml : включает служебные функции для объединения типов gosax с типами encoding/xml , что упрощает интеграцию с существующим кодом, использующим стандартную библиотеку.

Контрольный показатель

 goos: darwin
goarch: arm64
pkg: github.com/orisano/gosax
BenchmarkReader_Event-12    	       5	 211845800 ns/op	1103.30 MB/s	 2097606 B/op	       6 allocs/op

Установка

Чтобы установить gosax , используйте go get :

go get github.com/orisano/gosax

Использование

Вот базовый пример использования gosax для анализа XML-документа:

 package main

import (
	"fmt"
	"log"
	"strings"

	"github.com/orisano/gosax"
)

func main () {
	xmlData := `<root><element>Value</element></root>`
	reader := strings . NewReader ( xmlData )

	r := gosax . NewReader ( reader )
	for {
		e , err := r . Event ()
		if err != nil {
			log . Fatal ( err )
		}
		if e . Type () == gosax . EventEOF {
			break
		}
		fmt . Println ( string ( e . Bytes ))
	}
	// Output:
	// <root>
	// <element>
	// Value
	// </element>
	// </root>
}

Соединение с кодировкой/xml

Важное примечание для пользователей кодирования/xml:

При переходе encoding/xml на gosax обратите внимание, что самозакрывающиеся теги обрабатываются по-другому. Чтобы имитировать поведение encoding/xml , установите для gosax.Reader.EmitSelfClosingTag значение true . Это гарантирует правильное распознавание и обработку самозакрывающихся тегов.

Использование токенаE

Если вы привыкли кодировать Token encoding/xml , начните с gosax.TokenE . Примечание. Использование gosax.TokenE и gosax.Token предполагает выделение памяти из-за интерфейсов.

До:

 var dec * xml. Decoder
for {
	tok , err := dec . Token ()
	if err == io . EOF {
		break
	}
	// ...
}

После:

 var dec * gosax. Reader
for {
	tok , err := gosax . TokenE ( dec . Event ())
	if err == io . EOF {
		break
	}
	// ...
}

Использование xmlb

xmlb — это расширение для gosax , упрощающее переписывание кода encoding/xml . Он обеспечивает более высокопроизводительный мост для анализа и обработки XML.

До:

 var dec * xml. Decoder
for {
	tok , err := dec . Token ()
	if err == io . EOF {
		break
	}
	switch t := tok .( type ) {
	case xml. StartElement :
		// ...
	case xml. CharData :
		// ...
	case xml. EndElement :
		// ...
	}
}

После:

 var dec * xmlb. Decoder
for {
	tok , err := dec . Token ()
	if err == io . EOF {
		break
	}
	switch tok . Type () {
	case xmlb . StartElement :
		t , _ := tok . StartElement ()
		// ...
	case xmlb . CharData :
		t , _ := tok . CharData ()
		// ...
	case xmlb . EndElement :
		t := tok . EndElement ()
		// ...
	}
}