pyccoを使ってみたよ

以前使ってみたdoccoですが、pyccoというクローンがあったのでそっちを使ってみました。
pyccoもdoccoもPygmentsというライブラリに依存してるのですが、もともとPythonなpyccoならPython環境だけあれば済むので、
こちらのほうがよいかなーと。


Python実装以外にもRuby,Lua,Clojure,sh,C#などいろいろな実装があるみたいですが、
他の言語に対応していなかったりとかするみたいです。


pythonbrewとそれのvenvで環境を作ってあることが前提です。
環境:LinuxMint 12 64bit / pythonbrew 1.1 / Python 2.7.2

pyccoのインストール

インストールと言ってもコマンドひとつ叩くだけですが。

$ pip install pycco
Downloading/unpacking pycco
Downloading Pycco-0.3.0.tar.gz
Running setup.py egg_info for package pycco

Downloading/unpacking markdown (from pycco)
Downloading Markdown-2.1.1.zip (341Kb): 341Kb downloaded
Running setup.py egg_info for package markdown

Downloading/unpacking pygments (from pycco)
Downloading Pygments-1.4.tar.gz (3.5Mb): 3.5Mb downloaded
Running setup.py egg_info for package pygments

Downloading/unpacking pystache (from pycco)
Downloading pystache-0.3.1.tar.gz
Running setup.py egg_info for package pystache

Downloading/unpacking smartypants (from pycco)
Downloading smartypants-1.6.0.3.tar.gz
Running setup.py egg_info for package smartypants

Installing collected packages: pycco, markdown, pygments, pystache, smartypants
Running setup.py install for pycco

Installing pycco script to /home/sasaplus1/.pythonbrew/venvs/Python-2.7.2/default/bin
Running setup.py install for markdown
changing mode of build/scripts-2.7/markdown_py from 664 to 775
Converting docs/release-2.1.1.md -> build/docs/release-2.1.1.html
Converting docs/using_as_module.md -> build/docs/using_as_module.html
Converting docs/release-2.1.0.md -> build/docs/release-2.1.0.html
Converting docs/command_line.md -> build/docs/command_line.html
Converting docs/release-2.0.md -> build/docs/release-2.0.html
Converting docs/writing_extensions.md -> build/docs/writing_extensions.html
Converting docs/install.md -> build/docs/install.html
Converting docs/test_suite.md -> build/docs/test_suite.html
Converting docs/index.md -> build/docs/index.html
Converting docs/release-2.0.2.md -> build/docs/release-2.0.2.html
Converting docs/release-2.0.1.md -> build/docs/release-2.0.1.html
Converting docs/extensions/definition_lists.md -> build/docs/extensions/definition_lists.html
Converting docs/extensions/rss.md -> build/docs/extensions/rss.html
Converting docs/extensions/abbreviations.md -> build/docs/extensions/abbreviations.html
Converting docs/extensions/fenced_code_blocks.md -> build/docs/extensions/fenced_code_blocks.html
Converting docs/extensions/code_hilite.md -> build/docs/extensions/code_hilite.html
Converting docs/extensions/header_id.md -> build/docs/extensions/header_id.html
Converting docs/extensions/smart_strong.md -> build/docs/extensions/smart_strong.html
Converting docs/extensions/footnotes.md -> build/docs/extensions/footnotes.html
Converting docs/extensions/extra.md -> build/docs/extensions/extra.html
Converting docs/extensions/meta_data.md -> build/docs/extensions/meta_data.html
Converting docs/extensions/nl2br.md -> build/docs/extensions/nl2br.html
Converting docs/extensions/index.md -> build/docs/extensions/index.html
Converting docs/extensions/wikilinks.md -> build/docs/extensions/wikilinks.html
Converting docs/extensions/html_tidy.md -> build/docs/extensions/html_tidy.html
Converting docs/extensions/toc.md -> build/docs/extensions/toc.html
Converting docs/extensions/attr_list.md -> build/docs/extensions/attr_list.html
Converting docs/extensions/tables.md -> build/docs/extensions/tables.html

changing mode of /home/sasaplus1/.pythonbrew/venvs/Python-2.7.2/default/bin/markdown_py to 775
Running setup.py install for pygments

Installing pygmentize script to /home/sasaplus1/.pythonbrew/venvs/Python-2.7.2/default/bin
Running setup.py install for pystache

Running setup.py install for smartypants

Successfully installed pycco markdown pygments pystache smartypants
Cleaning up...

これでインストールされました。

使ってみる

$ vim sugoi.js
// すごいメソッドです
function sugoi() {
  // sugoiを返します
  return 'sugoi';
}
$ pycco sugoi.js
pycco = sugoi.js -> docs/sugoi.html

できた!

スクリーンショット


おおおー。doccoとほとんど変わらない!


Python使いな人はpyccoで、
node.js/Ruby使いだけれどeasy_installが気にならない人はdocco/roccoでいいのかも。