Namespaced Imports

Any import where the beginning portion (up to the first slash) of the URL does not contain a . is considered a namespaced import.

A namespaced import means that the IMPORT_SERVER (which defaults to https://import.sh) is prepended to the import URL. For example, these two import invocations are identical:

• import "assert"
• import "https://import.sh/assert"

Example

Let's take a look at importing this [tootallnate/hello][hello] "Hello World" import from GitHub:

#!/usr/bin/env importimport "tootallnate/hello"
hello# Hello, from @TooTallNate!

The import.sh server

The default IMPORT_SERVER is https://import.sh, which serves GitHub repositories that are "import-compatible", according to the following conventions:

• The main import syntax is import <org>/<repo>
• The entry point of the import is the file with the name of the repo with a .sh suffix
• If there is no / in the import path, then the default org ([importpw][]) is applied
• Specific tags may be referenced by appending an @<version> to the end

Top-level imports

The [importpw][] GitHub organization houses the top-level namespace imports. A top-level import happens when there is no / in the import path.

For example, the assert module includes functions that write simple unit testing scripts:

#!/usr/bin/env importimport "assert"
assert 1 = 2# assertion failed: 1 = 2

Here are some useful top-level imports:

• array
• assert
• confirm
• dns
• emitter
• http
• os
• path
• prompt
• querystring
• string
• tcp

See the [importpw][] org on GitHub for the complete listing of repositories.

Community imports

Here are some GitHub repositories that are known to be compatible with import:

• kward/log4sh
• kward/shflags
• kward/shunit2
• robwhitby/shakedown
• tootallnate/nexec

(Send a pull request if you would like to have an import listed here)