[変更ログ]をクリック— [ドキュメント]をクリックします

[変更ログ]をクリックします

これには、クリックリリース間のすべてのメジャーバージョンの変更が含まれます。

バージョン6.8

（バグ修正リリース;まだリリースされていません）

• サポートされていないPythonインタープリターでsys._getframes（）を無効にしました。 ＃728を参照してください。
• Noneでsys.exitを呼び出すときのテストランナーのバグを修正しました。 ＃739を参照してください。
• Windowsコンソールでのクラッシュを修正しました。＃744を参照してください。
• 連鎖コマンドのbashcompletionを修正しました。 ＃754を参照してください。
• ドキュメントに一致するようにオプションの命名ルーチンを修正しました。 ＃793を参照
• それぞれ2.xと3.xのUnicodeに関するクリックエラーメッセージの動作を修正しました。 メッセージは常にユニコードになり、strおよびunicodeの特殊メソッドはそのプラットフォームで期待どおりに機能します。

バージョン6.7

（バグ修正リリース; 2017年1月6日にリリース）

• click.progressbar が codecs.open ファイルで機能するようにします。 ＃637を参照してください。
• ネストされたサブコマンドを使用したbash補完のバグを修正しました。 ＃639を参照してください。
• テストランナーが呼び出し元の環境を正しく保存しない問題を修正しました。 ＃644を参照してください。
• SIGPIPEの処理を修正しました。 ＃626を参照
• Google AppEngineなどの壊れたWindows環境に対処します。 ＃711を参照してください。

バージョン6.6

（バグ修正リリース; 2016年4月4日にリリース）

• click.Path のバグを修正しました。-を渡すとクラッシュしていました。 ＃551を参照してください。

バージョン6.4

（バグ修正リリース; 2016年3月24日にリリース）

• クリックすると1つ以上の末尾の引数が破棄されるbash補完のバグを修正しました。 ＃471を参照してください。

バージョン6.3

（バグ修正リリース; 2016年2月22日にリリース）

• Windowsで -m および -c を使用してインタプリタを呼び出すための引数チェックを修正しました。
• Python3でロケール検出がエラーになるバグを修正しました。

バージョン6.2

（バグ修正リリース、2015年11月27日にリリース）

• 非表示のプログレスバーの修正を修正しました。

バージョン6.1

（バグ修正リリース、2015年11月27日にリリース）

• 非表示のプログレスバーがレンダリングされなくなる問題を解決しました。
• サブコマンドは本質的に壊れているため、サブコマンドを使用してチェーンコマンドを無効にします。
• MissingParameter がパラメーターを渡さないと機能しない問題を修正しました。

バージョン6.0

（コードネーム「pow pow」、2015年11月24日リリース）

• プログレスバーのレンダリングを最適化して、実際に変更されていないときにレンダリングしないようにしました。
• デフォルトに設定されたnargs = -1を明示的に禁止します。
• コンテキストは、スタックからポップされる前に閉じられるようになりました。
• トグルの偽旗作戦の短いエイリアスのサポートが追加されました。
• Clickは、OSを使用して使用可能なロケールを一覧表示することにより、ロケールエラーのデバッグをより適切に支援しようとします。
• 一部の単体テストの状況で、Python2でバイト文字列を返すために使用されるクリック。 これは、Unicode文字列を正しく返すように修正されました。
• Python 2を使用しているWindowsユーザーの場合、ClickはUnicodeをより正確に処理するようになり、システムからのUnicodeをより正確に処理できるようになりました。 これには、ファイル名が Path タイプでデフォルトで常にユニコードになるという残念な副作用もあります。これは、これを認識しないコードに小さなバグが発生する可能性があることを意味します。
• type パラメーターを Path に追加して、値に特定の文字列タイプを強制します。
• WindowsでPythonを実行しているユーザーの場合、 echo ）および prompt 関数は、出力ストリームをエミュレートすることにより、PythonWindowsコンソールの完全なUnicode機能で動作するようになりました。 これは、 click.get_text_stream（…）を介して仮想出力および入力ストリームを取得する場合にも当てはまります。
• ユニットテストでは、常に特定の仮想端末幅が強制されるようになりました。
• Path タイプへの標準ストリームをダッシュで示すことができるようにするためのサポートが追加されました。
• チェーンモードのマルチコマンドは、解析から残った引数をコールバックに伝播しなくなりました。 また、チェーンモードが有効になっている場合に、オプションの引数がマルチコマンドに付加されている場合、例外によって許可されなくなりました。
• 連鎖コマンドが他の連鎖コマンドを子コマンドとして持つことを禁止する制限が緩和されました。
• 正のnargsを持つ引数に、デフォルトを実装できるようになりました。 以前は、この構成では、わずかに予期しない値が返されることがよくありました。

バージョン5.1

（バグ修正リリース、2015年8月17日にリリース）

• 誤ってコンテキストも渡す pass_obj のバグを修正します。

バージョン5.0

（コードネーム「tok tok」、2015年8月16日にリリース）

• さまざまな非推奨の機能を削除しました。
• アトミックファイルは w モードのみを受け入れるようになりました。
• 非常に長いコマンドのヘルプ出力の使用部分を変更して、4つのスペースでインデントされた次の行に引数をラップします。
• CliRunnerの使用時にリターンコードとエラーメッセージが正しくないバグを修正しました。
• get_current_context を追加しました。
• リンクされたコンテキストのリスト全体で共有されるコンテキストに meta 辞書を追加して、クリックユーティリティが状態をそこに配置できるようにしました。
• Context.scope が導入されました。
• echo 関数はスレッドセーフになりました。基になるオブジェクトの write メソッドを1回だけ呼び出します。
• prompt（hide_input = True）は、 ^ C に改行を出力するようになりました。
• ユーザーがunicode_literalsを使用している場合、クリックで警告が表示されるようになりました。
• Clickは、PAGER環境変数が空であるか、空白のみが含まれている場合、それを無視するようになりました。
• click-contrib GitHub組織が作成されました。

バージョン4.1

（バグ修正リリース、2015年7月14日にリリース）

• エラーメッセージに末尾の None 文字列が含まれるバグを修正します。
• 末尾に改行があるdocstringでClickがクラッシュするバグを修正します。
• より良いエラーでバーフィングすることにより、Python3でエンコーディングが None に設定されたストリームをサポートします。
• less-pagerで^ Cを適切に処理します。
• sys.getfilesystemencoding からの None の戻り値を処理します
• click.echo でUnicodeファイルに書き込むときのクラッシュを修正しました。
• 複数のオプションで型推論を修正しました。

バージョン4.0

（コードネーム「ズームズーム」、2015年3月31日リリース）

• 直接または間接的にエコーを呼び出す多くのインターフェイスに color パラメーターを追加しました。 これは以前は常に自動検出でした（ echo_via_pager 関数を除く）。 クリックの自動検出を無効にして、強制的に有効または無効にできるようになりました。
• UNPROCESSED タイプを追加しました。これは、タイプの変更を実行せず、一部の特別な高度なユースケースで2.x /3.xでのテキスト処理を簡素化します。
• エラーのより一般的な処理のために、 NoSuchOption および BadOptionUsage 例外を追加しました。
• 引数が基になるツールに転送される状況で役立つ可能性がある未処理のオプションの処理のサポートが追加されました。
• ヘルプ出力の最大幅を変更するために使用できるコンテキストに max_content_width パラメーターを追加しました。 デフォルトでは、Clickは80文字を超える幅のコンテンツをフォーマットしません。
• stderrにプロンプトを書き込むためのサポートが追加されました。
• 複数の引数のデフォルトを表示するときのバグを修正します。
• オプションおよび引数にカスタムサブクラスのサポートが追加されました。
• coloramaがインストールされている場合のWindowsのclear()のバグを修正しました。
• オプションのnargs=-1を適切に拒否します。 オプションを可変個引数にすることはできません。
• ASCII以外の文字またはダッシュを含むコマンドでbashの完了が正しく機能しない問題を修正しました。
• プログレスバーを手動で更新する方法を追加しました。
• 欠落している引数のフォーマットを変更しました。 以前は内部引数名がエラーメッセージに表示されていましたが、渡された場合はメタ変数が表示されるようになりました。 自動化されたメタバーが選択されている場合、最初に余分なフォーマットが削除されます。

バージョン3.3

（バグ修正リリース、2014年9月8日にリリース）

• コマンドの無効な転送に関するPython3のエラーレポートの問題を修正しました。

バージョン3.2

（バグ修正リリース、2014年8月22日にリリース）

• secho 関数に欠落している err パラメーター転送を追加しました。
• コンテキストinvokeメソッドによってデフォルトパラメータが適切に処理されない問題を修正しました。 関数が不適切に使用された場合、これは後方互換性のない変更です。 詳細については、 3.2 へのアップグレードを参照してください。
• invoke_subcommands 属性を大幅に削除しました。 解析がどのように機能するかにより、エラーなしで機能するように提供することはできません。そのため、このAPIは非推奨になりました。 詳細については、 3.2 へのアップグレードを参照してください。
• 3.1でリグレッションとして壊れていた invoked_subcommand の機能を復元しました。

バージョン3.1

（バグ修正リリース、2014年8月13日にリリース）

• 親コマンドが呼び出される前にサブコマンドのコンテキストが作成される原因となっていたリグレッションを修正しました。これは、以前のClickバージョンからのリグレッションでした。

バージョン3.0

（コードネーム「clonkclonk」、2014年8月12日リリース）

• フォーマッタは、50文字未満の端末に対応しようとしなくなりました。 それが起こった場合、それは最小の幅を想定しています。
• テストシステムで例外を飲み込まない方法を追加しました。
• ポケットベルを使用した色のサポートと、自動検出をオーバーライドする方法が追加されました。
• CLIランナーの結果オブジェクトにトレースバックがアタッチされました。
• 自動ショートヘルプ検出が改善され、文を終了しないドットでより適切に機能するようになりました。
• 現在、実際の有効なオプション文字列なしでオプションを定義すると、Clickはサイレントに渡すのではなく、エラーメッセージを表示します。 これは、ユーザーがオプションではなく引数を作成したい状況をキャッチする必要があります。
• 再構築ベンダーをサポートするために内部的にクリックします。
• マルチコマンドチェーンのサポートが追加されました。
• 複数のオプションと nargs！= 1 のオプションと引数のデフォルトのサポートが追加されました。
• progressbar に渡されたラベルは、空白が削除されてレンダリングされなくなりました。
• Clickコマンドで main メソッドのスタンドアロンモードを無効にして、エラーをより適切に処理できるようにする方法を追加しました。
• コマンドコールバックから値を返すためのサポートが追加されました。
• echo からstderrに印刷するための簡略化を追加しました。
• グループの結果コールバックを追加しました。
• コンテキストを複数回入力すると、最後の終了が発生するまでクリーンアップが延期されます。
• open_file を追加しました。

バージョン2.6

（バグ修正リリース、2014年8月11日にリリース）

• Python3でラップされたストリームがseekableの誤った値を報告する問題を修正しました。

バージョン2.5

（バグ修正リリース、2014年7月28日にリリース）

• Python3でのテキストの折り返しに関するバグを修正しました。

バージョン2.4

（バグ修正リリース、2014年7月4日にリリース）

• 2.3のヘルプオプションの変更のバグを修正しました。

バージョン2.3

（バグ修正リリース、2014年7月3日にリリース）

• カウントオプションの誤った形式のヘルプレコードを修正しました。
• coloramaが利用できない場合は、WindowsでのANSIコードストリッピングのサポートを追加します。
• 特定のエッジケースのヘルプパラメータのClick1.0処理を復元しました。

バージョン2.2

（バグ修正リリース、2014年6月26日にリリース）

• PyPyでのtty検出を修正しました。
• コンテキストマネージャーを入力したときにプログレスバーが表示されない問題を修正しました。

バージョン2.1

（バグ修正リリース、2014年6月14日にリリース）

• Windowsの launch（）関数を修正しました。
• アプリケーションが中断された場合にコンソールを台無しにしないように努力するために、Windowsでのcoloramaサポートを改善しました。
• 修正されたWindowsターミナルは、79文字ではなく80文字の幅であると誤って報告されていました
• 可能な場合はcoloramawin32バインディングを使用して、Windowsターミナルの正しいサイズを取得します。
• Python3のカスタム関数タイプの問題を修正しました。
• 不明なオプションがエラーメッセージで誤って報告される問題を修正しました。

バージョン2.0

（コードネーム「タップタップタップ」、2014年6月6日リリース）

• Windowsでバイナリモードでstdin / stdoutを正しく開くためのサポートが追加されました。
• 一時ファイルを経由することによるファイルへのアトミック書き込みのサポートが追加されました。
• 型システムと同じエラーメッセージでカスタム検証を簡単に実行するために使用できる BadParameter が導入されました。
• progressbar（）を追加しました。 プログレスバーを表示する機能。
• get_app_dir（）を追加しました。 構成のホームフォルダを計算する関数。
• colorama を介して echo（）関数にANSIコードの透過的な処理を追加しました。
• clear（）関数を追加しました。
• 重大な変更：パラメーターコールバックは、2番目の引数として渡されるパラメーターオブジェクトを取得するようになりました。 警告するがスクリプトを実行する古いコールバックのレガシーサポートがあります。
• ANSIスタイルに style（）、 unstyle（）、 secho（）を追加しました。
• デフォルトのエディターを呼び出す edit（）関数を追加しました。
• ブラウザとアプリケーションを起動する launch（）関数を追加しました。
• 引数に-1のnargsを指定すると、requiredフラグを使用して強制的に単一のアイテムにすることができるようになりました。 デフォルトでは必須ではありません。
• 引数のデフォルトを設定すると、暗黙的に不要になります。
• 確認プロンプトで「yN」/「Yn」を「y / N」および「Y / n」に変更しました。
• bash補完の基本的なサポートが追加されました。
• getchar（）を追加して、端末から1文字をフェッチします。
• エラーは意図したとおりにstderrに送られるようになりました。
• DOS / Windowsスタイルの引数などのよりエキゾチックなパラメータ形式に関するさまざまな問題を修正しました。
• 追加された pause（）は、Windows pause cmd組み込みと同様に機能しますが、アプリケーションが端末を介して実行されない場合は自動noopになります。
• 欠落している選択パラメーターに関する追加情報を少し追加しました。
• ヘルプオプションのグローバルオーバーライドを可能にするために、ヘルプ機能の実装方法を変更しました。
• 大文字と小文字を区別しない処理を実装するためのトークン正規化のサポートが追加されました。
• コンテキスト設定のデフォルトを提供するためのサポートが追加されました。

バージョン1.1

（バグ修正リリース、2014年5月23日にリリース）

• Python2のテキストファイルがネイティブ文字列を受け入れない原因となっていたバグを修正しました。

バージョン1.0

（コードネームなし、2014年5月21日にリリース）

• 初回リリース。