Add command to post to twitter

Author: joedixon

app/Console/Commands/PostArticleToTwitter.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Models\Article;
+use Illuminate\Console\Command;
+use Illuminate\Notifications\AnonymousNotifiable;
+use App\Notifications\PostArticleToTwitter as PostArticleToTwitterNotification;
+
+final class PostArticleToTwitter extends Command
+{
+    protected $signature = 'post-article-to-twitter';
+
+    protected $description = 'Posts the latest unshared article to Twitter';
+
+    private $notifiable;
+
+    public function __construct(AnonymousNotifiable $notifiable)
+    {
+        parent::__construct();
+        $this->notifiable = $notifiable;
+    }
+
+    public function handle()
+    {
+        if (! $article = Article::nextForSharing()) {
+            return;
+        }
+
+        $this->notifiable->notify(new PostArticleToTwitterNotification($article));
+
+        $article->markAsShared();
+    }
+}

app/Console/Kernel.php

@@ -23,6 +23,12 @@ protected function schedule(Schedule $schedule)
         $schedule->command('backup:clean')->daily()->at('01:00');
         $schedule->command('backup:run')->daily()->at('02:00');
         $schedule->command('horizon:snapshot')->everyFiveMinutes();
+        $schedule->command('post-article-to-twitter')
+            ->everyMinute()
+            ->when(function () {
+                // ~2 posts every 24 hours.
+                return random_int(1, 1440) <= 2;
+            });
     }
 
     /**

app/Models/Article.php

@@ -35,6 +35,7 @@ final class Article extends Model
         'is_pinned',
         'submitted_at',
         'approved_at',
+        'shared_at',
     ];
 
     /**
@@ -43,6 +44,7 @@ final class Article extends Model
     protected $dates = [
         'submitted_at',
         'approved_at',
+        'shared_at',
     ];
 
     public function id(): int
@@ -82,7 +84,7 @@ public function series()
 
     public function updateSeries(Series $series = null): self
     {
-        if (is_null($series)) {
+        if (null === $series) {
             return $this->removeSeries();
         }
 
@@ -122,7 +124,7 @@ public function isSubmitted(): bool
 
     public function isNotSubmitted(): bool
     {
-        return is_null($this->submitted_at);
+        return null === $this->submitted_at;
     }
 
     public function isApproved(): bool
@@ -132,7 +134,7 @@ public function isApproved(): bool
 
     public function isNotApproved(): bool
     {
-        return is_null($this->approved_at);
+        return null === $this->approved_at;
     }
 
     public function isPublished(): bool
@@ -150,6 +152,16 @@ public function isPinned(): bool
         return (bool) $this->is_pinned;
     }
 
+    public function isNotShared(): bool
+    {
+        return null === $this->shared_at;
+    }
+
+    public function isShared(): bool
+    {
+        return ! $this->isNotShared();
+    }
+
     public function isAwaitingApproval(): bool
     {
         return $this->isSubmitted() && $this->isNotApproved();
@@ -202,6 +214,16 @@ public function scopeNotPublished(Builder $query): Builder
         });
     }
 
+    public function scopeShared(Builder $query): Builder
+    {
+        return $query->whereNotNull('shared_at');
+    }
+
+    public function scopeNotShared(Builder $query): Builder
+    {
+        return $query->whereNull('shared_at');
+    }
+
     public function scopeForTag(Builder $query, string $tag): Builder
     {
         return $query->whereHas('tagsRelation', function ($query) use ($tag) {
@@ -270,4 +292,19 @@ public function splitBody($value)
     {
         return $this->split($value);
     }
+
+    public function markAsShared()
+    {
+        $this->update([
+            'shared_at' => now(),
+        ]);
+    }
+
+    public static function nextForSharing(): ?self
+    {
+        return self::notShared()
+            ->published()
+            ->orderBy('submitted_at', 'asc')
+            ->first();
+    }
 }

app/Notifications/PostArticleToTwitter.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Notifications;
+
+use App\Models\Article;
+use Illuminate\Bus\Queueable;
+use Illuminate\Notifications\Notification;
+use NotificationChannels\Twitter\TwitterChannel;
+use NotificationChannels\Twitter\TwitterStatusUpdate;
+
+class PostArticleToTwitter extends Notification
+{
+    use Queueable;
+
+    private $article;
+
+    public function __construct(Article $article)
+    {
+        $this->article = $article;
+    }
+
+    public function via($notifiable)
+    {
+        return [TwitterChannel::class];
+    }
+
+    public function toTwitter($notifiable)
+    {
+        $title = $this->article->title();
+        $url = route('articles.show', $this->article->slug());
+        $author = $this->article->author()->name();
+
+        return new TwitterStatusUpdate("{$title} - {$author}\n\n{$url}");
+    }
+}

database/migrations/2020_07_16_185353_update_articles_table_add_shared_at_field.php

@@ -0,0 +1,15 @@
+<?php
+
+use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
+
+class UpdateArticlesTableAddSharedAtField extends Migration
+{
+    public function up()
+    {
+        Schema::table('articles', function (Blueprint $table) {
+            $table->dateTime('shared_at')->after('approved_at')->nullable();
+        });
+    }
+}

tests/Unit/Commands/PostArticleToTwitterTest.php

@@ -0,0 +1,76 @@
+<?php
+
+namespace Tests\Unit\Commands;
+
+use Tests\TestCase;
+use App\Models\Article;
+use Illuminate\Support\Facades\Notification;
+use App\Console\Commands\PostArticleToTwitter;
+use Illuminate\Notifications\AnonymousNotifiable;
+use Illuminate\Foundation\Testing\DatabaseMigrations;
+use App\Notifications\PostArticleToTwitter as PostArticleToTwitterNotification;
+
+class PostArticleToTwitterTest extends TestCase
+{
+    use DatabaseMigrations;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        Notification::fake();
+    }
+
+    /** @test */
+    public function published_articles_can_be_shared_on_twitter()
+    {
+        $article = factory(Article::class)->create([
+            'submitted_at' => now(),
+            'approved_at' => now(),
+        ]);
+
+        (new PostArticleToTwitter(new AnonymousNotifiable()))->handle();
+
+        Notification::assertSentTo(
+            new AnonymousNotifiable,
+            PostArticleToTwitterNotification::class
+        );
+
+        $this->assertTrue($article->fresh()->isShared());
+    }
+
+    /** @test */
+    public function already_shared_articles_are_not_shared_again()
+    {
+        factory(Article::class)->create([
+            'submitted_at' => now(),
+            'approved_at' => now(),
+            'shared_at' => now(),
+        ]);
+
+        (new PostArticleToTwitter(new AnonymousNotifiable()))->handle();
+
+        Notification::assertNothingSent();
+    }
+
+    /** @test */
+    public function unapproved_articles_are_not_shared()
+    {
+        factory(Article::class)->create([
+            'submitted_at' => now(),
+        ]);
+
+        (new PostArticleToTwitter(new AnonymousNotifiable()))->handle();
+
+        Notification::assertNothingSent();
+    }
+
+    /** @test */
+    public function unsubmitted_articles_are_not_shared()
+    {
+        factory(Article::class)->create();
+
+        (new PostArticleToTwitter(new AnonymousNotifiable()))->handle();
+
+        Notification::assertNothingSent();
+    }
+}