Metadata-Version: 2.1
Name: mittepro
Version: 2.4.0
Summary: MittePro is a powerful marketing tool with features to help companies with their marketing goals and deliver emails from their websites and apps.
Home-page: https://github.com/ThCC/mittepro-py
Author: Thiago Cardoso de Castro
Author-email: thiago.decastro2@gmail.com
License: Apache-2.0
Description: Client service, to send simple text emails or, using a template created at MittePro, send more complex emails.
        
        In order to use this library, you must create an account in MittePro.
        
        ** **It is not currently possible to create an account in MittePro, but will soon be** **
        
        How to install:
            pip install mittepro
        
        Follow the examples below to send simple emails or emails with templates:
        
        **Simple Emails:**
        
            from mittepro.models import Mail
            from mittepro.client import MittePro
        
            mittepro = MittePro(key='<your_account_public_key>', secret='<your_account_secret_key>')
        
            def send(self):
                mail = Mail(
                    recipient_list=[
                        'Foo Bar <foo.bar@gmail.com>',
                        'Fulano <fulano@gmail.com>',
                        '<ciclano@gmail.com>'
                    ],
                    message="Just a Test, delete if you want.",
                    from_='Beutrano <beutrano@mail.com>',
                    subject="Just a test"
                )
                response = mittepro.send(mail)
        
        **Template Emails:**
        
            from mittepro.models import Mail
            from mittepro.client import MittePro
        
            mittepro = MittePro(key='<your_account_public_key>', secret='<your_account_secret_key>')
        
            def send(self):
                mail = Mail(
                    recipient_list=[
                        'Foo Bar <foo.bar@gmail.com>',
                        'Fulano <fulano@gmail.com>',
                        '<ciclano@gmail.com>'
                    ],
                    from_='Beutrano <beutrano@mail.com>',
                    template_slug='test-101',
                    context={'foobar': True},
                    context_per_recipient={
                        "foo.bar@gmail.com": {"foo": True},
                        "fulano@gmail.com.br": {"bar": True}
                    },
                    use_tpl_default_subject=True,
                    use_tpl_default_email=False,
                    use_tpl_default_name=False
                )
                response = mittepro.send_template(mail)
        
        **Mail Parameters:**
        
        Parameter - Type - Required - Description
        
        recipient_list - List - Yes - List of all the recipients. The expected format is 'Name `<email>`' or '`<email>`'.
        
        subject - String - Yes* - The subject of the email. *In case your sending an email with template and pass `use_tpl_default_subject` as `True` then you don't need to pass the `subject`.
        
        message_text - String - Yes* - The `message` of the email on text format. *Only Required if your gonna send a simple text email.
        
        message_html - String - No - The `message` of the email on html format. *If pass this and an `template_slug` MittePro is going to ignore the template's html.
        
        tags - Dict/List - No - The `tags` must be an dictionary containing keys and simple values or an list with strings.
        
        from_ - String - No* - The email of the sender. The expected format is 'Name `<email>`' or '`<email>`'. *In case your sending an email with template and pass `use_template_email` as `true` then you don't need to pass this parameter.
        
        template_slug - String - Yes* - The `template_slug` is the slug of the template. *Just pass this if your gonna send a email with template.
        
        use_tpl_default_name - Bool - No* - If set to `True` it use the default value set to the sender's name.
        
        use_tpl_default_email - Bool - No* - If set to `True` it use the default value set to the sender's email.
        
        use_tpl_default_subject - Bool - No* - If set to `True` it use the default value set to the subject.
        
        expose_recipients_list - Bool - No* - If set to `True` every recipient will see the entire list of recipients.
        
        get_text_from_html - Bool - No* - If set to `True` MittePro will extract from your html template an text version. This will only happen if your template doesn't already have an text version.
        
        activate_tracking - Bool - No* - If set to `True` MittePro will track if your email will be open and how many times. Also it will track any links clicked inside the email.
        
        context - Dict - No - Global variables use in the Template. The format is expressed in the example (above).
        
        context_per_recipient - Dict - No - Variables set for each recipient. The format is expressed in the example (above).
        
        **Client Parameters:**
        
        Parameter - Type - Required - Description
        
        key - String - Yes - Your account's public key in the MittePro.
        
        secret - String - Yes - Your account's private key in the MittePro.
        
        fail_silently - Bool - No - If set to `True` the lib will raise it's exceptions. Default `False`.
        
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.5.*, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
Description-Content-Type: text/markdown
