This paragraph describes the required setup and configuration of your system to develop MRV or projects based on MRV.
The following software packages need to be installed,
- Nose 0.11 or higher
- Coverage ( optional )
- Epydoc 3.x
- Sphinx 0.65 or higher
The following installation guide assumes you have already installed git and Autodesk Maya for your platform. For instruction, please see the documentations of the respective software package.
The basic installation steps are similar in all supported operating systems. Getting MRV to run within a standalone interpreter differs between the platforms.
If a standalone interpreter does not work for you, its absolutely possible to run MRV within the default maya python interpreter, mayapy.
The instructions assume you are going to run MRV within a standalone interpreter. If you are planning to use mayapy, the installation may be more complicated, but in general all that needs to be done is to put the required package(s) into the ‘site-packages’ folder of your python installation.
Using easy_install, which comes with the python setuptools the installation is as easy as the name suggests:
$ easy_install<python_version> nose epydoc sphinx gitpython ipython
Please note that the version of easy_install is important as you need to install the prerequisites for each python version that is used by the maya version you are going to run:
The only package that you need to install to run the tests is nose. It is recommended to retrieve the package using easy_install for your standalone interpreter and to alter your PYTHONPATH to include the site-packages directory of your local python installation.
Alternatively, copy the nose package into “C:\Program Files\Autodesk\Maya<version>\Python\Lib\site-packages” ( windows ), into “/usr/autodesk/maya<version>/lib/python<pyversion>/site-packages” ( Linux ) or into “/Applications/Autodesk/maya<version>/Maya.app/Contents/Frameworks/Python.framework/Versions/<pyversion>/lib/python<pyversion>/site-packages” ( OSX ).
Clone the MRV mainline repository from github, or fork your own on https://github.com/mrv-developers/mrv and clone from your fork, or clone from the mainline repository as shown here.
Execute the following:
$ git clone git@github.com:mrv-developers/mrv.git mrv
$ cd mrv
$ git submodule update --init
On linux and OSX, you would have done this in a shell of your choice. On windows, you would have retrieved a shell using the “Git Bash Here” menu entry in your RMB explorer menu when clicking on a parent-folder of your choice.
On Windows, make sure that the MRV repository has at least one folder between itself and the drive letter. Otherwise you are not able to run tests properly due to some issue with nose on windows (apparently).
- c:\mrv\[.git]
- c:\projects\mrv\[.git]
By running the tests, you verify that the installation actually succeeded as you are able to run MRV in a standalone interpreter.
In your shell, you should now be able to execute the tmrv command as follows:
$ cd mrv
$ # start the tests for the given maya version, 2011 in this case
$ test/bin/tmrv <maya-version>
All tests are expected to succeed. The given <maya-version>, i.e. 2011 must cause mrv to launch the python version you installed the prerequisites for - 2011 would trigger python 2.6 to be launched for instance.
Please note that tmrv just executes mrv/bin/mrv and launches nosetest afterwards, hence all parameters supported by nosetests in your particular installation will work here as well.
On OSX Snow Leopard, the default python installation will not work if you intend to run Maya2010 or earlier. Please see the Troubleshooting guide for a solution which is essentially using mayapy. This can be achieved using the following command:
$ test/bin/tmrv 2011 --mrv-mayapy
On windows, in a command prompt, execute:
$ cd mrv
$ python test\bin\tmrv 2011 <full/path/to/test/directory>
Note
On windows, you can use the same commands presented here if you use a git-bash instead of cmd.exe.
This paragraph informs about possible issues which have a solution already.
Starting with Maya2011, maya is delivered as 64 bit binary. The default interpreter in your path should be 64 bits as well, but if it is not, you have to make some adjustments. Conversely, Maya2010 uses Pyhthon2.6 which is 64 bit on Snow Leopard, whereas Maya was just compiled in 32 bits.
To solve the issue, either install a python interpreter which matches the architecture of your respective maya version, or enforce using mayapy by specifying the --mrv-mayapy flag to the mrv tools.
If the standalone interpreter just doesn’t want to work on your platform or with your particular configuration, you may always use mayapy, which can be found in the <maya_install_directory>/bin folder. It will setup a standalone interpreter which automatically pulls in the packages required for Maya to work.
As a side-effect, nose needs to be installed in mayapy’s site-packages directory, as indicated in the installation section.
To force using mayapy, use the --mrv-mayapy flag:
$ # start the mayapy python interpreter in interactive mode
$ bin/mrv 2011 --mrv-mayapy
$ # run all tests in mayapy
$ /test/bin/tmrv 2009 --mrv-mayapy