docs: def augpath(path, augsuf='', augext='', augpref='', augdir=None, newext=None,
              newfname=None, ensure=False, prefix=None, suffix=None):
      """
      augments end of path before the extension.
  
      augpath
  
      Args:
          path (str):
          augsuf (str): augment filename before extension
  
      Returns:
          str: newpath
  
      Example:
          >>> # DISABLE_DOCTEST
          >>> from utool.util_path import *  # NOQA
          >>> path = 'somefile.txt'
          >>> augsuf = '_aug'
          >>> newpath = augpath(path, augsuf)
          >>> result = str(newpath)
          >>> print(result)
          somefile_aug.txt
  
      Example:
          >>> # DISABLE_DOCTEST
          >>> from utool.util_path import *  # NOQA
          >>> path = 'somefile.txt'
          >>> augsuf = '_aug2'
          >>> newext = '.bak'
          >>> augdir = 'backup'
          >>> newpath = augpath(path, augsuf, newext=newext, augdir=augdir)
          >>> result = str(newpath)
          >>> print(result)
          backup/somefile_aug2.bak
      """
      if prefix is not None:
          augpref = prefix
      if suffix is not None:
          augsuf = suffix
      # Breakup path
      dpath, fname = split(path)
      fname_noext, ext = splitext(fname)
      if newfname is not None:
          fname_noext = newfname
      # Augment ext
      if newext is None:
          newext = ext
      # Augment fname
      new_fname = ''.join((augpref, fname_noext, augsuf, newext, augext))
      # Augment dpath
      if augdir is not None:
          new_dpath = join(dpath, augdir)
          if ensure:
              # create new dir if needebe
              ensuredir(new_dpath)
      else:
          new_dpath = dpath
      # Recombine into new path
      newpath = join(new_dpath, new_fname)
      return newpath