Metadata-Version: 1.2
Name: pyppeteer
Version: 0.0.7
Summary: Headless chrome/chromium automation library (unofficial port of puppeteer)
Home-page: https://github.com/miyakogi/pyppeteer
Author: Hiroyuki Takagi
Author-email: miyako.dev@gmail.com
License: MIT license
Description: 
        Pyppeteer
        =========
        
        
        .. image:: https://img.shields.io/pypi/v/pyppeteer.svg
           :target: https://pypi.python.org/pypi/pyppeteer
           :alt: PyPI
        
        
        .. image:: https://img.shields.io/pypi/pyversions/pyppeteer.svg
           :target: https://pypi.python.org/pypi/pyppeteer
           :alt: PyPI version
        
        
        .. image:: https://img.shields.io/badge/docs-latest-brightgreen.svg
           :target: https://miyakogi.github.io/pyppeteer
           :alt: Documentation
        
        
        .. image:: https://travis-ci.org/miyakogi/pyppeteer.svg?branch=master
           :target: https://travis-ci.org/miyakogi/pyppeteer
           :alt: Build Status
        
        
        .. image:: https://codecov.io/gh/miyakogi/pyppeteer/branch/master/graph/badge.svg
           :target: https://codecov.io/gh/miyakogi/pyppeteer
           :alt: codecov
        
        
        Unofficial Python port of
        `puppeteer <https://github.com/GoogleChrome/puppeteer>`_ JavaScript (headless)
        chrome/chromium browser automation library.
        
        
        * Free software: MIT license (including the work distributed under the Apache 2.0 license)
        * Documentation: https://miyakogi.github.io/pyppeteer
        
        WORK IN PROGRESS
        ----------------
        
        Currently not all features are tested.
        
        Installation
        ------------
        
        Pyppeteer requires python 3.6+.
        
        Install by pip from PyPI:
        
        .. code-block::
        
           pytyon3 -m pip install pyppeteer
        
        Or install latest version from github:
        
        .. code-block::
        
           python3 -m pip install -U git+https://github.com/miyakogi/pyppeteer.git@dev
        
        Usage
        -----
        
        Below code open web page and take a screenshot.
        
        .. code-block:: py
        
           import asyncio
           from pyppeteer.launcher import launch
        
           async def main():
               browser = launch()
               page = await browser.newPage()
               await page.goto('http://example.com')
               await page.screenshot({'path': 'example.png'})
               browser.close()
        
           asyncio.get_event_loop().run_until_complete(main())
        
        Pyppeteer has almost same API as puppeteer.
        More APIs are listed in the
        `document <https://miyakogi.github.io/pyppeteer/reference.html>`_.
        
        `Puppeteer's document <https://github.com/GoogleChrome/puppeteer/blob/master/docs/api.md#>`_
        is also useful for pyppeteer users.
        
        Differences between puppeteer and pyppeteer
        -------------------------------------------
        
        Pyppeteer is to be as similar as puppeteer, but some differences between python
        and JavaScript make it difficult.
        
        These are differences between puppeteer and pyppeteer.
        
        Keyword argument for options
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        Puppeteer uses object (dictionary in python) for passing options to functions/methods.
        Pyppeteer accepts both dictionary and keyword argument for options.
        
        Dictionary style option (similar to puppeteer):
        
        .. code-block:: python
        
           browser = launch({'headless': True})
        
        Keyword argument style option (more pythonic, isn't it?):
        
        .. code-block:: python
        
           browser = launch(headless=True)
        
        Element selector method name (\ ``$`` -> ``querySelector``\ )
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        In python, ``$`` is not usable for method name.
        So pyppeteer uses ``Page.querySelector()`` instead of ``Page.$()``\ , and
        ``ElementHandle.querySelector()`` instead of ``ElementHandle.$()``.
        Pyppeteer has shorthand of this method, ``Page.J()`` and ``ElementHandle.J()``.
        
        Argument of ``Page.evaluate()`` / ``ElementHandle.evaluate()``
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        Puppeteer's version of ``evaluate()`` takes JavaScript raw function, but
        pyppeteer takes string of JavaScript function.
        
        Example to get element's inner text:
        
        .. code-block:: python
        
           element = await page.querySelector('h1')
           title = await element.evaluate('(element) => element.textContent')
        
        Credits
        -------
        
        This package was created with Cookiecutter\ * and the ``audreyr/cookiecutter-pypackage``\ * project template.
        
        .. _Cookiecutter: https://github.com/audreyr/cookiecutter
        
        .. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
        
Keywords: pyppeteer
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Requires-Python: >=3.5
