feat: add Group method to simplify group logger usage

cilog/logger.go

@@ -31,6 +31,17 @@ func Can(l Logger, capability Capability) bool {
 	return exists
 }
 
+// Group starts a group logger.
+// If the given logger doesn't support group logging,
+// the original logger will be returned and a noop finish function will be returned.
+func Group(l Logger, params GroupLogParams) (Logger, func()) {
+	if !Can(l, CapabilityGroupLog) {
+		return l, func() {}
+	}
+
+	return l.GroupLog(params)
+}
+
 // GroupLogParams specifies the parameter for GroupLog.
 type GroupLogParams struct {
 	// Name - name of the group

cilog/logger_test.go

@@ -12,3 +12,10 @@ func TestGet(t *testing.T) {
 	assert.IsType(t, &azurePipelineT{}, Get(ci.AzurePipelines))
 	assert.IsType(t, &genericT{}, Get(ci.Custom))
 }
+
+func TestGroup_GroupUnsupported(t *testing.T) {
+	l := &Mute{}
+	subLogger, finish := Group(l, GroupLogParams{Name: "group"})
+	assert.NotNil(t, finish)
+	assert.Equal(t, l, subLogger)
+}