Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kib357/less-go
Less compiler for golang
https://github.com/kib357/less-go
Last synced: 3 months ago
JSON representation
Less compiler for golang
- Host: GitHub
- URL: https://github.com/kib357/less-go
- Owner: kib357
- License: apache-2.0
- Created: 2015-12-08T05:23:05.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-08-21T07:35:37.000Z (almost 7 years ago)
- Last Synced: 2024-01-22T04:40:50.949Z (5 months ago)
- Language: JavaScript
- Size: 2.05 MB
- Stars: 17
- Watchers: 4
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-less - Go Compiler - Runs Less inside embedded Javascript engine. (Ports of Less / Go)
- awesome-github-star - less-go
README
# less-go
## THIS PROJECT IS NO LONGER MAINTAINED, feel free to fork and use as boilerplate for further usages
[](http://travis-ci.org/kib357/less-go)
[Less](http://lesscss.org/) compiler for [Golang](https://golang.org/)
Builds CSS using original [Less compiler](https://github.com/less/less.js) and [Duktape](http://duktape.org/) embeddable Javascript engine
## Status
This project is a work-in-progress, we accept pull requests.
## Installation
```
go get github.com/kib357/less-go
```
## Command Line usage
```
cd $GOPATH/src/github.com/kib357/less-go/lessc
go get
go build
./lessc --input="inputFile" --output="outputFile"
./lessc -i inputFile -o outputFile
```
Examples:
```
./lessc --input="./styles.less" --output="./styles.css"
./lessc -i styles.less -o styles.css
```
More about usage you can see in cli help:
```
./lessc -h
```
## Programmatic usage
```go
import "github.com/kib357/less-go"
func main() {
err := less.RenderFile("./styles.less", "./styles.css", map[string]interface{}{"compress": true})
}
```
### Function reference
#### RenderFile(input, output string, mods ...map[string]interface{}) error
Renders Less and generates output CSS.
#### SetReader(customReader Reader)
```go
type Reader interface {
ReadFile(string) ([]byte, error)
}
```
Sets a custom reader for .less files. You can use it to replace standard input from file system to another. Example:
```go
type LessReader struct{}
var lessFiles = map[string][]byte{"styles": []byte{".class { width: (1 + 1) }"}}
func (LessReader) ReadFile(path string) ([]byte, error) {
lessFile, ok := lessFiles[path]
if !ok {
return "", errors.New("path not found")
}
return lessFile, nil
}
func main() {
less.SetReader(LessReader)
...
}
```
#### SetWriter(customWriter Writer)
```go
type Writer interface {
WriteFile(string, []byte, os.FileMode) error
}
```
Analogue of custom reader, but for output CSS.
## Current limitations
Because of using C Javascript engine, cross compilation not supported. Not tested on Windows.
CLI interface doesnt support options