fast-csv-loader 2.2.0__tar.gz → 2.2.1__tar.gz

{fast_csv_loader-2.2.0 → fast_csv_loader-2.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-csv-loader
-Version: 2.2.0
+Version: 2.2.1
 Summary: A fast and memory efficient way to load large CSV files (Timeseries data) into Pandas
 Project-URL: Bug Tracker, https://github.com/BennyThadikaran/fast_csv_loader/issues
 Project-URL: Homepage, https://github.com/BennyThadikaran/fast_csv_loader
@@ -43,6 +43,11 @@ It also improves program execution time, when iterating or loading a large numbe
 
 **Supports Python >= 3.8**
 
+> **Note (v2.2.0):** This release introduces `cached_csv_loader`, an optional drop-in caching layer for `csv_loader` that significantly improves performance for repeated file reads. Existing behavior remains unchanged. Users are encouraged to review the updated documentation for details on cache behavior, invalidation, and configuration options.
+>
+> This feature was contributed by GitHub user **sai2311-eng**.
+
+
 ## Install
 
 `pip install fast-csv-loader`

{fast_csv_loader-2.2.0 → fast_csv_loader-2.2.1}/README.md

@@ -14,6 +14,11 @@ It also improves program execution time, when iterating or loading a large numbe
 
 **Supports Python >= 3.8**
 
+> **Note (v2.2.0):** This release introduces `cached_csv_loader`, an optional drop-in caching layer for `csv_loader` that significantly improves performance for repeated file reads. Existing behavior remains unchanged. Users are encouraged to review the updated documentation for details on cache behavior, invalidation, and configuration options.
+>
+> This feature was contributed by GitHub user **sai2311-eng**.
+
+
 ## Install
 
 `pip install fast-csv-loader`

{fast_csv_loader-2.2.0 → fast_csv_loader-2.2.1}/fast_csv_loader/cached_loader.py

@@ -33,7 +33,8 @@ from __future__ import annotations
 import threading
 from datetime import datetime
 from pathlib import Path
-from typing import List, Optional
+from typing import Optional
+from collections.abc import Sequence
 
 import pandas as pd
 
@@ -62,7 +63,7 @@ def cached_csv_loader(
     period: int = 160,
     end_date: Optional[datetime] = None,
     date_format: Optional[str] = None,
-    use_columns: Optional[List[str]] = None,
+    use_columns: Optional[Sequence[str]] = None,
     chunk_size: int = 1024 * 6,
 ) -> pd.DataFrame:
     """
@@ -98,9 +99,9 @@ def cached_csv_loader(
         CSV date column if automatic parsing fails.
     :type date_format: Optional[str]
 
-    :param use_columns: List of column names to load from the CSV file.
-        If None, all columns are loaded.
-    :type use_columns: Optional[List[str]]
+    :param use_columns: Default None. A sequence (e.g., list or tuple) of column names to load
+        from the CSV file. If None, all columns are loaded.
+    :type use_columns: Optional[Sequence[str]]
 
     :param chunk_size: Size of chunks (in bytes) used when reading the CSV
         file. Default is 6144 bytes (6 KB).

{fast_csv_loader-2.2.0 → fast_csv_loader-2.2.1}/fast_csv_loader/csv_loader.py

@@ -2,8 +2,8 @@ import io
 import os
 from datetime import datetime
 from pathlib import Path
-from typing import Optional, List
-
+from typing import Optional
+from collections.abc import Sequence
 import pandas as pd
 
 
@@ -12,7 +12,7 @@ def csv_loader(
     period: int = 160,
     end_date: Optional[datetime] = None,
     date_format: Optional[str] = None,
-    use_columns: Optional[List[str]] = None,
+    use_columns: Optional[Sequence[str]] = None,
     chunk_size: int = 1024 * 6,
 ) -> pd.DataFrame:
     """
@@ -35,8 +35,9 @@ def csv_loader(
     :param date_format: Custom date format in case pandas is unable to parse the date column.
     :type date_format: Optional[str]
 
-    :param use_columns: Default None. List of column names to load from the CSV file. If None, all columns are loaded.
-    :type use_columns: Optional[List[str]]
+    :param use_columns: Default None. A sequence (e.g., list or tuple) of column names to load
+        from the CSV file. If None, all columns are loaded.
+    :type use_columns: Optional[Sequence[str]]
 
     :param chunk_size: The size of data chunks loaded into memory.
         The default is 6144 bytes (6 KB).

{fast_csv_loader-2.2.0 → fast_csv_loader-2.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ requires = [ "hatchling" ]
 
 [project]
 name = "fast-csv-loader"
-version = "2.2.0"
+version = "2.2.1"
 description = "A fast and memory efficient way to load large CSV files (Timeseries data) into Pandas"
 readme = "README.md"
 keywords = [ "csv-loader", "csv-reader", "memory-efficient", "pandas-dataframe", "python3" ]
@@ -33,5 +33,5 @@ urls."Bug Tracker" = "https://github.com/BennyThadikaran/fast_csv_loader/issues"
 urls.Homepage = "https://github.com/BennyThadikaran/fast_csv_loader"
 
 [tool.hatch]
-build.targets.sdist.exclude = [ "docs", "tests", ".github" ]
-build.targets.wheel.exclude = [ "docs", "tests", ".github" ]
+build.targets.wheel.exclude = [ ".github", "docs", "tests" ]
+build.targets.sdist.exclude = [ ".github", "docs", "tests" ]

fast_csv_loader-2.2.1/requirements.txt

@@ -0,0 +1,4 @@
+pandas==2.0.3; python_version == "3.8"
+pandas==2.2.2; python_version > "3.8" and python_version < "3.13"
+pandas==2.2.3; python_version >= "3.13" and python_version < "3.14"
+pandas==2.3.3; python_version >= "3.14"

fast_csv_loader-2.2.0/requirements.txt

@@ -1 +0,0 @@
-pandas >= 2, <3