Pythonで基本的なWaveロボットを作成する

夏には、Googleサンドボックスに招待されました。 しかし、この非常にサンドボックスにはたくさんの人がいて、すべての波は公開されていて、私の貧しいネットブックはすべてのアクティビティを大きなきしみで消化しただけだったので、少し遊んで、サンドボックスを獲得しました:)

そして最近、私のサンドボックスアカウントがライブプレビューアカウントに変わりました。私は、到着した人に招待状を送信し、少なくとも1人の友人が招待するのを待ってから、ロボットAPIに対処しました。


手続きの結果、このような基本的なロボットが作成されました：bakarobo@appsot.com。

コマンドで！br：bor！ bashからランダムな引用を取得する
コマンドで！br：rb！ rosbestでその日の写真を撮る
コマンド上！br：BakaRobo！ 応答:)
なじみのないすべてのチームに応じて誓う。

そして、作成の過程で、私は面白いことを実現しました：大きくてクールなアプレットがウェーブロボット用に開発されました...現時点ではほとんど文書化されていません:)少なくともPython APIのリファレンスはクラスと関数の一般的なリストであり、実際には何も明確ではありません。

だから、さまざまなドックやサンプルを読むのに時間を費やして、ある種の有用なロボットを作るために必要な基本的な情報を特定したように思えます。 そして、これらの必要なすべてのことを伝えたいです。

まず、ロボットをGoogle App Engineに配置する必要があります 。 そこにアプリケーションを作成し、コードコミット用のツールをダウンロードする方法については説明しません。すべてがそこで明確に説明されています。

そのため、ツールをダウンロードし、ディスク上の特定のフォルダーに次のようなものを取得しました。

.
..
google_appengine
our_robot


our_robotは、ロボットが置かれるフォルダーです。 そして、このフォルダーでcode.google.comからこのアーカイブをダウンロードして解凍します。これは実際にはPythonアカウントです。

これで、実際の開発の準備が整いました。

念のため：アプリへのコードのコミットは次のように行われます。
python ./google_appengine/appcfg.py update ./our_robot/-その後、石鹸とパスワードについて質問し、ファイルをアップロードします。

基本ケースでは、プロジェクトに3つの主なファイルがあります。

 our_robot.py-実際には、ロボットのコード
 app.yaml-マニフェストのようなもの
 _wave / capabilities.xml-ロボットがリッスンするイベントを宣言するファイル。

Farcaller アドオン ：
Python APIは、robot.Robotの引数に基づいてxml-ku castati自体を生成しますが、javaはpensで記述する必要があります 。
したがって、明らかに、開発プロセスでの一定量の体の動きは放棄される可能性があります。

ここでイベントのリストを見ることができますが、私の意見では、ロボットにとって最も重要なものは次のとおりです。
WAVELET_SELF_ADDED-ロボットがWaveに追加されたときにトリガーされます。この時点で、使用に関する小さな情報を表示すると便利です。
BLIP_SUBMITTED -wave blipが作成/編集されたとき、書き込み時ではなく、Doneボタンが既に点滅しているときにトリガーされます。


さらに進みましょう。
app.yamlマニフェストは、code.google.comのチュートリアルで判断すると、次のようになります。

application: our_robot
version: 1
runtime: python
api_version: 1
handlers:
- url: /_wave/.*
script: our_robot.py
- url: /assets
static_dir: assets
- url: / icon.png
static_files: icon.png
upload: icon.png


ここではすべてが明らかなようです。 ロボットの名前、起動するバージョン、APIのバージョン、さまざまなURLのハンドラー。

注意する必要があるのは、ハンドラセクションの「-url：/icon.png」だけです。 これは、チュートリアルには含まれていないようです。デザインでは、ロボットアイコンの処理方法を指定できます。 pngshkaに描画し、robotフォルダーに保存し、pythonファイル内で宣言します:)

チュートリアルでも、capabilities.xmlも簡単に見えます。

<? xml version ="1.0" encoding ="utf-8" ? >
< w:robot xmlns:w ="http://wave.google.com/extensions/robots/1.0" >
< w:capabilities >
< w:capability name ="WAVELET_SELF_ADDED" content ="true" />
< w:capability name ="BLIP_SUBMITTED" content ="true" />
</ w:capabilities >
< w:version > 1 </ w:version >
</ w:robot >

* This source code was highlighted with Source Code Highlighter .

実際、このファイルで変更するものはほとんどありません。バージョン番号とリッスンするイベントのみです。

しかし、この予備的な混乱がすべて終わった後、実際には、ロボットのPythonコードを書くことに非常に楽しい騒ぎが起こりました。

まず、例とチュートリアルで示されているように、コードの一般的な構造を説明します。次に、チュートリアルにないあらゆる種類のマイナーな有用性をスローします。参考文献でその下に到達する必要があるため、例からそれらを抽出する必要がありました。

したがって、一般に、ロボットの空白のコードは次のようになります。

from waveapi import events
from waveapi import model
from waveapi import robot
def OnRobotAdded(properties, context):
pass
def OnBlipSubmitted(properties, context):
pass
if __name__ == '__main__' :
myRobot = robot.Robot( 'our_robot' ,
image_url= 'http://our_robot.appspot.com/icon.png' , #
version= '2.3' , #
profile_url= 'http://our_robot.appspot.com/' ) #
# :
myRobot.RegisterHandler(events.WAVELET_SELF_ADDED, OnRobotAdded)
myRobot.RegisterHandler(events.BLIP_SUBMITTED, OnBlipSubmitted)
#
myRobot.Run()

* This source code was highlighted with Source Code Highlighter .

そして、すべてが素晴らしく、理解できるかのように。 しかし、イベントの機能を書き始めると、たとえば、色付けや強調はもちろんのこと、テキストを別のテキストに置き換える方法が完全に不明確であることがわかります。

それほど長くはないが、かなりしつこいエッセイの結果として、私はロボットを書くのに十分な便利なメソッドのリストを掘りました。

最初に、イベント処理関数でイベントが発生したブリップを取得するために（もちろん、このイベントがブリップで発生した場合を除き）、
blip = context.GetBlipById（プロパティ['blipId']）

第二に、ブリップテキストを取得して操作するために、
doc = blip.GetDocument（）
内容= doc.GetText（）

したがって、テキストの一部を別のテキストに置き換えるには、結果のドキュメントを使用します
doc.SetTextInRange（model.document.Range（START、END）、新しいテキスト）

テキストをどこかに挿入するには：
doc.InsertText（START、TEXT）

最後にテキストを追加するには：
doc.AppendText（TEXT）

画像を挿入するには：
最後に-doc.AppendElement（model.document.Image（PICTURE ADDRESS、WIDTH、HEIGHT、ATTACHMENT_ID、ALT））
特定の場所へ-doc.InsertElement（START、model.document.Image（PICTURE ADDRESS、WIDTH、HEIGHT、ATTACHMENT_ID、ALT））

一般に、ドキュメントで何ができるかを知るには、 このリファレンスを参照すると便利です。 作成できる要素のタイプを見つけるために、waveapi.documentの参照を調べます*-Image、Link、さらにはGadgetもあります。

遠い。 ブリップのすべてのデザインおよびその他のさまざまな有用性は、いわゆる注釈に保存されます。 彼女のすべてはシンプルです。

doc.SetAnnotation（model.document.Range（START、END）、TYPE、VALUE）

さらに、TYPEは追加する注釈の種類を記述するものです。 最も重要なIMHOは「style / STYLE_PROP」です。STYLE_PROPはjs形式のcss属性レコードです。
突然、誰も知らない-これはjsスクリプトで使用される変換されたcssプロパティレコードであり、例を使用してその本質を簡単に表示できます。たとえば、色は単なる色ですが、font-sizeはfontSizeです。 つまり、cssにハイフンがある場合、このエントリにはハイフンはありませんが、最初の単語を除くすべての単語は大文字で始まります。 backgroundColor、backgroundImage、marginTopなど。

それらも簡単な方法で削除されます;例えば、フォントの色や背景色など、同じタイプのすべての注釈を、そのようなファンクで愚かに殺すことができます：

doc.DeleteAnnotationsByName（TYPE）

また、特定のタイプの注釈から特定の範囲のテキストのみを消去できます。

doc.DeleteAnnotationsInRange（model.document.Range（START、END）、TYPE）

注釈は、このメッセージに関連する情報を保存できるため、便利です。

ブリップ全体に注釈を付けるには、次を使用します。
doc.AnnotateDocument（TYPE、VALUE）

ブリップに何らかのタイプの注釈があるかどうかを調べるために、それが呼び出されます
doc.HasAnnotation（TYPE）

ここのどこかで、そのようなセットは、私にとっては、すでに何か有用なことができるロボットを作成できるように思えます。 もちろん、たとえばGAEデータベースシステムやその他の快適なものの使用はテキストの範囲外でしたが、できればテキストが完全に役に立たないことはないでしょう。

PS：ところで、最初は開発を大きく妨げていたバグに気付きました。appspot（利用可能な唯一のデバッグツール）のログタブで、デフォルトで表示されるメッセージのレベルはErrorに設定されています。 ポイントは、たとえばInfoなどのレベルの一部が最初にログレコードに表示され、その後エラーのある一部のみが表示される場合、そのようなレコードは表示されないということです。 そのため、デバッグのアラートのレベルを再配置し、発生したすべてのエラーを検討する機会に喜んでいます。

PPS：ありがとう、適切なブログに移動しました。