Rapid Web Development w/ Go
Latest commit d1b8df2 Aug 14, 2018
Permalink
Failed to load latest commit information.
binding updated the integration tests to use gometalinter and setup a bunch o… May 12, 2018
buffalo committed packr files Aug 14, 2018
generators committed packr files Aug 14, 2018
grifts version bump Aug 14, 2018
internal/release removed vbuffalo (#1101) Jun 12, 2018
mail Wip mail embed (#1041) May 12, 2018
meta Fixes broken build tags, again. This time adds an integration test to ( Jun 27, 2018
middleware Success status codes in PopTransaction doc string (#1089) Jun 10, 2018
plugins change the plugin path default from $PATH to $GOPATH/bin Feb 1, 2018
render removed a rogue blackfriday reference Aug 14, 2018
runtime removed a rogue blackfriday reference Aug 14, 2018
servers Allow buffalo to accept preconfigured http.Server(s) fixes #1015 (#1039) May 12, 2018
worker ran gofmt accross the code Jan 8, 2018
.codeclimate.yml ignore the vendor folder for code climate Nov 12, 2017
.codecov.yml Add codecov.io badge (#1100) Jun 12, 2018
.csslintrc Working on adding support for a Resource interface (#30) Dec 10, 2016
.eslintignore Working on adding support for a Resource interface (#30) Dec 10, 2016
.eslintrc Working on adding support for a Resource interface (#30) Dec 10, 2016
.gitignore ignore the .grifter folder Jan 8, 2018
.gometalinter.json updated the integration tests to use gometalinter and setup a bunch o… May 12, 2018
.goreleaser.yml cleaned up the release task, and started to migrate to a package for … Jun 11, 2018
.travis.yml codecov.io code coverage integration (#1087) Jun 11, 2018
BACKERS.md Updated BACKERS.md (#1210) Aug 3, 2018
CONTRIBUTING.md Mention correct repository in contributing.md (#966) May 12, 2018
Dockerfile Fixes broken build tags, again. This time adds an integration test to ( Jun 27, 2018
Dockerfile.build removed vbuffalo (#1101) Jun 12, 2018
Gopkg.toml removed a rogue blackfriday reference Aug 14, 2018
ISSUE_TEMPLATE.md Create ISSUE_TEMPLATE.md Apr 10, 2018
LICENSE.txt added a License Nov 24, 2016
Makefile fixed make test for go.tip Jul 19, 2018
README.md fixed the README Aug 14, 2018
SHOULDERS.md Updated SHOULDERS.md Aug 14, 2018
app.go Allow buffalo to accept preconfigured http.Server(s) fixes #1015 (#1039) May 12, 2018
app_test.go added tests around using/skipping middleware Nov 23, 2016
appveyor.yml added support for the new suite fixture stuff (#972) May 12, 2018
context.go removed deprecations from v0.12.0 (#1095) Jun 10, 2018
cookies.go Add Cookies.Delete method Jul 29, 2017
cookies_test.go Revert changes on cookies_test Dec 12, 2017
default_context.go removed deprecations from v0.12.0 (#1095) Jun 10, 2018
default_context_test.go removed deprecations from v0.12.0 (#1095) Jun 10, 2018
error_templates.go reduces duplicity on app.go and splits errors.go into errors and erro… May 12, 2018
errors.go updated the integration tests to use gometalinter and setup a bunch o… May 12, 2018
flash.go make the Flash#Persist function private Feb 3, 2017
flash_test.go simplifying slice Jan 23, 2018
go.mod removed a rogue blackfriday reference Aug 14, 2018
go.sum removed a rogue blackfriday reference Aug 14, 2018
grifts.go adding missing newline Dec 20, 2017
handler.go Revert "Make app version string available from inside app fixes #1035" ( May 12, 2018
logger.go ran gofmt accross the code Jan 8, 2018
logger_formatter.go updated the integration tests to use gometalinter and setup a bunch o… May 12, 2018
logo.svg added the svg logo to the archive Dec 20, 2016
method_override.go deprecated "Automatic" in favor of just "New". Sep 8, 2017
method_override_test.go deprecated "Automatic" in favor of just "New". Sep 8, 2017
middleware.go Fix #697: concurrent access on keyMap Oct 20, 2017
middleware_test.go updated the integration tests to use gometalinter and setup a bunch o… May 12, 2018
not_found_test.go deprecated "Automatic" in favor of just "New". Sep 8, 2017
options.go maybe this will fix travis (#1085) Jun 2, 2018
options_test.go removes the broken black friday dep and improves go modules support Aug 14, 2018
request_logger.go moving to lowercase logrus Dec 15, 2017
resource.go reduce the noise of resources by not generating it with a new Dec 11, 2017
response.go export Size and Status on Response May 9, 2017
route.go updated the integration tests to use gometalinter and setup a bunch o… May 12, 2018
route_test.go [feature] first attempt at adding named routes and functions on the view Apr 7, 2017
router.go fix resource name handling bug May 12, 2018
router_test.go updated the integration tests to use gometalinter and setup a bunch o… May 12, 2018
server.go Allow buffalo to accept preconfigured http.Server(s) fixes #1015 (#1039) May 12, 2018
session.go sessions lookups should happen up the app parent chain Sep 19, 2017
test.sh added a test.sh file because -tags sqlite needs to be set to run the Feb 28, 2018
wrappers.go fixed signal.Notify to use syscall.SIGTERM May 29, 2017
wrappers_test.go working on #3 Nov 24, 2016

README.md

GoDoc Build Status Windows Build status Code coverage status Go Report Card Open Source Helpers

Buffalo

Buffalo is a Go web development eco-system. Designed to make the life of a Go web developer easier.

Buffalo starts by generating a web project for you that already has everything from front-end (JavaScript, SCSS, etc...) to back-end (database, routing, etc...) already hooked up and ready to run. From there it provides easy APIs to build your web application quickly in Go.

Buffalo isn't just a framework, it's a holistic web development environment and project structure that lets developers get straight to the business of, well, building their business.

I ❤️ web dev in go again - Brian Ketelsen

Documentation

Please visit http://gobuffalo.io for the latest documentation, examples, and more.

Installation

$ go get -u -v github.com/gobuffalo/buffalo/buffalo

NOTE: Buffalo has a minimum Go dependency of 1.8.1.

Buffalo also depends on:

  • gcc for go-sqlite3 which is a cgo package.
  • node and npm for the asset pipeline.

Generating a new Project

Buffalo aims to make building new web applications in Go as simple as possible, and what could be more simple than a new application generator?

$ buffalo new <name>

That will generate a whole new Buffalo application that is ready to go. It'll even run go get for you to make sure you have all of the necessary dependencies needed to run your application.

To see a list of available flags for the new command, just check out its help.

$ buffalo help new

Running your application

Buffalo is Go "standards" compliant. That means you can just build your binary and run it. It's that simple.

Running your application in Development

One of the downsides to Go development is the lack of code "reloading". This means as you change your code you need to manually stop your application, rebuild it, and then restart it. Buffalo finds this is annoying and wants to make life better for you.

$ buffalo dev

The dev command will watch your .go and .html files by default, rebuild, and restart your binary for you so you don't have to worry about such things. Just run the dev command and start coding.

Testing your application

Just like running your application, Buffalo doesn't stop you from using the standard Go tools for testing. Buffalo does ship with a test command that will run all of your tests while conveniently skipping that pesky old ./vendor directory!

$ buffalo test

Shoulders of Giants

Buffalo would not be possible if not for all of the great projects it depends on. Please see SHOULDERS.md to see a list of them.

Templating

github.com/gobuffalo/plush - This templating package was chosen over the standard Go html/template package for a variety of reasons. The biggest of which is that it is significantly more flexible and easy to work with.

Routing

github.com/gorilla/mux - This router was chosen because of its stability and flexibility. There might be faster routers out there, but this one is definitely the most powerful!

Task Runner (Optional)

github.com/markbates/grift - If you're familiar with Rake tasks from Ruby, you'll be right at home using Grift. This package was chosen to allow for the easy running of simple, and common, tasks that most web applications need. Think things like seeding a database or taking in a CSV file and generating database records. Buffalo ships with an example routes task that prints off the defined routes and the function that handles those requests.

Models/ORM (Optional)

github.com/gobuffalo/pop - Accessing databases is nothing new in web applications. Pop, and its command line tool, Soda, were chosen because they strike a nice balance between simplifying common tasks, being idiomatic, and giving you the flexibility you need to built your app. Pop and Soda share the same core philosphies as Buffalo so they were a natural choice.

Sessions, Cookies, Websockets, and more...

github.com/gorilla - The Gorilla toolkit is a great set of packages designed to improve upon the standard library for a variety of web-related packages. With these high quality packages Buffalo is able to keep its "core" code to a minimum and focus on its goal of glueing them all together to make your life better.

Benchmarks

Oh, yeah, everyone wants benchmarks! What would a web framework be without its benchmarks? Well, guess what? I'm not giving you any! That's right. This is Go! I assure you that it is plenty fast enough for you. If you want benchmarks you can either a) checkout any benchmarks that the GIANTS Buffalo is built upon have published, or b) run your own. I have no interest in playing the benchmark game, and neither should you.

Contributing

First, thank you so much for wanting to contribute! It means so much that you care enough to want to contribute. We appreciate every PR from the smallest of typos to the be biggest of features.

To contribute, please read the contribution guidelines: CONTRIBUTING