Add pnetcdf.libver() and pnetcdf.inq_clibvers()

Author: wkliao

docs/source/api/file_api.rst

@@ -15,8 +15,7 @@ relations among data fields stored in a netCDF file.
     detach_buff, set_fill, inq_buff_usage, inq_buff_size, inq_num_rec_vars,
     inq_num_fix_vars, inq_striping, inq_recsize, inq_version, inq_info,
     inq_header_size, inq_put_size, inq_header_extent, inq_nreqs
-   :exclude-members: dimensions, variables, file_format, libver, indep_mode,
-    path
+   :exclude-members: dimensions, variables, file_format, indep_mode, path
 
 Read-only Python Attributes of File Class
  The following class members are read-only and should not be modified by the
@@ -44,9 +43,3 @@ Read-only Python Attributes of File Class
 
       **Type:** `str`
 
-   .. attribute:: libver
-
-      The PnetCDF-Python version string.
-
-      **Type:** `str`
-

docs/source/api/function_api.rst

@@ -2,10 +2,12 @@
 Utility Functions
 ================
 
+.. autofunction:: pnetcdf::libver
 .. autofunction:: pnetcdf::strerror
 .. autofunction:: pnetcdf::strerrno
 .. autofunction:: pnetcdf::chartostring
 .. autofunction:: pnetcdf::stringtochar
 .. autofunction:: pnetcdf::set_default_format
 .. autofunction:: pnetcdf::inq_default_format
 .. autofunction:: pnetcdf::inq_file_format
+.. autofunction:: pnetcdf::inq_clibvers

include/PnetCDF.pxi

@@ -21,6 +21,7 @@ cdef extern from "pnetcdf.h":
     ctypedef int MPI_Datatype
     const_char_ptr ncmpi_strerror(int err);
     const_char_ptr ncmpi_strerrno(int err);
+    const_char_ptr ncmpi_inq_libvers();
 
 
     cdef const int NC_BYTE_C "NC_BYTE"

src/pnetcdf/__init__.py

@@ -12,3 +12,13 @@
 from ._Dimension import *
 from ._Variable import *
 from ._utils import *
+
+def libver():
+    """
+    libver()
+
+    :return: PnetCDF-Python version string.
+    :rtype: str
+    """
+    return __version__
+

src/pnetcdf/_utils.pxd

@@ -26,3 +26,4 @@ cpdef inq_default_format()
 cpdef inq_file_format(str file_name)
 cpdef inq_malloc_max_size()
 cpdef inq_malloc_size()
+cpdef inq_clibvers()

src/pnetcdf/_utils.pyx

@@ -791,6 +791,20 @@ cdef _get_format(int ncid):
 
 
 # external C functions.
+cpdef inq_clibvers():
+    """
+    inq_clibvers()
+
+    This function returns a string describing the version of the PnetCDF-C
+    library used to build this PnetCDF-Python module, and when the PnetCDF-C
+    library was built.
+
+    :return: a string about PnetCDF-C library
+    :rtype: str
+    """
+    ver_str = (<char *>ncmpi_inq_libvers()).decode('ascii')
+    return ver_str
+
 cpdef strerror(err_code):
     """
     strerror(err_code)
@@ -807,7 +821,6 @@ cpdef strerror(err_code):
     """
     cdef int ierr
     ierr = err_code
-
     err_str = (<char *>ncmpi_strerror(ierr)).decode('ascii')
     return err_str
 
@@ -873,7 +886,7 @@ cpdef inq_default_format():
 
     :Operational mode: This function is an independent subroutine.
     """
-    cdef int curformat
+    cdef int ierr, curformat
     with nogil:
         ierr = ncmpi_inq_default_format(&curformat)
     _check_err(ierr)