-
Notifications
You must be signed in to change notification settings - Fork 24.9k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Consistent encoder names #29492
Consistent encoder names #29492
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@russcam I agree that it would be better if the encoder names consistently use one of the variants. I don't know enough to say if snake_case is the current "offical" variant since neither of the existing variant seems deprecated, but I added a few comments to change some other occurances in tests and code if we go with this version. Do you think we should we also start deprecating the other options? Has there been an issue where this was discussed already?
`caverphone2`, `cologne`, `nysiis`, `koelnerphonetik`, `haasephonetik`, | ||
`beidermorse`, `daitch_mokotoff`. | ||
`beider_morse`, `daitch_mokotoff`. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
If this is changes, beidermorse
in L28 should be changed as well. Also there is an occurence in plugins/analysis-phonetic/src/test/resources/org/elasticsearch/index/analysis/phonetic-1.yml and plugins/analysis-phonetic/src/test/java/org/elasticsearch/index/analysis/AnalysisPhoneticFactoryTests.java where we should then also test with this name, although the other variant is supported as well.
@@ -17,9 +17,9 @@ The `phonetic` token filter takes the following settings: | |||
`encoder`:: | |||
|
|||
Which phonetic encoder to use. Accepts `metaphone` (default), | |||
`doublemetaphone`, `soundex`, `refinedsoundex`, `caverphone1`, | |||
`double_metaphone`, `soundex`, `refined_soundex`, `caverphone1`, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe also change "refinedsoundec" in plugins/analysis-phonetic/src/test/resources/org/elasticsearch/index/analysis/phonetic-1.yml then
@@ -17,9 +17,9 @@ The `phonetic` token filter takes the following settings: | |||
`encoder`:: | |||
|
|||
Which phonetic encoder to use. Accepts `metaphone` (default), | |||
`doublemetaphone`, `soundex`, `refinedsoundex`, `caverphone1`, | |||
`double_metaphone`, `soundex`, `refined_soundex`, `caverphone1`, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Mabe also change doublemetaphone
in plugins/analysis-phonetic/src/test/java/org/elasticsearch/index/analysis/AnalysisPhoneticFactoryTests.java and plugins/analysis-phonetic/src/test/resources/org/elasticsearch/index/analysis/phonetic-1.yml then
Pinging @elastic/es-search-aggs |
@russcam just checking in, are you still interested in making this change? If not, I'd like to close this PR. |
I'd still like to make this change @cbuescher. As far as I have seen whilst working on the .NET client, the preference seems to be towards snake-casing, but perhaps @clintongormley has the authoritative answer? Irrespective of what the correct name should be, I'd still like to make the change, to make the documentation consistent with itself e.g. if |
My personal preference would be snakecase |
@russcam any chance to get this one ready to merge? |
thanks for the ping @cbuescher, I'll take a look first thing tomorrow 👍 |
This commit updates tests and docs to use snake_case encoder names for consistency. Addresses comments on #29492
I've addressed the comments in relation to updating names in phonetic-1.yml and AnalysisPhoneticFactoryTests.java to use snake_casing. @cbuescher would you mind taking another look when you get a chance? |
filters.put("beidermorse", PhoneticTokenFilterFactory.class); | ||
filters.put("doublemetaphone", PhoneticTokenFilterFactory.class); | ||
filters.put("beider_morse", PhoneticTokenFilterFactory.class); | ||
filters.put("double_metaphone", PhoneticTokenFilterFactory.class); |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sorry, I was wrong with my previous comment that this needs changing. This will actually fail the test now. I think the test is based on class name lookup, and the "_" doesn't work with this.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@russcam thanks for the update, I left a comment. Sorry about the test change, my mistake. Could you merge in current master or rebase once you change the test back so CI can run on a current version?
This commit updates encoder names to be consistent within documentation and align with snake casing convention.
This commit updates tests and docs to use snake_case encoder names for consistency. Addresses comments on #29492
This commit reverts the filter names used for testing back to what they were, as the name is used for class name lookup.
7f0f8b9
to
e65632a
Compare
Rebased against latest master and reverted filter names in |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for the changes, LGTM
Thanks @cbuescher. Are you OK for me to merge and backport (back to 6.3)? |
@russcam yes please. I'd merge this to 6.x only since it is not a really important bug-fix for the 6.3 line though. |
This commit updates encoder names to be consistent within documentation and align with snake casing convention. (cherry picked from commit e2b665c)
ported to 6.x: 990afd0 |
* 6.x: Security: revert to old way of merging automata (#32254) Fix a test bug in RangeQueryBuilderTests introduced in the field aliases backport. Introduce Application Privileges with support for Kibana RBAC (#32309) Undo a debugging change that snuck in during the field aliases merge. [test] port linux package packaging tests (#31943) Painless: Update More Methods to New Naming Scheme (#32305) Tribe: Add error with secure settings copied to tribe (#32298) Add V_6_3_3 version constant Add ERR to ranking evaluation documentation (#32314) [DOCS] Added link to 6.3.2 RNs [DOCS] Updates 6.3.2 release notes with PRs from ml-cpp repo (#32334) [Kerberos] Add Kerberos authentication support (#32263) [ML] Extract persistent task methods from MlMetadata (#32319) Backport - Add Snapshots Status API to High Level Rest Client (#32295) Make release notes ignore the `>test-failure` label. (#31309) [DOCS] Adds release highlights for search for 6.4 (#32095) Allow Integ Tests to run in a FIPS-140 JVM (#32316) Add support for field aliases to 6.x. (#32184) Register ERR metric with NamedXContentRegistry (#32320) fixes broken build for third-party-tests (#32315) Relates #31918 / Closes infra/issues/6085 [DOCS] Rollup Caps API incorrectly mentions GET Jobs API (#32280) Rest HL client: Add put watch action (#32026) (#32191) Add WeightedAvg metric aggregation (#31037) Consistent encoder names (#29492) Switch monitoring to new style Requests (#32255) specify subdirs of lib, bin, modules in package (#32253) Rename ranking evaluation `quality_level` to `metric_score` (#32168) Add new permission for JDK11 to load JAAS libraries (#32132) Switch x-pack:core to new style Requests (#32252) Watcher: Store username on watch execution (#31873) Silence SSL reload test that fails on JDK 11 Painless: Clean up add methods in PainlessLookup (#32258) CCE when re-throwing "shard not available" exception in TransportShardMultiGetAction (#32185) Fail shard if IndexShard#storeStats runs into an IOException (#32241) Fix `range` queries on `_type` field for singe type indices (#31756) (#32161) AwaitsFix RecoveryIT#testHistoryUUIDIsGenerated Add new fields to monitoring template for Beats state (#32085) (#32273) [TEST] improve REST high-level client naming conventions check (#32244) Check that client methods match API defined in the REST spec (#31825)
* master: Security: revert to old way of merging automata (#32254) Networking: Fix test leaking buffer (#32296) Undo a debugging change that snuck in during the field aliases merge. Painless: Update More Methods to New Naming Scheme (#32305) [TEST] Fix assumeFalse -> assumeTrue in SSLReloadIntegTests Ingest: Support integer and long hex values in convert (#32213) Introduce fips_mode setting and associated checks (#32326) Add V_6_3_3 version constant [DOCS] Removed extraneous callout number. Rest HL client: Add put license action (#32214) Add ERR to ranking evaluation documentation (#32314) Introduce Application Privileges with support for Kibana RBAC (#32309) Build: Shadow x-pack:protocol into x-pack:plugin:core (#32240) [Kerberos] Add Kerberos authentication support (#32263) [ML] Extract persistent task methods from MlMetadata (#32319) Add Restore Snapshot High Level REST API Register ERR metric with NamedXContentRegistry (#32320) fixes broken build for third-party-tests (#32315) Allow Integ Tests to run in a FIPS-140 JVM (#31989) [DOCS] Rollup Caps API incorrectly mentions GET Jobs API (#32280) awaitsfix testRandomClusterStateUpdates [TEST] add version skip to weighted_avg tests Consistent encoder names (#29492) Add WeightedAvg metric aggregation (#31037) Switch monitoring to new style Requests (#32255) Rename ranking evaluation `quality_level` to `metric_score` (#32168) Fix a test bug around nested aggregations and field aliases. (#32287) Add new permission for JDK11 to load JAAS libraries (#32132) Silence SSL reload test that fails on JDK 11 [test] package pre-install java check (#32259) specify subdirs of lib, bin, modules in package (#32253) Switch x-pack:core to new style Requests (#32252) awaitsfix SSLConfigurationReloaderTests Painless: Clean up add methods in PainlessLookup (#32258) Fail shard if IndexShard#storeStats runs into an IOException (#32241) AwaitsFix RecoveryIT#testHistoryUUIDIsGenerated Remove unnecessary warning supressions (#32250) CCE when re-throwing "shard not available" exception in TransportShardMultiGetAction (#32185) Add new fields to monitoring template for Beats state (#32085)
This commit updates encoder names to be consistent within documentation
and align with snake casing convention.