Twitter以上ブログ以下

ただの読み物

PyQを嫁にやらせてみている感想

先にまとめ

まだ一章? だけど、 PyQくらいStep by Stepでも、隣に少しは分かる人が居ないと本当の初心者には難しいのかも? と思った。 ただ、隣に少しでも分かる人がいると内容もわかりやすいし、結構小さい粒度で成功体験を得られるので良いサービスな気がする。

なぜやっているのか

PyQ というサービスが有る。プログラミング初心者はPython初学者に向けたサービス。 pyq.jp

嫁が「プログラミング勉強して、エンジニアとしてお賃金を稼ぎたい」と言い始めたので、話題になっていたPyQに登録してやってみている。

嫁のステータスとしては

  1. PCは触っているが、Huluでドラマを見たり、とある会社に所属してデータ入力をしているくらい
  2. 大学でWordやExcelは触っていたが、あんまりちゃんと使っていたわけではない感じ
  3. プログラミングは変数も知らない感じ。

とまぁ、「プログラミングに関しては本当にド素人で、キーボードをタイプすることには抵抗がない」くらいのステータス。

やっているのを横で見ていての感想

まずどんなサービスなのか

実際の画面をキャプチャしてよいのかわからないので、以下の公式サイトに有る画像を見てほしい

https://pyq.jp/static/img/landing_ss.289c5bc8d34b.png

https://pyq.jp/

こういう感じで、Side by Side に「問題文や解説文」が左側、右側にエディターがあって、右上の「実行」を押すと右下にTerminalで出力結果が出たりする感じだ。 問題によっては「判定」ボタンがあって、テストが通ってOK,NGが出る感じ。

内容も

f:id:holloword:20170809122048p:plain

ref: https://pyq.jp/quests/

こういう感じで、本当に初歩の初歩から初めていく。

個人的には本当に初歩の初歩からなのでわかりやすいとは感じたが……

言葉選びが突拍子がない

割りと初っ端から「写経」という言葉が出てくる。 写経という言葉を見て嫁は笑っていたが、これをうまく表現する言葉がないなぁと感じた。 コピペではなくて、見ながらタイプすることを、写経と表現されても、真の初学者にはわからない気がした。 実際には、「書き写しましょう」 みたいな言葉が出ていて、あぁ同じものをタイプすればいいんだな、と気がつくが、 「写経」という言葉の仰々しさに「うっ」っとくる。

エラーの説明がちょっとわかりずらい

SyntaxErrorとかを説明するフェーズがあったり、「SyntaxErrorの詳細はこちら」みたいなLinkを飛んで見たりできるが、その文章が初学者にはちょっとわかりづらい。 まぁこればっかりはしょうがない気もするが、エラーをいい感じに表現するのは難しい…… そしてこれを僕が改めて説明するのもまた、難しい……

コメントの必要性があんまりわからない

「コメント」ができるよ、みたいな課題があって、そう言われても、ぶっちゃけ初学者には「これができてなんなん?」みたいな感じになる。 実際そういうニュアンスで聞かれた。「まー、プログラムの説明を書くためのもんだよ」と説明しても、「ふ〜ん」みたいな感じ。 とはいえ、こればっかりはまじで書いてみないとわからない気もしているので限界な気もする。

変数がなんで嬉しいのかが遠い

a = 'ほげ'
print(a)

みたいなコードがあって、でもこれがなんで嬉しいのかが「こうやってできる」と「これはこう嬉しい」が遠いから、ちょっとわかりずらい。 「例えば a が【寿限無寿限無五劫の擦り切れ海砂利水魚の……】だったら、何度も打つの大変だけど、 a って入れるだけでそれが出てきたら楽だし?」みたいな説明をして「確かにそれは嬉しいね」となったけど、実際には関数の返り値を使いまわすとか、そういう使い方のほうが嬉しかったりして、ちょっと違うなーって思いながら説明する。

ココらへんで思ったこと

頻繁に「これがなんで嬉しいの?」と聞いてくる嫁氏は、割りと筋が良い気がするなぁと思ったりした。 「なんでこうなってるの?」と聞くこと、考えることはプログラミングをしていく上で必須スキルだけど、前段の自発的に聞くことすら出来ない人がたまにいる。(自分のことですごめんなさい……) ただ、「なんでこうなってるの?」と聞いたときにPyQ上だけだとどうしても書いてあることで理解できないとそこに対してあんまり納得がないまま進むことになってしまう。

あとで「ああこれってこういうときに嬉しいのね」ということが分かっても、そこまでで離脱する可能性もあってちょっと難しいなぁという感じ。

とはいえ

まだ初めて二時間くらいなので、とりあえず一ヶ月分はやりきってほしいので横でアドバイスしながら、「とりあえず実行してみ?」みたいなスタンスで見守っていく。

気持ちが高まったら続編も書く。

faraday-middleware と Oj の組み合わせで動かなくなる話

背景

faraday-middleware が突如として ArgumentError: options must be a hash. というエラーを吐いて落ちた この原因を探ってしまったので(本当は issue にあった)、記録として残しておく。現状この問題は解決済み

結論

Oj で mimic mode を使っていると、 faraday-middleware の v0.12.0 で入った改修により、落ちる。

github.com

回避方法としては Oj のアップデートを行うか、 mimic mode を利用しない。

faraday middleware 側の改修も Master には取り込まれているが、 2017-08-03時点ではReleaseされていない。

概要

Oj という Gem は、Rubyの早いJsonParseであり、大部分がCで実装されている。 また、Oj は mimic というモードを備えており、これを利用すると、既存の JSON.parse などのコードをOjのコードに差し替える。

Faraday Middleware の https://github.com/lostisland/faraday_middleware/pull/156/files#diff-5af7802308edb2ce67e963810b810354R11 この改修により、 parse_option を特に指定しない場合において JSON.parse(body, nil) が実行されるようになった。

しかし、 Oj の mimic mode によって上書きされた JSON.parse は、第二引数が Hash かどうかだけをチェックしており、ここで落ちる https://github.com/ohler55/oj/blob/b1504563d8eaadad549aa56b1eaac1845bb63a3d/ext/oj/mimic_json.c#L513

元の JSON.parse では、 オプションが nil の場合はOptionのパースは実行されないので、落ちない https://github.com/flori/json/blob/master/ext/json/ext/parser/parser.c#L1734-L1739

よって、今回の問題は Oj を利用しており、 Oj の mimic mode を利用している場合のみ発生していた。

というのが ↑ の issue にまとまってるので読むと良い。

技術的負債ナイトに参加してきたので簡単にまとめる

なにぞ?

↓ のSpeeeさんで行われた技術的負債ナイトに参加してきた。 その軽いまとめ。 speee.connpass.com

まとめしか書かない。内容はそのうち資料が揚がる……きっと……

sinsoku_listy

  1. 低品質なコードが悪いのではなく、低品質なコードを混入させないのが大切
  2. 普段から定期的にリファクタリングする
  3. レビューしたら自分がメンテできないコードは Approve しない。 Approve したコードは自分でもメンテするつもりでいるべき。

takanamito

  1. すべてを返済しようとしない
  2. 返済した結果、どうなるのかについては事業責任者を交えてしっかりビジョンを持つ
  3. 運用系タスクをやることで仕様が透けて見える
  4. 仕様ではなく運用をドキュメントにしてもらう

ayasuda

  1. 調査記録はQiitaとかEsaに書いても読まれないし、「そもそもここに調査記録があるとは思っていなかった」として調べない。なのでコメントを書く
  2. yardoc 良いぞ

joker1007

  1. 意識を強く持たないと人は容易にまれ窓に割れ窓を重ねる
  2. 自分のストレスや怒りを見逃すな
  3. DBの設計に関しては最新の注意を払って頑張る

最後に

最初二つ目くらいまではBearにまとめて書いてたけど途中から諦めてSlackに書き出したので雑になった。

ruby の Struct でキーワード引数を使って初期化する

背景

class Point < Struct.new(:x, :y); end

Point.new(x: 1, y: 2)

みたいなことをしたかった。

結論

class Point < Struct.new(:x, :y)
  def initialize(x:, y:)
    super(x, y)
  end
end

なぜ?

似たような class OpenStruct (Ruby 2.4.0) ならばできるが、OpenStructは #freeze をしないとAttributesが動的に増やせてコワイ。Hashと何が違うねん、みたいな気持ちになる

実際には異なるけどそれはそれ

でもOpenStructは便利で、 OpenStruct.new(x: 1, y: 2) ってできる。引数の順番を約束しなくてもよいので便利。 Structでもそうしたい。HashのKey:valueは取り出したときの順序を保証してないので、適当にぶち込むと謎のエラーになったりする可能性がある。

これをどうにか、静的な構造体として定義しつつ、引数の順序は問わずにいい感じにぶちこみたかった。

というわけで完成したのが結論のコード

ActiveRecordのクエリの結果をHashで取得するメソッド生やすGemを作った

背景

↓ をGemにしただけ。 haito.hatenablog.com

Gem 本体は ↓

github.com

rubygems.org は↓

https://rubygems.org/gems/activerecord-relation-exec2hash

なんでGemにしたか

  1. 勢い
  2. 実際にコードに AwesomeModel.exec_query とか出てくるとウッとなるから隠したかっただけ

感想

  1. minitest 実はRailsTutorial5.xVer以来初めてかいた
  2. ただのRubyのコードに見えるので良さげ

欲望

  • 同僚のとあるRubyコミッター氏にアドバイスをもらったので、 ActiveRecord::RelationActiveRecord::Result にして返すメソッドを生やしてPRを投げつけるところまで
  • 投げつけつつGemをそれはそれで作る

ActiveRecordでレコードをARインスタンス化しないでハッシュで取り扱う

背景

ams = AwesomeModel.where(id: [1,2,3])
#=> <ActiveRecord::Relations ... >

で、ams は AwesomeModel のインスタンスであるが、インスタンス化したくないときがある。

どうするか

AwesomeModel.connection.exec_query(AwesomeModel.where(id: [1,2,3]).to_sql).to_hash
#=> [{id: 1, attribute: 'hoge'}, {id: 2, attribute: 'huga'}]

頑張ろう。

Rspec,RailsのRequestSpecにおいて、post時にrefererをセットするには _path じゃなくて _url を使う

背景

Rspec で、ある条件のリクエストをすると、refererがあった場合にはreferer、そうでない場合は default みたいな感じの飛ばし方をしようとしているところがあって、これのSpecを書こうとしていた。

結論

request.referer で参照させるには、 /awsome だけではだめで、 http://localhost/awesome とフルパスが必要。

概要

# in application_controller.rb
def back_or_home_path
  request.referrer || home_path
end

# in awesome_controller.rb
def create
  if params[:hoge].blank?
    redirect_to back_or_home_path
  end
# ...
end

こんな感じ。本当はもちっと複雑。これをテストするのに

post awsome_path, params, {'HTTP_REFERER' => super_awsome_path}

expect(response).to redirect_to(super_awsome_path)

と書いていた。

これでは request.referrernil になってしまっていた。ただ、 HTTP_REFERER はセットされていて、この値が nil 。 実体としても多分だめで、実装としても多分ダメで、

- post awsome_path, params, {'HTTP_REFERER' => super_awsome_path}
+ post awsome_path, params, {'HTTP_REFERER' => super_awsome_url}

これで、 request.referrer が文字列で ‘http://local….’ になって、一件落着。

ActionPack、Rackとかにも潜ったけど、なんでこれで通るのか、すぐにはわからなかった。 本格的に潜るのも時間もったいないので、そういうもんなのかーみたいな気持ちでDump。