feat: add ofSingleCsvRecord methods to CsvReader for convenience

Introduce new methods to parse single CSV records:
- `ofSingleCsvRecord(String)` for simple usage.
- `ofSingleCsvRecord(CsvCallbackHandler, String)` for custom callback handling.

Author: osiegmar

lib/src/intTest/java/blackbox/reader/AbstractCsvReaderTest.java

@@ -27,6 +27,8 @@
 import de.siegmar.fastcsv.reader.CsvParseException;
 import de.siegmar.fastcsv.reader.CsvReader;
 import de.siegmar.fastcsv.reader.CsvRecord;
+import de.siegmar.fastcsv.reader.CsvRecordHandler;
+import de.siegmar.fastcsv.reader.FieldModifiers;
 import testutil.CsvRecordAssert;
 
 @SuppressWarnings({
@@ -377,7 +379,27 @@ void unreadable() {
 
     @Test
     void fieldCount() {
-        assertThat(crb.ofCsvRecord("foo,bar").iterator().next().getFieldCount()).isEqualTo(2);
+        assertThat(crb.ofSingleCsvRecord("foo,bar").getFieldCount()).isEqualTo(2);
+    }
+
+    @Test
+    void ofSingleCsvRecord() {
+        assertThat(crb.ofSingleCsvRecord("foo,bar"))
+            .satisfies(rec -> CsvRecordAssert.assertThat(rec).fields().containsExactly("foo", "bar"));
+    }
+
+    @Test
+    void ofNamedSingleCsvRecordDataMissing() {
+        assertThatThrownBy(() -> crb.ofSingleCsvRecord(""))
+            .isInstanceOf(CsvParseException.class)
+            .hasMessage("No record found in the provided data");
+    }
+
+    @Test
+    void ofSingleCsvRecordWithCustomHandler() {
+        final var cbh = CsvRecordHandler.of(c -> c.fieldModifier(FieldModifiers.TRIM));
+        assertThat(crb.ofSingleCsvRecord(cbh, " foo , bar "))
+            .satisfies(rec -> CsvRecordAssert.assertThat(rec).fields().containsExactly("foo", "bar"));
     }
 
     // test helpers

lib/src/main/java/de/siegmar/fastcsv/reader/CsvReader.java

@@ -584,6 +584,38 @@ public CsvReaderBuilder maxBufferSize(final int maxBufferSize) {
             return this;
         }
 
+        /// Convenience method to read a single CSV record from the specified string.
+        ///
+        /// If the string contains multiple records, only the first one is returned.
+        ///
+        /// @param data the CSV data to read; must not be `null`
+        /// @return a single [CsvRecord] instance containing the parsed data
+        /// @throws NullPointerException if data is `null`
+        /// @throws CsvParseException    if the data cannot be parsed
+        /// @see #ofSingleCsvRecord(CsvCallbackHandler, String)
+        public CsvRecord ofSingleCsvRecord(final String data) {
+            return ofSingleCsvRecord(CsvRecordHandler.of(), data);
+        }
+
+        /// Convenience method to read a single CSV record using a custom callback handler.
+        ///
+        /// If the string contains multiple records, only the first one is returned.
+        ///
+        /// @param <T>             the type of the CSV record.
+        /// @param callbackHandler the record handler to use. Do not reuse a handler after it has been used!
+        /// @param data            the CSV data to read; must not be `null`
+        /// @return a single record as processed by the callback handler
+        /// @throws NullPointerException if callbackHandler or data is `null`
+        /// @throws CsvParseException    if the data cannot be parsed
+        /// @see #ofSingleCsvRecord(String)
+        public <T> T ofSingleCsvRecord(final CsvCallbackHandler<T> callbackHandler, final String data) {
+            final T fetchedRecord = build(callbackHandler, data).fetch();
+            if (fetchedRecord == null) {
+                throw new CsvParseException("No record found in the provided data");
+            }
+            return fetchedRecord;
+        }
+
         /// Constructs a new index-based [CsvReader] for the specified input stream.
         ///
         /// This is a convenience method for calling [#build(CsvCallbackHandler,InputStream)] with