Ability to disable SD import

Author: michalmonday

CSV_Parser.cpp

@@ -1,7 +1,10 @@
 /*  https://github.com/michalmonday/CSV-Parser-for-Arduino  */
 
 #include "CSV_Parser.h"
-#include <SD.h>
+
+#ifndef CSV_PARSER_DONT_IMPORT_SD
+    #include <SD.h>
+#endif
 
 //#include "mem_check.h" // COMMENT-OUT BEFORE UPLOAD
 
@@ -105,9 +108,11 @@ CSV_Parser::~CSV_Parser() {
   free(leftover);
 }
 
+#ifndef CSV_PARSER_DONT_IMPORT_SD
 bool CSV_Parser::readSDfile(const char *f_name) {
   // open the file. note that only one file can be open at a time,
   // so you have to close this one before opening another.
+
   File csv_file = SD.open(f_name);
   if (!csv_file) 
     return false;
@@ -122,6 +127,7 @@ bool CSV_Parser::readSDfile(const char *f_name) {
   parseLeftover();
   return true;
 }
+#endif
 
 /*  It ensures that '\r\n' characters, delimiter and quote characters that are enclosed within string 
     value itself are properly parsed. It dynamically allocates memory, creates copy of parsed string 

CSV_Parser.h

@@ -116,7 +116,10 @@ class CSV_Parser {
       @param f_name - file name (provided file must have format that was supplied in CSV_Parser constructor)
       @return True if file could be read, false if not.
     It requires previously calling "SD.begin()".  */
+
+#ifndef CSV_PARSER_DONT_IMPORT_SD
   bool readSDfile(const char *f_name);
+#endif
 
   int getColumnsCount();
 

README.md

@@ -11,6 +11,7 @@
 * [Custom delimiter](#custom-delimiter)  
 * [Custom quote character](#custom-quote-character)  
 * [Checking if the file was parsed correctly](#checking-if-the-file-was-parsed-correctly)  
+* [Troubleshooting](#troubleshooting)  
 * [Motivation](#motivation)  
 * [Documentation](#documentation)  
 
@@ -292,6 +293,14 @@ It will display parsed header fields, their types and all the parsed values. Lik
 
 **Important - cp.print() method is using "Serial" object, it assumes that "Serial.begin(baud_rate);" was previously called.**  
 
+## Troubleshooting  
+
+Platformio users reported compilation issues due to SD library import by the CSV_Parser.cpp file. Since 0.2.1 version of this library, the SD import can be disabled by placing `#define CSV_PARSER_DONT_IMPORT_SD` above (it won't work if it's below) the CSV_Parser library import like this:  
+
+```cpp
+#define CSV_PARSER_DONT_IMPORT_SD
+#include <CSV_Parser.h>
+```
 
 ## Motivation
 I wanted to parse [covid-19 csv](https://github.com/tomwhite/covid-19-uk-data) data and couldn't find any csv parser for Arduino. So instead of rushing with a quick/dirty solution, I decided to write something that could be reused in the future (possibly by other people too).  

library.properties

@@ -1,9 +1,9 @@
 name=CSV Parser
-version=0.2.0
+version=0.2.1
 author=Michal Borowski <michalmonday17@gmail.com>
 maintainer=Michal Borowski <michalmonday17@gmail.com>
 sentence=CSV Parser for Arduino.
 paragraph=It turns CSV string into an associative array. It was written with care about speed/space efficiency.
 category=Data Processing
 url=https://github.com/michalmonday/CSV-Parser-for-Arduino
-architectures=*
+architectures=*