Merge pull request mcolella14#8 from mcolella14/playwright-support

Playwright support

Author: mcolella14

.gitignore

@@ -135,4 +135,6 @@ dmypy.json
 .pytype/
 
 # Cython debug symbols
-cython_debug/
+cython_debug/
+
+.vscode

MANIFEST.in

@@ -1 +1 @@
-include pyppeteer_ghost_cursor/js/*.js
+include python_ghost_cursor/js/*.js

README.md

@@ -1,18 +1,18 @@
-# Pyppeteer Ghost Cursor
-Python port of <a href="https://github.com/Xetera/ghost-cursor">Xetera/ghost-cursor</a>, for use with pyppeteer.
+# Python Ghost Cursor
+Python port of <a href="https://github.com/Xetera/ghost-cursor">Xetera/ghost-cursor</a>, for use with Pyppeteer and Playwright.
 
-> Generate realistic, human-like mouse movement data between coordinates or navigate between elements with puppeteer
+> Generate realistic, human-like mouse movement data between coordinates or navigate between elements with Pyppeteer/Playwright
 like the definitely-not-robot you are.
 
 ## Installation
-`pip install pyppeteer_ghost_cursor`
+`pip install python_ghost_cursor`
 
 ## Usage
 
 Generating movement data between 2 coordinates.
 
 ```python
-from pyppeteer_ghost_cursor import path
+from python_ghost_cursor import path
 
 start = {
     "x": 220,
@@ -36,11 +36,12 @@ route = path(start, end)
  # ]
 ```
 
-Usage with pyppeteer:
+Usage with Pyppeteer:
 
 ```python
-from pyppeteer_ghost_cursor import createCursor
+import asyncio
 import pyppeteer
+from python_ghost_cursor.pyppeteer import create_cursor
 
 async def main(url):
   selector = "#sign-up button"
@@ -51,8 +52,50 @@ async def main(url):
   await page.waitForSelector(selector)
   await cursor.click(selector)
 
+asyncio.run(main())
+
+```
+
+Usage with Playwright (async):
+
+```python
+import asyncio
+from playwright.async_api import async_playwright
+from python_ghost_cursor.playwright_async import create_cursor
+
+async def main():
+  async with async_playwright() as p:
+    selector = "#sign-up button"
+    browser = await p.chromium.launch(channel="chrome", headless=False)
+    page = await browser.new_page()
+    cursor = create_cursor(page)
+    await page.goto(url)
+    await page.wait_for_selector(selector)
+    await cursor.click(selector)
+
+asyncio.run(main())
+
 ```
 
+Usage with Playwright (sync):
+
+```python
+from playwright.sync_api import sync_playwright
+from python_ghost_cursor.playwright_sync import create_cursor
+
+def main():
+  sync with sync_playwright() as p:
+    selector = "#sign-up button"
+    browser = p.chromium.launch(channel="chrome", headless=False)
+    page = browser.new_page()
+    cursor = create_cursor(page)
+    page.goto(url)
+    page.wait_for_selector(selector)
+    cursor.click(selector)
+
+main()
+
+```
 ## More info
 The original repo gives <a href="https://github.com/Xetera/ghost-cursor#puppeteer-specific-behavior"> a description of some of the cool features</a>, along with <a href="https://github.com/Xetera/ghost-cursor#how-does-it-work">a good explanation of how it works.</a>