github.com/toplink-cn/moby@v0.0.0-20240305205811-460b4aebdf81/client/events.go (about) 1 package client // import "github.com/docker/docker/client" 2 3 import ( 4 "context" 5 "encoding/json" 6 "net/url" 7 "time" 8 9 "github.com/docker/docker/api/types" 10 "github.com/docker/docker/api/types/events" 11 "github.com/docker/docker/api/types/filters" 12 timetypes "github.com/docker/docker/api/types/time" 13 ) 14 15 // Events returns a stream of events in the daemon. It's up to the caller to close the stream 16 // by cancelling the context. Once the stream has been completely read an io.EOF error will 17 // be sent over the error channel. If an error is sent all processing will be stopped. It's up 18 // to the caller to reopen the stream in the event of an error by reinvoking this method. 19 func (cli *Client) Events(ctx context.Context, options types.EventsOptions) (<-chan events.Message, <-chan error) { 20 messages := make(chan events.Message) 21 errs := make(chan error, 1) 22 23 started := make(chan struct{}) 24 go func() { 25 defer close(errs) 26 27 query, err := buildEventsQueryParams(cli.version, options) 28 if err != nil { 29 close(started) 30 errs <- err 31 return 32 } 33 34 resp, err := cli.get(ctx, "/events", query, nil) 35 if err != nil { 36 close(started) 37 errs <- err 38 return 39 } 40 defer resp.body.Close() 41 42 decoder := json.NewDecoder(resp.body) 43 44 close(started) 45 for { 46 select { 47 case <-ctx.Done(): 48 errs <- ctx.Err() 49 return 50 default: 51 var event events.Message 52 if err := decoder.Decode(&event); err != nil { 53 errs <- err 54 return 55 } 56 57 select { 58 case messages <- event: 59 case <-ctx.Done(): 60 errs <- ctx.Err() 61 return 62 } 63 } 64 } 65 }() 66 <-started 67 68 return messages, errs 69 } 70 71 func buildEventsQueryParams(cliVersion string, options types.EventsOptions) (url.Values, error) { 72 query := url.Values{} 73 ref := time.Now() 74 75 if options.Since != "" { 76 ts, err := timetypes.GetTimestamp(options.Since, ref) 77 if err != nil { 78 return nil, err 79 } 80 query.Set("since", ts) 81 } 82 83 if options.Until != "" { 84 ts, err := timetypes.GetTimestamp(options.Until, ref) 85 if err != nil { 86 return nil, err 87 } 88 query.Set("until", ts) 89 } 90 91 if options.Filters.Len() > 0 { 92 //nolint:staticcheck // ignore SA1019 for old code 93 filterJSON, err := filters.ToParamWithVersion(cliVersion, options.Filters) 94 if err != nil { 95 return nil, err 96 } 97 query.Set("filters", filterJSON) 98 } 99 100 return query, nil 101 }