Odd... importing pymel in sphinx works for us, since that's what we use for
pymel's documentation.  Chad did make a few tweaks to sphinx though - I
thought it was mostly just to add "more features," as opposed to making it
work at all... but I could be wrong.

- Paul

On Fri, Jan 8, 2010 at 8:34 AM, David Moulder <[email protected]>wrote:

> I don't want to generate documentation for maya and pymel.  Just our own
> custom python modules.  I can do that with sphinx but obviously all our
> python module inport pymel.  imports using pymel or openmaya crash the
> builder.  I'll give this ago,
>
> Cheers Chad
>
> -Dave
>
> On Fri, Jan 8, 2010 at 4:17 PM, Chad Dombrova <[email protected]> wrote:
>
>> here's a little trick i learned.  go to where you unzipped pymel, where
>> the setup.py file resides. then try:
>>
>> mayapy setup.py easy_install sphinx
>>
>> btw, generating documentation for pymel and maya is not a simple test
>> case.  you should pick something a bit simpler.  we actually use a modified
>> version of their latest development version from bitbucket along with a lot
>> of custom templates to get it to work properly.  sphinx still has a ways to
>> come before it's a robust API-style documentation generator.
>>
>> -chad
>>
>>
>>
>> On Jan 8, 2010, at 6:35 AM, David Moulder wrote:
>>
>> Got a little further with this.
>>
>> Sphinx works if I don't import anything importing OpenMaya (Pymel being on
>> of these)
>>
>> I think I need to install Sphinx with Mayapy.   Only thing I can't seem to
>> work that out.  I can only install setupTools against my default Python
>> install with the SetupTools.exe  I tried using eay_install to -d flag to put
>> sphinx into Maya's site packages.   But that errors becase of C:\Program
>> Files (x86) has a space....
>>
>> Anyone?
>>
>>
>> Cheers
>> -Dave
>>
>>
>> On Fri, Jan 8, 2010 at 10:21 AM, thirstydevil 
>> <[email protected]>wrote:
>>
>>> Hi Guys and Gals,
>>>
>>> I'm trying to get Sphinx to auto document our modules here at work.
>>> However I'm running into problems with the build.
>>>
>>> While I'm testing I've just created a simple py file that imports
>>> pymel, cmds, os, sys.  A basic class with some dummy functions and
>>> test doc strings.
>>>
>>> in the config,py file I've added pymel, maya(from maya's site-
>>> packages) and the path the my py file.
>>> I've created .rst file for my module
>>>
>>> Paths added in the config file are :-
>>>
>>> # Paths to my modules
>>> sys.path.append(os.path.abspath("E:\\CODE\\SVN_Branch\\Maya\
>>> \Maya_Modules\\Modules\\CoreLibs\\PyLib"))
>>> sys.path.append(os.path.abspath("E:\\CODE\\SVN_Branch\\Maya\
>>> \Maya_Modules\\Modules\\CoreLibs\\PyLib\\eCore"))
>>> # Pymel path
>>> sys.path.append(os.path.abspath("C:\\ArtPipelines\\App\\Maya2010-
>>> x86"))
>>> # Maya Path
>>> sys.path.append(os.path.abspath("C:\\Program Files (x86)\\Autodesk\
>>> \Maya2010\\Python\\lib\\site-packages"))
>>>
>>> index.rst :-
>>>
>>> :mod:`eGeneral`
>>> ==========================================
>>>
>>> .. module:: eGeneral
>>>   :synopsis: Test synopsis
>>>
>>> .. automodule:: eCore.eGeneral
>>>
>>>
>>>  and linked it into the toctree in index.rst
>>>
>>> Contents:
>>>
>>> .. toctree::
>>>   :maxdepth: 1
>>>
>>>   modules/eFile.rst
>>>
>>>
>>> Then I run >>>$sphinx-build . html
>>> and get the followinh error.  Can't import/find module
>>> "eCore.eGeneral", DLL load failed: The specified proceedure could not
>>> be found. check the sys.path
>>>
>>> I used easy_install and installed sphinx to my system python 2.6.  I
>>> wonder if I need to install this to Maya's mayapy.
>>>
>>> Anyone got any tips or ideas would be much appreciated.
>>>
>>> Thanks people
>>>
>>> -Dave
>>>
>>> --
>>> http://groups.google.com/group/python_inside_maya
>>>
>>
>> --
>> http://groups.google.com/group/python_inside_maya
>>
>>
>>
>> --
>> http://groups.google.com/group/python_inside_maya
>>
>
>
> --
> http://groups.google.com/group/python_inside_maya
>
-- 
http://groups.google.com/group/python_inside_maya

Reply via email to