An open API service indexing awesome lists of open source software.

https://github.com/motdotla/sendgrid-opensource-proposals

this document is a moving target and likely temporary. It's a tool to workout brining our open source libraries closer inline together.
https://github.com/motdotla/sendgrid-opensource-proposals

Last synced: 8 days ago
JSON representation

this document is a moving target and likely temporary. It's a tool to workout brining our open source libraries closer inline together.

Awesome Lists containing this project

README

          

# Proposals for SendGrid open source

This document is a moving target and likely temporary. It's a tool to workout brining our open source libraries closer inline together.

## Proposals

* [Drop SMTP support from libraries](http://github.com/scottmotte/sendgrid-opensource-proposals/blob/master/proposals/completed/DROP_SMTP.md)
* [Unify naming for SMTPAPI libraries](http://github.com/scottmotte/sendgrid-opensource-proposals/blob/master/proposals/completed/METHOD_NAMING.md)
* [Port](https://github.com/scottmotte/sendgrid-opensource-proposals/blob/master/proposals/PORT.md)

## Summit

### Past few months

* Goal: Stable libs. It's an ongoing battle, but we did it. I'd consider our libs stable.
* New: sendgrid-ruby
* New: [nodemailer-sendgrid-transport](https://github.com/sendgrid/nodemailer-sendgrid-transport)
* New: sendgrid-apex (salesforce)
* New: smtpapi-objc
* New: sendgrid-cobol
* New: Appcelerator
* New: sendgrid-parse
* New: django dropin for SendGrid with web

### Low Hanging Fruit

* Objective C library to be transfered under SendGrid GitHub. Currently a fork.

### Discuss and Decide

* Discuss and Decide: Python and Go libs ready for 1.0?
* Discuss and Decide: Email vs Mail. Decide on Email but a very loose yes.
* Discuss and Decide: To be idiomatic or not to be idiomatic. [1](https://github.com/scottmotte/sendgrid-opensource-proposals/commit/5b2d1745044c08b5a01d9f113583a906bf2760d4#commitcomment-6921910) Idiomatic always calls the standard calls - like addTo.
* DONE (Eddie making it happen): Discuss and Decide: User agent to libs.
* Discuss and Decide: Awwa more involved. Begin by pulling in Awwa's smtpapi lib. Before or after my vacay.
* Discuss and Decide: Yamil's pythong library BCC approach. Multiple emails in the to field vs not multiple in to. Historic approach vs future approach.
* Discuss and decide: Options to pass through for port, host, etc. We're going with this:
- Protocol (`https`, `http`) - Maybe your environment only allows for HTTP connections.
- Host (`api.sendgrid.com`, `secret-hostname.sendgrid.com`, `bucket.runscope.io`) - For things like Runscope or HV customers
- Port (`80`, `443`) - Maybe you're an engineer testing our mail pipeline and you have it running on a weird port
- Endpoint (`/api/mail.send.json`) - _I dunno what else you'd do, but maybe in the future this is useful_
- URL as a whole (`https://api.sendgrid.com/api/mail.send.json`) - for simplicity's sake

## Status - 32

### SMTPAPI Libs - 3

* 1
* 0
* 1
* 0
* 0
* 1
* 0

### Libs - 19

* 5
* 0
* 9
* 0
* 4
* 1
* 0

#### Libs without SMTPAPI sub-libs - 10

* 0
* 3
* 7