adafruit-mirror/io-actions
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge pull request #14 from adafruit/tylerdcooper-patch-10

Browse source 
docs: compare text matcher block
This commit is contained in:
Loren Norman 2025-08-11 15:48:37 -04:00 committed by GitHub
commit e6d76cf361
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 6 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

21
app/blocks/matchers/matcher_text_compare.js
View file

@ -5,48 +5,40 @@ export default {
name: "Compare Text Matcher",
colour: 180,
inputsInline: true,
description: "Compare the new feed value with text for equality, inequality, or inclusion.",
description: "Compare text-based feed data using smart text matching. Perfect for triggers based on status messages ('door opened', 'motion detected'), device states ('online', 'offline'), or any text-based sensor data. Works with exact matches, exclusions, or partial text detection within longer messages.",
connections: { mode: 'value', output: 'matcher' },
template: "%OP %B",
inputs: {
B: {
description: "The string to compare with the Feed value.",
description: "The text to compare against your feed data. Examples: 'open' to detect door status, 'motion' for PIR sensors, 'online' for device connectivity, or any specific word/phrase you're monitoring for.",
check: "expression",
shadow: 'io_text'
}
},
fields: {
OP: {
description: "Select what kind of comparison to do:",
description: "Choose how to compare the incoming feed data with your text:",
options: [
['=', 'EQ', "Returns true if the Feed value and text are the same."],
['\u2260', 'NEQ', "Returns true if the Feed value and text are not the same."],
['includes', 'INC', "Returns true if the Feed value includes the text."],
['=', 'EQ', "Exact match: Feed value must be exactly the same as your text (e.g., feed='online' matches text='online', but 'ONLINE' or 'device online' would not match)."],
['\u2260', 'NEQ', "Not equal: Feed value must be different from your text (e.g., useful for 'not offline' conditions or excluding specific status messages)."],
['includes', 'INC', "Contains: Feed value includes your text anywhere within it (e.g., feed='motion detected at 3pm' would match text='motion', perfect for parsing longer status messages)."],
]
}
},
generators: {
json: (block, generator) => {
const
comparator = block.getFieldValue('OP'),
rightExp = generator.valueToCode(block, 'B', 0) || null,
blockPayload = JSON.stringify({
matcherTextCompare: {
comparator: comparator?.toLowerCase() || null,
right: JSON.parse(rightExp),
},
})
return [ blockPayload, 0 ]
}
},
regenerators: {
json: (blockObject, helpers) => {
const
@ -57,7 +49,6 @@ export default {
inputs = {
B: helpers.expressionToBlock(right, { shadow: "io_text" }),
}
return { type: 'matcher_text_compare', fields, inputs }
}
}