From 8ca8a5f7e5c5026f717e05a10cec000f6f26b7a8 Mon Sep 17 00:00:00 2001 From: Sarah Doire Date: Thu, 6 Oct 2022 13:06:50 -0500 Subject: [PATCH] feat: add postlight.com custom extractor (#695) --- .gitignore | 2 + dist/mercury.js | 32 +- fixtures/postlight.com/1664999338243.html | 650 ++++++++++++++++++ src/extractors/custom/index.js | 1 + src/extractors/custom/postlight.com/index.js | 36 + .../custom/postlight.com/index.test.js | 111 +++ 6 files changed, 831 insertions(+), 1 deletion(-) create mode 100644 fixtures/postlight.com/1664999338243.html create mode 100644 src/extractors/custom/postlight.com/index.js create mode 100644 src/extractors/custom/postlight.com/index.test.js diff --git a/.gitignore b/.gitignore index f2984975..b839f4a6 100644 --- a/.gitignore +++ b/.gitignore @@ -11,3 +11,5 @@ dist/mercury_test.js.map dist/mercury_test.web.js tmp/artifacts test-output.json +.tool-versions +.yarnrc.yml diff --git a/dist/mercury.js b/dist/mercury.js index 75df72d6..8ca35c9d 100644 --- a/dist/mercury.js +++ b/dist/mercury.js @@ -6139,6 +6139,35 @@ var SpektrumExtractor = { } }; +var PostlightComExtractor = { + domain: 'postlight.com', + title: { + selectors: [['meta[name="og:title"]', 'value']] + }, + author: { + selectors: [['meta[name="parsely-author"]', 'value']] + }, + date_published: { + selectors: [['meta[name="article:published_time"]', 'value']] + }, + dek: { + selectors: ['h2.single-hero__abstract'] + }, + lead_image_url: { + selectors: [['meta[name="og:image"]', 'value']] + }, + content: { + selectors: ['article.body'], + // Is there anything in the content you selected that needs transformed + // before it's consumable content? E.g., unusual lazy loaded images + transforms: {}, + // Is there anything that is in the result that shouldn't be? + // The clean selectors will remove anything that matches from + // the result + clean: ['section.pl-post-link'] + } +}; + var CustomExtractors = /*#__PURE__*/Object.freeze({ @@ -6285,7 +6314,8 @@ var CustomExtractors = /*#__PURE__*/Object.freeze({ WwwEngadgetComExtractor: WwwEngadgetComExtractor, ArstechnicaComExtractor: ArstechnicaComExtractor, WwwNdtvComExtractor: WwwNdtvComExtractor, - SpektrumExtractor: SpektrumExtractor + SpektrumExtractor: SpektrumExtractor, + PostlightComExtractor: PostlightComExtractor }); var Extractors = _Object$keys(CustomExtractors).reduce(function (acc, key) { diff --git a/fixtures/postlight.com/1664999338243.html b/fixtures/postlight.com/1664999338243.html new file mode 100644 index 00000000..35cd6f8a --- /dev/null +++ b/fixtures/postlight.com/1664999338243.html @@ -0,0 +1,650 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Three Ways to Be the Thermostat — Postlight — Digital Strategy, Design and Engineering + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ + + + + + + + Get in touch +
+
+
+
+ +
+
+

Digital Transformation? In This Economy? Join Postlight on 10/20 for a panel discussion on Digital Strategy. RSVP.

+
+
+
+
+ +
+
+ +
+
+
+
+
Leadership
+

+ Three Ways to Be the Thermostat

+

+ Great leaders set the temperature, especially when stress is high.

+
+
+
Gina TrapaniCEO
+ +
+
+
+
+
+
+ A woman standing in front of an orange background with her eyes closed and hands outspread looking at an office room of people within a blue background.
+ Image: Brian Weaver +
+
+
+
+
+
+ +

One of the best pieces of advice I’ve ever received is: “Be the thermostat, not the thermometer.” A thermometer reads the temperature in a room and merely reflects it back. A thermostat reads the temperature in a room and then regulates it by turning up the heat or cooling it down.

+ + + +

In a work context, the temperature can be: levels of stress and anxiety, engagement, sense of urgency, or velocity of your team. As a leader, it’s not enough to just be able to read that temperature and reflect it back. It’s up to you to regulate it through your words, actions, and example — to bring it up or bring it down, given where your team needs to go. 

+ + + +

Once you start thinking about leaders participating in team dynamics as thermometers versus thermostats, you can’t unsee it. When I observe leaders read a team’s state and then purposefully turn up the heat or cool it down, I think, “Now, there’s a thermostat at work.”

+ + + +

Here are three ways to be the thermostat with your team.

+ + + +

1. Normalize challenges.

+ + + +

Things go wrong, and that’s to be expected. When a team, especially one with inexperienced members, is dealing with a setback or an unexpected challenge, worry, concern, or panic can set in. When emotions are high, thinking isn’t clear and planning can go off the rails. It’s harder to be functional in the face of anxiety.

+ + + +

The thermostat in the room sees and communicates the following: 

+ + + +
  • Unexpected problems are par for the course. 
  • Everyone goes through them, and there’s not much new under the sun. 
  • This same exact challenge has happened before; therefore, we can handle it again. 
+ + + +

It’s usually the more experienced folks who have seen the situation before, and therefore can show up calmly and easily say, “Yeah, this isn’t surprising. Here are a few approaches we can use to figure out what to do next.”

+ + + +

I’ve seen shoulders lower when they hear, “Oh this, this has happened before, and here’s how we handled it. This is just a bump in the road and we’ll get through it.” Normalizing challenges is a very powerful way to take down stress and make even the stickiest situations feel more tractable.

+ + +
+
+ +
+
+
+
+
+
+
Leadership
+

Dear Optimistic Leaders: Make Paranoid Plans

+

Great plans account for when things don’t go according to plan.

+
+
+ +
+
+ + + +

2. Frame the problem.

+ + + +

When a team is facing a challenge with multiple factors, when lots of elements are out of their control and there is a domino effect of scary dependencies, it’s a natural human thing to feel like everything’s falling apart — and to react with stress and anxiety. 

+ + + +

“It’s all going to hell!” 

+ + + +

“We are totally screwed.” 

+ + + +

This is when it’s time to isolate and frame the problem around the things you can do.

+ + + +

Recently I’ve been enjoying Apple TV+’s For All Mankind, a soap opera involving space travel. In an episode deep into season three (no spoilers!), NASA scientists are gathered around a conference table in Houston and absolutely freaking out. Astronauts are in danger, their oxygen is running out, and there’s no workable rescue plan. When one of the leaders, Dev, proposes a plan, the reaction is immediate and fierce: It’s too dangerous! They will die if we miscalculate by even one meter! With everyone looking at him with wide eyes, Dev says calmly, “My friends, these are engineering problems. And we are engineers. Shall we begin?” And everyone gets to work.

+ + + +
+ +
+ + + +

When you can break a big challenge into its smaller parts, identifying the parts you can control and framing the challenge in front of the team as exactly what they’re able to do, a thermostat takes in the heat and turns it into action.

+ + + +

3. Put a clear plan forward.

+ + + +

“I don’t even know where to start.” 

+ + + +

When a team or a person is overwhelmed by a big challenge and can’t see the path forward, a thermostat starts drawing the map. They say: “Okay, we’re going to chip away at this step by step. Here’s step 1, here’s step 2, and here’s step 3. Let’s start there, and regroup tomorrow.” 

+ + + +

A clear plan channels everyone’s energy into action and staves off paralysis. Doing something that’s part of a clear plan calms the room and brings purpose and momentum in a time of overwhelm. Clarity around what happens next brings everyone’s stress levels down.

+ + + +

Be the thermostat

+ + + +

Becoming a thermostat takes practice. Team dynamics and emotions are contagious, so it’s easy to reflect back what the group is feeling but it can be harder to regulate it. However, once you start to observe the temperature of a room, and see how it’s not serving the group, you’ll realize you want to change it and you can — and you’ll appreciate the leaders who do.

+ + + +

Gina Trapani (she/her) is CEO at Postlight. Send her a note at gina.trapani@postlight.com or follow her on Twitter.

+ + + +

Gina learned about the thermostat concept from Michael Hyatt on this podcast.

+
+
+ +
+
+

+ Story published on Oct 5, 2022. +

+ +
+
+
+ + + + + +
+
+

Our Work

+ +
+
+
+ + + + + + + + + + + + + + diff --git a/src/extractors/custom/index.js b/src/extractors/custom/index.js index 0fe77004..b91c2429 100644 --- a/src/extractors/custom/index.js +++ b/src/extractors/custom/index.js @@ -142,3 +142,4 @@ export * from './www.engadget.com'; export * from './arstechnica.com'; export * from './www.ndtv.com'; export * from './www.spektrum.de'; +export * from './postlight.com'; diff --git a/src/extractors/custom/postlight.com/index.js b/src/extractors/custom/postlight.com/index.js new file mode 100644 index 00000000..df7145f6 --- /dev/null +++ b/src/extractors/custom/postlight.com/index.js @@ -0,0 +1,36 @@ +export const PostlightComExtractor = { + domain: 'postlight.com', + + title: { + selectors: [['meta[name="og:title"]', 'value']], + }, + + author: { + selectors: [['meta[name="parsely-author"]', 'value']], + }, + + date_published: { + selectors: [['meta[name="article:published_time"]', 'value']], + }, + + dek: { + selectors: ['h2.single-hero__abstract'], + }, + + lead_image_url: { + selectors: [['meta[name="og:image"]', 'value']], + }, + + content: { + selectors: ['article.body'], + + // Is there anything in the content you selected that needs transformed + // before it's consumable content? E.g., unusual lazy loaded images + transforms: {}, + + // Is there anything that is in the result that shouldn't be? + // The clean selectors will remove anything that matches from + // the result + clean: ['section.pl-post-link'], + }, +}; diff --git a/src/extractors/custom/postlight.com/index.test.js b/src/extractors/custom/postlight.com/index.test.js new file mode 100644 index 00000000..8be71563 --- /dev/null +++ b/src/extractors/custom/postlight.com/index.test.js @@ -0,0 +1,111 @@ +import assert from 'assert'; +import URL from 'url'; +import cheerio from 'cheerio'; + +import Mercury from 'mercury'; +import getExtractor from 'extractors/get-extractor'; +import { excerptContent } from 'utils/text'; + +const fs = require('fs'); + +describe('PostlightComExtractor', () => { + describe('initial test case', () => { + let result; + let url; + beforeAll(() => { + url = 'https://postlight.com/insights/three-ways-to-be-the-thermostat'; + const html = fs.readFileSync( + './fixtures/postlight.com/1664999338243.html' + ); + result = Mercury.parse(url, { html, fallback: false }); + }); + + it('is selected properly', () => { + // This test should be passing by default. + // It sanity checks that the correct parser + // is being selected for URLs from this domain + const extractor = getExtractor(url); + assert.equal(extractor.domain, URL.parse(url).hostname); + }); + + it('returns the title', async () => { + // To pass this test, fill out the title selector + // in ./src/extractors/custom/postlight.com/index.js. + const { title } = await result; + + // Update these values with the expected values from + // the article. + assert.equal(title, `Three Ways to Be the Thermostat`); + }); + + it('returns the author', async () => { + // To pass this test, fill out the author selector + // in ./src/extractors/custom/postlight.com/index.js. + const { author } = await result; + + // Update these values with the expected values from + // the article. + assert.equal(author, 'Gina Trapani'); + }); + + it('returns the date_published', async () => { + // To pass this test, fill out the date_published selector + // in ./src/extractors/custom/postlight.com/index.js. + const { date_published } = await result; + + // Update these values with the expected values from + // the article. + assert.equal(date_published, `2022-10-05T16:00:00.000Z`); + }); + + it('returns the dek', async () => { + // To pass this test, fill out the dek selector + // in ./src/extractors/custom/postlight.com/index.js. + const { dek } = await result; + + // Update these values with the expected values from + // the article. + assert.equal( + dek, + 'Great leaders set the temperature, especially when stress is high.' + ); + }); + + it('returns the lead_image_url', async () => { + // To pass this test, fill out the lead_image_url selector + // in ./src/extractors/custom/postlight.com/index.js. + const { lead_image_url } = await result; + + // Update these values with the expected values from + // the article. + assert.equal( + lead_image_url, + `https://postlight.com/wp-content/uploads/2022/09/Be-The-Thermostat-1200-1.png?fit=1200%2C675` + ); + }); + + it('returns the content', async () => { + // To pass this test, fill out the content selector + // in ./src/extractors/custom/postlight.com/index.js. + // You may also want to make use of the clean and transform + // options. + const { content } = await result; + + const $ = cheerio.load(content || ''); + + const first13 = excerptContent( + $('*') + .first() + .text(), + 13 + ); + + // Update these values with the expected values from + // the article. + assert.equal( + first13, + 'One of the best pieces of advice I’ve ever received is: “Be the' + ); + }); + }); +});