https://github.com/ei-grad/flask-shell-ipython
Replace default flask shell command by similar command running IPython.
https://github.com/ei-grad/flask-shell-ipython
flask ipython python
Last synced: 9 months ago
JSON representation
Replace default flask shell command by similar command running IPython.
- Host: GitHub
- URL: https://github.com/ei-grad/flask-shell-ipython
- Owner: ei-grad
- License: mit
- Created: 2016-06-20T15:20:14.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2024-09-10T15:24:51.000Z (over 1 year ago)
- Last Synced: 2025-03-31T04:03:32.346Z (9 months ago)
- Topics: flask, ipython, python
- Language: Python
- Homepage: https://pypi.org/project/flask-shell-ipython
- Size: 26.4 KB
- Stars: 195
- Watchers: 6
- Forks: 15
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Flask-Shell-IPython
`flask-shell-ipython` is a Python package that replaces the default `flask
shell` command with a similar command that runs IPython. This provides an
enhanced interactive Python shell with additional features like syntax
highlighting, tab-completion, and more.
## Installation
To install `flask-shell-ipython`, simply run:
```bash
pip install flask-shell-ipython
```
## Usage
After installing `flask-shell-ipython`, the `flask shell` command will
automatically use IPython instead of the default Python shell. There are no
additional steps required.
```bash
flask shell
```
You can also pass any valid IPython arguments after the `flask shell` command:
```bash
flask shell --no-banner -i foo.py
```
## Configuration
You can configure IPython settings by adding an `IPYTHON_CONFIG` key to your
Flask app's configuration. The value should be a dictionary containing the
configuration options you'd like to set.
For example:
```python
app.config['IPYTHON_CONFIG'] = {
'InteractiveShell': {
'colors': 'Linux',
'confirm_exit': False,
},
}
```
## Testing
To run tests for `flask-shell-ipython`, install the `pytest-forked` plugin,
which enables running tests in isolated forked subprocesses to ensure running a
clean IPython instance for each test case.
### Installing Dependencies
Install testing dependencies from `requirements-test.txt`:
```bash
pip install -r requirements-test.txt
```
### Running Tests
After installing the dependencies, run the test suite with the `--forked` option:
```bash
pytest --forked
```
Please, note that does pytest-forked does not work on Windows. To test
flask-shell-ipython on Windows run each test manually.
## License
`flask-shell-ipython` is licensed under the MIT License. See the
[LICENSE](LICENSE) file for more information.
## Contributing
If you'd like to contribute to the project, feel free to submit a pull request
on the GitHub repository at http://github.com/ei-grad/flask-shell-ipython.