REDROOM

Preview: __init__.py Size: 2.83 KB

//lib/python3.6/site-packages/pycparser/__init__.py

#-----------------------------------------------------------------
# pycparser: __init__.py
#
# This package file exports some convenience functions for
# interacting with pycparser
#
# Copyright (C) 2008-2015, Eli Bendersky
# License: BSD
#-----------------------------------------------------------------
__all__ = ['c_lexer', 'c_parser', 'c_ast']
__version__ = '2.14'

from subprocess import Popen, PIPE
from .c_parser import CParser


def preprocess_file(filename, cpp_path='cpp', cpp_args=''):
    """ Preprocess a file using cpp.

        filename:
            Name of the file you want to preprocess.

        cpp_path:
        cpp_args:
            Refer to the documentation of parse_file for the meaning of these
            arguments.

        When successful, returns the preprocessed file's contents.
        Errors from cpp will be printed out.
    """
    path_list = [cpp_path]
    if isinstance(cpp_args, list):
        path_list += cpp_args
    elif cpp_args != '':
        path_list += [cpp_args]
    path_list += [filename]

    try:
        # Note the use of universal_newlines to treat all newlines
        # as \n for Python's purpose
        #
        pipe = Popen(   path_list,
                        stdout=PIPE,
                        universal_newlines=True)
        text = pipe.communicate()[0]
    except OSError as e:
        raise RuntimeError("Unable to invoke 'cpp'.  " +
            'Make sure its path was passed correctly\n' +
            ('Original error: %s' % e))

    return text


def parse_file(filename, use_cpp=False, cpp_path='cpp', cpp_args='',
               parser=None):
    """ Parse a C file using pycparser.

        filename:
            Name of the file you want to parse.

        use_cpp:
            Set to True if you want to execute the C pre-processor
            on the file prior to parsing it.

        cpp_path:
            If use_cpp is True, this is the path to 'cpp' on your
            system. If no path is provided, it attempts to just
            execute 'cpp', so it must be in your PATH.

        cpp_args:
            If use_cpp is True, set this to the command line arguments strings
            to cpp. Be careful with quotes - it's best to pass a raw string
            (r'') here. For example:
            r'-I../utils/fake_libc_include'
            If several arguments are required, pass a list of strings.

        parser:
            Optional parser object to be used instead of the default CParser

        When successful, an AST is returned. ParseError can be
        thrown if the file doesn't parse successfully.

        Errors from cpp will be printed out.
    """
    if use_cpp:
        text = preprocess_file(filename, cpp_path, cpp_args)
    else:
        with open(filename, 'rU') as f:
            text = f.read()

    if parser is None:
        parser = CParser()
    return parser.parse(text, filename)

Name	Size	Perms	Modified	Actions
__pycache__ DIR	-	drwxr-xr-x	2025-03-30 04:21:30	Edit Download recursive recursive
ast_transforms.py	3.48 KB	lrw-r--r--	2015-06-10 03:00:55	Edit Download recursive recursive
c_ast.py	22.79 KB	lrw-r--r--	2019-11-13 14:57:08	Edit Download recursive recursive
c_generator.py	13.25 KB	lrw-r--r--	2015-06-10 03:00:55	Edit Download recursive recursive
c_lexer.py	14.11 KB	lrw-r--r--	2019-11-13 14:57:05	Edit Download recursive recursive
c_parser.py	60.75 KB	lrw-r--r--	2019-11-13 14:57:05	Edit Download recursive recursive
lextab.py	7.08 KB	lrw-r--r--	2019-11-13 14:57:07	Edit Download recursive recursive
plyparser.py	1.56 KB	lrw-r--r--	2015-06-10 03:00:55	Edit Download recursive recursive
yacctab.py	123.33 KB	lrw-r--r--	2019-11-13 14:57:08	Edit Download recursive recursive
_ast_gen.py	8.46 KB	lrw-r--r--	2015-06-10 03:00:55	Edit Download recursive recursive
_build_tables.py	851 B	lrw-r--r--	2015-06-10 03:00:55	Edit Download recursive recursive
_c_ast.cfg	4.08 KB	lrw-r--r--	2015-06-10 03:00:55	Edit Download recursive recursive
__init__.py	2.83 KB	lrw-r--r--	2015-06-10 03:00:55	Edit Download recursive recursive

Directory Contents