def _ProduceSingleContent(self, mod, showprivate=False, showinh=False):
        """An internal helper to create a page for a single module. This will
        automatically generate the needed RSF to document the module
        and save the module to its own page in its appropriate location.

        Args:
            mod (module): The single module to document as its own page
            showprivate (bool): A flag for whether or not to display private members

        Returns:
            str: The file name ready to be appended to a toctree
        """
        try:
            all = mod[1].__all__
        except AttributeError:
            raise RuntimeError('Module (%s) MUST have `__all__` defined.' % mod[1].__name__)
        try:
            name = mod[1].__displayname__
        except AttributeError:
            name = mod[0]
        try:
            category = mod[1].__category__
            self.__categories.setdefault(category, 0)
            self.__categories[category] += 1
        except AttributeError:
            pass
        feats = inspect.getmembers(mod[1])
        fname = 'content/' + mod[1].__name__.replace('.', '/').replace(' ', '-')+'.rst'
        feats = [f for f in feats if f[0] in all and (showprivate or not f[0][0:1] == '_')]
        with open(fname, 'w') as fid:
            fid.write(Classifier.GetModuleText(name, mod[1].__name__, showprivate=showprivate))

            for f in feats:
                # Check for a __displayname__
                if inspect.isclass(f[1]) or inspect.isfunction(f[1]):
                    try:
                        featname = f[1].__displayname__
                    except AttributeError:
                        featname = f[1].__name__
                    try:
                        category = f[1].__category__
                        self.__categories.setdefault(category, 0)
                        self.__categories[category] += 1
                    except AttributeError:
                        pass
                    # Make the auto doc rst
                    if inspect.isclass(f[1]):
                        fid.write(Classifier.GetClassText(featname, '%s.%s' % (mod[1].__name__, f[1].__name__), showprivate=showprivate, showinh=showinh))
                    elif inspect.isfunction(f[1]):
                         fid.write(Classifier.GetFunctionText(featname, '%s.%s' %  (mod[1].__name__, f[1].__name__)))

            fid.close()
        return '\n   %s' % (fname.split('/')[-1])
def _ProduceSingleContent ( self , mod , showprivate = False , showinh = False ) : try : all = mod [ 1 ] . __all__ except AttributeError : raise RuntimeError ( 'Module (%s) MUST have `__all__` defined.' % mod [ 1 ] . __name__ ) try : name = mod [ 1 ] . __displayname__ except AttributeError : name = mod [ 0 ] try : category = mod [ 1 ] . __category__ self . __categories . setdefault ( category , 0 ) self . __categories [ category ] += 1 except AttributeError : pass feats = inspect . getmembers ( mod [ 1 ] ) fname = 'content/' + mod [ 1 ] . __name__ . replace ( '.' , '/' ) . replace ( ' ' , '-' ) + '.rst' feats = [ f for f in feats if f [ 0 ] in all and ( showprivate or not f [ 0 ] [ 0 : 1 ] == '_' ) ] with open ( fname , 'w' ) as fid : fid . write ( Classifier . GetModuleText ( name , mod [ 1 ] . __name__ , showprivate = showprivate ) ) for f in feats : if inspect . isclass ( f [ 1 ] ) or inspect . isfunction ( f [ 1 ] ) : try : featname = f [ 1 ] . __displayname__ except AttributeError : featname = f [ 1 ] . __name__ try : category = f [ 1 ] . __category__ self . __categories . setdefault ( category , 0 ) self . __categories [ category ] += 1 except AttributeError : pass if inspect . isclass ( f [ 1 ] ) : fid . write ( Classifier . GetClassText ( featname , '%s.%s' % ( mod [ 1 ] . __name__ , f [ 1 ] . __name__ ) , showprivate = showprivate , showinh = showinh ) ) elif inspect . isfunction ( f [ 1 ] ) : fid . write ( Classifier . GetFunctionText ( featname , '%s.%s' % ( mod [ 1 ] . __name__ , f [ 1 ] . __name__ ) ) ) fid . close ( ) return '\n   %s' % ( fname . split ( '/' ) [ - 1 ] )
An internal helper to create a page for a single module. This will
        automatically generate the needed RSF to document the module
        and save the module to its own page in its appropriate location.

        Args:
            mod (module): The single module to document as its own page
            showprivate (bool): A flag for whether or not to display private members

        Returns:
            str: The file name ready to be appended to a toctree