{
    "info": {
        "author": "Climente Alin",
        "author_email": "climente.alin@gmail.com",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "# pyrobogui\nWrapper around pyautogui - plus some new functions\n\nBuild on top of pyautogui but with some extra features: \n* timeouts, \n* setup, \n* aproximate match of images, \n* can be oriented to a screen coordonate automation or screen images automation or both\n\nUsage:<br>\n\n### Installation\n```\npip install pyrobogui\n\n```\n\n### Usage\n\n```\nfrom pyrobogui import robo\n\n# use the robo.method() to do what you need \n```\n\n\n### Mouse functions \n\n<br>\n\n```\nrobo.click(image=None, \n        x=None, \n        y=None, \n        offsetUp=None, \n        offsetDown=None, \n        offsetLeft=None, \n        offsetRight=None, \n        imageError=None, \n        timeout=1800, \n        full_match=False)\n```\n<br>\nDescribing the parameters:\n<br>\nPut either:\n<br>\n\n* image - path to image\n\nor\n\n* x - coodonate number\n* y - coordonate number\n\n\nAdditionally you have:\n\n* offsetUp - make action up from the center specified\n* offsetDown - make action down from the center specified\n* offsetLeft - make action down from the center specified\n* offsetRight - make action down from the center specified\n* imageError - raise error when this image is found in screen while waiting for the image needed\n* timeout - if the seconds specified passes without the image needed to appear then raise error\n\n\nThese parameters are available for the bellow functions too:\n\n* rightClick\n* doubleClick\n* hover\n* dragTo\n\nScroll functions\n\n```\nrobo.scrollUp(320)\n```\n\n<br>\nInsert a number for the functions bellow (scroll is noticeable for values over 120)\n\n* scrollUp\n* scrollDown\n* scrollLeft\n* scrollRight\n\n<br>\n\n### Keyboard functions\n\n```\nrobo.write (text, \n            image=None, \n            x=None, \n            y=None, \n            offsetUp=None, \n            offsetDown=None, \n            offsetLeft=None, \n            offsetRight=None, \n            imageError=None, \n            timeout=1800,\n            full_match=False)\n```\n<br>\nWhere:\n<br>\n\n* text - the string to write on the center of the image or the coordinates specified\n\n<br>\n\nFor a list of key names you can press check pyautogui documentation\n\n```\nrobo.press(keys) # Ex: robo.press(\"ctrl, c\")\n```\n* keys - the hotkeys you want to press, you can press max 3 keys (ex: robo.press(\"ctrl, alt, delete\"))  \n\n<br>\n\n### Additional functions\n\nStart setup to get the x,y coordinates and RGB color from the screen\nUseful when you want to start an automation process based on x,y coodinates(xy positions must be the same each time the process runs!)\n```\nrobo.setup()\n```\nWait a number of seconds equivalent to > time.sleep(x) \n\n```\nrobo.waitSeconds(5) #wait 5 seconds\n```\n\nGet coordinates of the image:\n\n```\nrobo.getImageLocation(image, full_match=False)\n```\n* image - image you need to find on screen\n* full_match - by default if will reduce the match if not found on screen down to 70%. If you set it to True it will try to find on screen an identical match size, colors etc.\n\n<br>\nGet to coordonates for the images needed.\n<br>\nYou can count images of the same type on the screen from UP to DOWN, and LEFT to RIGHT.\n\n```\nrobo.imageNeddle(image, imageNr='last') \n```\nUseful for casses where you have images that look the same on the screen but they are positioned in different places.\n<br>\n\nFor example let's say the you have a form with a lot of radio buttons and you want to click on the 5th radio button, you will do:\n\n```\nrobo.imageNeddle(\"./img/radio_button.png\", 5)\n```\nAlso you the options for imageNr parameter:\n* imageNr=5 - returns the specified counted image \n* imageNr='last'\n* imageNr='first'\n* imageNr='all' - returns a list of image locations\n\n\n### Wait functions\n\n```\nrobo.waitColorToAppear(xyrgb, imageError=None, timeout=1800) #ex:robo.waitColorToAppear(\"100, 200, 255, 255, 255\") \nrobo.waitColorToDisappear(xyrgb, imageError=None, timeout=1800)\n```\n* xyrgb - a string like this \"100, 200, 255, 255, 255\"\n* imageError - if this image apprears on screen the function will stop\n* timeout - wait for the image to appear a specific number of seconds if that seconds pass then raise error\n\n```\nrobo.waitImageToAppear(image, imageError=None, timeout=1800, full_match=False)\nrobo.waitImageToDisappear(image, imageError=None, timeout=1800, full_match=False)\n```\n* image - image you need on screen\n* imageError - stop if this image is found\n* timeout - stop if takes too long time\n* full_match - by default if will aproximate the image on screen by 70% if you change it to True it will match it 100%\n\nfull_match - not on all PC's the rgb colors, image size are the same, they may vary a little; that's way full_match is False by default\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/ClimenteA/pyrobogui",
        "keywords": "",
        "license": "MIT",
        "maintainer": "",
        "maintainer_email": "",
        "name": "pyrobogui",
        "package_url": "https://pypi.org/project/pyrobogui/",
        "platform": "",
        "project_url": "https://pypi.org/project/pyrobogui/",
        "project_urls": {
            "Homepage": "https://github.com/ClimenteA/pyrobogui"
        },
        "release_url": "https://pypi.org/project/pyrobogui/0.0.6/",
        "requires_dist": [
            "pyautogui",
            "opencv-python",
            "numpy",
            "pyperclip"
        ],
        "requires_python": "",
        "summary": "Wrapper around pyautogui for automating mouse and keyboard - plus some new functions",
        "version": "0.0.6"
    },
    "last_serial": 5389849,
    "releases": {
        "0.0.5": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "dbe19ed0a27750d340dfda36dd4490fe",
                    "sha256": "26a58d21b9beb26fbb06559b5af01a6b0cd44af42d9f98bd0d63b2a12eb1ba79"
                },
                "downloads": -1,
                "filename": "pyrobogui-0.0.5-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "dbe19ed0a27750d340dfda36dd4490fe",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 7280,
                "upload_time": "2019-04-03T13:23:52",
                "url": "https://files.pythonhosted.org/packages/5e/40/ee12e67d25f7f345cffd00b0894ed48ce86e0d920d21ce1ee8f55702c339/pyrobogui-0.0.5-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "6f48222525531ccc96e411777b66e619",
                    "sha256": "33e3004ad25fcffbe5e21f740b62471f085db0a85971930806d5374abe9f1afd"
                },
                "downloads": -1,
                "filename": "pyrobogui-0.0.5.tar.gz",
                "has_sig": false,
                "md5_digest": "6f48222525531ccc96e411777b66e619",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 6367,
                "upload_time": "2019-04-03T13:23:53",
                "url": "https://files.pythonhosted.org/packages/17/99/acf17689c00c4bfa0cd63f503ccb82bb16bc4158354a47b7ce1a39020c33/pyrobogui-0.0.5.tar.gz"
            }
        ],
        "0.0.6": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "6b1d5855e06ed2d2d1302cb8c82c2a71",
                    "sha256": "c7be1ba6b00b236bd26d5c4125db3dc82e9935699a7b5582714fbf0f06f59673"
                },
                "downloads": -1,
                "filename": "pyrobogui-0.0.6-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "6b1d5855e06ed2d2d1302cb8c82c2a71",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 7309,
                "upload_time": "2019-06-12T07:09:23",
                "url": "https://files.pythonhosted.org/packages/32/e7/b040015458d80acb7982e24095669dedf323202083c48aa4396a85022d44/pyrobogui-0.0.6-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "08c5db0e332359a4e2a57a99c3cea4f3",
                    "sha256": "027be5bec88e1a4071e31d0e188038381324b58c82e095663a8104de9d2a695d"
                },
                "downloads": -1,
                "filename": "pyrobogui-0.0.6.tar.gz",
                "has_sig": false,
                "md5_digest": "08c5db0e332359a4e2a57a99c3cea4f3",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 6463,
                "upload_time": "2019-06-12T07:09:24",
                "url": "https://files.pythonhosted.org/packages/cd/73/116667d4889005260f2d25b16542a07d7cb5ce63ff1d78c221806076a6f6/pyrobogui-0.0.6.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "6b1d5855e06ed2d2d1302cb8c82c2a71",
                "sha256": "c7be1ba6b00b236bd26d5c4125db3dc82e9935699a7b5582714fbf0f06f59673"
            },
            "downloads": -1,
            "filename": "pyrobogui-0.0.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "6b1d5855e06ed2d2d1302cb8c82c2a71",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 7309,
            "upload_time": "2019-06-12T07:09:23",
            "url": "https://files.pythonhosted.org/packages/32/e7/b040015458d80acb7982e24095669dedf323202083c48aa4396a85022d44/pyrobogui-0.0.6-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "08c5db0e332359a4e2a57a99c3cea4f3",
                "sha256": "027be5bec88e1a4071e31d0e188038381324b58c82e095663a8104de9d2a695d"
            },
            "downloads": -1,
            "filename": "pyrobogui-0.0.6.tar.gz",
            "has_sig": false,
            "md5_digest": "08c5db0e332359a4e2a57a99c3cea4f3",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 6463,
            "upload_time": "2019-06-12T07:09:24",
            "url": "https://files.pythonhosted.org/packages/cd/73/116667d4889005260f2d25b16542a07d7cb5ce63ff1d78c221806076a6f6/pyrobogui-0.0.6.tar.gz"
        }
    ]
}