Mirrors/go-inbucket
1
0
Fork 0
mirror of https://github.com/jhillyerd/inbucket.git synced 2025-12-17 17:47:03 +00:00
Code Issues Releases Wiki Activity

Readme updates (#183)

Browse Source 
* Add docker build badge
* Rephrase things
* add dev guide link
* Remove brew tap section until #68 is fixed
This commit is contained in:
James Hillyerd
2020-09-23 20:43:51 -07:00
committed by GitHub
parent 361bbec293
commit 698b0406c8
1 changed files with 30 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
README.md
View File

@@ -1,11 +1,12 @@
Inbucket Inbucket
============================================================================= =============================================================================
[![Build Status](https://travis-ci.org/inbucket/inbucket.png?branch=master)][Build Status] [![Build Status](https://travis-ci.org/inbucket/inbucket.png?branch=master)][Build Status]
[![Docker Image](https://github.com/inbucket/inbucket/workflows/Docker%20Image/badge.svg)][Docker Image]
Inbucket is an email testing service; it will accept messages for any email Inbucket is an email testing service; it will accept messages for any email
address and make them available via web, REST and POP3. Once compiled, address and make them available via web, REST and POP3 interfaces. Once
Inbucket does not have any external dependencies (HTTP, SMTP, POP3 and storage compiled, Inbucket does not have any external dependencies - HTTP, SMTP, POP3
are all built in). and storage are all built in.
A Go client for the REST API is available in A Go client for the REST API is available in
`github.com/inbucket/inbucket/pkg/rest/client` - [Go API docs] `github.com/inbucket/inbucket/pkg/rest/client` - [Go API docs]
@@ -14,6 +15,7 @@ Read more at the [Inbucket Website]
![Screenshot](http://www.inbucket.org/images/inbucket-ss1.png "Viewing a message") ![Screenshot](http://www.inbucket.org/images/inbucket-ss1.png "Viewing a message")
## Development Status ## Development Status
Inbucket is currently production quality: it is being used for real work. Inbucket is currently production quality: it is being used for real work.
@@ -29,15 +31,6 @@ tracks our `master` branch (releases), `latest` tracks our unstable
`development` branch. `development` branch.
## Homebrew Tap
(currently broken, being tracked in [issue
#68](https://github.com/inbucket/inbucket/issues/68))
Inbucket has an OS X [Homebrew] tap available as [jhillyerd/inbucket][Homebrew Tap],
see the `README.md` there for installation instructions.
## Building from Source ## Building from Source
You will need functioning [Go] and [Node.js] installations for this to work. You will need functioning [Go] and [Node.js] installations for this to work.
@@ -45,17 +38,20 @@ You will need functioning [Go] and [Node.js] installations for this to work.
```sh ```sh
git clone https://github.com/inbucket/inbucket.git git clone https://github.com/inbucket/inbucket.git
cd inbucket/ui cd inbucket/ui
npm i npm ci
npm run build npm run build
cd .. cd ..
go build ./cmd/inbucket go build ./cmd/inbucket
``` ```
_Note:_ You may also use the included Makefile to build and test the Go binaries. For more information on building and development flows, check out the
[Development Quickstart] page of our wiki.
### Configure and Launch
Inbucket reads its configuration from environment variables, but comes with Inbucket reads its configuration from environment variables, but comes with
built in sane defaults. It should work on most Unix and OS X machines as is. reasonable defaults built-in. It should work on most Unix and OS X machines as
Launch the daemon: is. Launch the daemon:
```sh ```sh
./inbucket ./inbucket
@@ -65,12 +61,12 @@ By default the SMTP server will be listening on localhost port 2500 and
the web interface will be available at [localhost:9000](http://localhost:9000/). the web interface will be available at [localhost:9000](http://localhost:9000/).
See doc/[config.md] for more information on configuring Inbucket, but you will See doc/[config.md] for more information on configuring Inbucket, but you will
likely find the [Configurator] tool easier to use. likely find the [Configurator] tool the easiest way to generate a configuration.
## About ## About
Inbucket is written in [Go] Inbucket is written in [Go] and [Elm].
Inbucket is open source software released under the MIT License. The latest Inbucket is open source software released under the MIT License. The latest
version can be found at https://github.com/inbucket/inbucket version can be found at https://github.com/inbucket/inbucket
@@ -80,10 +76,12 @@ version can be found at https://github.com/inbucket/inbucket
[config.md]: https://github.com/inbucket/inbucket/blob/master/doc/config.md [config.md]: https://github.com/inbucket/inbucket/blob/master/doc/config.md
[Configurator]: https://www.inbucket.org/configurator/ [Configurator]: https://www.inbucket.org/configurator/
[CONTRIBUTING.md]: https://github.com/inbucket/inbucket/blob/develop/CONTRIBUTING.md [CONTRIBUTING.md]: https://github.com/inbucket/inbucket/blob/develop/CONTRIBUTING.md
[Development Quickstart]: https://github.com/inbucket/inbucket/wiki/Development-Quickstart
[Docker Image]: https://www.inbucket.org/binaries/docker.html [Docker Image]: https://www.inbucket.org/binaries/docker.html
[Elm]: https://elm-lang.org/
[From Source]: https://www.inbucket.org/installation/from-source.html [From Source]: https://www.inbucket.org/installation/from-source.html
[Go]: https://golang.org/ [Go]: https://golang.org/
[Go API docs]: https://godoc.org/github.com/inbucket/inbucket/pkg/rest/client [Go API docs]: https://pkg.go.dev/github.com/inbucket/inbucket/pkg/rest/client
[Homebrew]: http://brew.sh/ [Homebrew]: http://brew.sh/
[Homebrew Tap]: https://github.com/inbucket/homebrew-inbucket [Homebrew Tap]: https://github.com/inbucket/homebrew-inbucket
[Inbucket Website]: https://www.inbucket.org/ [Inbucket Website]: https://www.inbucket.org/