mirror of
https://codeberg.org/forgejo/forgejo.git
synced 2024-08-26 06:28:03 +02:00
* update github.com/alecthomas/chroma v0.8.0 -> v0.8.1 * github.com/blevesearch/bleve v1.0.10 -> v1.0.12 * editorconfig-core-go v2.1.1 -> v2.3.7 * github.com/gliderlabs/ssh v0.2.2 -> v0.3.1 * migrate editorconfig.ParseBytes to Parse * github.com/shurcooL/vfsgen to 0d455de96546 * github.com/go-git/go-git/v5 v5.1.0 -> v5.2.0 * github.com/google/uuid v1.1.1 -> v1.1.2 * github.com/huandu/xstrings v1.3.0 -> v1.3.2 * github.com/klauspost/compress v1.10.11 -> v1.11.1 * github.com/markbates/goth v1.61.2 -> v1.65.0 * github.com/mattn/go-sqlite3 v1.14.0 -> v1.14.4 * github.com/mholt/archiver v3.3.0 -> v3.3.2 * github.com/microcosm-cc/bluemonday 4f7140c49acb -> v1.0.4 * github.com/minio/minio-go v7.0.4 -> v7.0.5 * github.com/olivere/elastic v7.0.9 -> v7.0.20 * github.com/urfave/cli v1.20.0 -> v1.22.4 * github.com/prometheus/client_golang v1.1.0 -> v1.8.0 * github.com/xanzy/go-gitlab v0.37.0 -> v0.38.1 * mvdan.cc/xurls v2.1.0 -> v2.2.0 Co-authored-by: Lauris BH <lauris@nix.lv>
130 lines
2.9 KiB
Markdown
Vendored
130 lines
2.9 KiB
Markdown
Vendored
![Build Status](https://github.com/editorconfig/editorconfig-core-go/workflows/.github/workflows/main.yml/badge.svg)
|
|
[![GoDoc](https://godoc.org/github.com/editorconfig/editorconfig-core-go?status.svg)](https://godoc.org/github.com/editorconfig/editorconfig-core-go)
|
|
[![Go Report Card](https://goreportcard.com/badge/github.com/editorconfig/editorconfig-core-go)](https://goreportcard.com/report/github.com/editorconfig/editorconfig-core-go)
|
|
|
|
# Editorconfig Core Go
|
|
|
|
A [Editorconfig][editorconfig] file parser and manipulator for Go.
|
|
|
|
## Missing features
|
|
|
|
- escaping comments in values, probably in [go-ini/ini](https://github.com/go-ini/ini)
|
|
|
|
## Installing
|
|
|
|
We recommend the use of Go 1.13+ modules for this package.
|
|
|
|
Import by the same path. The package name you will use to access it is
|
|
`editorconfig`.
|
|
|
|
```go
|
|
import "github.com/editorconfig/editorconfig-core-go/v2"
|
|
```
|
|
|
|
## Usage
|
|
|
|
### Parse from file
|
|
|
|
```go
|
|
fp, err := os.Open("path/to/.editorconfig")
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
defer fp.Close()
|
|
|
|
editorConfig, err := editorconfig.Parse(fp)
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
```
|
|
|
|
### Parse from slice of bytes
|
|
|
|
```go
|
|
data := []byte("...")
|
|
editorConfig, err := editorconfig.ParseBytes(data)
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
```
|
|
|
|
### Get definition to a given filename
|
|
|
|
This method builds a definition to a given filename.
|
|
This definition is a merge of the properties with selectors that matched the
|
|
given filename.
|
|
The lasts sections of the file have preference over the priors.
|
|
|
|
```go
|
|
def := editorConfig.GetDefinitionForFilename("my/file.go")
|
|
```
|
|
|
|
This definition have the following properties:
|
|
|
|
```go
|
|
type Definition struct {
|
|
Selector string
|
|
|
|
Charset string
|
|
IndentStyle string
|
|
IndentSize string
|
|
TabWidth int
|
|
EndOfLine string
|
|
TrimTrailingWhitespace *bool
|
|
InsertFinalNewline *bool
|
|
Raw map[string]string
|
|
}
|
|
```
|
|
|
|
#### Automatic search for `.editorconfig` files
|
|
|
|
If you want a definition of a file without having to manually
|
|
parse the `.editorconfig` files, you can then use the static version
|
|
of `GetDefinitionForFilename`:
|
|
|
|
```go
|
|
def, err := editorconfig.GetDefinitionForFilename("foo/bar/baz/my-file.go")
|
|
```
|
|
|
|
In the example above, the package will automatically search for
|
|
`.editorconfig` files on:
|
|
|
|
- `foo/bar/baz/.editorconfig`
|
|
- `foo/baz/.editorconfig`
|
|
- `foo/.editorconfig`
|
|
|
|
Until it reaches a file with `root = true` or the root of the filesystem.
|
|
|
|
### Generating a .editorconfig file
|
|
|
|
You can easily convert a Editorconfig struct to a compatible INI file:
|
|
|
|
```go
|
|
// serialize to slice of bytes
|
|
data, err := editorConfig.Serialize()
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
|
|
// save directly to file
|
|
err := editorConfig.Save("path/to/.editorconfig")
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
```
|
|
|
|
## Contributing
|
|
|
|
To run the tests:
|
|
|
|
```bash
|
|
go test -v ./...
|
|
```
|
|
|
|
To run the [integration tests](https://github.com/editorconfig/editorconfig-core-test):
|
|
|
|
```
|
|
make test-core
|
|
```
|
|
|
|
[editorconfig]: https://editorconfig.org/
|