old_contents: # Copyright © 2016 Jakub Wilk <jwilk@jwilk.net>
  #
  # Permission is hereby granted, free of charge, to any person obtaining a copy
  # of this software and associated documentation files (the “Software”), to deal
  # in the Software without restriction, including without limitation the rights
  # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  # copies of the Software, and to permit persons to whom the Software is
  # furnished to do so, subject to the following conditions:
  #
  # The above copyright notice and this permission notice shall be included in
  # all copies or substantial portions of the Software.
  #
  # THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  # SOFTWARE.
  
  '''
  the command-line interface
  '''
  
  import argparse
  import functools
  import io
  import sys
  
  from lib import espeak
  from lib.enc import get_encoding
  from lib.misc import (
      choose_art,
      warn,
      open_file,
  )
  from lib.parser import parse_file
  
  text_to_phonemes = functools.lru_cache(maxsize=9999)(espeak.text_to_phonemes)
  
  def check_word(loc, art, word):
      phon = text_to_phonemes(word)
      correct_art = choose_art(phon)
      if correct_art is NotImplemented:
          warn("can't determine correct article for {word!r} /{phon}/".format(word=word, phon=phon))
      elif art.lower() != correct_art:
          print('{loc}: {art} {word} -> {cart} {word} /{phon}/'.format(
              loc=loc,
              art=art,
              cart=correct_art,
              word=word,
              phon=phon,
          ))
  
  def main():
      ap = argparse.ArgumentParser(description='"a" vs "an" checker')
      ap.add_argument('files', metavar='FILE', nargs='*', default=['-'],
          help='file to check (default: stdin)')
      options = ap.parse_args()
      encoding = get_encoding()
      sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding)
      espeak.init()
      espeak.set_voice_by_name('en')
      for path in options.files:
          file = open_file(path, encoding=encoding, errors='replace')
          with file:
              for loc, art, word in parse_file(file):
                  check_word(loc, art, word)
  
  __all__ = ['main']
  
  # vim:ts=4 sts=4 sw=4 et
  
new_contents: # Copyright © 2016 Jakub Wilk <jwilk@jwilk.net>
  #
  # Permission is hereby granted, free of charge, to any person obtaining a copy
  # of this software and associated documentation files (the “Software”), to deal
  # in the Software without restriction, including without limitation the rights
  # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  # copies of the Software, and to permit persons to whom the Software is
  # furnished to do so, subject to the following conditions:
  #
  # The above copyright notice and this permission notice shall be included in
  # all copies or substantial portions of the Software.
  #
  # THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  # SOFTWARE.
  
  '''
  the command-line interface
  '''
  
  import argparse
  import functools
  import io
  import sys
  
  from lib import espeak
  from lib.enc import get_encoding
  from lib.misc import (
      choose_art,
      warn,
      open_file,
  )
  from lib.parser import parse_file
  
  text_to_phonemes = functools.lru_cache(maxsize=9999)(espeak.text_to_phonemes)
  
  def check_word(loc, art, word):
      '''
      check if the word has correct article
      '''
      phon = text_to_phonemes(word)
      correct_art = choose_art(phon)
      if correct_art is NotImplemented:
          warn("can't determine correct article for {word!r} /{phon}/".format(word=word, phon=phon))
      elif art.lower() != correct_art:
          print('{loc}: {art} {word} -> {cart} {word} /{phon}/'.format(
              loc=loc,
              art=art,
              cart=correct_art,
              word=word,
              phon=phon,
          ))
  
  def main():
      '''
      run the program
      '''
      ap = argparse.ArgumentParser(description='"a" vs "an" checker')
      ap.add_argument('files', metavar='FILE', nargs='*', default=['-'],
          help='file to check (default: stdin)')
      options = ap.parse_args()
      encoding = get_encoding()
      sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding)
      espeak.init()
      espeak.set_voice_by_name('en')
      for path in options.files:
          file = open_file(path, encoding=encoding, errors='replace')
          with file:
              for loc, art, word in parse_file(file):
                  check_word(loc, art, word)
  
  __all__ = ['main']
  
  # vim:ts=4 sts=4 sw=4 et
  
subject: add docstrings.