Skip to main content

BentoBox Local Development System

Project description

BentoDev - BentoBox Local Theme Editor

.. contents::

.. section-numbering::

Main Features

* Edit BentoBox themes locally
* Uses real data when making themes
* Use Flask to act as a proxy between server requests
* Uses Jinja2 to rigidly enforce template edits


NOTE: This package is currently only supported on POSIX systems. For those on Windows it is recommended to create a new Vagrant box before installing.

It is recommended to install bentodev on a seperate Python 3 virtual environment:

.. code-block:: bash

$ virtualenv -p python3 venv
$ source venv/bin/activate

After ensuring one is on the correct Python 3 environment simply pip install the latest version:

.. code-block:: bash

$ pip install bentodev

BentoDev functions are activated via a command line interface.

.. code-block:: bash

$ bentodev
Usage: bentodev [OPTIONS] COMMAND [ARGS]...

BentoDev Used to develop themes locally for BentoBox sites!

--version Show the version and exit.
--help Show this message and exit.

clone Clone an account you have access too.
config Base configuration
list List accounts and themes you have access too.
start Begin running the development server

Upon using BentoDev for the first time you will be propmted to use add your BentoBox account.

You may also be asked for a password to get a remote token for your session.

Cloning Themes
By using the command ``bentodev list`` or ``bentodev start`` you will see the list of available Accounts and their current associated theme.

If you do not see any Accounts/Themes you need to create an Account that is associated to your User through the BentoBox website.

To work on an Account's theme you must first clone the theme. To do so use:

.. code-block:: bash

$ bentodev clone <theme_name>

You may be prompted to connect your GitHub account to BentoBox if you have not done so previously.

The theme will then be cloned to the ``~/bentodev/sites/<theme_name>`` folder, where you can then push edits with standard git commands.

Working on Themes
Once a theme has been cloned you can then run a small local server that will handle making requests to BentoBox.

.. code-block:: bash

$ bentodev start <account_name>

You should then see the server run, where you can connect at `localhost:5000 <http://localhost:5000>`_


To develop simply Git clone the associated URL.

Feature or test branches created must have be approved through pull request review before merging with master.

To make use of all debugging features, run the BentoBox Django application locally and then run the bentodev server with the flag ``--local``:

.. code-block:: bash

$ bentodev start <account_name> --local

User Configuration

Additional user settings can be added to the user config file at ``~/bentodev/config.json``. Default settings include:

.. code-block:: javascript

"BENTO_USER": "<user_name>"

Addtional settings can be added by hand. These include

.. code-block:: javascript

"DEV_ROOT": "<dir_pat>", (ie. "/Users/<user>/test_folder/")
"HOST": "<host_value>", (ie. "")
"PORT": "<port_value>", (i.e "8000")


User support

Please use the following support channels:

* `GitHub issues <>`_
for bug reports and feature requests.
* `StackOverflow <>`_
to ask questions (please make sure to use the
`bentodev <>`_ tag).
* Tweet directly to `@bentoboxnyc <>`_.
* You can also tweet directly to `@djstein`_.

Related projects

The entire utility is completely coupled to the `BentoBox Django Application <>`_.

It pulls data from the production (or a local) BentoBox instance and allows real data to displayed as engineers/designers edit themes that are displayed on the domain.


* `Flask <https://>`_
* `Jinja2 <>`_
* `Requests <>`_

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for bentodev, version 2018.11.2
Filename, size File type Python version Upload date Hashes
Filename, size bentodev-2018.11.2-py2.py3-none-any.whl (30.5 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size bentodev-2018.11.2.tar.gz (34.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page