Merge pull request #306 from NeuroML/feat/doc-sbml

Document sbml

Author: sanjayankur31

docs/source/pyneuroml.rst

@@ -26,5 +26,6 @@ The PyNeuroML package includes the following sub-packages:
    pyneuroml.povray
    pyneuroml.runners
    pyneuroml.swc
+   pyneuroml.sbml
    pyneuroml.tune
    pyneuroml.utils

docs/source/pyneuroml.sbml.rst

@@ -0,0 +1,7 @@
+pyneuroml.sbml module
+======================
+
+.. automodule:: pyneuroml.sbml
+   :members:
+   :undoc-members:
+   :show-inheritance:

pyneuroml/sbml/__init__.py

@@ -11,10 +11,15 @@
 
 
 def validate_sbml_files(input_files: List[str], strict_units: bool = False) -> bool:
-    """
-    validate each input file using libsbml.SBMLDocument.checkConsistency
-    input_files is a list of one or more filepaths
-    strict_units converts unit consistency warnings into errors
+    """Validate input files using libsbml.SBMLDocument.checkConsistency
+
+    :param input_files: a list of one or more filepaths
+    :type input_files: list(str)
+    :param strict_units: toggle whether unit consistency warnings should be
+        treated as errors
+    :type strict_units: bool
+    :returns: True if all files are valid, else False
+    :rtype: bool
     """
 
     if not len(input_files) >= 1: