logstash-filter-mutate 3.5.2 → 3.5.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c982091a8f87efc5ed66124586d93bfff189d401022059b0e9eea04b7a476983
-  data.tar.gz: 0d268422fadbc597010b0e621147b0647ef14e131c87b1c68c1a0285159c7bcf
+  metadata.gz: e7bbcb6c1b884bd1f9c2653e0c42b5cf4df89861e8d73c80375e6b6ce002e7ba
+  data.tar.gz: f069158a723bce0e79a3ff832703d7c55c773c48b7a57b7b87466e8f980a3f84
 SHA512:
-  metadata.gz: b726d7f17945dd1cf511c8291112c7686ba21a114e85d17ecd0bd5810c14fa5b4cb3a0f3f87ddd43c8dea3b48f22598a18e9640b5e4e37ccc02096bb45db0c61
-  data.tar.gz: 7d7639cc43f5d5dfa47b9cdbbd642f84a6cabf4a81ab73b4a056f8b7ae3ac60f7b04630a9ca125ee4e4e6daae1a2eebc9f285d2c59a195126cb6b879d8222046
+  metadata.gz: b0efa47627024ab7246ac3dbea389665b5802394cd5c5239370014ff6e60b538c2c61a5240ab5774ccebe21b2662bc8b2540fe43adf3131303a5c0b3bad84be5
+  data.tar.gz: c6f2c51923fe115eaa2d35b3b1b325c0d018f784fe7ed6455f600c61e937b4e3f166a2a2eadff1b126c6b73de9f88b9637621ca175d8767beee9e7a519ff1d4b

data/CHANGELOG.md

@@ -1,3 +1,16 @@
+## 3.5.6
+ - [DOC] Added info on maintaining precision between Ruby float and Elasticsearch float [#158](https://github.com/logstash-plugins/logstash-filter-mutate/pull/158)
+
+## 3.5.5
+ - Fix: removed code and documentation for already removed 'remove' option. [#161](https://github.com/logstash-plugins/logstash-filter-mutate/pull/161)
+
+## 3.5.4
+ - [DOC] In 'replace' documentation, mention 'add' behavior [#155](https://github.com/logstash-plugins/logstash-filter-mutate/pull/155)
+ - [DOC] Note that each mutate must be in its own code block as noted in issue [#27](https://github.com/logstash-plugins/logstash-filter-mutate/issues/27). Doc fix [#101](https://github.com/logstash-plugins/logstash-filter-mutate/pull/101)
+
+## 3.5.3
+ - [DOC] Expand description and behaviors for `rename` option [#156](https://github.com/logstash-plugins/logstash-filter-mutate/pull/156)
+
 ## 3.5.2
  - Fix: ensure that when an error occurs during registration, we use the correct i18n key to propagate the error message in a useful manner [#154](https://github.com/logstash-plugins/logstash-filter-mutate/pull/154)
 
@@ -12,7 +25,7 @@ the operations are now aborted and a configurable tag is added to the event [#13
  - Added ability to directly convert from integer and float to boolean [#127](https://github.com/logstash-plugins/logstash-filter-mutate/pull/127)
 
 ## 3.3.4
- - Changed documentation to clarify execution order and to provide workaround 
+ - [DOC] Changed documentation to clarify execution order and to provide workaround 
  [#128](https://github.com/logstash-plugins/logstash-filter-mutate/pull/128)
 
 ## 3.3.3

data/docs/index.asciidoc

@@ -21,7 +21,7 @@ include::{include_path}/plugin_header.asciidoc[]
 ==== Description
 
 The mutate filter allows you to perform general mutations on fields. You
-can rename, remove, replace, and modify fields in your events.
+can rename, replace, and modify fields in your events.
 
 [id="plugins-{type}s-{plugin}-proc_order"]
 ===== Processing order
@@ -38,13 +38,12 @@ Mutations in a config file are executed in this order:
 * capitalize
 * lowercase
 * strip
-* remove
 * split
 * join
 * merge
 * copy
 
-You can control the order by using separate mutate blocks.
+IMPORTANT: Each mutation must be in its own code block if the sequence of operations needs to be preserved.
 
 Example:
 [source,ruby]
@@ -101,6 +100,14 @@ Convert a field's value to a different type, like turning a string to an
 integer. If the field value is an array, all members will be converted.
 If the field is a hash no action will be taken.
 
+.Conversion insights
+[NOTE]
+================================================================================
+The values are converted using Ruby semantics.
+Be aware that using `float` and `float_eu` converts the value to a double-precision 64-bit IEEE 754 floating point decimal number.
+In order to maintain precision due to the conversion, you should use a `double` in the Elasticsearch mappings.
+================================================================================
+
 Valid conversion targets, and their expected behaviour with different inputs are:
 
  * `integer`:
@@ -265,6 +272,13 @@ Example:
 
 Rename one or more fields.
 
+If the destination field already exists, its value is replaced.
+
+If one of the source fields doesn't exist, no action is performed for that field.
+(This is not considered an error; the `tag_on_failure` tag is not applied.)
+
+When renaming multiple fields, the order of operations is not guaranteed.
+
 Example:
 [source,ruby]
     filter {
@@ -280,7 +294,8 @@ Example:
   * Value type is <<hash,hash>>
   * There is no default value for this setting.
 
-Replace the value of a field with a new value. The new value can include `%{foo}` strings
+Replace the value of a field with a new value, or add the field if it
+doesn't already exist. The new value can include `%{foo}` strings
 to help you build a new value from other parts of the event.
 
 Example:

data/lib/logstash/filters/mutate.rb

@@ -3,7 +3,7 @@ require "logstash/filters/base"
 require "logstash/namespace"
 
 # The mutate filter allows you to perform general mutations on fields. You
-# can rename, remove, replace, and modify fields in your events.
+# can rename, replace, and modify fields in your events.
 class LogStash::Filters::Mutate < LogStash::Filters::Base
   config_name "mutate"
 
@@ -258,7 +258,6 @@ class LogStash::Filters::Mutate < LogStash::Filters::Base
     capitalize(event) if @capitalize
     lowercase(event) if @lowercase
     strip(event) if @strip
-    remove(event) if @remove
     split(event) if @split
     join(event) if @join
     merge(event) if @merge

data/logstash-filter-mutate.gemspec

@@ -1,7 +1,7 @@
 Gem::Specification.new do |s|
 
   s.name            = 'logstash-filter-mutate'
-  s.version         = '3.5.2'
+  s.version         = '3.5.6'
   s.licenses        = ['Apache License (2.0)']
   s.summary         = "Performs mutations on fields"
   s.description     = "This gem is a Logstash plugin required to be installed on top of the Logstash core pipeline using $LS_HOME/bin/logstash-plugin install gemname. This gem is not a stand-alone program"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: logstash-filter-mutate
 version: !ruby/object:Gem::Version
-  version: 3.5.2
+  version: 3.5.6
 platform: ruby
 authors:
 - Elastic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-05-12 00:00:00.000000000 Z
+date: 2021-12-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
@@ -126,8 +126,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project:
-rubygems_version: 2.6.13
+rubygems_version: 3.1.6
 signing_key:
 specification_version: 4
 summary: Performs mutations on fields