Parses a superset of Python allowing for inline module import expressions
Project description
Import Expression Parser (for lack of a better name)
Import Expression Parser converts code like this:
x = collections.deque!(maxsize=2)
Into this equivalent code:
x = importlib.import_module('collections').deque(maxsize=2)
Usage
>>> import import_expression
>>> import_expression.eval('collections!.Counter("bccdddeeee")')
Counter({'e': 4, 'd': 3, 'c': 2, 'b': 1})
By default, the filename for SyntaxError
s is <string>
.
To change this, pass in a filename via the filename
kwarg.
AST usage
Monkey Patching the REPL
>>> urllib.parse!.quote
File "<stdin>", line 1
urllib.parse!.quote
^
SyntaxError: invalid syntax
>>> import import_expression.patch
>>> import_expression.patch.patch(globals())
>>> urllib.parse!.quote
<function quote at 0xdeadbeef>
For convenience, you can also add the following two lines to your sitecustomize.py
:
import import_expression.patch
import_expression.patch.patch()
And all REPL sessions will use the import expression syntax.
Limitations / Known Issues
- Some invalid syntax, such as
urllib!.parse!
andimport x!
is not yet detected, though the former still works as though it wasurllib.parse!
. - Due to the hell that is f-string parsing, import expressions inside f-strings will likely never be supported.
- Due to python limitations, results of
import_expression.exec
will have no effect on the caller's globals without an explicitglobals
argument.
FAQ
Actually asked questions for a new project! Golly gee!
-
Why not just use
__import__('x')
?
From the discord.py server:devon#4089: if i want to type
_("thing")
devon#4089: i have to move my fingers between three different locations
devon#4089: both at the end and start of the string
lambda#0987: yeah and [it's] also a pain to type on mobile so ok
devon#4089: <<x>> is slightly less grating \For context, the originally proposed syntax was <<x>>.
License
Copyright © 2018 Benjamin Mintz <bmintz@protonmail.com>. All Rights Reserved.
Licensed under the MIT License. See the LICENSE.md file for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for import_expression-0.3.8-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | df31f02b068424481bdf4b8ee5faa4e39263f67cc583fef206e2b3e0d4ac1755 |
|
MD5 | 3605bb140b581110ec8fa30f0f66a162 |
|
BLAKE2b-256 | 8a5fa9a0c21df162935b495a0ec16c20f56da8f7d08497208381a1bbe6bda36a |