Fix #581: add Mapper.isEnabled() (#582)

Author: cowtowncoder

csv/src/main/java/tools/jackson/dataformat/csv/CsvMapper.java

@@ -226,6 +226,20 @@ public CsvFactory tokenStreamFactory() {
         return (CsvFactory) _streamFactory;
     }
 
+    /*
+    /**********************************************************************
+    /* Format-specific
+    /**********************************************************************
+     */
+
+    public boolean isEnabled(CsvReadFeature f) {
+        return _deserializationConfig.hasFormatFeature(f);
+    }
+
+    public boolean isEnabled(CsvWriteFeature f) {
+        return _serializationConfig.hasFormatFeature(f);
+    }
+
     /*
     /**********************************************************************
     /* Additional ObjectReader factory methods

csv/src/test/java/tools/jackson/dataformat/csv/CSVFactoryFeaturesTest.java

@@ -102,4 +102,12 @@ public void testFactoryBuilderFastBigNumberFeature() throws Exception
         assertFalse(parser.isEnabled(StreamReadFeature.USE_FAST_BIG_NUMBER_PARSER));
         assertTrue(parser.isEnabled(StreamReadFeature.USE_FAST_DOUBLE_PARSER));
     }
+
+    // for [dataformats-text#581]
+    @Test
+    void testFormatFeatureDefaults() {
+        CsvMapper mapper = CsvMapper.shared();
+        assertFalse(mapper.isEnabled(CsvReadFeature.ALLOW_COMMENTS));
+        assertFalse(mapper.isEnabled(CsvWriteFeature.ALWAYS_QUOTE_EMPTY_STRINGS));
+    }
 }

release-notes/VERSION

@@ -14,6 +14,11 @@ implementations)
 === Releases ===
 ------------------------------------------------------------------------
 
+3.1.0 (not yet released)
+
+#581: (csv, toml, yaml) Add `isEnabled()` methods for format-specific
+  features to mappers 
+
 3.0.1 (21-Oct-2025)
 
 No changes since 3.0.0

toml/src/main/java/tools/jackson/dataformat/toml/TomlMapper.java

@@ -184,6 +184,20 @@ public TomlFactory tokenStreamFactory() {
         return (TomlFactory) _streamFactory;
     }
 
+    /*
+    /**********************************************************************
+    /* Format-specific
+    /**********************************************************************
+     */
+
+    public boolean isEnabled(TomlReadFeature f) {
+        return _deserializationConfig.hasFormatFeature(f);
+    }
+
+    public boolean isEnabled(TomlWriteFeature f) {
+        return _serializationConfig.hasFormatFeature(f);
+    }
+    
     /*
     /**********************************************************************
     /* Helper class(es)

toml/src/main/java/tools/jackson/dataformat/toml/TomlReadFeature.java

@@ -15,6 +15,8 @@ public enum TomlReadFeature
      * <p>
      * When this option is set, these time types will be parsed to their proper {@code java.time} counterparts and
      * appear as {@link tools.jackson.core.JsonToken#VALUE_EMBEDDED_OBJECT} tokens.
+     *<p>
+     * Feature is disabled by default.
      */
     PARSE_JAVA_TIME(false);
 

toml/src/main/java/tools/jackson/dataformat/toml/TomlWriteFeature.java

@@ -13,6 +13,8 @@ public enum TomlWriteFeature implements FormatFeature
      * {@link JsonGenerator#writeNull()} by default.
      * <p>
      * When this option is set, any attempt to write a null value will error instead.
+     *<p>
+     * Feature is disabled by default.
      */
     FAIL_ON_NULL_WRITE(false);
 

toml/src/test/java/tools/jackson/dataformat/toml/TomlMapperTest.java

@@ -16,8 +16,8 @@
 
 import static org.junit.jupiter.api.Assertions.*;
 
-public class TomlMapperTest extends TomlMapperTestBase {
-
+public class TomlMapperTest extends TomlMapperTestBase
+{
     private static final String TEST_STRING = "foo = 'bar'\n[nested]\nfoo = 4";
     private static final TestClass TEST_OBJECT;
 
@@ -199,4 +199,12 @@ public void nullDisable() {
                     .build().writeValueAsString(cf));
         });
     }
+
+    // for [dataformats-text#581]
+    @Test
+    void testFormatFeatureDefaults() {
+        TomlMapper mapper = TomlMapper.shared();
+        assertFalse(mapper.isEnabled(TomlReadFeature.PARSE_JAVA_TIME));
+        assertFalse(mapper.isEnabled(TomlWriteFeature.FAIL_ON_NULL_WRITE));
+    }
 }

yaml/src/main/java/tools/jackson/dataformat/yaml/YAMLMapper.java

@@ -197,6 +197,20 @@ public final YAMLFactory tokenStreamFactory() {
         return (YAMLFactory) _streamFactory;
     }
 
+    /*
+    /**********************************************************************
+    /* Format-specific
+    /**********************************************************************
+     */
+
+    public boolean isEnabled(YAMLReadFeature f) {
+        return _deserializationConfig.hasFormatFeature(f);
+    }
+
+    public boolean isEnabled(YAMLWriteFeature f) {
+        return _serializationConfig.hasFormatFeature(f);
+    }
+
     /*
     /**********************************************************
     /* Helper class(es)

yaml/src/main/java/tools/jackson/dataformat/yaml/YAMLWriteFeature.java

@@ -12,22 +12,28 @@ public enum YAMLWriteFeature implements FormatFeature
     /**
      * Whether we are to write an explicit document start marker ("---")
      * or not.
+     *<p>
+     * Feature is enabled by default.
      */
     WRITE_DOC_START_MARKER(true),
 
     /**
      * Whether to use YAML native Object Id construct for indicating type (true);
      * or "generic" Object Id mechanism (false). Former works better for systems that
-     * are YAML-centric; latter may be better choice for interoperability, when
+     * are YAML-centric; latter may be better choice for inter-operability, when
      * converting between formats or accepting other formats.
+     *<p>
+     * Feature is enabled by default.
      */
     USE_NATIVE_OBJECT_ID(true),
 
     /**
      * Whether to use YAML native Type Id construct for indicating type (true);
      * or "generic" type property (false). Former works better for systems that
-     * are YAML-centric; latter may be better choice for interoperability, when
+     * are YAML-centric; latter may be better choice for inter-operability, when
      * converting between formats or accepting other formats.
+     *<p>
+     * Feature is enabled by default.
      */
     USE_NATIVE_TYPE_ID(true),
 
@@ -36,6 +42,8 @@ public enum YAMLWriteFeature implements FormatFeature
      * <p>
      *     Ignored if you provide your own {@code DumperOptions}.
      * </p>
+     *<p>
+     * Feature is disabled by default.
      */
     CANONICAL_OUTPUT(false),
 
@@ -48,6 +56,8 @@ public enum YAMLWriteFeature implements FormatFeature
      * <p>
      *     Ignored if you provide your own {@code DumperOptions}.
      * </p>
+     *<p>
+     * Feature is enabled by default.
      */
     SPLIT_LINES(true),
 
@@ -59,6 +69,8 @@ public enum YAMLWriteFeature implements FormatFeature
      *     limited to printable characters according to the rules of
      *     <a href="http://www.yaml.org/spec/1.2/spec.html#style/block/literal">literal block style</a>.
      * </p>
+     *<p>
+     * Feature is disabled by default.
      */
     MINIMIZE_QUOTES(false),
 
@@ -70,6 +82,8 @@ public enum YAMLWriteFeature implements FormatFeature
      *     limited to printable characters according to the rules of
      *     <a href="http://www.yaml.org/spec/1.2/spec.html#style/block/literal">literal block style</a>.
      * </p>
+     *<p>
+     * Feature is disabled by default.
      */
     ALWAYS_QUOTE_NUMBERS_AS_STRINGS(false),
 
@@ -81,6 +95,8 @@ public enum YAMLWriteFeature implements FormatFeature
      *     The content of such strings is limited to printable characters according to the rules of
      *     <a href="http://www.yaml.org/spec/1.2/spec.html#style/block/literal">literal block style</a>.
      * </p>
+     *<p>
+     * Feature is disabled by default.
      */
     LITERAL_BLOCK_STYLE(false),
 
@@ -93,7 +109,8 @@ public enum YAMLWriteFeature implements FormatFeature
      * <p>
      *     Ignored if you provide your own {@code DumperOptions}.
      * </p>
-     *
+     *<p>
+     * Feature is disabled by default.
      */
     INDENT_ARRAYS(false),
 
@@ -106,7 +123,8 @@ public enum YAMLWriteFeature implements FormatFeature
      * <p>
      *     Ignored if you provide your own {@code DumperOptions}.
      * </p>
-     *
+     *<p>
+     * Feature is disabled by default.
      */
     INDENT_ARRAYS_WITH_INDICATOR(false),
 
@@ -118,6 +136,8 @@ public enum YAMLWriteFeature implements FormatFeature
      * <p>
      *     Ignored if you provide your own {@code DumperOptions}.
      * </p>
+     *<p>
+     * Feature is disabled by default.
      */
     ALLOW_LONG_KEYS(false),
     ;

yaml/src/test/java/tools/jackson/dataformat/yaml/YAMLMapperTest.java

@@ -0,0 +1,17 @@
+package tools.jackson.dataformat.yaml;
+
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import org.junit.jupiter.api.Test;
+
+public class YAMLMapperTest extends ModuleTestBase
+{
+    // for [dataformats-text#581]
+    @Test
+    void testFormatFeatureDefaults() {
+        YAMLMapper mapper = YAMLMapper.shared();
+        assertTrue(mapper.isEnabled(YAMLReadFeature.EMPTY_STRING_AS_NULL));
+        assertFalse(mapper.isEnabled(YAMLWriteFeature.CANONICAL_OUTPUT));
+    }
+}