pax_global_header00006660000000000000000000000064123002014220014474gustar00rootroot0000000000000052 comment=87e5eaf4707261dfcb37d7daadef018266c83d5a pyotherside-1.2.0/000077500000000000000000000000001230020142200140335ustar00rootroot00000000000000pyotherside-1.2.0/LICENSE000066400000000000000000000014461230020142200150450ustar00rootroot00000000000000PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 Copyright (c) 2011, 2013, 2014, Thomas Perl Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. pyotherside-1.2.0/README000066400000000000000000000013421230020142200147130ustar00rootroot00000000000000PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 ==================================================== A Qt 5 QML Plugin that provides access to a Python 3 interpreter from QML. Requirements: Qt >= 5.1.0 Python >= 3.3.0 To build and install the QML plugin: qmake make make install To build against a specific Python version, use: qmake PYTHON_CONFIG=python3.3-config make make install To run the included unit tests after building, use: ./tests/tests More information: Project page: https://thp.io/2011/pyotherside/ Git repo: http://github.com/thp/pyotherside/ Bug tracker: https://github.com/thp/pyotherside/issues Documentation: http://pyotherside.readthedocs.org/ pyotherside-1.2.0/docs/000077500000000000000000000000001230020142200147635ustar00rootroot00000000000000pyotherside-1.2.0/docs/Makefile000066400000000000000000000127201230020142200164250ustar00rootroot00000000000000# Makefile for Sphinx documentation # # You can set these variables from the command line. SPHINXOPTS = SPHINXBUILD = sphinx-build PAPER = BUILDDIR = _build # Internal variables. PAPEROPT_a4 = -D latex_paper_size=a4 PAPEROPT_letter = -D latex_paper_size=letter ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . # the i18n builder cannot share the environment and doctrees with the others I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . .PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext help: @echo "Please use \`make ' where is one of" @echo " html to make standalone HTML files" @echo " dirhtml to make HTML files named index.html in directories" @echo " singlehtml to make a single large HTML file" @echo " pickle to make pickle files" @echo " json to make JSON files" @echo " htmlhelp to make HTML files and a HTML help project" @echo " qthelp to make HTML files and a qthelp project" @echo " devhelp to make HTML files and a Devhelp project" @echo " epub to make an epub" @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" @echo " latexpdf to make LaTeX files and run them through pdflatex" @echo " text to make text files" @echo " man to make manual pages" @echo " texinfo to make Texinfo files" @echo " info to make Texinfo files and run them through makeinfo" @echo " gettext to make PO message catalogs" @echo " changes to make an overview of all changed/added/deprecated items" @echo " linkcheck to check all external links for integrity" @echo " doctest to run all doctests embedded in the documentation (if enabled)" clean: -rm -rf $(BUILDDIR)/* html: $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." dirhtml: $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml." singlehtml: $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml @echo @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml." pickle: $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle @echo @echo "Build finished; now you can process the pickle files." json: $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json @echo @echo "Build finished; now you can process the JSON files." htmlhelp: $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp @echo @echo "Build finished; now you can run HTML Help Workshop with the" \ ".hhp project file in $(BUILDDIR)/htmlhelp." qthelp: $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp @echo @echo "Build finished; now you can run "qcollectiongenerator" with the" \ ".qhcp project file in $(BUILDDIR)/qthelp, like this:" @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/PyOtherSide.qhcp" @echo "To view the help file:" @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/PyOtherSide.qhc" devhelp: $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp @echo @echo "Build finished." @echo "To view the help file:" @echo "# mkdir -p $$HOME/.local/share/devhelp/PyOtherSide" @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/PyOtherSide" @echo "# devhelp" epub: $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub @echo @echo "Build finished. The epub file is in $(BUILDDIR)/epub." latex: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex." @echo "Run \`make' in that directory to run these through (pdf)latex" \ "(use \`make latexpdf' here to do that automatically)." latexpdf: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through pdflatex..." $(MAKE) -C $(BUILDDIR)/latex all-pdf @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." text: $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text @echo @echo "Build finished. The text files are in $(BUILDDIR)/text." man: $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man @echo @echo "Build finished. The manual pages are in $(BUILDDIR)/man." texinfo: $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo @echo @echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo." @echo "Run \`make' in that directory to run these through makeinfo" \ "(use \`make info' here to do that automatically)." info: $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo @echo "Running Texinfo files through makeinfo..." make -C $(BUILDDIR)/texinfo info @echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo." gettext: $(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale @echo @echo "Build finished. The message catalogs are in $(BUILDDIR)/locale." changes: $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes @echo @echo "The overview file is in $(BUILDDIR)/changes." linkcheck: $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck @echo @echo "Link check complete; look for any errors in the above output " \ "or in $(BUILDDIR)/linkcheck/output.txt." doctest: $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest @echo "Testing of doctests in the sources finished, look at the " \ "results in $(BUILDDIR)/doctest/output.txt." pyotherside-1.2.0/docs/conf.py000066400000000000000000000171201230020142200162630ustar00rootroot00000000000000# -*- coding: utf-8 -*- # # PyOtherSide documentation build configuration file, created by # sphinx-quickstart on Wed Feb 5 22:01:34 2014. # # This file is execfile()d with the current directory set to its containing dir. # # Note that not all possible configuration values are present in this # autogenerated file. # # All configuration values have a default; values that are commented out # serve to show the default. import sys, os # If extensions (or modules to document with autodoc) are in another directory, # add these directories to sys.path here. If the directory is relative to the # documentation root, use os.path.abspath to make it absolute, like shown here. #sys.path.insert(0, os.path.abspath('.')) # -- General configuration ----------------------------------------------------- # If your documentation needs a minimal Sphinx version, state it here. #needs_sphinx = '1.0' # Add any Sphinx extension module names here, as strings. They can be extensions # coming with Sphinx (named 'sphinx.ext.*') or your custom ones. extensions = [] # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] # The suffix of source filenames. source_suffix = '.rst' # The encoding of source files. #source_encoding = 'utf-8-sig' # The master toctree document. master_doc = 'index' # General information about the project. project = u'PyOtherSide' copyright = u'2014, Thomas Perl' # The version info for the project you're documenting, acts as replacement for # |version| and |release|, also used in various other places throughout the # built documents. # # The short X.Y version. version = '1.2' # The full version, including alpha/beta/rc tags. release = '1.2.0' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. #language = None # There are two options for replacing |today|: either, you set today to some # non-false value, then it is used: #today = '' # Else, today_fmt is used as the format for a strftime call. #today_fmt = '%B %d, %Y' # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. exclude_patterns = ['_build'] # The reST default role (used for this markup: `text`) to use for all documents. #default_role = None # If true, '()' will be appended to :func: etc. cross-reference text. #add_function_parentheses = True # If true, the current module name will be prepended to all description # unit titles (such as .. function::). #add_module_names = True # If true, sectionauthor and moduleauthor directives will be shown in the # output. They are ignored by default. #show_authors = False # The name of the Pygments (syntax highlighting) style to use. pygments_style = 'sphinx' # A list of ignored prefixes for module index sorting. #modindex_common_prefix = [] # -- Options for HTML output --------------------------------------------------- # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. html_theme = 'default' # Theme options are theme-specific and customize the look and feel of a theme # further. For a list of options available for each theme, see the # documentation. #html_theme_options = {} # Add any paths that contain custom themes here, relative to this directory. #html_theme_path = [] # The name for this set of Sphinx documents. If None, it defaults to # " v documentation". #html_title = None # A shorter title for the navigation bar. Default is the same as html_title. #html_short_title = None # The name of an image file (relative to this directory) to place at the top # of the sidebar. #html_logo = None # The name of an image file (within the static path) to use as favicon of the # docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 # pixels large. #html_favicon = None # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ['_static'] # If not '', a 'Last updated on:' timestamp is inserted at every page bottom, # using the given strftime format. #html_last_updated_fmt = '%b %d, %Y' # If true, SmartyPants will be used to convert quotes and dashes to # typographically correct entities. #html_use_smartypants = True # Custom sidebar templates, maps document names to template names. #html_sidebars = {} # Additional templates that should be rendered to pages, maps page names to # template names. #html_additional_pages = {} # If false, no module index is generated. #html_domain_indices = True # If false, no index is generated. #html_use_index = True # If true, the index is split into individual pages for each letter. #html_split_index = False # If true, links to the reST sources are added to the pages. #html_show_sourcelink = True # If true, "Created using Sphinx" is shown in the HTML footer. Default is True. #html_show_sphinx = True # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. #html_show_copyright = True # If true, an OpenSearch description file will be output, and all pages will # contain a tag referring to it. The value of this option must be the # base URL from which the finished HTML is served. #html_use_opensearch = '' # This is the file name suffix for HTML files (e.g. ".xhtml"). #html_file_suffix = None # Output file base name for HTML help builder. htmlhelp_basename = 'PyOtherSidedoc' # -- Options for LaTeX output -------------------------------------------------- latex_elements = { # The paper size ('letterpaper' or 'a4paper'). #'papersize': 'letterpaper', # The font size ('10pt', '11pt' or '12pt'). #'pointsize': '10pt', # Additional stuff for the LaTeX preamble. #'preamble': '', } # Grouping the document tree into LaTeX files. List of tuples # (source start file, target name, title, author, documentclass [howto/manual]). latex_documents = [ ('index', 'PyOtherSide.tex', u'PyOtherSide Documentation', u'Thomas Perl', 'manual'), ] # The name of an image file (relative to this directory) to place at the top of # the title page. #latex_logo = None # For "manual" documents, if this is true, then toplevel headings are parts, # not chapters. #latex_use_parts = False # If true, show page references after internal links. #latex_show_pagerefs = False # If true, show URL addresses after external links. #latex_show_urls = False # Documents to append as an appendix to all manuals. #latex_appendices = [] # If false, no module index is generated. #latex_domain_indices = True # -- Options for manual page output -------------------------------------------- # One entry per manual page. List of tuples # (source start file, name, description, authors, manual section). man_pages = [ ('index', 'pyotherside', u'PyOtherSide Documentation', [u'Thomas Perl'], 1) ] # If true, show URL addresses after external links. #man_show_urls = False # -- Options for Texinfo output ------------------------------------------------ # Grouping the document tree into Texinfo files. List of tuples # (source start file, target name, title, author, # dir menu entry, description, category) texinfo_documents = [ ('index', 'PyOtherSide', u'PyOtherSide Documentation', u'Thomas Perl', 'PyOtherSide', 'One line description of project.', 'Miscellaneous'), ] # Documents to append as an appendix to all manuals. #texinfo_appendices = [] # If false, no module index is generated. #texinfo_domain_indices = True # How to display URL addresses: 'footnote', 'no', or 'inline'. #texinfo_show_urls = 'footnote' pyotherside-1.2.0/docs/images/000077500000000000000000000000001230020142200162305ustar00rootroot00000000000000pyotherside-1.2.0/docs/images/image_provider_example.png000066400000000000000000002165611230020142200234600ustar00rootroot00000000000000PNG  IHDR,,"sRGB pHYs  tIME W IDATxڴgw$ו-=P,%Lt[=Nt?֕(Jd{r>7ύHV-Hdĉc9mȋ 729dx26O2ΐe0w3_22ÇS3lexd^~>ÿdU3 Û 739f28 e txÅ 2,d/3e g3f4å dq d&3g ?n "õ >dXu?3&g3t鯻 S.dP˰~2?23C3LfȰqU >p&HZ] 2p*Co 2 p+ÿfMd8a 3p]e'_dx{'5ï3|a:C-J=ÿd]g8a(AWW/g2&2te ÷> ~ 7= [ߐߐ[gN7 W>tЦp7-3~.# Q#Dh'Gġ9ͣGuF<':m.pt$:C:%:9mD84G:ѩ~;=b!2ˣP#*D8 mb&.Ny:tuh#Hl+1L31Hԉ#bxM<$q'b"*qx~A7=e;N  1O#EbJ't}1B Aw^k&8i':.!^[ EQ8!#mJ|yIvE5s:nE1#F~)wyy#=cQZ*#C vŀ̈́1Jm #p5}yH'ԦY='KtU"=2i6&ҚI!қLcRMAҚb8dUbtSGlKq"&!"#ڈbxNp'>'> N+[v),1N!`bCa(vyQAة/<پ(䊚GKRMToRّOKr 4&E1L6<\̈́X&b2aіAhl4DZgi"i#M]i 7jbM1DM5&Ц%-Glub8KXGX}K81DE,O{ub8OÊ>1Lu.qVW!K qxk ^ u!Uʺ9|{L e3[1Nd#e`'VbŸWJV60k avx GUf H Ƙ BT=T1fELiw ?lU Wi_a:ފ\1Ub8p"m8C5Kd:'4TùIl<9t~:t(R 3?&aN(jᖉ~ж-.K'S5[h L}bX q8M2~{,_xBWIZ! QtT +B!iLonnh †T86b=2GG Qzr :l lwiwvFVGqyhtPv/+1L Be!X#Ӛv݂«V Np<8~5NM95~(E?F)N9-mo^xQ /2:uGo!)c̞S8 .9#јi|b^V=J#-}QgnZ8v;nf{ǣoxDxF ~3 ǁ PKˊĒ|H/DBHͼ $6: ҫ"<\rZam aN@ /߆O+ Gor\6&m~iq7cVJ`^Ҷ=8֥>.Wn1^FeޡqM_co0&ď J{Vٿ-^)[?q­`[_撇"N|s-w9ޮ!qObYB R9_=M6P*"Z] K-?ڎI~m`nioPcChՆZK'\9,ێj ʞB]hu 5[!^%E-9p5 }yCBi>Ĩ0-@c*෇i-}QG:eqT*"ZC_i;I F'TuJ-AGy[;vעf!1U41p GյPfEbX&V-ˣaH}vh:UkڡfBcO-k11fǍמ0+ ?I[-6y ͗ ÜG%{B҄rC0k3hyPTC]`.07 Xw ]1H# ⅈ2]"ֈ' <%^2BD)@(7V]%^]di -X;oY-PQm>njma89R=n(b%*ЮV~?M2WRܣ~Ax2GB:j[(:!d?G?D=*ҦmIt tؖ `qm: ] 65zbN,ĺTW!LjY񂸡KĴ.ψ;MKɦOrX'Eb-v92R0]1╘K;e"$pߒ [ wZZI~$۹a֒J}R- *3E&6\1۴HWmՑkAhC* *P+j{oɈ =Z0}CH{ (q*ߤv~/Z6#U~Nz ".g w5x1IDhwAWPPlyl8Ggu)NS+P"VYDR"=sJ֑v(iP-RJi"=Y^N5%Ҋ+Jȸ]c:B65` j)/GOPaz;MeUCe.Nb&̤^]UEbJF qxx8Cv^}J<$gybJ5#[ @!Ĩ)Vە6 O Pː'Ѳ_ALV\QZP7:^moH;[R7 j!'n21{b1"fI8K#eZdVTjmc5ɚF;;;hnzlHb}՜RDK THĄǼ9+1*v,'azQbxĶǡˣsb"f)Јw5sy<'UNXSAH%abPH[nHX+-Ed9?/<*)88L;I-qJL(g=F2Ķ؞OI8!M1 jh)W5 jm"=\npW WO=mRxZ6H trnBJX- H #,=b(Wk9bZ9j]bfg'ӡ{.172{! E%bXӄf&cĄ`Eb]X Ɖqx,n@׸Tr J\2D:9S9m=捀[!%A|BG!&> exD|A̘_ }!_Xꚾ'kX]I;z^D1ϞƩS%ĆzseJV43Gf,6h@Z6=LxBT=:\e_ ̳,C2KG#wfىB"{ )<\3#Xgfu+rS fY.gxǂsKwk#s%f#0ӆY'5[2DkX^J8R[fOuIȸEuy9l }1T#l 11Ct*V?59R1Wq-?,DY36vOͶx츦e=OX(KY a-3ObpC8~r[ebYuc&l/兴!iG#) P/Yty D(ۄ@zir]*C"!ʆJ(š-8=랩6͌W PޚǶ8[uJ (g\ ~b8E"^JEnWO, 03pIAL56A|B|npXq#mS/QĜpˡؗ۴XqBC oCgI,k}' zKSh0Wpda46M.H n`kݼ4ݘH8R  `!,=/N) ^dsKQlfY.8+J{7 ׏)8Up^!^ J]8L{t #haxKLnBLkMx&Lo4ZR:2Z7iOĔZ}bxibuBQ3yBÌ*[ ^OL.X@ duS21[4D٥Dz5;fǮEJk #i&,xI7JIKW<VL&̈c[u.N fOZ:.{t<W[G-N`>W"+|gωs9a;!o{\wFB3)eCbX ib2Ǟ&^!&MZ\tMr?].YL!c ($=z]ðWb10&H$u͇`)vm-ySi˩O'=vva T4ZR(m*k7rn3;Nz \ NWy?q]Õm %bّƂS  @ u3sީ]+sⱦ/Ɂ˩)ĄԃWA8K!B{Sf\}J,}41OsĬ v&qL\ .n4cط 91<&qƲq3Y'lbuԸ0?5wS뎆:ćx۪f :RK`-:b>qfiZV qY{lL6vIN+3nN'o䝴\a"q#ޚzօz :<2VgIN ̣q{Tw[.$úb%nψČ9Ǵk"zI]/"L;Gё~bTCWě3uǸzLj81bv*> #VWlWƆǂWQRL)U"S%:<+7jT.ÓHPVd;OOytXX:thq קPZ=H=]sgBT>0Eqv&1Ô=) z`6(JIS3PpVt*K"[w[T'~|fS.bzO(ȜުCipQ@PZJjOM 7[4}jz rI By+a$KW+V҂8Mf^GAw *8c)H}T({5 7E\C]qtoa Qm%hE%ÜꥺاFT&Ìd++H", KP'="_~Nc}ⴠ6ҼdNvMWF0ipC5(fvD!]C1C.?d[8Y  e'{ʄ=&Ƭ]q  g2 麴iq%kcM0  (Bg5F5,}İǘ ESpvݒ@p]>'ikS_u aM=]͎0xK!n){ڿiP7bvxD<&njj#9z k#koEωI 4q8E?Һ*%3ħć9b0TWlM3=l=]M[PLcbc:0833 /{*V=޸fڧ3ՅXmZ=I)VO.aZ&vŮ"k)b^M5'R4j6MFn-[f| ׊M';r|ֶ"SN3vX)`*ƒ *w9@u)GtQ#%@#fhad7le݌pC_\[Dқ#'EѪ:1IϴR6$Y c<10:cwhis(3b?#։VőX7O5"/h&4.EEm"ʼnO-݉A؄>k!o}b N) k4g_xn)7%RWRH[Q:HzL&zUqC0ÒHDǰ yKM7!k YvZS;4ڈo%vS`H|׿x㰠qCd2:x:͌ғo$3_\;/[h.uYqֻǦk!8gEvMn݆q?4ۊ+]XjҏSx䰕>RKj)V#隤Oi:_2Wf + Bipu_ݝ~%m-FRgܻ؄G[MO>)aY^&TU4C<ӄf*%yFuTvJ0C!K8^%(lv;5-0 N۠fˊ MuLz+ xO;>)&^&>!>%>&3Cf)qA\%F tNCxL#?hԤ'/-8Lix%gH\U0bhY)ڔ%}Ր'ئLd\JYq4aD gI_30>z|gQ["u,8[ǔSp.nĦ:'-q3yd./{qߔGd nF 1bl8m/u9:%Vg=XBE{W"kF=q91^Cv{7O9W.OcN(%ωibtb:dLLmCf#sGG="I;G5BDB5Vapo(Q?5b\{dt84E,V+"m;qmZbiE|N8; zDwM3ܡR_4ZV[^ǒúK༮sE׻C)bS3͢˺cd8' [p"uuV 6҅pl 50R!480+Y^PJ?89.{4QЃ%.*521H|ĦSF,D dSVE'K61 ec&M{5*zPXd boėLhxY՟jb-96XVvUf+ 3Ψz;j pZLE}AU䰡؈gp|d8ekz˯Ĵ.CݐR#<ƴ1f84.fv2B N/ėćǡոfj|bي!G)9&P=#v։0L88erC\oM0qhğUY}u؍EqE y[ѺrH@HTDLzmN*0GrX$~.}-rD)tR8G-M'"H|JpI>c&u38T,04Ӓ1c) {BƂ["8>-8n(8].;A )9%yF&:'yz,|Za<0(>K/G0KW=<szbE"5oδ17'f6dA#zEyyLf_gў,X.Xfi{1SWecFg!!Y=&.ǔ˫8b xH<tC6Y@v{K!=F\jPU bV(:v!k1J7 %u']U .O21k5|b DCbX~fTU[V-hA7F4LHf +ik1QUb4Bb9cMmxWyǴ v_vz&"^xusiS;l@І}oQj4,xwDkP?&2,ںٽnkm)gf,peF?OeT}0F\sqhqp:B|l%#jgSE6tw/~kCMP4OSJjGj<S_dLI}bRZ. *cj\ϠN2g{\yMøRPf\81`:_{t9*Va$F:XIQw6l=h7>WTbz1V ^ukNoX2g`wᰴgDžEqbmyaD+ qU*LM~k@$(65Ϗ[WB1li6 IkB]bҸ6ıc*VZHq0QrIʌ,TDfX1CxcuUUg5ԯd BNX:yZci]Nx6$1Fӗ4'Ct NqA`}vԚAΘ_(⢉@(C]j;f5y ZLnfR8}%F! FtA})_<Gފiax3F@П.BuW4DL;c6| 3MO^N0#."&/h`kQUmhS#GhVTږ>oUіX%Z(8_^Զ{[n4/Լwk&N=L_TAc IDATӐ<焹!f=]^u(nTۮt[D:NlV0M\^ZaDXbA ~NotJ2nx,M E >|(sunyV<\^k(̼wSTOQ-xFC-㪙h8QqM~aqN㊡x%iSuA= rGOduolQϣ.) LI"&2Oǎ 0U.PR+z~EJw&{!d셂s$gZc(,ШxKFpVV10OwSBaD@I1o tHмUWZcoC^CC|b27uu](cfZ09HjfKfv?l4O NM>@^*r`N cfHZ g3C3ӛ cOe}/K:TDs+O07z*)n/x Ԗ ZSKPG'o9Y5 mR2c&YVQ20Z^L6?:Y#5eU.f-mZq,t1ЪcML4~7/Z3)%fhUB m41pl)7̦&Uf-7ԊyS_4YMgƂ3bs2V4.rې=F\>Y $I"FVmbcai'Eg hlJ n[fL& z.+F>kK-݅Vpy (dmzA#0R7\NΊ73] ]vDF 9L\$<>s9Ga`\%~*VE%~M;/3TgLB^mw%Jǚ+m,2Ψ* xXj4 h1fP$g͚ۂa2#iL&̮q#l]=5`|K4ZQɤN5/bɜѽ~[ٹW PAM ~چB-u&p^j0B| ۋYzP6ziP'=%>WaYxXU2x|GUOH2&V|U( .:ˆVڲؠJj& Ԑ> jYpZdJqHiܣyHCw#7J]),c%/Xn{l3M<>cox pߤ$=~ sEp630zh,ķD"\2Y06W^UE XoC@V4 s<$.݌:<]^) o@_xM>Y2,q+ڨ)8RHiM2$ϧܵdV k(+$UfeYJk<31ˌN*7RfJMA Vӗ;)DG+fq_lSCqMo"iDH'$qaEt'T$5lâ[8}er0reVqh7ti"pE$ Qbc5w*JOLEYKӰUF=ß y|iCp8g<(uʸCŐx=]"P\&>~8dn+5 c*qݎ Kb`x _efXtc'}L5 #[%FB|)ʤ.k[*5D1clr'xҺ鸹a0,0H}DIRdC-⏒1jeQ&.`Z$㶬-FUwD~3:59_׆=SF>j캵U(>F`t-Ti9]魸l4/9(쬥;oo4K HpBlzsFrΪϫ홷EUS4Vs9L) h,"h"bsxo~5ldHEl[ ~O|0ƾ)0t|C ?]^ݱ Nh'Z<\si2ݾE.ty^b3V9q.6ԗ3_;2vc04Eg tq]s?Ej̖MMI2N̛US-|t"B},[&Ɛu >^ +3♼"sb{tq#n[H5koa?y]ifX9{+=ioĻ;fڵQ~df1S#YLJ>rs`gR12_ aS.[7"o`U3C|lҠ!~Y6\H!OfP%l'5V  gR+3\ ^J@y]̧U6RIM7<\zReWFEl%BNayk㚂Uf R[m8q13JcK_ LTk]QjIҊba.KOub1o3isM)TXc+_8|u,,+qV@"?4&xƠG^x3K Kw,-/RR=K,^p4/%D+ o=n*8lڌ=1A#Om߰zô{@1Ìv3׉ePMI-֩C\8alQqSwqv}x<S\uv:}iL7 vI6үDW$戟1m}R7r祡 ąlS S1{?%8O~=TuʸAܔ1B2(+f3(?$O %lYXjp< oUN1qqߪSyq{ԉf;B*mKJ\w OO7^.)_3^W߂:{7h]rm «Y [lwTs$Ba|ZS kz J|pZ(y=s4)l3Q6N&1atqq|/:5ysJMe^$ K#|X;u{N#As: ϋ_\|5y s,?pNQ:Vزhta_6bcJ*gL_\c>L_"jg$,Y1 މq-[' SdOkE%7J Ҧϥ k "X]5qWH0Y1bVM_F*{vW1.Ʉo,},;0FF78 ؽ@idz\,s N 6;v <:w6c%u&[" J*n^ϞfUw#_7l^axI$HVQjx\sM5b$M@@zt9o"%Hkzzt|n@o =־2c^yY2r:m42kZtL[;vEp&_WYoDs9&/nһ3pz̺&182']ၗUF":A+mW 4;rHwݙ5Zi=_iW̎{݁y?sns潈oDZud'劓aU g\W9f`a-(%oOpc1W,0 pbdW5m<ƁsHsyH^3?}8mX%#0N> IF.6CK &ų({`ax?ħYSb] ;%&26ʼxGeijV> 9ϲ_e@eVs2Ͱu?؞-,s ,kpe Eo;O bʟU>QFx VuplmkVһ*X6C4^[5m<5ЎyX&3~ hqoӗV?/}fRA ɀVa\t1o!3L$N*%iJ' "8o= r[*OTBCS] gihk4t]͈*^owuxv2ltb L\kQ9 ԋ e~^\YT6U9sDcW]Q ߳8"h*U}jbۧdv'hHM҃[2J U.3m cncP*9ߎBD"|CU$EַbRNIHbfȶaa??]F10HQiY2auS*TMx01'$MJ z3;Q{y!L;af: 3Ӄ13L+{lZ0VST 1wNX1YBi$0 +S\OUe ű񜸩]PL؊qc" Mr$13+2AɌ~7!M^]qZpЗӝE=+0[n$1WK+Ӵ}\NN^\fJ/֓agRw#b·6:}0 h4!Ŭ^v]i%c?X؄hXsmE字.|֊y-P-V`tŽ%t?qڇ+V7ZM a4F2*JiS%H)`^n;RيauO寄!*sÚ6Lsg-w jvo$gnus#1\̤h]Ns)"Xd(o>?ZӺ \}/Sv-ѓasx7i!Fob8k/?XaפV:piVYA'O E;81156W ~Fut MR:}4A\. zViջ*`MʆL}/s)6IϾg6Ne - hVIÕ-&]JM,F^v]\͞lNge~V'X'oUwVϨ{tgΰ"4=xs3jlfA y v^Wؒ&I-I)Жa=~UA{fVr WE t*V/|+WH Ϸj+pM;Ӌ4YAIXf5/訜x- +Sϫ0fd [VMqX,3T"w 'Ut";ZC1xݘ孫\&I;3r՘t>T9FDe)Tlu_L޿>fXˑ,\VIpjbT$cHk̨ mtbqV(\(nukA &i<:1f%oI6_5[P/"}*75m̙mg9C x9g%p$j^:\Nڥ?c#h; i u3Gop<;]-kǕɠA;-jc&]X:iu)O܆,E<2Z/_l IDAT.,hvc|UEl n'Ukژ]/34wc+/^޹w={dڭK+}MH?T9D{{mIȜG@® zrQۋ(s.ͳbKq%6vf -Phx)'U/5[mkjeݕ/[ut,Δ֙>zrEi!+@?/Ȃ jpez1K Ϫ\S=3fe'7/6݅?m~:IVgEq2mpʷ SMf9r r7\+kT\lKW|lΤh.q0|84O)dGq-ڨN FG8?SX g`?n"vf(2U6cxZe[;7XdF7S*x5q5=ۿCL-֧ ?umߤK*5j^aNT~|o`cM3RBo/p \`0hV* itմ'*wLEϛKz/u|2)t$!I'P##ZTסNˬ˥3| T|O nrrWb!d*lGSlmNx!ml)˔+}37VP4fˆ+u>€a*2eE;?cB8>2/]t =9\rI/_—3aH]*^]1_Κb+E^]!ވLiTNV?fAs $BJgUfSŤHR, $ӚY<Ո4kXT4 Ug8v5 H^TB@I[:= 6:g= !1Ð8 f3=ԗCԤ0I<| EtEʷqk{Aڦq;Ps5//{?oϿO ttPJ8椌*h*]+5W•~O —?/S@x{TP|ptR0q&m3ՕRaذ X>!aJ~WH]5`'nz撙x/V筀ڢ@l;rvlX3ˁv̴ŭLf^W_|ov֙ iߨ̕ʢi _zy u ?#ԝB^.BJg [XG`|eU1Iw*ϼs)cj[DfLzpE2{͝&EUNxls9YfCxK1ոA&HJU~Kq!vUƗL f,O:\21J5ᛉ> LvJ8zDh[W.`GZec}cQ.O`&_x8mDžWK 4& Zٷ@c='e r7gqɤ (n|Ś61 @MBޕQAӗNyq=NL {u؅ 9c0tyq5f?NQd7 EK+U}X1(eXxqE zoBݞ§se{rH咘jOΌQÚZbS^6RFl=1ʺʴʷe$2Maea;E%Fk B6bPKsNPt TA-}I>V*Ø`1.xx]KRbM]y W>:cO\d{K 2) dƆͰImCD{;nŵVK~jα6p'kJ!Wx¾qY0xuՕ/Xo,l='Ƹ=t.Exdˈ+Kcl)Οont+0'|O5l1sί *LBϪt)/|31^KiL<);@wq<ʮ3Pdb|oyB ԽɪyE hl퀇ƌICL AS<\ Ո>mK ѐ;]m[h2 HyVfTbF[!@c;+`ENyji~ܼMY&T>/㝜Ӟ Ο!]A%#tpRQCI\xk 7p }M+Ԏh*_UUb$e&j@ (֬ vEg 85pD3."?o޲ʏ(҅2"Œ J{pQ:iC>zȿ`QmWRwi`wRX%}/ݮއαOj_ }:2JbgL7fxH>왶C5/.ZG0]Qz^w{/Np_'lrϼT9I˯0N邩*m^\ÿAc`1TatSOF2ܓaxvX厗N0erM(gR $?dR<ˍL t 񅛫."X^mX$8IR0n5*[xvEnqM呖I c(>{e`h}4w"MK|D"Kl]'F+z:3\U !uzF]*{!Ee0'4id`Ny]ͪf &f*6a+.!?t.jڸO> "d7D8I iRS2 F/ƙ6c/\TI+[1`",cVӺ8 ziwF?@RČʜ=0,A:bniF@Xe]e/fO$됯-*-0 U\WΨ|e:ӗ\Z\ u֊{*S/aJj]P믫|ք,Vx+A+IVu^/_1Cmg 5/{<]2&1rUTִq;u҄h1X ,+*L2I%om~!).?[is^XXS<>To@*ujro1>;ғexGbL?`QbaK۶A]*DW}T)˭)w@e\叙BmWbj P10[nDŽPİmn0~|~lqfytqmfv'bi_'=-/k°G*?ȵ #OL*;嗷^lX3G"qԉ|ͯBi sSS5g>:v `p{[%pì?N <$ֶ |)*i Rq"e05VY̸RR!z˜s{z%;A`+v*`q^[#~RXVGV[5ڄb==& # Zx[FMpf3Iea"Gg 6?Vb5$AbkJ eMܦX)q`M(k?N:Et| hY2QoyKMh1)aS3J,xkiOU5_=m`|*R9P߱3}ϳrB{`-OKs^jç@B=$"CWc0&H媗wNFv|ֶِU26W'$Wm5frX":q۹uW.ŝR?5?yԥ.q"'; kM3a_,1bY)g\6ٳjU'1;&_w~ㄵ/W\* N#4]B E ^(*>M#i?0/KDz H'Z/.5s^]g-!|'y ].](>.MEr **uf#a^/uWvn> uC/.IǠ ,^.892a8^|AeXq^}N]opcLm/T̸3jژ"#h^OH|X᳥\0ɤ['Z`/ w@ vRE$8{h,6,M UHc%f+Hxe:1loRN6s֓7c]HȬ3CrX{xb8A\7I ÛwTr +Gk1";#^<9rFe\4َG|3U &Iꃪx#$%j0&;*Eb#h73)j08b!Wo\=C)J{9tmpP^>u(ִa>#]m5je6L"E$4^-t/YvnekPzO`'aԈk1K{'LS2IpRu,P/Jj&1?e@[iivܭ2EWd;@U{ZT<|e5^QۦAЮ"]LtDmajD4"rO&-_vcM09INAـhƤ][\^?ڧa ?R}!.eV\f .f{wK s8e !1/SP(sQlpe۔bƿ0Ͷ`I^]yg/˥]Wb4ƘOU{yN|ͽ!? {x PQ/垸%/k.NM'492b+>sGC?f1K^ =gf@rɤ`MG8FnMNN05Q$Oay:pu MZO[Nʂ#h~*7E kUa)YQk03Xs}ʱANuf5iL}3ڦI5"_ً!/Mڂg?QO{h\ 7Tb?brc BiTl[~{;06VH _`3cY&ng5&mNTN@ex^i 2\ b\2z2b[4^¡2J3Ӥ8u!0>[j~0 +2UbQ%5u~GӰu@2!833y[;,x:^:,!W=qDH\2G^UPm\^ZT8U/g:RɘSd4\vW?e7ۡ#Q>{sek\P9{J)xXfeYV5؂ gN5?s%t?-, FOѸ;Q f]L N]մqK+1""XmzpdgCtÈMғ(51QH(ٵ:!bs`'Cp4 IDAT~ˈ+6 k? )bATϨL5)ذGk^"K*g1s=a3m԰>uPeˀ+I{DIA\=7#X<ܕ*T>!p҅X]=e[t֞lqkSl3 jDxGӻXu%p.Vܥ<~zx&$+(.14eEd9d[5m,\&tCy+fÌ ~a d$q8q&[@dV8do!=p˜$aa"|.'㑠:h rnM2pnfM MUZͰ:;cƯnybuf/.yP[^|F$7vCL<V~F34^p^ϜTNcoxC'ŰEpnvrMxlK'uf31D| [xqNSIj"hjD(co/2u2(ToR}Zҥ9Oo#d$A _xݍ϶i&ie:5L[ʔeddח3&߯'* Jc,MTU o7AgTe#[ºro' >_ʰn\P ΫM*6> l/W\o~|d(kj׍AԜc_)]^P\2mM$w_Œ`o#<1,zytΛư0:H 1y)4d, 0ӎ[%CĀJκh[~iTު̨&+ߤ1W; n s{GP..51WLඳP5H<"\7/+0}h.|9yh+*UĤ覮V|bG+UY$~_+-qe .ё1|}/7]a#*?B?Kq.)$~ѹ.>1R'af-ڧUz#~c-=ųic"/])EtNC]+I{xziw$c4)Y!媋u,̛^bZ厗;yI#ivŢ&+We^n)DpPu0&F : 2LKV0*fh\c/\iI?7΄g+ & ގq/LZ3$neY$/<|9?NϢjCWy kG<2+W|lUG̈́,]AX kN}qd1N` (IT;7]ЖR]*GNG|܎-(cK7(c<&FJL+U ##ڔ򔰞Pg*3pKeBwIbՊF8Kt =~?7vAC%{R_h0N,NOpla +}ˌaN[)$y\"[c 5WS*g&Y@0;M#P/5XbIp+fvZC/(YaM$AcL{s!\201OPٳ6eݕIhQTd:i'UAbZMd^ H)Y_;/NT> LBWqk}Nɹ6|;]D_|unᾧK @@-eT@/\=Cr%+߆e) Sh'Tfk0I$ u)\6.O!'%ɀ U4M6T~;dPϥP##km= Kf,y|&t )[%PY:WZwlEWGYgݘ6U.wR/vq|ɝۨʇ=P}Yʗt \415+:VH \|qaM-劷˶+$z\݉D8g t:Lfm  xiseZ7Zi$,;!8?Cr?FѤ~L% *{B*2lO}R"DO>ZQ<ҶvPŹwUfH ̢i(g֙ZL}KB.Z3Vy+?unא{zk҅k$~טSOUKc1K*cp\YL0TyRs{rOF ~mݨF -]ȧа 'zUM;UVBSo;$NYAEs5uI@W@Ē>d^z]Y'X'i?W`墓s ØYLX 1%l\◬As3™L_>j(F$Kq4b[PW+NұC yOwԂJ2Lby$ekQFL`"VoҋSގUJ/$^xu&I0uJ]eZ:3‡oeEZaF_7и# 6Mfs9KWK\_QIÆ9yS 24^$Bu#uh.* ml]*bb˄+ZZ`m, ̀.WJt:]2f1;ҏ|'V/p2~(C?$_+OgˑKmkQ-%&%֙,:JET&!'.iWir*pF Z1ǀ: dŦ ZJW^ƅ7Ba,].=DWV`qMEb4<6kzy2aK, !3ء 84av`chRz4=8kJMe쓊Dej5!VHkiT0r1:Sg̓PSWu(Z׼.|-1 &|A[cp_8yx;v0y@w.>E@: 4|R =F96^aΤNr.e> ڜ6۱\:˘/! R`7\23^&\^c _{y kY@ Lh4nz΄77:;:&EM1ߑGp)β׮{1/v27"[^V\1;U|Obҵ/O]I ҆C߲v} rǀ|ƐBi+bT+Rgl^|9_% c-ũS65Aڰ, vцf[,pT~&t~(.{LM|rye.; iς^%W雩r&xGtm^kLL4,S彵V,S1"$u|Mcgn!unwR^Ao/bbn[^/[*<'1@mYִ%")b$qm˙d҈Y弋au ;ʹ dNÛ*7q,|hTw>|E* QVֶY.!zAiCd[pSӎ4/.mJB2eC9^h4K+nږ]Vy\外ߜ)WԹf0Oa: 6W2uk\xH .;G^R0Ϸmk"=2g]jG82Vӆ&E$-eЕV#c&RDI^:\y *e7:o ]p./3NTsY}lM&*yv3%?gTc gC'!qON>7y/\alWUUY|܋" ;]RTx4laP7UL٧R;>NRvQ\eD /ȿ6MA+65tjw!x7D!ymLIMPUc6|PSJC`iҺa)rugs.ׁecy"l s@eD*i#i˻Ъ@OGף f!e=O-U#i~u&@T&T>Y= `3-d]GpR.{ncVٹ DX[l3U/~ IJ]lčUÙzA>ߧF+W7*c\ͯXTKKijW11"vʥ8%D Ac*7(8wJV0,Ky@Gv/ WH9/^rpDeˠ+Ud5vK:lh5yiq]Uţˮ+c^! ʘQ6qBXeZ^yy C,d3Lx++GCHOP/_3̾Q?E~7^aE=[bٮi yk7lpAxg/$8ޤNj=h ~ +oa0XӵO ~JO?aH&)֎AE(Re u VzE [oY<܈Εݡi( uVcwUUT~G8ێ؇%6_=C%3*s*7[u?fh `{*TAkWt z9銝3:J+^F\6m!]|yy՚6dg;j6Y[2J:-O}H랣nXStOLV;ņ5tR–b°x7(q2)6ʴm e%nAۈM3[ٙi IDATxID ְ eC2llMreAlaZSrF勜|A6MwTT\ͧ&#:z3k$]\'fIpj&3s* Ri*)a^4vGkD#VZC2yxt~/#8?23*1,g~W,:^<#uZeˤ+&Q;a]1ق_[Q{sgUq+SbtK1)HktPD:,&qY.m/3Niϲ*+{uyiw3aMN^]TƝ Nc^]{B*y/|m.:Tlbr Я/fXWsr(%Ca,/o?쫪l^tRuK?)I %35־bb=W9R'vjeL?$7~^hy~c&˰]l Axiuf3Kx2ML +?7ONzQ}KxGM<rOoˡ,S prqj4nϩQY yB FH,`mdS Pǵ?os˕ h]Y Rgm˸+}Ms?$82 mwge/FyKWYh6(ӎA+5W$-h_qoYkVJ]U~M?mS?Ž~֙ zy)ZxѦeՕn WR97'(˞+aoe {^\D +Sgcv{=0~ bq>^ş7dެK0wkTaT$h kXQI` ac% HEWrNNy &,т U:~(cQ$P95&|&[k.aj|u\N!wn{1K[UŨ XRwAοҭ BՅl~BӅ6zai疟3`uKf PVN:⽼sNMqu\2IpA79G^: l<%O|c|zBleTƞI}W#eZ;ZYV-W:1rf;^{sȹvG̼nޡʷwұ-Zws2N2 Tlxf77]ԅƎ- ʓv['i;uLR h/醙/,R#i͞wv?V/G8|2xΟQ+#C^z\a:-;PٹӉS9I^]=pO@] z0kn ux4UzS[84%_c)%@̰8t!80F!LHz:il3EpXaANQ&qXمWIm'䘩ħVoS[g7JLx̅O&yHY~ӗgZN@ Գ_yg^tn{f }O["j \!]l*G[UéxpZaM}2z]1@R&Exiw);2]R܁]2=^8?JMfr2JEPaM(#dD2Hʰ!$dzsWQwtϿjG ?rnގN&_۳T10du7g72 3SgJc+T\ _xYwBipόx>`5/KܘtIHWc]/ם\R2Hԉ2PfHQ$xp, ! Kq`{j!smd:7][p  `'p[< Ɇ5ǽKׅz^|&&A^d4nAbXg[͆(qA厙 mrؓ ^-T%(YՎ VΦ78ymN_0yG|eo}DO75ldֹ=."z-ua *@  +PrMMb]^' ]c;@yfI !8?µ^]t N/.p̣1#Y~['pEųe&_Xw%[~!<X^N!Id;m*}F* U:-p| 12"g^x> f~)g BV7>Obv?i)-qKk𽦩$5]{w)w]>֞]kt x;â$#8ߋ#nQty.{yJ# EhI:zUKei5L~$UDWb/v,:׼߾̧XoqgS?)Psű01U2eE=Y=)K#;xM帗O\1ajpϴ,5и5mer4,ѷFHCn&_UyrRrytu5gs{_K1DO8L48 G*ߩ|Q)bR] t[`kptm/vkt`tוM/ݴta%Sb b+k_e/^e8(^\9K^vӈX^6&]jzr[e+;yvRc ܤHAeG=W"V`U㷞x3S1J MbmV32ו6ҕ 6/ULp=+p E/ӮRZ]F IK+ ʞz@ X R R3|mv7]:ahRܠ(C/vaSeb}*6ʄ4Dʼn)ez-ȭ~ɛ6zO|;m]$ӽ" }sSza$603#*%^W]n`"q%s+JF(;/ ٚp \K$G cr+z! y /Cc5m fEhRDIdzt| k1nƒš! *FwΘhnz㙗_te6dprʩաYZ9Z$aly~6JL=dz0fvʦ4IBVyZb.W+!t̟ĤI츈{**S{\63AFωOF;c\ͪS6_*l *n_gMq\S?7lwtOI<wnŝ枹O~?cv`-eB{F5m:{cj!TNxsta{6~gq$E2faam4O'44.!M1ݬX20l20n(38!0SM䙝?ɯ'*J DOODڛ\Ϛ춼9"؍[1`L۫*f7381ť1ע2eloJ0b(cE3K}.=?6v}Q[cj~QT(ǕPLw7lb5K -ŤA[bXK^]_öf i]/Nf㲗'*OUN&/{ShC|]1+^V]I ҪJ{Y3Zg:0ƶf^ĥ uO]4^lⲷ] 2@?kxF֙C<eˊKKc <34K/xqv{uyüsʉ?eԕ-]%0P=6+TxxUbM%LC,2wE8Nm q~`?wq[NF90PMgFɲ|ג,e[ɚfA9Ч޵9Ou['̐0IYFi{YUeTe^Z|vu\2;@+ۅ Cd^1ә4wY>kt5%iF HqbeVݡ MGR~>}*Li8A<ܗ_"`n⧀͟&H 3oX@0Ora-]9ުps&ӗz, ^$ED1V ~8b=k?E_B(QYiW(?S(WF\ʰxX-CCۇqhluX8freu1 2ML֎:h=3^B(Vbdez3S !H۳Zow4ln0} F.Og4s~?3=1lAJ5u~ qB$_̦UZFp~i׿m#uv/n{&#5 B އ{cl`1 +2|$b)07CfF$唺շ%3) >I+TYRV^Ͱa/lsܤkLj:zi$H5OUW :dc i6#z֔F/aWI"Z+1$3l;vRTh!8H71-yS>ի x&Ɔc;j1#`P̙uM 鱤V|O\qt3O6^VF㕯;ha*96]pK{"Ϳ2X d">* tYpj~ b:{(d֙2Y ,ń5TXd~26vtj֙\RZ=C;-2}b3Inqn+[놏2ki@5tl~̍80OQ+CK NzAL&L$!0tk;)El}jO\:EQ׻_l546s;B]{&&q5dQ| W4>2|76=m:?f}%3 I׷-~SI}Ca-Ju5W\RAuƛkO+p}+ !4ʌE[ #i2jie{P{L{cۃ!JlH8^kﵭiU,O42f< 8IifW8Hvdou+Of|1 Q - ̦MQZ9/,{L״x-*GлR}ܞj/dZ 2t\ ;4 iõK12|ǡR3 :_23 t5CDIeW0,kpZYKlhYFLP@> $K#kIرKNtWP$)Ϙ`e0fjPS'VPxHky ӭJ")]o{k/yz GG5 cuv9ꅧ'kL?Q P3/xz G:s+N,5v?SqK~x4RGy/FfH+I3C`ĿKq"0;%zIR(2Llx:/ZܓF;Q,f& K3]& E2)J+w:kkreFtDyMCйwZiS0lD^,?$_lbY죛Lw4@<˹gc1[L~ŷ>s0wҀV̀ TT5*%,;8)Ǒcq2L)fn;)0Jr)(Hg4ڭn)=^&35Obyse)aI żvӂK#Gc)׾azGm2]pkB3|e`w /=8?XҞph]V&LxG"^JqV. _Ot5l8}P;H:0E;sN4‹yI`SoYRڞEd4{fJM4R*"J)ӨKJ5= OEjNGAjڹqK!fMtq㡑7v4=E65s GW@<\fcEcv-gZɉpܘ;L? 0Vbm0p\:."SSh.蒙28@ٞT>:0,,٨`0%JSSe%=SMd=( Hk!': mkQbẖ4Q143YA?G O3.e ]Fmi^2{z d)xꈵ XP\QW N&SS{tiֵYCnoX2WONE/2}4XtlC]KP'Fnh%p'KX+*PfxQ->e#zt{D7i-cnA`X*H@4Ã1Mf=͸b9 -O8͏mE~? g\[?)\t=.X5LOkfK VLu N'X#4sBJ^h[FZfJF5(S19.s>9וvfNvPY I ]IigFK@Iuqw_j\QP~LL7eCnwAfnjp g=߅)I=iѾ_c2|Buxj7=ͺZ-/0=dPYahYn {A7¸&FZ(t]cA:nkAr;Қ@r.dWbP S)sa3,dǚs֙syZie|T{]q\{tʴIC ={?e)vމ W $̾^& 0}|OS}{fS=B[?JveW ~iCӥ%0,i g5<u%Ͱx.a/X9lMW#k]>1lDLg2|osd\l_ڪao-? XF8 pZKǙ1 hM'R~GgLO4EvϼKЀ\ӫ]0z`wӦk>L7kc'!6( .K)^tݩ>2b4 х^0}%a/X:f.,~sӖk!mkIHyҎPz(c=4;woqOEyu)iO l=i'+S^WwbjŊk3JXN} "ʹ8z!WKx4KO _{LUѧ"sӹ+"GjpS*zZ!Hp[:V숵Rk k} &FVEyGe+77a/hN38١;s4>LDK9?geJx40Nv`^lRZ4."&= Q gi]`h Nbfӎl+=mgDrS`^{V56C~+0fz_37*ܚTL)wO\GE5od<-; nK$) F'L߈ jSK␪`NR6$miU&+ +WcݑzT{27=0KP8Wɺ΄B4iZgkRp~^̵ϐLL?Iuۧ[LVܾ4R~3$-ИS3_sVI:,( .mnLapGlP,kLOdpIz5}tG'cF~mHa%ccV2d"鬌|遣mwIIl 鄉=S|'f,B'Ot*R ؚKl 6ov~sb8k6^]l`?!zӹ+j{вX~Ϙi3a4 g0fwTR+faxa6s'L<hb'.$GvM$qK!b,smZd^ʡ"d.޵ sú e02L\9S۳f)XS.dn"7&m?L#,ӀKvRג`dX zq*#G(-EIQFo!y1c\nw:^-c @[Oo]{_e!:HT$J3m6\,"W~:+W]9S ղaiHC{:.MG.7QGYLHkaV$L[SK1UC{4"uv 6Ӱ+H p:t%XD G3 1a "~J6:,~O(cC 0!kQd6$;j2 ;蘅QKΔKXOL\ r5f_wreK\488_dI bd'OSN4G` TŴtba[2YheD2e=u$L(O=ǞΜ_ۚRfueVv%m} Kמh4b6s2zK=Yxtт\ϙn3vC)@(Eqp^ÔbXXȰHg)u؀Qðx%shSńNAP]9ql7+LNP^LH$|-EKvlo}Z2X{[Žznz4d39PrD߇k:_C11Hޘd(>Qw ) #_5>1}*5Pųۑ 6z#ITsmA)d&yR bS_2 8:BX 2FvE$kl,d3C]ޅiusG{L-jURoaLyJp.\Y9 ~r`GS PafS6=,ZR{F?i5zN3M{t)ɲZXSHXf"y䖤Q_ o<=s+}B!U涧eWP+!s­`q4]DLL°zxGcu1LH H- vP~BmcFl X[1ֳ'dKI杲ZE2}+י<-a1(OC7 ?yT#}g2&F`p> jtQ<1;>uyb!͜ "Pw1@e\4O5uVQ0vTQuO\#Y JMm#8z %am?4?3߁h!"bWy4K觸/9`Wu-3{~<ǰ6#/a`qD0"NT,i# { 'zd^нUzXy:eZ%sBou4ca:e*%ozJmRڙ9_j w&؏9j3X{] BIU>C?Ct3@"M`z0oi[&`C kOk6 : ؚ]S!a]88ELa/]2Ӛ6 tE2'Ϋ(3ʈ2v ;dtxQ5je.?dgg:PgPJ]9Y|3#:c 5t47 JӿJah EgWxt_k͗ 1]x6s­/!:nC04vK}RY5OFQЃuƟb2F;Ăa!9Ou>C%ӦM \)b JtC{ݥFK)O88:u$\ {&0wX2/k+B&l}tA ?Kð*ۧSOP`&0w)= ;9ut45DEz v`]EA4mw10Jxe.Y` S| $#B2lk6*RWSLƌ40U EDƝ#WtS5d H%L3L?O0Wت pUV:7 ɥHص+xGtQީUuKҎI( 6q4JwkCFJp2;&0ɠ2qcb=+L_0յg-1h2ɼВD4B[v@T J}Y>a6S~lFӜNGyhIi :׎>У_Ӊfoτ_ <Ջ >Jw:7/]2kk%$Ӕ)@|j !!x}pE̦޿S"X{DI]ʰTCp0!08o(o'3 N4wո| =9?15^rU6 H#'&HcN cg9څ$ ГJ./Ou628j&)Ӊ+֩2̖gi -`& bӮSε g iG%c3pD|_l~C3>CӤk/0 觘}iå %jkqJ0&2,椄MNܥ%]01.o $xƩMd059; 碗PGX6 *ld_o條ɾ ZƖbbaK m^Z{q;#`zw(d3C&;9[-7&iW9cUv%1 0} 7c^ 0?nw;t­!Ou'ep PK2tcqc%eK\K\xvן+ńa fdp~ ^|Cxl{t*w)<apak[εBZ`,F*S.hb1F?@SvZYۗrnWQ^~~BB暧W0u z0~X{uGLM;2ggekLn]ȶI0οѝ\M1u]{Gqx$.5[/ ^2돡Q&J(jWG|2{L[B"yZε&,>ʅ9eu&e4SK3IN6e"g.(G~[ii Oʖ_F,?>f39 ?@עxxiJΟonm1yBL RS7OMW 8Xe#NfNz\{>]ӬSh^NrC;PmÒ 2_3 mR@uh0+HIVg㴌tLRZ:@wu&ehuSS^tl'1IM0-Ix&Ӣ%2Ʈyz LP4 9|Oܘ HKz`L_BraDȰA+Vĩyd cAڧ툑} X3,-iR@N&Q/ud)ORgs~,Ojl 3 {^M[g _1Uқ^ٌ"V1@H0'/3y0MHF7V[߆i%oqظ ,Bz|l~`K"ͯzZuLu]`_XPwQKV%i[2JM&vd,e<.sXFjv/|\RZX̌Yش&մ(mpOG?i}6& È )+=K}ۭSXxi%k? 7Df.ǒ3b)nffZ"c`NLK'Th%P?3ε¿#?2Z]Ԗ"-բdf5C6'96Ck;: -Дg֙mD1M1ҁMI@zK'O?\صy2!w#~LcLv|rcwI#aXdztӂ+@vJb4.ӄ+ә;tbBɦ+>$,ȇLS:ˌ2yPd bܝj:jFHFG3@ȕs wZXR֛B zc+ FNԊX~!7} O ./k"E䴧 Wu(? !SJGxA[ky#=@ ȍ~u@EF&<hɭ}}[D/*(3(lյQO- 8fEɍrZ m E~̰q̴ YnEZlJ}aVaO&1[{5K;֡1~)fZd(ĩX~RƖ|bMax/=S/@\ڵ3ư7i`X| 'uUӜ*C)HK*‚d^{qŴarPiĥ5laRO.ct*<hB.RvHe{s%Ч8BCFCk9qOLǵ KV5&&:=,[Ӷ7A8._Ϡx#iqOC=^Kڼdn?g^[?u>Hap0Ox?c*+ }Wa/({ PqD4kAzgFS|45ac"MkxA̅<)!.a:%wris0SHv)Ȕ{kMsi|bPk{: Mi]\;o#dXZB*B#%w ߡ6DT'^ztEca[@>=1YyƢ Xa鱣?:mܣpWLAeb.71kZ<ʹRpw&)B;+=a-iuRζFFO2hFOMfӑ3CjŦ31*JT8ЉИ\mOonLq꺙=" ON>XkaYڽ$8Xenbiznp~xwLB~bb5 2_3Tx+R5= .KG1E}mfIiV)#44#ZGLb[;;}o>.=al+Z< ! 'Lm0^nx6o4KaXk^M1zwE)6̘g]>aV3I؋!@:"ULwĹ6M_`hG+Gz"[{.\c&&I]%4Wک g{ڶ!GLLJp2Ry"W| W@eiӴS 7vM2oc==u̴tCMܵ00͉xxknU딸db"NQ1:_iŜ!eѽpO2_idI#VǚDZm S&QCDu^U;gN8쒝p֟+<֙x aKk8z`16i8|ddpAgjT/ C2 'K6E!2Yh-k,seh9ZY@ERo0tELV#U]R]Le+h4GƜ` mCV 4t=9}:/f6; M\14_UҿI= ­Ckڰ6)iJqɐM°x" [#N L2wFrnQF&i QӢvL(Z Zh3jW\vU+ct|٘4K|:lӀ2t _Ci֙o0M1]+B7Q7r!>r'ߡv?5zc $ k2u°س)JQzGte4|Z-4a>מn;.Qu`{|CR\;LwG匊a/YM}魧uF&Ff 'DL]eXOvЎ@sh?'N"jyfeza0iuo7׆q֌TmpO{cW=Rgz&TON)Ϳ= gcP~Ĵ1\Z{bK1M1>A%a p5!Mq`7To{ڰ|4E7s@vў t!na1cZa) $$uJ 1ATʂ:-:D2UNjT_7%뼼ί.,蛽{&{mRgGR1ݠn%0Q(SL7u&4`ol>2(ӧ4  ~+?)/>az­Oa`߄gg=M"{6._R mJGYڔqtI K״׵N y7ِg)ӑdfӗ._yl, (TH,B0u;bafϙk94nyXZC[:3s .iuPYE#z`n*[BHXv49hc]T/^2=,BhsGoɶ/{~c;F_˖q ҮʻŲwLmƼp2(ii(I5v6thr^sQMB;4Wl^:!>1JXoҨp2EG>tõXts&j̜a/ie"Q&|Q,LA4jlA ` ߡ?p{ =5}c/C0U6igiֳ]5&@> 0 7qճ('#Ƶ7}Pyִ5[VpBW@^Zs̴$PSյ["~(𾩽 Y0M0r;7&9 •#_!?\h Rq~ w$_2л_2 &_Tu$s8I k"iѥJ3&@T jNRl!aEŭ'F SӅS5\Z$βDmt[XKBBz~Stţ0Q&/HKv&Ԍ~UYO$ja``)1LcFa-ǐZiiZt3Q<9z8SL?8XcjZAWk| 3} EtJ'sa/aoOaP籯5i)ii]~Cؕ1 ӹ.)s5,,)$޴ePibj@ݢ7˃g:XgځM6*n1yO<3I5d %+ߧv7<};'c(C$ܞ~ԊeCk۞# >ļVos h弣Q_f+bFo |}Iuq V> ~NfXɐaM6ЮsEeIb„6:yt:$|F)mt6Ķ-_P_[3!=&]15ʔeֶk]fO!B^ֳvaD.7v\l=VUZYI>1Gtlɓd& ٔ:UbP~L3L?`q}qClZѩ隤V,TAӱ##GwtVgX5#F貨C\?(Yhی{5Ğtiܓ&OW#*vbfE/U.9m9zE$hDN3]9iREIs#f)!ݎw[md6%Ӟ:DO 52͈mm:akqpZ//L7 6r0Ӎ >GLߊNrt Ԙ<5\[6)`@B_k[Oo\[X&>7aKLqa{LF7/O]~8{5P/!uGKn}$|'f,A؉%V~[?#NU4BQ9W)el+H4 %<>Lo(ӟBez6 heNn\KVI.+7 M(AmI 7@ ZZgM'$ǼS]ٵИgL/~ ) v&'|U2~veW51S- E3[Y/W11D -G_3=gRINȀf_ ;d_ gV10e#.1zviY^z$=wXnYaL!ؘ=1M0][]:$\iÑ:oӔࠔ#k 4>LL7 {q3fh0j"m6'H]Әg(7 ~x$8@֐a.ӼLjeXGLk) j%9_ -Xg?8꜊퐗]\m;5q )n}M _fΰbXue[9g~3q?:MH9SSv2, SAn)lT|Xk-q 9Ö]J(IoDoLRFi!ixɧ#Cʹ&1qI ZQڶ@#tt.LM_Yځ6Xh6@sN:jE[gk$\a\FZ6/)j0$`ٍ\F@楝0M0-2}= ¶`u\a=饣LD̆ Q6v>w;于0yŴ4:#.WWVJ<-¹]ns';LNK(rR2 PmS%T~#u8՞\b+N螙OWYdXxzfX,TxH5{@a/YnOe]1ӗqWޘ VgQ?LR+ipBмt Fgw4Ӟf] Cha O0,^0 ~WQ?՘I.SoI G]ǩ#ߑ&P_uCBc5 \K?fgCBz}0wbL=mc.IJ9$)[/~OzKiq.oPZ|oCc酧Fn{e8 `COZ?qd7pGkvlvK>aL ϙ F]f騜(Syʣ-)M4(Ǐ(lzM ud=d w/y5kI 46)G'!g ^Fi03}u=}$4&~LsLh\H&P>=Qz[ NӘ+K°Bc26 "4KJQnw#x HNL62ʄSmDO-=V5P<̢SO')kRkc6ֳvÙ ,)~a;pML,zTdC˂j=ӝzp_nk/fNz:WdCc^0%d&\*Gq~!a;dֿ*ɠwkb)==k-@ZKðH%0(}i/M/#P${J@|J>5ֿ3i rQTF[hVFy^_p+M%~6TQ0}FQ:/f~n [#g1εل'cz4 <mt =,2;L;L]9S/XεfX8438_FȄ1ɆM|3zJcNL"KF7B*# 4}zp,=abr:Mbk2M1(<6\]2ZԖ3t ؍G\G6WL7_Is]a"IENDB`pyotherside-1.2.0/docs/index.rst000066400000000000000000000605341230020142200166340ustar00rootroot00000000000000PyOtherSide Developer Guide =========================== *PyOtherSide* is a Qt 5 QML Plugin that provides access to a Python 3 interpreter from QML. It was designed with mobile devices in mind, where high-framerate touch interfaces are common, and where the user usually interfaces only with one application at a time via a touchscreen. As such, it is important to never block the UI thread, so that the user can always continue to use the interface, even when the backend is processing, downloading or calculating something in the background. At its core, PyOtherSide is basically a simple layer that converts Qt (QML) objects to Python objects and vice versa, with focus on asynchronous events and continuation-passing style function calls. While PyOtherSide once worked with Qt 4.x, and still works with Python 2.7, its focus now lies on Python 3.x and Qt 5. Python 3 has been out for several years, and offers some nice language features and clean-ups, while Qt 5 supports most mobile platforms well, and has an improved QML engine and a faster renderer (Qt Scene Graph) compared to Qt 4. QML API ======= This section describes the QML API exposed by the *PyOtherSide* QML Plugin. Import Versions --------------- The current QML API version of PyOtherSide is 1.2. When new features are introduced, or behavior is changed, the API version will be bumped and documented here. io.thp.pyotherside 1.0 `````````````````````` * Initial API release. io.thp.pyotherside 1.2 `````````````````````` * :func:`importModule` now behaves like the ``import`` statement in Python for names with dots. This means that ``importModule('x.y.z', ...)`` now works like ``import x.y.z`` in Python. * If a JavaScript exception occurs in the callback passed to :func:`importModule` or :func:`call`, the signal :func:`error` is emitted with the exception information (filename, line, message) as ``traceback``. QML ``Python`` Element ---------------------- The ``Python`` element exposes a Python interpreter in a QML file. In PyOtherSide 1.0, if multiple Python elements are instantiated, they will share the same underlying Python interpreter, so Python module-global state will be shared between all Python elements. To use the ``Python`` element in a QML file, you have to import the plugin using: .. code-block:: javascript import io.thp.pyotherside 1.2 Signals ``````` .. function:: received(var data) Default event handler for :func:`pyotherside.send` if no other event handler was set. .. function:: error(string traceback) Error handler for errors from Python. Methods ``````` To configure event handlers for events from Python, you can use the :func:`setHandler` method: .. function:: setHandler(string event, callable callback) Set the handler for events sent with :func:`pyotherside.send`. Importing modules is then done by optionally adding an import path and then importing the module asynchronously: .. function:: addImportPath(string path) Add a local filesystem path to Python's ``sys.path``. .. versionchanged:: 1.1.0 :func:`addImportPath` will automatically strip a leading ``file://`` from the path, so you can use :func:`Qt.resolvedUrl()` without having to manually strip the leading ``file://`` in QML. .. function:: importModule(string name, function callback(success) {}) Import a Python module. .. versionchanged:: 1.2.0 Previously, this function didn't work correctly for importing modules with dots in their name. Starting with the API version 1.2 (``import io.thp.pyotherside 1.2``), this behavior is now fixed, and ``importModule('x.y.z, ...)`` behaves like ``import x.y.z``. .. versionchanged:: 1.2.0 If a JavaScript exception occurs in the callback, the :func:`error` signal is emitted with ``traceback`` containing the exception info (QML API version 1.2 and newer). Once modules are imported, Python function can be called on the imported modules using: .. function:: call(string func, args=[], function callback(result) {}) Call the Python function ``func`` with ``args`` asynchronously. If ``args`` is omitted, ``func`` will be called without arguments. If ``callback`` is a callable, it will be called with the Python function result as single argument when the call has succeeded. .. versionchanged:: 1.2.0 If a JavaScript exception occurs in the callback, the :func:`error` signal is emitted with ``traceback`` containing the exception info (QML API version 1.2 and newer). For some of these methods, there also exist synchronous variants, but it is highly recommended to use the asynchronous variants instead to avoid blocking the QML UI thread: .. function:: evaluate(string expr) -> var Evaluate a Python expression synchronously. .. function:: importModule_sync(string name) -> bool Import a Python module. Returns ``true`` on success, ``false`` otherwise. .. function:: call_sync(string func, var args=[]) -> var Call a Python function. Returns the return value of the Python function. The following functions allow access to the version of the running PyOtherSide plugin and Python interpreter. .. function:: pluginVersion() -> string Get the version of the PyOtherSide plugin that is currently used. .. note:: This is not necessarily the same as the QML API version currently in use. The QML API version is decided by the QML import statement, so even if :func:`pluginVersion`` returns 1.2.0, if the plugin has been imported as ``import io.thp.pyotherside 1.0``, the API version used would be 1.0. .. versionadded:: 1.1.0 .. function:: pythonVersion() -> string Get the version of the Python interpreter that is currently used. .. versionadded:: 1.1.0 Python API ========== PyOtherSide uses a normal Python 3.x interpreter for running your Python code. The ``pyotherside`` module -------------------------- When a module is imported in PyOtherSide, it will have access to a special module called :mod:`pyotherside` in addition to all Python Standard Library modules and Python modules in ``sys.path``: .. code-block:: python import pyotherside The module can be used to send events asynchronously (even from different threads) to the QML layer, register a callback for doing clean-ups at application exit and integrate with other QML-specific features of PyOtherSide. Methods ``````` .. function:: pyotherside.send(event, \*args) Send an asynchronous event with name ``event`` with optional arguments ``args`` to QML. .. function:: pyotherside.atexit(callback) Register a ``callback`` to be called when the application is closing. .. function:: pyotherside.set_image_provider(provider) Set the QML `image provider`_ (``image://python/``). .. versionadded:: 1.1.0 .. _constants: Constants ````````` .. versionadded:: 1.1.0 These constants are used in the return value of a `image provider`_ function: **pyotherside.format_mono** Mono pixel format (``QImage::Format_Mono``). **pyotherside.format_mono_lsb** Mono pixel format, LSB alignment (``QImage::Format_MonoLSB``). **pyotherside.format_rgb32** 32-bit RGB format (``QImage::Format_RGB32``). **pyotherside.format_argb32** 32-bit ARGB format (``QImage::Format_ARGB32``). **pyotherside.format_rgb16** 16-bit RGB format (``QImage::Format_RGB16``). **pyotherside.format_rgb666** 18bpp RGB666 format (``QImage::Format_RGB666``). **pyotherside.format_rgb555** 15bpp RGB555 format (``QImage::Format_RGB555``). **pyotherside.format_rgb888** 24-bit RGB format (``QImage::Format_RGB888``). **pyotherside.format_rgb444** 12bpp RGB format (``QImage::Format_RGB444``). **pyotherside.format_data** Encoded image file data (e.g. PNG/JPEG data). Data Type Mapping ================= PyOtherSide will automatically convert Python data types to Qt data types (which in turn will be converted to QML data types by the QML engine). The following data types are supported and can be used to pass data between Python and QML (and vice versa): +--------------------+------------+-----------------------------+ | Python | QML | Remarks | +====================+============+=============================+ | bool | bool | | +--------------------+------------+-----------------------------+ | int | int | | +--------------------+------------+-----------------------------+ | float | double | | +--------------------+------------+-----------------------------+ | str | string | | +--------------------+------------+-----------------------------+ | list | JS Array | | +--------------------+------------+-----------------------------+ | tuple | JS Array | JS Arrays are converted to | | | | lists, not tuples | +--------------------+------------+-----------------------------+ | dict | JS Object | Keys must be strings | +--------------------+------------+-----------------------------+ | datetime.date | QML date | since PyOtherSide 1.2.0 | +--------------------+------------+-----------------------------+ | datetime.time | QML time | since PyOtherSide 1.2.0 | +--------------------+------------+-----------------------------+ | datetime.datetime | JS Date | since PyOtherSide 1.2.0 | +--------------------+------------+-----------------------------+ Trying to pass in other types than the ones listed here is undefined behavior and will usually result in an error. .. _image provider: Image Provider ============== .. versionadded:: 1.1.0 A QML Image Provider can be registered from Python to load image data (e.g. map tiles, diagrams, graphs or generated images) in QML ``Image`` elements without resorting to saving/loading files. An image provider has the following argument list and return values: .. code-block:: python def image_provider(image_id, requested_size): ... return bytearray(pixels), (width, height), format The parameters to the image provider functions are: **image_id** The ID of the image URL (``image://python/``). **requested_size** The source size of the QML ``Image`` as tuple: ``(width, height)``. ``(-1, -1)`` if the source size is not set. The image provider must return a tuple ``(data, size, format)``: **data** A ``bytearray`` object containing the pixel data for the given size and the given format. **size** A tuple ``(width, height)`` describing the size of the pixel data in pixels. **format** The pixel format of ``data`` (see `constants`_), or ``pyotherside.format_data`` if ``data`` contains an encoded (PNG/JPEG) image instead of raw pixel data. In order to register the image provider with PyOtherSide for use as provider for ``image://python/`` URLs, the image provider function needs to be passed to PyOtherSide: .. code-block:: python import pyotherside def image_provider(image_id, requested_size): ... pyotherside.set_image_provider(image_provider) Because Python modules are usually imported asynchronously, the image provider will only be registered once the module registering the image provider is successfully imported. You have to make sure that setting the ``source`` property on a QML ``Image`` element only happens *after* the image provider has been set (e.g. by setting the ``source`` property in the callback function passed to :func:`importModule`). Cookbook ======== This section contains code examples and best practices for combining Python and QML. Importing modules and calling functions asynchronously ------------------------------------------------------ In this example, we import the Python Standard Library module ``os`` and - when the module is imported - call the :func:`os.getcwd` function on it. The result of the :func:`os.getcwd` function is then printed to the console and :func:`os.chdir` is called with a single argument (``'/'``) - again, after the :func:`os.chdir` function has returned, a message will be printed. In this example, importing modules and calling functions are both done in an asynchronous way - the QML/GUI thread will not block while these functions execute. In fact, the ``Component.onCompleted`` code block will probably finish before the :mod:`os` module has been imported in Python. .. code-block:: javascript Python { Component.onCompleted: { importModule('os', function() { call('os.getcwd', [], function (result) { console.log('Working directory: ' + result); call('os.chdir', ['/'], function (result) { console.log('Working directory changed.'); });); }); }); } } While this `continuation-passing style`_ might look a like a little pyramid due all the nesting and indentation at first, it makes sure your application's UI is always responsive. The user will be able to interact with the GUI (e.g. scroll and move around in the UI) while the Python code can process requests. .. _Continuation-passing style: https://en.wikipedia.org/wiki/Continuation-passing_style Evaluating Python expressions in QML ```````````````````````````````````` The :func:`evaluate` method on the ``Python`` object can be used to evaluate a simple Python expression and return its result as JavaScript object: .. code-block:: javascript Python { Component.onCompleted: { console.log('Squares: ' + evaluate('[x for x in range(10)]')); } } Evaluating expressions is done synchronously, so make sure you only use it for expressions that are not long-running calculations / operations. Error handling in QML --------------------- If an error happens in Python while calling functions, the traceback of the error (or an error message in case the error happens in the PyOtherSide layer) will be sent with the :func:`error` signal of the ``Python`` element. During early development, it's probably enough to just log the error to the console: .. code-block:: javascript Python { // ... onError: console.log('Error: ' + traceback) } Once your application grows, it might make sense to maybe show the error to the user in a dialog box, message or notification in addition to or instead of using :func:`console.log()` to print the error. Handling asynchronous events from Python in QML ----------------------------------------------- Your Python code can send asynchronous events with optional data to the QML layer using the :func:`pyotherside.send` function. You can call this function from functions called from QML, but also from anywhere else - including threads that you created in Python. The first parameter is mandatory, and must be a string that identifies the event. Additional parameters are optional and can be of any data type that PyOtherSide supports: .. code-block:: python import pyotherside pyotherside.send('new-entries', 100, 123) If you do not add a special handler on the ``Python`` object, such events would be handled by the :func:`received` signal handler in QML - its ``data`` parameter contains the event name and all arguments in a list: .. code-block:: javascript Python { // .. onReceived: console.log('Event: ' + data) } Usually, you want to install a handler for such events. If you have e.g. the ``'new-entries'`` event like shown above (with two numeric parameters that we will call ``first`` and ``last`` for this example), you might want to define a simple handler function that will process this event: .. code-block:: javascript Python { // .. Component.onCompleted: { setHandler('new-entries', function (first, last) { console.log('New entries from ' + first + ' to ' + last); }); } } Once a handler for a given event is defined, the :func:`received` signal will not be emitted anymore. If you need to unset a handler for a given event, you can use ``setHandler('event', undefined)`` to do so. In some cases, it might be useful to not install a handler function directly, but turn the :func:`pyotherside.send` call into a new signal on the ``Python`` object. As there is no easy way for PyOtherSide to determine the names of the arguments of the event, you have to define and hook up these signals manually. The upside of having to define the signals this way is that all signals will be nicely documented in your QML file for future reference: .. code-block:: javascript Python { signal updated() signal newEntries(int first, int last) signal entryRenamed(int index, string name) Component.onCompleted: { setHandler('updated', updated); setHandler('new-entries', newEntries); setHandler('entry-renamed', entryRenamed); } } With this setup, you can now emit these signals from the ``Python`` object by using :func:`pyotherside.send` in your Python code: .. code-block:: python pyotherside.send('updated') pyotherside.send('new-entries', 20, 30) pyotherside.send('entry-renamed', 11, 'Hello World') Loading ``ListModel`` data from Python -------------------------------------- Most of the time a PyOtherSide QML application will display some data stored somewhere and retrieved or generated with Python. The easiest way to do this is to return a list-of-dicts in your Python function: **listmodel.py** .. code-block:: python def get_data(): return [ {'name': 'Alpha', 'team': 'red'}, {'name': 'Beta', 'team': 'blue'}, {'name': 'Gamma', 'team': 'green'}, {'name': 'Delta', 'team': 'yellow'}, {'name': 'Epsilon', 'team': 'orange'}, ] Of course, the function could do other things (such as doing web requests, querying databases, etc..) - as long as it returns a list-olf-dicts, it will be fine (if you are using a generator that yields dicts, just wrap the generator with :func:`list`). Using this function from QML is straightforward: **listmodel.qml** .. code-block:: javascript import QtQuick 2.0 import io.thp.pyotherside 1.2 Rectangle { color: 'black' width: 400 height: 400 ListView { anchors.fill: parent model: ListModel { id: listModel } delegate: Text { // Both "name" and "team" are taken from the model text: name color: team } } Python { id: py Component.onCompleted: { // Add the directory of this .qml file to the search path addImportPath(Qt.resolvedUrl('.')); // Import the main module and load the data importModule('listmodel', function () { py.call('listmodel.get_data', [], function(result) { // Load the received data into the list model for (var i=0; i # # Permission to use, copy, modify, and/or distribute this software for any # purpose with or without fee is hereby granted, provided that the above # copyright notice and this permission notice appear in all copies. # # THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH # REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND # FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, # INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM # LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR # OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR # PERFORMANCE OF THIS SOFTWARE. # import pyotherside import os import random from PIL import Image from PIL import ImageDraw def render(image_id, requested_size): # width and height will be -1 if not set in QML if requested_size == (-1, -1): requested_size = (300, 300) img = Image.new('RGBA', requested_size) filename = os.path.join(os.path.dirname(__file__), image_id) logo = Image.open(filename) for x in range(100): img.paste(logo, (random.randint(0, requested_size[0]), random.randint(0, requested_size[1]))) draw = ImageDraw.Draw(img) for x in range(100): draw.text((random.randint(0, requested_size[0]), random.randint(0, requested_size[1])), 'PyOtherSide PIL Test', fill=(random.randint(10, 255), random.randint(10, 255), random.randint(10, 255))) del draw b, g, r, a = img.split() img = Image.merge("RGBA", (r, g, b, a)) return bytearray(img.tostring()), img.size, pyotherside.format_argb32 pyotherside.set_image_provider(render) pyotherside-1.2.0/examples/image_loader.qml000066400000000000000000000024661230020142200210040ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ import QtQuick 2.0 import io.thp.pyotherside 1.0 Image { id: image width: 300 height: 300 Python { Component.onCompleted: { // Add the directory of this .qml file to the search path addImportPath(Qt.resolvedUrl('.')); importModule('image_loader', function () { image.source = 'image://python/pyotherside.png'; }); } onError: console.log('Python error: ' + traceback) } } pyotherside-1.2.0/examples/imageprovider_data.py000066400000000000000000000053761230020142200220640ustar00rootroot00000000000000# # PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 # Copyright (c) 2011, 2013, Thomas Perl # # Permission to use, copy, modify, and/or distribute this software for any # purpose with or without fee is hereby granted, provided that the above # copyright notice and this permission notice appear in all copies. # # THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH # REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND # FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, # INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM # LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR # OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR # PERFORMANCE OF THIS SOFTWARE. # import pyotherside import os import base64 # base64-encoded image data (PNG) IMAGE_DATA = b""" iVBORw0KGgoAAAANSUhEUgAAAGAAAABgCAMAAADVRocKAAABRFBMVEX////C0d5+pcZklb1JhbZD g7ZDf7JQhbBkkbV9ob/X3uOdutFDhbs4gr44fLU3ea83dqtkjrI4f7o3c6VCc6VJiLtEicDN3+73 9/+CrdFwlrWbv9329fU8cp6Cr9Q2bZybvdo3apRakb/v7+//7WD/5ln44W5/qMr/617/41T51ls4 hcP/20z12oL7zkewx9n/1UTx5cNyoMVQfKH16Mb/4FL/0ED12Y1Sjb341Wj4zVd/nrjx7Nr/zDv7 yED71U/8xTmAo8DG1OD/2En/xTJDeafc4ef145j64mL7wDf15qb/vCn5wkSApsb3zXTz8vJCfa76 vkCQr8n/tSH22Jf5wEmhus9Jf6z/zVf/4Jf/1nv/9+X/03b9vi7/+/L/1oP33pL/z2r/7cj/5Kz/ uC330oT4x2L236D/tTH31Hvr6urm5uaTuO3WAAAAAWJLR0QAiAUdSAAAAAlwSFlzAAAASAAAAEgA RslrPgAAAnBJREFUaN7tlltz0kAYQBcVRcsmbdDWKooppDZNRFRAUWhtoViKFjXWe73f/f/v7iVZ toG8ZD9mdNzz2plzyJdvt0FIo9FoNBrNv0bm2PET2ZOEU7nTZ+D1c3mMsWEYpmnOExbA/RhblmXQ AtEXCoWzwIFzeHHp/DJ7ANMsUC7ABvL4IkLFcEAscAk2gPFlhJYM4S+VStABvHwlKwZUAg+wF3zE Dx0QGxr5gQOCXBSwgYSZFXrCcHxAtm2XKxXHcVYV/VcxTvDb5bU1x3XddSX/nOd59Ahb0gkQAYf6 ff+aSmCR+6UrQvjtssv8flXBf91LHBALEL1fq91IH7jpefIdKhaIcqveaFB9rXk7feAOThyQnWn5 3N+8mz6QTx7QvXbo73Q20gcsa/KK4PPJtDepn+g7nfvpA/Lv39ouj6m3ut0u9/d6PaUnMHhhp/9g t8Kh68/XJ/QrBLJiQP1VoXca0fqE/kH6wErk39qb4m9y//Bh+sCj6AT0d8fjccX69Jh/uJ8+sB2e gPmRE/NH4yH+YTt9AD0ON3SU4Cf64RMFP3rKP7N4YHJ9qD94phJAOX5FjKauD/MfKPkRev5ih4DI P5fQX61WNxgDhsIbPoIYfwtIGMedWB+F4zU9EH+9wAE6/uj27L189Zq8XtiAL6/PG4TeBoewgU12 O4fXwzuE3gfAI/og3z4fP33+EnyFDaB16fYJCN+A/Qh9r0anl+h/qN0PCdR/HgwO6e22r/AlpPlr KY4mmIU8/OoCjRSLsloGpiHrf42REwC/X+h/c0QCojDjJ5j9O2CJ4pQlJdA/qOulSgwwt0aj0Wg0 Gs1/wR/yOd+mI4x7LgAAACV0RVh0ZGF0ZTpjcmVhdGUAMjAxMy0xMC0wNFQwMzo1OTozNCswMDow MLgfTfgAAAAldEVYdGRhdGU6bW9kaWZ5ADIwMTMtMTAtMDRUMDM6NTk6MzQrMDA6MDDJQvVEAAAA AElFTkSuQmCC """ def load_data(image_id, requested_size): # If you return data in the format "pyotherside.format_data", the size is # ignored; the data is interpreted as image file data (e.g. PNG, jpeg, ..) return bytearray(base64.b64decode(IMAGE_DATA)), (-1, -1), pyotherside.format_data pyotherside.set_image_provider(load_data) pyotherside-1.2.0/examples/imageprovider_data.qml000066400000000000000000000024721230020142200222170ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ import QtQuick 2.0 import io.thp.pyotherside 1.0 Image { id: image width: 300 height: 300 Python { Component.onCompleted: { // Add the directory of this .qml file to the search path addImportPath(Qt.resolvedUrl('.')); importModule('imageprovider_data', function () { image.source = 'image://python/get-some-data'; }); } onError: console.log('Python error: ' + traceback) } } pyotherside-1.2.0/examples/imageprovider_example.py000066400000000000000000000031621230020142200225750ustar00rootroot00000000000000# # PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 # Copyright (c) 2011, 2013, Thomas Perl # # Permission to use, copy, modify, and/or distribute this software for any # purpose with or without fee is hereby granted, provided that the above # copyright notice and this permission notice appear in all copies. # # THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH # REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND # FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, # INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM # LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR # OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR # PERFORMANCE OF THIS SOFTWARE. # import pyotherside import math def render(image_id, requested_size): print('image_id: "{image_id}", size: {requested_size}'.format(**locals())) # width and height will be -1 if not set in QML if requested_size == (-1, -1): requested_size = (300, 300) width, height = requested_size # center for circle cx, cy = width/2, 10 pixels = [] for y in range(height): for x in range(width): pixels.extend(reversed([ 255, # alpha int(10 + 10 * ((x - y * 0.5) % 20)), # red 20 + 10 * (y % 20), # green int(255 * abs(math.sin(0.3*math.sqrt((cx-x)**2 + (cy-y)**2)))) # blue ])) return bytearray(pixels), (width, height), pyotherside.format_argb32 pyotherside.set_image_provider(render) pyotherside-1.2.0/examples/imageprovider_example.qml000066400000000000000000000025101230020142200227320ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ import QtQuick 2.0 import io.thp.pyotherside 1.0 Image { id: image width: 300 height: 300 Python { Component.onCompleted: { // Add the directory of this .qml file to the search path addImportPath(Qt.resolvedUrl('.')); importModule('imageprovider_example', function () { image.source = 'image://python/image-id-passed-from-qml'; }); } onError: console.log('Python error: ' + traceback) } } pyotherside-1.2.0/examples/listmodel.py000066400000000000000000000004711230020142200202210ustar00rootroot00000000000000# Example how to fill a list model with data from Python. def get_data(): return [ {'name': 'Alpha', 'team': 'red'}, {'name': 'Beta', 'team': 'blue'}, {'name': 'Gamma', 'team': 'green'}, {'name': 'Delta', 'team': 'yellow'}, {'name': 'Epsilon', 'team': 'orange'}, ] pyotherside-1.2.0/examples/listmodel.qml000066400000000000000000000017311230020142200203620ustar00rootroot00000000000000import QtQuick 2.0 import io.thp.pyotherside 1.0 Rectangle { color: 'black' width: 400 height: 400 ListView { anchors.fill: parent model: ListModel { id: listModel } delegate: Text { // Both "name" and "team" are taken from the model text: name color: team } } Python { id: py Component.onCompleted: { // Add the directory of this .qml file to the search path addImportPath(Qt.resolvedUrl('.')); // Import the main module and load the data importModule('listmodel', function () { py.call('listmodel.get_data', [], function(result) { // Load the received data into the list model for (var i=0; i # # Permission to use, copy, modify, and/or distribute this software for any # purpose with or without fee is hereby granted, provided that the above # copyright notice and this permission notice appear in all copies. # # THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH # REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND # FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, # INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM # LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR # OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR # PERFORMANCE OF THIS SOFTWARE. # import pyotherside import random COLORS = [(255, 255, 255, 255), (255, 0, 0, 0)] for i in range(30): COLORS.insert(1, ( 255, # alpha random.randint(30, 255), # red random.randint(30, 255), # green random.randint(30, 255), # blue )) # Of course, in production code, you don't want to calculate your mandelbrot # set in CPython for performance reasons. This is just an example of what is # possible with the image provider support in PyOtherSide. def mandelbrot(x, y, steps): a = b = 0 for i in range(steps): a, b = a**2 - b**2 + x, 2*a*b + y if a**2 + b**2 >= 4: break return i def render_mandelbrot(image_id, requested_size): # when the url is: "image://python/xmin/xmax/ymin/ymax" # the image_id is: "xmin/xmax/ymin/ymax" parts = [float(x) for x in image_id.split('/')] x_range = parts[0:2] y_range = parts[2:4] # width and height will be -1 if not set in QML if requested_size == (-1, -1): requested_size = (200, 200) width, height = requested_size pixels = [] for y in range(height): yy = y_range[0] + (y_range[1] - y_range[0]) * y / height for x in range(width): xx = x_range[0] + (x_range[1] - x_range[0]) * x / width pixels.extend(reversed(COLORS[mandelbrot(xx, yy, len(COLORS))])) return bytearray(pixels), (width, height), pyotherside.format_argb32 pyotherside.set_image_provider(render_mandelbrot) pyotherside-1.2.0/examples/mandelbrot.qml000066400000000000000000000070401230020142200205140ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ import QtQuick 2.0 import io.thp.pyotherside 1.0 Image { id: image width: 300 height: 300 property real zoomFactor: 1.2 property real zoom: 2.5 property real xCenter: -0.5 property real yCenter: 0.0 property real xRange: zoom property real yRange: zoom * height / width property real mLeft: xCenter - xRange / 2 property real mRight: xCenter + xRange / 2 property real mTop: yCenter - yRange / 2 property real mBottom: yCenter + yRange / 2 onXRangeChanged: updateImageTimer.start() onYRangeChanged: updateImageTimer.start() onXCenterChanged: updateImageTimer.start() onYCenterChanged: updateImageTimer.start() sourceSize { width: image.width / 4 height: image.height / 4 } MouseArea { anchors.fill: parent property real lastPosX property real lastPosY onPressed: { lastPosX = mouse.x; lastPosY = mouse.y; } onPositionChanged: { var diffX = (mouse.x - lastPosX); var diffY = (mouse.y - lastPosY); image.xCenter -= diffX / image.width * image.xRange; image.yCenter -= diffY / image.height * image.yRange; lastPosX = mouse.x; lastPosY = mouse.y; } } Column { spacing: 10 anchors { right: parent.right top: parent.top margins: 10 } Rectangle { width: 30; height: 30 color: '#aaffffff' Text { anchors.centerIn: parent text: '-' } MouseArea { anchors.fill: parent onClicked: image.zoom *= image.zoomFactor } } Rectangle { width: 30; height: 30 color: '#aaffffff' Text { anchors.centerIn: parent text: '+' } MouseArea { anchors.fill: parent onClicked: image.zoom /= image.zoomFactor } } } Python { id: py Component.onCompleted: { // Add the directory of this .qml file to the search path py.addImportPath(Qt.resolvedUrl('.')); py.importModule('mandelbrot', function () { // Do the first image update once the module is loaded updateImageTimer.start(); }); } onError: console.log('Python error: ' + traceback) } Timer { id: updateImageTimer interval: 100 onTriggered: image.source = 'image://python/' + image.mLeft + '/' + image.mRight + '/' + image.mTop + '/' + image.mBottom } } pyotherside-1.2.0/examples/notes_example.py000066400000000000000000000021601230020142200210650ustar00rootroot00000000000000# A very simple notetaking application that uses Python to load # and save a string in a text file in the user's home directory. import os import threading import time import pyotherside class Notes: def __init__(self): self.filename = os.path.expanduser('~/pyotherside_notes.txt') self.thread = None self.new_text = self.get_contents() def save_now(self): print('Saving file right away at exit') self._update_file(now=True) def _update_file(self, now=False): if not now: time.sleep(3) print('Saving file now') open(self.filename, 'w').write(self.new_text) self.thread = None def get_contents(self): if os.path.exists(self.filename): return open(self.filename).read() else: return '' def set_contents(self, text): self.new_text = text if self.thread is None: print('Scheduling saving of file') self.thread = threading.Thread(target=self._update_file) self.thread.start() notes = Notes() pyotherside.atexit(notes.save_now) pyotherside-1.2.0/examples/notes_example.qml000066400000000000000000000016511230020142200212320ustar00rootroot00000000000000import QtQuick 2.0 import io.thp.pyotherside 1.0 Rectangle { width: 300 height: 200 TextInput { id: ti anchors.fill: parent onTextChanged: { py.call('notes_example.notes.set_contents', [text], function() { console.log('Changes sent to Python'); }); } Python { id: py Component.onCompleted: { // Add the directory of this .qml file to the search path addImportPath(Qt.resolvedUrl('.')); importModule('notes_example', function () { console.log('imported python module'); call('notes_example.notes.get_contents', [], function(result) { console.log('got contents from Python: ' + result); ti.text = result; }); }); } } } } pyotherside-1.2.0/examples/plotorama.py000066400000000000000000000025431230020142200202250ustar00rootroot00000000000000# # PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 # Copyright (c) 2011, 2013, Thomas Perl # # Permission to use, copy, modify, and/or distribute this software for any # purpose with or without fee is hereby granted, provided that the above # copyright notice and this permission notice appear in all copies. # # THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH # REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND # FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, # INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM # LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR # OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR # PERFORMANCE OF THIS SOFTWARE. # import matplotlib.pyplot as plt import numpy as np import io import pyotherside def plot_provider(image_id, requested_size): plt.figure() x = np.arange(0.0, 5.0, 0.1) plt.plot(np.sin(x)) for dataset in image_id.split(';'): plt.plot([float(x) for x in dataset.split(',') if x]) plt.title("Dataset from QML") buf = io.BytesIO() plt.savefig(buf, format='png') plt.close() buf.seek(0) return bytearray(buf.read()), requested_size, pyotherside.format_data pyotherside.set_image_provider(plot_provider) pyotherside-1.2.0/examples/plotorama.qml000066400000000000000000000030241230020142200203610ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ import QtQuick 2.0 import io.thp.pyotherside 1.0 Image { id: image width: 300 height: 300 Python { Component.onCompleted: { // Add the directory of this .qml file to the search path addImportPath(Qt.resolvedUrl('.')); importModule('plotorama', function () { input.text = '4.3,5.5,3.3,2.2,1.4,1.3,1.2,0.7,0.2'; }); } onError: console.log('Python error: ' + traceback) } TextInput { id: input anchors { top: parent.top left: parent.left right: parent.right } onTextChanged: image.source = 'image://python/' + text } } pyotherside-1.2.0/examples/pyotherside.png000066400000000000000000000046251230020142200207250ustar00rootroot00000000000000PNG  IHDR?XB/=sBIT|d pHYs B(xtEXtSoftwarewww.inkscape.org< IDATx{p\u?ޛ&i҇M XR(k(”ͮKXpQ(è((ph A^fȈ c%ݹyqZk (m4fI{춓M3;"xq88I~$+5yF,YR2l)TV#n=}}D"q B@~F{"xP^& fZ=Eo&hX- ( L^D$ߊY d2>'ȉ|$9  ئMm@>׈:S a !` rRFkP\s-3 f8PxBζl1 YNqh6fEypSSiԷ‹Fg(zo ⶉf`:0 B,흓H$~ܞC,i#+b-V/)DFE#(0϶Yx"#h4Z-@I0k0;cXԵ@/ x$_GÓ|]]BAulO[ZZ(2rq$6WI RYYN`h4Z6Uu^ }e4ڵkf2;J==޿ymM0*/HG9067:NX,Gy<+%H$\%/"B U=Lpq'/(E"]?A.IGQMI?W_ۅЋ0M(8^-sPM.]a<NKvBմC7?!`3ORFu +.ꭡdpZPP`Ӓ#\2.%J Evv $erФ@iEZ̟v~lKeu>~miH$1HͽgbG;6NaP˱f57N7=gXnD poE2Rx2Syp\zoI!52='s gO_l[d[%厹qbmgɴ"g!i\V촡A[}o$\!0kbs'9w5=yqWߛ7LX,?PFuuu 16fP"\1sS̛-[z-pဨ@W6p_wWWWƍ@(kI"Z? R&im /w:}0QS4t3И~nYyW^衰3o+^Cc=t{!'q]_)'oϼkhlex m 1 0x m?E$z/ ]1QbOQ-OL @ :7,1*hZ{GVD|M7ŊIENDB`pyotherside-1.2.0/pyotherside.pri000066400000000000000000000000521230020142200171030ustar00rootroot00000000000000PROJECTNAME = pyotherside VERSION = 1.2.0 pyotherside-1.2.0/pyotherside.pro000066400000000000000000000006371230020142200171220ustar00rootroot00000000000000TEMPLATE = subdirs SUBDIRS += src tests tests.depends = src include(pyotherside.pri) tar.target = $${PROJECTNAME}-$${VERSION}.tar tar.commands = git archive --format=tar --prefix=$${PROJECTNAME}-$${VERSION}/ --output=$@ $${VERSION} targz.target = $${PROJECTNAME}-$${VERSION}.tar.gz targz.depends = tar targz.commands = gzip $^ sdist.target = sdist sdist.depends = targz QMAKE_EXTRA_TARGETS += tar targz sdist pyotherside-1.2.0/python.pri000066400000000000000000000003221230020142200160650ustar00rootroot00000000000000isEmpty(PYTHON_CONFIG) { PYTHON_CONFIG = python3-config } message(PYTHON_CONFIG = $$PYTHON_CONFIG) QMAKE_LIBS += $$system($$PYTHON_CONFIG --ldflags) QMAKE_CXXFLAGS += $$system($$PYTHON_CONFIG --includes) pyotherside-1.2.0/src/000077500000000000000000000000001230020142200146225ustar00rootroot00000000000000pyotherside-1.2.0/src/converter.h000066400000000000000000000124351230020142200170070ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, 2014, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #ifndef PYOTHERSIDE_CONVERTER_H #define PYOTHERSIDE_CONVERTER_H struct ConverterDate { ConverterDate(int y, int m, int d) : y(y), m(m), d(d) { } int y, m, d; }; struct ConverterTime { ConverterTime(int h, int m, int s, int ms) : h(h), m(m), s(s), ms(ms) { } int h, m, s, ms; }; struct ConverterDateTime : public ConverterDate { ConverterDateTime(int y, int m, int d, int h, int mm, int s, int ms) : ConverterDate(y, m, d) , time(h, mm, s, ms) { } ConverterTime time; }; template class ListBuilder { public: ListBuilder() {} virtual ~ListBuilder() {} virtual void append(V) = 0; virtual V value() = 0; }; template class DictBuilder { public: DictBuilder() {} virtual ~DictBuilder() {} virtual void set(V, V) = 0; virtual V value() = 0; }; template class ListIterator { public: ListIterator() {} virtual ~ListIterator() {} virtual int count() = 0; virtual bool next(V*) = 0; }; template class DictIterator { public: DictIterator() {} virtual ~DictIterator() {} virtual bool next(V*, V*) = 0; }; template class Converter { public: Converter() {} virtual ~Converter() {} enum Type { NONE = 0, INTEGER, FLOATING, BOOLEAN, STRING, LIST, DICT, DATE, TIME, DATETIME, }; virtual enum Type type(V&) = 0; virtual long long integer(V&) = 0; virtual double floating(V&) = 0; virtual bool boolean(V&) = 0; virtual const char *string(V&) = 0; virtual ListIterator *list(V&) = 0; virtual DictIterator *dict(V&) = 0; virtual ConverterDate date(V&) = 0; virtual ConverterTime time(V&) = 0; virtual ConverterDateTime dateTime(V&) = 0; virtual V fromInteger(long long v) = 0; virtual V fromFloating(double v) = 0; virtual V fromBoolean(bool v) = 0; virtual V fromString(const char *v) = 0; virtual V fromDate(ConverterDate date) = 0; virtual V fromTime(ConverterTime time) = 0; virtual V fromDateTime(ConverterDateTime dateTime) = 0; virtual ListBuilder *newList() = 0; virtual DictBuilder *newDict() = 0; virtual V none() = 0; }; template T convert(F from) { FC fconv; TC tconv; switch (fconv.type(from)) { case FC::NONE: return tconv.none(); case FC::INTEGER: return tconv.fromInteger(fconv.integer(from)); case FC::FLOATING: return tconv.fromFloating(fconv.floating(from)); case FC::BOOLEAN: return tconv.fromBoolean(fconv.boolean(from)); case FC::STRING: return tconv.fromString(fconv.string(from)); case FC::LIST: { ListBuilder *listBuilder = tconv.newList(); F listValue; ListIterator *listIterator = fconv.list(from); while (listIterator->next(&listValue)) { listBuilder->append(convert(listValue)); } delete listIterator; T listResult = listBuilder->value(); delete listBuilder; return listResult; } case FC::DICT: { DictBuilder *dictBuilder = tconv.newDict(); DictIterator *dictIterator = fconv.dict(from); FC keyConvFrom; TC keyConvTo; F dictKey; F dictValue; while (dictIterator->next(&dictKey, &dictValue)) { dictBuilder->set(keyConvTo.fromString(keyConvFrom.string(dictKey)), convert(dictValue)); } delete dictIterator; T dictResult = dictBuilder->value(); delete dictBuilder; return dictResult; } case FC::DATE: return tconv.fromDate(fconv.date(from)); case FC::TIME: return tconv.fromTime(fconv.time(from)); case FC::DATETIME: return tconv.fromDateTime(fconv.dateTime(from)); } return tconv.none(); } #endif /* PYOTHERSIDE_CONVERTER_H */ pyotherside-1.2.0/src/global_libpython_loader.cpp000066400000000000000000000040431230020142200222050ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2013, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #include "global_libpython_loader.h" namespace GlobalLibPythonLoader { #ifdef __linux__ #define _GNU_SOURCE #include #include #include static int load_python_globally_callback(struct dl_phdr_info *info, size_t size, void *data) { int major, minor; const char *basename = strrchr(info->dlpi_name, '/'); int *success = (int *)data; if (basename != NULL) { if (sscanf(basename, "/libpython%d.%d.so", &major, &minor) != 2) { if (sscanf(basename, "/libpython%d.%dm.so", &major, &minor) != 2) { return 0; } } void *pylib = dlopen(info->dlpi_name, RTLD_GLOBAL | RTLD_NOW); if (pylib != NULL) { *success = 1; } else { fprintf(stderr, "Could not load python library '%s': %s\n", info->dlpi_name, dlerror()); } } return 0; } bool loadPythonGlobally() { int success = 0; dl_iterate_phdr(load_python_globally_callback, &success); return success; } #else /* __linux__ */ bool loadPythonGlobally() { /* On non-Linux systems, no need to load globally */ return true; } #endif /* __linux__ */ }; /* namespace GlobalLibPythonLoader */ pyotherside-1.2.0/src/global_libpython_loader.h000066400000000000000000000020421230020142200216470ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2013, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #ifndef PYOTHERSIDE_GLOBAL_LIBPYTHON_LOADER_H #define PYOTHERSIDE_GLOBAL_LIBPYTHON_LOADER_H namespace GlobalLibPythonLoader { bool loadPythonGlobally(); }; #endif /* PYOTHERSIDE_GLOBAL_LIBPYTHON_LOADER_H */ pyotherside-1.2.0/src/pyobject_converter.h000066400000000000000000000171311230020142200207040ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, 2014, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #ifndef PYOTHERSIDE_PYOBJECT_CONVERTER_H #define PYOTHERSIDE_PYOBJECT_CONVERTER_H #include "converter.h" #include "Python.h" #include "datetime.h" #if PY_MAJOR_VERSION >= 3 # define PY3K #endif class PyObjectListBuilder : public ListBuilder { public: PyObjectListBuilder() : list(PyList_New(0)) {} virtual ~PyObjectListBuilder() {} virtual void append(PyObject *o) { PyList_Append(list, o); } virtual PyObject * value() { return list; } private: PyObject *list; }; class PyObjectDictBuilder : public DictBuilder { public: PyObjectDictBuilder() : dict(PyDict_New()) {} virtual ~PyObjectDictBuilder() {} virtual void set(PyObject *key, PyObject *value) { PyDict_SetItem(dict, key, value); Py_DECREF(value); } virtual PyObject * value() { return dict; } private: PyObject *dict; }; class PyObjectListIterator : public ListIterator { public: PyObjectListIterator(PyObject *&v) : list(v), pos(0) {} virtual ~PyObjectListIterator() {} virtual int count() { if (PyList_Check(list)) { return PyList_Size(list); } else { return PyTuple_Size(list); } } virtual bool next(PyObject **v) { if (pos == count()) { return false; } if (PyList_Check(list)) { *v = PyList_GetItem(list, pos); } else { *v = PyTuple_GetItem(list, pos); } pos++; return true; } private: PyObject *list; int pos; }; class PyObjectDictIterator : public DictIterator { public: PyObjectDictIterator(PyObject *&v) : dict(v), pos(0) {} virtual ~PyObjectDictIterator() {} virtual bool next(PyObject **key, PyObject **value) { return PyDict_Next(dict, &pos, key, value); } private: PyObject *dict; Py_ssize_t pos; }; class PyObjectConverter : public Converter { public: PyObjectConverter() : stringcontainer(NULL) { static bool datetime_imported = false; if (!datetime_imported) { PyDateTime_IMPORT; datetime_imported = true; } } virtual ~PyObjectConverter() { if (stringcontainer != NULL) { Py_DECREF(stringcontainer); } } virtual enum Type type(PyObject *&o) { if (PyBool_Check(o)) { return BOOLEAN; #ifdef PY3K } else if (PyLong_Check(o)) { return INTEGER; #else } else if (PyLong_Check(o) || PyInt_Check(o)) { return INTEGER; #endif } else if (PyFloat_Check(o)) { return FLOATING; } else if (PyUnicode_Check(o) || PyBytes_Check(o)) { return STRING; } else if (PyDateTime_Check(o)) { // Need to check PyDateTime before PyDate, because // it is a subclass of PyDate. return DATETIME; } else if (PyDate_Check(o)) { return DATE; } else if (PyTime_Check(o)) { return TIME; } else if (PyList_Check(o) || PyTuple_Check(o)) { return LIST; } else if (PyDict_Check(o)) { return DICT; } else if (o == Py_None) { return NONE; } fprintf(stderr, "Warning: Cannot convert:"); PyObject_Print(o, stderr, 0); fprintf(stderr, "\n"); return NONE; } virtual long long integer(PyObject *&o) { #ifdef PY3K return PyLong_AsLong(o); #else if (PyInt_Check(o)) { return PyInt_AsLong(o); } else { return PyLong_AsLong(o); } #endif } virtual double floating(PyObject *&o) { return PyFloat_AsDouble(o); } virtual bool boolean(PyObject *&o) { return (o == Py_True); } virtual const char *string(PyObject *&o) { if (PyBytes_Check(o)) { return PyBytes_AsString(o); } // XXX: In Python 3.3, we can use PyUnicode_UTF8() if (stringcontainer != NULL) { Py_DECREF(stringcontainer); } stringcontainer = PyUnicode_AsUTF8String(o); return PyBytes_AsString(stringcontainer); } virtual ListIterator *list(PyObject *&o) { return new PyObjectListIterator(o); } virtual DictIterator *dict(PyObject *&o) { return new PyObjectDictIterator(o);; } virtual ConverterDate date(PyObject *&o) { return ConverterDate(PyDateTime_GET_YEAR(o), PyDateTime_GET_MONTH(o), PyDateTime_GET_DAY(o)); } virtual ConverterTime time(PyObject *&o) { return ConverterTime(PyDateTime_TIME_GET_HOUR(o), PyDateTime_TIME_GET_MINUTE(o), PyDateTime_TIME_GET_SECOND(o), PyDateTime_TIME_GET_MICROSECOND(o) / 1000); } virtual ConverterDateTime dateTime(PyObject *&o) { return ConverterDateTime(PyDateTime_GET_YEAR(o), PyDateTime_GET_MONTH(o), PyDateTime_GET_DAY(o), PyDateTime_DATE_GET_HOUR(o), PyDateTime_DATE_GET_MINUTE(o), PyDateTime_DATE_GET_SECOND(o), PyDateTime_DATE_GET_MICROSECOND(o) / 1000); } virtual PyObject * fromInteger(long long v) { return PyLong_FromLong((long)v); } virtual PyObject * fromFloating(double v) { return PyFloat_FromDouble(v); } virtual PyObject * fromBoolean(bool v) { return PyBool_FromLong((long)v); } virtual PyObject * fromString(const char *v) { return PyUnicode_FromString(v); } virtual PyObject * fromDate(ConverterDate v) { return PyDate_FromDate(v.y, v.m, v.d); } virtual PyObject * fromTime(ConverterTime v) { return PyTime_FromTime(v.h, v.m, v.s, 1000 * v.ms); } virtual PyObject * fromDateTime(ConverterDateTime v) { return PyDateTime_FromDateAndTime(v.y, v.m, v.d, v.time.h, v.time.m, v.time.s, v.time.ms * 1000); } virtual ListBuilder *newList() { return new PyObjectListBuilder(); } virtual DictBuilder *newDict() { return new PyObjectDictBuilder(); } virtual PyObject * none() { Py_RETURN_NONE; } private: PyObject *stringcontainer; }; #endif /* PYOTHERSIDE_PYOBJECT_CONVERTER_H */ pyotherside-1.2.0/src/pyotherside_plugin.cpp000066400000000000000000000041261230020142200212460ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, 2014, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #include "qpython_priv.h" #include "qpython.h" #include "qpython_imageprovider.h" #include "global_libpython_loader.h" #include "pyotherside_plugin.h" static void pyotherside_atexit() { QPythonPriv::closing(); } PyOtherSideExtensionPlugin::PyOtherSideExtensionPlugin() { atexit(pyotherside_atexit); } PyOtherSideExtensionPlugin::~PyOtherSideExtensionPlugin() { } void PyOtherSideExtensionPlugin::initializeEngine(QQmlEngine *engine, const char *uri) { Q_ASSERT(QString(PYOTHERSIDE_PLUGIN_ID) == uri); // In some Linux distributions, the plugin (and subsequently libpython) // isn't loaded with the RTLD_GLOBAL flag, so symbols in libpython that // are needed by shared Python modules won't be resolved unless we also // load libpython again RTLD_GLOBAL again. We do this here. GlobalLibPythonLoader::loadPythonGlobally(); engine->addImageProvider(PYOTHERSIDE_IMAGEPROVIDER_ID, new QPythonImageProvider); } void PyOtherSideExtensionPlugin::registerTypes(const char *uri) { Q_ASSERT(QString(PYOTHERSIDE_PLUGIN_ID) == uri); qmlRegisterType(uri, 1, 0, PYOTHERSIDE_QPYTHON_NAME); // There is no PyOtherSide 1.1 import, as it's the same as 1.0 qmlRegisterType(uri, 1, 2, PYOTHERSIDE_QPYTHON_NAME); } pyotherside-1.2.0/src/pyotherside_plugin.h000066400000000000000000000027371230020142200207210ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, 2014, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #ifndef PYOTHERSIDE_PLUGIN_H #define PYOTHERSIDE_PLUGIN_H #include #include #define PYOTHERSIDE_PLUGIN_ID "io.thp.pyotherside" #define PYOTHERSIDE_IMAGEPROVIDER_ID "python" #define PYOTHERSIDE_QPYTHON_NAME "Python" class Q_DECL_EXPORT PyOtherSideExtensionPlugin : public QQmlExtensionPlugin { Q_OBJECT Q_PLUGIN_METADATA(IID PYOTHERSIDE_PLUGIN_ID) public: PyOtherSideExtensionPlugin(); ~PyOtherSideExtensionPlugin(); virtual void initializeEngine(QQmlEngine *engine, const char *uri); virtual void registerTypes(const char *uri); }; #endif /* PYOTHERSIDE_PLUGIN_H */ pyotherside-1.2.0/src/qml_python_bridge.h000066400000000000000000000024671230020142200205120ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, 2014, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #ifndef PYOTHERSIDE_QML_PYTHON_BRIDGE_H #define PYOTHERSIDE_QML_PYTHON_BRIDGE_H #include "pyobject_converter.h" #include "qvariant_converter.h" inline PyObject * convertQVariantToPyObject(QVariant v) { return convert(v); } inline QVariant convertPyObjectToQVariant(PyObject *o) { return convert(o); } #endif /* PYOTHERSIDE_QML_PYTHON_BRIDGE_H */ pyotherside-1.2.0/src/qmldir000066400000000000000000000000631230020142200160340ustar00rootroot00000000000000module io.thp.pyotherside plugin pyothersideplugin pyotherside-1.2.0/src/qpython.cpp000066400000000000000000000215731230020142200170400ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, 2014, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #include "qml_python_bridge.h" #include "qpython.h" #include "qpython_priv.h" #include "qpython_worker.h" #include #include #define SINCE_API_VERSION(smaj, smin) \ ((api_version_major > smaj) || (api_version_major == smaj && api_version_minor >= smin)) QPythonPriv * QPython::priv = NULL; QPython::QPython(QObject *parent, int api_version_major, int api_version_minor) : QObject(parent) , worker(new QPythonWorker(this)) , thread() , handlers() , api_version_major(api_version_major) , api_version_minor(api_version_minor) { if (priv == NULL) { priv = new QPythonPriv; } worker->moveToThread(&thread); QObject::connect(priv, SIGNAL(receive(QVariant)), this, SLOT(receive(QVariant))); QObject::connect(this, SIGNAL(process(QString,QVariant,QJSValue *)), worker, SLOT(process(QString,QVariant,QJSValue *))); QObject::connect(worker, SIGNAL(finished(QVariant,QJSValue *)), this, SLOT(finished(QVariant,QJSValue *))); QObject::connect(this, SIGNAL(import(QString,QJSValue *)), worker, SLOT(import(QString,QJSValue *))); QObject::connect(worker, SIGNAL(imported(bool,QJSValue *)), this, SLOT(imported(bool,QJSValue *))); thread.setObjectName("QPythonWorker"); thread.start(); } QPython::~QPython() { thread.quit(); thread.wait(); delete worker; } void QPython::addImportPath(QString path) { priv->enter(); // Strip leading "file://" (for use with Qt.resolvedUrl()) if (path.startsWith("file://")) { path = path.mid(7); } QByteArray utf8bytes = path.toUtf8(); PyObject *sys_path = PySys_GetObject((char*)"path"); PyObject *cwd = PyUnicode_FromString(utf8bytes.constData()); PyList_Insert(sys_path, 0, cwd); Py_DECREF(cwd); priv->leave(); } void QPython::importModule(QString name, QJSValue callback) { QJSValue *cb = 0; if (!callback.isNull() && !callback.isUndefined() && callback.isCallable()) { cb = new QJSValue(callback); } emit import(name, cb); } bool QPython::importModule_sync(QString name) { // Lesson learned: name.toUtf8().constData() doesn't work, as the // temporary QByteArray will be destroyed after constData() has // returned, so we need to save the toUtf8() result in a local // variable that doesn't get destroyed until the function returns. QByteArray utf8bytes = name.toUtf8(); const char *moduleName = utf8bytes.constData(); priv->enter(); bool use_api_10 = (api_version_major == 1 && api_version_minor == 0); PyObject *module = NULL; if (use_api_10) { // PyOtherSide API 1.0 behavior (star import) module = PyImport_ImportModule(moduleName); } else { // PyOtherSide API 1.2 behavior: "import x.y.z" PyObject *fromList = PyList_New(0); module = PyImport_ImportModuleEx(const_cast(moduleName), NULL, NULL, fromList); Py_XDECREF(fromList); } if (module == NULL) { emit error(QString("Cannot import module: %1 (%2)").arg(name).arg(priv->formatExc())); priv->leave(); return false; } if (!use_api_10) { // PyOtherSide API 1.2 behavior: "import x.y.z" // If "x.y.z" is imported, we need to set "x" in globals if (name.indexOf('.') != -1) { name = name.mid(0, name.indexOf('.')); utf8bytes = name.toUtf8(); moduleName = utf8bytes.constData(); } } PyDict_SetItemString(priv->globals, moduleName, module); priv->leave(); return true; } void QPython::receive(QVariant variant) { QVariantList list = variant.toList(); QString event = list[0].toString(); if (handlers.contains(event)) { QJSValue callback = handlers[event]; QJSValueList args; for (int i=1; itoScriptValue(list[i]); } QJSValue result = callback.call(args); if (result.isError()) { // Ideally we would throw the error back to Python (so that the // pyotherside.send() method fails, as this is where the call // originated). We can't do this, because the pyotherside.send() // call is asynchronous (it returns before we call into JS), so do // the next best thing and report the error to our error handler in // QML instead. emit error("pyotherside.send() failed handler: " + result.property("fileName").toString() + ":" + result.property("lineNumber").toString() + ": " + result.toString()); } } else { // Default action emit received(variant); } } void QPython::setHandler(QString event, QJSValue callback) { if (!callback.isCallable() || callback.isNull() || callback.isUndefined()) { handlers.remove(event); } else { handlers[event] = callback; } } QVariant QPython::evaluate(QString expr) { priv->enter(); PyObject *o = priv->eval(expr); if (o == NULL) { emit error(QString("Cannot evaluate '%1' (%2)").arg(expr).arg(priv->formatExc())); priv->leave(); return QVariant(); } QVariant v = convertPyObjectToQVariant(o); Py_DECREF(o); priv->leave(); return v; } void QPython::call(QString func, QVariant args, QJSValue callback) { QJSValue *cb = 0; if (!callback.isNull() && !callback.isUndefined() && callback.isCallable()) { cb = new QJSValue(callback); } emit process(func, args, cb); } QVariant QPython::call_sync(QString func, QVariant args) { priv->enter(); PyObject *callable = priv->eval(func); if (callable == NULL) { emit error(QString("Function not found: '%1' (%2)").arg(func).arg(priv->formatExc())); priv->leave(); return QVariant(); } if (PyCallable_Check(callable)) { QVariant v; PyObject *argl = convertQVariantToPyObject(args); if (!PyList_Check(argl)) { Py_DECREF(callable); Py_XDECREF(argl); emit error(QString("Not a parameter list in call to %1: %2") .arg(func).arg(args.toString())); priv->leave(); return QVariant(); } PyObject *argt = PyList_AsTuple(argl); Py_DECREF(argl); PyObject *o = PyObject_Call(callable, argt, NULL); Py_DECREF(argt); if (o == NULL) { emit error(QString("Return value of PyObject call is NULL: %1").arg(priv->formatExc())); } else { v = convertPyObjectToQVariant(o); Py_DECREF(o); } Py_DECREF(callable); priv->leave(); return v; } emit error(QString("Not a callable: %1").arg(func)); Py_DECREF(callable); priv->leave(); return QVariant(); } void QPython::finished(QVariant result, QJSValue *callback) { QJSValueList args; QJSValue v = callback->engine()->toScriptValue(result); args << v; QJSValue callbackResult = callback->call(args); if (SINCE_API_VERSION(1, 2)) { if (callbackResult.isError()) { emit error(callbackResult.property("fileName").toString() + ":" + callbackResult.property("lineNumber").toString() + ": " + callbackResult.toString()); } } delete callback; } void QPython::imported(bool result, QJSValue *callback) { QJSValueList args; QJSValue v = callback->engine()->toScriptValue(QVariant(result)); args << v; QJSValue callbackResult = callback->call(args); if (SINCE_API_VERSION(1, 2)) { if (callbackResult.isError()) { emit error(callbackResult.property("fileName").toString() + ":" + callbackResult.property("lineNumber").toString() + ": " + callbackResult.toString()); } } delete callback; } QString QPython::pluginVersion() { return QString(PYOTHERSIDE_VERSION); } QString QPython::pythonVersion() { return QString(PY_VERSION); } pyotherside-1.2.0/src/qpython.h000066400000000000000000000240171230020142200165010ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, 2014, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #ifndef PYOTHERSIDE_QPYTHON_H #define PYOTHERSIDE_QPYTHON_H #include #include #include #include #include #include #include class QPython; class QPythonPriv; class QPythonWorker; class QPython : public QObject { Q_OBJECT public: /** * \brief Create a new Python instance * * A new Python instance can be created in QML as follows: * * \code * import io.thp.pyotherside 1.0 * * Python { * id: py * } * \endcode * * \arg parent The parent QObject * \arg api_version_major Major API version (used internally) * \arg api_version_minor Minor API version (used internally) **/ QPython(QObject *parent, int api_version_major, int api_version_minor); virtual ~QPython(); /** * \brief Add a local filesystem path to Python's sys.path. * * The import path will be added synchronously. After the call * returns, the new import path will already be in effect. * * \arg path Directory that will be added to the search path **/ Q_INVOKABLE void addImportPath(QString path); /** * \brief Add a handler for events sent with \c pyotherside.send() * * The provided \a callback will be called whenever the first argument * to \c pyotherside.send() matches the \a event argument. * * For example, when the Python code contains a call like this: * * \code * import pyotherside * * pyotherside.send('new-entries', 100, 123) * \endcode * * The event can be captured in QML like this: * * \code * Python { * id: py * * Component.onCompleted: { * py.setHandler('new-entries', function(first, last) { * console.log('New entries from ' + first + ' to ' + last); * }); * } * } * \endcode * * All events for which no handler was set will be sent to the * received() signal. * * If a handler for that specific \a event already exist, the * new \a callback will replace the old one. * * \arg event The event name (first argument to pyotherside.send()) * \arg callback The JS callback to be called when the event occurs **/ Q_INVOKABLE void setHandler(QString event, QJSValue callback); /** * \brief Evaluate a Python expression synchronously * * Evaluate the string \a expr as Python expression and return the * result as Qt data type. The evaluation happens synchronously. * * \code * Python { * Component.onCompleted: { * console.log('Squares: ' + evaluate('[x for x in range(10)]')); * } * } * \endcode * * \arg expr Python expression to be evaluated * \result The result of the expression as Qt data type **/ Q_INVOKABLE QVariant evaluate(QString expr); /** * \brief Asynchronously import a Python module * * Imports a Python module by name asynchronously. The function * will return immediately. If the module is successfully imported, * the supplied \a callback will be called. Only then will the * imported module be available: * * \code * Python { * Component.onCompleted: { * importModule('os', function() { * // You can use the "os" module here * }); * } * } * \endcode * * If an error occurs while trying to import, the signal error() * will be emitted with detailed information about the error. * * \arg name The name of the Python module to import * \arg callback The JS callback to be called when the module is * successfully imported **/ Q_INVOKABLE void importModule(QString name, QJSValue callback); /** * \brief Synchronously import a Python module * * Imports a Python module by name synchronously. This function * will block until the module is imported and available. In * general, you should use importModule() instead of this function * to avoid blocking the QML UI thread. Example use: * * \code * Python { * Component.onCompleted: { * var success = importModule_sync('os'); * if (success) { * // You can use the "os" module here * } * } * } * \endcode * * \arg name The name of the Python module to import * \result \c true if the import was successful, \c false otherwise **/ Q_INVOKABLE bool importModule_sync(QString name); /** * \brief Asynchronously call a Python function * * Call a Python function asynchronously and call back into QML * when the result is available: * * \code * Python { * Component.onCompleted: { * importModule('os', function() { * call('os.getcwd', [], function (result) { * console.log('Working directory: ' + result); * call('os.chdir', ['/'], function (result) { * console.log('Working directory changed.'); * });); * }); * }); * } * } * \endcode * * \arg func The Python function to call * \arg args A list of arguments, or \c [] for no arguments * \arg callback A callback that receives the function call result **/ Q_INVOKABLE void call(QString func, QVariant args=QVariantList(), QJSValue callback=QJSValue()); /** * \brief Synchronously call a Python function * * This is the synchronous variant of call(). In general, you should * use call() instead of this function to avoid blocking the QML UI * thread. Example usage: * * \code * Python { * Component.onCompleted: { * importModule_sync('os'); * var cwd = call_sync('os.getcwd', []); * console.log('Working directory: ' + cwd); * call_sync('os.chdir', ['/']); * console.log('Working directory changed.'); * } * } * \endcode * * \arg func The Python function to call * \arg args A list of arguments, or \c [] for no arguments * \result The return value of the Python call as Qt data type **/ Q_INVOKABLE QVariant call_sync(QString func, QVariant args=QVariantList()); /** * \brief Get the PyOtherSide version * * \result The running version of PyOtherSide **/ Q_INVOKABLE QString pluginVersion(); /** * \brief Get the Python versino * * \result The running versino of Python **/ Q_INVOKABLE QString pythonVersion(); signals: /** * \brief Default event handler for \c pyotherside.send() * * This signal will be emitted for all events from Python for * which no specific handler (see setHandler()) is configured. * * \arg data The argument list of \c pyotherside.send() **/ void received(QVariant data); /** * \brief Error handler for errors from Python * * This signal will be emitted when an error happens in the * Python interpreter that isn't caught. For example, errors * in evaluate(), importModule() and call() will be reported * with this signal. * * \arg traceback A string describing the error **/ void error(QString traceback); /* For internal use only */ void process(QString func, QVariant args, QJSValue *callback); void import(QString name, QJSValue *callback); private slots: void receive(QVariant data); void finished(QVariant result, QJSValue *callback); void imported(bool result, QJSValue *callback); private: static QPythonPriv *priv; QPythonWorker *worker; QThread thread; QMap handlers; int api_version_major; int api_version_minor; }; class QPython10 : public QPython { Q_OBJECT public: QPython10(QObject *parent=0) : QPython(parent, 1, 0) { } }; class QPython12 : public QPython { Q_OBJECT public: QPython12(QObject *parent=0) : QPython(parent, 1, 2) { } }; #endif /* PYOTHERSIDE_QPYTHON_H */ pyotherside-1.2.0/src/qpython_imageprovider.cpp000066400000000000000000000140161230020142200217470ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, 2014, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #include "qpython_priv.h" #include "qpython_imageprovider.h" #include QPythonImageProvider::QPythonImageProvider() : QQuickImageProvider(QQmlImageProviderBase::Image) { } QPythonImageProvider::~QPythonImageProvider() { } static void cleanup_python_qimage(void *data) { QPythonPriv *priv = QPythonPriv::instance(); priv->enter(); Py_XDECREF(static_cast(data)); priv->leave(); } QImage QPythonImageProvider::requestImage(const QString &id, QSize *size, const QSize &requestedSize) { QImage img; // Image data (and metadata) returned from Python PyObject *pixels = NULL; unsigned int width = 0, height = 0; int format = 0; // For counting the number of required bytes int bitsPerPixel = 0; size_t requiredBytes = 0; size_t actualBytes = 0; QPythonPriv *priv = QPythonPriv::instance(); if (!priv) { qWarning() << "Python component not instantiated yet"; return QImage(); } if (!priv->image_provider) { qWarning() << "No image provider set in Python code"; return QImage(); } QByteArray id_utf8 = id.toUtf8(); // Image provider implementation in Python: // // import pyotherside // // def image_provider(image_id, requested_size): // if requested_size == (-1, -1): // requested_size = 100, 200 # some sane default size // width, height = requested_size // pixels = ... // format = pyotherside.format_argb32 # or some other format // return (bytearray(pixels), (width, height), format) // // pyotherside.set_image_provider(image_provider) priv->enter(); PyObject *args = Py_BuildValue("(N(ii))", PyUnicode_FromString(id_utf8.constData()), requestedSize.width(), requestedSize.height()); PyObject *result = PyObject_Call(priv->image_provider, args, NULL); Py_DECREF(args); if (result == NULL) { qDebug() << "Error while calling the image provider"; PyErr_Print(); goto cleanup; } if (!PyArg_ParseTuple(result, "O(ii)i", &pixels, &width, &height, &format)) { PyErr_Clear(); qDebug() << "Image provider must return (pixels, (width, height), format)"; goto cleanup; } if (!PyByteArray_Check(pixels)) { qDebug() << "Image data must be a Python bytearray()"; goto cleanup; } switch (format) { case -1: /* pyotherside.format_data */ break; case QImage::Format_Mono: case QImage::Format_MonoLSB: bitsPerPixel = 1; break; case QImage::Format_RGB32: case QImage::Format_ARGB32: bitsPerPixel = 32; break; case QImage::Format_RGB16: case QImage::Format_RGB555: case QImage::Format_RGB444: bitsPerPixel = 16; break; case QImage::Format_RGB666: case QImage::Format_RGB888: bitsPerPixel = 24; break; default: qDebug() << "Invalid format:" << format; goto cleanup; } requiredBytes = (bitsPerPixel * width * height + 7) / 8; actualBytes = PyByteArray_Size(pixels); // QImage requires scanlines to be 32-bit aligned. Scanlines from Python // are considered to be tightly packed, we have to check for alignment. // While we could re-pack the data to be aligned, we don't want to do that // for performance reasons. // If we're using 32-bit data (e.g. ARGB32), it will always be aligned. if (format != -1 && bitsPerPixel != 32) { if ((bitsPerPixel * width) % 32 != 0) { // If actualBytes > requiredBytes, we can check if there are enough // bytes to consider the data 32-bit aligned (from Python) and avoid // the error (scanlines must be padded to multiples of 4 bytes) if ((((width * bitsPerPixel / 8 + 3) / 4) * 4 * height) == actualBytes) { qDebug() << "Assuming 32-bit aligned scanlines from Python"; } else { qDebug() << "Each scanline of data must be 32-bit aligned"; goto cleanup; } } } if (format != -1 && requiredBytes > actualBytes) { qDebug() << "Format" << (enum QImage::Format)format << "at size" << QSize(width, height) << "requires at least" << requiredBytes << "bytes of image data, got only" << actualBytes << "bytes"; goto cleanup; } if (format == -1) { // Pixel data is actually encoded image data that we need to decode img.loadFromData((const unsigned char*)PyByteArray_AsString(pixels), PyByteArray_Size(pixels)); } else { // Need to keep a reference to the byte array object, as it contains // the backing store data for the QImage. // Will be decref'd by cleanup_python_qimage once the QImage is gone. Py_INCREF(pixels); img = QImage((const unsigned char *)PyByteArray_AsString(pixels), width, height, (enum QImage::Format)format, cleanup_python_qimage, pixels); } cleanup: Py_XDECREF(result); priv->leave(); *size = img.size(); return img; } pyotherside-1.2.0/src/qpython_imageprovider.h000066400000000000000000000023501230020142200214120ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, 2014, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #ifndef PYOTHERSIDE_QPYTHON_IMAGEPROVIDER_H #define PYOTHERSIDE_QPYTHON_IMAGEPROVIDER_H #include class QPythonImageProvider : public QQuickImageProvider { public: QPythonImageProvider(); virtual ~QPythonImageProvider(); virtual QImage requestImage(const QString &id, QSize *size, const QSize &requestedSize); }; #endif /* PYOTHERSIDE_QPYTHON_IMAGEPROVIDER_H */ pyotherside-1.2.0/src/qpython_priv.cpp000066400000000000000000000155701230020142200201000ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, 2014, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #include "qml_python_bridge.h" #include "qpython_priv.h" #include #include static QPythonPriv *priv = NULL; PyObject * pyotherside_send(PyObject *self, PyObject *args) { priv->receiveObject(args); Py_RETURN_NONE; } PyObject * pyotherside_atexit(PyObject *self, PyObject *o) { if (priv->atexit_callback != NULL) { Py_DECREF(priv->atexit_callback); } Py_INCREF(o); priv->atexit_callback = o; Py_RETURN_NONE; } PyObject * pyotherside_set_image_provider(PyObject *self, PyObject *o) { if (priv->image_provider != NULL) { Py_DECREF(priv->image_provider); } Py_INCREF(o); priv->image_provider = o; Py_RETURN_NONE; } static PyMethodDef PyOtherSideMethods[] = { {"send", pyotherside_send, METH_VARARGS, "Send data to Qt."}, {"atexit", pyotherside_atexit, METH_O, "Function to call on shutdown."}, {"set_image_provider", pyotherside_set_image_provider, METH_O, "Set the QML image provider."}, {NULL, NULL, 0, NULL}, }; #ifdef PY3K static struct PyModuleDef PyOtherSideModule = { PyModuleDef_HEAD_INIT, "pyotherside", /* name of module */ NULL, -1, PyOtherSideMethods, }; PyMODINIT_FUNC PyOtherSide_init() { PyObject *pyotherside = PyModule_Create(&PyOtherSideModule); // Format constants for the image provider return value format // see http://qt-project.org/doc/qt-5.1/qtgui/qimage.html#Format-enum PyModule_AddIntConstant(pyotherside, "format_mono", QImage::Format_Mono); PyModule_AddIntConstant(pyotherside, "format_mono_lsb", QImage::Format_MonoLSB); PyModule_AddIntConstant(pyotherside, "format_rgb32", QImage::Format_RGB32); PyModule_AddIntConstant(pyotherside, "format_argb32", QImage::Format_ARGB32); PyModule_AddIntConstant(pyotherside, "format_rgb16", QImage::Format_RGB16); PyModule_AddIntConstant(pyotherside, "format_rgb666", QImage::Format_RGB666); PyModule_AddIntConstant(pyotherside, "format_rgb555", QImage::Format_RGB555); PyModule_AddIntConstant(pyotherside, "format_rgb888", QImage::Format_RGB888); PyModule_AddIntConstant(pyotherside, "format_rgb444", QImage::Format_RGB444); // Custom constant - pixels are to be interpreted as encoded image file data PyModule_AddIntConstant(pyotherside, "format_data", -1); return pyotherside; } #endif QPythonPriv::QPythonPriv() : locals(NULL) , globals(NULL) , state(NULL) , atexit_callback(NULL) , image_provider(NULL) , traceback_mod(NULL) , mutex() { #ifdef PY3K PyImport_AppendInittab("pyotherside", PyOtherSide_init); #endif Py_Initialize(); PyEval_InitThreads(); locals = PyDict_New(); assert(locals != NULL); globals = PyDict_New(); assert(globals != NULL); traceback_mod = PyImport_ImportModule("traceback"); assert(traceback_mod != NULL); #ifndef PY3K Py_InitModule("pyotherside", PyOtherSideMethods); #endif priv = this; if (PyDict_GetItemString(globals, "__builtins__") == NULL) { PyDict_SetItemString(globals, "__builtins__", PyEval_GetBuiltins()); } // Need to lock mutex here, as it will always be unlocked // by leave(). If we don't do that, it will be unlocked // once too often resulting in undefined behavior. mutex.lock(); leave(); } QPythonPriv::~QPythonPriv() { enter(); Py_DECREF(traceback_mod); Py_DECREF(globals); Py_DECREF(locals); Py_Finalize(); } void QPythonPriv::enter() { mutex.lock(); assert(state != NULL); PyEval_RestoreThread(state); state = NULL; } void QPythonPriv::leave() { assert(state == NULL); state = PyEval_SaveThread(); mutex.unlock(); } void QPythonPriv::receiveObject(PyObject *o) { emit receive(convertPyObjectToQVariant(o)); } QString QPythonPriv::formatExc() { PyObject *type = NULL; PyObject *value = NULL; PyObject *traceback = NULL; PyObject *list = NULL; PyObject *n = NULL; PyObject *s = NULL; PyErr_Fetch(&type, &value, &traceback); PyErr_NormalizeException(&type, &value, &traceback); QString message; QVariant v; if (type == NULL && value == NULL && traceback == NULL) { // No exception thrown? goto cleanup; } if (value != NULL) { // We can at least format the exception as string message = convertPyObjectToQVariant(PyObject_Str(value)).toString(); } if (type == NULL || traceback == NULL) { // Cannot get a traceback for this exception goto cleanup; } list = PyObject_CallMethod(traceback_mod, "format_exception", "OOO", type, value, traceback); if (list == NULL) { // Could not format exception, fall back to original message PyErr_Print(); goto cleanup; } n = PyUnicode_FromString("\n"); if (n == NULL) { PyErr_Print(); goto cleanup; } s = PyUnicode_Join(n, list); if (s == NULL) { PyErr_Print(); goto cleanup; } v = convertPyObjectToQVariant(s); if (v.isValid()) { message = v.toString(); } cleanup: Py_XDECREF(s); Py_XDECREF(n); Py_XDECREF(list); Py_XDECREF(type); Py_XDECREF(value); Py_XDECREF(traceback); qDebug() << QString("PyOtherSide error: %1").arg(message); return message; } PyObject * QPythonPriv::eval(QString expr) { QByteArray utf8bytes = expr.toUtf8(); PyObject *result = PyRun_String(utf8bytes.constData(), Py_eval_input, globals, locals); return result; } void QPythonPriv::closing() { if (!priv) { return; } priv->enter(); if (priv->atexit_callback != NULL) { PyObject *args = PyTuple_New(0); PyObject *result = PyObject_Call(priv->atexit_callback, args, NULL); Py_DECREF(args); Py_XDECREF(result); Py_DECREF(priv->atexit_callback); priv->atexit_callback = NULL; } if (priv->image_provider != NULL) { Py_DECREF(priv->image_provider); priv->image_provider = NULL; } priv->leave(); } QPythonPriv * QPythonPriv::instance() { return priv; } pyotherside-1.2.0/src/qpython_priv.h000066400000000000000000000032031230020142200175330ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, 2014, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #ifndef PYOTHERSIDE_QPYTHON_PRIV_H #define PYOTHERSIDE_QPYTHON_PRIV_H #include "Python.h" #include #include #include #include class QPythonPriv : public QObject { Q_OBJECT public: QPythonPriv(); ~QPythonPriv(); PyObject *eval(QString expr); void enter(); void leave(); void receiveObject(PyObject *o); static void closing(); static QPythonPriv *instance(); QString formatExc(); PyObject *locals; PyObject *globals; PyThreadState *state; PyObject *atexit_callback; PyObject *image_provider; PyObject *traceback_mod; QMutex mutex; signals: void receive(QVariant data); }; #endif /* PYOTHERSIDE_QPYTHON_PRIV_H */ pyotherside-1.2.0/src/qpython_worker.cpp000066400000000000000000000026201230020142200204210ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, 2014, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #include "qpython.h" #include "qpython_worker.h" QPythonWorker::QPythonWorker(QPython *qpython) : QObject() , qpython(qpython) { } QPythonWorker::~QPythonWorker() { } void QPythonWorker::process(QString func, QVariant args, QJSValue *callback) { QVariant result = qpython->call_sync(func, args); if (callback) { emit finished(result, callback); } } void QPythonWorker::import(QString name, QJSValue *callback) { bool result = qpython->importModule_sync(name); if (callback) { emit imported(result, callback); } } pyotherside-1.2.0/src/qpython_worker.h000066400000000000000000000027601230020142200200730ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, 2014, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #ifndef PYOTHERSIDE_QPYTHON_WORKER_H #define PYOTHERSIDE_QPYTHON_WORKER_H #include #include #include #include class QPython; class QPythonWorker : public QObject { Q_OBJECT public: QPythonWorker(QPython *qpython); ~QPythonWorker(); public slots: void process(QString func, QVariant args, QJSValue *callback); void import(QString func, QJSValue *callback); signals: void finished(QVariant result, QJSValue *callback); void imported(bool result, QJSValue *callback); private: QPython *qpython; }; #endif /* PYOTHERSIDE_QPYTHON_WORKER_H */ pyotherside-1.2.0/src/qvariant_converter.h000066400000000000000000000146501230020142200207150ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, 2014, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #ifndef PYOTHERSIDE_QVARIANT_CONVERTER_H #define PYOTHERSIDE_QVARIANT_CONVERTER_H #include "converter.h" #include #include #include #include #include class QVariantListBuilder : public ListBuilder { public: QVariantListBuilder() : list() {} virtual ~QVariantListBuilder() {} virtual void append(QVariant v) { list << v; } virtual QVariant value() { return QVariant(list); } private: QVariantList list; }; class QVariantDictBuilder : public DictBuilder { public: QVariantDictBuilder() : dict() {} virtual ~QVariantDictBuilder() {} virtual void set(QVariant key, QVariant value) { dict[key.toString()] = value; } virtual QVariant value() { return QVariant(dict); } private: QMap dict; }; class QVariantListIterator : public ListIterator { public: QVariantListIterator(QVariant &v) : list(v.toList()), pos(0) {} virtual ~QVariantListIterator() {} virtual int count() { return list.size(); } virtual bool next(QVariant *v) { if (pos == count()) { return false; } *v = list[pos]; pos++; return true; } private: QList list; int pos; }; class QVariantDictIterator : public DictIterator { public: QVariantDictIterator(QVariant &v) : dict(v.toMap()), keys(dict.keys()), pos(0) {} virtual ~QVariantDictIterator() {} virtual bool next(QVariant *key, QVariant *value) { if (pos == keys.size()) { return false; } *key = keys[pos]; *value = dict[keys[pos]]; pos++; return true; } private: QMap dict; QList keys; int pos; }; class QVariantConverter : public Converter { public: QVariantConverter() : stringstorage() {} virtual ~QVariantConverter() {} virtual enum Type type(QVariant &v) { QVariant::Type t = v.type(); switch (t) { case QVariant::Bool: return BOOLEAN; case QVariant::Int: case QVariant::LongLong: case QVariant::UInt: case QVariant::ULongLong: return INTEGER; case QVariant::Double: return FLOATING; case QVariant::String: return STRING; case QVariant::Date: return DATE; case QVariant::Time: return TIME; case QVariant::DateTime: return DATETIME; case QVariant::List: return LIST; case QVariant::Map: return DICT; case QVariant::Invalid: return NONE; default: qDebug() << "Cannot convert:" << v; return NONE; } } virtual ListIterator *list(QVariant &v) { return new QVariantListIterator(v); } virtual DictIterator *dict(QVariant &v) { return new QVariantDictIterator(v); } virtual long long integer(QVariant &v) { return v.toLongLong(); } virtual double floating(QVariant &v) { return v.toDouble(); } virtual bool boolean(QVariant &v) { return v.toBool(); } virtual ConverterDate date(QVariant &v) { QDate d = v.toDate(); return ConverterDate(d.year(), d.month(), d.day()); } virtual ConverterTime time(QVariant &v) { QTime t = v.toTime(); return ConverterTime(t.hour(), t.minute(), t.second(), t.msec()); } virtual ConverterDateTime dateTime(QVariant &v) { QDateTime dt = v.toDateTime(); QDate d = dt.date(); QTime t = dt.time(); return ConverterDateTime(d.year(), d.month(), d.day(), t.hour(), t.minute(), t.second(), t.msec()); } virtual const char *string(QVariant &v) { stringstorage = v.toString().toUtf8(); return stringstorage.constData(); } virtual ListBuilder *newList() { return new QVariantListBuilder; } virtual DictBuilder *newDict() { return new QVariantDictBuilder; } virtual QVariant fromInteger(long long v) { return QVariant(v); } virtual QVariant fromFloating(double v) { return QVariant(v); } virtual QVariant fromBoolean(bool v) { return QVariant(v); } virtual QVariant fromString(const char *v) { return QVariant(QString::fromUtf8(v)); } virtual QVariant fromDate(ConverterDate v) { return QVariant(QDate(v.y, v.m, v.d)); } virtual QVariant fromTime(ConverterTime v) { return QVariant(QTime(v.h, v.m, v.s, v.ms)); } virtual QVariant fromDateTime(ConverterDateTime v) { QDate d(v.y, v.m, v.d); QTime t(v.time.h, v.time.m, v.time.s, v.time.ms); return QVariant(QDateTime(d, t)); } virtual QVariant none() { return QVariant(); }; private: QByteArray stringstorage; }; #endif /* PYOTHERSIDE_QVARIANT_CONVERTER_H */ pyotherside-1.2.0/src/src.pro000066400000000000000000000020201230020142200161250ustar00rootroot00000000000000TARGET = pyothersideplugin include(../pyotherside.pri) DEFINES += PYOTHERSIDE_VERSION=\\\"$${VERSION}\\\" PLUGIN_IMPORT_PATH = io/thp/pyotherside TEMPLATE = lib CONFIG += qt plugin QT += qml quick target.path = $$[QT_INSTALL_QML]/$$PLUGIN_IMPORT_PATH INSTALLS += target qmldir.files += $$_PRO_FILE_PWD_/qmldir qmldir.path += $$target.path INSTALLS += qmldir DEPENDPATH += . INCLUDEPATH += . # PyOtherSide QML Plugin SOURCES += pyotherside_plugin.cpp HEADERS += pyotherside_plugin.h # QML Image Provider SOURCES += qpython_imageprovider.cpp HEADERS += qpython_imageprovider.h # Python QML Object SOURCES += qpython.cpp HEADERS += qpython.h SOURCES += qpython_worker.cpp HEADERS += qpython_worker.h SOURCES += qpython_priv.cpp HEADERS += qpython_priv.h # Globally Load Python hack SOURCES += global_libpython_loader.cpp HEADERS += global_libpython_loader.h # Type System Conversion Logic HEADERS += converter.h HEADERS += qvariant_converter.h HEADERS += pyobject_converter.h HEADERS += qml_python_bridge.h include(../python.pri) pyotherside-1.2.0/tests/000077500000000000000000000000001230020142200151755ustar00rootroot00000000000000pyotherside-1.2.0/tests/test_callback_errors/000077500000000000000000000000001230020142200213645ustar00rootroot00000000000000pyotherside-1.2.0/tests/test_callback_errors/test_callback_errors.qml000066400000000000000000000021171230020142200262670ustar00rootroot00000000000000import QtQuick 2.0 import io.thp.pyotherside 1.2 // Test if PyOtherSide correctly reports JS errors happening in callbacks // in signal error(string traceback) for both imports and function calls. Python { property var tests: ([]) function test_next() { if (tests.length) { tests.pop()(); } else { console.log('Tests done'); Qt.quit(); } } Component.onCompleted: { tests.unshift(function () { console.log('Expecting ReferenceError for "invalid" on import'); importModule('os', function (success) { invalid; }); }); tests.unshift(function() { console.log('Expecting TypeError for "lock" property'); call('os.getcwd', [], function (result) { console.lock(result); }); }); test_next(); } onError: { // Remove full path to .qml file var msg = traceback.replace(Qt.resolvedUrl('.'), ''); console.log('Got error: ' + msg); test_next(); } } pyotherside-1.2.0/tests/test_callback_errors/test_callback_errors.txt000066400000000000000000000004421230020142200263140ustar00rootroot00000000000000Expecting ReferenceError for "invalid" on import Got error: test_callback_errors.qml:23: ReferenceError: invalid is not defined Expecting TypeError for "lock" property Got error: test_callback_errors.qml:29: TypeError: Property 'lock' of object [object Object] is not a function Tests done pyotherside-1.2.0/tests/test_callparam/000077500000000000000000000000001230020142200201705ustar00rootroot00000000000000pyotherside-1.2.0/tests/test_callparam/test_callparam.qml000066400000000000000000000012661230020142200237030ustar00rootroot00000000000000import QtQuick 2.0 import io.thp.pyotherside 1.0 Rectangle { id: page width: 300 height: 300 Python { Component.onCompleted: { // We use call_sync() instead of call() in order // to guarantee the right ordering of Python's output // and the output of the JS engine for the error // This should fail with an error: // "Not a parameter list in call to print: 123" call_sync('print', 123); // This should work and print "123" on the console call_sync('print', [123]); } onError: { console.log('Received error: ' + traceback); } } } pyotherside-1.2.0/tests/test_datetime/000077500000000000000000000000001230020142200200305ustar00rootroot00000000000000pyotherside-1.2.0/tests/test_datetime/test_datetime.py000066400000000000000000000012371230020142200232400ustar00rootroot00000000000000import datetime def submit_datetime(dt): assert dt is not None print('Python got datetime:', dt) return dt def submit_date(date): assert date is not None print('Python got date:', date) return date def submit_time(time): assert time is not None print('Python got time:', time) return time def get_datetime_value(): v = datetime.datetime.now() print('Python returning datetime:', v) return v def get_time_value(): v = datetime.datetime.now().time() print('Python returning time:', v) return v def get_date_value(): v = datetime.datetime.now().date() print('Python returning date:', v) return v pyotherside-1.2.0/tests/test_datetime/test_datetime.qml000066400000000000000000000063331230020142200234030ustar00rootroot00000000000000import QtQuick 2.0 import io.thp.pyotherside 1.2 Python { property var tests: ([]) property var someJsDate: (new Date()) property date someDate: '2014-02-12' // XXX: Not possible, see https://qt-project.org/forums/viewthread/8935 // property time someTime: '11:22:33' Component.onCompleted: { addImportPath(Qt.resolvedUrl('.')); importModule('test_datetime', function () { var someTime = call_sync('test_datetime.get_time_value', []); // Note: Qt doesn't support microseconds, so these are trimmed // to milliseconds during conversion between data types console.log('Got time value from Python: ' + someTime); var someDateFromPython = call_sync('test_datetime.get_date_value', []); console.log('Got date value from Python: ' + someDateFromPython); var someDateTimeFromPython = call_sync('test_datetime.get_datetime_value', []); console.log('Got datetime value from Python: ' + someDateTimeFromPython); function test_next() { console.log('================================'); if (tests.length == 0) { console.log('Tests completed'); Qt.quit(); } else { var test = tests.pop(); console.log('-> ' + test.name); call(test.func, [test.expected], function (reply) { if (reply === undefined || reply === null) { error('Got undefined or null'); return; } console.log('Got: ' + reply); console.log('Expected: ' + test.expected); if (reply.toString() !== test.expected.toString()) { error('Results do not match'); return; } test_next(); }); } } tests.unshift({ name: 'Submit back and forth date (QML date property)', func: 'test_datetime.submit_date', expected: someDate }); tests.unshift({ name: 'Submit back and forth time (QML time from Python)', func: 'test_datetime.submit_time', expected: someTime }); tests.unshift({ name: 'Submit back and forth datetime (JS "new Date()")', func: 'test_datetime.submit_datetime', expected: someJsDate }); tests.unshift({ name: 'Submit back and forth date (JS var from Python)', func: 'test_datetime.submit_date', expected: someDateFromPython }); tests.unshift({ name: 'Submit back and forth datetime (JS var from Python)', func: 'test_datetime.submit_datetime', expected: someDateTimeFromPython }); test_next(); }); } onError: { console.log('Error: ' + traceback); console.log('Tests failed'); Qt.quit(); } } pyotherside-1.2.0/tests/test_errors/000077500000000000000000000000001230020142200175505ustar00rootroot00000000000000pyotherside-1.2.0/tests/test_errors/README000066400000000000000000000003641230020142200204330ustar00rootroot00000000000000Test if JS errors from pyotherside.send() are propagated to the PyOtherSide error handler. Thanks to Osmo Salomaa for the original report and test case. ---- https://github.com/thp/pyotherside/issues/9 https://gist.github.com/otsaloma/8258322 pyotherside-1.2.0/tests/test_errors/test_errors.py000066400000000000000000000003001230020142200224660ustar00rootroot00000000000000import pyotherside import threading import time def run(): while True: pyotherside.send("test-errors") time.sleep(3) thread = threading.Thread(target=run) thread.start() pyotherside-1.2.0/tests/test_errors/test_errors.qml000066400000000000000000000015341230020142200226410ustar00rootroot00000000000000import QtQuick 2.0 import io.thp.pyotherside 1.0 Rectangle { id: page width: 300 height: 300 Component.onCompleted: { py.addImportPath(Qt.resolvedUrl('.').substr('file://'.length)); py.setHandler("test-errors", page.testErrors); py.importModule("test_errors", null); } Python { id: py onError: { console.log("PYTHON ERROR: " + traceback); msg.text += '\n' + traceback; } } Text { id: msg anchors { top: parent.top left: parent.left right: parent.right } text: "Testing (you should see errors appearing here)..." wrapMode: Text.Wrap } function testErrors() { console.log("starting"); page.nonexistentMethod(); console.log("finished"); } } pyotherside-1.2.0/tests/test_nested_import/000077500000000000000000000000001230020142200211105ustar00rootroot00000000000000pyotherside-1.2.0/tests/test_nested_import/README000066400000000000000000000002701230020142200217670ustar00rootroot00000000000000Test for importModule() with dots in the module name. Tests the (broken) behavior of QML API import 1.0, and the fixed 1.2 behavior. See: https://github.com/thp/pyotherside/issues/3 pyotherside-1.2.0/tests/test_nested_import/example_api10.qml000066400000000000000000000046531230020142200242600ustar00rootroot00000000000000import QtQuick 2.0 import io.thp.pyotherside 1.0 Python { Component.onCompleted: { addImportPath(Qt.resolvedUrl('.')); /** * Here, we test the broken behavior of the PyOtherSide 1.0 API * for imports with "." in the name: * 1. It uses PyImport_ImportModule() which does a "*"_import * 2. The variable in the globals dict that gets set is the full * module name (and not the module after the "." for * non-"*"-imports) including the dot, which is broken, anyway, as * there's not way to retrieve that name in normal Python syntax * (names cannot contain a "."), so for this test we use a dirty * way of accessing they key via the globals() dict (just for * testing - I hope nobody used that in old code, but we want to * have a stable API, so we will drag this behavior along with the * 1.0 API support - new code should definitely use the 1.2 API) **/ importModule('thp_io.pyotherside.nested', function () { console.log('"nested" imported successfully'); // In API version 1.0, we expect the import to have done a "*" // import, and to add insult to injury, we assign the module // name with a ".", which basically makes the import unaccessible // from normal Python code (the entry in the globals dict contains // a ".", which isn't a valid name in Python), so we access the // globals dictionary directly console.log('repr of the module: ' + evaluate('repr(globals()["thp_io.pyotherside.nested"])')); call('globals()["thp_io.pyotherside.nested"].info', [], function (result) { console.log('from nested.info(): ' + result); }); importModule('thp_io.pyotherside.nested.module', function () { console.log('"nested.module" imported successfully'); // Globals hack - see above call('globals()["thp_io.pyotherside.nested.module"].info', [], function (result) { console.log('from nested.module.info(): ' + result); // Globals hack again - see above console.log('nested.module.value: ' + evaluate('globals()["thp_io.pyotherside.nested.module"].value')); Qt.quit(); }); }); }); } } pyotherside-1.2.0/tests/test_nested_import/example_api12.qml000066400000000000000000000017551230020142200242620ustar00rootroot00000000000000import QtQuick 2.0 import io.thp.pyotherside 1.2 Python { Component.onCompleted: { addImportPath(Qt.resolvedUrl('.')); importModule('thp_io.pyotherside.nested', function () { console.log('"nested" imported successfully'); console.log('repr of the module: ' + evaluate('repr(thp_io.pyotherside.nested)')); call('thp_io.pyotherside.nested.info', [], function (result) { console.log('from nested.info(): ' + result); }); importModule('thp_io.pyotherside.nested.module', function () { console.log('"nested.module" imported successfully'); call('thp_io.pyotherside.nested.module.info', [], function (result) { console.log('from nested.module.info(): ' + result); console.log('nested.module.value: ' + evaluate('thp_io.pyotherside.nested.module.value')); Qt.quit(); }); }); }); } } pyotherside-1.2.0/tests/test_nested_import/thp_io/000077500000000000000000000000001230020142200223725ustar00rootroot00000000000000pyotherside-1.2.0/tests/test_nested_import/thp_io/__init__.py000066400000000000000000000000001230020142200244710ustar00rootroot00000000000000pyotherside-1.2.0/tests/test_nested_import/thp_io/pyotherside/000077500000000000000000000000001230020142200247315ustar00rootroot00000000000000pyotherside-1.2.0/tests/test_nested_import/thp_io/pyotherside/__init__.py000066400000000000000000000000001230020142200270300ustar00rootroot00000000000000pyotherside-1.2.0/tests/test_nested_import/thp_io/pyotherside/nested/000077500000000000000000000000001230020142200262135ustar00rootroot00000000000000pyotherside-1.2.0/tests/test_nested_import/thp_io/pyotherside/nested/__init__.py000066400000000000000000000000641230020142200303240ustar00rootroot00000000000000def info(): return 'This is the nested package' pyotherside-1.2.0/tests/test_nested_import/thp_io/pyotherside/nested/module.py000066400000000000000000000001071230020142200300500ustar00rootroot00000000000000def info(): return 'This is the nested.module module' value = 123 pyotherside-1.2.0/tests/tests.cpp000066400000000000000000000105521230020142200170460ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #include "pyobject_converter.h" #include "qvariant_converter.h" #include "qpython.h" #include "converter.h" #include "qml_python_bridge.h" #include "tests.h" TestPyOtherSide::TestPyOtherSide() : QObject() { } QTEST_MAIN(TestPyOtherSide) template void test_converter_for(Converter *conv) { V v, w, x; /* Convert from/to Integer */ v = conv->fromInteger(123); QVERIFY(conv->type(v) == Converter::INTEGER); QVERIFY(conv->integer(v) == 123); /* Convert from/to Float */ v = conv->fromFloating(42.23); QVERIFY(conv->type(v) == Converter::FLOATING); QVERIFY(conv->floating(v) == 42.23); /* Convert from/to Bool */ v = conv->fromBoolean(true); QVERIFY(conv->type(v) == Converter::BOOLEAN); QVERIFY(conv->boolean(v)); v = conv->fromBoolean(false); QVERIFY(conv->type(v) == Converter::BOOLEAN); QVERIFY(!conv->boolean(v)); /* Convert from/to String */ v = conv->fromString("Hello World"); QVERIFY(conv->type(v) == Converter::STRING); QVERIFY(strcmp(conv->string(v), "Hello World") == 0); /* Convert from/to List */ ListBuilder *builder = conv->newList(); v = conv->fromInteger(444); builder->append(v); v = conv->fromString("Hello"); builder->append(v); v = builder->value(); delete builder; ListIterator *iterator = conv->list(v); QVERIFY(iterator->count() == 2); QVERIFY(iterator->next(&w)); QVERIFY(conv->type(w) == Converter::INTEGER); QVERIFY(conv->integer(w) == 444); QVERIFY(iterator->next(&w)); QVERIFY(conv->type(w) == Converter::STRING); QVERIFY(strcmp(conv->string(w), "Hello") == 0); delete iterator; /* Convert from/to Dict */ DictBuilder *builder2 = conv->newDict(); v = conv->fromBoolean(true); builder2->set(conv->fromString("a"), v); v = builder2->value(); delete builder2; DictIterator *iterator2 = conv->dict(v); QVERIFY(iterator2->next(&w, &x)); QVERIFY(conv->type(w) == Converter::STRING); QVERIFY(strcmp(conv->string(w), "a") == 0); QVERIFY(conv->type(x) == Converter::BOOLEAN); QVERIFY(conv->boolean(x) == true); delete iterator2; delete conv; } void TestPyOtherSide::testQVariantConverter() { test_converter_for(new QVariantConverter); } void TestPyOtherSide::testPyObjectConverter() { test_converter_for(new PyObjectConverter); } void TestPyOtherSide::testConvertToPythonAndBack() { QVariantList l; l << "Hello" << 123 << 45.667 << true; QVariantList l2; l2 << "A" << QVariant() << "B" << 4711; l << QVariant(l2); QVariant v(l); PyObject *o = convertQVariantToPyObject(v); QVariant v2 = convertPyObjectToQVariant(o); QVERIFY(v == v2); } static void testEvaluateWith(QPython *py) { QVariant squares = py->evaluate("[x*x for x in range(10)]"); QVERIFY(squares.canConvert(QMetaType::QVariantList)); QVariantList squares_list = squares.toList(); QVERIFY(squares_list.size() == 10); QVERIFY(squares_list[0] == 0); QVERIFY(squares_list[1] == 1); QVERIFY(squares_list[2] == 4); QVERIFY(squares_list[3] == 9); QVERIFY(squares_list[4] == 16); QVERIFY(squares_list[5] == 25); QVERIFY(squares_list[6] == 36); QVERIFY(squares_list[7] == 49); QVERIFY(squares_list[8] == 64); QVERIFY(squares_list[9] == 81); } void TestPyOtherSide::testEvaluate() { // PyOtherSide API 1.0 QPython10 py10; testEvaluateWith(&py10); // PyOtherSide API 1.2 QPython12 py12; testEvaluateWith(&py12); } pyotherside-1.2.0/tests/tests.h000066400000000000000000000023601230020142200165110ustar00rootroot00000000000000 /** * PyOtherSide: Asynchronous Python 3 Bindings for Qt 5 * Copyright (c) 2011, 2013, Thomas Perl * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. **/ #ifndef PYOTHERSIDE_TESTS_H #define PYOTHERSIDE_TESTS_H #include #include #include class TestPyOtherSide : public QObject { Q_OBJECT public: TestPyOtherSide(); private slots: void testEvaluate(); void testQVariantConverter(); void testPyObjectConverter(); void testConvertToPythonAndBack(); }; #endif /* PYOTHERSIDE_TESTS_H */ pyotherside-1.2.0/tests/tests.pro000066400000000000000000000010341230020142200170570ustar00rootroot00000000000000QT += testlib qml CONFIG -= app_bundle include(../pyotherside.pri) DEFINES += PYOTHERSIDE_VERSION=\\\"$${VERSION}\\\" SOURCES += tests.cpp HEADERS += tests.h SOURCES += ../src/qpython.cpp SOURCES += ../src/qpython_worker.cpp SOURCES += ../src/qpython_priv.cpp HEADERS += ../src/qpython.h HEADERS += ../src/qpython_worker.h HEADERS += ../src/qpython_priv.h HEADERS += ../src/converter.h HEADERS += ../src/qvariant_converter.h HEADERS += ../src/pyobject_converter.h DEPENDPATH += . ../src INCLUDEPATH += . ../src include(../python.pri)