�
��g� � � � S r SSKrSSKrSSKrSSKrSSKJr SSKrSSKrSSK r SSK
J r SSK J
r " S S\5 rS\
S 4S
jrSS S 4S
jrg)au Bootstrap PyUNO Runtime.
The soffice process is started opening a named pipe of random name, then
the local context is used to access the pipe. This function directly
returns the remote component context, from whereon you can get the
ServiceManager by calling getServiceManager() on the returned object.
This module supports the following environments:
- Windows
- GNU/Linux derivatives
- Mac OS X
A configurable time-out allows to wait for LibO process to be completed.
Multiple attempts can be set in order to connect to LibO as a service.
Specific versions of the office suite can be started.
Instructions:
1. Include one of the below examples in your Python macro
2. Run your LibreOffice script from your preferred IDE
Imports:
os, random, subprocess, sys - `bootstrap`
itertools, time - `retry` decorator
Exceptions:
OSError - in `bootstrap`
BootstrapException - in `bootstrap`
NoConnectException - in `bootstrap`
Functions:
`bootstrap`
`retry` decorator
Acknowledgments:
- Kim Kulak for original officehelper.py Python translation from bootstrap.java
- ActiveState, for `retry` python decorator
warning:: Tested platforms are Linux, Mac OS X & Windows
AppImage, Flatpak, Snap and the like have not been validated
:References:
.. _ActiveState retry Python decorator: http://code.activestate.com/recipes/580745-retry-decorator-in-python/
� N)�platform)�NoConnectException)� Exceptionc � � \ rS rSrSrg)�BootstrapException�C � N)�__name__�
__module__� __qualname__�__firstlineno__�__static_attributes__r � �,/usr/lib/libreoffice/program/officehelper.pyr r C s � �r r )r � � � � iX i c � � g �Nr ��argss r �<lambda>r I s � �tr c � ^ ^^� U UU4S jnU$ )zeretry Python decorator
Credit:
http://code.activestate.com/recipes/580745-retry-decorator-in-python/
c � >^ � UUU U4S jnU$ )Nc � >� / n[ R " TS /5 H n T" U 0 UD6s $ g ! T aL nUR U5 Uc
T" SU5 e T" SUSU- 5 [ R " U5 S nAM^ S nAff = f)Nz retryable failed definitely:zretryable failed:z-- delaying for %ds)� itertools�chain�append�time�sleep) r �kwargs�problems�delay�problem�delays� exception�function�reports ����r �wrapped�'retry.<locals>.wrapper.<locals>.wrappedO s� �� ��H�"� � ��$��8��
*�#�T�4�V�4�4� 9� �� !� *� �O�O�G�,� �}� � =�x�H� � � 2�G� 4�u� <�>� �
�
�5�)�)��*�s �-�A?�AA:�:A?r )r( r* r& r' r) s ` ���r �wrapper�retry.<locals>.wrapperN s �� � � � �r r )r& r' r) r, s ``` r �retryr. G s �� ��" �Nr )r � r � c � � g r r r s r r r b s � �dr c � ^ ^ � SnU ( a U nOS[ R ; a [ R S nOSn[ R R US5 n[ R
" S5 ( a US-
nSU- S- nO [ S:X a S n[ R " 5 S
[ [ R " 5 5 S S - nSR S US
/5 nSR USSSU- S- /5 n[ R
" S5 ( d
[ S:X a [ R " USS9nO5[ S:X a% [ R " US[ R S9nO[ e[ R " 5 nUR R! SU5 m SR SUS/5 m [# U[$ US9U U 4S j5 n U " 5 n
U
$ ! [& a� [( R* " S5 W( a� [ R
" S5 ( d
[ S:X a UR- 5 [8 e[ S:X aC [ R. " [ R0 " UR2 5 [4 R6 5 [8 ef = f) a� Bootstrap PyUNO Runtime.
The soffice process is started opening a named pipe of random name,
then the local context is used to access the pipe. This function
directly returns the remote component context, from whereon you can
get the ServiceManager by calling getServiceManager() on the
returned object.
Examples:
i. Start LO as a service, get its remote component context
import officehelper
ctx = officehelper.bootstrap()
# your code goes here
ii. Wait longer for LO to start, request context multiples times
+ Report processing in console
import officehelper as oh
ctx = oh.bootstrap(delays=(5,10,15,20),report=print) # wait 5, 10, 15 and 20 sec.
# your code goes here
iii. Use a specific LibreOffice copy
from officehelper import bootstrap
ctx = bootstrap(soffice=r"USB:\PortableApps\libO-7.6\App\libreoffice\program\soffice.exe")
# your code goes here
N�UNO_PATH� �soffice�winz.exe�"�darwinz4/Applications/LibreOffice.App/Contents/MacOS/soffice�uno� z
pipe,name=z;urp;� z--nologoz --nodefaultz
--accept="T)�shell�linux)r< �
preexec_fnz"com.sun.star.bridge.UnoUrlResolverzuno:zStarOffice.ComponentContext)r& r' r) c �& >� T R T5 $ r )�resolve)�resolver�sConnects ��r r@ �bootstrap.<locals>.resolve� s �� � �#�#�H�-� -r �
) �os�environ�path�joinr �
startswith�random�seed�str�
subprocess�Popen�setsid�OSErrorr9 �getComponentContext�ServiceManager�createInstanceWithContextr. r r r r! � terminate�killpg�getpgid�pid�signal�SIGTERMr )
r5 r& r) �process�sOffice� sPipeName�connect_string�command�
xLocalContextr@ �ctxrA rB s
@@r � bootstrapra b s �� �</!��� � �G��R�Z�Z�'� �*�*�Z�0�� ���g�g�l�l�7�I�6�G��"�"�5�)�)��6�!�� ��-�#�-���X�%�P��� � �
��C��
�
�� 0��� 4�4� ����,� �7�!C�D���(�(�G�Z� � �~�@]�`c�@c�d�e�� � � �u� %� %��X�)=� �&�&�w�d�;�G�
��
� �&�&�w�d�r�y�y�Q�G��M��/�/�1�
� �/�/�I�I� 0�-�A���7�7�F�N�4Q�R�S�� �f�+� �
� .�
� .��i���
�� � !� �
�
�2�� ��"�"�5�)�)�X��-A��!�!�#� !� � �W�$�� � �"�*�*�W�[�[�1�6�>�>�B� � �!�s
�G G �B6J)�__doc__rE rJ rX rM �sysr r r r9 �com.sun.star.connectionr �com.sun.star.unor � UnoExceptionr r. ra r r r �<module>rg sW ��& �D
�
�
� � � � �
� 6� 6� � � � /� �#��6 �<�8J� M!r