From 0b9809123cdc1d5b01486971d62e6c24b1ab2817 Mon Sep 17 00:00:00 2001 From: Tetsuo Koyama Date: Sun, 20 Apr 2025 12:03:52 +0900 Subject: [PATCH 1/6] docs: translate to Japanese tests.md --- locales/ja/LC_MESSAGES/tests.po | 793 ++++++++++++++++---------------- 1 file changed, 399 insertions(+), 394 deletions(-) diff --git a/locales/ja/LC_MESSAGES/tests.po b/locales/ja/LC_MESSAGES/tests.po index 50fba669..421ef3e8 100644 --- a/locales/ja/LC_MESSAGES/tests.po +++ b/locales/ja/LC_MESSAGES/tests.po @@ -1,170 +1,185 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2024, pyOpenSci -# This file is distributed under the same license as the pyOpenSci Python -# Package Guide package. -# FIRST AUTHOR , 2024. +# Copyright (C) 2025, pyOpenSci +# This file is distributed under the same license as the pyOpenSci Python Package Guide package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Tetsuo Koyama , 2025 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: pyOpenSci Python Package Guide \n" +"Project-Id-Version: pyOpenSci Python Package Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-02-17 22:50+0000\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME \n" -"Language: ja\n" -"Language-Team: ja \n" -"Plural-Forms: nplurals=1; plural=0;\n" +"POT-Creation-Date: 2025-04-14 22:27+0900\n" +"PO-Revision-Date: 2025-04-14 18:12+0000\n" +"Last-Translator: Tetsuo Koyama , 2025\n" +"Language-Team: Japanese (https://app.transifex.com/tkoyama010/teams/196662/ja/)\n" "MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=utf-8\n" +"Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Generated-By: Babel 2.17.0\n" +"Language: ja\n" +"Plural-Forms: nplurals=1; plural=0;\n" #: ../../tests/code-cov.md:1 -#, fuzzy msgid "Code coverage for your Python package test suite" -msgstr "Pythonパッケージのテストを書く" +msgstr "Pythonパッケージのテストスイートのコードカバレッジ" #: ../../tests/code-cov.md:3 msgid "" -"Code coverage measures how much of your package's code runs during " -"testing. Achieving high coverage can help ensure the reliability of your " -"codebase, but it’s not a guarantee of quality. Below, we outline key " -"considerations for using code coverage effectively." +"Code coverage measures how much of your package's code runs during testing. " +"Achieving high coverage can help ensure the reliability of your codebase, " +"but it’s not a guarantee of quality. Below, we outline key considerations " +"for using code coverage effectively." msgstr "" +"コードカバレッジは、テスト中にパッケージのコードがどれだけ実行されるかを測定します。 " +"高いカバレッジを達成することは、コードベースの信頼性を確保するのに役立ちますが、品質を保証するものではありません。 " +"以下に、コードカバレッジを効果的に使用するための主な検討事項を概説します。" #: ../../tests/code-cov.md:8 msgid "Why aim for high code coverage?" -msgstr "" +msgstr "なぜ高いコードカバレッジを目指すのか？" #: ../../tests/code-cov.md:10 msgid "" -"A good practice is to ensure that every line of your code runs at least " -"once during your test suite. This helps you:" -msgstr "" +"A good practice is to ensure that every line of your code runs at least once" +" during your test suite. This helps you:" +msgstr "良い習慣は、テストスイートの間に、コードのすべての行が少なくとも一度は実行されるようにすることです。これはあなたを助けます:" #: ../../tests/code-cov.md:13 msgid "Identify untested parts of your codebase." -msgstr "" +msgstr "コードベースのテストされていない部分を特定します。" #: ../../tests/code-cov.md:14 msgid "Catch bugs that might otherwise go unnoticed." -msgstr "" +msgstr "他の方法では気づかれないかもしれないバグをキャッチします。" #: ../../tests/code-cov.md:15 msgid "Build confidence in your software's stability." -msgstr "" +msgstr "ソフトウェアの安定性に自信を持てます。" #: ../../tests/code-cov.md:17 msgid "Limitations of code coverage" -msgstr "" +msgstr "コードカバレッジの限界" #: ../../tests/code-cov.md:19 msgid "While high code coverage is valuable, it has its limits:" -msgstr "" +msgstr "高いコードカバレッジは価値がありますが、それには限界があります:" #: ../../tests/code-cov.md:21 msgid "" -"**Difficult-to-test code:** Some parts of your code might be challenging " -"to test, either due to complexity or limited resources." -msgstr "" +"**Difficult-to-test code:** Some parts of your code might be challenging to " +"test, either due to complexity or limited resources." +msgstr "**テストしにくいコード:** コードの中には、複雑さや限られたリソースのために、テストが難しい部分があるかもしれません。" #: ../../tests/code-cov.md:23 msgid "" -"**Missed edge cases:** Running all lines of code doesn’t guarantee that " -"edge cases are handled correctly." -msgstr "" +"**Missed edge cases:** Running all lines of code doesn’t guarantee that edge" +" cases are handled correctly." +msgstr "**見逃されたエッジケース:** すべてのコードを実行しても、エッジケースが正しく処理される保証はありません。" #: ../../tests/code-cov.md:26 msgid "" "Ultimately, you should focus on how your package will be used and ensure " "your tests cover those scenarios adequately." -msgstr "" +msgstr "最終的には、パッケージがどのように使用されるかに焦点を当て、テストがそのシナリオを十分にカバーするようにしなければなりません。" #: ../../tests/code-cov.md:29 msgid "Tools for analyzing Python package code coverage" -msgstr "" +msgstr "Pythonパッケージのコードカバレッジを分析するツール" #: ../../tests/code-cov.md:31 msgid "" "Some common services for analyzing code coverage are " -"[codecov.io](https://codecov.io/) and " -"[coveralls.io](https://coveralls.io/). These projects are free for open " -"source tools and will provide dashboards that tell you how much of your " -"codebase is covered during your tests. We recommend setting up an account" -" (on either CodeCov or Coveralls) and using it to keep track of your code" -" coverage." +"[codecov.io](https://codecov.io/) and [coveralls.io](https://coveralls.io/)." +" These projects are free for open source tools and will provide dashboards " +"that tell you how much of your codebase is covered during your tests. We " +"recommend setting up an account (on either CodeCov or Coveralls) and using " +"it to keep track of your code coverage." msgstr "" +"コードカバレッジを分析するための一般的なサービスには、 [codecov.io](https://codecov.io/) と " +"[coveralls.io](https://coveralls.io/) があります。 " +"これらのプロジェクトはオープンソースのツールで無料であり、テスト中にコードベースがどの程度カバーされているかを示すダッシュボードを提供してくれます。 " +"(CodeCovまたはCoverallsで) アカウントを設定し、コード・カバレッジを追跡するために使用することをお勧めします。" #: ../../tests/code-cov.md:33 -#, python-format msgid "" -"Screenshot of the code cov service - showing test coverage for the " -"stravalib package. This image shows a list of package modules and the " -"associated number of lines and % lines covered by tests. At the top of " -"the image, you can see what branch is being evaluated and the path to the" -" repository." +"Screenshot of the code cov service - showing test coverage for the stravalib" +" package. This image shows a list of package modules and the associated " +"number of lines and % lines covered by tests. At the top of the image, you " +"can see what branch is being evaluated and the path to the repository." msgstr "" +"code covサービスのスクリーンショット - stravalibパッケージのテストカバレッジを示します。 " +"この画像は、パッケージモジュールのリストと、関連する行数およびテスト対象行の割合を示しています。 " +"画像の上部には、評価対象のブランチとリポジトリへのパスが表示されています。" #: ../../tests/code-cov.md:38 msgid "" "The CodeCov platform is a useful tool if you wish to track code coverage " -"visually. Using it, you can not only get the same summary information " -"that you can get with the **pytest-cov** extension. You can also see what" -" lines are covered by your tests and which are not. Code coverage is " -"useful for evaluating unit tests and/or how much of your package code is " -"\"covered\". It, however, will not evaluate things like integration tests" -" and end-to-end workflows." +"visually. Using it, you can not only get the same summary information that " +"you can get with the **pytest-cov** extension. You can also see what lines " +"are covered by your tests and which are not. Code coverage is useful for " +"evaluating unit tests and/or how much of your package code is \"covered\". " +"It, however, will not evaluate things like integration tests and end-to-end " +"workflows." msgstr "" +"CodeCovプラットフォームは、コードカバレッジを視覚的に追跡したい場合に便利なツールです。これを使えば、 **pytest-cov** " +"拡張機能で得られるのと同じサマリー情報を得られるだけではありません。また、テストの対象になっているラインとそうでないラインを確認することもできます。コードカバレッジは、単体テストの評価や、パッケージのコードがどれだけ" +" \"カバー\" されているかを評価するのに役立ちます。しかし、統合テストやエンドツーエンドのワークフローなどは評価されません。" #: ../../tests/code-cov.md:43 msgid "Typing & MyPy coverage" -msgstr "" +msgstr "型 & MyPyのカバレッジ" #: ../../tests/code-cov.md:44 msgid "You can also create and upload typing reports to CodeCov." -msgstr "" +msgstr "また、型レポートを作成し、CodeCovにアップロードすることもできます。" #: ../../tests/code-cov.md:47 msgid "Exporting Local Coverage Reports" -msgstr "" +msgstr "ローカルカバレッジレポートのエクスポート" #: ../../tests/code-cov.md:49 msgid "" -"In addition to using services like CodeCov or Coveralls, you can generate" -" local coverage reports directly using the **coverage.py** tool. This can" -" be especially useful if you want to create reports in Markdown or HTML " -"format for offline use or documentation." +"In addition to using services like CodeCov or Coveralls, you can generate " +"local coverage reports directly using the **coverage.py** tool. This can be " +"especially useful if you want to create reports in Markdown or HTML format " +"for offline use or documentation." msgstr "" +"CodeCovやCoverallsのようなサービスを利用するだけでなく、 **coverage.py** " +"ツールを使って直接ローカルカバレッジレポートを作成することもできます。 " +"これは、オフラインでの使用や文書化のためにMarkdownやHTML形式でレポートを作成したい場合に特に便利です。" #: ../../tests/code-cov.md:51 msgid "To generate a coverage report in **Markdown** format, run:" -msgstr "" +msgstr "カバレッジレポートを **Markdown** 形式で作成するには、以下を実行します:" #: ../../tests/code-cov.md:56 msgid "" -"This command will produce a Markdown-formatted coverage summary that you " -"can easily include in project documentation or share with your team." +"This command will produce a Markdown-formatted coverage summary that you can" +" easily include in project documentation or share with your team." msgstr "" +"このコマンドはMarkdown形式のカバレッジサマリーを作成し、プロジェクトのドキュメントに簡単に記載したり、チームと共有したりすることができます。" #: ../../tests/code-cov.md:58 msgid "" "To generate an HTML report that provides a detailed, interactive view of " "which lines are covered, use:" -msgstr "" +msgstr "どの行がカバーされているか、詳細でインタラクティブなビューを提供するHTMLレポートを生成するには、以下を使用します:" #: ../../tests/code-cov.md:64 msgid "" "The generated HTML report will be saved in a directory named htmlcov by " -"default. Open the index.html file in your browser to explore your " -"coverage results." +"default. Open the index.html file in your browser to explore your coverage " +"results." msgstr "" +"生成されたHTMLレポートは、デフォルトでhtmlcovというディレクトリに保存されます。index.htmlファイルをブラウザで開き、カバレッジ結果をご覧ください。" #: ../../tests/code-cov.md:66 msgid "" -"These local reports are an excellent way to quickly review coverage " -"without setting up an external service." -msgstr "" +"These local reports are an excellent way to quickly review coverage without " +"setting up an external service." +msgstr "このようなローカルレポートは、外部サービスを立ち上げることなくカバレッジを素早く確認する優れた方法です。" #: ../../tests/index.md:73 msgid "Intro" @@ -188,7 +203,7 @@ msgstr "オンラインでテストを実行する(CIを使用する)" #: ../../tests/index.md:73 msgid "Code coverage" -msgstr "" +msgstr "コードカバレッジ" #: ../../tests/index.md:73 msgid "Create & Run Tests" @@ -200,19 +215,18 @@ msgstr "Pythonパッケージのテストとデータ" #: ../../tests/index.md:4 msgid "" -"Tests are an important part of your Python package because they provide a" -" set of checks that ensure that your package is functioning how you " -"expect it to." +"Tests are an important part of your Python package because they provide a " +"set of checks that ensure that your package is functioning how you expect it" +" to." msgstr "" "テストは Python " "パッケージの重要な一部です。なぜなら、テストはパッケージが期待通りに動作しているかどうかを確認するための一連のチェック機能を提供するからです。" #: ../../tests/index.md:8 -#, fuzzy msgid "" -"In this section, you will learn more about the importance of writing " -"tests for your Python package and how you can set up infrastructure to " -"run your tests both locally and on GitHub." +"In this section, you will learn more about the importance of writing tests " +"for your Python package and how you can set up infrastructure to run your " +"tests both locally and on GitHub." msgstr "" "このセクションでは、Python パッケージのテストを書くことの重要性と、ローカルと GitHub " "の両方でテストを実行するためのインフラストラクチャの設定方法について学びます。" @@ -228,7 +242,7 @@ msgid "" "contributors to your project." msgstr "" "Python パッケージのテストを書く技術についてもっと学びましょう。 " -"なぜテストを書く必要があるのか、そしてテストがどのようにあなたやあなたのプロジェクトへの将来の貢献者の助けになるのかを学びましょう。" +"なぜテストを書く必要があるのか、そしてテストがどのようにあなたやあなたのプロジェクトへの潜在的な貢献者の助けになるのかを学びましょう。" #: ../../tests/index.md:32 msgid "✨ Types of tests ✨" @@ -236,9 +250,9 @@ msgstr "✨テストの種類✨" #: ../../tests/index.md:37 msgid "" -"There are three general types of tests that you can write for your Python" -" package: unit tests, integration tests and end-to-end (or functional) " -"tests. Learn about all three." +"There are three general types of tests that you can write for your Python " +"package: unit tests, integration tests and end-to-end (or functional) tests." +" Learn about all three." msgstr "" "Python パッケージで書くことのできるテストには、ユニットテスト、統合テスト、エンドツーエンドテスト (あるいは機能テスト) の 3 " "種類があります。 この 3 つについて学びましょう。" @@ -249,8 +263,8 @@ msgstr "✨ローカルでテストを実行する✨" #: ../../tests/index.md:48 msgid "" -"If you expect your users to use your package across different versions of" -" Python, then using an automation tool such as nox to run your tests is " +"If you expect your users to use your package across different versions of " +"Python, then using an automation tool such as nox to run your tests is " "useful. Learn about the various tools that you can use to run your tests " "across python versions here." msgstr "" @@ -263,14 +277,13 @@ msgid "✨ Run tests online (using CI) ✨" msgstr "✨オンラインでテストを実行する(CIを使用する)✨" #: ../../tests/index.md:59 -#, fuzzy msgid "" -"Continuous integration platforms such as GitHub Actions can be useful for" -" running your tests across both different Python versions and different " +"Continuous integration platforms such as GitHub Actions can be useful for " +"running your tests across both different Python versions and different " "operating systems. Learn about setting up tests to run in Continuous " "Integration here." msgstr "" -"GitHub アクションのような継続的インテグレーションプラットフォームは、Python " +"GitHub Actionsのような継続的インテグレーションプラットフォームは、Python " "のバージョンやオペレーティングシステムの違いを問わずテストを実行するのに便利です。 " "継続的インテグレーションで実行するテストの設定については、こちらを参照してください。" @@ -284,11 +297,11 @@ msgstr "Pythonパッケージテストの実行" #: ../../tests/run-tests.md:8 msgid "" -"Running your tests is important to ensure that your package is working as" -" expected. It's good practice to consider that tests will run on your " -"computer and your users' computers that may be running a different Python" -" version and operating systems. Think about the following when running " -"your tests:" +"Running your tests is important to ensure that your package is working as " +"expected. It's good practice to consider that tests will run on your " +"computer and your users' computers that may be running a different Python " +"version and operating systems. Think about the following when running your " +"tests:" msgstr "" "テストを実行することは、パッケージが期待通りに動作していることを確認するために重要です。 テストは、あなたのコンピュータと、Python " "のバージョンやオペレーティングシステムが異なるユーザのコンピュータで実行されることを考慮するのがよい習慣です。 " @@ -296,31 +309,30 @@ msgstr "" #: ../../tests/run-tests.md:11 msgid "" -"Run your test suite in a matrix of environments that represent the Python" -" versions and operating systems your users are likely to have." +"Run your test suite in a matrix of environments that represent the Python " +"versions and operating systems your users are likely to have." msgstr "テストスイートは、Python のバージョンとユーザーが使用する可能性のあるオペレーティングシステムを表す環境のマトリックスで実行します。" #: ../../tests/run-tests.md:12 msgid "" "Running your tests in an isolated environment provides confidence in the " "tests and their reproducibility. This ensures that tests do not pass " -"randomly due to your computer's specific setup. For instance, you might " -"have unexpectedly installed dependencies on your local system that are " -"not declared in your package's dependency list. This oversight could lead" -" to issues when others try to install or run your package on their " -"computers." +"randomly due to your computer's specific setup. For instance, you might have" +" unexpectedly installed dependencies on your local system that are not " +"declared in your package's dependency list. This oversight could lead to " +"issues when others try to install or run your package on their computers." msgstr "" "隔離された環境でテストを実行することで、テストとその再現性に自信を持つことができます。 " "これにより、あなたのコンピュータの設定によってテストがランダムにパスすることがなくなります。 " "たとえば、あなたのパッケージの依存関係リストで宣言されていない依存関係を、予期せずローカルシステムにインストールしてしまったかもしれません。 " -"このような見落としは、他の人があなたのパッケージを自分のコン ピュータにインストールしたり実行しようとしたときに、問題につながる可能性 " -"があります。" +"このような見落としは、他の人があなたのパッケージを自分のコン ピュータにインストールしたり実行しようとしたときに、問題につながる可能性 があります。" #: ../../tests/run-tests.md:14 msgid "" -"On this page, you will learn about the tools that you can use to both run" -" tests in isolated environments and across Python versions." -msgstr "このページでは、隔離された環境でテストを実行したり、Python のバージョンを越えてテストを実行したりするために使えるツールについて学びます。" +"On this page, you will learn about the tools that you can use to both run " +"tests in isolated environments and across Python versions." +msgstr "" +"このページでは、隔離された環境でテストを実行したり、Python のバージョンを越えてテストを実行したりするために使えるツールについて学びます。" #: ../../tests/run-tests.md:19 msgid "Tools to run your tests" @@ -328,53 +340,50 @@ msgstr "テストを実行するためのツール" #: ../../tests/run-tests.md:21 msgid "" -"There are three categories of tools that will make is easier to setup and" -" run your tests in various environments:" +"There are three categories of tools that will make is easier to setup and " +"run your tests in various environments:" msgstr "さまざまな環境でのテストのセットアップと実行を容易にするツールには、3つのカテゴリーがあります:" #: ../../tests/run-tests.md:24 msgid "" -"A **test framework**, is a package that provides a particular syntax and " -"set of tools for _both writing and running your tests_. Some test " -"frameworks also have plugins that add additional features such as " -"evaluating how much of your code the tests cover. Below you will learn " -"about the **pytest** framework which is one of the most commonly used " -"Python testing frameworks in the scientific ecosystem. Testing frameworks" -" are essential but they only serve to run your tests. These frameworks " -"don't provide a way to easily run tests across Python versions without " -"the aid of additional automation tools." +"A **test framework**, is a package that provides a particular syntax and set" +" of tools for _both writing and running your tests_. Some test frameworks " +"also have plugins that add additional features such as evaluating how much " +"of your code the tests cover. Below you will learn about the **pytest** " +"framework which is one of the most commonly used Python testing frameworks " +"in the scientific ecosystem. Testing frameworks are essential but they only " +"serve to run your tests. These frameworks don't provide a way to easily run " +"tests across Python versions without the aid of additional automation tools." msgstr "" "**テストフレームワーク** とは、テストを書いたり実行したりするための特定の構文やツールのセットを提供するパッケージのことです。 " "いくつかのテストフレームワークにはプラグインがあり、テストがカバーするコードの範囲を評価するなどの機能を追加することができます。 " "以下では、科学的なエコシステムで最もよく使われている Python テストフレームワークの一つである **pytest** " "フレームワークについて学びます。 テストフレームワークは必要不可欠ですが、テストを実行するためだけのものです。 " -"これらのフレームワークは、追加の自動化ツールの助けを借りずに Python のバージョンをまたいだテストを簡単に実行する方法は提供しません。" +"これらのフレームワークは、追加の自動化ツールの助けを借りずに Python のバージョン間でテストを簡単に実行する方法は提供しません。" #: ../../tests/run-tests.md:25 msgid "" -"**Automation tools** allow you to automate running workflows such as " -"tests in specific ways using user-defined commands. For instance it's " -"useful to be able to run tests across different Python versions with a " -"single command. Tools such as " -"[**nox**](https://nox.thea.codes/en/stable/index.html) and " -"[**tox**](https://tox.wiki/en/latest/index.html) also allow you to run " -"tests across Python versions. However, it will be difficult to test your " -"build on different operating systems using only nox and tox - this is " -"where continuous integration (CI) comes into play." +"**Automation tools** allow you to automate running workflows such as tests " +"in specific ways using user-defined commands. For instance it's useful to be" +" able to run tests across different Python versions with a single command. " +"Tools such as [**nox**](https://nox.thea.codes/en/stable/index.html) and " +"[**tox**](https://tox.wiki/en/latest/index.html) also allow you to run tests" +" across Python versions. However, it will be difficult to test your build on" +" different operating systems using only nox and tox - this is where " +"continuous integration (CI) comes into play." msgstr "" "**自動化ツール** を使うと、ユーザー定義のコマンドを使って、テストのようなワークフローを特定の方法で実行することを自動化できます。 " "例えば、1つのコマンドで異なるPythonのバージョンにまたがってテストを実行できると便利です。 " "[**nox**](https://nox.thea.codes/en/stable/index.html) や " "[**tox**](https://tox.wiki/en/latest/index.html) " "のようなツールも、Pythonのバージョンをまたいでテストを実行できます。 " -"しかし、noxとtoxだけを使って異なるオペレーティングシステムでビルドをテストするのは難しいでしょう - " -"ここで継続的インテグレーション(CI)の出番です。" +"しかし、noxとtoxだけを使って異なるオペレーティングシステムでビルドをテストするのは難しいでしょう - 継続的インテグレーション(CI)の出番です。" #: ../../tests/run-tests.md:26 msgid "" -"**Continuous Integration (CI):** is the last tool that you'll need to run" -" your tests. CI will not only allow you to replicate any automated builds" -" you create using nox or tox to run your package in different Python " +"**Continuous Integration (CI):** is the last tool that you'll need to run " +"your tests. CI will not only allow you to replicate any automated builds you" +" create using nox or tox to run your package in different Python " "environments. It will also allow you to run your tests on different " "operating systems (Windows, Mac and Linux). [We discuss using CI to run " "tests here](tests-ci)." @@ -457,16 +466,16 @@ msgstr "テストを実行するには、どのテストフレームワーク/ #: ../../tests/run-tests.md:75 msgid "" -"We recommend using `Pytest` to build and run your package tests. Pytest " -"is the most common testing tool used in the Python ecosystem." +"We recommend using `Pytest` to build and run your package tests. Pytest is " +"the most common testing tool used in the Python ecosystem." msgstr "" "パッケージテストのビルドと実行には `Pytest` を使うことを推奨します。 Pytest は Python " "のエコシステムで最もよく使われているテストツールです。" #: ../../tests/run-tests.md:77 msgid "" -"[The Pytest package](https://docs.pytest.org/en/latest/) also has a " -"number of extensions that can be used to add functionality such as:" +"[The Pytest package](https://docs.pytest.org/en/latest/) also has a number " +"of extensions that can be used to add functionality such as:" msgstr "" "[Pytestパッケージ](https://docs.pytest.org/en/latest/) " "には、以下のような機能を追加するために使用できる多くの拡張機能もあります：" @@ -474,8 +483,8 @@ msgstr "" #: ../../tests/run-tests.md:80 msgid "" "[pytest-cov](https://pytest-cov.readthedocs.io/en/latest/) allows you to " -"analyze the code coverage of your package during your tests, and " -"generates a report that you can [upload to codecov](https://codecov.io/)." +"analyze the code coverage of your package during your tests, and generates a" +" report that you can [upload to codecov](https://codecov.io/)." msgstr "" "[pytest-cov](https://pytest-cov.readthedocs.io/en/latest/) " "を使うと、テスト中にパッケージのコードカバレッジを分析し、 [codecov](https://codecov.io/) " @@ -492,9 +501,9 @@ msgstr "コードカバレッジについてはこちらをご覧ください。 #: ../../tests/run-tests.md:87 msgid "" -"Your editor or IDE may add additional convenience for running tests, " -"setting breakpoints, and toggling the `–no-cov` flag. Check your editor's" -" documentation for more information." +"Your editor or IDE may add additional convenience for running tests, setting" +" breakpoints, and toggling the `–no-cov` flag. Check your editor's " +"documentation for more information." msgstr "" "お使いのエディタや IDE には、テストを実行したり、ブレークポイントを設定したり、 `-no-cov` " "フラグを切り替えたりするための便利な機能が追加されているかもしれません。 詳しくはエディタのドキュメントを参照してください。" @@ -504,7 +513,8 @@ msgid "Run tests using pytest" msgstr "pytest を使ってテストを実行する" #: ../../tests/run-tests.md:92 -msgid "If you are using **pytest**, you can run your tests locally by calling:" +msgid "" +"If you are using **pytest**, you can run your tests locally by calling:" msgstr "**pytest** を使用している場合、テストをローカルで実行することができます:" #: ../../tests/run-tests.md:95 @@ -516,8 +526,7 @@ msgid "" "Or if you want to run a specific test file - let's call this file " "\"`test_module.py`\" - you can run:" msgstr "" -"また、特定のテストファイル - このファイルを \"`test_module.py`\" と呼ぶことにします - " -"を実行したい場合は、次のようにします:" +"また、特定のテストファイル - このファイルを \"`test_module.py`\" と呼ぶことにします - を実行したい場合は、次のようにします:" #: ../../tests/run-tests.md:99 msgid "`pytest test_module.py`" @@ -525,18 +534,18 @@ msgstr "`pytest test_module.py`" #: ../../tests/run-tests.md:101 msgid "" -"Learn more from the [get started docs](https://docs.pytest.org/en/7.1.x" -"/getting-started.html)." +"Learn more from the [get started " +"docs](https://docs.pytest.org/en/7.1.x/getting-started.html)." msgstr "" -"詳しくは [ドキュメントスタートガイド](https://docs.pytest.org/en/7.1.x/getting-" -"started.html) をご覧ください。" +"詳しくは [ドキュメントスタートガイド](https://docs.pytest.org/en/7.1.x/getting-started.html) " +"をご覧ください。" #: ../../tests/run-tests.md:103 msgid "" "Running pytest on your computer is going to run your tests in whatever " -"Python environment you currently have activated. This means that tests " -"will be run on a single version of Python and only on the operating " -"system that you are running locally." +"Python environment you currently have activated. This means that tests will " +"be run on a single version of Python and only on the operating system that " +"you are running locally." msgstr "" "あなたのコンピュータで pytest を実行すると、現在有効になっている Python 環境でテストが実行されます。 " "つまり、テストは単一のバージョンのPythonで、ローカルで実行しているオペレーティングシステム上でのみ実行されます。" @@ -549,7 +558,7 @@ msgstr "自動化ツールは、様々な Python 環境でテストを実行す #: ../../tests/run-tests.md:111 msgid "Tests across operating systems" -msgstr "オペレーティングシステムをまたいだテスト" +msgstr "オペレーティングシステムを超えたテスト" #: ../../tests/run-tests.md:112 msgid "" @@ -565,23 +574,23 @@ msgstr "テストの実行を自動化するツール" #: ../../tests/run-tests.md:117 msgid "" -"To run tests on various Python versions or in various specific " -"environments with a single command, you can use an automation tool such " -"as `nox` or `tox`. Both `nox` and `tox` can create an isolated virtual " -"environments. This allows you to easily run your tests in multiple " -"environments and across Python versions." +"To run tests on various Python versions or in various specific environments " +"with a single command, you can use an automation tool such as `nox` or " +"`tox`. Both `nox` and `tox` can create an isolated virtual environments. " +"This allows you to easily run your tests in multiple environments and across" +" Python versions." msgstr "" "一つのコマンドで様々な Python のバージョンや特定の環境でテストを実行するには、 `nox` や `tox` " -"のような自動化ツールを使うことができます。 `nox` も `tox` も、隔離された仮想環境を作成することができます。 これにより、複数の環境や" -" Python のバージョンをまたいだテストを簡単に実行することができます。" +"のような自動化ツールを使うことができます。 `nox` も `tox` も、隔離された仮想環境を作成することができます。 これにより、複数の環境や " +"Python のバージョン間でテストを簡単に実行することができます。" #: ../../tests/run-tests.md:120 msgid "" -"We will focus on [Nox](https://nox.thea.codes/) in this guide. `nox` is a" -" Python-based automation tool that builds upon the features of both " -"`make` and `tox`. `nox` is designed to simplify and streamline testing " -"and development workflows. Everything that you do with `nox` can be " -"implemented using a Python-based interface." +"We will focus on [Nox](https://nox.thea.codes/) in this guide. `nox` is a " +"Python-based automation tool that builds upon the features of both `make` " +"and `tox`. `nox` is designed to simplify and streamline testing and " +"development workflows. Everything that you do with `nox` can be implemented " +"using a Python-based interface." msgstr "" "このガイドでは、 [Nox](https://nox.thea.codes/) に焦点を当てます。 `nox` は Python " "ベースの自動化ツールで、 `make` と `tox` の機能をベースにしています。 `nox` " @@ -593,41 +602,38 @@ msgid "Other automation tools you'll see in the wild" msgstr "その他の自動化ツール" #: ../../tests/run-tests.md:125 -#, fuzzy msgid "" "**[Tox](https://tox.wiki/en/latest/index.html#useful-links)** is an " -"automation tool that supports common steps such as building " -"documentation, running tests across various versions of Python, and more." +"automation tool that supports common steps such as building documentation, " +"running tests across various versions of Python, and more." msgstr "" "**[Tox](https://tox.wiki/en/latest/index.html#useful-links)** " -"は自動化ツールで、ドキュメントのビルドや、Pythonの様々なバージョン間でのテストの実行など、一般的なステップをサポートしています。 " -"[plasmaPyのドキュメントによいtoxの概要があります](https://docs.plasmapy.org/en/stable/contributing/testing_guide.html" -"#using-tox) 。" +"は自動化ツールで、ドキュメントのビルドや、Pythonの様々なバージョン間でのテストの実行など、一般的なステップをサポートしています。" #: ../../tests/run-tests.md:127 msgid "" -"**[Hatch](https://github.com/ofek/hatch)** is a modern end-to-end " -"packaging tool that works with the popular build backend called " -"hatchling. `hatch` offers a `tox`-like setup where you can run tests " -"locally using different Python versions. If you are using `hatch` to " -"support your packaging workflow, you may want to also use its testing " -"capabilities rather than using `nox`." +"**[Hatch](https://github.com/ofek/hatch)** is a modern end-to-end packaging " +"tool that works with the popular build backend called hatchling. `hatch` " +"offers a `tox`-like setup where you can run tests locally using different " +"Python versions. If you are using `hatch` to support your packaging " +"workflow, you may want to also use its testing capabilities rather than " +"using `nox`." msgstr "" "**[Hatch](https://github.com/ofek/hatch)** " -"は、hatchlingと呼ばれる人気のあるビルドバックエンドで動作する最新のエンドツーエンドパッケージングツールです。 `hatch` は " -"`tox` のようなセットアップを提供し、異なる Python バージョンを使ってローカルでテストを実行することができます。 " +"は、hatchlingと呼ばれる人気のあるビルドバックエンドで動作する最新のエンドツーエンドパッケージングツールです。 `hatch` は `tox`" +" のようなセットアップを提供し、異なる Python バージョンを使ってローカルでテストを実行することができます。 " "パッケージングのワークフローをサポートするために `hatch` を使っているのであれば、 `nox` を使うよりも `hatch` " "のテスト機能を使った方が良いかもしれない。" #: ../../tests/run-tests.md:129 msgid "" "[**make:**](https://www.gnu.org/software/make/manual/make.html) Some " -"developers use Make, which is a build automation tool, for running tests " -"due to its versatility; it's not tied to a specific language and can be " -"used to run various build processes. However, Make's unique syntax and " -"approach can make it more challenging to learn, particularly if you're " -"not already familiar with it. Make also won't manage environments for you" -" like **nox** will do." +"developers use Make, which is a build automation tool, for running tests due" +" to its versatility; it's not tied to a specific language and can be used to" +" run various build processes. However, Make's unique syntax and approach can" +" make it more challenging to learn, particularly if you're not already " +"familiar with it. Make also won't manage environments for you like **nox** " +"will do." msgstr "" "[**make:**](https://www.gnu.org/software/make/manual/make.html) " "ビルド自動化ツールであるMakeは汎用性が高いため、テストの実行に使う開発者もいます; " @@ -644,7 +650,7 @@ msgstr "**Nox** は素晴らしい自動化ツールです:" #: ../../tests/run-tests.md:140 msgid "Is Python-based making it accessible if you already know Python and" -msgstr "Pythonベースですので、Pythonをすでに知っていれば利用しやすいです。" +msgstr "Pythonベースですので、Pythonをすでに知っていればアクセス可能です。" #: ../../tests/run-tests.md:141 msgid "Will create isolated environments to run workflows." @@ -652,9 +658,9 @@ msgstr "ワークフローを実行するための隔離された環境を構築 #: ../../tests/run-tests.md:143 msgid "" -"`nox` simplifies creating and managing testing environments. With `nox`, " -"you can set up virtual environments, and run tests across Python versions" -" using the environment manager of your choice with a single command." +"`nox` simplifies creating and managing testing environments. With `nox`, you" +" can set up virtual environments, and run tests across Python versions using" +" the environment manager of your choice with a single command." msgstr "" "`nox` はテスト環境の作成と管理を簡単にします。 `nox` を使うと、仮想環境をセットアップし、好きな環境マネージャを使って Python " "のバージョンをまたいだテストをコマンド一つで実行することができます。" @@ -665,12 +671,12 @@ msgstr "Noxのインストール" #: ../../tests/run-tests.md:150 msgid "" -"When you install and use nox to run tests across different Python " -"versions, nox will create and manage individual `venv` environments for " -"each Python version that you specify in the nox function." +"When you install and use nox to run tests across different Python versions, " +"nox will create and manage individual `venv` environments for each Python " +"version that you specify in the nox function." msgstr "" -"異なる Python バージョン間でテストを実行するために nox をインストールして使用する場合、nox は nox 関数で指定した " -"Python バージョンごとに個別の `venv` 環境を作成して管理します。" +"異なる Python バージョン間でテストを実行するために nox をインストールして使用する場合、nox は nox 関数で指定した Python " +"バージョンごとに個別の `venv` 環境を作成して管理します。" #: ../../tests/run-tests.md:152 msgid "Nox will manage each environment on its own." @@ -679,18 +685,18 @@ msgstr "Noxはそれぞれの環境を独自に管理します。" #: ../../tests/run-tests.md:154 msgid "" "Nox can also be used for other development tasks such as building " -"documentation, creating your package distribution, and testing " -"installations across both PyPI related environments (e.g. venv, " -"virtualenv) and `conda` (e.g. `conda-forge`)." +"documentation, creating your package distribution, and testing installations" +" across both PyPI related environments (e.g. venv, virtualenv) and `conda` " +"(e.g. `conda-forge`)." msgstr "" "nox は、ドキュメントのビルド、パッケージ配布の作成、PyPI 関連の環境 (venv や virtualenv など) と `conda` " "(conda-forge` など) の両方にわたるインストールのテストなど、その他の開発作業にも使用できます。" #: ../../tests/run-tests.md:158 msgid "" -"To get started with nox, you create a `noxfile.py` file at the root of " -"your project directory. You then define commands using Python functions. " -"Some examples of that are below." +"To get started with nox, you create a `noxfile.py` file at the root of your " +"project directory. You then define commands using Python functions. Some " +"examples of that are below." msgstr "" "noxを使い始めるには、プロジェクトディレクトリのルートに `noxfile.py` ファイルを作成します。 " "そして、Pythonの関数を使ってコマンドを定義します。 以下にその例をいくつか挙ます。" @@ -703,20 +709,20 @@ msgstr "テスト環境" msgid "" "By default, `nox` uses the Python built in `venv` environment manager. A " "virtual environment (`venv`) is a self-contained Python environment that " -"allows you to isolate and manage dependencies for different Python " -"projects. It helps ensure that project-specific libraries and packages do" -" not interfere with each other, promoting a clean and organized " -"development environment." +"allows you to isolate and manage dependencies for different Python projects." +" It helps ensure that project-specific libraries and packages do not " +"interfere with each other, promoting a clean and organized development " +"environment." msgstr "" -"デフォルトでは、 `nox` は Python 組み込みの `venv` 環境マネージャを使用します。 仮想環境 (`venv`) は自己完結型の" -" Python 環境で、異なる Python プロジェクトの依存関係を分離して管理することができます。 " +"デフォルトでは、 `nox` は Python 組み込みの `venv` 環境マネージャを使用する。 仮想環境 (`venv`) は自己完結型の " +"Python 環境で、異なる Python プロジェクトの依存関係を分離して管理することができます。 " "プロジェクト固有のライブラリやパッケージが互いに干渉しないようにし、クリーンで整理された開発環境を促進します。" #: ../../tests/run-tests.md:166 msgid "" "An example of using nox to run tests in `venv` environments for Python " "versions 3.9, 3.10, 3.11 and 3.12 is below." -msgstr "noxを使ってPythonバージョン3.9、3.10、3.11、3.12の `venv` 環境でテストを実行する例を以下に示します。" +msgstr "noxを使ってPythonバージョン3.9、3.10、3.11、3.12の `venv` 環境でテストを実行する例を以下に示す。" #: ../../tests/run-tests.md:169 msgid "" @@ -732,43 +738,44 @@ msgstr "venv環境のnox" #: ../../tests/run-tests.md:175 msgid "" -"TODO: add some tests above and show what the output would look like in " -"the examples below..." +"TODO: add some tests above and show what the output would look like in the " +"examples below..." msgstr "TODO: 上記のテストをいくつか追加し、以下の例で出力がどのようになるかを示す..." #: ../../tests/run-tests.md:178 msgid "" -"Below is an example of setting up nox to run tests using `venv` which is " -"the built in environment manager that comes with base Python." -msgstr "以下は、Pythonに組み込まれている環境マネージャーである `venv` を使ってテストを実行するようにnoxをセットアップする例です。" +"Below is an example of setting up nox to run tests using `venv` which is the" +" built in environment manager that comes with base Python." +msgstr "" +"以下は、Pythonに組み込まれている環境マネージャーである `venv` を使ってテストを実行するようにnoxをセットアップする例である。" #: ../../tests/run-tests.md:180 msgid "" "Note that the example below assumes that you have [setup your " "`pyproject.toml` to declare test dependencies in a way that pip can " -"understand](../package-structure-code/declare-dependencies.md). An " -"example of that setup is below." +"understand](../package-structure-code/declare-dependencies.md). An example " +"of that setup is below." msgstr "" -"以下の例では、 [pipが理解できる方法でテストの依存関係を宣言するように`pyproject.toml`をセットアップする" -"](../package-structure-code/declare-dependencies.md) " -"ことを前提としていることに注意してください。 そのセットアップの例を以下に示します。" +"以下の例では、 [pipが理解できる方法でテストの依存関係を宣言するように`pyproject.toml`をセットアップする](../package-" +"structure-code/declare-dependencies.md) ことを前提としていることに注意してください。 " +"そのセットアップの例を以下に示します。" #: ../../tests/run-tests.md:201 msgid "" "If you have the above setup, then you can use " -"`session.install(\".[tests]\")` to install your test dependencies. Notice" -" that below one single nox session allows you to run your tests on 4 " +"`session.install(\".[tests]\")` to install your test dependencies. Notice " +"that below one single nox session allows you to run your tests on 4 " "different Python environments (Python 3.9, 3.10, 3.11, and 3.12)." msgstr "" -"上記の設定ができていれば、 `session.install(\".[tests]\")` " -"を使ってテストの依存関係をインストールすることができます。 以下のように、1つのnoxセッションで4つの異なるPython環境（Python " +"上記の設定ができていれば、 `session.install(\".[tests]\")` を使ってテストの依存関係をインストールすることができます。 " +"以下のように、1つのnoxセッションで4つの異なるPython環境（Python " "3.9、3.10、3.11、3.12）でテストを実行できることに注意してください。" #: ../../tests/run-tests.md:222 msgid "" "Above you create a nox session in the form of a function with a " -"`@nox.session` decorator. Notice that within the decorator you declare " -"the versions of python that you wish to run." +"`@nox.session` decorator. Notice that within the decorator you declare the " +"versions of python that you wish to run." msgstr "" "上の例では、 `@nox.session` デコレーターを使って関数の形で nox セッションを作成しています。 デコレータの中で、実行したい " "python のバージョンを宣言していることに注意してください。" @@ -776,8 +783,8 @@ msgstr "" #: ../../tests/run-tests.md:226 msgid "" "To run the above you'd execute the following command, specifying which " -"session with `--session` (sometimes shortened to `-s`). Your function " -"above is called test, therefore the session name is test." +"session with `--session` (sometimes shortened to `-s`). Your function above " +"is called test, therefore the session name is test." msgstr "" "上記を実行するには、 `--session` （ `-s` " "と短縮されることもある）でセッションを指定し、以下のコマンドを実行します。上記の関数はtestという名前なので、セッション名はtestです。" @@ -789,18 +796,17 @@ msgstr "conda / mamba による nox" #: ../../tests/run-tests.md:236 msgid "" "Below is an example for setting up nox to use mamba (or conda) for your " -"environment manager. Note that unlike venv, conda can automatically " -"install the various versions of Python that you need. You won't need to " -"install all four Python versions if you use conda/mamba, like you do with" -" `venv`." +"environment manager. Note that unlike venv, conda can automatically install " +"the various versions of Python that you need. You won't need to install all " +"four Python versions if you use conda/mamba, like you do with `venv`." msgstr "" "以下は、noxが環境マネージャーにmamba（またはconda）を使うように設定する例です。venvと違って、condaは必要なPythonの様々なバージョンを自動的にインストールできることに注意してください。conda/mambaを使う場合は、" " `venv` のように4つのPythonバージョンをインストールする必要はありません。" #: ../../tests/run-tests.md:242 msgid "" -"For `conda` to work with `nox`, you will need to ensure that either " -"`conda` or `mamba` is installed on your computer." +"For `conda` to work with `nox`, you will need to ensure that either `conda` " +"or `mamba` is installed on your computer." msgstr "" "`nox` で `conda` を動作させるには、コンピュータに `conda` か `mamba` " "のどちらかがインストールされていることを確認する必要があります。" @@ -819,8 +825,8 @@ msgstr "3種類のテスト: 単体テスト、統合テスト、機能テスト #: ../../tests/test-types.md:5 msgid "" -"There are different types of tests that you want to consider when " -"creating your test suite:" +"There are different types of tests that you want to consider when creating " +"your test suite:" msgstr "テストスイートを作成する際に考慮したいテストには、さまざまなタイプがあります:" #: ../../tests/test-types.md:8 @@ -837,14 +843,14 @@ msgstr "エンドツーエンド(機能テストとも呼ばれる)テスト" #: ../../tests/test-types.md:12 msgid "" -"Each type of test has a different purpose. Here, you will learn about all" -" three types of tests." -msgstr "それぞれのテストには異なる目的があります。 ここでは、3種類のテストすべてについて学びます。" +"Each type of test has a different purpose. Here, you will learn about all " +"three types of tests." +msgstr "それぞれの検査には異なる目的がある。 ここでは、3種類の検査すべてについて学びます。" #: ../../tests/test-types.md:15 msgid "" -"I think this page would be stronger if we did have some examples from our" -" package here: https://github.com/pyOpenSci/pyosPackage" +"I think this page would be stronger if we did have some examples from our " +"package here: https://github.com/pyOpenSci/pyosPackage" msgstr "" "私たちのパッケージからの例があれば、このページはもっと強くなると思います: " "https://github.com/pyOpenSci/pyosPackage " @@ -856,27 +862,29 @@ msgstr "単体テスト" #: ../../tests/test-types.md:22 msgid "" "A unit test involves testing individual components or units of code in " -"isolation to ensure that they work correctly. The goal of unit testing is" -" to verify that each part of the software, typically at the function or " -"method level, performs its intended task correctly." -msgstr "単体テストは、個々のコンポーネントやコードの単位を分離してテストし、それらが正しく動作することを確認するものです。単体テストの目的は、ソフトウェアの各部分、通常は関数やメソッドのレベルが、意図したタスクを正しく実行することを検証することです。" +"isolation to ensure that they work correctly. The goal of unit testing is to" +" verify that each part of the software, typically at the function or method " +"level, performs its intended task correctly." +msgstr "" +"単体テストは、個々のコンポーネントやコードの単位を分離してテストし、それらが正しく動作することを確認するものです。単体テストの目的は、ソフトウェアの各部分、通常は関数やメソッドのレベルが、意図したタスクを正しく実行することを検証することです。" #: ../../tests/test-types.md:24 msgid "" -"Unit tests can be compared to examining each piece of your puzzle to " -"ensure parts of it are not broken. If all of the pieces of your puzzle " -"don’t fit together, you will never complete it. Similarly, when working " -"with code, tests ensure that each function, attribute, class, method " -"works properly when isolated." -msgstr "単体テストは、パズルの各パーツが壊れていないかどうかを調べることに例えることができます。パズルのピースがすべて合わなければ、完成することはありません。同様に、コードを扱う場合、テストは各関数、プロパティ、クラス、メソッドが分離されたときに正しく機能することを保証します。" +"Unit tests can be compared to examining each piece of your puzzle to ensure " +"parts of it are not broken. If all of the pieces of your puzzle don’t fit " +"together, you will never complete it. Similarly, when working with code, " +"tests ensure that each function, attribute, class, method works properly " +"when isolated." +msgstr "" +"単体テストは、パズルの各パーツが壊れていないかどうかを調べることに例えることができます。パズルのピースがすべて合わなければ、完成することはありません。同様に、コードを扱う場合、テストは各関数、プロパティ、クラス、メソッドが分離されたときに正しく機能することを保証します。" #: ../../tests/test-types.md:26 msgid "" "**Unit test example:** Pretend that you have a function that converts a " -"temperature value from Celsius to Fahrenheit. A test for that function " -"might ensure that when provided with a value in Celsius, the function " -"returns the correct value in degrees Fahrenheit. That function is a unit " -"test. It checks a single unit (function) in your code." +"temperature value from Celsius to Fahrenheit. A test for that function might" +" ensure that when provided with a value in Celsius, the function returns the" +" correct value in degrees Fahrenheit. That function is a unit test. It " +"checks a single unit (function) in your code." msgstr "" "**ユニットテスト例:** " "温度値を摂氏から華氏に変換する関数があるとします。その関数のテストは、摂氏の値が提供されたとき、その関数が正しい華氏の値を返すことを保証するかもしれません。この関数はユニットテストです。これは、コード内の1つのユニット(関数)をチェックします。" @@ -889,14 +897,14 @@ msgstr "上記の関数のユニットテスト例。このテストは、 **tes #: ../../tests/test-types.md:65 ../../tests/test-types.md:115 msgid "" -"image of puzzle pieces that all fit together nicely. The puzzle pieces " -"are colorful - purple, green and teal." +"image of puzzle pieces that all fit together nicely. The puzzle pieces are " +"colorful - purple, green and teal." msgstr "パズルのピースがうまく組み合わさったような画像です。パズルのピースは紫色、緑色、鴨の羽色とカラフルです。" #: ../../tests/test-types.md:69 msgid "" -"Your unit tests should ensure each part of your code works as expected on" -" its own." +"Your unit tests should ensure each part of your code works as expected on " +"its own." msgstr "ユニットテストでは、コードの各部分がそれ自体で期待通りに動作することを確認する必要があります。" #: ../../tests/test-types.md:72 @@ -905,35 +913,36 @@ msgstr "統合テスト" #: ../../tests/test-types.md:74 msgid "" -"Integration tests involve testing how parts of your package work together" -" or integrate. Integration tests can be compared to connecting a bunch of" -" puzzle pieces together to form a whole picture. Integration tests focus " -"on how different pieces of your code fit and work together." -msgstr "統合テストでは、パッケージの各パーツがどのように連動するか、あるいは統合されるかをテストします。統合テストは、パズルのピースをつなげて全体像を作るようなものです。統合テストは、コードのさまざまな部分がどのように適合し、連携して動作するかに焦点を当てます。" +"Integration tests involve testing how parts of your package work together or" +" integrate. Integration tests can be compared to connecting a bunch of " +"puzzle pieces together to form a whole picture. Integration tests focus on " +"how different pieces of your code fit and work together." +msgstr "" +"統合テストでは、パッケージの各パーツがどのように連動するか、あるいは統合されるかをテストします。統合テストは、パズルのピースをつなげて全体像を作るようなものです。統合テストは、コードのさまざまな部分がどのように適合し、連携して動作するかに焦点を当てます。" #: ../../tests/test-types.md:76 msgid "" -"For example, if you had a series of steps that collected temperature data" -" in a spreadsheet, converted it from degrees celsius to Fahrenheit and " -"then provided an average temperature for a particular time period. An " -"integration test would ensure that all parts of that workflow behaved as " -"expected." -msgstr "例えば、スプレッドシートに温度データを収集し、摂氏から華氏に変換し、特定の期間の平均温度を提供する一連のステップがあったとします。統合テストは、そのワークフローのすべての部分が期待通りに動作することを保証します。" +"For example, if you had a series of steps that collected temperature data in" +" a spreadsheet, converted it from degrees celsius to Fahrenheit and then " +"provided an average temperature for a particular time period. An integration" +" test would ensure that all parts of that workflow behaved as expected." +msgstr "" +"例えば、スプレッドシートに温度データを収集し、摂氏から華氏に変換し、特定の期間の平均温度を提供する一連のステップがあったとします。統合テストは、そのワークフローのすべての部分が期待通りに動作することを保証します。" #: ../../tests/test-types.md:107 msgid "" -"image of two puzzle pieces with some missing parts. The puzzle pieces are" -" purple teal yellow and blue. The shapes of each piece don’t fit " -"together." +"image of two puzzle pieces with some missing parts. The puzzle pieces are " +"purple teal yellow and blue. The shapes of each piece don’t fit together." msgstr "パズルのピースが2つあり、一部欠けている画像です。パズルのピースは紫・鴨の羽色・黄色・青色。 それぞれのピースの形が合いません。" #: ../../tests/test-types.md:112 msgid "" "If puzzle pieces have missing ends, they can’t work together with other " -"elements in the puzzle. The same is true with individual functions, " -"methods and classes in your software. The code needs to work both " -"individually and together to perform certain sets of tasks." -msgstr "パズルのピースの両端が欠けていると、パズルの他の要素と連動することができません。ソフトウェアの個々の関数、メソッド、クラスについても同様です。コードは、ある一連のタスクを実行するために、個々に、そして一緒に働く必要があります。" +"elements in the puzzle. The same is true with individual functions, methods " +"and classes in your software. The code needs to work both individually and " +"together to perform certain sets of tasks." +msgstr "" +"パズルのピースの両端が欠けていると、パズルの他の要素と連動することができません。ソフトウェアの個々の関数、メソッド、クラスについても同様です。コードは、ある一連のタスクを実行するために、個々に、そして一緒に働く必要があります。" #: ../../tests/test-types.md:120 msgid "" @@ -947,14 +956,14 @@ msgstr "エンドツーエンド(機能)テスト" #: ../../tests/test-types.md:126 msgid "" -"End-to-end tests (also referred to as functional tests) in Python are " -"like comprehensive checklists for your software. They simulate real user " -"end-to-end workflows to make sure the code base supports real life " -"applications and use-cases from start to finish. These tests help catch " -"issues that might not show up in smaller tests and ensure your entire " -"application or program behaves correctly. Think of them as a way to give " -"your software a final check before it's put into action, making sure it's" -" ready to deliver a smooth experience to its users." +"End-to-end tests (also referred to as functional tests) in Python are like " +"comprehensive checklists for your software. They simulate real user end-to-" +"end workflows to make sure the code base supports real life applications and" +" use-cases from start to finish. These tests help catch issues that might " +"not show up in smaller tests and ensure your entire application or program " +"behaves correctly. Think of them as a way to give your software a final " +"check before it's put into action, making sure it's ready to deliver a " +"smooth experience to its users." msgstr "" "Python " "におけるエンドツーエンドのテスト（機能テストとも呼ばれる）は、ソフトウェアの包括的なチェックリストのようなものです。実際のユーザーのエンドツーエンドのワークフローをシミュレートし、コードベースが実際のアプリケーションやユースケースを最初から最後までサポートすることを確認します。これらのテストは、小規模なテストでは表示されないかもしれない問題をキャッチし、アプリケーションやプログラム全体が正しく動作することを確認するのに役立ちます。ソフトウェアを実用化する前に最終チェックを行い、ユーザーにスムーズなエクスペリエンスを提供する準備ができていることを確認する方法だと考えてください。" @@ -965,23 +974,25 @@ msgstr "デイジーを描いたパズルの完成イメージ" #: ../../tests/test-types.md:133 msgid "" -"End-to-end or functional tests represent an entire workflow that you " -"expect your package to support." +"End-to-end or functional tests represent an entire workflow that you expect " +"your package to support." msgstr "エンドツーエンドテストまたは機能テストは、パッケージがサポートすることを期待するワークフロー全体を表します。" #: ../../tests/test-types.md:137 msgid "" "End-to-end test also test how a program runs from start to finish. A " -"tutorial that you add to your documentation that runs in CI in an " -"isolated environment is another example of an end-to-end test." -msgstr "エンドツーエンドのテストも、プログラムが最初から最後までどのように実行されるかをテストします。ドキュメントに追加するチュートリアルは、分離された環境のCIで実行され、エンドツーエンドのテストのもう一つの例です。" +"tutorial that you add to your documentation that runs in CI in an isolated " +"environment is another example of an end-to-end test." +msgstr "" +"エンドツーエンドのテストも、プログラムが最初から最後までどのように実行されるかをテストします。ドキュメントに追加するチュートリアルは、分離された環境のCIで実行され、エンドツーエンドのテストのもう一つの例です。" #: ../../tests/test-types.md:140 msgid "" "For scientific packages, creating short tutorials that highlight core " -"workflows that your package supports, that are run when your " -"documentation is built could also serve as end-to-end tests." -msgstr "科学的なパッケージの場合、パッケージがサポートする中核的なワークフローを強調する短いチュートリアルを作成し、ドキュメントのビルド時に実行することで、エンドツーエンドのテストを兼ねることができます。" +"workflows that your package supports, that are run when your documentation " +"is built could also serve as end-to-end tests." +msgstr "" +"科学的なパッケージの場合、パッケージがサポートする中核的なワークフローを強調する短いチュートリアルを作成し、ドキュメントのビルド時に実行することで、エンドツーエンドのテストを兼ねることができます。" #: ../../tests/test-types.md:143 msgid "Comparing unit, integration and end-to-end tests" @@ -1001,25 +1012,25 @@ msgstr "" #: ../../tests/test-types.md:147 msgid "" -"Integration and end-to-end tests verify that the different portions of " -"the program work together, but are less well-suited for isolating where " -"errors are occurring. For example, when you refactor your code, it is " -"possible that that your end-to-end tests will break. But if the refactor " -"didn't introduce new behavior to your existing code, then you can rely on" -" your unit tests to continue to pass, testing the original functionality " -"of your code." -msgstr "統合テストとエンドツーエンドテストは、プログラムのさまざまな部分が連携して動作することを検証しますが、どこでエラーが発生しているかを切り分けるにはあまり適していません。例えば、コードをリファクタリングすると、エンドツーエンドのテストが壊れる可能性があります。しかし、リファクタリングによって既存のコードに新しい動作が導入されなかったのであれば、コードの元の機能をテストするユニットテストがパスし続けることに頼ることができます。" +"Integration and end-to-end tests verify that the different portions of the " +"program work together, but are less well-suited for isolating where errors " +"are occurring. For example, when you refactor your code, it is possible that" +" that your end-to-end tests will break. But if the refactor didn't introduce" +" new behavior to your existing code, then you can rely on your unit tests to" +" continue to pass, testing the original functionality of your code." +msgstr "" +"統合テストとエンドツーエンドテストは、プログラムのさまざまな部分が連携して動作することを検証しますが、どこでエラーが発生しているかを切り分けるにはあまり適していません。例えば、コードをリファクタリングすると、エンドツーエンドのテストが壊れる可能性があります。しかし、リファクタリングによって既存のコードに新しい動作が導入されなかったのであれば、コードの元の機能をテストするユニットテストがパスし続けることに頼ることができます。" #: ../../tests/test-types.md:152 msgid "" -"It is important to note that you don't need to spend energy worrying " -"about the specifics surrounding the different types of tests. When you " -"begin to work on your test suite, consider what your package does and how" -" you may need to test parts of your package. Bring familiar with the " -"different types of tests can provides a framework to help you think about" -" writing tests and how different types of tests can complement each " -"other." -msgstr "重要なのは、さまざまな種類のテストにまつわる詳細について心配することにエネルギーを費やす必要はないということです。テストスイートの作成に取りかかるときには、パッケージが何をするのか、そしてパッケージの一部をどのようにテストする必要があるのかを考えてください。さまざまな種類のテストに慣れ親しむことは、テストの書き方や、さまざまな種類のテストが互いにどのように補完し合えるかを考える際のフレームワークとなります。" +"It is important to note that you don't need to spend energy worrying about " +"the specifics surrounding the different types of tests. When you begin to " +"work on your test suite, consider what your package does and how you may " +"need to test parts of your package. Bring familiar with the different types " +"of tests can provides a framework to help you think about writing tests and " +"how different types of tests can complement each other." +msgstr "" +"重要なのは、さまざまな種類のテストにまつわる詳細について心配することにエネルギーを費やす必要はないということです。テストスイートの作成に取りかかるときには、パッケージが何をするのか、そしてパッケージの一部をどのようにテストする必要があるのかを考えてください。さまざまな種類のテストに慣れ親しむことは、テストの書き方や、さまざまな種類のテストが互いにどのように補完し合えるかを考える際のフレームワークとなります。" #: ../../tests/tests-ci.md:1 msgid "Run tests with Continuous Integration" @@ -1027,24 +1038,23 @@ msgstr "継続的インテグレーションによるテストの実行" #: ../../tests/tests-ci.md:3 msgid "" -"Running your [test suite locally](run-tests) is useful as you develop " -"code and also test new features or changes to the code base. However, you" -" also will want to setup Continuous Integration (CI) to run your tests " -"online. CI allows you to run all of your tests in the cloud. While you " -"may only be able to run tests locally on a specific operating system, " -"using CI you can specify tests to run both on various versions of Python " -"and across different operating systems." +"Running your [test suite locally](run-tests) is useful as you develop code " +"and also test new features or changes to the code base. However, you also " +"will want to setup Continuous Integration (CI) to run your tests online. CI " +"allows you to run all of your tests in the cloud. While you may only be able" +" to run tests locally on a specific operating system, using CI you can " +"specify tests to run both on various versions of Python and across different" +" operating systems." msgstr "" "[テストスイートをローカルで実行する](run-tests) " "ことは、コードを開発したり、新しい機能やコード・ベースの変更をテストしたりするときに便利です。しかし、テストをオンラインで実行するために、継続的インテグレーション（CI）もセットアップしたいです。CIを使えば、すべてのテストをクラウド上で実行できます。特定のオペレーティングシステム上でしかローカルにテストを実行できないかもしれませんが、CIを使用すると、Pythonのさまざまなバージョンや異なるオペレーティングシステム間で実行するテストを指定できます。" #: ../../tests/tests-ci.md:5 msgid "" -"CI can also be triggered for pull requests and pushes to your repository." -" This means that every pull request that you, your maintainer team or a " -"contributor submit, can be tested. In the end CI testing ensures your " -"code continues to run as expected even as changes are made to the code " -"base." +"CI can also be triggered for pull requests and pushes to your repository. " +"This means that every pull request that you, your maintainer team or a " +"contributor submit, can be tested. In the end CI testing ensures your code " +"continues to run as expected even as changes are made to the code base." msgstr "" "CIは、プルリクエストやリポジトリへのプッシュをトリガーすることもできます。 " "これは、あなた、あなたのメンテナチーム、またはコントリビューターが提出するすべてのプルリクエストをテストできることを意味します。 " @@ -1052,8 +1062,8 @@ msgstr "" #: ../../tests/tests-ci.md:9 msgid "" -"Learn more about Continuous Integration and how it can be used, here. " -"(add link)" +"Learn more about Continuous Integration and how it can be used, here. (add " +"link)" msgstr "継続的インテグレーションとその使用方法については、こちらをご覧ください。 (リンクを追加)" #: ../../tests/tests-ci.md:13 @@ -1062,25 +1072,23 @@ msgstr "CIとプルリクエスト" #: ../../tests/tests-ci.md:15 msgid "" -"CI is invaluable if you have outside people contributing to your " -"software. You can setup CI to run on all pull requests submitted to your " -"repository. CI can make your repository more friendly to new potential " -"contributors. It allows users to contribute code, documentation fixes and" -" more without having to create development environments, run tests and " -"build documentation locally." +"CI is invaluable if you have outside people contributing to your software. " +"You can setup CI to run on all pull requests submitted to your repository. " +"CI can make your repository more friendly to new potential contributors. It " +"allows users to contribute code, documentation fixes and more without having" +" to create development environments, run tests and build documentation " +"locally." msgstr "" "CIは、外部の人があなたのソフトウェアに貢献している場合、非常に貴重です。 " "リポジトリに投稿されたすべてのプルリクエストに対してCIを実行するように設定できます。 " -"CIは、あなたのリポジトリを新しい将来の貢献者によりフレンドリーなものにします。 " +"CIは、あなたのリポジトリを新しい潜在的な貢献者によりフレンドリーなものにします。 " "開発環境の構築、テストの実行、ドキュメントのビルドをローカルで行うことなく、コードやドキュメントの修正などに貢献することができます。" #: ../../tests/tests-ci.md:22 -#, fuzzy msgid "Example GitHub Actions that runs tests" msgstr "テストを実行する GitHub Actionsの例" #: ../../tests/tests-ci.md:24 -#, fuzzy msgid "" "Below is an example GitHub Actions that runs tests using nox across both " "Windows, Mac and Linux and on Python versions 3.9-3.11." @@ -1090,8 +1098,8 @@ msgstr "" #: ../../tests/tests-ci.md:28 msgid "" -"To work properly, this file should be located in a root directory of your" -" GitHub repository:" +"To work properly, this file should be located in a root directory of your " +"GitHub repository:" msgstr "正しく動作させるには、このファイルをGitHubリポジトリのルートディレクトリに置く必要があります:" #: ../../tests/write-tests.md:1 @@ -1103,8 +1111,8 @@ msgid "" "Writing code that tests your package code, also known as test suites, is " "important for you as a maintainer, your users, and package contributors. " "Test suites consist of sets of functions, methods, and classes that are " -"written with the intention of making sure a specific part of your code " -"works as you expected it to." +"written with the intention of making sure a specific part of your code works" +" as you expected it to." msgstr "" "パッケージのコードをテストするコードを書くことは、テスト・スイートとしても知られています。 " "テスト・スイートは、関数、メソッド、クラスのセットで構成され、コードの特定の部分が期待通りに動作することを確認することを意図して書かれます。" @@ -1115,32 +1123,31 @@ msgstr "なぜパッケージのテストを書くのか？" #: ../../tests/write-tests.md:9 msgid "" -"Tests act as a safety net for code changes. They help you spot and " -"rectify bugs before they affect users. Tests also instill confidence that" -" code alterations from contributors won't breaking existing " -"functionality." +"Tests act as a safety net for code changes. They help you spot and rectify " +"bugs before they affect users. Tests also instill confidence that code " +"alterations from contributors won't breaking existing functionality." msgstr "" -"テストはコード変更のセーフティネットとして機能します。 バグがユーザーに影響を与える前に発見し、修正するのに役立ちます。 " +"テストはコード変更のセーフティネットとして機能する。 バグがユーザーに影響を与える前に発見し、修正するのに役立ちます。 " "テストはまた、貢献者によるコード改変が既存の機能を壊さないという確信を与えます。" #: ../../tests/write-tests.md:13 msgid "Writing tests for your Python package is important because:" -msgstr "Pythonパッケージのテストを書くことは重要です:" +msgstr "Pythonパッケージのテストを書くことは重要である:" #: ../../tests/write-tests.md:15 msgid "" -"**Catch Mistakes:** Tests are a safety net. When you make changes or add " -"new features to your package, tests can quickly tell you if you " -"accidentally broke something that was working fine before." +"**Catch Mistakes:** Tests are a safety net. When you make changes or add new" +" features to your package, tests can quickly tell you if you accidentally " +"broke something that was working fine before." msgstr "" "**キャッチミス:** " "テストはセーフティネットです。パッケージに変更を加えたり、新機能を追加したりした場合、テストによって、以前は問題なく動作していたものを誤って壊してしまったかどうかをすぐに知ることができます。" #: ../../tests/write-tests.md:16 msgid "" -"**Save Time:** Imagine you have a magic button that can automatically " -"check if your package is still working properly. Tests are like that " -"magic button! They can run all those checks for you saving you time." +"**Save Time:** Imagine you have a magic button that can automatically check " +"if your package is still working properly. Tests are like that magic button!" +" They can run all those checks for you saving you time." msgstr "" "**時間を節約する:** " "あなたのパッケージがまだ正常に動作しているかどうかを自動的にチェックできる魔法のボタンがあるとしましょう。テストは魔法のボタンのようなものです！ " @@ -1149,18 +1156,18 @@ msgstr "" #: ../../tests/write-tests.md:17 msgid "" "**Easier Collaboration:** If you're working with others, or have outside " -"contributors, tests help everyone stay on the same page. Your tests " -"explain how your package is supposed to work, making it easier for others" -" to understand and contribute to your project." +"contributors, tests help everyone stay on the same page. Your tests explain " +"how your package is supposed to work, making it easier for others to " +"understand and contribute to your project." msgstr "" "**より容易なコラボレーション:** " "他の人と一緒に仕事をしていたり、外部の協力者がいる場合、テストは全員が同じページにとどまるのに役立ちます。テストは、パッケージがどのように動作するかを説明し、他の人が理解しやすくし、プロジェクトに貢献しやすくします。" #: ../../tests/write-tests.md:18 msgid "" -"**Fearless Refactoring:** Refactoring means making improvements to your " -"code structure without changing its behavior. Tests empower you to make " -"these changes as if you break something, test failures will let you know." +"**Fearless Refactoring:** Refactoring means making improvements to your code" +" structure without changing its behavior. Tests empower you to make these " +"changes as if you break something, test failures will let you know." msgstr "" "**大胆不敵なリファクタリング:** リファクタリングとは、コードの振る舞いを変えることなく、コード構造を改善することです。 " "テストは、あなたが何かを壊した場合、テストの失敗があなたに知らせてくれるので、このような変更を行う力を与えてくれます。" @@ -1168,9 +1175,9 @@ msgstr "" #: ../../tests/write-tests.md:19 msgid "" "**Documentation:** Tests serve as technical examples of how to use your " -"package. This can be helpful for a new technical contributor that wants " -"to contribute code to your package. They can look at your tests to " -"understand how parts of your code functionality fits together." +"package. This can be helpful for a new technical contributor that wants to " +"contribute code to your package. They can look at your tests to understand " +"how parts of your code functionality fits together." msgstr "" "**文書化:** テストは、あなたのパッケージの使い方の技術的な例となります。 " "これは、あなたのパッケージにコードを提供しようとする新しい技術的貢献者にとって役に立ちます。 " @@ -1186,17 +1193,16 @@ msgstr "" "パッケージが進化するにつれて、テストは、時間の経過とともに変更を加えても、コードが期待通りに動作し続けることを保証します。こうして、テストを書くときに将来の自分を助けることになります。" #: ../../tests/write-tests.md:21 -#, fuzzy msgid "" "**Easier pull request reviews:** By running your tests in a CI framework " "such as GitHub Actions, each time you or a contributor makes a change to " "your code-base, you can catch issues and things that may have changed in " -"your code base. This ensures that your software behaves the way you " -"expect it to." +"your code base. This ensures that your software behaves the way you expect " +"it to." msgstr "" -"**より簡単なプルリクエストのレビュー:** GitHub actions のような CI " -"フレームワークでテストを実行することで、あなたや貢献者がコードベースに変更を加えるたびに、コードベースの問題や変更点をキャッチすることができます。" -" これにより、あなたのソフトウェアが期待通りに動作することが保証されます。" +"**より簡単なプルリクエストのレビュー:** GitHub Actionsのような CI " +"フレームワークでテストを実行することで、あなたや貢献者がコードベースに変更を加えるたびに、コードベースの問題や変更点をキャッチすることができます。 " +"これにより、あなたのソフトウェアが期待通りに動作することが保証されます。" #: ../../tests/write-tests.md:23 msgid "Tests for user edge cases" @@ -1204,12 +1210,12 @@ msgstr "ユーザーエッジケースのテスト" #: ../../tests/write-tests.md:25 msgid "" -"Edge cases refer to unexpected or \"outlier\" ways that some users may " -"use your package. Tests enable you to address various edge cases that " -"could impair your package's functionality. For example, what occurs if a " -"function expects a pandas `dataframe` but a user supplies a numpy " -"`array`? Does your code gracefully handle this situation, providing clear" -" feedback, or does it leave users frustrated by an unexplained failure?" +"Edge cases refer to unexpected or \"outlier\" ways that some users may use " +"your package. Tests enable you to address various edge cases that could " +"impair your package's functionality. For example, what occurs if a function " +"expects a pandas `dataframe` but a user supplies a numpy `array`? Does your " +"code gracefully handle this situation, providing clear feedback, or does it " +"leave users frustrated by an unexplained failure?" msgstr "" "エッジケースとは、あるユーザがあなたのパッケージを使用する際の、予期せぬ、あるいは \"外れ値\" の使い方を指します。 " "テストによって、パッケージの機能を損なう可能性のある様々なエッジケースに対処することができます。 例えば、ある関数がpandasの " @@ -1222,17 +1228,18 @@ msgid "" "lesson](https://swcarpentry.github.io/python-novice-" "inflammation/10-defensive.html)" msgstr "" -"テストの入門書としては、 [このSoftware Carpentryのレッスン](https://swcarpentry.github.io" -"/python-novice-inflammation/10-defensive.html) を参照してください。" +"テストの入門書としては、 [このSoftware " +"Carpentryのレッスン](https://swcarpentry.github.io/python-novice-" +"inflammation/10-defensive.html) を参照してください。" #: ../../tests/write-tests.md:41 msgid "" "Imagine you're working on a puzzle where each puzzle piece represents a " -"function, method, class or attribute in your Python package that you want" -" other people to be able to use. Would you want to give someone a puzzle " -"that has missing pieces or pieces that don't fit together? Providing " -"people with the right puzzle pieces that work together can be compared to" -" writing tests for your Python package." +"function, method, class or attribute in your Python package that you want " +"other people to be able to use. Would you want to give someone a puzzle that" +" has missing pieces or pieces that don't fit together? Providing people with" +" the right puzzle pieces that work together can be compared to writing tests" +" for your Python package." msgstr "" "パズルのピースが、あなたのPythonパッケージの関数、メソッド、クラス、属性を表しているとしましょう。 " "そしてあなたは他の人に使ってもらいたいと思っています。 ピースが欠けていたり、ピースが合わなかったりするパズルを誰かに渡したいと思いますか？ " @@ -1244,14 +1251,13 @@ msgstr "テスト例" #: ../../tests/write-tests.md:47 msgid "" -"Let’s say you have a Python function that adds two numbers a and b " -"together." +"Let’s say you have a Python function that adds two numbers a and b together." msgstr "例えば、2つの数値aとbを足し合わせるPython関数があるとしましょう。" #: ../../tests/write-tests.md:54 msgid "" -"A test to ensure that function runs as you might expect when provided " -"with different numbers might look like this:" +"A test to ensure that function runs as you might expect when provided with " +"different numbers might look like this:" msgstr "異なる数値が与えられたときに、その関数が期待通りに実行されることを確認するテストは次のようになります:" #: ../../tests/write-tests.md:72 @@ -1278,18 +1284,18 @@ msgstr "この時点で、あなたは疑問に思うかもしれません-あ #: ../../tests/write-tests.md:82 msgid "" -"**Test some typical cases:** Test that the package functions as you " -"expect it to when users use it. For instance, if your package is supposed" -" to add two numbers, test that the outcome value of adding those two " -"numbers is correct." +"**Test some typical cases:** Test that the package functions as you expect " +"it to when users use it. For instance, if your package is supposed to add " +"two numbers, test that the outcome value of adding those two numbers is " +"correct." msgstr "" "**いくつかの典型的なケースをテスト:** " -"パッケージが、ユーザーが使用したときに期待通りに機能することをテストします。例えば、パッケージが2つの数値を足すことになっている場合、その2つの数値を足した結果が正しいかどうかをテストします。" +"パッケージが、ユーザーが使用したときに期待通りに機能することをテストします。例えば、パッケージが2つの数値を足すことになっている場合、その2つの数値を足した結果が正しいかどうかをテストする。" #: ../../tests/write-tests.md:84 msgid "" -"**Test special cases:** Sometimes there are special or outlier cases. For" -" instance, if a function performs a specific calculation that may become " +"**Test special cases:** Sometimes there are special or outlier cases. For " +"instance, if a function performs a specific calculation that may become " "problematic closer to the value = 0, test it with the input of both 0 and" msgstr "" "**特別なケースをテストする:** " @@ -1297,21 +1303,20 @@ msgstr "" #: ../../tests/write-tests.md:86 msgid "" -"**Test at and near the expected boundaries:** If a function requires a " -"value that is greater than or equal to 1, make sure that the function " -"still works with both the values 1 and less than one and 1.001 as well " -"(something close to the constraint value).." +"**Test at and near the expected boundaries:** If a function requires a value" +" that is greater than or equal to 1, make sure that the function still works" +" with both the values 1 and less than one and 1.001 as well (something close" +" to the constraint value).." msgstr "" -"**予想される境界線とその付近でテストする:** 関数が1以上の値を必要とする場合、この関数が、1と1未満と1.001の両方の値 " -"(制約値に近い値) でも動作することを確認してください。" +"**予想される境界線とその付近でテストする:** 関数が1以上の値を必要とする場合、この関数が、1と1未満と1.001の両方の値 (制約値に近い値) " +"でも動作することを確認してください。" #: ../../tests/write-tests.md:88 msgid "" -"**Test that code fails correctly:** If a function requires a value " -"greater than or equal to 1, then test at 0.999. Make sure that the " -"function fails gracefully when given unexpected values and help and that " -"the user can easily understand why if failed (provides a useful error " -"message)." +"**Test that code fails correctly:** If a function requires a value greater " +"than or equal to 1, then test at 0.999. Make sure that the function fails " +"gracefully when given unexpected values and help and that the user can " +"easily understand why if failed (provides a useful error message)." msgstr "" "**コードが正しく失敗するかテストする** 関数が1以上の値を必要とする場合は、0.999でテストします。 " -"予期しない値やヘルプが与えられたときに、関数が差し障り無く失敗し、ユーザが失敗した理由を簡単に理解できるようにします(有用なエラーメッセージを提供します)。" +"予期しない値やヘルプが与えられたときに、関数が優雅に失敗し、ユーザが失敗した理由を簡単に理解できるようにします(有用なエラーメッセージを提供します)。" From 964576410a185d51e6ee91dd23071054a5a64070 Mon Sep 17 00:00:00 2001 From: Tetsuo Koyama Date: Sun, 20 Apr 2025 12:22:49 +0900 Subject: [PATCH 2/6] Fix format of test.po --- locales/ja/LC_MESSAGES/tests.po | 698 ++++++++++++++++---------------- 1 file changed, 352 insertions(+), 346 deletions(-) diff --git a/locales/ja/LC_MESSAGES/tests.po b/locales/ja/LC_MESSAGES/tests.po index 421ef3e8..e7235497 100644 --- a/locales/ja/LC_MESSAGES/tests.po +++ b/locales/ja/LC_MESSAGES/tests.po @@ -1,25 +1,27 @@ # SOME DESCRIPTIVE TITLE. # Copyright (C) 2025, pyOpenSci -# This file is distributed under the same license as the pyOpenSci Python Package Guide package. -# FIRST AUTHOR , YEAR. +# This file is distributed under the same license as the pyOpenSci Python +# Package Guide package. +# FIRST AUTHOR , 2025. # # Translators: # Tetsuo Koyama , 2025 -# #, fuzzy msgid "" msgstr "" "Project-Id-Version: pyOpenSci Python Package Guide\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-14 22:27+0900\n" +"POT-Creation-Date: 2025-04-20 11:32+0900\n" "PO-Revision-Date: 2025-04-14 18:12+0000\n" "Last-Translator: Tetsuo Koyama , 2025\n" -"Language-Team: Japanese (https://app.transifex.com/tkoyama010/teams/196662/ja/)\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=UTF-8\n" -"Content-Transfer-Encoding: 8bit\n" "Language: ja\n" +"Language-Team: Japanese " +"(https://app.transifex.com/tkoyama010/teams/196662/ja/)\n" "Plural-Forms: nplurals=1; plural=0;\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.17.0\n" #: ../../tests/code-cov.md:1 msgid "Code coverage for your Python package test suite" @@ -27,10 +29,10 @@ msgstr "Pythonパッケージのテストスイートのコードカバレッジ #: ../../tests/code-cov.md:3 msgid "" -"Code coverage measures how much of your package's code runs during testing. " -"Achieving high coverage can help ensure the reliability of your codebase, " -"but it’s not a guarantee of quality. Below, we outline key considerations " -"for using code coverage effectively." +"Code coverage measures how much of your package's code runs during " +"testing. Achieving high coverage can help ensure the reliability of your " +"codebase, but it’s not a guarantee of quality. Below, we outline key " +"considerations for using code coverage effectively." msgstr "" "コードカバレッジは、テスト中にパッケージのコードがどれだけ実行されるかを測定します。 " "高いカバレッジを達成することは、コードベースの信頼性を確保するのに役立ちますが、品質を保証するものではありません。 " @@ -42,8 +44,8 @@ msgstr "なぜ高いコードカバレッジを目指すのか？" #: ../../tests/code-cov.md:10 msgid "" -"A good practice is to ensure that every line of your code runs at least once" -" during your test suite. This helps you:" +"A good practice is to ensure that every line of your code runs at least " +"once during your test suite. This helps you:" msgstr "良い習慣は、テストスイートの間に、コードのすべての行が少なくとも一度は実行されるようにすることです。これはあなたを助けます:" #: ../../tests/code-cov.md:13 @@ -68,14 +70,14 @@ msgstr "高いコードカバレッジは価値がありますが、それには #: ../../tests/code-cov.md:21 msgid "" -"**Difficult-to-test code:** Some parts of your code might be challenging to " -"test, either due to complexity or limited resources." +"**Difficult-to-test code:** Some parts of your code might be challenging " +"to test, either due to complexity or limited resources." msgstr "**テストしにくいコード:** コードの中には、複雑さや限られたリソースのために、テストが難しい部分があるかもしれません。" #: ../../tests/code-cov.md:23 msgid "" -"**Missed edge cases:** Running all lines of code doesn’t guarantee that edge" -" cases are handled correctly." +"**Missed edge cases:** Running all lines of code doesn’t guarantee that " +"edge cases are handled correctly." msgstr "**見逃されたエッジケース:** すべてのコードを実行しても、エッジケースが正しく処理される保証はありません。" #: ../../tests/code-cov.md:26 @@ -91,23 +93,26 @@ msgstr "Pythonパッケージのコードカバレッジを分析するツール #: ../../tests/code-cov.md:31 msgid "" "Some common services for analyzing code coverage are " -"[codecov.io](https://codecov.io/) and [coveralls.io](https://coveralls.io/)." -" These projects are free for open source tools and will provide dashboards " -"that tell you how much of your codebase is covered during your tests. We " -"recommend setting up an account (on either CodeCov or Coveralls) and using " -"it to keep track of your code coverage." +"[codecov.io](https://codecov.io/) and " +"[coveralls.io](https://coveralls.io/). These projects are free for open " +"source tools and will provide dashboards that tell you how much of your " +"codebase is covered during your tests. We recommend setting up an account" +" (on either CodeCov or Coveralls) and using it to keep track of your code" +" coverage." msgstr "" "コードカバレッジを分析するための一般的なサービスには、 [codecov.io](https://codecov.io/) と " "[coveralls.io](https://coveralls.io/) があります。 " -"これらのプロジェクトはオープンソースのツールで無料であり、テスト中にコードベースがどの程度カバーされているかを示すダッシュボードを提供してくれます。 " -"(CodeCovまたはCoverallsで) アカウントを設定し、コード・カバレッジを追跡するために使用することをお勧めします。" +"これらのプロジェクトはオープンソースのツールで無料であり、テスト中にコードベースがどの程度カバーされているかを示すダッシュボードを提供してくれます。" +" (CodeCovまたはCoverallsで) アカウントを設定し、コード・カバレッジを追跡するために使用することをお勧めします。" #: ../../tests/code-cov.md:33 +#, python-format msgid "" -"Screenshot of the code cov service - showing test coverage for the stravalib" -" package. This image shows a list of package modules and the associated " -"number of lines and % lines covered by tests. At the top of the image, you " -"can see what branch is being evaluated and the path to the repository." +"Screenshot of the code cov service - showing test coverage for the " +"stravalib package. This image shows a list of package modules and the " +"associated number of lines and % lines covered by tests. At the top of " +"the image, you can see what branch is being evaluated and the path to the" +" repository." msgstr "" "code covサービスのスクリーンショット - stravalibパッケージのテストカバレッジを示します。 " "この画像は、パッケージモジュールのリストと、関連する行数およびテスト対象行の割合を示しています。 " @@ -116,12 +121,12 @@ msgstr "" #: ../../tests/code-cov.md:38 msgid "" "The CodeCov platform is a useful tool if you wish to track code coverage " -"visually. Using it, you can not only get the same summary information that " -"you can get with the **pytest-cov** extension. You can also see what lines " -"are covered by your tests and which are not. Code coverage is useful for " -"evaluating unit tests and/or how much of your package code is \"covered\". " -"It, however, will not evaluate things like integration tests and end-to-end " -"workflows." +"visually. Using it, you can not only get the same summary information " +"that you can get with the **pytest-cov** extension. You can also see what" +" lines are covered by your tests and which are not. Code coverage is " +"useful for evaluating unit tests and/or how much of your package code is " +"\"covered\". It, however, will not evaluate things like integration tests" +" and end-to-end workflows." msgstr "" "CodeCovプラットフォームは、コードカバレッジを視覚的に追跡したい場合に便利なツールです。これを使えば、 **pytest-cov** " "拡張機能で得られるのと同じサマリー情報を得られるだけではありません。また、テストの対象になっているラインとそうでないラインを確認することもできます。コードカバレッジは、単体テストの評価や、パッケージのコードがどれだけ" @@ -141,10 +146,10 @@ msgstr "ローカルカバレッジレポートのエクスポート" #: ../../tests/code-cov.md:49 msgid "" -"In addition to using services like CodeCov or Coveralls, you can generate " -"local coverage reports directly using the **coverage.py** tool. This can be " -"especially useful if you want to create reports in Markdown or HTML format " -"for offline use or documentation." +"In addition to using services like CodeCov or Coveralls, you can generate" +" local coverage reports directly using the **coverage.py** tool. This can" +" be especially useful if you want to create reports in Markdown or HTML " +"format for offline use or documentation." msgstr "" "CodeCovやCoverallsのようなサービスを利用するだけでなく、 **coverage.py** " "ツールを使って直接ローカルカバレッジレポートを作成することもできます。 " @@ -156,10 +161,9 @@ msgstr "カバレッジレポートを **Markdown** 形式で作成するには #: ../../tests/code-cov.md:56 msgid "" -"This command will produce a Markdown-formatted coverage summary that you can" -" easily include in project documentation or share with your team." -msgstr "" -"このコマンドはMarkdown形式のカバレッジサマリーを作成し、プロジェクトのドキュメントに簡単に記載したり、チームと共有したりすることができます。" +"This command will produce a Markdown-formatted coverage summary that you " +"can easily include in project documentation or share with your team." +msgstr "このコマンドはMarkdown形式のカバレッジサマリーを作成し、プロジェクトのドキュメントに簡単に記載したり、チームと共有したりすることができます。" #: ../../tests/code-cov.md:58 msgid "" @@ -170,15 +174,14 @@ msgstr "どの行がカバーされているか、詳細でインタラクティ #: ../../tests/code-cov.md:64 msgid "" "The generated HTML report will be saved in a directory named htmlcov by " -"default. Open the index.html file in your browser to explore your coverage " -"results." -msgstr "" -"生成されたHTMLレポートは、デフォルトでhtmlcovというディレクトリに保存されます。index.htmlファイルをブラウザで開き、カバレッジ結果をご覧ください。" +"default. Open the index.html file in your browser to explore your " +"coverage results." +msgstr "生成されたHTMLレポートは、デフォルトでhtmlcovというディレクトリに保存されます。index.htmlファイルをブラウザで開き、カバレッジ結果をご覧ください。" #: ../../tests/code-cov.md:66 msgid "" -"These local reports are an excellent way to quickly review coverage without " -"setting up an external service." +"These local reports are an excellent way to quickly review coverage " +"without setting up an external service." msgstr "このようなローカルレポートは、外部サービスを立ち上げることなくカバレッジを素早く確認する優れた方法です。" #: ../../tests/index.md:73 @@ -215,18 +218,18 @@ msgstr "Pythonパッケージのテストとデータ" #: ../../tests/index.md:4 msgid "" -"Tests are an important part of your Python package because they provide a " -"set of checks that ensure that your package is functioning how you expect it" -" to." +"Tests are an important part of your Python package because they provide a" +" set of checks that ensure that your package is functioning how you " +"expect it to." msgstr "" "テストは Python " "パッケージの重要な一部です。なぜなら、テストはパッケージが期待通りに動作しているかどうかを確認するための一連のチェック機能を提供するからです。" #: ../../tests/index.md:8 msgid "" -"In this section, you will learn more about the importance of writing tests " -"for your Python package and how you can set up infrastructure to run your " -"tests both locally and on GitHub." +"In this section, you will learn more about the importance of writing " +"tests for your Python package and how you can set up infrastructure to " +"run your tests both locally and on GitHub." msgstr "" "このセクションでは、Python パッケージのテストを書くことの重要性と、ローカルと GitHub " "の両方でテストを実行するためのインフラストラクチャの設定方法について学びます。" @@ -250,9 +253,9 @@ msgstr "✨テストの種類✨" #: ../../tests/index.md:37 msgid "" -"There are three general types of tests that you can write for your Python " -"package: unit tests, integration tests and end-to-end (or functional) tests." -" Learn about all three." +"There are three general types of tests that you can write for your Python" +" package: unit tests, integration tests and end-to-end (or functional) " +"tests. Learn about all three." msgstr "" "Python パッケージで書くことのできるテストには、ユニットテスト、統合テスト、エンドツーエンドテスト (あるいは機能テスト) の 3 " "種類があります。 この 3 つについて学びましょう。" @@ -263,8 +266,8 @@ msgstr "✨ローカルでテストを実行する✨" #: ../../tests/index.md:48 msgid "" -"If you expect your users to use your package across different versions of " -"Python, then using an automation tool such as nox to run your tests is " +"If you expect your users to use your package across different versions of" +" Python, then using an automation tool such as nox to run your tests is " "useful. Learn about the various tools that you can use to run your tests " "across python versions here." msgstr "" @@ -278,8 +281,8 @@ msgstr "✨オンラインでテストを実行する(CIを使用する)✨" #: ../../tests/index.md:59 msgid "" -"Continuous integration platforms such as GitHub Actions can be useful for " -"running your tests across both different Python versions and different " +"Continuous integration platforms such as GitHub Actions can be useful for" +" running your tests across both different Python versions and different " "operating systems. Learn about setting up tests to run in Continuous " "Integration here." msgstr "" @@ -297,11 +300,11 @@ msgstr "Pythonパッケージテストの実行" #: ../../tests/run-tests.md:8 msgid "" -"Running your tests is important to ensure that your package is working as " -"expected. It's good practice to consider that tests will run on your " -"computer and your users' computers that may be running a different Python " -"version and operating systems. Think about the following when running your " -"tests:" +"Running your tests is important to ensure that your package is working as" +" expected. It's good practice to consider that tests will run on your " +"computer and your users' computers that may be running a different Python" +" version and operating systems. Think about the following when running " +"your tests:" msgstr "" "テストを実行することは、パッケージが期待通りに動作していることを確認するために重要です。 テストは、あなたのコンピュータと、Python " "のバージョンやオペレーティングシステムが異なるユーザのコンピュータで実行されることを考慮するのがよい習慣です。 " @@ -309,51 +312,54 @@ msgstr "" #: ../../tests/run-tests.md:11 msgid "" -"Run your test suite in a matrix of environments that represent the Python " -"versions and operating systems your users are likely to have." +"Run your test suite in a matrix of environments that represent the Python" +" versions and operating systems your users are likely to have." msgstr "テストスイートは、Python のバージョンとユーザーが使用する可能性のあるオペレーティングシステムを表す環境のマトリックスで実行します。" #: ../../tests/run-tests.md:12 msgid "" "Running your tests in an isolated environment provides confidence in the " "tests and their reproducibility. This ensures that tests do not pass " -"randomly due to your computer's specific setup. For instance, you might have" -" unexpectedly installed dependencies on your local system that are not " -"declared in your package's dependency list. This oversight could lead to " -"issues when others try to install or run your package on their computers." +"randomly due to your computer's specific setup. For instance, you might " +"have unexpectedly installed dependencies on your local system that are " +"not declared in your package's dependency list. This oversight could lead" +" to issues when others try to install or run your package on their " +"computers." msgstr "" "隔離された環境でテストを実行することで、テストとその再現性に自信を持つことができます。 " "これにより、あなたのコンピュータの設定によってテストがランダムにパスすることがなくなります。 " "たとえば、あなたのパッケージの依存関係リストで宣言されていない依存関係を、予期せずローカルシステムにインストールしてしまったかもしれません。 " -"このような見落としは、他の人があなたのパッケージを自分のコン ピュータにインストールしたり実行しようとしたときに、問題につながる可能性 があります。" +"このような見落としは、他の人があなたのパッケージを自分のコン ピュータにインストールしたり実行しようとしたときに、問題につながる可能性 " +"があります。" #: ../../tests/run-tests.md:14 msgid "" -"On this page, you will learn about the tools that you can use to both run " -"tests in isolated environments and across Python versions." -msgstr "" -"このページでは、隔離された環境でテストを実行したり、Python のバージョンを越えてテストを実行したりするために使えるツールについて学びます。" +"On this page, you will learn about the tools that you can use to both run" +" tests in isolated environments and across Python versions." +msgstr "このページでは、隔離された環境でテストを実行したり、Python のバージョンを越えてテストを実行したりするために使えるツールについて学びます。" #: ../../tests/run-tests.md:19 +#, fuzzy msgid "Tools to run your tests" msgstr "テストを実行するためのツール" #: ../../tests/run-tests.md:21 msgid "" -"There are three categories of tools that will make is easier to setup and " -"run your tests in various environments:" +"There are three categories of tools that will make is easier to setup and" +" run your tests in various environments:" msgstr "さまざまな環境でのテストのセットアップと実行を容易にするツールには、3つのカテゴリーがあります:" #: ../../tests/run-tests.md:24 msgid "" -"A **test framework**, is a package that provides a particular syntax and set" -" of tools for _both writing and running your tests_. Some test frameworks " -"also have plugins that add additional features such as evaluating how much " -"of your code the tests cover. Below you will learn about the **pytest** " -"framework which is one of the most commonly used Python testing frameworks " -"in the scientific ecosystem. Testing frameworks are essential but they only " -"serve to run your tests. These frameworks don't provide a way to easily run " -"tests across Python versions without the aid of additional automation tools." +"A **test framework**, is a package that provides a particular syntax and " +"set of tools for _both writing and running your tests_. Some test " +"frameworks also have plugins that add additional features such as " +"evaluating how much of your code the tests cover. Below you will learn " +"about the **pytest** framework which is one of the most commonly used " +"Python testing frameworks in the scientific ecosystem. Testing frameworks" +" are essential but they only serve to run your tests. These frameworks " +"don't provide a way to easily run tests across Python versions without " +"the aid of additional automation tools." msgstr "" "**テストフレームワーク** とは、テストを書いたり実行したりするための特定の構文やツールのセットを提供するパッケージのことです。 " "いくつかのテストフレームワークにはプラグインがあり、テストがカバーするコードの範囲を評価するなどの機能を追加することができます。 " @@ -363,27 +369,29 @@ msgstr "" #: ../../tests/run-tests.md:25 msgid "" -"**Automation tools** allow you to automate running workflows such as tests " -"in specific ways using user-defined commands. For instance it's useful to be" -" able to run tests across different Python versions with a single command. " -"Tools such as [**nox**](https://nox.thea.codes/en/stable/index.html) and " -"[**tox**](https://tox.wiki/en/latest/index.html) also allow you to run tests" -" across Python versions. However, it will be difficult to test your build on" -" different operating systems using only nox and tox - this is where " -"continuous integration (CI) comes into play." +"**Automation tools** allow you to automate running workflows such as " +"tests in specific ways using user-defined commands. For instance it's " +"useful to be able to run tests across different Python versions with a " +"single command. Tools such as " +"[**nox**](https://nox.thea.codes/en/stable/index.html) and " +"[**tox**](https://tox.wiki/en/latest/index.html) also allow you to run " +"tests across Python versions. However, it will be difficult to test your " +"build on different operating systems using only nox and tox - this is " +"where continuous integration (CI) comes into play." msgstr "" "**自動化ツール** を使うと、ユーザー定義のコマンドを使って、テストのようなワークフローを特定の方法で実行することを自動化できます。 " "例えば、1つのコマンドで異なるPythonのバージョンにまたがってテストを実行できると便利です。 " "[**nox**](https://nox.thea.codes/en/stable/index.html) や " "[**tox**](https://tox.wiki/en/latest/index.html) " "のようなツールも、Pythonのバージョンをまたいでテストを実行できます。 " -"しかし、noxとtoxだけを使って異なるオペレーティングシステムでビルドをテストするのは難しいでしょう - 継続的インテグレーション(CI)の出番です。" +"しかし、noxとtoxだけを使って異なるオペレーティングシステムでビルドをテストするのは難しいでしょう - " +"継続的インテグレーション(CI)の出番です。" #: ../../tests/run-tests.md:26 msgid "" -"**Continuous Integration (CI):** is the last tool that you'll need to run " -"your tests. CI will not only allow you to replicate any automated builds you" -" create using nox or tox to run your package in different Python " +"**Continuous Integration (CI):** is the last tool that you'll need to run" +" your tests. CI will not only allow you to replicate any automated builds" +" you create using nox or tox to run your package in different Python " "environments. It will also allow you to run your tests on different " "operating systems (Windows, Mac and Linux). [We discuss using CI to run " "tests here](tests-ci)." @@ -466,16 +474,16 @@ msgstr "テストを実行するには、どのテストフレームワーク/ #: ../../tests/run-tests.md:75 msgid "" -"We recommend using `Pytest` to build and run your package tests. Pytest is " -"the most common testing tool used in the Python ecosystem." +"We recommend using `Pytest` to build and run your package tests. Pytest " +"is the most common testing tool used in the Python ecosystem." msgstr "" "パッケージテストのビルドと実行には `Pytest` を使うことを推奨します。 Pytest は Python " "のエコシステムで最もよく使われているテストツールです。" #: ../../tests/run-tests.md:77 msgid "" -"[The Pytest package](https://docs.pytest.org/en/latest/) also has a number " -"of extensions that can be used to add functionality such as:" +"[The Pytest package](https://docs.pytest.org/en/latest/) also has a " +"number of extensions that can be used to add functionality such as:" msgstr "" "[Pytestパッケージ](https://docs.pytest.org/en/latest/) " "には、以下のような機能を追加するために使用できる多くの拡張機能もあります：" @@ -483,8 +491,8 @@ msgstr "" #: ../../tests/run-tests.md:80 msgid "" "[pytest-cov](https://pytest-cov.readthedocs.io/en/latest/) allows you to " -"analyze the code coverage of your package during your tests, and generates a" -" report that you can [upload to codecov](https://codecov.io/)." +"analyze the code coverage of your package during your tests, and " +"generates a report that you can [upload to codecov](https://codecov.io/)." msgstr "" "[pytest-cov](https://pytest-cov.readthedocs.io/en/latest/) " "を使うと、テスト中にパッケージのコードカバレッジを分析し、 [codecov](https://codecov.io/) " @@ -501,9 +509,9 @@ msgstr "コードカバレッジについてはこちらをご覧ください。 #: ../../tests/run-tests.md:87 msgid "" -"Your editor or IDE may add additional convenience for running tests, setting" -" breakpoints, and toggling the `–no-cov` flag. Check your editor's " -"documentation for more information." +"Your editor or IDE may add additional convenience for running tests, " +"setting breakpoints, and toggling the `–no-cov` flag. Check your editor's" +" documentation for more information." msgstr "" "お使いのエディタや IDE には、テストを実行したり、ブレークポイントを設定したり、 `-no-cov` " "フラグを切り替えたりするための便利な機能が追加されているかもしれません。 詳しくはエディタのドキュメントを参照してください。" @@ -513,8 +521,7 @@ msgid "Run tests using pytest" msgstr "pytest を使ってテストを実行する" #: ../../tests/run-tests.md:92 -msgid "" -"If you are using **pytest**, you can run your tests locally by calling:" +msgid "If you are using **pytest**, you can run your tests locally by calling:" msgstr "**pytest** を使用している場合、テストをローカルで実行することができます:" #: ../../tests/run-tests.md:95 @@ -526,7 +533,8 @@ msgid "" "Or if you want to run a specific test file - let's call this file " "\"`test_module.py`\" - you can run:" msgstr "" -"また、特定のテストファイル - このファイルを \"`test_module.py`\" と呼ぶことにします - を実行したい場合は、次のようにします:" +"また、特定のテストファイル - このファイルを \"`test_module.py`\" と呼ぶことにします - " +"を実行したい場合は、次のようにします:" #: ../../tests/run-tests.md:99 msgid "`pytest test_module.py`" @@ -534,18 +542,18 @@ msgstr "`pytest test_module.py`" #: ../../tests/run-tests.md:101 msgid "" -"Learn more from the [get started " -"docs](https://docs.pytest.org/en/7.1.x/getting-started.html)." +"Learn more from the [get started docs](https://docs.pytest.org/en/7.1.x" +"/getting-started.html)." msgstr "" -"詳しくは [ドキュメントスタートガイド](https://docs.pytest.org/en/7.1.x/getting-started.html) " -"をご覧ください。" +"詳しくは [ドキュメントスタートガイド](https://docs.pytest.org/en/7.1.x/getting-" +"started.html) をご覧ください。" #: ../../tests/run-tests.md:103 msgid "" "Running pytest on your computer is going to run your tests in whatever " -"Python environment you currently have activated. This means that tests will " -"be run on a single version of Python and only on the operating system that " -"you are running locally." +"Python environment you currently have activated. This means that tests " +"will be run on a single version of Python and only on the operating " +"system that you are running locally." msgstr "" "あなたのコンピュータで pytest を実行すると、現在有効になっている Python 環境でテストが実行されます。 " "つまり、テストは単一のバージョンのPythonで、ローカルで実行しているオペレーティングシステム上でのみ実行されます。" @@ -574,23 +582,23 @@ msgstr "テストの実行を自動化するツール" #: ../../tests/run-tests.md:117 msgid "" -"To run tests on various Python versions or in various specific environments " -"with a single command, you can use an automation tool such as `nox` or " -"`tox`. Both `nox` and `tox` can create an isolated virtual environments. " -"This allows you to easily run your tests in multiple environments and across" -" Python versions." +"To run tests on various Python versions or in various specific " +"environments with a single command, you can use an automation tool such " +"as `nox` or `tox`. Both `nox` and `tox` can create an isolated virtual " +"environments. This allows you to easily run your tests in multiple " +"environments and across Python versions." msgstr "" "一つのコマンドで様々な Python のバージョンや特定の環境でテストを実行するには、 `nox` や `tox` " -"のような自動化ツールを使うことができます。 `nox` も `tox` も、隔離された仮想環境を作成することができます。 これにより、複数の環境や " -"Python のバージョン間でテストを簡単に実行することができます。" +"のような自動化ツールを使うことができます。 `nox` も `tox` も、隔離された仮想環境を作成することができます。 これにより、複数の環境や" +" Python のバージョン間でテストを簡単に実行することができます。" #: ../../tests/run-tests.md:120 msgid "" -"We will focus on [Nox](https://nox.thea.codes/) in this guide. `nox` is a " -"Python-based automation tool that builds upon the features of both `make` " -"and `tox`. `nox` is designed to simplify and streamline testing and " -"development workflows. Everything that you do with `nox` can be implemented " -"using a Python-based interface." +"We will focus on [Nox](https://nox.thea.codes/) in this guide. `nox` is a" +" Python-based automation tool that builds upon the features of both " +"`make` and `tox`. `nox` is designed to simplify and streamline testing " +"and development workflows. Everything that you do with `nox` can be " +"implemented using a Python-based interface." msgstr "" "このガイドでは、 [Nox](https://nox.thea.codes/) に焦点を当てます。 `nox` は Python " "ベースの自動化ツールで、 `make` と `tox` の機能をベースにしています。 `nox` " @@ -604,36 +612,36 @@ msgstr "その他の自動化ツール" #: ../../tests/run-tests.md:125 msgid "" "**[Tox](https://tox.wiki/en/latest/index.html#useful-links)** is an " -"automation tool that supports common steps such as building documentation, " -"running tests across various versions of Python, and more." +"automation tool that supports common steps such as building " +"documentation, running tests across various versions of Python, and more." msgstr "" "**[Tox](https://tox.wiki/en/latest/index.html#useful-links)** " "は自動化ツールで、ドキュメントのビルドや、Pythonの様々なバージョン間でのテストの実行など、一般的なステップをサポートしています。" #: ../../tests/run-tests.md:127 msgid "" -"**[Hatch](https://github.com/ofek/hatch)** is a modern end-to-end packaging " -"tool that works with the popular build backend called hatchling. `hatch` " -"offers a `tox`-like setup where you can run tests locally using different " -"Python versions. If you are using `hatch` to support your packaging " -"workflow, you may want to also use its testing capabilities rather than " -"using `nox`." +"**[Hatch](https://github.com/ofek/hatch)** is a modern end-to-end " +"packaging tool that works with the popular build backend called " +"hatchling. `hatch` offers a `tox`-like setup where you can run tests " +"locally using different Python versions. If you are using `hatch` to " +"support your packaging workflow, you may want to also use its testing " +"capabilities rather than using `nox`." msgstr "" "**[Hatch](https://github.com/ofek/hatch)** " -"は、hatchlingと呼ばれる人気のあるビルドバックエンドで動作する最新のエンドツーエンドパッケージングツールです。 `hatch` は `tox`" -" のようなセットアップを提供し、異なる Python バージョンを使ってローカルでテストを実行することができます。 " +"は、hatchlingと呼ばれる人気のあるビルドバックエンドで動作する最新のエンドツーエンドパッケージングツールです。 `hatch` は " +"`tox` のようなセットアップを提供し、異なる Python バージョンを使ってローカルでテストを実行することができます。 " "パッケージングのワークフローをサポートするために `hatch` を使っているのであれば、 `nox` を使うよりも `hatch` " "のテスト機能を使った方が良いかもしれない。" #: ../../tests/run-tests.md:129 msgid "" "[**make:**](https://www.gnu.org/software/make/manual/make.html) Some " -"developers use Make, which is a build automation tool, for running tests due" -" to its versatility; it's not tied to a specific language and can be used to" -" run various build processes. However, Make's unique syntax and approach can" -" make it more challenging to learn, particularly if you're not already " -"familiar with it. Make also won't manage environments for you like **nox** " -"will do." +"developers use Make, which is a build automation tool, for running tests " +"due to its versatility; it's not tied to a specific language and can be " +"used to run various build processes. However, Make's unique syntax and " +"approach can make it more challenging to learn, particularly if you're " +"not already familiar with it. Make also won't manage environments for you" +" like **nox** will do." msgstr "" "[**make:**](https://www.gnu.org/software/make/manual/make.html) " "ビルド自動化ツールであるMakeは汎用性が高いため、テストの実行に使う開発者もいます; " @@ -658,9 +666,9 @@ msgstr "ワークフローを実行するための隔離された環境を構築 #: ../../tests/run-tests.md:143 msgid "" -"`nox` simplifies creating and managing testing environments. With `nox`, you" -" can set up virtual environments, and run tests across Python versions using" -" the environment manager of your choice with a single command." +"`nox` simplifies creating and managing testing environments. With `nox`, " +"you can set up virtual environments, and run tests across Python versions" +" using the environment manager of your choice with a single command." msgstr "" "`nox` はテスト環境の作成と管理を簡単にします。 `nox` を使うと、仮想環境をセットアップし、好きな環境マネージャを使って Python " "のバージョンをまたいだテストをコマンド一つで実行することができます。" @@ -671,12 +679,12 @@ msgstr "Noxのインストール" #: ../../tests/run-tests.md:150 msgid "" -"When you install and use nox to run tests across different Python versions, " -"nox will create and manage individual `venv` environments for each Python " -"version that you specify in the nox function." +"When you install and use nox to run tests across different Python " +"versions, nox will create and manage individual `venv` environments for " +"each Python version that you specify in the nox function." msgstr "" -"異なる Python バージョン間でテストを実行するために nox をインストールして使用する場合、nox は nox 関数で指定した Python " -"バージョンごとに個別の `venv` 環境を作成して管理します。" +"異なる Python バージョン間でテストを実行するために nox をインストールして使用する場合、nox は nox 関数で指定した " +"Python バージョンごとに個別の `venv` 環境を作成して管理します。" #: ../../tests/run-tests.md:152 msgid "Nox will manage each environment on its own." @@ -685,18 +693,18 @@ msgstr "Noxはそれぞれの環境を独自に管理します。" #: ../../tests/run-tests.md:154 msgid "" "Nox can also be used for other development tasks such as building " -"documentation, creating your package distribution, and testing installations" -" across both PyPI related environments (e.g. venv, virtualenv) and `conda` " -"(e.g. `conda-forge`)." +"documentation, creating your package distribution, and testing " +"installations across both PyPI related environments (e.g. venv, " +"virtualenv) and `conda` (e.g. `conda-forge`)." msgstr "" "nox は、ドキュメントのビルド、パッケージ配布の作成、PyPI 関連の環境 (venv や virtualenv など) と `conda` " "(conda-forge` など) の両方にわたるインストールのテストなど、その他の開発作業にも使用できます。" #: ../../tests/run-tests.md:158 msgid "" -"To get started with nox, you create a `noxfile.py` file at the root of your " -"project directory. You then define commands using Python functions. Some " -"examples of that are below." +"To get started with nox, you create a `noxfile.py` file at the root of " +"your project directory. You then define commands using Python functions. " +"Some examples of that are below." msgstr "" "noxを使い始めるには、プロジェクトディレクトリのルートに `noxfile.py` ファイルを作成します。 " "そして、Pythonの関数を使ってコマンドを定義します。 以下にその例をいくつか挙ます。" @@ -709,10 +717,10 @@ msgstr "テスト環境" msgid "" "By default, `nox` uses the Python built in `venv` environment manager. A " "virtual environment (`venv`) is a self-contained Python environment that " -"allows you to isolate and manage dependencies for different Python projects." -" It helps ensure that project-specific libraries and packages do not " -"interfere with each other, promoting a clean and organized development " -"environment." +"allows you to isolate and manage dependencies for different Python " +"projects. It helps ensure that project-specific libraries and packages do" +" not interfere with each other, promoting a clean and organized " +"development environment." msgstr "" "デフォルトでは、 `nox` は Python 組み込みの `venv` 環境マネージャを使用する。 仮想環境 (`venv`) は自己完結型の " "Python 環境で、異なる Python プロジェクトの依存関係を分離して管理することができます。 " @@ -738,44 +746,43 @@ msgstr "venv環境のnox" #: ../../tests/run-tests.md:175 msgid "" -"TODO: add some tests above and show what the output would look like in the " -"examples below..." +"TODO: add some tests above and show what the output would look like in " +"the examples below..." msgstr "TODO: 上記のテストをいくつか追加し、以下の例で出力がどのようになるかを示す..." #: ../../tests/run-tests.md:178 msgid "" -"Below is an example of setting up nox to run tests using `venv` which is the" -" built in environment manager that comes with base Python." -msgstr "" -"以下は、Pythonに組み込まれている環境マネージャーである `venv` を使ってテストを実行するようにnoxをセットアップする例である。" +"Below is an example of setting up nox to run tests using `venv` which is " +"the built in environment manager that comes with base Python." +msgstr "以下は、Pythonに組み込まれている環境マネージャーである `venv` を使ってテストを実行するようにnoxをセットアップする例である。" #: ../../tests/run-tests.md:180 msgid "" "Note that the example below assumes that you have [setup your " "`pyproject.toml` to declare test dependencies in a way that pip can " -"understand](../package-structure-code/declare-dependencies.md). An example " -"of that setup is below." +"understand](../package-structure-code/declare-dependencies.md). An " +"example of that setup is below." msgstr "" -"以下の例では、 [pipが理解できる方法でテストの依存関係を宣言するように`pyproject.toml`をセットアップする](../package-" -"structure-code/declare-dependencies.md) ことを前提としていることに注意してください。 " -"そのセットアップの例を以下に示します。" +"以下の例では、 [pipが理解できる方法でテストの依存関係を宣言するように`pyproject.toml`をセットアップする" +"](../package-structure-code/declare-dependencies.md) " +"ことを前提としていることに注意してください。 そのセットアップの例を以下に示します。" #: ../../tests/run-tests.md:201 msgid "" "If you have the above setup, then you can use " -"`session.install(\".[tests]\")` to install your test dependencies. Notice " -"that below one single nox session allows you to run your tests on 4 " +"`session.install(\".[tests]\")` to install your test dependencies. Notice" +" that below one single nox session allows you to run your tests on 4 " "different Python environments (Python 3.9, 3.10, 3.11, and 3.12)." msgstr "" -"上記の設定ができていれば、 `session.install(\".[tests]\")` を使ってテストの依存関係をインストールすることができます。 " -"以下のように、1つのnoxセッションで4つの異なるPython環境（Python " +"上記の設定ができていれば、 `session.install(\".[tests]\")` " +"を使ってテストの依存関係をインストールすることができます。 以下のように、1つのnoxセッションで4つの異なるPython環境（Python " "3.9、3.10、3.11、3.12）でテストを実行できることに注意してください。" #: ../../tests/run-tests.md:222 msgid "" "Above you create a nox session in the form of a function with a " -"`@nox.session` decorator. Notice that within the decorator you declare the " -"versions of python that you wish to run." +"`@nox.session` decorator. Notice that within the decorator you declare " +"the versions of python that you wish to run." msgstr "" "上の例では、 `@nox.session` デコレーターを使って関数の形で nox セッションを作成しています。 デコレータの中で、実行したい " "python のバージョンを宣言していることに注意してください。" @@ -783,8 +790,8 @@ msgstr "" #: ../../tests/run-tests.md:226 msgid "" "To run the above you'd execute the following command, specifying which " -"session with `--session` (sometimes shortened to `-s`). Your function above " -"is called test, therefore the session name is test." +"session with `--session` (sometimes shortened to `-s`). Your function " +"above is called test, therefore the session name is test." msgstr "" "上記を実行するには、 `--session` （ `-s` " "と短縮されることもある）でセッションを指定し、以下のコマンドを実行します。上記の関数はtestという名前なので、セッション名はtestです。" @@ -796,17 +803,18 @@ msgstr "conda / mamba による nox" #: ../../tests/run-tests.md:236 msgid "" "Below is an example for setting up nox to use mamba (or conda) for your " -"environment manager. Note that unlike venv, conda can automatically install " -"the various versions of Python that you need. You won't need to install all " -"four Python versions if you use conda/mamba, like you do with `venv`." +"environment manager. Note that unlike venv, conda can automatically " +"install the various versions of Python that you need. You won't need to " +"install all four Python versions if you use conda/mamba, like you do with" +" `venv`." msgstr "" "以下は、noxが環境マネージャーにmamba（またはconda）を使うように設定する例です。venvと違って、condaは必要なPythonの様々なバージョンを自動的にインストールできることに注意してください。conda/mambaを使う場合は、" " `venv` のように4つのPythonバージョンをインストールする必要はありません。" #: ../../tests/run-tests.md:242 msgid "" -"For `conda` to work with `nox`, you will need to ensure that either `conda` " -"or `mamba` is installed on your computer." +"For `conda` to work with `nox`, you will need to ensure that either " +"`conda` or `mamba` is installed on your computer." msgstr "" "`nox` で `conda` を動作させるには、コンピュータに `conda` か `mamba` " "のどちらかがインストールされていることを確認する必要があります。" @@ -825,8 +833,8 @@ msgstr "3種類のテスト: 単体テスト、統合テスト、機能テスト #: ../../tests/test-types.md:5 msgid "" -"There are different types of tests that you want to consider when creating " -"your test suite:" +"There are different types of tests that you want to consider when " +"creating your test suite:" msgstr "テストスイートを作成する際に考慮したいテストには、さまざまなタイプがあります:" #: ../../tests/test-types.md:8 @@ -843,14 +851,14 @@ msgstr "エンドツーエンド(機能テストとも呼ばれる)テスト" #: ../../tests/test-types.md:12 msgid "" -"Each type of test has a different purpose. Here, you will learn about all " -"three types of tests." +"Each type of test has a different purpose. Here, you will learn about all" +" three types of tests." msgstr "それぞれの検査には異なる目的がある。 ここでは、3種類の検査すべてについて学びます。" #: ../../tests/test-types.md:15 msgid "" -"I think this page would be stronger if we did have some examples from our " -"package here: https://github.com/pyOpenSci/pyosPackage" +"I think this page would be stronger if we did have some examples from our" +" package here: https://github.com/pyOpenSci/pyosPackage" msgstr "" "私たちのパッケージからの例があれば、このページはもっと強くなると思います: " "https://github.com/pyOpenSci/pyosPackage " @@ -862,29 +870,27 @@ msgstr "単体テスト" #: ../../tests/test-types.md:22 msgid "" "A unit test involves testing individual components or units of code in " -"isolation to ensure that they work correctly. The goal of unit testing is to" -" verify that each part of the software, typically at the function or method " -"level, performs its intended task correctly." -msgstr "" -"単体テストは、個々のコンポーネントやコードの単位を分離してテストし、それらが正しく動作することを確認するものです。単体テストの目的は、ソフトウェアの各部分、通常は関数やメソッドのレベルが、意図したタスクを正しく実行することを検証することです。" +"isolation to ensure that they work correctly. The goal of unit testing is" +" to verify that each part of the software, typically at the function or " +"method level, performs its intended task correctly." +msgstr "単体テストは、個々のコンポーネントやコードの単位を分離してテストし、それらが正しく動作することを確認するものです。単体テストの目的は、ソフトウェアの各部分、通常は関数やメソッドのレベルが、意図したタスクを正しく実行することを検証することです。" #: ../../tests/test-types.md:24 msgid "" -"Unit tests can be compared to examining each piece of your puzzle to ensure " -"parts of it are not broken. If all of the pieces of your puzzle don’t fit " -"together, you will never complete it. Similarly, when working with code, " -"tests ensure that each function, attribute, class, method works properly " -"when isolated." -msgstr "" -"単体テストは、パズルの各パーツが壊れていないかどうかを調べることに例えることができます。パズルのピースがすべて合わなければ、完成することはありません。同様に、コードを扱う場合、テストは各関数、プロパティ、クラス、メソッドが分離されたときに正しく機能することを保証します。" +"Unit tests can be compared to examining each piece of your puzzle to " +"ensure parts of it are not broken. If all of the pieces of your puzzle " +"don’t fit together, you will never complete it. Similarly, when working " +"with code, tests ensure that each function, attribute, class, method " +"works properly when isolated." +msgstr "単体テストは、パズルの各パーツが壊れていないかどうかを調べることに例えることができます。パズルのピースがすべて合わなければ、完成することはありません。同様に、コードを扱う場合、テストは各関数、プロパティ、クラス、メソッドが分離されたときに正しく機能することを保証します。" #: ../../tests/test-types.md:26 msgid "" "**Unit test example:** Pretend that you have a function that converts a " -"temperature value from Celsius to Fahrenheit. A test for that function might" -" ensure that when provided with a value in Celsius, the function returns the" -" correct value in degrees Fahrenheit. That function is a unit test. It " -"checks a single unit (function) in your code." +"temperature value from Celsius to Fahrenheit. A test for that function " +"might ensure that when provided with a value in Celsius, the function " +"returns the correct value in degrees Fahrenheit. That function is a unit " +"test. It checks a single unit (function) in your code." msgstr "" "**ユニットテスト例:** " "温度値を摂氏から華氏に変換する関数があるとします。その関数のテストは、摂氏の値が提供されたとき、その関数が正しい華氏の値を返すことを保証するかもしれません。この関数はユニットテストです。これは、コード内の1つのユニット(関数)をチェックします。" @@ -897,14 +903,14 @@ msgstr "上記の関数のユニットテスト例。このテストは、 **tes #: ../../tests/test-types.md:65 ../../tests/test-types.md:115 msgid "" -"image of puzzle pieces that all fit together nicely. The puzzle pieces are " -"colorful - purple, green and teal." +"image of puzzle pieces that all fit together nicely. The puzzle pieces " +"are colorful - purple, green and teal." msgstr "パズルのピースがうまく組み合わさったような画像です。パズルのピースは紫色、緑色、鴨の羽色とカラフルです。" #: ../../tests/test-types.md:69 msgid "" -"Your unit tests should ensure each part of your code works as expected on " -"its own." +"Your unit tests should ensure each part of your code works as expected on" +" its own." msgstr "ユニットテストでは、コードの各部分がそれ自体で期待通りに動作することを確認する必要があります。" #: ../../tests/test-types.md:72 @@ -913,36 +919,35 @@ msgstr "統合テスト" #: ../../tests/test-types.md:74 msgid "" -"Integration tests involve testing how parts of your package work together or" -" integrate. Integration tests can be compared to connecting a bunch of " -"puzzle pieces together to form a whole picture. Integration tests focus on " -"how different pieces of your code fit and work together." -msgstr "" -"統合テストでは、パッケージの各パーツがどのように連動するか、あるいは統合されるかをテストします。統合テストは、パズルのピースをつなげて全体像を作るようなものです。統合テストは、コードのさまざまな部分がどのように適合し、連携して動作するかに焦点を当てます。" +"Integration tests involve testing how parts of your package work together" +" or integrate. Integration tests can be compared to connecting a bunch of" +" puzzle pieces together to form a whole picture. Integration tests focus " +"on how different pieces of your code fit and work together." +msgstr "統合テストでは、パッケージの各パーツがどのように連動するか、あるいは統合されるかをテストします。統合テストは、パズルのピースをつなげて全体像を作るようなものです。統合テストは、コードのさまざまな部分がどのように適合し、連携して動作するかに焦点を当てます。" #: ../../tests/test-types.md:76 msgid "" -"For example, if you had a series of steps that collected temperature data in" -" a spreadsheet, converted it from degrees celsius to Fahrenheit and then " -"provided an average temperature for a particular time period. An integration" -" test would ensure that all parts of that workflow behaved as expected." -msgstr "" -"例えば、スプレッドシートに温度データを収集し、摂氏から華氏に変換し、特定の期間の平均温度を提供する一連のステップがあったとします。統合テストは、そのワークフローのすべての部分が期待通りに動作することを保証します。" +"For example, if you had a series of steps that collected temperature data" +" in a spreadsheet, converted it from degrees celsius to Fahrenheit and " +"then provided an average temperature for a particular time period. An " +"integration test would ensure that all parts of that workflow behaved as " +"expected." +msgstr "例えば、スプレッドシートに温度データを収集し、摂氏から華氏に変換し、特定の期間の平均温度を提供する一連のステップがあったとします。統合テストは、そのワークフローのすべての部分が期待通りに動作することを保証します。" #: ../../tests/test-types.md:107 msgid "" -"image of two puzzle pieces with some missing parts. The puzzle pieces are " -"purple teal yellow and blue. The shapes of each piece don’t fit together." +"image of two puzzle pieces with some missing parts. The puzzle pieces are" +" purple teal yellow and blue. The shapes of each piece don’t fit " +"together." msgstr "パズルのピースが2つあり、一部欠けている画像です。パズルのピースは紫・鴨の羽色・黄色・青色。 それぞれのピースの形が合いません。" #: ../../tests/test-types.md:112 msgid "" "If puzzle pieces have missing ends, they can’t work together with other " -"elements in the puzzle. The same is true with individual functions, methods " -"and classes in your software. The code needs to work both individually and " -"together to perform certain sets of tasks." -msgstr "" -"パズルのピースの両端が欠けていると、パズルの他の要素と連動することができません。ソフトウェアの個々の関数、メソッド、クラスについても同様です。コードは、ある一連のタスクを実行するために、個々に、そして一緒に働く必要があります。" +"elements in the puzzle. The same is true with individual functions, " +"methods and classes in your software. The code needs to work both " +"individually and together to perform certain sets of tasks." +msgstr "パズルのピースの両端が欠けていると、パズルの他の要素と連動することができません。ソフトウェアの個々の関数、メソッド、クラスについても同様です。コードは、ある一連のタスクを実行するために、個々に、そして一緒に働く必要があります。" #: ../../tests/test-types.md:120 msgid "" @@ -956,14 +961,14 @@ msgstr "エンドツーエンド(機能)テスト" #: ../../tests/test-types.md:126 msgid "" -"End-to-end tests (also referred to as functional tests) in Python are like " -"comprehensive checklists for your software. They simulate real user end-to-" -"end workflows to make sure the code base supports real life applications and" -" use-cases from start to finish. These tests help catch issues that might " -"not show up in smaller tests and ensure your entire application or program " -"behaves correctly. Think of them as a way to give your software a final " -"check before it's put into action, making sure it's ready to deliver a " -"smooth experience to its users." +"End-to-end tests (also referred to as functional tests) in Python are " +"like comprehensive checklists for your software. They simulate real user " +"end-to-end workflows to make sure the code base supports real life " +"applications and use-cases from start to finish. These tests help catch " +"issues that might not show up in smaller tests and ensure your entire " +"application or program behaves correctly. Think of them as a way to give " +"your software a final check before it's put into action, making sure it's" +" ready to deliver a smooth experience to its users." msgstr "" "Python " "におけるエンドツーエンドのテスト（機能テストとも呼ばれる）は、ソフトウェアの包括的なチェックリストのようなものです。実際のユーザーのエンドツーエンドのワークフローをシミュレートし、コードベースが実際のアプリケーションやユースケースを最初から最後までサポートすることを確認します。これらのテストは、小規模なテストでは表示されないかもしれない問題をキャッチし、アプリケーションやプログラム全体が正しく動作することを確認するのに役立ちます。ソフトウェアを実用化する前に最終チェックを行い、ユーザーにスムーズなエクスペリエンスを提供する準備ができていることを確認する方法だと考えてください。" @@ -974,25 +979,23 @@ msgstr "デイジーを描いたパズルの完成イメージ" #: ../../tests/test-types.md:133 msgid "" -"End-to-end or functional tests represent an entire workflow that you expect " -"your package to support." +"End-to-end or functional tests represent an entire workflow that you " +"expect your package to support." msgstr "エンドツーエンドテストまたは機能テストは、パッケージがサポートすることを期待するワークフロー全体を表します。" #: ../../tests/test-types.md:137 msgid "" "End-to-end test also test how a program runs from start to finish. A " -"tutorial that you add to your documentation that runs in CI in an isolated " -"environment is another example of an end-to-end test." -msgstr "" -"エンドツーエンドのテストも、プログラムが最初から最後までどのように実行されるかをテストします。ドキュメントに追加するチュートリアルは、分離された環境のCIで実行され、エンドツーエンドのテストのもう一つの例です。" +"tutorial that you add to your documentation that runs in CI in an " +"isolated environment is another example of an end-to-end test." +msgstr "エンドツーエンドのテストも、プログラムが最初から最後までどのように実行されるかをテストします。ドキュメントに追加するチュートリアルは、分離された環境のCIで実行され、エンドツーエンドのテストのもう一つの例です。" #: ../../tests/test-types.md:140 msgid "" "For scientific packages, creating short tutorials that highlight core " -"workflows that your package supports, that are run when your documentation " -"is built could also serve as end-to-end tests." -msgstr "" -"科学的なパッケージの場合、パッケージがサポートする中核的なワークフローを強調する短いチュートリアルを作成し、ドキュメントのビルド時に実行することで、エンドツーエンドのテストを兼ねることができます。" +"workflows that your package supports, that are run when your " +"documentation is built could also serve as end-to-end tests." +msgstr "科学的なパッケージの場合、パッケージがサポートする中核的なワークフローを強調する短いチュートリアルを作成し、ドキュメントのビルド時に実行することで、エンドツーエンドのテストを兼ねることができます。" #: ../../tests/test-types.md:143 msgid "Comparing unit, integration and end-to-end tests" @@ -1012,25 +1015,25 @@ msgstr "" #: ../../tests/test-types.md:147 msgid "" -"Integration and end-to-end tests verify that the different portions of the " -"program work together, but are less well-suited for isolating where errors " -"are occurring. For example, when you refactor your code, it is possible that" -" that your end-to-end tests will break. But if the refactor didn't introduce" -" new behavior to your existing code, then you can rely on your unit tests to" -" continue to pass, testing the original functionality of your code." -msgstr "" -"統合テストとエンドツーエンドテストは、プログラムのさまざまな部分が連携して動作することを検証しますが、どこでエラーが発生しているかを切り分けるにはあまり適していません。例えば、コードをリファクタリングすると、エンドツーエンドのテストが壊れる可能性があります。しかし、リファクタリングによって既存のコードに新しい動作が導入されなかったのであれば、コードの元の機能をテストするユニットテストがパスし続けることに頼ることができます。" +"Integration and end-to-end tests verify that the different portions of " +"the program work together, but are less well-suited for isolating where " +"errors are occurring. For example, when you refactor your code, it is " +"possible that that your end-to-end tests will break. But if the refactor " +"didn't introduce new behavior to your existing code, then you can rely on" +" your unit tests to continue to pass, testing the original functionality " +"of your code." +msgstr "統合テストとエンドツーエンドテストは、プログラムのさまざまな部分が連携して動作することを検証しますが、どこでエラーが発生しているかを切り分けるにはあまり適していません。例えば、コードをリファクタリングすると、エンドツーエンドのテストが壊れる可能性があります。しかし、リファクタリングによって既存のコードに新しい動作が導入されなかったのであれば、コードの元の機能をテストするユニットテストがパスし続けることに頼ることができます。" #: ../../tests/test-types.md:152 msgid "" -"It is important to note that you don't need to spend energy worrying about " -"the specifics surrounding the different types of tests. When you begin to " -"work on your test suite, consider what your package does and how you may " -"need to test parts of your package. Bring familiar with the different types " -"of tests can provides a framework to help you think about writing tests and " -"how different types of tests can complement each other." -msgstr "" -"重要なのは、さまざまな種類のテストにまつわる詳細について心配することにエネルギーを費やす必要はないということです。テストスイートの作成に取りかかるときには、パッケージが何をするのか、そしてパッケージの一部をどのようにテストする必要があるのかを考えてください。さまざまな種類のテストに慣れ親しむことは、テストの書き方や、さまざまな種類のテストが互いにどのように補完し合えるかを考える際のフレームワークとなります。" +"It is important to note that you don't need to spend energy worrying " +"about the specifics surrounding the different types of tests. When you " +"begin to work on your test suite, consider what your package does and how" +" you may need to test parts of your package. Bring familiar with the " +"different types of tests can provides a framework to help you think about" +" writing tests and how different types of tests can complement each " +"other." +msgstr "重要なのは、さまざまな種類のテストにまつわる詳細について心配することにエネルギーを費やす必要はないということです。テストスイートの作成に取りかかるときには、パッケージが何をするのか、そしてパッケージの一部をどのようにテストする必要があるのかを考えてください。さまざまな種類のテストに慣れ親しむことは、テストの書き方や、さまざまな種類のテストが互いにどのように補完し合えるかを考える際のフレームワークとなります。" #: ../../tests/tests-ci.md:1 msgid "Run tests with Continuous Integration" @@ -1038,23 +1041,24 @@ msgstr "継続的インテグレーションによるテストの実行" #: ../../tests/tests-ci.md:3 msgid "" -"Running your [test suite locally](run-tests) is useful as you develop code " -"and also test new features or changes to the code base. However, you also " -"will want to setup Continuous Integration (CI) to run your tests online. CI " -"allows you to run all of your tests in the cloud. While you may only be able" -" to run tests locally on a specific operating system, using CI you can " -"specify tests to run both on various versions of Python and across different" -" operating systems." +"Running your [test suite locally](run-tests) is useful as you develop " +"code and also test new features or changes to the code base. However, you" +" also will want to setup Continuous Integration (CI) to run your tests " +"online. CI allows you to run all of your tests in the cloud. While you " +"may only be able to run tests locally on a specific operating system, " +"using CI you can specify tests to run both on various versions of Python " +"and across different operating systems." msgstr "" "[テストスイートをローカルで実行する](run-tests) " "ことは、コードを開発したり、新しい機能やコード・ベースの変更をテストしたりするときに便利です。しかし、テストをオンラインで実行するために、継続的インテグレーション（CI）もセットアップしたいです。CIを使えば、すべてのテストをクラウド上で実行できます。特定のオペレーティングシステム上でしかローカルにテストを実行できないかもしれませんが、CIを使用すると、Pythonのさまざまなバージョンや異なるオペレーティングシステム間で実行するテストを指定できます。" #: ../../tests/tests-ci.md:5 msgid "" -"CI can also be triggered for pull requests and pushes to your repository. " -"This means that every pull request that you, your maintainer team or a " -"contributor submit, can be tested. In the end CI testing ensures your code " -"continues to run as expected even as changes are made to the code base." +"CI can also be triggered for pull requests and pushes to your repository." +" This means that every pull request that you, your maintainer team or a " +"contributor submit, can be tested. In the end CI testing ensures your " +"code continues to run as expected even as changes are made to the code " +"base." msgstr "" "CIは、プルリクエストやリポジトリへのプッシュをトリガーすることもできます。 " "これは、あなた、あなたのメンテナチーム、またはコントリビューターが提出するすべてのプルリクエストをテストできることを意味します。 " @@ -1062,8 +1066,8 @@ msgstr "" #: ../../tests/tests-ci.md:9 msgid "" -"Learn more about Continuous Integration and how it can be used, here. (add " -"link)" +"Learn more about Continuous Integration and how it can be used, here. " +"(add link)" msgstr "継続的インテグレーションとその使用方法については、こちらをご覧ください。 (リンクを追加)" #: ../../tests/tests-ci.md:13 @@ -1072,12 +1076,12 @@ msgstr "CIとプルリクエスト" #: ../../tests/tests-ci.md:15 msgid "" -"CI is invaluable if you have outside people contributing to your software. " -"You can setup CI to run on all pull requests submitted to your repository. " -"CI can make your repository more friendly to new potential contributors. It " -"allows users to contribute code, documentation fixes and more without having" -" to create development environments, run tests and build documentation " -"locally." +"CI is invaluable if you have outside people contributing to your " +"software. You can setup CI to run on all pull requests submitted to your " +"repository. CI can make your repository more friendly to new potential " +"contributors. It allows users to contribute code, documentation fixes and" +" more without having to create development environments, run tests and " +"build documentation locally." msgstr "" "CIは、外部の人があなたのソフトウェアに貢献している場合、非常に貴重です。 " "リポジトリに投稿されたすべてのプルリクエストに対してCIを実行するように設定できます。 " @@ -1098,8 +1102,8 @@ msgstr "" #: ../../tests/tests-ci.md:28 msgid "" -"To work properly, this file should be located in a root directory of your " -"GitHub repository:" +"To work properly, this file should be located in a root directory of your" +" GitHub repository:" msgstr "正しく動作させるには、このファイルをGitHubリポジトリのルートディレクトリに置く必要があります:" #: ../../tests/write-tests.md:1 @@ -1111,8 +1115,8 @@ msgid "" "Writing code that tests your package code, also known as test suites, is " "important for you as a maintainer, your users, and package contributors. " "Test suites consist of sets of functions, methods, and classes that are " -"written with the intention of making sure a specific part of your code works" -" as you expected it to." +"written with the intention of making sure a specific part of your code " +"works as you expected it to." msgstr "" "パッケージのコードをテストするコードを書くことは、テスト・スイートとしても知られています。 " "テスト・スイートは、関数、メソッド、クラスのセットで構成され、コードの特定の部分が期待通りに動作することを確認することを意図して書かれます。" @@ -1123,9 +1127,10 @@ msgstr "なぜパッケージのテストを書くのか？" #: ../../tests/write-tests.md:9 msgid "" -"Tests act as a safety net for code changes. They help you spot and rectify " -"bugs before they affect users. Tests also instill confidence that code " -"alterations from contributors won't breaking existing functionality." +"Tests act as a safety net for code changes. They help you spot and " +"rectify bugs before they affect users. Tests also instill confidence that" +" code alterations from contributors won't breaking existing " +"functionality." msgstr "" "テストはコード変更のセーフティネットとして機能する。 バグがユーザーに影響を与える前に発見し、修正するのに役立ちます。 " "テストはまた、貢献者によるコード改変が既存の機能を壊さないという確信を与えます。" @@ -1136,18 +1141,18 @@ msgstr "Pythonパッケージのテストを書くことは重要である:" #: ../../tests/write-tests.md:15 msgid "" -"**Catch Mistakes:** Tests are a safety net. When you make changes or add new" -" features to your package, tests can quickly tell you if you accidentally " -"broke something that was working fine before." +"**Catch Mistakes:** Tests are a safety net. When you make changes or add " +"new features to your package, tests can quickly tell you if you " +"accidentally broke something that was working fine before." msgstr "" "**キャッチミス:** " "テストはセーフティネットです。パッケージに変更を加えたり、新機能を追加したりした場合、テストによって、以前は問題なく動作していたものを誤って壊してしまったかどうかをすぐに知ることができます。" #: ../../tests/write-tests.md:16 msgid "" -"**Save Time:** Imagine you have a magic button that can automatically check " -"if your package is still working properly. Tests are like that magic button!" -" They can run all those checks for you saving you time." +"**Save Time:** Imagine you have a magic button that can automatically " +"check if your package is still working properly. Tests are like that " +"magic button! They can run all those checks for you saving you time." msgstr "" "**時間を節約する:** " "あなたのパッケージがまだ正常に動作しているかどうかを自動的にチェックできる魔法のボタンがあるとしましょう。テストは魔法のボタンのようなものです！ " @@ -1156,18 +1161,18 @@ msgstr "" #: ../../tests/write-tests.md:17 msgid "" "**Easier Collaboration:** If you're working with others, or have outside " -"contributors, tests help everyone stay on the same page. Your tests explain " -"how your package is supposed to work, making it easier for others to " -"understand and contribute to your project." +"contributors, tests help everyone stay on the same page. Your tests " +"explain how your package is supposed to work, making it easier for others" +" to understand and contribute to your project." msgstr "" "**より容易なコラボレーション:** " "他の人と一緒に仕事をしていたり、外部の協力者がいる場合、テストは全員が同じページにとどまるのに役立ちます。テストは、パッケージがどのように動作するかを説明し、他の人が理解しやすくし、プロジェクトに貢献しやすくします。" #: ../../tests/write-tests.md:18 msgid "" -"**Fearless Refactoring:** Refactoring means making improvements to your code" -" structure without changing its behavior. Tests empower you to make these " -"changes as if you break something, test failures will let you know." +"**Fearless Refactoring:** Refactoring means making improvements to your " +"code structure without changing its behavior. Tests empower you to make " +"these changes as if you break something, test failures will let you know." msgstr "" "**大胆不敵なリファクタリング:** リファクタリングとは、コードの振る舞いを変えることなく、コード構造を改善することです。 " "テストは、あなたが何かを壊した場合、テストの失敗があなたに知らせてくれるので、このような変更を行う力を与えてくれます。" @@ -1175,9 +1180,9 @@ msgstr "" #: ../../tests/write-tests.md:19 msgid "" "**Documentation:** Tests serve as technical examples of how to use your " -"package. This can be helpful for a new technical contributor that wants to " -"contribute code to your package. They can look at your tests to understand " -"how parts of your code functionality fits together." +"package. This can be helpful for a new technical contributor that wants " +"to contribute code to your package. They can look at your tests to " +"understand how parts of your code functionality fits together." msgstr "" "**文書化:** テストは、あなたのパッケージの使い方の技術的な例となります。 " "これは、あなたのパッケージにコードを提供しようとする新しい技術的貢献者にとって役に立ちます。 " @@ -1197,12 +1202,12 @@ msgid "" "**Easier pull request reviews:** By running your tests in a CI framework " "such as GitHub Actions, each time you or a contributor makes a change to " "your code-base, you can catch issues and things that may have changed in " -"your code base. This ensures that your software behaves the way you expect " -"it to." +"your code base. This ensures that your software behaves the way you " +"expect it to." msgstr "" "**より簡単なプルリクエストのレビュー:** GitHub Actionsのような CI " -"フレームワークでテストを実行することで、あなたや貢献者がコードベースに変更を加えるたびに、コードベースの問題や変更点をキャッチすることができます。 " -"これにより、あなたのソフトウェアが期待通りに動作することが保証されます。" +"フレームワークでテストを実行することで、あなたや貢献者がコードベースに変更を加えるたびに、コードベースの問題や変更点をキャッチすることができます。" +" これにより、あなたのソフトウェアが期待通りに動作することが保証されます。" #: ../../tests/write-tests.md:23 msgid "Tests for user edge cases" @@ -1210,12 +1215,12 @@ msgstr "ユーザーエッジケースのテスト" #: ../../tests/write-tests.md:25 msgid "" -"Edge cases refer to unexpected or \"outlier\" ways that some users may use " -"your package. Tests enable you to address various edge cases that could " -"impair your package's functionality. For example, what occurs if a function " -"expects a pandas `dataframe` but a user supplies a numpy `array`? Does your " -"code gracefully handle this situation, providing clear feedback, or does it " -"leave users frustrated by an unexplained failure?" +"Edge cases refer to unexpected or \"outlier\" ways that some users may " +"use your package. Tests enable you to address various edge cases that " +"could impair your package's functionality. For example, what occurs if a " +"function expects a pandas `dataframe` but a user supplies a numpy " +"`array`? Does your code gracefully handle this situation, providing clear" +" feedback, or does it leave users frustrated by an unexplained failure?" msgstr "" "エッジケースとは、あるユーザがあなたのパッケージを使用する際の、予期せぬ、あるいは \"外れ値\" の使い方を指します。 " "テストによって、パッケージの機能を損なう可能性のある様々なエッジケースに対処することができます。 例えば、ある関数がpandasの " @@ -1228,18 +1233,17 @@ msgid "" "lesson](https://swcarpentry.github.io/python-novice-" "inflammation/10-defensive.html)" msgstr "" -"テストの入門書としては、 [このSoftware " -"Carpentryのレッスン](https://swcarpentry.github.io/python-novice-" -"inflammation/10-defensive.html) を参照してください。" +"テストの入門書としては、 [このSoftware Carpentryのレッスン](https://swcarpentry.github.io" +"/python-novice-inflammation/10-defensive.html) を参照してください。" #: ../../tests/write-tests.md:41 msgid "" "Imagine you're working on a puzzle where each puzzle piece represents a " -"function, method, class or attribute in your Python package that you want " -"other people to be able to use. Would you want to give someone a puzzle that" -" has missing pieces or pieces that don't fit together? Providing people with" -" the right puzzle pieces that work together can be compared to writing tests" -" for your Python package." +"function, method, class or attribute in your Python package that you want" +" other people to be able to use. Would you want to give someone a puzzle " +"that has missing pieces or pieces that don't fit together? Providing " +"people with the right puzzle pieces that work together can be compared to" +" writing tests for your Python package." msgstr "" "パズルのピースが、あなたのPythonパッケージの関数、メソッド、クラス、属性を表しているとしましょう。 " "そしてあなたは他の人に使ってもらいたいと思っています。 ピースが欠けていたり、ピースが合わなかったりするパズルを誰かに渡したいと思いますか？ " @@ -1251,13 +1255,14 @@ msgstr "テスト例" #: ../../tests/write-tests.md:47 msgid "" -"Let’s say you have a Python function that adds two numbers a and b together." +"Let’s say you have a Python function that adds two numbers a and b " +"together." msgstr "例えば、2つの数値aとbを足し合わせるPython関数があるとしましょう。" #: ../../tests/write-tests.md:54 msgid "" -"A test to ensure that function runs as you might expect when provided with " -"different numbers might look like this:" +"A test to ensure that function runs as you might expect when provided " +"with different numbers might look like this:" msgstr "異なる数値が与えられたときに、その関数が期待通りに実行されることを確認するテストは次のようになります:" #: ../../tests/write-tests.md:72 @@ -1284,18 +1289,18 @@ msgstr "この時点で、あなたは疑問に思うかもしれません-あ #: ../../tests/write-tests.md:82 msgid "" -"**Test some typical cases:** Test that the package functions as you expect " -"it to when users use it. For instance, if your package is supposed to add " -"two numbers, test that the outcome value of adding those two numbers is " -"correct." +"**Test some typical cases:** Test that the package functions as you " +"expect it to when users use it. For instance, if your package is supposed" +" to add two numbers, test that the outcome value of adding those two " +"numbers is correct." msgstr "" "**いくつかの典型的なケースをテスト:** " "パッケージが、ユーザーが使用したときに期待通りに機能することをテストします。例えば、パッケージが2つの数値を足すことになっている場合、その2つの数値を足した結果が正しいかどうかをテストする。" #: ../../tests/write-tests.md:84 msgid "" -"**Test special cases:** Sometimes there are special or outlier cases. For " -"instance, if a function performs a specific calculation that may become " +"**Test special cases:** Sometimes there are special or outlier cases. For" +" instance, if a function performs a specific calculation that may become " "problematic closer to the value = 0, test it with the input of both 0 and" msgstr "" "**特別なケースをテストする:** " @@ -1303,20 +1308,21 @@ msgstr "" #: ../../tests/write-tests.md:86 msgid "" -"**Test at and near the expected boundaries:** If a function requires a value" -" that is greater than or equal to 1, make sure that the function still works" -" with both the values 1 and less than one and 1.001 as well (something close" -" to the constraint value).." +"**Test at and near the expected boundaries:** If a function requires a " +"value that is greater than or equal to 1, make sure that the function " +"still works with both the values 1 and less than one and 1.001 as well " +"(something close to the constraint value).." msgstr "" -"**予想される境界線とその付近でテストする:** 関数が1以上の値を必要とする場合、この関数が、1と1未満と1.001の両方の値 (制約値に近い値) " -"でも動作することを確認してください。" +"**予想される境界線とその付近でテストする:** 関数が1以上の値を必要とする場合、この関数が、1と1未満と1.001の両方の値 " +"(制約値に近い値) でも動作することを確認してください。" #: ../../tests/write-tests.md:88 msgid "" -"**Test that code fails correctly:** If a function requires a value greater " -"than or equal to 1, then test at 0.999. Make sure that the function fails " -"gracefully when given unexpected values and help and that the user can " -"easily understand why if failed (provides a useful error message)." +"**Test that code fails correctly:** If a function requires a value " +"greater than or equal to 1, then test at 0.999. Make sure that the " +"function fails gracefully when given unexpected values and help and that " +"the user can easily understand why if failed (provides a useful error " +"message)." msgstr "" "**コードが正しく失敗するかテストする** 関数が1以上の値を必要とする場合は、0.999でテストします。 " "予期しない値やヘルプが与えられたときに、関数が優雅に失敗し、ユーザが失敗した理由を簡単に理解できるようにします(有用なエラーメッセージを提供します)。" From 994ed848b2ea38b3ec1d997ea0e2a98e4e802091 Mon Sep 17 00:00:00 2001 From: Tetsuo Koyama Date: Sun, 20 Apr 2025 12:24:26 +0900 Subject: [PATCH 3/6] Update tests.po --- locales/ja/LC_MESSAGES/tests.po | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/locales/ja/LC_MESSAGES/tests.po b/locales/ja/LC_MESSAGES/tests.po index e7235497..5467266b 100644 --- a/locales/ja/LC_MESSAGES/tests.po +++ b/locales/ja/LC_MESSAGES/tests.po @@ -754,7 +754,7 @@ msgstr "TODO: 上記のテストをいくつか追加し、以下の例で出力 msgid "" "Below is an example of setting up nox to run tests using `venv` which is " "the built in environment manager that comes with base Python." -msgstr "以下は、Pythonに組み込まれている環境マネージャーである `venv` を使ってテストを実行するようにnoxをセットアップする例である。" +msgstr "以下は、Pythonに組み込まれている環境マネージャーである `venv` を使ってテストを実行するようにnoxをセットアップする例です。" #: ../../tests/run-tests.md:180 msgid "" From 2bf351c1b72f3bbf538e3e47ceb31f7b6a00af5f Mon Sep 17 00:00:00 2001 From: Tetsuo Koyama Date: Sun, 20 Apr 2025 12:25:09 +0900 Subject: [PATCH 4/6] Update tests.po --- locales/ja/LC_MESSAGES/tests.po | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/locales/ja/LC_MESSAGES/tests.po b/locales/ja/LC_MESSAGES/tests.po index 5467266b..631ca20e 100644 --- a/locales/ja/LC_MESSAGES/tests.po +++ b/locales/ja/LC_MESSAGES/tests.po @@ -853,7 +853,7 @@ msgstr "エンドツーエンド(機能テストとも呼ばれる)テスト" msgid "" "Each type of test has a different purpose. Here, you will learn about all" " three types of tests." -msgstr "それぞれの検査には異なる目的がある。 ここでは、3種類の検査すべてについて学びます。" +msgstr "それぞれのテストには異なる目的がある。 ここでは、3種類のテストすべてについて学びます。" #: ../../tests/test-types.md:15 msgid "" From 96d246b3270d5768df6a687249c95deb6d94864c Mon Sep 17 00:00:00 2001 From: Tetsuo Koyama Date: Sun, 20 Apr 2025 12:36:38 +0900 Subject: [PATCH 5/6] Update tests.po --- locales/ja/LC_MESSAGES/tests.po | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/locales/ja/LC_MESSAGES/tests.po b/locales/ja/LC_MESSAGES/tests.po index 631ca20e..35a4cbce 100644 --- a/locales/ja/LC_MESSAGES/tests.po +++ b/locales/ja/LC_MESSAGES/tests.po @@ -15,8 +15,7 @@ msgstr "" "PO-Revision-Date: 2025-04-14 18:12+0000\n" "Last-Translator: Tetsuo Koyama , 2025\n" "Language: ja\n" -"Language-Team: Japanese " -"(https://app.transifex.com/tkoyama010/teams/196662/ja/)\n" +"Language-Team: ja \n" "Plural-Forms: nplurals=1; plural=0;\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" From 14f6887d2b3992636ea1250a6e6675d730847f1b Mon Sep 17 00:00:00 2001 From: Tetsuo Koyama Date: Sun, 20 Apr 2025 12:41:15 +0900 Subject: [PATCH 6/6] Apply suggestions from code review --- locales/ja/LC_MESSAGES/tests.po | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/locales/ja/LC_MESSAGES/tests.po b/locales/ja/LC_MESSAGES/tests.po index 35a4cbce..a3ad1f2f 100644 --- a/locales/ja/LC_MESSAGES/tests.po +++ b/locales/ja/LC_MESSAGES/tests.po @@ -244,7 +244,7 @@ msgid "" "contributors to your project." msgstr "" "Python パッケージのテストを書く技術についてもっと学びましょう。 " -"なぜテストを書く必要があるのか、そしてテストがどのようにあなたやあなたのプロジェクトへの潜在的な貢献者の助けになるのかを学びましょう。" +"なぜテストを書く必要があるのか、そしてテストがどのようにあなたやあなたのプロジェクトへの将来の貢献者の助けになるのかを学びましょう。" #: ../../tests/index.md:32 msgid "✨ Types of tests ✨" @@ -364,7 +364,7 @@ msgstr "" "いくつかのテストフレームワークにはプラグインがあり、テストがカバーするコードの範囲を評価するなどの機能を追加することができます。 " "以下では、科学的なエコシステムで最もよく使われている Python テストフレームワークの一つである **pytest** " "フレームワークについて学びます。 テストフレームワークは必要不可欠ですが、テストを実行するためだけのものです。 " -"これらのフレームワークは、追加の自動化ツールの助けを借りずに Python のバージョン間でテストを簡単に実行する方法は提供しません。" +"これらのフレームワークは、追加の自動化ツールの助けを借りずに Python のバージョンをまたいだテストを簡単に実行する方法は提供しません。" #: ../../tests/run-tests.md:25 msgid "" @@ -384,7 +384,7 @@ msgstr "" "[**tox**](https://tox.wiki/en/latest/index.html) " "のようなツールも、Pythonのバージョンをまたいでテストを実行できます。 " "しかし、noxとtoxだけを使って異なるオペレーティングシステムでビルドをテストするのは難しいでしょう - " -"継続的インテグレーション(CI)の出番です。" +"ここで継続的インテグレーション(CI)の出番です。" #: ../../tests/run-tests.md:26 msgid "" @@ -565,7 +565,7 @@ msgstr "自動化ツールは、様々な Python 環境でテストを実行す #: ../../tests/run-tests.md:111 msgid "Tests across operating systems" -msgstr "オペレーティングシステムを超えたテスト" +msgstr "オペレーティングシステムをまたいだテスト" #: ../../tests/run-tests.md:112 msgid "" @@ -589,7 +589,7 @@ msgid "" msgstr "" "一つのコマンドで様々な Python のバージョンや特定の環境でテストを実行するには、 `nox` や `tox` " "のような自動化ツールを使うことができます。 `nox` も `tox` も、隔離された仮想環境を作成することができます。 これにより、複数の環境や" -" Python のバージョン間でテストを簡単に実行することができます。" +" Python のバージョンをまたいだテストを簡単に実行することができます。" #: ../../tests/run-tests.md:120 msgid "" @@ -657,7 +657,7 @@ msgstr "**Nox** は素晴らしい自動化ツールです:" #: ../../tests/run-tests.md:140 msgid "Is Python-based making it accessible if you already know Python and" -msgstr "Pythonベースですので、Pythonをすでに知っていればアクセス可能です。" +msgstr "Pythonベースですので、Pythonをすでに知っていれば利用しやすいです。" #: ../../tests/run-tests.md:141 msgid "Will create isolated environments to run workflows." @@ -721,15 +721,15 @@ msgid "" " not interfere with each other, promoting a clean and organized " "development environment." msgstr "" -"デフォルトでは、 `nox` は Python 組み込みの `venv` 環境マネージャを使用する。 仮想環境 (`venv`) は自己完結型の " -"Python 環境で、異なる Python プロジェクトの依存関係を分離して管理することができます。 " +"デフォルトでは、 `nox` は Python 組み込みの `venv` 環境マネージャを使用します。 仮想環境 (`venv`) は自己完結型の" +" Python 環境で、異なる Python プロジェクトの依存関係を分離して管理することができます。 " "プロジェクト固有のライブラリやパッケージが互いに干渉しないようにし、クリーンで整理された開発環境を促進します。" #: ../../tests/run-tests.md:166 msgid "" "An example of using nox to run tests in `venv` environments for Python " "versions 3.9, 3.10, 3.11 and 3.12 is below." -msgstr "noxを使ってPythonバージョン3.9、3.10、3.11、3.12の `venv` 環境でテストを実行する例を以下に示す。" +msgstr "noxを使ってPythonバージョン3.9、3.10、3.11、3.12の `venv` 環境でテストを実行する例を以下に示します。" #: ../../tests/run-tests.md:169 msgid "" @@ -852,7 +852,7 @@ msgstr "エンドツーエンド(機能テストとも呼ばれる)テスト" msgid "" "Each type of test has a different purpose. Here, you will learn about all" " three types of tests." -msgstr "それぞれのテストには異なる目的がある。 ここでは、3種類のテストすべてについて学びます。" +msgstr "それぞれのテストには異なる目的があります。 ここでは、3種類のテストすべてについて学びます。" #: ../../tests/test-types.md:15 msgid "" @@ -1084,7 +1084,7 @@ msgid "" msgstr "" "CIは、外部の人があなたのソフトウェアに貢献している場合、非常に貴重です。 " "リポジトリに投稿されたすべてのプルリクエストに対してCIを実行するように設定できます。 " -"CIは、あなたのリポジトリを新しい潜在的な貢献者によりフレンドリーなものにします。 " +"CIは、あなたのリポジトリを新しい将来の貢献者によりフレンドリーなものにします。 " "開発環境の構築、テストの実行、ドキュメントのビルドをローカルで行うことなく、コードやドキュメントの修正などに貢献することができます。" #: ../../tests/tests-ci.md:22 @@ -1131,12 +1131,12 @@ msgid "" " code alterations from contributors won't breaking existing " "functionality." msgstr "" -"テストはコード変更のセーフティネットとして機能する。 バグがユーザーに影響を与える前に発見し、修正するのに役立ちます。 " +"テストはコード変更のセーフティネットとして機能します。 バグがユーザーに影響を与える前に発見し、修正するのに役立ちます。 " "テストはまた、貢献者によるコード改変が既存の機能を壊さないという確信を与えます。" #: ../../tests/write-tests.md:13 msgid "Writing tests for your Python package is important because:" -msgstr "Pythonパッケージのテストを書くことは重要である:" +msgstr "Pythonパッケージのテストを書くことは重要です:" #: ../../tests/write-tests.md:15 msgid "" @@ -1294,7 +1294,7 @@ msgid "" "numbers is correct." msgstr "" "**いくつかの典型的なケースをテスト:** " -"パッケージが、ユーザーが使用したときに期待通りに機能することをテストします。例えば、パッケージが2つの数値を足すことになっている場合、その2つの数値を足した結果が正しいかどうかをテストする。" +"パッケージが、ユーザーが使用したときに期待通りに機能することをテストします。例えば、パッケージが2つの数値を足すことになっている場合、その2つの数値を足した結果が正しいかどうかをテストします。" #: ../../tests/write-tests.md:84 msgid "" @@ -1324,4 +1324,4 @@ msgid "" "message)." msgstr "" "**コードが正しく失敗するかテストする** 関数が1以上の値を必要とする場合は、0.999でテストします。 " -"予期しない値やヘルプが与えられたときに、関数が優雅に失敗し、ユーザが失敗した理由を簡単に理解できるようにします(有用なエラーメッセージを提供します)。" +"予期しない値やヘルプが与えられたときに、関数が差し障り無く失敗し、ユーザが失敗した理由を簡単に理解できるようにします(有用なエラーメッセージを提供します)。"