はてなブックマーク

docker container run はコンテナの「作成」と「起動」docker container run（旧: docker run）は、もっとも頻繁に紹介されているコマンドですが、内部で複数のことを行うので 一番分かりにくいコマンド かもしれません。 docker container run は次のようなことを一度に実行します。 指定したイメージがなければダウンロード (docker image pull)Docker コンテナを作成する (docker container create)Docker コンテナを起動する (docker container start)例えば、次のコマンドを実行すると、Docker イメージ (ubuntu:20.04) のダウンロード、Docker コンテナ (mycon) の作成、そのコンテナの起動までを一気に実行します。 各オプションは次の

nvm (Node Version Manager) とは？nvm というコマンドラインツールを使うと、システム内に複数バージョンの Node.js 実行環境をインストールして、切り替えて使うことができるようになります。 $ nvm use 16 # node コマンドを version 16.x.x に切り替え $ nvm use 14 # node コマンドを version 14.x.x に切り替え 新しいバージョンの Node.js を試してみたいときや、複数バージョンでテストを行いたい場合に便利です。 nvm はスタンドアローン版の Node.js とも共存できるので、安心してインストールすることができます。 nvm を使わずにインストールされた Node.js は、system という名前で参照できるようになっています。

python-dotenv モジュールの概要python-dotenv モジュールを使用すると、Python プログラム実行時に次のような .env ファイルを読み込んで、環境変数を設定することができます。 .env MYAPP_USER=maku MYAPP_PASS=makupass MYAPP_CONFIG=${HOME}/${MYAPP_USER}/config 上記の例のように、${HOME} という形で環境変数の値を展開することもできます。 特定のプログラムを実行するために、いちいち OS の環境変数を設定するのを嫌がるユーザーはたくさんいます。 あなたのプログラムが何らかの環境変数を必要としているのであれば、.env ファイルによる設定手段も提供しておくと親切です。 .env の仕組みは Python に限ったものではなく、いろいろな言語で採用されています。 参考: Node

JavaScript で IE かどうかを判別する IE 判別関数 (isIe) navigator.userAgent プロパティを参照して、ブラウザのユーザーエージェントを調べることで、使用しているブラウザが IE (Internet Explorer) であるかを判別することができます。 IE の場合、ユーザーエージェント名は MSIE あるいは Trident/ で始まります。 // 使用中のブラウザが IE であるかどうかを判別します。 function isIe() { var ua = navigator.userAgent; return ua.indexOf('MSIE ') > -1 || ua.indexOf('Trident/') > -1; } ただし、navigator.userAgent プロパティの値はブラウザの設定により書き換えられる可能性があることに注意

なぜ rimraf が必要か？ TypeScript などのトランスパイラを使って Node.js アプリを開発していると、ビルド結果を格納するディレクトリを削除する clean コマンド（NPM スクリプト）を定義したくなります。 package.json これはこれで間違いではないのですが、Linux の rm コマンドを使用しているので、OS 依存の package.json になってしまいます。 そこで、OS に依存しない rm -rf コマンドを実現するのが rimraf という NPM パッケージです。 rimraf は NPM の作者である Isaac 氏が作成しており、安心して使用できます。 rimraf という名前は Linux コマンドの rm -rf の発音が由来だと言われています。 rimraf の使い方 rimraf のインストール rimraf コマンドは NP

あるリポジトリの Issues の一覧を取得するGitHub の /repos/<ユーザー名>/<リポジトリ名>/issues という REST API エンドポイントにアクセスすると、指定したリポジトリ内の Issue の一覧を取得することができます。 特定の Organization が提供しているリポジトリを指定するときは、ユーザー名 の部分を Organization名 に置き換えてください。 Public リポジトリの場合Public リポジトリの情報は、誰でも簡単に取得することができます。 下記は、curl コマンドを使って REST API を呼び出すサンプルです。 ユーザー名とリポジトリ名の部分は適切な値に変更してください。 Public なリポジトリの場合 $ USER_NAME=myname $ REPO_NAME=myrepo $ curl https://api.g

コマンドライン引数の基本 ($1 ~ $9)bash シェルスクリプト実行時にコマンドラインで渡した引数を参照するには、次のようなパラメーター参照用の特殊変数を使用します。 $1 … 第 1 パラメーター$2 … 第 2 パラメーター$3 … 第 3 パラメーターパラメーターの参照には、$1 〜 $9 が使用できます。 使用することは余りないと思いますが、10 番目以降のパラメータを参照したいときは、${10} のように数値を {} で囲めば参照できます。 sample.sh #!/bin/bash echo '1 番目: ' "$1" echo '2 番目: ' "$2" echo '3 番目: ' "$3"

var arr = ['AAA', 'BBB', 'CCC']; for (const elem of arr) { console.log(elem); } ECMAScript 2015 以降は、配列をループ処理したいときは for-of の構文を使うのがシンプルです。 参考: for…of - JavaScript｜MDN forEach を使う方法 (ECMAScript 2015) Array.forEach() を使用すると、指定したコールバック関数が要素ごとに呼び出されます。 const arr = ['AAA', 'BBB', 'CCC']; arr.forEach(function(elem, index) { console.log(index + ': ' + elem); });

なぜ npm-run-all が必要か？ package.json の scripts プロパティでスクリプトを定義しておくと、任意のコマンドを npm run コマンド経由で実行できるようになります（以降 NPM スクリプトと呼びます）。 しかし、デフォルトでは、複数の NPM スクリプトを連続して実行する方法（Linux の cmd1 && cmd1）や、並列に実行する方法（Linux の cmd1 & cmd2）は提供されていません。 強引に各 OS のシェルの && や & を組み合わせることでできないことはありませんが、Windows と Linux で記述方法が異なるので、OS に依存した package.json になってしまいます。 このような場合に、npm-run-all という NPM パッケージを使用すると、複数の NPM スクリプトを逐次／並列実行するスクリプトを、

process.argv によるコマンドライン引数の取得 Node.js プログラムから、コマンドライン引数を取得するには、process.argv プロパティを参照します。 process モジュールはデフォルトで使用できるようになっているので、require によるモジュールの読み込みは必要ありません。 process.argv は配列になっており、argv[2] 以降にコマンドライン引数が格納されています。 下記のサンプルコードは、process.argv 配列の内容を列挙します。 args.js for (let i = 0; i < process.argv.length; ++i) { console.log(i + ': ' + process.argv[i]); }

NPM のパッケージとして公開されている js-yaml を使用すると、Node.js のプログラムから簡単に Yaml ファイルを扱うことができるようになります。

ページバンドルとは初期の頃の Hugo では、画像ファイルは static ディレクトリに置いて、記事ファイル (Markdown) と別々のディレクトリで管理するという方法がとられていました。 content/_index.mdpage1.mdpage2.mdpage3.mdstatic/image1.pngimage2.pngimage3.pngしかし、これでは Markdown ファイルと画像ファイルをバラバラに管理しないといけないというユーザーの不満が出て、現状は content ディレクトリ以下に一緒に配置できるようになっています。 この仕組みを ページバンドル (Page Bundle) と言います。 参考: Page Bundles - Hugoページバンドルは、その名のとおり、各ページにバンドルする形で画像ファイル（リソース）を保持するという考え方です。 ページバンドルを作

GitHub の REST API でできることGitHub は Web API (REST API) を提供しており、コマンドラインや任意のアプリケーションから利用することで、GitHub の操作を自動化することができます。 Linux の curl コマンドや、スクリプト（Python や Ruby など）から簡単に利用できるので、Organization やリポジトリを管理する立場にある人はぜひ使ってみてください。 GitHub - REST API v3GitHub の REST API を使うと、例えば、下記のような処理を自動化できます。 Users指定したユーザの詳細情報を取得する二要素認証が設定できていないユーザのリストを取得するRepositories指定したオーナー（ユーザー or 組織）のリポジトリのリストを取得するOrganizations/Members指定した組織

dotenv モジュールとは Node.js のプログラムから環境変数を参照するには process.env を参照します。 参考: Node.js で環境変数を参照する (process.env) ユーザー設定を環境変数で行うようにしているアプリはよくあるのですが、たかが 1 つのアプリのために環境変数を設定するのは嫌だというユーザーは少なからずいます（設定がどこで行われているのかわかりにくいという理由もあります）。 dotenv モジュールを使用すると、カレントディレクトリに置かれた .env ファイルを読み込み、そこに記述されたキー＆バリューのペアを process.env 経由で参照できるようになります。 dotenv - npm つまり、ユーザはアプリの設定を、従来通り環境変数で行うこともできるし、.env ファイルでも行うことができるようになります。 環境変数を使ってアプリの挙

ここでは、Hugo サイトに全文検索の機能を付ける方法を説明します。 全文検索を実現する方法としては、Google カスタム検索を導入する方法もありますが、Google カスタム検索は、インターネット上に公開する Web サイトにしか適用できません。 ここで紹介する JavaScript を利用した全文検索は、ローカルで運用する Web サイトでも利用できますし、インクリメンタルサーチも実現することができます（実際のサイトの例）。 図: 全文検索＋インクリメンタルサーチの完成イメージ大まかに、下記のようなコードを含む HTML ファイルを出力できれば、サイト内の全文検索を実現することができます。 検索用 JavaScript データ (const data = [...])検索用 HTML フォーム (<input>)検索用 JavaScript 関数 (function search()

Windows の schtasks コマンドを使用すると、任意のコマンドやバッチファイルなどを指定したスケジュールで自動実行することができます（Linux の cron のようなものです）。日々のバックアップ作業、ログの取得などを自動で行うことができます。 タスクスケジューラと schtasks コマンド Windows にはタスクスケジューラ (task scheduler) サービスが標準搭載されており、ここに schtasks コマンドでタスクを登録することで、指定された時間や頻度で、任意のコマンドを自動実行してくれます（以降、タスクスケジューラに登録するタスクのことを、「スケジュールタスク」あるいは単に「タスク」と呼びます。 schtasks コマンドでは、主に下記の 6 種類のオプションを利用してスケジュールタスクの管理を行います。 これらのコマンド一覧は schtasks /

あるバージョン間の変更行数（追加＆削除）を集計する (git diff --stat, git log --numstat) 下記の説明では、バージョン 1、バージョン 2 のリリースコミットとして、タグ v1、v2 が設定されているとします。 バージョン間の変更行数を調べるには、主に git diff --stat を使った方法と、git log --numstat を使った方法があります。 git diff --stat v1 v2 v1 と v2 のスナップショット間で差分を取って変更行数を集計したいとき git log --numstat v1..v2 v1 から v2 までの各コミットの修正行数を集計したいとき バージョン間の変更行数を調べる (1) git diff を使う方法 リビジョン間（v1 と v2）の変更行数を調べるには、下記のように git diff に --sta

make の種類あれこれ 一番よく使用されているのは GNU make ですが、いろいろな亜種があります。 System V make Stuart I. Feldman によって作成されたオリジナルの make です GNU make Linux の世界で一般的に使用されている make です Implemented by Richard Stallman and Roland McGrath. Development since Version 3.76 has been handled by Paul D. Smith. Microsoft 版 nmake Microsoft C コンパイラ ver. 6.0A に付属 Borland 版 make Borland Turbo C++ コンパイラ ver.2 に付属 参考: MAKE の達人 (1992) Makefile に記述する

Hugo で独自のショートコードを作成すると、定型の HTML コードを記事内に簡単に埋め込めるようになります。 ショートコード作成の基本ショートコードは、layouts/shortcodes ディレクトリ内に .html 拡張子のファイルとして作成します。 layouts/shortcodes/my-shortcode.html ファイル名から拡張子を除いたものが、ショートコード名となります。 上記の例の場合、my-shortcode というショートコードを作成したことになります。 記事（Markdown ファイル）の中から、下記のように呼び出すと、上記の内容がそこに展開されます。 content/page1.md ショートコードにパラメータを渡す (.Get)単純なパラメータショートコード呼び出し時に、パラメータを渡すことができます。 下記の例では、２つのパラメータ red、32px

はじめに／基本コーディングスタイル／ドキュメンテーションコーディングスタイルPython のコーディングスタイルVisual Studio Code で Python 用のフォーマッター (Black) を使うドキュメンテーションドキュメンテーションコメント (docstring) を記述するWindows で pydoc コマンドを使用できるようにする関数やクラスのソースコードを確認する (insepct)開発ツール／デバッグ／ユニットテストPython プロジェクト用の爆速パッケージマネージャ uv を導入する実行環境／仮想環境python コマンドのバージョンを切り替える (pyenv, py)Python の実行環境を venv で切り替える（仮想環境）Python の実行環境を virtualenv で切り替える（仮想環境）（Python 3.2 以前）パッケージPython の