Extensions
Finding Extensions
pyrevit extensions search <search_pattern>
pyrevit extensions (info | help | open) <extension_name>
$ pyrevit extensions search apex # search for an extension with apex in name
$ pyrevit extensions info apex # get info on extension with apex in name
<search_pattern>: Regular Expression (REGEX) pattern to search for
Installing Extensions
pyrevit extend <extension_name> [--dest=<dest_path>] [--branch=<branch_name>] [--log=<log_file>]
$ pyrevit extend pyApex --dest="C:\pyRevit\Extensions" # install pyApex extension
--dest: This is optional. If not provided, pyRevit attempts to install extension at the defautl third-party extension folder (usually%appdata%/pyRevit/Extensions). The destination directory will be added to pyRevit extensions search paths automatically and will be loaded on the next pyRevit reload.--branch: Optional. Specific branch of the extension repo to be installed. Defaults tomasterbranch if not provided.
To installing your own extensions, you’ll need to specify what type if extension you’re installing (ui or lib) and provide the url:
pyrevit extend (ui | lib) <extension_name> <repo_url> [--dest=<dest_path>] [--branch=<branch_name>] [--log=<log_file>] [(--username=<username> --password=<password> | --token=<auth_token>)] [--persist-credentials]
$ pyrevit extend ui MyExtension "https://www.github.com/my-extension.git" --dest="C:\pyRevit\Extensions"
Preferred: --token=<token> use a fine grained token with proper scope
Deprecated in Github: If you are cloning your extension from a private repository, you can provide the --username and --password to the repo account as well.
Managing Installed Extensions
List all installed extensions:
Delete an extension completely using:
Set origin url on an extension using:
pyrevit extensions origin <extension_name> --reset [--log=<log_file>]
pyrevit extensions origin <extension_name> [<origin_url>] [--log=<log_file>]
$ # changing origin remote url for `pyApex` extension
$ pyrevit extensions origin pyApex https://www.git.com/repo.git
$ # resetting origin remote url back to default for `pyApex` extension
$ pyrevit extensions origin pyApex --reset
Add, remove extension search paths for all your existing extensions:
pyrevit extensions paths
pyrevit extensions paths forget --all [--log=<log_file>]
pyrevit extensions paths (add | forget) <extensions_path> [--log=<log_file>]
$ pyrevit extensions paths add "C:\pyRevit\MyExtensions" # add a search path
$ pyrevit extensions paths forget --all # forget all search paths
Enable or Disable an extension in pyRevit config file:
pyrevit extensions (enable | disable) <extension_name> [--log=<log_file>]
$ pyrevit extensions enable pyApex
Getting info, opening help or installed directory:
pyrevit extensions (info | help | open) <extension_name>
$ pyrevit extensions info apex # get info on extension with apex in name
$ pyrevit extensions help apex # open help page
$ pyrevit extensions open apex # open path in file explorer
Updating Extensions
pyrevit extensions update (--all | <extension_name>) [--log=<log_file>]
$ pyrevit extensions update --all # update all installed extension
$ pyrevit extensions update pyApex # update pyApex extension
Managing Extensions Lookup Sources
pyrevit can lookup in other places when searching for extensions. This means that you can define a json file with all your private extensions and add the path to the pyrevit sources. Your extensions will show up in search results from then on and can be installed by their name:
pyrevit extensions sources
pyrevit extensions sources forget --all [--log=<log_file>]
pyrevit extensions sources (add | forget) <source_json_or_url> [--log=<log_file>]
$ pyrevit extensions sources add "https://www.github.com/me/extensions.json"
<source_json_or_url>: Can be ajsonfile path or web url