Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fiorix/go-smpp
SMPP 3.4 Protocol for the Go programming language
https://github.com/fiorix/go-smpp
Last synced: 2 days ago
JSON representation
SMPP 3.4 Protocol for the Go programming language
- Host: GitHub
- URL: https://github.com/fiorix/go-smpp
- Owner: fiorix
- License: mit
- Created: 2015-09-24T08:48:44.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2022-11-28T17:28:03.000Z (about 2 years ago)
- Last Synced: 2024-12-14T08:06:44.381Z (9 days ago)
- Language: Go
- Homepage:
- Size: 260 KB
- Stars: 220
- Watchers: 19
- Forks: 139
- Open Issues: 38
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SMPP 3.4
[](https://godoc.org/github.com/fiorix/go-smpp) [](https://goreportcard.com/report/github.com/fiorix/go-smpp) [](https://travis-ci.org/fiorix/go-smpp)
This is an implementation of SMPP 3.4 for Go, based on the original
[smpp34](https://github.com/CodeMonkeyKevin/smpp34) from Kevin Patel.
The API has been refactored to idiomatic Go code with more tests
and documentation. There are also quite a few new features, such
as a test server (see smpptest package) and support for text
transformation for LATIN-1 and UCS-2.
It is not fully compliant, there are some TODOs in the code.
## Usage
Following is an SMPP client transmitter wrapped by an HTTP server
that can send Short Messages (SMS):
```go
func main() {
// make persistent connection
tx := &smpp.Transmitter{
Addr: "localhost:2775",
User: "foobar",
Passwd: "secret",
}
conn := tx.Bind()
// check initial connection status
var status smpp.ConnStatus
if status = <-conn; status.Error() != nil {
log.Fatalln("Unable to connect, aborting:", status.Error())
}
log.Println("Connection completed, status:", status.Status().String())
// example of connection checker goroutine
go func() {
for c := range conn {
log.Println("SMPP connection status:", c.Status())
}
}()
// example of sender handler func
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
sm, err := tx.Submit(&smpp.ShortMessage{
Src: r.FormValue("src"),
Dst: r.FormValue("dst"),
Text: pdutext.Raw(r.FormValue("text")),
Register: pdufield.NoDeliveryReceipt,
TLVFields: pdutlv.Fields{
pdutlv.TagReceiptedMessageID: pdutlv.CString(r.FormValue("msgId")),
},
})
if err == smpp.ErrNotConnected {
http.Error(w, "Oops.", http.StatusServiceUnavailable)
return
}
if err != nil {
http.Error(w, err.Error(), http.StatusBadRequest)
return
}
io.WriteString(w, sm.RespID())
})
log.Fatal(http.ListenAndServe(":8080", nil))
}
```
You can test from the command line:
```bash
curl localhost:8080 -X GET -F src=bart -F dst=lisa -F text=hello
```
If you don't have an SMPP server to test, check out
[Selenium SMPPSim](http://www.seleniumsoftware.com/downloads.html).
It has been used for the development of this package.
## Tools
See the tools under `cmd/`. There's a command line tool for sending
SMS from the command line, and an HTTP server with WebSocket support.
## Supported PDUs
- [x] bind_transmitter
- [x] bind_transmitter_resp
- [x] bind_receiver
- [x] bind_receiver_resp
- [x] bind_transceiver
- [x] bind_transceiver_resp
- [ ] outbind
- [x] unbind
- [x] unbind_resp
- [x] submit_sm
- [x] submit_sm_resp
- [ ] submit_sm_multi
- [ ] submit_sm_multi_resp
- [ ] data_sm
- [ ] data_sm_resp
- [x] deliver_sm
- [x] deliver_sm_resp
- [x] query_sm
- [x] query_sm_resp
- [ ] cancel_sm
- [ ] cancel_sm_resp
- [ ] replace_sm
- [ ] replace_sm_resp
- [x] enquire_link
- [x] enquire_link_resp
- [ ] alert_notification
- [x] generic_nack
- [x] tag-length-value (TLV)
## Copyright
See LICENSE and AUTHORS files for details.