README

NOTICE
Effective immediately: XLSX has been migrated to [[https://codeberg.org/tealeg/xlsx][codeberg]] and it's version bumped to v4.

No further support or maintenance will be provided on the GitHub
hosted version of this repository.  Please migrate to codeberg if you
wish to contribute to or use this library.

 XLSX

[[https://github.com/tealeg/xlsx/actions/workflows/go.yml][https://github.com/tealeg/xlsx/actions/workflows/go.yml/badge.svg?branch=master]]
[[https://codecov.io/gh/tealeg/xlsx][https://codecov.io/gh/tealeg/xlsx/branch/master/graph/badge.svg]]
[[https://pkg.go.dev/github.com/tealeg/xlsx/v3][https://pkg.go.dev/badge/github.com/tealeg/xlsx/v3.svg]]
[[https://github.com/tealeg/xlsxlicense][https://img.shields.io/badge/license-bsd-orange.svg]]

 Introduction
xlsx is a library to simplify reading and writing the XML format, used
by versions of Microsoft Excel since 2002, in Go programs.

 Current status
We're back! The will of the people has spoken.  [[https://github.com/tealeg][I]] tried to slowly let
this die, but the patches keep coming in, and people keep expressing
frustration at the alternatives.  So, the fate of this library
lies with you all. [[https://github.com/tealeg][I]] will review patches, make releases, etc.  [[https://github.com/tealeg][I]]
don't plan to take on any new development work here myself, but I will
attempt to support you if you do.

 Tutorial

If you'd like an introduction to this project try the [[https://github.com/tealeg/xlsx/blob/master/tutorial/tutorial.adoc][tutorial]].

 Different versions of this project

 Prior to v1.0.0

You don't want these versions ;-)

It's hard to remember exactly, but work on this library started within
a month of the first public announcement of Go, now more than a decade
ago.  It was essentially a quick hack to get data out of XLSX files at
my workplace.  Nobody but me relied on it, so it was fine to use this
brand new language for this task. Somewhat later I decided to share
the code, and I know it was well established as an open-source project
by the time I left that job in late 2011.

Although I did do some "release" tags, versioning in Go in the early
days relied on tagging your code with the name of the Go release
(i.e. go1.2) and then go get would fetch that tag, if it existed,
and if not, it'd grab the master branch.

 Version 1.x.x

Version 1.0.0 was tagged in 2017 to support vendoring tools.

As of October 8th, 2019, I've branched off v1.x.x maintenance work
from master.  The master branch now tracks v2.x.x.

If you have existing code, can live with the issues in the 1.x.x
codebase, and don't want to update your code to use a later version,
then you can stick to these releases.  I mostly won't be touching this
code, but if something really important comes up, let me know.

 Version 2.x.x

Version 2.0.0 introduced breaking changes in the API.

The scope of these changes included the way Col elements and
DataValidation works, as these aspects have been built around
inc