%global _empty_manifest_terminate_build 0 Name: python-Flask-Modals Version: 0.5.1 Release: 1 Summary: Use forms in Bootstrap modals with Flask. License: MIT License URL: https://github.com/deb17/flask-modals Source0: https://mirrors.aliyun.com/pypi/web/packages/29/74/6d930d8bc8b22e896114f40834a2163685e5f68b7751bf4861ccd1263008/Flask-Modals-0.5.1.tar.gz BuildArch: noarch Requires: python3-Flask %description ## Modals for Flask Use forms in Bootstrap modals with Flask. ### Description Plain forms can be boring. Using them in modals is possible, but requires JavaScript. Normal form submission in modals is problematic. This Flask extension eases the process of using forms in Bootstrap modals. Bootstrap versions 4 and 5 are supported. No JavaScript coding is required on your part. You can code in pure Python - flashing messages and rendering templates. ### Installation ```Shell pip install Flask-Modals ``` ### Setup 1. Import the `Modal` class and instantiate it in your `app.py` file. ```Python from flask_modals import Modal app = Flask(__name__) modal = Modal(app) ``` You will also need a secret key in the app config (not shown).
2. Alternatively if you are using the application factory pattern: ```Python from flask_modals import Modal modal = Modal() def create_app(): app = Flask(__name__) modal.init_app(app) ```
3. Include the following in the head tag of your base template. ```html {{ modals() }} ```
4. Include the following in the modal body. ```html
{{ modal_messages() }}
... ``` ### Basic usage You only need to import the function `render_template_modal` in your `routes.py` file. Use it instead of `render_template` in the route handler for the page with the modal form. It takes an extra argument - `modal` (the modal `id` with a default of `modal-form`).
The extension works by submitting the modal form twice - first via ajax and then, if all validations pass, normally. When submiited via ajax, it passes a field '_ajax' with the form, which can be used as shown below. Example route handler: ```Python from flask_modals import render_template_modal @app.route('/', methods=['GET', 'POST']) def index(): ajax = '_ajax' in request.form # Add this line form = LoginForm() if form.validate_on_submit(): if form.username.data != 'test' or form.password.data != 'pass': flash('Invalid username or password', 'danger') return redirect(url_for('index')) if ajax: # Add these return '' # two lines login_user(user, remember=form.remember_me.data) flash('You have logged in!', 'success') return redirect(url_for('home')) # Add this line return render_template_modal('index.html', form=form) ``` ### Other usage If you want to render a template and not redirect: ```Python @app.route('/', methods=['GET', 'POST']) def index(): ajax = '_ajax' in request.form form = LoginForm() if form.validate_on_submit(): if form.username.data != 'test' or form.password.data != 'pass': flash('Invalid username or password', 'danger') return render_template_modal('index.html', form=form) if ajax: return '' login_user(user, remember=form.remember_me.data) flash('You have logged in!', 'success') return render_template_modal('index.html', form=form) return render_template_modal('index.html', form=form) ``` If the above looks verbose, you can use the `response` decorator and return a context dictionary, like so: ```Python from flask_modals import response @app.route('/', methods=['GET', 'POST']) @response('index.html') def index(): ... ... return {'form': form} ```
### Note 1. See the examples folder in the repo for more details. 2. The extension loads the NProgress js library to display a progress bar during form submission. %package -n python3-Flask-Modals Summary: Use forms in Bootstrap modals with Flask. Provides: python-Flask-Modals BuildRequires: python3-devel BuildRequires: python3-setuptools BuildRequires: python3-pip %description -n python3-Flask-Modals ## Modals for Flask Use forms in Bootstrap modals with Flask. ### Description Plain forms can be boring. Using them in modals is possible, but requires JavaScript. Normal form submission in modals is problematic. This Flask extension eases the process of using forms in Bootstrap modals. Bootstrap versions 4 and 5 are supported. No JavaScript coding is required on your part. You can code in pure Python - flashing messages and rendering templates. ### Installation ```Shell pip install Flask-Modals ``` ### Setup 1. Import the `Modal` class and instantiate it in your `app.py` file. ```Python from flask_modals import Modal app = Flask(__name__) modal = Modal(app) ``` You will also need a secret key in the app config (not shown).
2. Alternatively if you are using the application factory pattern: ```Python from flask_modals import Modal modal = Modal() def create_app(): app = Flask(__name__) modal.init_app(app) ```
3. Include the following in the head tag of your base template. ```html {{ modals() }} ```
4. Include the following in the modal body. ```html
{{ modal_messages() }} ... ``` ### Basic usage You only need to import the function `render_template_modal` in your `routes.py` file. Use it instead of `render_template` in the route handler for the page with the modal form. It takes an extra argument - `modal` (the modal `id` with a default of `modal-form`).
The extension works by submitting the modal form twice - first via ajax and then, if all validations pass, normally. When submiited via ajax, it passes a field '_ajax' with the form, which can be used as shown below. Example route handler: ```Python from flask_modals import render_template_modal @app.route('/', methods=['GET', 'POST']) def index(): ajax = '_ajax' in request.form # Add this line form = LoginForm() if form.validate_on_submit(): if form.username.data != 'test' or form.password.data != 'pass': flash('Invalid username or password', 'danger') return redirect(url_for('index')) if ajax: # Add these return '' # two lines login_user(user, remember=form.remember_me.data) flash('You have logged in!', 'success') return redirect(url_for('home')) # Add this line return render_template_modal('index.html', form=form) ``` ### Other usage If you want to render a template and not redirect: ```Python @app.route('/', methods=['GET', 'POST']) def index(): ajax = '_ajax' in request.form form = LoginForm() if form.validate_on_submit(): if form.username.data != 'test' or form.password.data != 'pass': flash('Invalid username or password', 'danger') return render_template_modal('index.html', form=form) if ajax: return '' login_user(user, remember=form.remember_me.data) flash('You have logged in!', 'success') return render_template_modal('index.html', form=form) return render_template_modal('index.html', form=form) ``` If the above looks verbose, you can use the `response` decorator and return a context dictionary, like so: ```Python from flask_modals import response @app.route('/', methods=['GET', 'POST']) @response('index.html') def index(): ... ... return {'form': form} ```
### Note 1. See the examples folder in the repo for more details. 2. The extension loads the NProgress js library to display a progress bar during form submission. %package help Summary: Development documents and examples for Flask-Modals Provides: python3-Flask-Modals-doc %description help ## Modals for Flask Use forms in Bootstrap modals with Flask. ### Description Plain forms can be boring. Using them in modals is possible, but requires JavaScript. Normal form submission in modals is problematic. This Flask extension eases the process of using forms in Bootstrap modals. Bootstrap versions 4 and 5 are supported. No JavaScript coding is required on your part. You can code in pure Python - flashing messages and rendering templates. ### Installation ```Shell pip install Flask-Modals ``` ### Setup 1. Import the `Modal` class and instantiate it in your `app.py` file. ```Python from flask_modals import Modal app = Flask(__name__) modal = Modal(app) ``` You will also need a secret key in the app config (not shown).
2. Alternatively if you are using the application factory pattern: ```Python from flask_modals import Modal modal = Modal() def create_app(): app = Flask(__name__) modal.init_app(app) ```
3. Include the following in the head tag of your base template. ```html {{ modals() }} ```
4. Include the following in the modal body. ```html
{{ modal_messages() }} ... ``` ### Basic usage You only need to import the function `render_template_modal` in your `routes.py` file. Use it instead of `render_template` in the route handler for the page with the modal form. It takes an extra argument - `modal` (the modal `id` with a default of `modal-form`).
The extension works by submitting the modal form twice - first via ajax and then, if all validations pass, normally. When submiited via ajax, it passes a field '_ajax' with the form, which can be used as shown below. Example route handler: ```Python from flask_modals import render_template_modal @app.route('/', methods=['GET', 'POST']) def index(): ajax = '_ajax' in request.form # Add this line form = LoginForm() if form.validate_on_submit(): if form.username.data != 'test' or form.password.data != 'pass': flash('Invalid username or password', 'danger') return redirect(url_for('index')) if ajax: # Add these return '' # two lines login_user(user, remember=form.remember_me.data) flash('You have logged in!', 'success') return redirect(url_for('home')) # Add this line return render_template_modal('index.html', form=form) ``` ### Other usage If you want to render a template and not redirect: ```Python @app.route('/', methods=['GET', 'POST']) def index(): ajax = '_ajax' in request.form form = LoginForm() if form.validate_on_submit(): if form.username.data != 'test' or form.password.data != 'pass': flash('Invalid username or password', 'danger') return render_template_modal('index.html', form=form) if ajax: return '' login_user(user, remember=form.remember_me.data) flash('You have logged in!', 'success') return render_template_modal('index.html', form=form) return render_template_modal('index.html', form=form) ``` If the above looks verbose, you can use the `response` decorator and return a context dictionary, like so: ```Python from flask_modals import response @app.route('/', methods=['GET', 'POST']) @response('index.html') def index(): ... ... return {'form': form} ```
### Note 1. See the examples folder in the repo for more details. 2. The extension loads the NProgress js library to display a progress bar during form submission. %prep %autosetup -n Flask-Modals-0.5.1 %build %py3_build %install %py3_install install -d -m755 %{buildroot}/%{_pkgdocdir} if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi pushd %{buildroot} if [ -d usr/lib ]; then find usr/lib -type f -printf "\"/%h/%f\"\n" >> filelist.lst fi if [ -d usr/lib64 ]; then find usr/lib64 -type f -printf "\"/%h/%f\"\n" >> filelist.lst fi if [ -d usr/bin ]; then find usr/bin -type f -printf "\"/%h/%f\"\n" >> filelist.lst fi if [ -d usr/sbin ]; then find usr/sbin -type f -printf "\"/%h/%f\"\n" >> filelist.lst fi touch doclist.lst if [ -d usr/share/man ]; then find usr/share/man -type f -printf "\"/%h/%f.gz\"\n" >> doclist.lst fi popd mv %{buildroot}/filelist.lst . mv %{buildroot}/doclist.lst . %files -n python3-Flask-Modals -f filelist.lst %dir %{python3_sitelib}/* %files help -f doclist.lst %{_docdir}/* %changelog * Thu Jun 08 2023 Python_Bot - 0.5.1-1 - Package Spec generated