..  Copyright 2017 David Malcolm <dmalcolm@redhat.com>
    Copyright 2017 Red Hat, Inc.

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Lesser General Public
    License as published by the Free Software Foundation; either
    version 2.1 of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Lesser General Public License for more details.

    You should have received a copy of the GNU Lesser General Public
    License along with this library; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301
    USA

Parsers
=======

There are various parsers that take the output of specific analyzers and
turn them into :py:class:`firehose.model.Analysis` instances.

* clanganalyzer.py

  Parser for the ``.plist`` files emitted by the
  `clang-static-analyzer <https://clang-analyzer.llvm.org/>`_,
  when :option:`-plist` is passed as an option to "scan-build" or "clang"

* cppcheck.py

  Parser for output from `cppcheck <http://cppcheck.sourceforge.net/>`_,
  specifically, version 2 of its XML format as generated by:

  .. code-block:: sh

     cppcheck PATH_TO_SOURCES --xml --xml-version=2

* findbugs.py

  Parser for xml output from `findbugs <http://findbugs.sourceforge.net/>`_.

* frama_c.py

  Parser for warnings emitted by `frama-c <https://frama-c.com/>`_.

* gcc.py

  Parser for warnings emitted by `GCC <https://gcc.gnu.org/>`_.

* flawfinder.py

  Parser for warnings emitted by `flawfinder <https://www.dwheeler.com/flawfinder/>`_.

* splint.py

  Parser for the :option:`-csv` output format from `splint <http://splint.org/>`_.
