Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/plandem/xlsx
Fast and reliable way to work with Microsoft Excel™ [xlsx] files in Golang
https://github.com/plandem/xlsx
ecma376 excel golang microsoft ooxml openoffice openxml spreadsheet xlsx
Last synced: 20 days ago
JSON representation
Fast and reliable way to work with Microsoft Excel™ [xlsx] files in Golang
- Host: GitHub
- URL: https://github.com/plandem/xlsx
- Owner: plandem
- License: mit
- Created: 2017-08-26T23:11:38.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2020-11-04T15:00:26.000Z (about 4 years ago)
- Last Synced: 2024-08-30T21:38:29.402Z (3 months ago)
- Topics: ecma376, excel, golang, microsoft, ooxml, openoffice, openxml, spreadsheet, xlsx
- Language: Go
- Homepage:
- Size: 2.7 MB
- Stars: 173
- Watchers: 12
- Forks: 24
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-go - xlsx - Fast and safe way to read/update your existing Microsoft Excel files in Go programs. (Microsoft Office / Microsoft Excel)
- zero-alloc-awesome-go - xlsx - Fast and safe way to read/update your existing Microsoft Excel files in Go programs. (Microsoft Office / Microsoft Excel)
- awesome-go - xlsx - Fast and safe way to read/update your existing Excel xlsx files - ★ 26 (Utilities)
- awesome-go-extra - xlsx - 08-26T23:11:38Z|2020-11-04T15:00:26Z| (Microsoft Office / Microsoft Excel)
README
# Xlsx2Go
[](https://travis-ci.org/plandem/xlsx)
[](https://codecov.io/gh/plandem/xlsx)
[](https://goreportcard.com/report/github.com/plandem/xlsx)
[](https://godoc.org/github.com/plandem/xlsx)
[](https://raw.githubusercontent.com/plandem/xlsx/master/LICENSE)
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fplandem%2Fxlsx?ref=badge_shield)
[](https://www.paypal.me/gayvoronsky)
```go
package main
import (
"github.com/plandem/xlsx"
"github.com/plandem/xlsx/format/conditional"
"github.com/plandem/xlsx/format/conditional/rule"
"github.com/plandem/xlsx/format/styles"
)
func main() {
xl := xlsx.New()
defer xl.Close()
//create a new sheet
sheet := xl.AddSheet("The first sheet")
//access by ref
cell := sheet.CellByRef("A2")
//set value
cell.SetValue("Easy Peasy")
//set cool styles
cell.SetStyles(styles.New(
styles.Font.Bold,
styles.Font.Color("#ff0000"),
styles.Fill.Type(styles.PatternTypeSolid),
styles.Fill.Color("#ffff00"),
styles.Border.Color("#009000"),
styles.Border.Type(styles.BorderStyleMedium),
))
//add comment
cell.SetComment("No Comment!")
//add hyperlink
sheet.CellByRef("A4").SetValueWithHyperlink("wikipedia", "http://google.com")
//merge cells
sheet.RangeByRef("A6:A7").Merge()
sheet.CellByRef("A6").SetValue("merged cell")
//iterating
for iRow := 1; iRow < 7; iRow++ {
//access by indexes
cell := sheet.Cell(1, iRow)
cell.SetValue(iRow)
}
//add conditional formatting
sheet.AddConditional(conditional.New(
conditional.AddRule(
rule.Value.Between(1, 3, styles.New(
styles.Font.Bold,
styles.Font.Color("#ff0000"),
)),
),
conditional.AddRule(
rule.IconSet.Type(rule.IconSetType3Arrows),
),
), "B2:B7")
xl.SaveAs("./foo.xlsx")
}
```
## Documentation
* [Guide](https://plandem.github.io/xlsx/)
* [API Documentation](https://godoc.org/github.com/plandem/xlsx)
* [Benchmarks](https://github.com/plandem/xlsx-benchmarks)
# Roadmap
- [ ] sheet: copy
- [ ] sheet: custom filters
- [x] sheet: streaming
- [x] merged cells: merge/split for ranges, cols, rows
- [x] hyperlinks: for cells, ranges, cols, rows
- [x] range: copy
- [x] row: copy
- [x] col: copy
- [x] cell: comments
- [ ] cell: formulas
- [x] cell: typed getter/setter for values
- [x] other: conditional formatting
- [x] other: rich texts
- [ ] other: drawing
- [ ] other: more optimization
- [ ] other: more tests
# Contribution
- To prevent mess, sources have strict separation of markup and functionality. Document that describes OOXML is quite huge (about 6K pages), but the same time - functionality is not.
- All markup resides inside of 'ml' folders, only marshal/unmarshal is allowed here, no any functionality.
- Not every 'ml object' has related 'functional object' and vice versa.
- If you want some functionality, then wrap 'ml object' and do what you want.
### OOXML edition
XML is compliant with part 1 of the [5th edition](http://www.ecma-international.org/publications/standards/Ecma-376.htm) of the ECMA-376 Standard for Office Open XML
## License
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fplandem%2Fxlsx?ref=badge_large)