diff options
Diffstat (limited to 'content/blog/2022-06-22-daily-poetry.md')
| -rw-r--r-- | content/blog/2022-06-22-daily-poetry.md | 92 |
1 files changed, 46 insertions, 46 deletions
diff --git a/content/blog/2022-06-22-daily-poetry.md b/content/blog/2022-06-22-daily-poetry.md index a687ce3..96f11b2 100644 --- a/content/blog/2022-06-22-daily-poetry.md +++ b/content/blog/2022-06-22-daily-poetry.md @@ -7,8 +7,8 @@ draft = false # Source Code -I don't want to bury the lede here, so if you'd like to see the full source -code I use to email myself plaintext poems daily, visit the repository: +I don't want to bury the lede here, so if you'd like to see the full source code +I use to email myself plaintext poems daily, visit the repository: [daily-poem.git](https://git.cleberg.net/?p=daily-poem.git;a=summary). # My Daily Dose of Poetry @@ -20,8 +20,8 @@ In this case, I was looking for a simply and easy way to get a daily dose of literature or poetry to read in the mornings. However, I don't want to sign up for a random mailing list on just any website. -I also don't want to have to work to find the reading content each morning, as -I know I would simply give up and stop reading daily. +I also don't want to have to work to find the reading content each morning, as I +know I would simply give up and stop reading daily. Thus, I found a way to deliver poetry to myself in plain-text format, on a daily basis, and scheduled to deliver automatically. @@ -31,8 +31,8 @@ basis, and scheduled to deliver automatically. This solution uses Python and email, so the following process requires the following to be installed: -1. An SMTP server, which can be as easy as installing `mailutils` if you're on - a Debian-based distro. +1. An SMTP server, which can be as easy as installing `mailutils` if you're on a + Debian-based distro. 2. Python (& pip!) 3. The following Python packages: `email`, `smtplib`, `json`, and `requests` @@ -46,7 +46,7 @@ informational. This program starts with a simple import of the required packages, so I wanted to explain why each package is used: -``` python +```python from email.mime.text import MIMEText # Required for translating MIMEText import smtplib # Required to process the SMTP mail delivery import json # Required to parse the poetry API results @@ -55,41 +55,41 @@ import requests # Required to send out a request to the API ## Sending the API Request -Next, we need to actually send the API request. In my case, I'm calling a -random poem from the entire API. If you want, you can call specific poems or -authors from this API. +Next, we need to actually send the API request. In my case, I'm calling a random +poem from the entire API. If you want, you can call specific poems or authors +from this API. -``` python +```python json_data = requests.get('https://poetrydb.org/random').json() ``` This gives us the following result in JSON: -``` json +```json [ - { - "title": "Sonnet XXII: With Fools and Children", - "author": "Michael Drayton", - "lines": [ - "To Folly", - "", - "With fools and children, good discretion bears;", - "Then, honest people, bear with Love and me,", - "Nor older yet, nor wiser made by years,", - "Amongst the rest of fools and children be;", - "Love, still a baby, plays with gauds and toys,", - "And, like a wanton, sports with every feather,", - "And idiots still are running after boys,", - "Then fools and children fitt'st to go together.", - "He still as young as when he first was born,", - "No wiser I than when as young as he;", - "You that behold us, laugh us not to scorn;", - "Give Nature thanks you are not such as we.", - "Yet fools and children sometimes tell in play", - "Some, wise in show, more fools indeed than they." - ], - "linecount": "15" - } + { + "title": "Sonnet XXII: With Fools and Children", + "author": "Michael Drayton", + "lines": [ + "To Folly", + "", + "With fools and children, good discretion bears;", + "Then, honest people, bear with Love and me,", + "Nor older yet, nor wiser made by years,", + "Amongst the rest of fools and children be;", + "Love, still a baby, plays with gauds and toys,", + "And, like a wanton, sports with every feather,", + "And idiots still are running after boys,", + "Then fools and children fitt'st to go together.", + "He still as young as when he first was born,", + "No wiser I than when as young as he;", + "You that behold us, laugh us not to scorn;", + "Give Nature thanks you are not such as we.", + "Yet fools and children sometimes tell in play", + "Some, wise in show, more fools indeed than they." + ], + "linecount": "15" + } ] ``` @@ -102,17 +102,17 @@ presented by the API. For the actual poem content, we need to loop over each line in the `lines` variable since each line is a separate string by default. -> You *could* also extract the title or author and make another call out to the +> You _could_ also extract the title or author and make another call out to the > API to avoid having to build the plaintext poem with a loop, but it just -> doesn't make sense to me to send multiple requests when we can create a -> simple loop on our local machine to work with the data we already have. +> doesn't make sense to me to send multiple requests when we can create a simple +> loop on our local machine to work with the data we already have. > > For > [example](https://poetrydb.org/title/Sonnet%20XXII:%20With%20Fools%20and%20Children/lines.text), -> look at the raw data response of this link to see the poem's lines returned -> in plaintext. +> look at the raw data response of this link to see the poem's lines returned in +> plaintext. -``` python +```python title = json_data[0]['title'] author = json_data[0]['author'] line_count = json_data[0]['linecount'] @@ -130,7 +130,7 @@ For my daily email, I want to see the title of the poem first, followed by the author, then a blank line, and finally the full poem. This code snippet combines that data and packages it into a MIMEText container, ready to be emailed. -``` python +```python msg_body = title + "\n" + author + "\n\n" + lines msg = MIMEText(msg_body) ``` @@ -138,7 +138,7 @@ msg = MIMEText(msg_body) Before we send the email, we need to prepare the metadata (subject, from, to, etc.): -``` python +```python sender_email = 'example@server.local' recipient_emails = ['user@example.com'] msg['Subject'] = 'Your Daily Poem (' + line_count + ' lines)' @@ -152,7 +152,7 @@ Now that I have everything ready to be emailed, the last step is to simply connect to an SMTP server and send the email out to the recipients. In my case, I installed `mailutils` on Ubuntu and let my SMTP server be `localhost`. -``` python +```python smtp_server = 'localhost' s = smtplib.SMTP(smtp_server) s.sendmail(sender_email, recipient_emails, msg.as_string()) @@ -164,7 +164,7 @@ s.quit() Instead of including a screenshot, I've copied the contents of the email that was delivered to my inbox below since I set this process up in plaintext format. -``` txt +```txt Date: Wed, 22 Jun 2022 14:37:19 +0000 (UTC) From: REDACTED To: REDACTED @@ -206,7 +206,7 @@ In the file, simply paste the following snippet at the bottom of the file and ensure that the file path is correctly pointing to wherever you saved your Python script: -``` config +```config 0 8 ** ** ** python3 /home/<your_user>/dailypoem/main.py ``` |