/ xlsx

Введение

xlsx — это библиотека для упрощения чтения и записи формата XML, используемого последней версией Microsoft Excel в программах Go.

Учебное пособие

Если вы хотите познакомиться с этим проектом, попробуйте новое руководство.

Различные версии этого проекта

До v1.0.0

Вам не нужны эти версии 😉

Трудно вспомнить точно, но работа над этой библиотекой началась через месяц после первого публичного анонса Go, а теперь более десяти лет назад . По сути, это был быстрый способ получить данные из файлов XLSX на моем рабочем месте. Никто, кроме меня, не полагался на него, поэтому было нормально использовать этот новый язык для этой задачи. Несколько позже я решил поделиться кодом, и я знаю, что к тому времени, когда я оставил эту работу в конце 2011 года, он был хорошо зарекомендовал себя как проект с открытым исходным кодом.

Хотя я все же сделал несколько «релизов». теги, управление версиями в Go в первые дни полагалось на пометку вашего кода с именем выпуска Go (например, go1.2), а затем `go get` извлекает этот тег, если он существует, а если нет, он захватывает главная ветка.

Версия 1.xx

Версия 1.0.0 была помечена в 2017 году для поддержки инструментов вендора.

По состоянию на 8 октября 2019 г., я перестал работать с v1.xx от мастера. Основная ветка теперь отслеживает v2.xx

Если у вас есть существующий код, вы можете жить с проблемами в кодовой базе 1.xx и не хотите обновлять свой код для использования более поздней версии, тогда вы можете придерживаться этих релизов. Я в основном не буду касаться этого кода, но если появится что-то действительно важное, дайте мне знать.

Версия 2.xx

Версия 2.0.0 представила нарушение изменения в API.

Объем этих изменений включал способ работы элементов `Col` и` DataValidation`, поскольку эти аспекты были построены вокруг неправильных моделей базового формата XLSX.

Подробности см. на https://github.com/tealeg/xlsx/milestone/5.

Версия 2.0.1 была помечена только потому, что 2.0.0 не обрабатывалась правильно в отношении того, как работают модули go. Невозможно использовать 2.0.0 из проекта, основанного на Go Modules.

Версия 3.xx

Версия 3.0.0 вносит еще несколько критических изменений в API. Все методы, которые могут возвращать структуру `xlsx.File`, теперь принимают ноль, одну или несколько функций` xlsx.FileOption` в качестве своих конечных аргументов. Их можно использовать для изменения поведения результирующей структуры — в частности, они заменяют варианты `… WithRowLimit` этих методов результатом вызова` xlsx.RowLimit` и добавляют возможность определять настраиваемое хранилище резервных копий для электронной таблицы данные, которые будут храниться во время обработки.

StreamFileBuilder был удален из этой версии библиотеки, так как стало трудно поддерживать.

Полная документация по API

Полную документацию по API можно просмотреть с помощью встроенного инструмента документации go или онлайн на сайте godoc.org.

Содействие

Мы очень рады рассмотреть запросы на вытягивание. Пожалуйста, проявите терпение, поддержка XLSX не приносит чьей-либо зарплаты (насколько мне известно).

Если вы хотите предложить изменение, убедитесь, что соблюдены следующие условия:

  • Все существующие тесты проходят успешно.
  • В наборе тестов есть тесты, которые охватывают вносимые вами изменения.
  • Вы добавили строки документации (на английском языке) для (по крайней мере) общедоступных функций, которые вы добавили или изменили.
  • Использование или создание вами XML соответствует части 1 4-го издания ECMA- 376 Standard для Office Open XML.

Ешьте персик — Джефф

Оцените статью
techsly.ru
Добавить комментарий