.. Installation

============
インストール
============

.. This tutorial assumes that Python and virtualenv are already installed
.. and working in your system. If you need help setting this up, you should
.. refer to the chapters on :ref:`installing_chapter`.

このチュートリアルは、あなたのシステムに Python と virtualenv が既に
インストールされて動作する状態になっていることを想定しています。
もしこの環境構築に助けが必要な場合、 :ref:`installing_chapter` の章を
参照してください。


.. Preparation

準備
===========

.. Please take the following steps to prepare for the tutorial.  The
.. steps are slightly different depending on whether you're using UNIX or
.. Windows.

チュートリアルの準備をするには次の手順を実行します。
手順はUNIXまたはWindowsを使っているかによって、若干異なります。


.. Preparation, UNIX

準備 (UNIX)
-----------------

.. #. Install SQLite3 and its development packages if you don't already
..    have them installed.  Usually this is via your system's package
..    manager.  For example, on a Debian Linux system, do ``sudo apt-get
..    install libsqlite3-dev``.

1. まだインストールしていなければ SQLite3 とその開発用パッケージの
   インストール。通常これはシステムのパッケージマネージャーを介して行います。
   例えば Debian Linuxシステムでは ``sudo apt-get install
   libsqlite3-dev`` を実行します。


.. #. Use your Python's virtualenv to make a workspace:

2. virtualenv を使ってワークスペースを作成します:


   .. code-block:: text

      $ path/to/my/Python-2.6/bin/virtualenv --no-site-packages pyramidtut


.. #. Switch to the ``pyramidtut`` directory:

3. ``pyramidtut`` ディレクトリに移動します:


   .. code-block:: text

      $ cd pyramidtut


.. #. Use ``easy_install`` to get :app:`Pyramid` and its direct
..    dependencies installed:

4. ``easy_install`` を使って :app:`Pyramid` と直接の依存関係を
   インストールします:


   .. code-block:: text

      $ bin/easy_install pyramid


.. Preparation, Windows

準備 (Windows)
--------------------

.. #. Use your Python's virtualenv to make a workspace:

1. virtualenv を使ってワークスペースを作成します:


   .. code-block:: text

      c:\> c:\Python26\Scripts\virtualenv --no-site-packages pyramidtut


.. #. Switch to the ``pyramidtut`` directory:

2. ``pyramidtut`` ディレクトリに移動します:


   .. code-block:: text

      c:\> cd pyramidtut


.. #. Use ``easy_install`` to get :app:`Pyramid` and its direct
..    dependencies installed:

3. ``easy_install`` を使って :app:`Pyramid` と直接の依存関係を
   インストールします:


   .. code-block:: text

      c:\pyramidtut> Scripts\easy_install pyramid


.. Making a Project

.. _sql_making_a_project:

プロジェクトの作成
==================

.. Your next step is to create a project.  :app:`Pyramid` supplies a
.. variety of scaffolds to generate sample projects.  We will use the
.. ``alchemy`` scaffold, which generates an application
.. that uses :term:`SQLAlchemy` and :term:`URL dispatch`.

次のステップはプロジェクトを作成することです。 :app:`Pyramid` はサンプル
プロジェクトを作成するための様々な骨組み (scaffold) を提供しています。
私たちは scaffold として ``alchemy`` を使用します。これは
:term:`SQLAlchemy` と :term:`URL dispatch` を使用するアプリケーションを
生成します。


.. The below instructions assume your current working directory is the
.. "virtualenv" named "pyramidtut".

以下の説明では、現在の作業ディレクトリが "pyramidtut" という名前の
"virtualenv" であると仮定しています。


.. On UNIX:

UNIX の場合:


.. code-block:: text

   $ bin/pcreate -s alchemy tutorial


.. On Windows:

Windows の場合:


.. code-block:: text

   c:\pyramidtut> Scripts\pcreate -s alchemy tutorial


.. .. note:: If you are using Windows, the ``alchemy``
..    scaffold may not deal gracefully with installation into a
..    location that contains spaces in the path.  If you experience
..    startup problems, try putting both the virtualenv and the project
..    into directories that do not contain spaces in their paths.

.. note::

   Windows を使っている場合、 ``alchemy`` scaffold はパスにスペースが
   含まれている場所には簡単にインストールできないかもしれません。もし
   startup で問題に遭遇したら、 virtualenv とプロジェクトの両方を
   パスにスペースが含まれていないディレクトリに置いてみてください。


.. Installing the Project in "Development Mode"

開発モードでのプロジェクトのインストール
============================================

.. In order to do development on the project easily, you must "register"
.. the project as a development egg in your workspace using the
.. ``setup.py develop`` command.  In order to do so, cd to the "tutorial"
.. directory you created in :ref:`sql_making_a_project`, and run the
.. "setup.py develop" command using virtualenv Python interpreter.

簡単にプロジェクトの開発をするために、 ``setup.py develop`` コマンドを
使ってプロジェクトを開発用 egg として作業用スペースに "登録" する必要が
あります。これをするために、 :ref:`sql_making_a_project` で作成した
"tutorial" ディレクトリに移動します。そして virtualenv の Python インタプリタ
を使って "setup.py develop" コマンドを実行します。


.. On UNIX:

UNIX の場合:


.. code-block:: text

   $ cd tutorial
   $ ../bin/python setup.py develop


.. On Windows:

Windows の場合:


.. code-block:: text

   c:\pyramidtut> cd tutorial
   c:\pyramidtut\tutorial> ..\Scripts\python setup.py develop


.. Success executing this command will end with a line to the console something
.. like:

このコマンドの実行に成功すると、コンソールに次のような出力が行われるでしょう:


::

   Finished processing dependencies for tutorial==0.0


.. Running the Tests

.. _sql_running_tests:

テストの実行
=================

.. After you've installed the project in development mode, you may run
.. the tests for the project.

開発モードでインストールした後で、プロジェクトに対するテストを実行する
ことができます。


.. On UNIX:

UNIX の場合:


.. code-block:: text

   $ ../bin/python setup.py test -q


.. On Windows:

Windows の場合:


.. code-block:: text

   c:\pyramidtut\tutorial> ..\Scripts\python setup.py test -q


.. For a successful test run, you should see output that ends like this:

テストの実行に成功すると、次のような出力が見られるはずです:


::

  .
  ----------------------------------------------------------------------
  Ran 1 test in 0.094s
 
  OK


.. Exposing Test Coverage Information

テストカバレッジ情報の抽出
==================================

.. You can run the ``nosetests`` command to see test coverage
.. information.  This runs the tests in the same way that ``setup.py
.. test`` does but provides additional "coverage" information, exposing
.. which lines of your project are "covered" (or not covered) by the
.. tests.

``nosetests`` コマンドを実行してテストカバレッジを見ることができます。
これは ``setup.py test`` と同じ方法でテストを実行しますが、追加の
"カバレッジ" 情報を提供し、そのプロジェクトの行がテストで "カバーされて
いる" (もしくはカバーされていない) かを抽出します。


.. To get this functionality working, we'll need to install a couple of
.. other packages into our ``virtualenv``: ``nose`` and ``coverage``:

この機能を動かすには、 ``virtualenv`` に追加で 2 つのパッケージ
``nose`` と ``coverage`` をインストールする必要があります。


.. On UNIX:

UNIX の場合:


.. code-block:: text

   $ ../bin/easy_install nose coverage


.. On Windows:

Windows の場合:


.. code-block:: text

   c:\pyramidtut\tutorial> ..\Scripts\easy_install nose coverage


.. Once ``nose`` and ``coverage`` are installed, we can actually run the
.. coverage tests.

``nose`` と ``coverage`` をインストールすると、実際にカバレッジテストが
実行できます。


.. On UNIX:

UNIX の場合:


.. code-block:: text

   $ ../bin/nosetests --cover-package=tutorial --cover-erase --with-coverage


.. On Windows:

Windows の場合:


.. code-block:: text

   c:\pyramidtut\tutorial> ..\Scripts\nosetests --cover-package=tutorial ^
         --cover-erase --with-coverage


.. If successful, you will see output something like this:

成功すると、次のような出力が見られるでしょう:


::

  .
  Name               Stmts   Miss  Cover   Missing
  ------------------------------------------------
  tutorial              11      7    36%   9-15
  tutorial.models       17      0   100%   
  tutorial.scripts       0      0   100%   
  tutorial.tests        24      0   100%   
  tutorial.views         6      0   100%   
  ------------------------------------------------
  TOTAL                 58      7    88%   
  ----------------------------------------------------------------------
  Ran 1 test in 0.459s

  OK


.. Looks like our package doesn't quite have 100% test coverage.

私たちのパッケージは 100% のテストカバレッジではないようです。


.. Initializing the Database

データベースの初期化
=========================

.. We need to use the ``initialize_tutorial_db`` :term:`console
.. script` to initialize our database.

データベースを初期化するために ``initialize_tutorial_db``
:term:`console script` を使用する必要があります。


.. Type the following command, make sure you are still in the ``tutorial``
.. directory (the directory with a ``development.ini`` in it):

``tutorial`` ディレクトリ (``development.ini`` のあるディレクトリ) の中
にいることを確認して、次のコマンドをタイプしてください:


.. On UNIX:

UNIX の場合:


.. code-block:: text

   $ ../bin/initialize_tutorial_db development.ini


.. On Windows:

Windows の場合:


.. code-block:: text

   c:\pyramidtut\tutorial> ..\Scripts\initialize_tutorial_db development.ini


.. The output to your console should be something like this:

コンソールに対して次のような出力が行われるはずです:


::

  2011-11-26 14:42:25,012 INFO  [sqlalchemy.engine.base.Engine][MainThread] 
                                PRAGMA table_info("models")
  2011-11-26 14:42:25,013 INFO  [sqlalchemy.engine.base.Engine][MainThread] ()
  2011-11-26 14:42:25,013 INFO  [sqlalchemy.engine.base.Engine][MainThread] 
  CREATE TABLE models (
  	id INTEGER NOT NULL, 
  	name VARCHAR(255), 
  	value INTEGER, 
  	PRIMARY KEY (id), 
  	UNIQUE (name)
  )
  2011-11-26 14:42:25,013 INFO  [sqlalchemy.engine.base.Engine][MainThread] ()
  2011-11-26 14:42:25,135 INFO  [sqlalchemy.engine.base.Engine][MainThread] 
                                COMMIT
  2011-11-26 14:42:25,137 INFO  [sqlalchemy.engine.base.Engine][MainThread] 
                                BEGIN (implicit)
  2011-11-26 14:42:25,138 INFO  [sqlalchemy.engine.base.Engine][MainThread] 
                                INSERT INTO models (name, value) VALUES (?, ?)
  2011-11-26 14:42:25,139 INFO  [sqlalchemy.engine.base.Engine][MainThread] 
                                (u'one', 1)
  2011-11-26 14:42:25,140 INFO  [sqlalchemy.engine.base.Engine][MainThread] 
                                COMMIT


.. Success!  You should now have a ``tutorial.db`` file in your current working
.. directory.  This will be a SQLite database with a single table defined in it
.. (``models``).

成功です! 現在の作業ディレクトリに ``tutorial.db`` ファイルができている
はずです。このファイルは、単一のテーブルが定義された SQLite データベース
(``models``) になります。


.. Starting the Application

.. _wiki2-start-the-application:

アプリケーションの起動
==========================

.. Start the application.

アプリケーションを起動します。


.. On UNIX:

UNIX の場合:


.. code-block:: text

   $ ../bin/pserve development.ini --reload


.. On Windows:

Windows の場合:


.. code-block:: text

   c:\pyramidtut\tutorial> ..\Scripts\pserve development.ini --reload


.. If successful, you will see something like this on your console:

成功すると、コンソールに次のような出力が見られるでしょう:


::

  Starting subprocess with file monitor
  Starting server in PID 8966.
  Starting HTTP server on http://0.0.0.0:6543


.. This means the server is ready to accept requests.

これは、サーバーがリクエストを受け付ける準備ができていることを意味します。


.. At this point, when you visit ``http://localhost:6543/`` in your web browser,
.. you will see the generated application's default page.

この時点で、ウェブブラウザで ``http://localhost:6543/`` を開くと、
生成されたアプリケーションのデフォルトページが表示されるでしょう。


.. One thing you'll notice is the "debug toolbar" icon on right hand side of the
.. page.  You can read more about the purpose of the icon at
.. :ref:`debug_toolbar`.  It allows you to get information about your
.. application while you develop.

ページの右側に "デバッグツールバー" アイコンがあるのに気が付くと思います。
アイコンの用途について詳しいことは :ref:`debug_toolbar` で読むことができます。
それは開発中にアプリケーションに関する情報を取得することができます。


.. Decisions the ``alchemy`` Scaffold Has Made For You

``alchemy`` scaffold が決めてくれること
=================================================================

.. Creating a project using the ``alchemy`` scaffold makes
.. the following assumptions:

``alchemy`` scaffold を使ってプロジェクトを作成すると、次のことが仮定されます:


.. - you are willing to use :term:`SQLAlchemy` as a database access tool

- データベースアクセスツールとして :term:`SQLAlchemy` を使用する


.. - you are willing to use :term:`url dispatch` to map URLs to code.

- URLからコードへのマッピング方法に :term:`url dispatch` を使用する


.. .. note::

..    :app:`Pyramid` supports any persistent storage mechanism (e.g. object
..    database or filesystem files, etc).  It also supports an additional
..    mechanism to map URLs to code (:term:`traversal`).  However, for the
..    purposes of this tutorial, we'll only be using url dispatch and
..    SQLAlchemy.

.. note::

   :app:`Pyramid` は任意の永続化ストレージ機構をサポートしています
   (例えば、オブジェクトデータベースやファイルシステムなど)。
   また、URLからコードへのマッピングを行う追加の方法もサポートします
   (:term:`traversal`)。 しかし、このチュートリアルの用途には
   url dispatch と SQLAlchemy だけを使用します。