Convert to modules - update to v5

Author: ibmmqmet

CHANGELOG.md

@@ -1,6 +1,9 @@
 # Changelog
 Newest updates are at the top of this file.
 
+## May 01 2020 - v5.0.0-alpha
+* Initial migration for Go modules (requires new major number)
+
 ## Apr 02 2020 - v4.1.4
 * Update for MQ 9.1.5                                           
 * ibmmq - Add message and header compression for MQCD (#137)

Dockerfile

@@ -12,12 +12,12 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-ARG BASE_IMAGE=ubuntu:19.04
+ARG BASE_IMAGE=ubuntu:19.10
 FROM $BASE_IMAGE
 
 ARG GOPATH_ARG="/go"
 
-ENV GOVERSION=1.12 \
+ENV GOVERSION=1.13 \
     GOPATH=$GOPATH_ARG \
     ORG="github.com/ibm-messaging"
 

README.md

@@ -2,9 +2,7 @@
 
 This repository demonstrates how you can call IBM MQ from applications written in the Go language.
 
-> **NOTICE**: Please ensure that you use a dependency management tool such as [dep](https://github.com/golang/dep) or [Glide](http://glide.sh/), and add a specific version dependency.
-
-This repository previously contained sample programs that exported MQ statistics to
+This repository previously contained programs that exported MQ statistics to
 some monitoring packages. These have now been moved to a
 [GitHub repository called mq-metric-samples](https://github.com/ibm-messaging/mq-metric-samples).
 
@@ -56,8 +54,7 @@ but subsequent steps are independent of the platform.
 ### Linux
 
 * Install the Go runtime and compiler. On Linux, the packaging may vary but a typical
-directory for the code is `/usr/lib/golang`.
-The compiler should be at least version 10. If you see an error similar to "ld: NULL not defined"
+directory for the code is `/usr/lib/golang`. If you see an error similar to "ld: NULL not defined"
 when building a program then it is likely you need to upgrade your compiler.
 
 
@@ -123,7 +120,7 @@ For example,
 ```
 
 * Compile the `ibmmq` component:
-
+* 
   `go install ./src/github.com/ibm-messaging/mq-golang/ibmmq`
 
 * If you plan to use monitoring functions, then compile the `mqmetric` component:
@@ -137,8 +134,19 @@ For example,
 At this point, you should have a compiled copy of the program in `$GOPATH/bin`. See the
 `samples` directory for more sample programs.
 
+## Building in a container
 The `buildSamples.sh` script in this directory can also be used to create a container which will
-compile the samples and copy them to a local directory.
+compile the samples and copy them to a local directory. If you use this approach, you do not need
+to install a local copy of the compiler and associated toold, though you will still need a copy of
+the MQ runtime libraries for wherever you execute the programs.
+
+## Go Modules
+The packages in this repository are now set up to be used as Go modules. See the `go.mod` file in
+the root of the repository. This required a major version bump in the release stream.
+
+Support for modules started to be introduced around Go 1.11 and has been firmed up in various
+modification level updates in each of the compiler levels since then. The module changes for this
+package were developed and tested with Go 1.13.6.
 
 ## Related Projects
 

go.mod

@@ -1,3 +1,3 @@
-module github.com/ibm-messaging/mq-golang
+module github.com/ibm-messaging/mq-golang/v5
 
 go 1.13

mqmetric/channel.go

@@ -30,7 +30,7 @@ about running MQ channels
 */
 
 import (
-	"github.com/ibm-messaging/mq-golang/ibmmq"
+	"github.com/ibm-messaging/mq-golang/v5/ibmmq"
 	"regexp"
 	"strings"
 	"time"

mqmetric/discover.go

@@ -39,7 +39,7 @@ import (
 	"regexp"
 	"strings"
 
-	"github.com/ibm-messaging/mq-golang/ibmmq"
+	"github.com/ibm-messaging/mq-golang/v5/ibmmq"
 )
 
 // MonElement describes the real metric element generated by MQ

mqmetric/mqif.go

@@ -26,7 +26,7 @@ don't need to repeat common setups eg of MQMD or MQSD structures.
 
 import (
 	"fmt"
-	"github.com/ibm-messaging/mq-golang/ibmmq"
+	"github.com/ibm-messaging/mq-golang/v5/ibmmq"
 )
 
 var (

mqmetric/mqmetric_test.go

@@ -21,7 +21,7 @@ import (
 	"os"
 	"testing"
 
-	"github.com/ibm-messaging/mq-golang/ibmmq"
+	"github.com/ibm-messaging/mq-golang/v5/ibmmq"
 )
 
 func TestNormalise(t *testing.T) {

mqmetric/qmgr.go

@@ -30,7 +30,7 @@ about the MQ queue manager
 */
 
 import (
-	"github.com/ibm-messaging/mq-golang/ibmmq"
+	"github.com/ibm-messaging/mq-golang/v5/ibmmq"
 	"strings"
 	"time"
 )

mqmetric/queue.go

@@ -31,7 +31,7 @@ about MQ queues
 
 import (
 	//	"fmt"
-	"github.com/ibm-messaging/mq-golang/ibmmq"
+	"github.com/ibm-messaging/mq-golang/v5/ibmmq"
 	"strings"
 	"time"
 )