Bend/docs/imports.md

Import System

Importing Relative Paths

Paths starting with ./ or ../ are imported relative to the file.

Example:

from ./utils import helper
import ../lib/math

Importing Absolute Paths

Otherwise, paths imported are relative to the folder of the main file.

Example:

from utils import helper
import lib/math

Importing Specific Top-Level Names

You can import specific top-level names from a file.

Syntax:

from path/file import name
from path/file import (name1, name2)
import (path/file/name1, path/file/name2)

Example:

from utils/helper import calculate
from lib/math import (add, subtract)
import (lib/math/add, lib/math/subtract)

Importing All Names

You can import all top-level names from a file using the wildcard *.

Syntax:

from path/file import *

Importing All .bend Files from a Folder

You can import all .bend files from a folder using the wildcard *.

Syntax:

from path import *

Aliasing Imports

You can alias imports to a different name for convenience.

Importing a File with Alias

Import the file top-level name from file.bend aliased to alias, and all other names as alias/name.

Syntax:

from path import file as alias
import path/file as alias

Example:

from utils import helper as utilsHelper
import lib/math as mathLib

Importing Specific Names with Aliases

You can import specific top-level names and alias them to different names.

Syntax:

from path/file import name as alias
from path/file import (name1 as alias1, name2 as alias2)
import (path/file/name1 as alias1, path/file/name2 as alias2)

Example:

from utils/helper import calculate as calc
from lib/math import (add as addFunc, subtract as subFunc)
import (lib/math/add as addFunc, lib/math/subtract as subFunc)