Connection Local Variable

原文地址:https://raw.githubusercontent.com/lujun9972/lujun9972.github.com/source/Emacs之怒/Connection Local Variable.org

目录

• 定义Connection Local Variable
• 在Elisp代码中使用Connection Local Variable

Emacs26开始新增了一种变量:Connection Local Variable. 用来为特定的连接设置特定的变量值.

值得说明的是，严格来说， Connection Local Variable 并不是一种变量，而是用来为buffer设置变量的一种接口！

定义Connection Local Variable

定义Connection Local Variable的步骤如下:

1. 启用connection local variable

   (setq enable-connection-local-variables t)
   

2. 定义一个connection profile

   (connection-local-set-profile-variables
    'remote-termux
    '((org-babel-remote-temporary-directory . "/data/data/com.termux/files/usr/tmp")))
   

   该函数会更新变量 connection-local-profile-alist 的值。

   执行完上面语句后就能从变量 connection-local-profile-alist 中看到多了一个 remote-termux 的profile，以及对应的变量值

3. 为特定规则的连接设置profile

   (connection-local-set-profiles
    '(:application 'tramp :protocol "ssh" :machine "phone" :user "lujun9972")
    'remote-termux)
   

   该函数会更新变量 connection-local-criteria-alist 的值。

   执行完上面语句后就能从变量 connection-local-criteria-alist 看到定义的规则和对应profile

在Elisp代码中使用Connection Local Variable

遗憾的是，并不是定义了Connection Local Variable后，之前所有网络连接相关的包都会神奇地自动应用Connection Local Variable的值.

Emacs为我们提供了两个函数来应用Connection Local Variable:

1. (hack-connection-local-variables-apply criteria)

   根据指定的标准，将对应条件的Connection Local Variable应用到当前buffer中

   (hack-connection-local-variables-apply '(:application 'tramp :protocol "ssh" :machine "phone" :user "lujun9972"))
   

   这时你再查看 org-babel-remote-temporary-directory 的值，你会发现已经变成了新的值

   org-babel-remote-temporary-directory is a variable defined in ‘ob-core.el’.
   Its value is ("/data/data/com.termux/files/usr/tmp")
   Original value was "/tmp/"
   Local in buffer *scratch*; global value is "/tmp/"
   
   Documentation:
   Directory to hold temporary files on remote hosts.
   
   You can customize this variable.
   
   [back]
   

2. (with-connection-local-profiles profiles &rest body)

   在应用 profiles 中的connection local variables的环境下执行body中的内容.

   (with-connection-local-profiles '(remote-termux)
     (message "%s" org-babel-remote-temporary-directory))