Skip to content

Latest commit

 

History

History
48 lines (34 loc) · 2.03 KB

README.md

File metadata and controls

48 lines (34 loc) · 2.03 KB

USFM Toolkit

Build Status Coverage Status GoDoc MIT License

A toolkit to analyze, parse & convert USFM formatted text files.

Visit the wiki for documentation about the usage, architecture etc.,

Development

If you are interested to contribute to this project, please follow the instruction given here.

  1. Install Go compiler
  2. Run this command to get source code: go get github.com/socceroos/usfm (Git is a prerequisite)

The code will be available under $GOPATH/src/github.com/socceroos/usfm You will also a get an executable binary under $GOPATH/bin/usfm.

You can fork the project from the original Github project and push your changes there. Later you can send pull request with your changes. Before sending the pull request, make sure the tests are running locally using this command:

go test ./...

I also recommend to run these tools:

  1. go fmt - format the code as per the Go community standard
  2. go vet - reports suspicious constructs
  3. golint - reports more lint issues

Please run these commands before sending pull request. This will help us to maintain the quality of code. You can run the run.sh shell script to run all the above mentioned tools including tests.

Credits

The parser is created based on the article written by Ben Johnson