docs: def parse_agent_req_file(contents):
      """
      Returns a dictionary mapping {check-package-name --> pinned_version} from the
      given file contents. We can assume lines are in the form:
  
          datadog-active-directory==1.1.1; sys_platform == 'win32'
  
      """
      catalog = OrderedDict()
      for line in contents.splitlines():
          toks = line.split('==', 1)
          if len(toks) != 2 or not toks[0] or not toks[1]:
              # if we get here, the requirements file is garbled but let's stay
              # resilient
              continue
  
          name, other = toks
          version = other.split(';')
          catalog[name] = version[0]
  
      return catalog