Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/go-the-way/exl
Excel binding to struct written in Go.(Only supports Go1.18+)
https://github.com/go-the-way/exl
Last synced: about 1 month ago
JSON representation
Excel binding to struct written in Go.(Only supports Go1.18+)
- Host: GitHub
- URL: https://github.com/go-the-way/exl
- Owner: go-the-way
- License: other
- Created: 2022-04-19T06:04:31.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-23T03:07:17.000Z (about 1 month ago)
- Last Synced: 2024-04-23T06:40:24.905Z (about 1 month ago)
- Language: Go
- Homepage:
- Size: 63.5 KB
- Stars: 26
- Watchers: 0
- Forks: 7
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-go - exl - Excel binding to struct written in Go.(Only supports Go1.18+) (Microsoft Office / Microsoft Excel)
- awesome-go - exl - Excel binding to struct written in Go.(Only supports Go1.18+) (Microsoft Office / Microsoft Excel)
- awesome-go-extra - exl - 04-19T06:04:31Z|2022-06-24T09:24:36Z| (Microsoft Office / Microsoft Excel)
- awesome-go - exl - Excel binding to struct written in Go.(Only supports Go1.18+) (Microsoft Office / Microsoft Excel)
- awesome-go - exl - Excel binding to struct written in Go.(Only supports Go1.18+) (Microsoft Office / Microsoft Excel)
- awesome-go - exl - Excel binding to struct written in Go.(Only supports Go1.18+) (Microsoft Office / Microsoft Excel)
- awesome-go-cn - exl - the-way/exl) (微软办公软件 / Microsoft Excel)
- zero-alloc-awesome-go - exl - Excel binding to struct written in Go.(Only supports Go1.18+) (Microsoft Office / Microsoft Excel)
- awesome-go-stars - exl(stars: 26) - Excel binding to struct written in Go.(Only supports Go1.18+) (Microsoft Office / Microsoft Excel)
- awesome-go-with-stars - exl - Excel binding to struct written in Go.(Only supports Go1.18+) (Microsoft Office / Microsoft Excel)
- repo-1316-awesome-go-cn - exl - the-way/exl) (微软办公软件 / Microsoft Excel)
- repo-1211-awesome-go-cn - exl - the-way/exl) (微软办公软件 / Microsoft Excel)
- Go-awesome - exl - Excel binding to struct written in Go.(Only supports Go1.18+) (Microsoft Office / Microsoft Excel)
- awesome-go-cn - exl - the-way/exl) (微软办公软件 / Microsoft Excel)
- awesome-go - exl - Excel binding to struct written in Go.(Only supports Go1.18+) (Microsoft Office / Microsoft Excel)
- awesome-go-zh - exl - the-way/exl) (微软办公软件 / Microsoft Excel)
- awesome-go - exl - Excel binding to struct written in Go.(Only supports Go1.18+) (Microsoft Office / Microsoft Excel)
- awesome-go - exl - Excel binding to struct written in Go.(Only supports Go1.18+) (Microsoft Office / Microsoft Excel)
README
# exl
Excel binding to struct written in Go.(Only supports Go1.18+)
[](https://circleci.com/gh/go-the-way/exl/tree/main)
[](https://codecov.io/gh/go-the-way/exl)
[](https://goreportcard.com/report/github.com/go-the-way/exl)
[](https://pkg.go.dev/github.com/go-the-way/exl?tab=doc)
[](https://github.com/avelino/awesome-go#microsoft-excel)
## usage
### Read Excel
```go
package main
import (
"fmt"
"github.com/go-the-way/exl"
)
type ReadExcel struct {
ID int `excel:"ID"`
Name string `excel:"Name"`
}
func (*ReadExcel) ReadConfigure(rc *exl.ReadConfig) {}
func main() {
if models, err := exl.ReadFile[*ReadExcel]("/to/path.xlsx"); err != nil {
fmt.Println("read excel err:" + err.Error())
} else {
fmt.Printf("read excel num: %d\n", len(models))
}
}
```
### Write Excel
```go
package main
import (
"fmt"
"github.com/go-the-way/exl"
)
type WriteExcel struct {
ID int `excel:"ID"`
Name string `excel:"Name"`
}
func (m *WriteExcel) WriteConfigure(wc *exl.WriteConfig) {}
func main() {
if err := exl.Write("/to/path.xlsx", []*WriteExcel{{100, "apple"}, {200, "pear"}}); err != nil {
fmt.Println("write excel err:" + err.Error())
} else {
fmt.Println("write excel done")
}
}
```
## Writer
```go
package main
import (
"fmt"
"github.com/go-the-way/exl"
)
func main() {
w := exl.NewWriter()
if err := w.Write("int", []int{1, 2}); err != nil {
fmt.Println(err)
return
}
if err := w.Write("float", []float64{1.1, 2.2}); err != nil {
fmt.Println(err)
return
}
if err := w.Write("string", []string{"hello", "world"}); err != nil {
fmt.Println(err)
return
}
if err := w.Write("map", []map[string]string{{"id":"1000","name":"hello"},{"id":"2000","name":"world"}}); err != nil {
fmt.Println(err)
return
}
if err := w.Write("structWithField", []struct{ID int}{{1000},{2000}}); err != nil {
fmt.Println(err)
return
}
if err := w.Write("structWithTag", []struct{ID int `excel:"编号"`}{{1000},{2000}}); err != nil {
fmt.Println(err)
return
}
if err := w.Write("structWithTagAndIgnore", []struct{
ID int `excel:"编号"`
Extra int `excel:"-"`
Name string `excel:"名称"`
}{{1000,0,"Coco"},{2000,0,"Apple"}}); err != nil {
fmt.Println(err)
return
}
if err := w.SaveTo("dist.xlsx"); err != nil {
fmt.Println(err)
return
}
}
```