VimPlug/parso
1
0
Fork 0
mirror of https://github.com/davidhalter/parso.git synced 2026-08-12 19:11:34 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Better documentation for the parso grammar.

Browse Source
This commit is contained in:
Dave Halter
2017-05-23 14:10:32 -04:00
parent 5fab429163
commit 649d2bebbc
1 changed files with 19 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
parso/grammar.py
+19 -10
View File
@@ -23,17 +23,24 @@ class Grammar(object):
If you need finer grained control over the parsed instance, there will be If you need finer grained control over the parsed instance, there will be
other ways to access it. other ways to access it.
:param code: A unicode string that contains Python code. :param code str: A unicode string that contains Python code.
:param path: The path to the file you want to open. Only needed for caching. :param path str: The path to the file you want to open. Only needed for caching.
:param grammar: A Python grammar file, created with load_grammar. You may :param error_recovery bool: If enabled, any code will be returned. If
not specify it. In that case it's the current Python version. it is invalid, it will be returned as an error node. If disabled,
:param error_recovery: If enabled, any code will be returned. If it is you will get a ParseError when encountering syntax errors in your
invalid, it will be returned as an error node. If disabled, you will code.
get a ParseError when encountering syntax errors in your code. :param start_symbol str: The grammar symbol that you want to parse. Only
:param start_symbol: The grammar symbol that you want to parse. Only
allowed to be used when error_recovery is disabled. allowed to be used when error_recovery is disabled.
:param cache_path: If given saves the parso cache in this directory. If not :param cache bool: A Python grammar file, created with load_grammar.
given, defaults to the default cache places on each platform. You may not specify it. In that case it's the current Python version.
:param diff_cache bool: Diffs the cached python module against the new
code and tries to parse only the parts that have changed. Returns
the same (changed) module that is found in cache. Using this option
requires you to not do anything anymore with the old cached module,
because the contents of it might have changed.
:param cache_path bool: If given saves the parso cache in this
directory. If not given, defaults to the default cache places on
each platform.
:return: A syntax tree node. Typically the module. :return: A syntax tree node. Typically the module.
""" """
@@ -48,6 +55,8 @@ class Grammar(object):
""" """
if code is None and path is None: if code is None and path is None:
raise TypeError("Please provide either code or a path.") raise TypeError("Please provide either code or a path.")
if error_recovery and start_symbol:
raise NotImplementedError("This is currently not implemented.")
if cache and code is None and path is not None: if cache and code is None and path is not None:
# With the current architecture we cannot load from cache if the # With the current architecture we cannot load from cache if the