Merge pull request #630 from laughingman7743/feature/s3fs-cursor

Add S3FS Cursor for lightweight CSV-based result reading

Author: laughingman7743

docs/api.rst

@@ -12,6 +12,7 @@ This section provides comprehensive API documentation for all PyAthena classes a
    api/connection
    api/pandas
    api/arrow
+   api/s3fs
    api/spark
    api/converters
    api/filesystem
@@ -35,6 +36,7 @@ Specialized Integrations
 
 - :ref:`api_pandas` - pandas DataFrame integration
 - :ref:`api_arrow` - Apache Arrow columnar data integration
+- :ref:`api_s3fs` - Lightweight S3FS-based cursor (no pandas/pyarrow required)
 - :ref:`api_spark` - Apache Spark integration for big data processing
 
 Infrastructure

docs/api/s3fs.rst

@@ -0,0 +1,42 @@
+.. _api_s3fs:
+
+S3FS Integration
+================
+
+This section covers lightweight S3FS-based cursors, CSV readers, and data converters.
+
+S3FS Cursors
+------------
+
+.. autoclass:: pyathena.s3fs.cursor.S3FSCursor
+   :members:
+   :inherited-members:
+
+.. autoclass:: pyathena.s3fs.async_cursor.AsyncS3FSCursor
+   :members:
+   :inherited-members:
+
+S3FS CSV Readers
+----------------
+
+S3FSCursor supports pluggable CSV reader implementations to control how NULL values
+and empty strings are handled when parsing Athena's CSV output.
+
+.. autoclass:: pyathena.s3fs.reader.AthenaCSVReader
+   :members:
+
+.. autoclass:: pyathena.s3fs.reader.DefaultCSVReader
+   :members:
+
+S3FS Data Converters
+--------------------
+
+.. autoclass:: pyathena.s3fs.converter.DefaultS3FSTypeConverter
+   :members:
+
+S3FS Result Set
+---------------
+
+.. autoclass:: pyathena.s3fs.result_set.AthenaS3FSResultSet
+   :members:
+   :inherited-members:

docs/index.rst

@@ -20,6 +20,7 @@ Documentation
    cursor
    pandas
    arrow
+   s3fs
    spark
    testing
    api