通过 pywin32 模块使用Python來控制MS Word的文章不少，可是看过后我发现他们有一个共同的问题：参考手册在哪里？
因为是通过 COM 接口进行通信的，不能使用help()或者dir()命令来获取 API 帮助，所以迫切地需要详细的文档，才能知道那些对象拥有的属性和方法。我在网上尝试找了 VBA 的参考手册，这个微软倒是有，但没找到离线版。虽说有也多半是 Windows 专用程序来阅读，颇为不便，但至少不受制于网络嘛。最后找来找去，原来 Word 2010 自带了！一如既往地隐蔽哦。点右上角的帮助图标出现「Word 帮助」窗口后，点「搜索」按钮的下拉箭头，选择「开发人员参考」，里边那个「Word 2010 开发人员参考」就是了。
别问不同的帮助主题和「搜索」有什么关系，也别问「Visual Basic 语言参考」和「Microsoft 窗体参考」为什么会在这里。微软一向是忽视逻辑的。
另外，工具栏最右边那两个按钮也很有用。
前日进行了系统升级，结果分外悲剧。在 Awesome 下，Empathy 和 gnome-terminal 都不能正常使用了。当然，Awesome 并没有升级，它很稳定。关于 Empathy 的事下篇再写，本篇只吐槽 gnome-terminal。
早些时候，我就发现我经常不能在 gnome-terminal 中成功打开输入法。昨天将 gnome-terminal 从 3.2.1-1 版本升级到 3.4.1.1-1 （以及相伴的其它组件升级）后，我发现我已经很难遇到输入法「恰巧」能够打开的时候了。于是给 GNOME 他们报了 bug。而昨天和今天早些时候，只好使用 vimim 或者复制的方式来在终端里输入中文。今天，收到 gnome-terminal 开发者 Christian Persch 的回复：
Please test if this is reproducible with either gnome-shell or metacity (latest versions from gnome 3.4) in click-to-focus mode. Anything else is entirely unsupported.
他说，如果不能在 GNOME 的组件中重现，那么他们不会修复。操你妹啊，你丫又没有平铺式WM！这不就相当于我说你们的某家电在我家里无法使用，经销商却说你们要是不能在商场里重现问题那不关他们的事么！
于是决心放弃一切有问题的 GNOME 组件，换终端了。我不想用 guake 那种特别的终端，因为一个普通的正常终端在 Awesome 下已经被我调教得很听话了。先尝试的是 lxterminal。忽略掉不完整的中文翻译，开始迁移自己的配置。终端光标不能更改为竖线就算了，竟然没办法通过命令行参数的方式指定窗口的任何可以用作区分的参数。原来 gnome-terminal 我是指定 class 的，这样我可以设置一个流动终端——按一个组合键把它叫过来，用完后再按个键让它离开。但这样做必须能够匹配到那个窗口；我还有些放 mosh 会话的终端，我可不希望它们也跟过来。
又尝试了 Xfce 的终端。这个长得和 gnome-terminal 已经比较像了。看看命令行选项，能设置 role。这个足够用了。配置下字体、颜色什么的，再去改改 Awesome 的配置就可以用了。途中还修整了下run_or_raise函数的匹配逻辑。
PS: GTK 3 更新到 3.4 后，UI 发生了很大的变化，如：
突然想给 locate 命令写个 wrapper，把输出中的家目录和一些因加密而引入的软链接显示为~。自然，这需要读取 locate 命令的输出。在 process 这个库中看到了readProcess函数，似乎是自己想要的（完整代码）：
readLocate :: [String] -> IO String readLocate args = getArgs >>= \cmd -> let args' = args ++ cmd in readProcess "locate" args' ""
结果却发现，原本 locate 命令是边查找边输出的，现在变成了先静默，然后一下子全部吐出来。没有按 Haskell 惯常的「懒惰」脾气来。这样一来，当我发现输出项目太多想按Ctrl-C中断时已经晚了。
Google 了一下，找到这个：
I guess people who want laziness can implement it themselves directly, taking care to get whatever laziness it is that they want.
好吧。我先下回 process 库的源码看看readProcess为什么不是惰性的：
readProcess
:: FilePath -- ^ command to run
-> [String] -- ^ any arguments
-> String -- ^ standard input
-> IO String -- ^ stdout
readProcess cmd args input = do
(Just inh, Just outh, _, pid) <-
createProcess (proc cmd args){ std_in = CreatePipe,
std_out = CreatePipe,
std_err = Inherit }
-- fork off a thread to start consuming the output
output <- hGetContents outh
outMVar <- newEmptyMVar
_ <- forkIO $ C.evaluate (length output) >> putMVar outMVar ()
-- now write and flush any input
when (not (null input)) $ do hPutStr inh input; hFlush inh
hClose inh -- done with stdin
-- wait on the output
takeMVar outMVar
hClose outh
-- wait on the process
ex <- waitForProcess pid
case ex of
ExitSuccess -> return output
ExitFailure r ->
ioError (mkIOError OtherError ("readProcess: " ++ cmd ++
' ':unwords (map show args) ++
" (exit " ++ show r ++ ")")
Nothing Nothing)
原来是另开了一 IO 线程读输出，然后等待进程结束后关闭管道。这解释为什么它不是惰性的——它得进程善后处理。
那好吧，改用createProcess好了：
doLocate :: IO (String, ProcessHandle)
doLocate = do
argv0 <- getProgName
let args = case argv0 of
"lre" -> ["-b", "--regex"]
_ -> []
args' <- getArgs
let args'' = args ++ args'
(_, Just out, _, p) <- createProcess (proc "locate" args''){ std_in = Inherit,
std_out = CreatePipe,
std_err = Inherit }
hSetBuffering out LineBuffering
(,) <$> hGetContents out <*> return p
改进后的程序，不会等待进程结束，而是返回输出和进程句柄。进程句柄用来等待子进程结束，同时获取退出状态。至于那个管道就不关闭了，留给操作系统解决好了。
main = do (out, p) <- doLocate putStr $ transform out waitForProcess p >>= exitWith
改进版的完整程序在此。
Tornado 自身是不支持大文件上传的。对于接收到的文件，它会把文件内容保存在内存里，而不是像 PHP 那样保存在临时文件里。这样对于大文件，问题很明显了——内容不够。所以，Tornado 上传文件的大小限制在 100M 以下了。Tornado 官方建议使用 nginx 的上传模块来处理文件上传。但是，我这个服务连 nginx 都没用的，不想为了这个还专门跑个 nginx。
于是，我尝试性地写了这么几百行代码。POST 上传的数据是multipart/form-data格式的，没有找到对应的 RFC，就对照着 HttpFox 显示的实际上传数据和 tornado 已有的代码进行修改。我理解的multipart/form-data格式是这样子的：
首先，在请求头里指定Content-Type: multipart/form-data; boundary=---------------------------12724806401896502337880080173，其中 boundary 的值是浏览器生成的，它用来分隔上传的不同文件。请求体一开始便是添加了--前缀的这个 boundary。刚开始我没太注意前边的横线多了两个，造成接收到的数据不对。在之后是\r\n，然后是和请求头格式一致的信息，如：
Content-Disposition: form-data; name="file"; filename="name.txt" Content-Type: application/octet-stream
Content-Disposition中指明了文件对应表单的域名以及上传的文件名。文件名的编码看来没有定论，我的火狐用的是 UTF-8 编码。这些信息之后又是\r\n\r\n，然后是文件内容。还好这文件内容没有经过任何编码，直接保存即可。完了之后，如果还有下一个域的数据，那么在一个\r\n后就是类似的格式，否则在\r\n后是带--前缀和--后缀的 boundary。Tornado 的代码暗示数据结尾的\r\n是可选的。
整个格式是这样子的：
-----------------------------12724806401896502337880080173 Content-Disposition: form-data; name="file"; filename="name.txt"" Content-Type: application/octet-stream This is file content. -----------------------------12724806401896502337880080173 Content-Disposition: form-data; name="file"; filename="c" Content-Type: text/plain Another file content. -----------------------------12724806401896502337880080173--
所以，要把数据保存到临时文件里去，不需要担心怎么进行流式解码了，只要确定了文件数据的起始和结束就好。为了做到这个，我只好每次都将读到的数据的最后一段长度为带前缀的 boundary 的长度加一的部分保存下来与下次读到的数据合并再处理，以此保存每段数据都是检查过 boundary 的。再加上一是为了防止\r\n被打断，下次找到 boundary 后取它前边的数据时出错。这个 edge case 还是今天写这文章时才想到，又花了不少时间测试。
最后记下 md5sum 的用法。计算 md5 时，把输出重定向到文件，校验时直接md5sum -c md5文件就可以了，不需要人工对比。
又，netcat 很好用。Arch 下使用 OpenBSD 版 netcat 发送 HTTP 请求的命令是：
nc.openbsd -q0 localhost 4322 < post
Ubuntu 现在默认的 netcat 就是 OpenBSD 版，所以直接用nc命令就可以了。
今天，哦不，已经是昨天了，看到 Google 的「Chrome Multitask Mode」。觉得挺好玩，于是亲自试了试——当然不是在 Chrome 里，而是在 Linux 里。准确地说，是在 X Window 里。我给系统弄出一对鼠标指针来了 ;-)
先看看我有哪些输入设备：
xinput --list
⎡ Virtual core pointer id=2 [master pointer (3)]
⎜ ↳ Virtual core XTEST pointer id=4 [slave pointer (2)]
⎜ ↳ SynPS/2 Synaptics TouchPad id=12 [slave pointer (2)]
⎜ ↳ TPPS/2 IBM TrackPoint id=13 [slave pointer (2)]
⎜ ↳ USB Optical Mouse id=9 [slave pointer (2)]
⎣ Virtual core keyboard id=3 [master keyboard (2)]
↳ Virtual core XTEST keyboard id=5 [slave keyboard (3)]
↳ Power Button id=6 [slave keyboard (3)]
↳ Video Bus id=7 [slave keyboard (3)]
↳ Power Button id=8 [slave keyboard (3)]
↳ Integrated Camera id=10 [slave keyboard (3)]
↳ AT Translated Set 2 keyboard id=11 [slave keyboard (3)]
↳ ThinkPad Extra Buttons id=14 [slave keyboard (3)]
一个鼠标指针不够，我还要一个：
xinput --create-master xxx
现在屏幕上就多了个鼠标指针了。但是它还不能动，因为没有对应的设备。那好，我的 USB 鼠标，你去控制另外个指针吧：
xinput --reattach 9 "xxx pointer"
Voilà！两个鼠标指针都能用了哦～
不过，这样做还是有些缺点的。比如，它会让火狐等程序迷惑不解，还是当成只有一个鼠标。在火狐中，鼠标的形状总是一样的，并且，不能同时触发两个不同的 onhover 事件。再比如，没有相关联的键盘，所以这个「新的」鼠标指针没办法配合键盘工作的，比如按住某键再点击什么的就不行。
好了，玩完了，还是回到一个鼠标指针的模式吧：
xinput --reattach 9 "Virtual core pointer" xinput --remove-master "xxx pointer"
搞到了个病毒，想看看它想干什么，扔虚拟机里跑了几次。PS: 这个病毒真大，9M 多了。
第一次，观察到其进程结构为一个 winloads.exe 进程下生成三个 xviewer.exe 工作进程。winloads.exe 无法被 Process Explorer 杀死，而 xviewer.exe 可以。工作进程总保持为三个。病毒运行过程中，耳机不时传来 Windows 页面刷新的声音，猜测这家伙在用浏览器。第二次使用 Process Monitor 观察的结果证实了这个猜测，xviewer.exe 在大量访问C:\Documents and Settings\LocalService\Local Settings\Temporary Internet Files\Content.IE5\index.dat文件。不过，Process Monitor 可能还是太弱了，不能看到事件的详细信息，也没看到网络访问。
第三次测试，将 vbox 的 NAT 网卡关掉，只留下一块 host only 的。然后本机开启 NAT 转发：
sudo sh -c "echo 1 > /proc/sys/net/ipv4/ip_forward" sudo iptables -t nat -A POSTROUTING -s 192.168.56.0/24 -j MASQUERADE
使用 Wireshark 在 vboxnet0 接口上监听。虚拟机上手动设置网关为192.168.56.1，DNS 服务器为我本机上的 dnsmasq，也就是相同的地址。
设定好后，再次运行病毒，可以看到其
原来是刷搜索排名的。难怪百度的搜索结果那么差，国内这些东西估计有不小的贡献吧？
PS: 我是用 XueTr 来结束病毒的进程们的，这个软件不支持进程树显示，但是可以多选来同时杀掉多个进程。
病毒样本及抓包结果下载链接在此。
今天看 Matz 的《Ruby编程指南》，遇到一个被称为「flip-flop」的奇特表达式：
在一个由条件式或循环所构成的上下文中，一个 flip-flop 由两个通过
..操作符相连的布尔表达式构成。除非其左侧表达式为 true，否则一个 flip-flop 表达式就是 false，而且在左侧表达式为 true 之前，它的值都会是 false。一旦该表达式为 true ，那么它就会“flips”到一个持久的 true 状态。它会保持该状态，而且对其后续的求值也返回 true，直到其右侧表达式成为 true 为止。如果其右侧表达式为 true 了，那么该 flip-flop 就会“flops”回一个持久的false状态，对其后续的求值也返回false，直到其左侧表达式再次成为 true 为止。[...]
Flip-flop 是一个非常晦涩的 Ruby 特性，因此最好不要在你的代码中使用它。但是它们并不是 Ruby 所独有的，Ruby 从 Perl 那里继承了这个特性，而 Perl 则从 Unix 的文本处理工具 sed 和 awk 那里继承了这个特性（注4）。Flip-flop 的初衷是在一个开始模式和一个结束模式之间匹配一个文本文件的行，而且这仍然是使用它们的有效方式。下面的这个简单的 Ruby 程序展示了一个 flip-flop，它逐行地从一个文本文件中读取内容，打印出含有“TODO”的行。它会不断地打印文本行，直到读入一个空行为止：
ARGF.each do |line| # For each line of standard in or of named files print line if line=~/TODO/..line=~/^$/ # Print lines when flip-flop is true end
作者还说很难正式地描述一个 flip-flop 的精确行为
。但我不这么认为。
我想到了学习数字电路时遇到的各种触发器，于是乎，反复读了几次以上描述确定了 flip-flop 的行为到底如何后，列出了它的真值表，其中 A、B 为点两边的表达式的值（输入），Q 为其内部状态，Qn 就是 Qnext。
A B Q Qn 0 0 0 0 0 0 1 1 0 1 0 0 0 1 1 0 1 0 0 1 1 0 1 1 1 1 0 1 1 1 1 0
然后和那些触发器的真值表对照，赫然发现它就是JK 触发器——
J K Q Qn 0 0 0 0 0 0 1 1 0 1 X 0 1 0 X 1 1 1 0 1 1 1 1 0
看来 Matz 没学过数字电路 ;-)
PS: flip-flop 在电子电路中就是「触发器」的意思。。。
zsh 的命令行编辑使用的是 Zsh Line Editor（Zle），功能比 readline 强大不少，只是大量好用的功能都深埋于文档中，难得见识到。最近在看A User's Guide to the Z-Shell，虽然内容有些旧了，但依旧很有用。
首先说一点，以下内容均假定使用的是 Emacs 式键绑定。
暂停当前命令的编辑，先执行点其它命令。这个功能叫push-line，默认绑定在Alt-q。另有一个叫做push-line-or-edit的 widget，我把它绑过来了：
bindkey "\eq" push-line-or-edit
push-line widget 会将当前命令行上的内容放到一个栈上，显示一个新的提示符让你来执行点别的东西。比如刚写了一个长命令的一半，却发现当前目录不对。怎么办呢？readline 里我只好先Ctrl-u，执行之后再Ctrl-y粘贴回来。偶尔会找不到之前 kill 的内容。在 Zsh 里，按下Alt-q，当前命令暂存起来，你可以执行点别的命令，再显示命令提示符时，之前 push 走的命令内容会 pop 回来。而且这个操作是可以嵌套的，因为这是一个栈。
push-line-or-edit widget 多了个 or-edit 后缀。当输入一个if或者for这样的命令时，你可以写成多行，zsh 会自动判断出你的命令尚未写完，显示$PS2提示符。这时，如果想修改之前的某一行怎么办呢？push-line-or-edit widget 会把这些行命令变成一个不带有$PS2提示符的多行命令，默认键绑定中，使用Ctrl-p/n或者方向键移动即可。这个就是 zsh 的多行编辑能力。如果你喜欢使用 zsh 编辑的话，可以试试zed这个运行于 zsh 中的简单文本编辑器：
autoload zed zed some_small_text_file
按顺序执行若干条历史记录中的命令。比如我读取 3G 网卡短信使用如下的命令序列：
gnokii --smsreader gnokii --getsms SM 0 end -f sms smsmboxproc < sms > sms.mbox mutt -f sms.mbox
如果使用Ctrl-r搜索历史的话，每条命令都搜索岂不麻烦？所以有了accept-line-and-down-history这个 widget，默认绑定于Ctrl-o。先在历史记录里找到第一条需要的命令，按下Ctrl-o，命令执行后，历史记录中的下一条就会出现了。然后接着按Ctrl-o，直到需要执行的命令序列到达最后一条，这次该按Enter了。
最后一个，你是不是经常往命令行上粘贴网址？是的话，你应该知道，网址得用引号括起来，以防止有些字符被 shell 解释了。zsh 带了个功能，可以检测出当前输入的是否是 URL，如果是的话就自动转义那些特殊字符。这样往命令行上粘贴 URL 时就不需要事先打好引号了。使用如下命令启用：
autoload -U url-quote-magic zle -N self-insert url-quote-magic
使用 gnokii 读取 3G 网卡短信的方法ArchWiki上有写。安装 gnokii 后复制配置文件并将自己添加到uucp用户组中：
cp /etc/gnokiirc ~/.config/gnokii/config sudo gpasswd -a `whoami` uucp
然后修改下配置文件，主要是port = /dev/ttyUSB0和model = AT这两处。用户组的修改要下次登录时才生效，或者使用newgrp命令来登录到uucp组。据说此命令在某些 shell 里是内建命令，不过在 bash 和 zsh 里没有，只能调用外部命令，所以会开启一个新的 shell。
newgrp uucp
现在就可以读短信了。接收新信息并存储，可使用命令
gnokii --smsreader
完事之后按Ctrl-C中断。要把短信读出来，gnokii 可以把短信存储为 mbox 格式。这是一种邮件格式，使用 mutt 即可阅读。-f后边的sms即是要保存的文件名。注意，gnokii 仍会将消息输出到终端。ArchWiki 上说的是使用 xgnokii GUI 程序来读取，但是我没有找到这个程序（只有 manpage）。
gnokii --getsms SM 0 end -f sms
对于中文短信，这样会导致乱码。所以我写了个 Python 脚本来处理。三件事：一是将内容编码标识为 UTF-8，二是把按字节截断的邮件主题（短信正文的前若干个字节）最后几个无效的编码替换掉，三是将邮件主题按标准进行编码。这些事 Python 处理起来挺容易的 ;-)
#!/usr/bin/env python3
# vim:fileencoding=utf-8
import os
import sys
import email.header
for i in os.fdopen(sys.stdin.fileno(), encoding='utf-8', errors='replace'):
if i.startswith('Subject: '):
s = i[9:-1]
print('Content-Type: text/plain; charset=utf-8')
print('Subject:', email.header.Header(s, 'utf-8').encode())
else:
sys.stdout.write(i)
不知道为什么，新版 github 在项目首页上只提供 zip 归档格式的下载，要下载 gzip 包还需要点击 download 到新页面去。可是我就是不喜欢 zip 格式嘛——
// ==UserScript==
// @name github 下载默认 gzip 格式
// @namespace http://lilydjwg.is-programmer.com/
// @description 把默认的 zip 下载按键改成 gzip 的
// @include https://github.com/*
// ==/UserScript==
var dl = document.querySelector('.btn-download');
if(dl){
dl.title = dl.title.replace('zip', 'gzip')
dl.href = dl.href.replace('/zipball/', '/tarball/');
var icon = dl.querySelector('.icon');
if(icon){
icon.nextSibling.textContent = 'GZIP';
}
}
| Theme: Aeros 2.0 by TheBuckmaker.com