This is an automated email from the ASF dual-hosted git repository.
jamesnetherton pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel-quarkus.git
The following commit(s) were added to refs/heads/main by this push:
new 22285e23d4 Document Twitter native locale requirements #2564
22285e23d4 is described below
commit 22285e23d4adcad3d0f12a3f9925734b2ec1564b
Author: Abdullah <[email protected]>
AuthorDate: Wed Sep 2 10:14:27 2026 +0300
Document Twitter native locale requirements #2564
Fixes #2564
* Document Twitter native locale and timezone requirements #2564
Twitter4J parses API dates with Locale.ENGLISH and timezone UTC.
Native images only embed the build-machine locale, so a French (or
other non-English) locale fails to parse responses.
Document quarkus.default-locale=en-US and UTC on the extension page
and set the same properties on the Twitter integration tests.
* Drop removed native locale and timezone settings #2564
quarkus.native.user-language and user-country are gone in Quarkus
3.39. twitter4j does not read the JVM default timezone. Keep
quarkus.default-locale=en-US and regenerate the extension page.
* Align twitter.adoc spacing with the generated template
---
.../ROOT/pages/reference/extensions/twitter.adoc | 17 +++++++++++++++++
.../twitter/runtime/src/main/doc/limitations.adoc | 12 ++++++++++++
integration-tests/twitter/README.adoc | 3 +++
.../twitter/src/main/resources/application.properties | 5 +++++
4 files changed, 37 insertions(+)
diff --git a/docs/modules/ROOT/pages/reference/extensions/twitter.adoc
b/docs/modules/ROOT/pages/reference/extensions/twitter.adoc
index 9473944f14..eb87e20cfe 100644
--- a/docs/modules/ROOT/pages/reference/extensions/twitter.adoc
+++ b/docs/modules/ROOT/pages/reference/extensions/twitter.adoc
@@ -47,6 +47,23 @@ ifeval::[{doc-show-user-guide-link} == true]
Check the xref:user-guide/index.adoc[User guide] for more information about
writing Camel Quarkus applications.
endif::[]
+[id="extensions-twitter-camel-quarkus-limitations"]
+== Camel Quarkus limitations
+
+The Twitter Java client parses timestamps with `Locale.US`.
+In native mode, GraalVM includes only the build machine locale by default. A
non-English locale
+(for example French) then fails to parse Twitter API responses.
+
+Set the default locale to `en-US` in `application.properties`:
+
+[source,properties]
+----
+quarkus.default-locale=en-US
+----
+
+See also xref:user-guide/native-mode.adoc#locale[Locale in native mode].
+
+
[id="extensions-twitter-ssl-in-native-mode"]
== SSL in native mode
diff --git a/extensions/twitter/runtime/src/main/doc/limitations.adoc
b/extensions/twitter/runtime/src/main/doc/limitations.adoc
new file mode 100644
index 0000000000..80c80ff61d
--- /dev/null
+++ b/extensions/twitter/runtime/src/main/doc/limitations.adoc
@@ -0,0 +1,12 @@
+The Twitter Java client parses timestamps with `Locale.US`.
+In native mode, GraalVM includes only the build machine locale by default. A
non-English locale
+(for example French) then fails to parse Twitter API responses.
+
+Set the default locale to `en-US` in `application.properties`:
+
+[source,properties]
+----
+quarkus.default-locale=en-US
+----
+
+See also xref:user-guide/native-mode.adoc#locale[Locale in native mode].
diff --git a/integration-tests/twitter/README.adoc
b/integration-tests/twitter/README.adoc
index 9fff37ebe7..6e523b9f59 100644
--- a/integration-tests/twitter/README.adoc
+++ b/integration-tests/twitter/README.adoc
@@ -17,3 +17,6 @@ export TWITTER_USER_NAME=my-twitter-username
----
+
+Native tests need `Locale.US`, otherwise Twitter API date parsing fails.
+The test `application.properties` already sets `quarkus.default-locale=en-US`.
diff --git
a/integration-tests/twitter/src/main/resources/application.properties
b/integration-tests/twitter/src/main/resources/application.properties
index c5b0a9d6fd..bffe7fc1b6 100644
--- a/integration-tests/twitter/src/main/resources/application.properties
+++ b/integration-tests/twitter/src/main/resources/application.properties
@@ -43,3 +43,8 @@
camel.component.twitter-directmessage.consumerKey={{env:TWITTER_CONSUMER_KEY}}
camel.component.twitter-directmessage.consumerSecret={{env:TWITTER_CONSUMER_SECRET}}
camel.component.twitter-directmessage.accessToken={{env:TWITTER_ACCESS_TOKEN}}
camel.component.twitter-directmessage.accessTokenSecret={{env:TWITTER_ACCESS_TOKEN_SECRET}}
+
+#
+# Native image: Twitter4J parses dates with Locale.US
+#
+quarkus.default-locale=en-US
