GoogleMailLibrary

Library Scope: GLOBAL

created: September 21, 2022 12:20 UTC8

Author: Francisco Quinola Jr. | email: francisco.quinola@mnltechnology.com

company: Spiralworks Technologies Inc

Full Documentation: https://mainsystemdev.github.io/GoogleMailLibrary

Contents:

• GoogleMailLibrary
  • Contents
  • Introduction
  • Installation
  • Usage
  • Generating Documentation
  • Dependencies

Introduction

GoogleMailLibrary is a Robotframework Test Library for interfacing tests with Google Email using Google Mail API v1.

Installation

Option 1
Install using pypi, run:

pip install rf-googlemaillibrary

Option 2
With recent version of pip, it is possible to install directly from GitHub repository. To Install latest source from the master branch, use this command:

pip install git+https://github.com/MainSystemDev/GoogleMailLibrary.git

Please note that installation will take some time, because pip will clone the GoogleMailLibrary project to a temporary directory and then perform the installation.

Usage

To use GoogleMailLibrary in Robot Framework tests, the library needs to first be imported using the Library setting as any other library.

*** Settings ***
Documentation                         This is demo test script to show how GoogleMailLibrary Works

Library                               GoogleMailLibrary
...                                   scopes=['https://www.googleapis.com/auth/gmail.readonly']

Library                               String

Suite Setup                           Initialize Email
...                                   tokenFile=path/to/token.json

Force Tags                            gmail-api

*** Variables ***
# Sample id
# Should be a specific valid email id from an inbox from gmail to work.
${email_id}                           183a2a567gf2db7c

*** Test Cases ***
Get First Email In Inbox
    [Documentation]                   Get the first email in inbox and return raw data.
    ...                               Please refer to the link on the datas returned for raw
    ...                               https://developers.google.com/gmail/api/reference/rest/v1/users.messages#Message.FIELDS
    [Tags]                            gmail-api-1
    ${first_email_raw}                Parse First Email
    Log To Console                    ${first_email_raw}

Get Recent Id In Inbox
    [Documentation]                   Get the first email id in inbox.
    ...                               Please refer to the link on the datas returned for raw
    ...                               https://developers.google.com/gmail/api/reference/rest/v1/users.messages#Message.FIELDS
    [Tags]                            gmail-api-2
    ${recent_message_id_in_inbox}     Get First Id In Inbox
    Log To Console                    \n${recent_message_id_in_inbox}

Get Specific Id In Inbox
    [Documentation]                   Get the Specific email id in inbox.
    ...                               Please refer to the link on the datas returned for raw
    ...                               expecting an argument for specific email_id
    ...                               https://developers.google.com/gmail/api/reference/rest/v1/users.messages#Message.FIELDS
    [Tags]                            gmail-api-3
    ${specific_message_in_inbox}      Parse Email                        ${email_id}
    Log To Console                    \n${specific_message_in_inbox}

Delete Specific Mail
    [Documentation]                   Delete the specific email in inbox
    ...                               Please refer to the link on the datas returned for raw
    ...                               expecting an argument for specific email_id
    ...                               https://developers.google.com/gmail/api/reference/rest/v1/users.messages/delete
    [Tags]                            gmail-api-4
    Delete Message                    ${email_id}

Return Email Body Content
    [Documentation]                   Get the specific email in inbox
    ...                               Email format can be in plain text, rich text and html
    ...                               Converts the html content to a readable text
    ...                               expecting an argument for specific email_id
    [Tags]                            gmail-api-5
    ${body_content}                   Return Email Body Content        
    ...                               ${email_id}
    Log To Console                    \n${body_content}

Return Sender of Specific Email
    [Documentation]                   Get the specific email in inbox
    ...                               Return the specific sender of email
    [Tags]                            gmail-api-6
    ${sender}                         Return Sender Name            ${email_id}
    Log To Console                    \n${sender}

Return TimeStamp of Specific Email
    [Documentation]                   Get the specific timestamp of email
    ...                               Return the specific timestamp of email
    [Tags]                            gmail-api-7
    ${timestamp}                      Return Email Timestamp            ${email_id}
    Log To Console                    \n${timestamp}

Generating Documentation

To Generate the keyword Documentation, simply run:

python -m robot.libdoc GoogleMailLibrary documentation.html

Note that the library must first be installed before generating a documentation.

Dependencies