aws-logs 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56d76017d06966a77c263a2aaa65e2925882cc919e2f3baff52276b5b1f53b05
-  data.tar.gz: 0f60ef45cdea2a00de22c924b2815f14be84fc59dd16957f527416ad58ac6eb7
+  metadata.gz: 64ddf1d20fab423535f9f50bb65c10ae9be2130c57fbf15575a12ea5c3d63e96
+  data.tar.gz: f48a61b93834a37c64e22e088465f4d2212a863fc69c42214f250237713a4886
 SHA512:
-  metadata.gz: db6f055ed5ef2094493f22484bf2fa56c40977980b915583aa61c72c2e74fc8675a5c3a4992d64ec15e042aa9692eec7e0f696f57e39b3f2fd0722a79657d402
-  data.tar.gz: e3970d0c5db5c4eb363a02333d7262a87359cd73577aad5b986fba4c78ed9d33bedb5b9becdbefe614eac554bdfa170d4405a1df0cae68d55740b627591bec9e
+  metadata.gz: 1d362480e5d9aa1279ff5350bf685b3cdb350523f960e29a884106857c8a0f3033c9dc6974d778dc17971ca07c65d523b74da7b6e3e4f9e232331328bff801bc
+  data.tar.gz: 456686311206099c88a2f931e6369eb030145a97d3e45d54381b6e5a237b816bf5234bc029edd2fb0d6062e156d6092e6c4dec5ec7fe1753121c669227d1f6a9

data/CHANGELOG.md

@@ -3,5 +3,10 @@
 All notable changes to this project will be documented in this file.
 This project *tries* to adhere to [Semantic Versioning](http://semver.org/), even before v1.0.
 
+## [0.2.0]
+- add stop_follow! method
+- friendly error message when log not found
+- improve `@follow` default, `@log_group_name` and stdout sync true by default
+
 ## [0.1.0]
 - Initial release.

data/README.md

@@ -1,4 +1,4 @@
-# AwsLogs
+# aws-logs
 
 [![Gem Version](https://badge.fury.io/rb/GEMNAME.png)](http://badge.fury.io/rb/GEMNAME)
 
@@ -12,7 +12,7 @@ Tail AWS CloudWatch Logs.
 
 ## Examples
 
-Here's a couple of examples where the `LOG_GROUP=/aws/codebuild/demo`:
+Here's a couple of examples where `LOG_GROUP=/aws/codebuild/demo`:
 
     aws-logs tail /aws/codebuild/demo --since 60m
     aws-logs tail /aws/codebuild/demo --since "2018-08-08 08:00:00"
@@ -25,15 +25,7 @@ Here's a couple of examples where the `LOG_GROUP=/aws/codebuild/demo`:
 
 ## Installation
 
-Add this line to your application's Gemfile:
-
-    gem "aws-logs"
-
-And then execute:
-
-    bundle
-
-Or install it yourself as:
+Install with:
 
     gem install aws-logs
 

data/lib/aws_logs.rb

@@ -1,3 +1,5 @@
+$stdout.sync = true unless ENV["AWS_LOGS_STDOUT_SYNC"] == "0"
+
 $:.unshift(File.expand_path("../", __FILE__))
 require "aws_logs/version"
 require "rainbow/ext/string"

data/lib/aws_logs/cli.rb

@@ -9,8 +9,8 @@ module AwsLogs
     option :log_stream_name_prefix, desc: "Filters the results to include only events from log streams that have names starting with this prefix. Can only use log_stream_names or log_stream_name_prefix but not both."
     option :filter_pattern, desc: "The filter pattern to use. If not provided, all the events are matched"
     option :follow_until, desc: "Exit out of the follow loop once this text is found."
-    def tail(log_group)
-      Tail.new(options.merge(log_group: log_group)).run
+    def tail(log_group_name)
+      Tail.new(options.merge(log_group_name: log_group_name)).run
     end
 
     desc "completion *PARAMS", "Prints words for auto-completion."

data/lib/aws_logs/help/tail.md

@@ -41,4 +41,17 @@ Since supports these formats:
 * d - days
 * w - weeks
 
-Since does not current support combining the formats. IE: 5m30s.
+Since does not current support combining the formats. IE: 5m30s.
+
+## Filter Pattern
+
+The `--filter-pattern` option is quite powerful as CloudWatch supports a full
+[Filter and Pattern Syntax](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html).
+
+To match terms with spaces in it, you'll need quotes around it. Otherise, the match will be an OR of the terms. Example:
+
+    aws-logs tail /aws/codebuild/demo --filter-pattern '"Wed Nov 27 23"' --since 3h --no-follow
+
+Here's an example of matching with an exclude patter using the `-` (minus sign).
+
+    aws-logs tail /aws/codebuild/demo --filter-pattern '"ERROR" - "Exiting"' --since 3h --no-follow

data/lib/aws_logs/tail.rb

@@ -6,7 +6,9 @@ module AwsLogs
 
     def initialize(options={})
       @options = options
-      @log_group = options[:log_group]
+      @log_group_name = options[:log_group_name]
+      # Setting to ensure matches default CLI option
+      @follow = @options[:follow] || true
 
       @loop_count = 0
       @output = [] # for specs
@@ -14,15 +16,6 @@ module AwsLogs
       set_trap
     end
 
-    @@end_loop_signal = false
-    def set_trap
-      Signal.trap("INT") {
-        puts "\nCtrl-C detected. Exiting..."
-        @@end_loop_signal = true  # delayed exit, usefu control loop flow though
-        exit # immediate exit
-      }
-    end
-
     def reset
       @events = [] # constantly replaced with recent events
       @last_shown_event_id = nil
@@ -48,8 +41,11 @@ module AwsLogs
         display
         since, now = now, current_now
         loop_count!
-        sleep 5 if @options[:follow] && !@@end_loop_signal && !ENV["AWS_LOGS_TEST"]
+        sleep 5 if @follow && !@@end_loop_signal && !ENV["AWS_LOGS_TEST"]
       end
+    rescue Aws::CloudWatchLogs::Errors::ResourceNotFoundException => e
+      puts "ERROR: #{e.class}: #{e.message}".color(:red)
+      puts "Log group #{@log_group_name} not found."
     end
 
     def refresh_events(start_time, end_time)
@@ -59,7 +55,7 @@ module AwsLogs
       # TODO: can hit throttle limit if there are lots of pages
       while next_token
         options = {
-          log_group_name: @log_group, # required
+          log_group_name: @log_group_name, # required
           start_time: start_time,
           end_time: end_time,
           # limit: 10,
@@ -114,6 +110,19 @@ module AwsLogs
       @output.join("\n") + "\n"
     end
 
+    @@end_loop_signal = false
+    def set_trap
+      Signal.trap("INT") {
+        puts "\nCtrl-C detected. Exiting..."
+        @@end_loop_signal = true  # useful to control loop
+        exit # immediate exit
+      }
+    end
+
+    def self.stop_follow!
+      @@end_loop_signal = true
+    end
+
   private
     def initial_since
       since = @options[:since]
@@ -136,7 +145,7 @@ module AwsLogs
 
     # Useful for specs
     def max_loop_count
-      @options[:follow] ? nil : 1
+      @follow ? nil : 1
     end
   end
 end

data/lib/aws_logs/version.rb

@@ -1,3 +1,3 @@
 module AwsLogs
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-logs
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Tung Nguyen
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-11-27 00:00:00.000000000 Z
+date: 2019-11-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport