Metadata-Version: 2.3
Name: class-email
Version: 0.0.4
Summary: A tool to output .eml files, because we can't add OAuth applications to use SMTP.
Project-URL: Repository, https://github.com/HamishWHC/class-email.git
Project-URL: Issues, https://github.com/HamishWHC/class-email/issues
Author-email: Hamish Cox <hamish@hamishwhc.com>
Maintainer-email: Hamish Cox <hamish@hamishwhc.com>
License: Copyright © 2024 Hamish Cox
        
        Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications :: Email
Classifier: Topic :: Text Processing :: Markup :: HTML
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Requires-Dist: click>=8.1.7
Requires-Dist: jinja2>=3.1.4
Description-Content-Type: text/markdown

# A tool for spitting out .eml files from a template and a CSV file

Built for UNSW COMP6[48]41 tutors, because we don't get to use SMTP with Outlook, since we can't add OAuth applications.

Defaults are tailored to the COMP6[48]41 marking spreadsheet for 24T3.

```
Usage: class-email [OPTIONS] DATAFILE TEMPLATE SUBJECT

  Creates .eml files for each row in DATAFILE. The email body is generated
  from TEMPLATE, which is a Jinja2 template. Each email's subject will be
  SUBJECT.

Options:
  --filter TEXT            An allowed value for the column specified by
                           --filter-column. Not compatible with --filter-file.
  --filter-file FILENAME   A file with allowed values for the column specified
                           by --filter-column. Values should be separated by
                           newlines. Not compatible with --filter-file.
  --filter-column INTEGER  The column to filter on. First column is column 0.
                           Defaults to 0 when using --filter-file and 3 when
                           using --filter.
  --sender TEXT            If specified, the From header is added to .eml
                           files - useful if you have multiple sending
                           addresses configured in your email client.
  --email-column INTEGER   The column to use as the email address. First
                           column is column 0. Defaults to 4.
  --header-count INTEGER   Number of header rows. Defaults to 2.
  --outdir DIRECTORY       A directory where .eml files should be output to.
  --yes                    Auto-open all output email files without prompting.
  --no                     Skips the file open prompt without opening.
  --help                   Show this message and exit.
```