Frappe Framework

https://docs.frappe.io/framework/
Admin
Frappe Framework is a full-stack web framework written in Python and JavaScript, designed for...
Tokens:363,831
Snippets:3,404
Trust Score:10
Update:1 week ago
Show doc for...
Tokens:
Raw
### Example: bench version --format plain

Source: https://docs.frappe.io/framework/user/en/bench/reference/bench-version

Example command to get human-readable information about installed apps on the current bench, including commit messages.

```bash
bench version --format plain
```

--------------------------------

### Setup sites and apps with bench

Source: https://docs.frappe.io/framework/user/en/production-setup

Sets up a new site and installs apps. Creates a site named example.com, downloads the erpnext app and a custom app from a Git repository, then installs both apps on the site.

```bash
# change directory to frappe-bench
cd frappe-bench

# create a new site
bench new-site example.com

# download frappe apps or your custom-apps
bench get-app erpnext
bench get-app https://github.com/yourremote/yourapp.git

# install apps onto your site
bench --site example.com install-app erpnext yourapp
```

--------------------------------

### Example: bench version -f json

Source: https://docs.frappe.io/framework/user/en/bench/reference/bench-version

Example command to get bench version information in JSON format using the short flag -f.

```bash
bench version -f json
```

--------------------------------

### modules.txt example

Source: https://docs.frappe.io/framework/user/en/guides/basics/apps

Example modules.txt content showing modules for the ERPNext app. Modules organize Documents and each gets an icon on the Desk.

```text
 accounts
 buying
 home
 hr
 manufacturing
 projects
 selling
 setup
 stock
 support
 utilities
 contacts
```

--------------------------------

### Setup Bench Manager on an existing bench

Source: https://docs.frappe.io/framework/user/en/bench/bench-commands

Run this command on an existing bench to install Bench Manager. It creates a new site bench-manager.local, fetches the bench_manager app, and installs the app on that site, which you can then manage via the /desk view.

```zsh
➜ bench setup manager
```

--------------------------------

### Initialize MySQL server setup on macOS

Source: https://docs.frappe.io/framework/user/en/installation

Initializes MySQL server setup if not prompted for root password during installation. Only run if not prompted.

```bash
sudo mariadb-secure-installation
```

--------------------------------

### Install app on site

Source: https://docs.frappe.io/framework/user/en/tutorial/create-a-site

Install the Library Management app on the site. The output shows the installation progress.

```bash
$ bench --site library.localhost install-app library_management

Installing library_management...
```

--------------------------------

### Open bench console for a site

Source: https://docs.frappe.io/framework/user/en/debugging

Starts an iPython shell for the specified site, importing frappe and connecting to the database. The output shows an example of fetching a document and its representation.

```bash
▶ bench --site [sitename] console

In [1]: frappe.get_doc('Task', 'TASK00004')
Out[1]: <erpnext.projects.doctype.task.task.task at="" 0x10825d710="">
  
```

--------------------------------

### Start bench with start

Source: https://docs.frappe.io/framework/user/en/bench/bench-commands

Starts the bench development server. After starting, access the site at localhost:8000 (or your external IP). Default login is Administrator with the password set during site creation.

```zsh
➜ bench start
```

--------------------------------

### Install an app with bench install-app

Source: https://docs.frappe.io/framework/user/en/guides/basics/apps

Command to install an app to a site.

```bash
 bench --site site_name install-app app_name
```

--------------------------------

### bench setup command usage

Source: https://docs.frappe.io/framework/user/en/bench/bench-commands

General usage for the setup command group. Use this to run any setup subcommand within the current bench context.

```zsh
➜ bench setup COMMAND [ARGS]...
```

--------------------------------

### Interactive prompts and installation output for bench new-app

Source: https://docs.frappe.io/framework/user/en/tutorial/create-an-app

Shows the prompts you will see when creating an app, followed by the installation output. The app is created in the apps folder and installed with pip and bench build.

```bash
App Title (default: Library Management):
App Description: Library Management System
App Publisher: Faris Ansari
App Email: faris@example.com
App Icon (default 'octicon octicon-file-directory'):
App Color (default 'grey'):
App License (default 'MIT'):
'library_management' created at /home/frappe/frappe-bench/apps/library_management

Installing library_management
$ ./env/bin/pip install -q -U -e ./apps/library_management
$ bench build --app library_management
yarn run v1.22.4
$ FRAPPE_ENV=production node rollup/build.js --app library_management
Production mode
✔ Built js/moment-bundle.min.js
✔ Built js/libs.min.js
✨  Done in 1.95s.
```

--------------------------------

### Install bench CLI with uv

Source: https://docs.frappe.io/framework/user/en/installation

Installs the bench CLI via pip using uv.

```bash
uv tool install frappe-bench
```

--------------------------------

### Install Bench with Easy Install script

Source: https://docs.frappe.io/framework/user/en/production-setup

Installs bench with the --production flag on supported Linux distributions (Debian, Ubuntu, CentOS). Replace [frappe-user] with the desired user.

```bash
sudo python install.py --production --user [frappe-user]
```

--------------------------------

### After instrumentation example

Source: https://docs.frappe.io/framework/user/en/ui-testing

Example of source code after instrumentation with Istanbul, showing inserted counters.

```bash
cov_1m1jljnmzu();

function foo(a, b) {
 cov_1m1jljnmzu().f[0]++;
 cov_1m1jljnmzu().s[0]++;

 if (a < b) {
 cov_1m1jljnmzu().b[0][0]++;
 cov_1m1jljnmzu().s[1]++;
 return b - a;
 } else {
 cov_1m1jljnmzu().b[0][1]++;
 cov_1m1jljnmzu().s[2]++;
 return a - b;
 }
}
```

--------------------------------

### Install hooks: before_install, after_install, after_sync

Source: https://docs.frappe.io/framework/user/en/python-api/hooks

Install hooks allow running code before and after app installation. The hooks.py file defines module paths to functions in app/setup/install.py that execute at each stage.

```python
# python module path
before_install = "app.setup.install.before_install"
after_install = "app.setup.install.after_install"
after_sync = "app.setup.install.after_sync"
  
```

```python
# will run before app is installed on site
def before_install():
    pass

# will run after app is installed on site
def after_install():
    pass

# will run after app fixtures are synced
def after_sync():
    pass
  
```

--------------------------------

### Create a new site and install an app

Source: https://docs.frappe.io/framework/user/en/bench/reference/new-site

Creates a new site and installs an app that is available on the current bench.

```bash
bench new-site {site} --install-app {app}
```

--------------------------------

### Install an app on a site with bench install-app

Source: https://docs.frappe.io/framework/user/en/basics/apps

Installs the app on a site, creating the models and database tables for the app. Run this command to use the app on the specified site.

```sh
$ bench --site site_name install-app custom_app

Installing custom_app...
```

--------------------------------

### More bench execute examples

Source: https://docs.frappe.io/framework/user/en/bench/reference/execute

A collection of additional bench execute examples covering common Frappe operations: clearing cache, getting documents, counting records, running whitelisted methods, checking record existence, getting configuration values, executing DocType methods, and chaining operations.

```bash
# Clear cache for a specific DocType
bench --site frappe.test execute frappe.clear_cache --doctype "Sales Order"

# Get a document
bench --site frappe.test execute frappe.get_doc User Administrator

# Count records
bench --site frappe.test execute frappe.db.count User

# Run a whitelisted method
bench --site frappe.test execute myapp.api.my_function --param1 value1 --param2 value2

# Check if a record exists
bench --site frappe.test execute frappe.db.exists User guest

# Get configuration value
bench --site frappe.test execute frappe.conf.get developer_mode

# Execute a DocType method
bench --site frappe.test execute "frappe.get_doc('User', 'Administrator').get_fullname()"

# Chain operations with Python expressions
bench --site frappe.test execute "frappe.get_doc('User', 'Administrator').add_roles('System Manager')"
```

--------------------------------

### Show bench init help

Source: https://docs.frappe.io/framework/user/en/bench/bench-commands

Use `bench init --help` to see options for initializing a new bench instance. The output shows the `--python`, `--ignore-exist`, and `--apps_path` flags.

```zsh
➜ bench init --help
Usage: bench init [OPTIONS] PATH

 Initialize a new bench instance in the specified path

Options:
 --python TEXT Path to Python Executable.
 --ignore-exist Ignore if Bench instance exists.
 --apps_path TEXT path to json files with apps to install
 after init
```

--------------------------------

### Create a new bench with init

Source: https://docs.frappe.io/framework/user/en/bench/bench-commands

Initializes a new bench directory with the Frappe framework installed and sets up periodic backups. Run this command first to create your bench environment.

```zsh
➜ bench init frappe-bench && cd frappe-bench
```

--------------------------------

### Configure Grafana systemd service

Source: https://docs.frappe.io/framework/user/en/using_frappe_as_oauth_service

Use these systemd commands to enable Grafana to start on boot, start the service, and check its status. Run them after installing Grafana on a Debian-based system.

```bash
# add to systemd to start on bootup
systemctl enable grafana-server.service
# start the service
systemctl start grafana-server
# check status
systemctl status grafana-server
  
```

--------------------------------

### Initialize a new frappe-bench setup

Source: https://docs.frappe.io/framework/user/en/basics/architecture

Initializes a new frappe-bench directory with the specified name, setting up the directory structure, virtual environment, configuration, and dependencies.

```sh
bench init frappe-bench
```

--------------------------------

### doc.get_url - Get Desk URL

Source: https://docs.frappe.io/framework/user/en/api/document

Returns the Desk URL for the document, for example `/app/task/TASK00002`.

```python
url = doc.get_url()
  
```

--------------------------------

### Pagination with limit and offset

Source: https://docs.frappe.io/framework/get_query

Use limit and offset for pagination. The first example gets the first 10 users, and the second gets the next 10 users (page 2) by adding offset=10.

```python
# Get the first 10 users
query = frappe.qb.get_query("User", limit=10)

# Get the next 10 users (page 2)
query = frappe.qb.get_query("User", limit=10, offset=10)
```

--------------------------------

### GET /api/resource/Customer/CUST-00001

Source: https://docs.frappe.io/framework/user/en/guides/integration/rest_api/manipulating_documents

Retrieves a specific Customer document by its name (ID) CUST-00001. Authentication is required but not shown in this example.

```bash
curl -X GET https://{your frappe instance}/api/resource/Customer/CUST-00001
```

--------------------------------

### Example site_config.json

Source: https://docs.frappe.io/framework/user/en/basics/sites

Example site_config.json file containing database and admin credentials. Values are available in the frappe.conf local variable as a dict.

```json
{
    "db_name": "test_frappe",
    "db_password": "test_frappe",
    "admin_password": "admin",
}
  
```

--------------------------------

### Create first bench instance

Source: https://docs.frappe.io/framework/user/en/installation

Creates the first bench instance. Creates a directory, navigates into it, and initializes a new bench named my-bench.

```bash
mkdir ~/frappe
cd ~/frappe
bench init my-bench
```

--------------------------------

### Import dayjs in main.bundle.js

Source: https://docs.frappe.io/framework/user/en/basics/asset-bundling

Import and use the dayjs library in your source files after installing it with yarn. This example is from myapp/public/main.bundle.js.

```js
import * as dayjs from 'dayjs';

console.log(dayjs())
```

--------------------------------

### Get remote app with get-app

Source: https://docs.frappe.io/framework/user/en/bench/bench-commands

Downloads a remote Frappe app from a git repository. Example uses the ERPNext repository.

```zsh
➜ bench get-app erpnext https://github.com/frappe/erpnext
```

--------------------------------

### Create a new site

Source: https://docs.frappe.io/framework/user/en/bench/reference/new-site

Creates a new site with default settings. The {site} placeholder is the site name.

```bash
bench new-site {site}
```

--------------------------------

### Access token authentication request

Source: https://docs.frappe.io/framework/user/en/api/rest

Sends a GET request to frappe.auth.get_logged_user with an Authorization header using a Bearer access_token obtained from OAuth setup.

```javascript
fetch('http://<base-url>/api/method/frappe.auth.get_logged_user', {
    headers: {
        'Authorization': 'Bearer access_token'
    }
})
```

--------------------------------

### Initialize frappe-bench directory

Source: https://docs.frappe.io/framework/user/en/tutorial/install-and-setup-bench

Run this command to create a new directory named 'frappe-bench' in the current working directory. It sets up a Python virtual environment, installs the frappe app, installs node modules, and builds static assets.

```bash
$ bench init frappe-bench
```

--------------------------------

### now() - Get current datetime

Source: https://docs.frappe.io/framework/user/en/api/utils

Returns the current datetime as a string in the format yyyy-mm-dd hh:mm:ss. The example shows the output format.

```python
from frappe.utils import now

now() # '2021-05-25 06:38:52.242515'
```

--------------------------------

### Program and args for bench serve

Source: https://docs.frappe.io/framework/user/en/debugging

The program and args in launch.json replicate the bench serve command with --noreload and --nothreading flags.

```json
"program": "${workspaceFolder}/frappe/frappe/utils/bench_helper.py",
"args": ["frappe", "serve", "--port", "8000", "--noreload", "--nothreading"]
```

--------------------------------

### Form Events - frm Parameter

Source: https://docs.frappe.io/framework/user/en/api/form

Shows that form event handlers receive frm as the first parameter, using the setup event as an example.

```javascript
frappe.ui.form.on('ToDo', {
    // frm passed as the first parameter
    setup(frm) {
        // write setup code
    }
})
  
```

--------------------------------

### Create a new site with bench new-site

Source: https://docs.frappe.io/framework/user/en/tutorial/create-a-site

Run from the frappe-bench directory to create a new site. Prompts for the MariaDB root password and then for the Administrator password; the output shows the installation progress and confirms the site is set.

```bash
$ bench new-site library.localhost
MySQL root password:

Installing frappe...
Updating DocTypes for frappe        : [========================================] 100%
Set Administrator password:
*** Scheduler is disabled ***
Current Site set to library.localhost
```

--------------------------------

### frappe.get_last_doc: Get last document with filters

Source: https://docs.frappe.io/framework/user/en/api/document

Retrieves the last document matching the given filters. Example shows filtering by status 'Cancelled'.

```python
# get the last available Cancelled Task
task = frappe.get_last_doc('Task', filters={"status": "Cancelled"})
```

--------------------------------

### Distinct Results with distinct=True

Source: https://docs.frappe.io/framework/get_query

Use distinct=True to get unique rows. This example retrieves distinct customers from submitted Sales Invoices (docstatus=1).

```python
# Get distinct customers from submitted Sales Invoices
query = frappe.qb.get_query(
    "Sales Invoice",
    fields=["customer"],
    filters={"docstatus": 1},
    distinct=True
)
```

--------------------------------

### frappe.get_route() - Get current route as array

Source: https://docs.frappe.io/framework/user/en/api/js-utils

Returns the current route as an array. The example shows the output for a route like ['List', 'Task', 'List'].

```javascript
frappe.get_route()
// ["List", "Task", "List"]
```

--------------------------------

### Create a new app with bench new-app

Source: https://docs.frappe.io/framework/user/en/basics/apps

Run this command from the frappe-bench directory to create a new app. It prompts for app details and installs the app, creating the app directory in the apps folder and adding it to apps.txt.

```sh
$ bench new-app custom_app
INFO:bench.app:creating new app custom_app
App Title (default: Custom App):
App Description: Custom Frappe App
App Publisher: John Doe
App Email: custom@johndoe.com
App Icon (default 'octicon octicon-file-directory'):
App Color (default 'grey'):
App License (default 'MIT'):
'custom_app' created at /Users/johndoe/frappe-bench/apps/custom_app
INFO:bench.app:installing custom_app
INFO:bench.utils:./env/bin/pip install -q -e ./apps/custom_app
```

--------------------------------

### page.get_form_values - Get all form values

Source: https://docs.frappe.io/framework/user/en/api/page

Returns an object containing all form values from the page form toolbar. The example shows a comment with the expected output format.

```javascript
let values = page.get_form_values()
// { status: 'Open', priority: 'Low' }
```

--------------------------------

### curl request to get token

Source: https://docs.frappe.io/framework/user/en/guides/integration/rest_api/oauth-2

Example curl command to exchange the authorization code for an access token. The request includes grant_type, code, redirect_uri, and client_id as form parameters.

```bash
curl -X POST https://{your frappe instance}/api/method/frappe.integrations.oauth2.get_token \
 -H 'Content-Type: application/x-www-form-urlencoded' \
 -H 'Accept: application/json' \
 -d 'grant_type=authorization_code&code=wa1YuQMff2ZXEAu2ZBHLpJRQXcGZdr
 &redirect_uri=https%3A%2F%2Fapp.getpostman.com%2Foauth2%2Fcallback&client_id=af615c2d3a'
```

--------------------------------

### Install an app with bench install-app

Source: https://docs.frappe.io/framework/user/en/bench/frappe-commands

Installs a Frappe application on the specified site. The app must already be available on the bench.

```bash
bench --site {site} install-app {app}
```

--------------------------------

### month_diff: Calculate months between two dates

Source: https://docs.frappe.io/framework/user/en/api/utils

Returns the difference between two dates in months. The example uses a fixed start date and adds 60 days, then prints the month difference, which is 2.

```python
from frappe.utils import add_to_date, month_diff
date_1 = "2024-07-01"
date_2 = add_to_date(date_1, days=60)

print(month_diff(date_2, date_1)) #2
```

--------------------------------

### Backup site with bench

Source: https://docs.frappe.io/framework/user/en/desk/navigation/migrating-to-the-new-navigation

Run before upgrading to create a backup of the site. The upgrade deletes nothing, but a backup is the only way to restore a site exactly as it was.

```bash
bench --site <your-site> backup
```

--------------------------------

### GET /api/resource/Customer with filters

Source: https://docs.frappe.io/framework/user/en/guides/integration/rest_api/manipulating_documents

Retrieves a list of Customer documents filtered by phone number, returning only the 'name' field. The response shows a single customer with name CUST-00001. Authentication is required but not shown in this example.

```bash
curl -X GET https://{your frappe instance}/api/resource/Customer?fields=["name"]\
 &filters=[["Customer","phone","=","4915227058038"]]
```

```json
 {
 "data": [
 {
 "name": "CUST-00001"
 },
 ]
 }
```

--------------------------------

### Access Token JSON example with data array containing name-description pairs truncated with ellipsis GET /api/resource/:do revision  umentation REST API Frappé

Source: https://docs.frappe.io/framework/user/en/api/rest

 shows the default response format when no parameters are provided GET /api/resource/:doctype?*; includes a `data` array of objects with `name` truncated list of 8 items ending with `...` demonstrating typical output.xyz

```json; code: {
  "data":[
    {"description": 
{
  "data": 
```

--------------------------------

### Get SQL string with query.get_sql()

Source: https://docs.frappe.io/framework/get_query

Retrieve the generated SQL string without executing the query. The values are directly substituted, which is useful for debugging. The example output shows the format: SELECT `name`, `email` FROM `tabUser` WHERE `first_name`='Admin'.

```python
# Get the SQL string with values directly substituted (for debugging)
sql_string = query.get_sql()
print(sql_string)
# Example Output: SELECT `name`, `email` FROM `tabUser` WHERE `first_name`='Admin'
```

--------------------------------

### Start Frappe Bench with bench start

Source: https://docs.frappe.io/framework/user/en/tutorial/install-and-setup-bench

Starts the Frappe development server from the frappe-bench directory. It launches multiple processes: a Gunicorn-based Python web server, Redis servers for caching, job queuing, and socketio pub-sub, background workers, a node server for socketio, and a node server for compiling JS/CSS files. The web server listens on port 8000, but no sites are available yet until an app and site are created. Keep this terminal running and use another terminal for bench commands.

```bash
$ cd frappe-bench
$ bench start
18:16:36 system | redis_cache.1 started (pid=11231)
18:16:36 system | redis_socketio.1 started (pid=11233)
18:16:36 system | redis_queue.1 started (pid=11234)
18:16:36 system | socketio.1 started (pid=11236)
18:16:36 system | web.1 started (pid=11237)
18:16:36 system | watch.1 started (pid=11240)
18:16:36 system | schedule.1 started (pid=11241)
18:16:36 system | worker_short.1 started (pid=11242)
18:16:36 redis_queue.1 | 11234:C 10 Jul 2020 18:16:36.320 # oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo
18:16:36 redis_queue.1 | 11234:C 10 Jul 2020 18:16:36.320 # Redis version=6.0.5, bits=64, commit=00000000, modified=0, pid=11234, just started
18:16:36 redis_queue.1 | 11234:C 10 Jul 2020 18:16:36.320 # Configuration loaded
18:16:36 system | worker_long.1 started (pid=11244)
18:16:36 redis_cache.1 | 11231:C 10 Jul 2020 18:16:36.318 # oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo
18:16:36 redis_cache.1 | 11231:C 10 Jul 2020 18:16:36.318 # Redis version=6.0.5, bits=64, commit=00000000, modified=0, pid=11231, just started
18:16:36 redis_cache.1 | 11231:C 10 Jul 2020 18:16:36.318 # Configuration loaded
18:16:36 redis_cache.1 | 11231:M 10 Jul 2020 18:16:36.320 * Increased maximum number of open files to 10032 (it was originally set to 256).
18:16:36 redis_queue.1 | 11234:M 10 Jul 2020 18:16:36.325 * Increased maximum number of open files to 10032 (it was originally set to 256).
18:16:36 system | worker_default.1 started (pid=11245)
18:16:36 redis_cache.1 | 11231:M 10 Jul 2020 18:16:36.337 * Running mode=standalone, port=13000.
18:16:36 redis_cache.1 | 11231:M 10 Jul 2020 18:16:36.337 # Server initialized
18:16:36 redis_cache.1 | 11231:M 10 Jul 2020 18:16:36.337 * Ready to accept connections
18:16:36 redis_queue.1 | 11234:M 10 Jul 2020 18:16:36.367 * Running mode=standalone, port=11000.
18:16:36 redis_queue.1 | 11234:M 10 Jul 2020 18:16:36.367 # Server initialized
18:16:36 redis_queue.1 | 11234:M 10 Jul 2020 18:16:36.367 * Ready to accept connections
18:16:36 redis_socketio.1 | 11233:C 10 Jul 2020 18:16:36.359 # oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo
18:16:36 redis_socketio.1 | 11233:C 10 Jul 2020 18:16:36.359 # Redis version=6.0.5, bits=64, commit=00000000, modified=0, pid=11233, just started
18:16:36 redis_socketio.1 | 11233:C 10 Jul 2020 18:16:36.359 # Configuration loaded
18:16:36 redis_socketio.1 | 11233:M 10 Jul 2020 18:16:36.374 * Increased maximum number of open files to 10032 (it was originally set to 256).
18:16:36 redis_socketio.1 | 11233:M 10 Jul 2020 18:16:36.417 * Running mode=standalone, port=12000.
18:16:36 redis_socketio.1 | 11233:M 10 Jul 2020 18:16:36.418 # Server initialized
18:16:36 redis_socketio.1 | 11233:M 10 Jul 2020 18:16:36.418 * Ready to accept connections
18:16:37 socketio.1 | listening on *: 9000
18:16:41 web.1 | * Running on http://0.0.0.0:8000/ (Press CTRL+C to quit)
18:16:41 web.1 | * Restarting with fsevents reloader
18:16:41 watch.1 | yarn run v1.22.4
18:16:41 watch.1 | $ node rollup/watch.js
18:16:42 watch.1 |
18:16:42 watch.1 | Rollup Watcher Started
18:16:42 watch.1 |
18:16:42 watch.1 | Watching...
18:16:42 web.1 | * Debugger is active!
18:16:42 web.1 | * Debugger PIN: 100-672-925
18:16:43 watch.1 | Rebuilding frappe-web-b4.css
18:16:44 watch.1 | Rebuilding frappe-chat-web.css
18:16:44 watch.1 | Rebuilding chat.js
18:16:45 watch.1 | Rebuilding frappe-recorder.min.js
18:16:48 watch.1 | Rebuilding checkout.min.js
18:16:48 watch.1 | Rebuilding frappe-web.min.js
18:16:51 watch.1 | Rebuilding bootstrap-4-web.min.js
18:16:52 watch.1 | Rebuilding control.min.js
18:16:54 watch.1 | Rebuilding dialog.min.js
18:16:57 watch.1 | Rebuilding desk.min.css
18:16:57 watch.1 | Rebuilding frappe-rtl.css
18:16:58 watch.1 | Rebuilding printview.css
18:16:58 watch.1 | Rebuilding desk.min.js
18:17:04 watch.1 | Rebuilding form.min.css
18:17:04 watch.1 | Rebuilding form.min.js
18:17:07 watch.1 | Rebuilding list.min.css
18:17:07 watch.1 | Rebuilding list.min.js
18:17:09 watch.1 | Rebuilding report.min.css
18:17:09 watch.1 | Rebuilding report.min.js
18:17:12 watch.1 | Rebuilding web_form.min.js
18:17:12 watch.1 | Rebuilding web_form.css
18:17:13 watch.1 | Rebuilding email.css
18:17:13 watch.1 | Rebuilding social.min.js
18:17:13 watch.1 | Rebuilding barcode_scanner.min.js
18:17:15 watch.1 | Rebuilding data_import_tools.min.js
  
```

--------------------------------

### Simple example with fields

Source: https://docs.frappe.io/framework/get_query

Fetches user names and emails by specifying fields in the query. The result is a list of dictionaries, as shown in the comment.

```python
# Get all user names and emails
query = frappe.qb.get_query("User", fields=["name", "email"])
users = query.run(as_dict=True)
# users will be like: [{'name': 'Administrator', 'email': 'admin@example.com'}, ...]
```

--------------------------------

### CustomPage renderer class with can_render and render

Source: https://docs.frappe.io/framework/user/en/python-api/routing-and-rendering

Example custom page renderer class that extends BaseRenderer. It must implement `can_render` and `render`; `can_render` returning True makes this renderer responsible for the path. Custom renderers get priority over standard page renderers.

```python
from frappe.website.utils import build_response
from frappe.website.page_renderers.base_renderer import BaseRenderer

class CustomPage(BaseRenderer):
 def can_render(self):
 return True

 def render(self):
 response_html = "Custom Response"
 return self.build_response(response_html)

```

--------------------------------

### Setup SSL for custom domain with bench options

Source: https://docs.frappe.io/framework/user/en/bench/guides/adding-custom-domains.html

Use these options to configure SSL for your custom domain when running the add-domain command.

```bash
12 --ssl-certificate [path] --ssl-key [path]
```

--------------------------------

### frm.set_query - Apply filters on Link fields

Source: https://docs.frappe.io/framework/user/en/api/form

Applies filters on a Link field to limit selectable records. Must be called early in the form lifecycle, usually in setup or onload. Examples show simple filters, 'in' filters, and filters for a child table field.

```javascript
// show only customers whose territory is set to India
frm.set_query('customer', () => {
    return {
        filters: {
            territory: 'India'
        }
    }
})

// show customers whose territory is any of India, Nepal, Japan
frm.set_query('customer', () => {
    return {
        filters: {
            territory: ['in', ['India', 'Nepal', 'Japan']]
        }
    }
})

// set filters for Link field item_code in
// items field which is a Child Table
frm.set_query('item_code', 'items', () => {
    return {
        filters: {
            item_group: 'Products'
        }
    }
})
```
Tokens:
Raw