Skip to content

Commit d885a8a

Browse files
chore: update GitHub branch references to use HEAD (#432)
1 parent d9bb55d commit d885a8a

14 files changed

+51
-51
lines changed

CHANGELOG.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -120,7 +120,7 @@ All notable changes to this project will be documented in this file.
120120
[2019-06-04] Version 6.0.0
121121
--------------------------
122122
### BREAKING CHANGE
123-
- [PR #284](https://github.com/sendgrid/sendgrid-ruby/pull/284): The sinatra gem is no longer specified as a dependency of this gem. If you would like to use the inbound processing, please follow the [upgrade guide](https://github.com/sendgrid/sendgrid-ruby/blob/master/UPGRADE.md). Big thanks to [@jjb](https://github.com/jjb) for the PR!
123+
- [PR #284](https://github.com/sendgrid/sendgrid-ruby/pull/284): The sinatra gem is no longer specified as a dependency of this gem. If you would like to use the inbound processing, please follow the [upgrade guide](UPGRADE.md). Big thanks to [@jjb](https://github.com/jjb) for the PR!
124124

125125
### Added
126126
- [PR #271](https://github.com/sendgrid/sendgrid-ruby/pull/271): Add ability to impersonate a subuser. Big thanks to [@danilospa](https://github.com/danilospa) for the PR!
@@ -187,7 +187,7 @@ All notable changes to this project will be documented in this file.
187187
- `mail.headers` becomes `mail.add_header()`
188188
- `mail.categories` becomes `mail.add_category()`
189189
- `mail.custom_args` becomes `mail.custom_args()`
190-
- For a full example of usage, please [see here](https://github.com/sendgrid/sendgrid-ruby/blob/master/examples/helpers/mail/example.rb#L21).
190+
- For a full example of usage, please [see here](examples/helpers/mail/example.rb#L21).
191191

192192
## [4.3.3] - 2017-5-2
193193
### Update
@@ -210,7 +210,7 @@ All notable changes to this project will be documented in this file.
210210
## [4.3.0] - 2017-4-12 ##
211211
### Added
212212
- #70: Adds an account settings management helper object
213-
- See the [helper README](https://github.com/sendgrid/sendgrid-ruby/tree/master/lib/sendgrid/helpers/settings) for details
213+
- See the [helper README](lib/sendgrid/helpers/settings) for details
214214
- Thanks to [Kyle Kern](https://github.com/kernkw) for the pull request!
215215

216216
## [4.2.1] - 2017-4-10 ##
@@ -262,15 +262,15 @@ All notable changes to this project will be documented in this file.
262262
## [4.0.3] - 2016-08-24 ##
263263
### Added
264264
- Table of Contents in the README
265-
- Added a [USE_CASES.md](https://github.com/sendgrid/sendgrid-ruby/blob/master/USE_CASES.md) section, with the first use case example for transactional templates
265+
- Added a [USE_CASES.md](USE_CASES.md) section, with the first use case example for transactional templates
266266

267267
## [4.0.2] - 2016-07-26 ##
268268
### Fixed
269269
- Example and USAGE DELETE calls were missing example payloads
270270

271271
## [4.0.1] - 2016-07-25 ##
272272
### Added
273-
- [Troubleshooting](https://github.com/sendgrid/sendgrid-ruby/blob/master/TROUBLESHOOTING.md) section
273+
- [Troubleshooting](TROUBLESHOOTING.md) section
274274

275275
## [4.0.0] - 2016-07-23 ##
276276
### BREAKING CHANGE

CONTRIBUTING.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ source ./sendgrid.env
9393

9494
##### Execute: #####
9595

96-
See the [examples folder](https://github.com/sendgrid/sendgrid-ruby/tree/master/examples) to get started quickly.
96+
See the [examples folder](examples) to get started quickly.
9797

9898
To run the examples using the local version of this library from the root directory of this repo, please replace:
9999

@@ -126,7 +126,7 @@ The Web API v3 client is `sendgrid-ruby.rb`
126126

127127
## Testing
128128

129-
All PRs require passing tests before the PR will be reviewed. All test files are in the [`tests`](https://github.com/sendgrid/sendgrid-ruby/tree/master/test) directory. For the purposes of contributing to this repo, please update the [`test_sendgrid-ruby.rb`](https://github.com/sendgrid/sendgrid-ruby/blob/master/test/test_sendgrid-ruby.rb) file with unit tests as you modify the code.
129+
All PRs require passing tests before the PR will be reviewed. All test files are in the [`tests`](test) directory. For the purposes of contributing to this repo, please update the [`test_sendgrid-ruby.rb`](test/sendgrid/test_sendgrid-ruby.rb) file with unit tests as you modify the code.
130130

131131
The integration tests require a Twilio SendGrid mock API in order to execute. We've simplified setting this up using Docker to run the tests. You will just need [Docker Desktop](https://docs.docker.com/get-docker/) and `make`.
132132

@@ -187,7 +187,7 @@ Please run your code through:
187187
5. Locally merge (or rebase) the upstream development branch into your topic branch:
188188

189189
```bash
190-
git pull [--rebase] upstream master
190+
git pull [--rebase] upstream main
191191
```
192192

193193
6. Push your topic branch up to your fork:
@@ -197,7 +197,7 @@ Please run your code through:
197197
```
198198

199199
7. [Open a Pull Request](https://help.github.com/articles/using-pull-requests/)
200-
with a clear title and description against the `master` branch. All tests must be passing before we will review the PR.
200+
with a clear title and description against the `main` branch. All tests must be passing before we will review the PR.
201201

202202
<a name="code-reviews"></a>
203203
## Code Reviews

README.md

+20-20
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
![Twilio SendGrid Logo](https://github.com/sendgrid/sendgrid-python/raw/master/twilio_sendgrid_logo.png)
1+
![Twilio SendGrid Logo](twilio_sendgrid_logo.png)
22

3-
[![Travis Badge](https://travis-ci.org/sendgrid/sendgrid-ruby.svg?branch=master)](https://travis-ci.org/sendgrid/sendgrid-ruby)
3+
[![Travis Badge](https://travis-ci.org/sendgrid/sendgrid-ruby.svg?branch=main)](https://travis-ci.org/sendgrid/sendgrid-ruby)
44
[![Gem Version](https://badge.fury.io/rb/sendgrid-ruby.svg)](https://badge.fury.io/rb/sendgrid-ruby)
55
[![Email Notifications Badge](https://dx.sendgrid.com/badge/ruby)](https://dx.sendgrid.com/newsletter/ruby)
66
[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE.md)
@@ -16,7 +16,7 @@
1616

1717
Version 3.X.X+ of this library provides full support for all Twilio SendGrid [Web API v3](https://sendgrid.com/docs/API_Reference/Web_API_v3/index.html) endpoints, including the new [v3 /mail/send](https://sendgrid.com/blog/introducing-v3mailsend-sendgrids-new-mail-endpoint).
1818

19-
This library represents the beginning of a new path for Twilio SendGrid. We want this library to be community driven and Twilio SendGrid led. We need your help to realize this goal. To help make sure we are building the right things in the right order, we ask that you create [issues](https://github.com/sendgrid/sendgrid-ruby/issues) and [pull requests](https://github.com/sendgrid/sendgrid-ruby/blob/master/CONTRIBUTING.md) or simply upvote or comment on existing issues or pull requests.
19+
This library represents the beginning of a new path for Twilio SendGrid. We want this library to be community driven and Twilio SendGrid led. We need your help to realize this goal. To help make sure we are building the right things in the right order, we ask that you create [issues](https://github.com/sendgrid/sendgrid-ruby/issues) and [pull requests](CONTRIBUTING.md) or simply upvote or comment on existing issues or pull requests.
2020

2121
Please browse the rest of this README for further details.
2222

@@ -42,7 +42,7 @@ We appreciate your continued support, thank you!
4242

4343
## Prerequisites
4444

45-
- Ruby version >= 2.4 (except version [2.6.0](https://github.com/sendgrid/sendgrid-ruby/blob/master/TROUBLESHOOTING.md#ruby-versions))
45+
- Ruby version >= 2.4 (except version [2.6.0](TROUBLESHOOTING.md#ruby-versions))
4646
- The Twilio SendGrid service, starting at the [free level](https://sendgrid.com/free?source=sendgrid-ruby)
4747

4848
## Setup Environment Variables
@@ -83,7 +83,7 @@ gem install sendgrid-ruby
8383

8484
## Hello Email
8585

86-
The following is the minimum needed code to send an email with the [/mail/send Helper](https://github.com/sendgrid/sendgrid-ruby/tree/master/lib/sendgrid/helpers/mail) ([here](https://github.com/sendgrid/sendgrid-ruby/blob/master/examples/helpers/mail/example.rb#L21) is a full example):
86+
The following is the minimum needed code to send an email with the [/mail/send Helper](lib/sendgrid/helpers/mail) ([here](examples/helpers/mail/example.rb#L21) is a full example):
8787

8888
### With Mail Helper Class
8989

@@ -105,11 +105,11 @@ puts response.parsed_body
105105
puts response.headers
106106
```
107107

108-
For more complex scenarios, please do not use the above constructor and instead build your own personalization object as [demonstrated here](https://github.com/sendgrid/sendgrid-ruby/blob/master/examples/helpers/mail/example.rb#L21).
108+
For more complex scenarios, please do not use the above constructor and instead build your own personalization object as [demonstrated here](examples/helpers/mail/example.rb#L21).
109109

110110
### Without Mail Helper Class
111111

112-
The following is the minimum needed code to send an email without the /mail/send Helper ([here](https://github.com/sendgrid/sendgrid-ruby/blob/master/examples/mail/mail.rb#L26) is a full example):
112+
The following is the minimum needed code to send an email without the /mail/send Helper ([here](examples/mail/mail.rb#L26) is a full example):
113113

114114
```ruby
115115
require 'sendgrid-ruby'
@@ -171,29 +171,29 @@ puts response.headers
171171
<a name="inbound"></a>
172172
# Processing Inbound Email
173173

174-
Please see [our helper](https://github.com/sendgrid/sendgrid-ruby/tree/master/lib/sendgrid/helpers/inbound) for utilizing our Inbound Parse webhook.
174+
Please see [our helper](lib/sendgrid/helpers/inbound) for utilizing our Inbound Parse webhook.
175175

176176
<a name="usage"></a>
177177
# Usage
178178

179179
- [Twilio SendGrid Docs](https://sendgrid.com/docs/API_Reference/index.html)
180-
- [Library Usage Docs](https://github.com/sendgrid/sendgrid-ruby/tree/master/USAGE.md)
181-
- [Example Code](https://github.com/sendgrid/sendgrid-ruby/tree/master/examples)
180+
- [Library Usage Docs](USAGE.md)
181+
- [Example Code](examples)
182182
- [How-to: Migration from v2 to v3](https://sendgrid.com/docs/Classroom/Send/v3_Mail_Send/how_to_migrate_from_v2_to_v3_mail_send.html)
183-
- [v3 Web API Mail Send Helper](https://github.com/sendgrid/sendgrid-ruby/tree/master/lib/sendgrid/helpers/mail) - build a request object payload for a v3 /mail/send API call.
184-
- [Settings Helper](https://github.com/sendgrid/sendgrid-ruby/tree/master/lib/sendgrid/helpers/settings)
183+
- [v3 Web API Mail Send Helper](lib/sendgrid/helpers/mail) - build a request object payload for a v3 /mail/send API call.
184+
- [Settings Helper](lib/sendgrid/helpers/settings)
185185

186186
<a name="use_cases"></a>
187187
# Use Cases
188188

189-
[Examples of common API use cases](https://github.com/sendgrid/sendgrid-ruby/blob/master/USE_CASES.md), such as how to send an email with a transactional template.
189+
[Examples of common API use cases](use-cases), such as how to send an email with a transactional template.
190190

191191
<a name="announcements"></a>
192192
# Announcements
193193

194194
Please see our announcement regarding [breaking changes](https://github.com/sendgrid/sendgrid-ruby/issues/94). Your support is appreciated!
195195

196-
All updates to this library are documented in our [CHANGELOG](https://github.com/sendgrid/sendgrid-ruby/blob/master/CHANGELOG.md) and [releases](https://github.com/sendgrid/sendgrid-ruby/releases). You may also subscribe to email [release notifications](https://dx.sendgrid.com/newsletter/ruby) for releases and breaking changes.
196+
All updates to this library are documented in our [CHANGELOG](CHANGELOG.md) and [releases](https://github.com/sendgrid/sendgrid-ruby/releases). You may also subscribe to email [release notifications](https://dx.sendgrid.com/newsletter/ruby) for releases and breaking changes.
197197

198198
<a name="roadmap"></a>
199199
# Roadmap
@@ -203,17 +203,17 @@ If you are interested in the future direction of this project, please take a loo
203203
<a name="contribute"></a>
204204
# How to Contribute
205205

206-
We encourage contribution to our libraries (you might even score some nifty swag), please see our [CONTRIBUTING](https://github.com/sendgrid/sendgrid-ruby/tree/master/CONTRIBUTING.md) guide for details.
206+
We encourage contribution to our libraries (you might even score some nifty swag), please see our [CONTRIBUTING](CONTRIBUTING.md) guide for details.
207207

208-
- [Feature Request](https://github.com/sendgrid/sendgrid-ruby/tree/master/CONTRIBUTING.md#feature_request)
209-
- [Bug Reports](https://github.com/sendgrid/sendgrid-ruby/tree/master/CONTRIBUTING.md#submit_a_bug_report)
210-
- [Improvements to the Codebase](https://github.com/sendgrid/sendgrid-ruby/tree/master/CONTRIBUTING.md#improvements_to_the_codebase)
211-
- [Review Pull Requests](https://github.com/sendgrid/sendgrid-ruby/blob/master/CONTRIBUTING.md#code-reviews)
208+
- [Feature Request](CONTRIBUTING.md#feature_request)
209+
- [Bug Reports](CONTRIBUTING.md#submit_a_bug_report)
210+
- [Improvements to the Codebase](CONTRIBUTING.md#improvements_to_the_codebase)
211+
- [Review Pull Requests](CONTRIBUTING.md#code-reviews)
212212

213213
<a name="troubleshooting"></a>
214214
# Troubleshooting
215215

216-
Please see our [troubleshooting guide](https://github.com/sendgrid/sendgrid-ruby/blob/master/TROUBLESHOOTING.md) for common library issues.
216+
Please see our [troubleshooting guide](TROUBLESHOOTING.md) for common library issues.
217217

218218
<a name="about"></a>
219219
# About

TROUBLESHOOTING.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ end
7373
<a name="versioning"></a>
7474
## Versioning
7575

76-
We follow the MAJOR.MINOR.PATCH versioning scheme as described by [SemVer.org](http://semver.org). Therefore, we recommend that you always pin (or vendor) the particular version you are working with to your code and never auto-update to the latest version. Especially when there is a MAJOR point release, since that is guaranteed to be a breaking change. Changes are documented in the [CHANGELOG](https://github.com/sendgrid/sendgrid-ruby/blob/master/CHANGELOG.md) and [releases](https://github.com/sendgrid/sendgrid-ruby/releases) section.
76+
We follow the MAJOR.MINOR.PATCH versioning scheme as described by [SemVer.org](http://semver.org). Therefore, we recommend that you always pin (or vendor) the particular version you are working with to your code and never auto-update to the latest version. Especially when there is a MAJOR point release, since that is guaranteed to be a breaking change. Changes are documented in the [CHANGELOG](CHANGELOG.md) and [releases](https://github.com/sendgrid/sendgrid-ruby/releases) section.
7777

7878
<a name="environment"></a>
7979
## Environment Variables and Your Twilio SendGrid API Key

USAGE.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -2103,7 +2103,7 @@ For more detailed information about how to use the v3 Mail Send endpoint, please
21032103

21042104
### POST /mail/send
21052105

2106-
This endpoint has a helper, check it out [here](https://github.com/sendgrid/sendgrid-ruby/blob/master/lib/sendgrid/helpers/mail/README.md).
2106+
This endpoint has a helper, check it out [here](lib/sendgrid/helpers/mail/README.md).
21072107

21082108
```ruby
21092109
data = JSON.parse('{

examples/mail/mail.rb

+1-1
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@
2626
##################################################
2727
# v3 Mail Send #
2828
# POST /mail/send #
29-
# This endpoint has a helper, check it out [here](https://github.com/sendgrid/sendgrid-ruby/blob/master/lib/helpers/mail/README.md).
29+
# This endpoint has a helper, check it out [here](https://github.com/sendgrid/sendgrid-ruby/blob/HEAD/lib/helpers/mail/README.md).
3030

3131
data = JSON.parse('{
3232
"asm": {

lib/sendgrid/helpers/inbound/README.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@
1717
# Installation
1818

1919
In addition to the installation instructions in
20-
[the main readme](https://github.com/sendgrid/sendgrid-ruby/tree/master/#installation),
20+
[the main readme](../../../../README.md#installation),
2121
you must also add sinatra to your Gemfile:
2222

2323
```
@@ -47,7 +47,7 @@ bundle install
4747
ruby ./lib/sendgrid/helpers/inbound/send.rb ./lib/sendgrid/helpers/inbound/sample_data/default_data.txt
4848
```
4949

50-
More sample data can be found [here](https://github.com/sendgrid/sendgrid-ruby/tree/master/lib/sendgrid/helpers/inbound/sample_data).
50+
More sample data can be found [here](sample_data).
5151

5252
View the results in the first terminal.
5353

@@ -82,11 +82,11 @@ Next, send an email to [anything]@inbound.yourdomain.com, then look at the termi
8282

8383
## app.rb
8484

85-
This module runs a [Sinatra](http://www.sinatrarb.com/) server, that by default (you can change those settings [here](https://github.com/sendgrid/sendgrid-ruby/blob/master/sendgrid/helpers/inbound/config.yml)), listens for POSTs on http://localhost:9292. When the server receives the POST, it parses and prints the key/value data.
85+
This module runs a [Sinatra](http://www.sinatrarb.com/) server, that by default (you can change those settings [here](config.yml)), listens for POSTs on http://localhost:9292. When the server receives the POST, it parses and prints the key/value data.
8686

8787
## config.yml
8888

89-
This module loads application environment variables (located in [config.yml](https://github.com/sendgrid/sendgrid-ruby/blob/master/sendgrid/helpers/inbound/config.yml)).
89+
This module loads application environment variables (located in [config.yml](config.yml)).
9090

9191
## send.rb & /sample_data
9292

@@ -95,4 +95,4 @@ This module is used to send sample test data. It is useful for testing and devel
9595
<a name="contributing"></a>
9696
# Contributing
9797

98-
If you would like to contribute to this project, please see our [contributing guide](https://github.com/sendgrid/sendgrid-ruby/blob/master/CONTRIBUTING.md). Thanks!
98+
If you would like to contribute to this project, please see our [contributing guide](../../../../CONTRIBUTING.md). Thanks!

lib/sendgrid/helpers/inbound/public/index.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,6 @@
55
<body>
66
<h1>You have successfuly launched the server!</h1>
77

8-
Check out <a href="https://github.com/sendgrid/sendgrid-ruby/tree/master/sendgrid/helpers/inbound">the documentation</a> on how to use this software to utilize the SendGrid Inbound Parse webhook.
8+
Check out <a href="https://github.com/sendgrid/sendgrid-ruby/tree/HEAD/sendgrid/helpers/inbound">the documentation</a> on how to use this software to utilize the SendGrid Inbound Parse webhook.
99
</body>
1010
</html>

lib/sendgrid/helpers/mail/README.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,13 @@
22

33
# Quick Start
44

5-
Run the [example](https://github.com/sendgrid/sendgrid-ruby/tree/master/examples/helpers/mail) (make sure you have set your environment variable to include your SENDGRID_API_KEY).
5+
Run the [example](../../../../examples/helpers/mail) (make sure you have set your environment variable to include your SENDGRID_API_KEY).
66

77
```bash
88
ruby examples/helpers/mail/example.rb
99
```
1010

1111
## Usage
1212

13-
- See the [example](https://github.com/sendgrid/sendgrid-ruby/tree/master/examples/helpers/mail) for a complete working example.
13+
- See the [example](../../../../examples/helpers/mail) for a complete working example.
1414
- [Documentation](https://sendgrid.com/docs/API_Reference/Web_API_v3/Mail/index.html)

lib/sendgrid/helpers/settings/README.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,13 @@
22

33
# Quick Start
44

5-
Run the [example](https://github.com/sendgrid/sendgrid-ruby/tree/master/examples/helpers/settings) (make sure you have set your environment variable to include your SENDGRID_API_KEY).
5+
Run the [example](../../../../examples/helpers/settings) (make sure you have set your environment variable to include your SENDGRID_API_KEY).
66

77
```bash
88
ruby examples/helpers/settings/example.rb
99
```
1010

1111
## Usage
1212

13-
- See the [example](https://github.com/sendgrid/sendgrid-ruby/tree/master/examples/helpers/settings) for a complete working example.
13+
- See the [example](../../../../examples/helpers/settings) for a complete working example.
1414
- [Documentation](https://sendgrid.com/docs/API_Reference/Web_API_v3/Settings/index.html)

0 commit comments

Comments
 (0)