Clean ArchitectureとBuilding Evolutionary Architecturesを読んだ
Clean Architectureという本とBuilding Evolutionary Architecturesという本を最近読んだのでざっくりとしたメモ。（両方共2-3時間ぐらいでざっくりとしか読んでないので、解釈間違いは普通にありそうです） 両方共アーキテクチャに対するメタ的な視点な部分があるので、合わせて読むと面白いかも。 Clean Architecture(Clean Codeの人のシリーズ)という本を読んだ。 Clean Architecture: A Craftsman’s Guide to Software Structure and Design | InformIT PDFとかEpubとかMobiが買える Robert C. MartinのClean *シリーズでいわゆるクリーンアーキテクチャそのものだけを扱ったという内容ではない。 でもクリーンアーキテクチャについ
lernaでのmonorepoにおけるリリースフロー(Fixed/Independent)
一つのリポジトリで複数のパッケージを管理する際にはLernaとYarnのワークスペースを組み合わせて運用するmonorepoにすることが多いです。 lerna/lerna: A tool for managing JavaScript projects with multiple packages. LernaにはFixed(すべてのパッケージが同じバージョン)とIndependent(パッケージごとに異なるバージョン)のモードがあります。 https://github.com/lerna/lerna#how-it-works 基本的にはFixedの方が運用は簡単ですが、不自然なバージョンの上がり方を避けたい場合などはIndependentのmodeを使うことになります。 この記事では、Fixed modeとIndependent modeでのパッケージのリリースフローについて見ていきます
Jestなどを使わずにスナップショットテストを書く
次のようなテストコードを書きます。(これはMochaを使っていますが大体どんなテストフレームワークでも同じことが出来ます。) 次のスナップショットでは、transformというJSONを入力に受け取り、JSONを出力する関数をテストしています。 snapshot-test.js: const fs = require("fs"); const path = require("path"); const assert = require("assert"); const fixturesDir = path.join(__dirname, "snapshots"); // transform function const transform = require("../transform"); describe("Snapshot testing", () => { fs.readdirSy
documentationjs + add-text-to-markdownでREADME.mdのAPIリファレンスを自動更新
documentationjs + add-text-to-markdownでREADME.mdのAPIリファレンスを自動更新 documentationjsはJSDocからドキュメントを生成できるツールで、ES2015以降のコードにも対応しています。 (TypeScriptは対応してないようです) 以前はMarkdownへの出力が難しかったのですが、いつのまにかdocumentation build -f mdでMarkdownでのAPIドキュメントが生成できるようになっていました。 これを使うことで、ライブラリを書いてそのJSDocからドキュメントを生成して、READMEのUsageセキュクションを自動的に更新できるようになっています。 以前もできたのですが、かなりトリッキーなテーマを書いたりしないといけませんでした。(後stdoutへの出力がなかった気がします) –theme for
AlminでFluxアーキテクチャをやってみる
AlminでFluxアーキテクチャについてを見ていく話です。 AlminはいわゆるFluxライブラリ的なものですが、ドメイン駆動設計（DDD）を行うにあたって既存のReduxやFluxでは上手くレイヤー分けをやりにくい部分がありました。 この辺の経緯については以前スライドやドキュメントにまとめてあるので、以下を参照してください。 azu/large-scale-javascript: 複雑なJavaScriptアプリケーションを作るために考えること 複雑なJavaScriptアプリケーションを考えながら作る話 この記事では、実際のサンプルコードを見ていきながら、Flux的なデータフローについて見ていきます。 Alminでカウンターアプリを作る このサンプルではAlminを使って次のようなカウンターアプリを作っていきます。 次に英語のチュートリアルもあるので参照してください。 Counter
performance.markでパフォーマンス計測する
JavaScriptである区間にかかった時間を計測する時に、次のようなコードを書いたことがあると思います。 const start = performance.now(); // 処理 // 色々な処理がすべて終わった doSome(() => { console.log(performance.now() - start); }) Performance Timelineのperformance.markとperformance.measureなどを使うと、ある区間の処理時間をもっと簡単に取ることができます。 APIについて詳しくは以下の記事を見るといいと思います。 User Timing API: あなたの Web アプリをもっと理解するために - HTML5 Rocks Performance.mark() - Web API インターフェイス | MDN 簡単に解説すると perf
Almin + React/Vue.jsのパフォーマンスプロファイルをタイムライン表示できるように
AlminはClient-side DDD/CQRSをしやすい構造を作ることを目的にした – いわゆるステート管理ライブラリです。 Almin 0.14.0でperformance.markベースのプロファイルを取れるようになりました。 これにより、AlminのUseCaseやStoreといったそれぞれの処理にどれぐらいかかっているかを開発者ツールのタイムラインで見ることができます。 performance.markはUser Timing Level 2で標準化されている方法なので、後述するようにReactやVueなどのライブラリと組み合わせた状態も見ることができます。 performance.markについては次の記事でも書いています。 performance.markでパフォーマンス計測する | Web Scratch 使い方 Contextを作成する際にperformancePro
今年のOSS活動振り返り @ 2017
2017年のOSS活動の振り返り記事です。 今までの振り返り。 今年のOSS活動振り返り @ 2016 | Web Scratch 今年のOSS活動振り返り @ 2015 | Web Scratch 今年のOSS活動振り返り @ 2014 | Web Scratch 2017年のGitHubのContributionsは8000~10000ぐらいを推移していました。 (1/3ぐらいはJSer.info関連だと思います。) 今はGitHubに表示されないけど、Current Streakは1507日でした。(1507/365 = 4.128767123年) GitHub Full Longest Streak:azu GitHubのLongest Streakを出してくれるツール Issue/PR PR: 527 去年: 457 Issue: 485 去年: 392 大体同じ程度増えている感
ローカルのPDFを全文検索するクライアント/サーバ/Electronアプリを書いた
ローカルにあるPDFを全部検索して、その結果を一覧したいことがあります。 例えば、今、js-primerという書籍を書いていて、ある用語が他の書籍ではどんな扱い/用語になっているのかを調べたいことがよくありました。 この手のアプリとしては論文管理のPapers for Macなどがありますが、検索したいだけなのに色々な機能がついていてまた、とりあえず作ってみることにしました。 searchiveというプロジェクト名にしてPDFからテキストを取り出す所やフロントエンドのElectronアプリ、PDFからテキストを取り出すのはブラウザでやるには遅いので、そこをサーバ側でやってくれる仕組みを作りました。 大体100冊ぐらいをインデックスに入れて検索していますが、数百ms以内に検索結果が出てるので意外と動くようです。 インストール Release pageからElectronアプリをダウンロードし
AlminのサイトをOSSドキュメントツールのdocusaurusで作り直した
Alminでは元々GitBookを使ったドキュメントサイトをhttps://almin.js.org/で公開していました。 最近、OSS向けのドキュメントサイト作成ツールであるDocusaurusが公開されたのを受けて、GitBookからDocusaurusに移行しました。 Alminのサイト: Almin · Flux/CQRS patterns for JavaScript application. https://github.com/almin/almin DocusaurusはEasy to Maintain Open Source Documentation WebsitesとあるようにOSSのライブラリやプロダクト向けのドキュメントサイトを作る一種の静的サイトジェネレーターです。 Facebookから公開されていることからも分かるように、JestやPrettier(Faceb
JavaScriptのライブラリを徐々にTypeScriptに移行する
Alminというライブラリは元々JavaScript(+Babel)で書かれていましたが、今年の2月にsrc/下のソースコードはTypeScriptに移行しました。 その時のコミットログは次のPRに残っているため、コミットログを1コづつ見ていけばどのように行われていったが分かると思います。 Convert src/ to TypeScript by saneyuki · Pull Request #68 · almin/almin この時取った方法は大まかに次のような手順でした src/ の TypeScript化 Babel -> JS(js -> js)だったものをTypeScript -> Babel -> JSにビルドスクリプトを変更 TypeScriptはtargetをesnextにすることで単純に型を取り除くだけの変換にする ES2015 -> ES5を実際にやるのは既存のBa
Living Documentation by design, with Domain-Driven Designを読んだ
Living Documentation by design, with Domain-Driven Designを読んだ Living Documentation by design, with Domain-Driven Design by Cyrille Martraire [PDF/iPad/Kindle]という電子書籍を読んだ。 leanpubで$0から購入できて、任意の値段で購入できるドキュメンテーションとDDDについての書籍。 追記: 書籍版 Amazon.co.jp: Living Documentation: Continuous Knowledge Sharing by Design (English Edition) 電子書籍: Martraire, Cyrille: 洋書 ドキュメンテーションもソフトウェア開発のように設計やテストといったパターンやアプローチがありま
#teppeis_sushi でクライアントサイドDDDについて発表した
#teppeis_sushiというイベントで、Faao - ドメイン駆動設計で作るGitHub Issue Client -という話をしました。 Electronやブラウザなどで動くfaaoというGitHubクライアントを書いていてそれの技術的な話です。 クライアントサイドでDDDを取り入れた設計になっていて、その設計や規約の作り方やそれを守る方法についての話をしました。 azu/faao: Faao is a GitHub issue/pull-request client on Electron. Living Documentation by design, with Domain-Driven Design by Cyrille Martraire [PDF/iPad/Kindle]という無料から買える書籍では、ドキュメントとコードを同じ速度で成長させていくためにはドキュメントに対
Array.prototypeのImmutable版メソッドを個別のパッケージで使えるものを作った
JavaScriptの配列には破壊的なものと非破壊的なものが混在しています。 例えばArrray.prototype.pushは破壊的ですが、Array.prototype.concatは結合した新しい配列を返すので非破壊的です。 破壊的か非破壊的かは、基本的には覚えることでしか区別できません。 配列のメソッドの使い方については次の記事やjs-primerで今書いています。 JavaScriptの配列のパターン | Web Scratch 配列 · JavaScriptの入門書 #jsprimer それらの破壊的メソッドの非破壊的なバージョン - Immutableバージョンのライブラリを作成しました。 azu/immutable-array-prototype: A collection of Immutable Array prototype methods(Per method pa
Almin 0.12リリース: Read層におけるState更新のアプローチ
Almin 0.12をリリースしました。 Release Almin 0.12 · almin/almin StoreとStoreGroupが書き直されたので色々変わっていますが、マイグレーションツールでアップデートできます。 変更点 StoreGroupを書き直した Before: class AStore extends Store { getState() { return {a : "a value"}; } } class BStore extends Store { getState() { return {b : "b value"}; } } const aStore = new AStore(); const bStore = new BStore(); const storeGroup = new StoreGroup( aStore, bStore ]); conso
power-assert + babel as a development tool
3行まとめ espower-babelは役目を終えたので、Deprecated Babel + power-assertはbabel-preset-power-assertを使う コード上はrequire("power-assert")とrequire("assert") どちらでもpower-assert化できるようになった espower-babelは非推奨へ Babel + Mocha + power-assertの組み合わせを出来るだけ設定ファイルなどを作らずに使えるespower-babelというモジュールを書いていましたが、役目を終えたので非推奨(deprecated)にしました。 テストコードをES6+power-assertで書けるespower-babel 3.0.0リリース | Web Scratch 理由としては、Babel@6からは設定(ファイル)を必ず必要とするの
今年のOSS活動振り返り @ 2016
2016年のOSS活動振り返りです。 去年との比較用にGithubOriginalStreakを使って古い形でGitHubのContributionsを出してみた。 3年ぐらい毎日コミットが続いてる。けど、2016年の後半がだらけててコミット数が少なくなってる。 後、GitHub Full Longest Streakを使うと、GitHubのStreakを取ることができます。 (他のツールみたいに365日制限とかなく、GitHubにアカウントを作ってからの全データが見れます) https://azu.github.io/github-longest-streak/?user=azu 以前のまとめ 今年のOSS活動振り返り @ 2015 | Web Scratch 今年のOSS活動振り返り @ 2014 | Web Scratch Issue/PR PRs: 457 Issues: 392
東京Node学園祭2016 アウトラインメモ
東京Node学園祭2016に参加してきたのでメモ Demystifying JavaScript Engines - Alejandro Oviedo a0viedo/demystifying-js-engines: A list of resources about JavaScript engines 2006年のJavaScriptエンジン インタプリタ 遅い 最適化しても遅い Fortran、Self、Smalltalkの人がより良い方法を考えた (Source) -> Parse -> (bytecode) -> executionPhase <-> JIT Compiler 何度も実行するコードはJITコンパイラを通すようにした プロパティのアクセスの最適化、Hidden Classなど色々な最適化 Design Elements · v8/v8 Wiki evalとtry-c
pdf.jsなPDFビューアアプリをElectronで作った
タイトルどおりですが、FirefoxのPDFビューアをスタンドアローン化したようなアプリを作りました。 azu/mu-pdf-viewer: PDF viewer on electron. 特徴は次の通りです。 PDF.jsベース J, Kでスクロールなどいじっています Drag and Dropをサポートしてます Install npm でインストールするか バイナリをダウンロードして使えます(OS Xのみ) https://github.com/azu/mu-pdf-viewer/releases/latest Travis CIとかでelectronを自動ビルドするのがかなり難しくなったので、自分用にOS X版のみバイナリを作ってます。 READMEにその他の環境のバイナリの作り方を書いてあります。 Usage npmでインストールした場合はCLIから起動できます。
AWS lambdaでGitHubのアクティビティをTwitterで読む用に投稿する
タイトルどおりですが、AWS Lambdaを使って、GitHubのWatchやアクティビティをTwitterに投げるlambda functionを書きました。 azu/github-to-twitter-lambda: Lambda bot that fetch own GitHub notifications/events and post to Twitter. こんな感じでTwitterにGitHubのNotification(Watch)、アクティビティが流れます。 ⚠ 注意: メインで使ってるGitHubアカウントのPersonal Tokenを使うとそのアカウントのNotificationとタイムラインが流れるので、privateの情報とかもなげられてしまうので注意です。 追記: G2T_ENABLE_PRIVATE_REPOSITORY の設定でprivateリポジトリの情
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
