chemistry-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jeff Potts <jeffpott...@gmail.com>
Subject Re: sphinx @ hudson
Date Thu, 09 Dec 2010 15:04:39 GMT
Yes, I noticed that. That's an issue for us because Sphinx uses introspection to document cmislib.
So if he can't find the classes, the doc will be incomplete. The issue is probably that when
the executor box checks out the code from SVN, cmislib isn't added to that machine's Python
lib path. I'll see if I can tweak run-sphinx.py further to make that happen.

Jeff

On Dec 9, 2010, at 1:19 AM, Klevenz, Stephan wrote:

> Jeff,
> 
> It looks better now:
> 
> https://hudson.apache.org/hudson/view/A-F/view/Chemistry/job/Chemistry-Phyton-cmislib-doc/8/console
> 
> Some imports of own libs are not resolved.
> 
> Stephan
> 
> 
> 
> -----Original Message-----
> From: Jeff Potts [mailto:jeffpotts01@gmail.com] 
> Sent: Mittwoch, 8. Dezember 2010 22:11
> To: chemistry-dev@incubator.apache.org
> Subject: Re: sphinx @ hudson
> 
> Stephan,
> 
> Checked in a new version of the script. We'll see if that does it. I think the prob is
that the sphinx bin on my machine is sphinx-build2.6 while it is probably just sphinx-build
on the Hudson executor box.
> 
> Jeff
> 
> On Dec 8, 2010, at 2:46 PM, Stephan Klevenz wrote:
> 
>> Jeff,
>> 
>> Again, me ;)
>> 
>> Sphinx is now installed on all Ubuntu systems. Source of Sphinx was this: http://sphinx.pocoo.org
>> 
>> The job still shows an error:
>> 
>> https://hudson.apache.org/hudson/job/Chemistry-Phyton-cmislib-doc/7/console
>> 
>> Is this something you can fix? If not what is expected from environment?
>> 
>> BTW If the script returns <> 0 in case of error then Hudson will mark the job
as failed and send a notification to the mailing list. Maybe this is useful.
>> 
>> Regards,
>> Stephan
>> 
>> 
>> Am 08.12.2010 um 17:25 schrieb Klevenz, Stephan:
>> 
>>> Hi Jeff,
>>> 
>>> This is now a good point to go ahead with
>>> 
>>> https://issues.apache.org/jira/browse/INFRA-3202
>>> 
>>> Is there another dependency apart of sphinx? I assume Hudson needs a installation
as described here http://sphinx.pocoo.org/, Right?
>>> 
>>> Regards,
>>> Stephan
>>> 
>>> 
>>> 
>>> -----Original Message-----
>>> From: Jeff Potts [mailto:jeffpotts01@gmail.com] 
>>> Sent: Mittwoch, 8. Dezember 2010 15:36
>>> To: chemistry-dev@incubator.apache.org
>>> Subject: Re: sphinx @ hudson
>>> 
>>> Stephan,
>>> 
>>> I adjusted the run-sphinx.py script so that it would run regardless of where
it was called from. From the output of the latest build (https://hudson.apache.org/hudson/job/Chemistry-Phyton-cmislib-doc/6/console)
it looks like Sphinx has either not yet been installed or is not in the path.
>>> 
>>> My make file is set to look for an executable called "sphinx-build2.6", which
according to the log, isn't found.
>>> 
>>> Jeff
>>> 
>>> On Dec 7, 2010, at 4:25 AM, Klevenz, Stephan wrote:
>>> 
>>>> Hi Jeff,
>>>> 
>>>> There is now a Hudson job (Chemistry-Phyton-cmislib-doc) executing the Phyton
script that you have provided:  
>>>> 
>>>> https://hudson.apache.org/hudson/view/A-F/view/Chemistry/
>>>> 
>>>> The execution runs once a day (3am server time) and every time when you commit
a change to svn. The SVN poll time is 1 hour and execution depends also on the traffic of
the build queue.
>>>> 
>>>> Now it is up to you to let the sphinx script do the necessary tasks. 
>>>> 
>>>> To track execution please use the console view of Hudson:
>>>> 
>>>> e.g. https://hudson.apache.org/hudson/view/A-F/view/Chemistry/job/Chemistry-Phyton-cmislib-doc/1/console
>>>> 
>>>> In case of missing dependencies we have to identify them and contact Admins
for support. 
>>>> 
>>>> Regards,
>>>> Stephan
>>>> 
>>>> 
>>>> 
>>>> 
>>>> 
>>>> -----Original Message-----
>>>> From: Jeff Potts [mailto:jeffpotts01@gmail.com] 
>>>> Sent: Donnerstag, 2. Dezember 2010 15:51
>>>> To: chemistry-dev@incubator.apache.org
>>>> Subject: Re: sphinx @ hudson
>>>> 
>>>> Stephan,
>>>> 
>>>> I've checked in the wrapper script:
>>>> /cmislib/src/doc/src/run-sphinx.py
>>>> 
>>>> Hopefully, that's all you need to get Hudson triggering the cmislib doc build.
If not, let me know and we'll try something else.
>>>> 
>>>> Jeff
>>>> 
>>>> On Nov 30, 2010, at 2:09 AM, Klevenz, Stephan wrote:
>>>> 
>>>>> Well, the script will be in SVN and you can modify it anytime. Hudson
can sync the script from SVN and triggers only its execution. This is a recommended practice
for the Hudson.
>>>>> 
>>>>> Have a look here: https://issues.apache.org/jira/browse/INFRA-3202
>>>>> 
>>>>> Regards,
>>>>> Stephan
>>>>> 
>>>>> 
>>>>> -----Original Message-----
>>>>> From: Jeff Potts [mailto:jeffpotts01@gmail.com] 
>>>>> Sent: Montag, 29. November 2010 18:25
>>>>> To: chemistry-dev@incubator.apache.org
>>>>> Subject: Re: sphinx @ hudson
>>>>> 
>>>>> Stephan,
>>>>> 
>>>>> The doc build is command-line. A python script could execute the same
command-line that a shell script would but what does that buy us?
>>>>> 
>>>>> Jeff
>>>>> 
>>>>> On Nov 29, 2010, at 10:53 AM, Klevenz, Stephan wrote:
>>>>> 
>>>>>> Jeff,
>>>>>> 
>>>>>> Sorry for late response, but I was busy with other activities last
couples of days.
>>>>>> 
>>>>>> One option to get such a build job is to check in a phyton script
to SVN. As a native build job Hudson has access to it an can execute the script.
>>>>>> 
>>>>>> Can you provide such a script?
>>>>>> 
>>>>>> Regards,
>>>>>> Stephan
>>>>>> 
>>>>>> -----Original Message-----
>>>>>> From: Stephan Klevenz [mailto:stephan@klaeff.de] 
>>>>>> Sent: Montag, 15. November 2010 20:17
>>>>>> To: chemistry-dev@incubator.apache.org
>>>>>> Subject: Re: sphinx @ hudson
>>>>>> 
>>>>>> Hi Jeff,
>>>>>> 
>>>>>> I did create a Jira issue for this:
>>>>>> 
>>>>>> https://issues.apache.org/jira/browse/INFRA-3202
>>>>>> 
>>>>>> As soon as the environment is available I can volunteer to setup
a Hudson build job.
>>>>>> 
>>>>>> Regards,
>>>>>> Stephan
>>>>>> 
>>>>>> 
>>>>>> Am 10.11.2010 um 22:43 schrieb Niklas Gustavsson:
>>>>>> 
>>>>>>> Please open a JIRA issue with this request. If appropriate, provide
>>>>>>> installation instructions on one of the slaves OSes (preferably
on
>>>>>>> Ubuntu using apt-get).
>>>>>>> 
>>>>>>> /niklas
>>>>>>> 
>>>>>>> On Wed, Nov 10, 2010 at 9:29 PM, Stephan Klevenz <stephan@klaeff.de>
wrote:
>>>>>>>> Hi build admins,
>>>>>>>> 
>>>>>>>> The Apache Chemistry project (http://incubator.apache.org/chemistry/)
would like to build documentation with Hudson and require a tool called Sphinx. How that works
with Hudson is described here:
>>>>>>>> 
>>>>>>>> http://blog.timc3.com/2010/03/21/using-hudson-to-build-sphinx-documentation/
>>>>>>>> 
>>>>>>>> In summary the Hudson requirements are:
>>>>>>>> Hudson Python plugin
>>>>>>>> pip installed for python
>>>>>>>> VirtualEnv installed for python
>>>>>>>> The build script is this:
>>>>>>>> 
>>>>>>>>  cd $WORKSPACE
>>>>>>>>  virtualenv -q docs
>>>>>>>>  source ./docs/bin/activate
>>>>>>>>  pip install -q -E ./docs -r trunk/requirements.pip
>>>>>>>>  cd trunk
>>>>>>>>  sphinx-build -b html source build
>>>>>>>> 
>>>>>>>> Is this from general interest and supported by Apache Hudson?
If not then is there an option to get this within a local environment?
>>>>>>>> 
>>>>>>>> Regards,
>>>>>>>> Stephan
>>>>>> 
>>>>>> ----
>>>>>> Stephan Klevenz
>>>>>> 
>>>>>> Fabrikstr. 45
>>>>>> 69126 Heidelberg
>>>>>> 
>>>>>> Tel.: +49 6221 879625
>>>>>> Fax.: +49 6221 339926
>>>>>> 
>>>>>> 
>>>>>> 
>>>>>> 
>>>>>> 
>>>>> 
>>>> 
>>> 
>> 
>> ----
>> Stephan Klevenz
>> 
>> Fabrikstr. 45
>> 69126 Heidelberg
>> 
>> Tel.: +49 6221 879625
>> Fax.: +49 6221 339926
>> Email: stephan@klaeff.de
>> 
>> 
>> 
>> 
>> 
>> 
> 


Mime
View raw message