URLを比較
APIドキュメントとかでどこが変わったのかCHANGE LOGがない場合にURL同士を比較すばいいんじゃないかと思ってググりました。
するとStackOverflowには以下のような回答が。
diff <(curl http://to.my/file/one.js) <(curl http://to.my/file.two.js)
diffでええやん、と。なるほど。
でもhtmlのまま比較すると結果見るのがしんどいのでテキスト化します。
$ pip install html2text
でインストールできます。
$ html2text https://pypi.python.org/pypi/html2text
URLを指定して実行するとmarkdownで結果が出ます。
$ echo '<h1>hoge</h1><p>fuga</p><hr>' | html2text
# hoge
fuga
* * *
パイプで渡しても良い模様。
というわけで、
$ diff <(curl -s https://v2.angular.io/docs/ts/latest/guide/template-syntax.html | html2text) <(curl -s https://angular.io/docs/ts/latest/guide/template-syntax.html | html2text)
これで晴れてAngular2とAngular最新(4)のテンプレートシンタックスに違いがないことがわかりました!!
付録: html2text –help
$ html2text --version
html2text 2016.9.19
$ html2text --help
Usage: html2text [(filename|url) [encoding]]
Options:
--version show program's version number and exit
-h, --help show this help message and exit
--default-image-alt=DEFAULT_IMAGE_ALT
The default alt string for images with missing ones
--pad-tables pad the cells to equal column width in tables
--no-wrap-links wrap links during conversion
--ignore-emphasis don't include any formatting for emphasis
--reference-links use reference style links instead of inline links
--ignore-links don't include any formatting for links
--protect-links protect links from line breaks surrounding them with
angle brackets
--ignore-images don't include any formatting for images
--images-to-alt Discard image data, only keep alt text
--images-with-size Write image tags with height and width attrs as raw
html to retain dimensions
-g, --google-doc convert an html-exported Google Document
-d, --dash-unordered-list
use a dash rather than a star for unordered list items
-e, --asterisk-emphasis
use an asterisk rather than an underscore for
emphasized text
-b BODY_WIDTH, --body-width=BODY_WIDTH
number of characters per output line, 0 for no wrap
-i LIST_INDENT, --google-list-indent=LIST_INDENT
number of pixels Google indents nested lists
-s, --hide-strikethrough
hide strike-through text. only relevant when -g is
specified as well
--escape-all Escape all special characters. Output is less
readable, but avoids corner case formatting issues.
--bypass-tables Format tables in HTML rather than Markdown syntax.
--ignore-tables Ignore table-related tags (table, th, td, tr) while
keeping rows.
--single-line-break Use a single line break after a block element rather
than two line breaks. NOTE: Requires --body-width=0
--unicode-snob Use unicode throughout document
--no-automatic-links Do not use automatic links wherever applicable
--no-skip-internal-links
Do not skip internal links
--links-after-para Put links after each paragraph instead of document
--mark-code Mark program code blocks with [code]...[/code]
--decode-errors=DECODE_ERRORS
What to do in case of decode errors.'ignore', 'strict'
and 'replace' are acceptable values