csvpath 0.0.481__tar.gz → 0.0.482__tar.gz

{csvpath-0.0.481 → csvpath-0.0.482}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: csvpath
-Version: 0.0.481
+Version: 0.0.482
 Summary: A declarative language for data extraction and validation of CSV files
 Author: David Kershaw
 Author-email: dk107dk@hotmail.com
@@ -81,8 +81,8 @@ Read more about CsvPath and see realistic CSV validation examples at <a href='ht
 - [More Examples](#examples)
 - [Grammar](#grammar)
 
-# Motivation
 <a name="motivation"></a>
+# Motivation
 
 CSV files are everywhere!
 

{csvpath-0.0.481 → csvpath-0.0.482}/csvpath/managers/results_manager.py

@@ -89,7 +89,6 @@ class ResultsManager(CsvPathsResultsManager):  # pylint: disable=C0115
     def __init__(self, *, csvpaths=None):
         self.named_results = {}
         self._csvpaths = None
-        self._variables = None
 
         # use property
         self.csvpaths = csvpaths
@@ -137,13 +136,11 @@ class ResultsManager(CsvPathsResultsManager):  # pylint: disable=C0115
         return True
 
     def get_variables(self, name: str) -> bool:
-        if self._variables is None:
-            results = self.get_named_results(name)
-            vs = {}
-            for r in results:
-                vs = {**r.csvpath.variables, **vs}
-            self._variables = vs
-        return self._variables
+        results = self.get_named_results(name)
+        vs = {}
+        for r in results:
+            vs = {**r.csvpath.variables, **vs}
+        return vs
 
     def has_lines(self, name: str) -> bool:
         results = self.get_named_results(name)

{csvpath-0.0.481 → csvpath-0.0.482}/csvpath/matching/functions/boolean/orf.py

@@ -1,4 +1,5 @@
 # pylint: disable=C0114
+from typing import Any
 from ..function_focus import MatchDecider
 from csvpath.matching.productions import Term, Variable, Header, Reference, Equality
 from ..function import Function
@@ -12,10 +13,12 @@ class Or(MatchDecider):
         self.args = Args(matchable=self)
         a = self.args.argset()
         a.arg(
-            types=[Term, Variable, Header, Function, Reference, Equality], actuals=[int]
+            types=[Term, Variable, Header, Function, Reference, Equality],
+            actuals=[None, Any],
         )
         a.arg(
-            types=[Term, Variable, Header, Function, Reference, Equality], actuals=[int]
+            types=[Term, Variable, Header, Function, Reference, Equality],
+            actuals=[None, Any],
         )
         self.args.validate(self.siblings_or_equality())
         super().check_valid()

{csvpath-0.0.481 → csvpath-0.0.482}/csvpath/matching/functions/counting/counter.py

@@ -16,6 +16,11 @@ class Counter(ValueProducer):
         self.args = Args(matchable=self)
         self.args.argset(1).arg(types=[None, Any], actuals=[int])
         self.args.validate(self.siblings())
+        name = self.first_non_term_qualifier(self.get_id())
+        # initializing the counter to 0. if we don't do this and the counter is
+        # never hit (e.g. it is behind a ->) a print returns the counter's name
+        # which is confusing.
+        self.matcher.get_variable(name, set_if_none=0)
         super().check_valid()  # pylint: disable=W0246
 
     def _produce_value(self, skip=None) -> None:

{csvpath-0.0.481 → csvpath-0.0.482}/csvpath/matching/functions/function_factory.py

@@ -3,11 +3,9 @@ from csvpath.matching.productions.expression import Matchable
 from .function import Function
 from .function_finder import FunctionFinder
 from .dates.now import Now
-from .dates.datef import Date
 from .strings.lower import Lower
 from .strings.upper import Upper
 from .strings.substring import Substring
-from .strings.string import String
 from .strings.starts_with import StartsWith
 from .strings.strip import Strip
 from .strings.length import Length, MinMaxLength
@@ -35,7 +33,6 @@ from .headers.empty_stack import EmptyStack
 from .headers.mismatch import Mismatch
 from .headers.end import End
 from .math.above import AboveBelow
-from .math.intf import Int, Num, Float
 from .math.add import Add
 from .math.subtract import Subtract
 from .math.multiply import Multiply
@@ -47,7 +44,6 @@ from .math.round import Round
 from .math.mod import Mod
 from .boolean.notf import Not
 from .boolean.inf import In
-from .boolean.boolean import Boolean
 from .boolean.orf import Or
 from .boolean.empty import Empty
 from .boolean.no import No
@@ -81,12 +77,16 @@ from .variables.get import Get
 from .variables.put import Put
 from .variables.track import Track
 from .misc.random import Random, Shuffle
-from .misc.nonef import Nonef, Blank
 from .misc.importf import Import
 from .testing.debug import Debug, BriefStackTrace, VoteStack, DoWhenStack, Log
 from .validity.line import Line
 from .validity.failed import Failed
 from .validity.fail import Fail, FailAll
+from .types.nonef import Nonef, Blank
+from .types.boolean import Boolean
+from .types.intf import Int, Num, Float
+from .types.string import String
+from .types.datef import Date
 
 
 class UnknownFunctionException(Exception):

{csvpath-0.0.481 → csvpath-0.0.482}/csvpath/matching/functions/lines/advance.py

@@ -1,7 +1,8 @@
 # pylint: disable=C0114
 from csvpath.matching.util.exceptions import ChildrenException
 from ..function_focus import SideEffect
-from csvpath.matching.productions.term import Term
+from csvpath.matching.productions import Term, Variable
+from csvpath.matching.functions.function import Function
 from ..args import Args
 
 
@@ -11,7 +12,7 @@ class Advance(SideEffect):
     def check_valid(self) -> None:
         self.args = Args(matchable=self)
         a = self.args.argset(1)
-        a.arg(types=[Term], actuals=[int])
+        a.arg(types=[Term, Variable, Function], actuals=[int])
         self.args.validate(self.siblings())
         super().check_valid()
 

{csvpath-0.0.481 → csvpath-0.0.482}/csvpath/matching/functions/strings/length.py

@@ -13,7 +13,10 @@ class Length(ValueProducer):
     def check_valid(self) -> None:
         self.args = Args(matchable=self)
         a = self.args.argset(1)
-        a.arg(types=[Term, Variable, Header, Function, Reference], actuals=[str])
+        a.arg(
+            types=[Term, Variable, Header, Function, Reference],
+            actuals=[None, str, self.args.EMPTY_STRING],
+        )
         self.args.validate(self.siblings())
         super().check_valid()
 

{csvpath-0.0.481/csvpath/matching/functions/math → csvpath-0.0.482/csvpath/matching/functions/types}/intf.py

@@ -62,9 +62,14 @@ class Num(ValueProducer):
         self.args = Args(matchable=self)
         a = self.args.argset(1)
         a.arg(
-            types=[Term, Variable, Header, Function],
-            actuals=[None, int, float, bool],
+            types=[Term, Variable, Header, Function], actuals=[None, int, float, bool]
         )
+        a = self.args.argset(5)
+        a.arg(types=[Term, Variable, Header, Function], actuals=[None, int, float])
+        a.arg(types=[Term, Variable, Header, Function], actuals=[int])
+        a.arg(types=[None, Term, Variable, Header, Function], actuals=[int])
+        a.arg(types=[None, Term, Variable, Header, Function], actuals=[int])
+        a.arg(types=[None, Term, Variable, Header, Function], actuals=[int])
         self.args.validate(self.siblings())
         super().check_valid()
 
@@ -81,4 +86,54 @@ class Num(ValueProducer):
             self.my_expression.handle_error(e)
 
     def _decide_match(self, skip=None) -> None:
-        self.match = self.default_match()
+        """
+        (value, max digits before decimal, min digits before decimal, max places, min places)
+            max of -1 means we don't care
+            min of -1 means 0, or use -1, we don't care
+
+        """
+        val = self._value_one()
+        if not ExpressionUtility.is_one_of(val, (int, float)):
+            self.match = False
+            return
+        else:
+            self.match = True
+
+        dmax = self._value_two()
+        if dmax is None:
+            dmax = -1
+        else:
+            dmax = ExpressionUtility.to_int(dmax)
+
+        dmin = self._value_three()
+        dmin = ExpressionUtility.to_int(dmin) or 0
+
+        dplaces_max = self._value_four()
+        if dplaces_max is None:
+            dplaces_max = -1
+        else:
+            dplaces_max = ExpressionUtility.to_int(dplaces_max)
+
+        dplaces_min = self._value_five()
+        dplaces_min = ExpressionUtility.to_int(dplaces_min) or 0
+
+        s = f"{val}"
+        d = ""
+        si = s.find(".")
+        if si > -1:
+            d = s[si + 1 :]
+            s = s[0:si]
+        if dmax > -1 and dmin == dmax:
+            self.match = len(s) == dmax
+        elif dmax > -1 and dmin > 0:
+            self.match = dmin <= len(s) <= dmax
+        elif dmax > -1 and dmin == -1:
+            self.match = dmax >= len(s)
+        elif dmax == -1 and dmin > -1:
+            self.match = len(s) >= dmin
+        if self.match and dplaces_max > -1 and dplaces_min == dplaces_max:
+            self.match = len(d) == dplaces_max
+        elif self.match and dplaces_max > -1 and dplaces_min in [0, -1]:
+            self.match = 0 <= len(d) <= dplaces_max
+        elif self.match and dplaces_max == -1 and dplaces_min > -1:
+            self.match = len(d) >= dplaces_min

{csvpath-0.0.481 → csvpath-0.0.482}/csvpath/matching/functions/validity/line.py

@@ -7,11 +7,11 @@ from csvpath.matching.util.expression_utility import ExpressionUtility
 from ..function_focus import MatchDecider
 from csvpath.matching.functions.function import Function
 from csvpath.matching.productions.header import Header
-from csvpath.matching.functions.strings.string import String
-from csvpath.matching.functions.misc.nonef import Nonef, Blank
-from csvpath.matching.functions.dates.datef import Date
-from csvpath.matching.functions.math.intf import Num, Float, Int
-from csvpath.matching.functions.boolean.boolean import Boolean
+from csvpath.matching.functions.types.string import String
+from csvpath.matching.functions.types.nonef import Nonef, Blank
+from csvpath.matching.functions.types.datef import Date
+from csvpath.matching.functions.types.intf import Num, Float, Int
+from csvpath.matching.functions.types.boolean import Boolean
 from ..args import Args
 
 
@@ -69,8 +69,12 @@ class Line(MatchDecider):
                         f"Line {pln}: the {ExpressionUtility._numeric_string(i)} item, {s.name}, does not match"
                     )
             else:
-                if isinstance(s, (Blank, Nonef)):
+                if isinstance(s, (Blank)):
                     continue
+                if isinstance(s, (Nonef)):
+                    if ExpressionUtility.is_none(self.matcher.line[i]):
+                        continue
+                    errors.append(f"Line {pln}: position {i} is not empty")
                 if s.children[0].name != self.matcher.csvpath.headers[i]:
                     errors.append(
                         f"Line {pln}: the {ExpressionUtility._numeric_string(i)} item, {s.children[0].name}, does not name a current header"

{csvpath-0.0.481 → csvpath-0.0.482}/csvpath/matching/functions/variables/pushpop.py

@@ -14,7 +14,7 @@ class Push(SideEffect):
         self.args = Args(matchable=self)
         a = self.args.argset(2)
         a.arg(types=[Term, Variable, Header, Function, Reference], actuals=[str])
-        a.arg(types=[Term, Variable, Header, Function, Reference], actuals=[Any])
+        a.arg(types=[Term, Variable, Header, Function, Reference], actuals=[None, Any])
         self.args.validate(self.siblings())
         super().check_valid()
 

{csvpath-0.0.481 → csvpath-0.0.482}/csvpath/matching/productions/matchable.py

@@ -154,10 +154,38 @@ class Matchable(Qualified):
         if len(self.children) == 0:
             # validation should have already caught this, if it is a problem
             return None
-        if len(self.children) >= 3:
+        if len(self.children[0].children) > 2:
             return self.children[0].children[2]
         return None
 
+    def _value_four(self, skip=None):
+        c = self._child_four()
+        if c is None:
+            return None
+        return c.to_value(skip=skip)
+
+    def _child_four(self):
+        if len(self.children) == 0:
+            # validation should have already caught this, if it is a problem
+            return None
+        if len(self.children[0].children) > 3:
+            return self.children[0].children[3]
+        return None
+
+    def _value_five(self, skip=None):
+        c = self._child_five()
+        if c is None:
+            return None
+        return c.to_value(skip=skip)
+
+    def _child_five(self):
+        if len(self.children) == 0:
+            # validation should have already caught this, if it is a problem
+            return None
+        if len(self.children[0].children) > 4:
+            return self.children[0].children[4]
+        return None
+
     def siblings_or_equality(self) -> list:
         if (
             len(self.children) == 1

csvpath-0.0.482/docs/functions/intf.md

@@ -0,0 +1,51 @@
+
+# Int, Float, Num
+
+These functions:
+- Identity numbers as types for structural validation
+- Convert values to numbers
+
+In CsvPath numbers are often upcast to floats before operations. In some cases it may be desirable to convert floats back to ints or declare the number of places.
+
+## int()
+
+Converts its argument to an int, if possible. Beyond the regular way Python converts to int, it will attempt to:
+- Swap a `None` for `0`
+- Strip a string to empty and treat as `0`
+
+If the conversion is possible there is a match.
+
+
+## float()
+
+Converts its argument to a float similar to the way `int()` does, if possible. If the conversion is possible there is a match.
+
+## num()
+
+Used for its value, `num()` converts any type to `float`, if possible, with the exception leaving `int`s and `bool`s as they are.
+
+In matching num takes up to five arguments:
+- The required value from any match component
+- Optionally:
+    - Max number of digits before the decimal
+    - Min number of digits before the decimal
+    - Max number of digits after the decimal
+    - Min number of digits after the decimal
+
+In the max/min values a `-1` means we don't care. Effectively a `-1` min is `0`.
+
+It is certainly straightforward to handle this validation in a regular expression; however, using `num()` has more type-intentionality and requires less understanding of regular expressions.
+
+# Examples
+
+```bash
+    $file.csv[*][ line( string(#firstname), num(#age, 3, 1, 0) )]
+```
+
+This declares that the age header value is a whole number < 999. More validation of ages may be needed.
+
+```bash
+    $file.csv[*][line( int(#year), num(#rain_in_year, 0, 0, 2 ) )]
+```
+This csvpath presents the number of inches of rain each year in Luxor, Egypt. .99 is large enough.
+

csvpath-0.0.482/docs/functions/line.md

@@ -0,0 +1,74 @@
+
+# Line
+
+The `line()` function is the core tool for structural validation. It gives you a way to declare the data-shape of a line. `line()` is similar to the `TABLE` declaration in SQL's DDL.
+
+`line()` takes any number of functions as arguments. The only allowed functions are data primatives. They include:
+- `string()`
+- `int()`
+- `float()`
+- `num()`
+- `date()`
+- `datetime()`
+- `bool()`
+- `none()`
+- `blank()`
+
+All of these type functions can have a `notnone` qualifier. `string()` can optionally take max and min arguments. `none()` requires an empty header. `blank()` indicates an unspecified header.
+
+The type functions only take headers as children, with the exception of string, which also optionally takes max and min int arguments. No other functions are allowed.
+
+The order of the type functions determines what order of headers is valid. You can think of line as being like a specialized `all()` with a defined order and the ability to accept None values, when so declared.
+
+# Examples
+
+```bash
+    ~ name: structural validation example with two rules
+      match-mode: no-matches
+      logic-mode: AND
+      validation-mode: print, fail, no-raise
+    ~
+    $[*][
+        line(
+            string.notnone(#firstname, 20, 1),
+            string        (#middlename, 20),
+            string.notnone(#lastname, 30, 2),
+            int           (#age),
+            date          (#date_of_birth),
+            string        (#country),
+            string        (#email, 30)
+        )
+        or( exists(#age), exists(#date_of_birth) )
+        #email -> regex(#email, "@")
+    ]
+```
+
+This csvpath defines a line as having seven headers that have string, int, and date typed-values. Additionally, there are two simple rules applied essentially on top of this line definition:
+- A line must have either an age or a date of birth
+- An email must have an `@` sign.
+
+Because `match-mode` is set to `no-matches`, if a line doesn't match this description it will be returned as we iterate through the CSV file.
+
+```bash
+    ~ name: line definition with gaps ~
+    $[*][
+        line(
+            string.notnone(#firstname, 20, 1),
+            none(),
+            string.notnone(#lastname, 30, 2),
+            int           (#age),
+            date          (#date_of_birth),
+            blank(),
+            string        (#email, 30),
+            unspecified   (#widget)
+        )
+        ~ there is a #widget header. we don't know what it is but sometimes
+          it has values. the blank() makes a placeholder for a header that
+          comes after date. there is always a header there but the name
+          isn't consistent ~
+    ]
+```
+
+In this version we are saying that middle name is always None, after date_of_birth there is something that we don't have information about, cannot rely on, and should ignore. And that the last column will be consistently present as `#widget`, but is also unknown.
+
+

{csvpath-0.0.481 → csvpath-0.0.482}/docs/functions/subtract.md

@@ -1,5 +1,5 @@
 
-# Add, Subtract, Multiply, Divide, Mod, Int, Round
+# Add, Subtract, Multiply, Divide, Mod, Round
 
 These arithmetic functions work mostly the way you would expect.
 
@@ -27,15 +27,6 @@ Divides any number of numbers. `divide()` will return `nan` when divide by `0` i
 
 Returns the modulus of two numbers. `mod()` upcasts to `float` and rounds to the hundredths.
 
-## int()
-
-Converts its argument to an int, if possible. If the convert to int fails it will attempt to:
-- Swap a `None` for `0`
-- Identify the empty string and treat as `0`
-- Swap `False` for `0`
-
-If those attempts don't work it raises `ChildrenException`.
-
 ## round()
 
 `round()` takes a numeric value and a number of places and rounds the first by the second. The function will convert a `None` or `bool` to 0.0 or 1.0. The places value must be a positive int.

{csvpath-0.0.481 → csvpath-0.0.482}/docs/functions.md

@@ -14,6 +14,7 @@ Most of the work of matching is done in match component functions. There are ove
 - [Stats](#stats)
 - [Strings](#strings)
 - [Testing](#testing)
+- [Types](#types)
 - [Validity](#validity)
 - [Variables](#variables)
 
@@ -110,8 +111,6 @@ There are lots more simple examples on the individual function pages.
 ## Dates
 <table>
 <tr><th>Function            <a name="dates"> </th><th> What it does                                              </th></tr>
-<tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/date.md'>date(value, format)</a></td><td> Returns a date parsed according to a format string.  </td></tr>
-<tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/date.md'>datetime(value, format)</a></td><td> Returns a datetime parsed according to a format string.  </td></tr>
 <tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/now.md'>now(format)</a></td><td> Returns a datetime, optionally formatted, for the current moment.       </td></tr>
 </table>
 
@@ -172,10 +171,7 @@ There are lots more simple examples on the individual function pages.
 ## Misc
 <table>
 <tr><th>Function   <a name="misc">  </th><th> What it does                                              </th></tr>
-<tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/subtract.md'>float(value)</a>    </td><td> Returns a number as a float. </td></tr>
 <tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/import.md'>import()</a></td><td> Injects another csvpath into the current csvpath. </td></tr>
-<tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/subtract.md'>int(value)</a>    </td><td> Returns a number as an int. </td></tr>
-<tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/no.md'>none()</a>                    </td><td> Returns None. </td></tr>
 <tr><td><a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/random.md'>random(starting, ending)</a></td><td> Generates a random int from starting to ending.</td>
 <tr><td><a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/random.md'>shuffle(starting, ending)</a></td><td> Generates a random int from starting to ending with no replacement.</td>
 </table>
@@ -223,7 +219,6 @@ There are lots more simple examples on the individual function pages.
 <tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/string_functions.md'>min_length(value)</a>  </td><td> Returns the length of the value.</td></tr>
 <tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/regex.md'>regex(regex-string, value)</a> </td><td> Matches on a regular expression. </td></tr>
 <tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/string_functions.md'>starts_with(value, value)</a>   </td><td> Checks if the first value starts with the second. </td></tr>
-<tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/string_functions.md'>string(value, max, min)</a>              </td><td> Declares a string, optionally with max and min lengths.  </td></tr>
 <tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/string_functions.md'>strip(value)</a>              </td><td> Trims off whitespace.  </td></tr>
 <tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/string_functions.md'>substring(value, int)</a>     </td><td> Returns the first n chars from the value. </td></tr>
 <tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/string_functions.md'>upper(value)</a>              </td><td> Makes a value uppercase.   </td></tr>
@@ -239,12 +234,29 @@ There are lots more simple examples on the individual function pages.
 <tr><td> vote_stack()           </td><td> Returns a stack with True or False for each match component's match decision. </td></tr>
 </table>
 
+
+## Types
+<table>
+<tr><th>Function            <a name="types"> </th><th> What it does                                              </th></tr>
+<tr><td>boolean(value)</td><td> A boolean value  </td></tr>
+<tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/date.md'>date(value, format)</a></td><td> Returns a date parsed according to a format string.  </td></tr>
+<tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/date.md'>datetime(value, format)</a></td><td> Returns a datetime parsed according to a format string.  </td></tr>
+<tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/intf.md'>float(value)</a>    </td><td> A number as a float. </td></tr>
+<tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/intf.md'>int(value)</a>    </td><td> A number as an int. </td></tr>
+<tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/no.md'>none()</a>                    </td><td> Returns None. </td></tr>
+<tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/intf.md'>num(value, int, int, int, int)</a>    </td><td> A number defined as min/max before and after the decimal. </td></tr>
+<tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/string_functions.md'>string(value, max, min)</a> </td><td> Declares a string, optionally with max and min lengths.  </td></tr>
+</table>
+
+
+
 ## Validity
 <table>
 <tr><th>Function            <a name="validity"> </th><th> What it does                                              </th></tr>
 <tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/fail.md'>fail()</a>  </td><td> Indicate that the CSV is invalid.   </td></tr>
 <tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/fail.md'>failed()</a></td><td> Check if the CSV is invalid.   </td></tr>
 <tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/fail.md'>fail_and_stop()</a></td><td> Stop the scan and declare the file invalid at the same time.  </td></tr>
+<tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/line.md'>line(function, function, ...)</a></td><td> Declares a typed ordered structure for lines using core data type functions like string(), int(), etc.  </td></tr>
 <tr><td> <a href='https://github.com/dk107dk/csvpath/blob/main/docs/functions/fail.md'>valid()</a></td><td> Check if the CSV is valid or invalid.  </td></tr>
 </table>