initial commit

Author: erikaheidi

Command/Help/DefaultController.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace librarianphp\Import;
+
+use Minicli\Command\CommandController;
+
+class DefaultController extends CommandController
+{
+    public function handle(): void
+    {
+        $this->getPrinter()->info("Import posts from DEV.", true);
+        $this->getPrinter()->info("./librarian import devto");
+    }
+}

Command/Import/DefaultController.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace librarianphp\Import;
+
+use Librarian\Exception\ApiException;
+use Provider\DevtoServiceProvider;
+use Minicli\Command\CommandController;
+
+class DevController extends CommandController
+{
+    public function handle(): void
+    {
+        /** @var DevtoServiceProvider $devto */
+        $devto = $this->getApp()->devto;
+        $app_debug = $this->getApp()->config->app_debug;
+
+        if ($devto === null) {
+            if ($app_debug) {
+                $this->getPrinter()->error('ERROR: dev.to service not found. Perhaps you forgot to register it?');
+            }
+            exit;
+        }
+
+        if (!$this->getApp()->config->devto_username) {
+            if ($app_debug) {
+                $this->getPrinter()->error(
+                    "ERROR: dev.to username not set.\n" .
+                "You must define a devto_username in your config file\n" .
+                "if you want to import posts from that platform."
+                );
+            }
+            exit;
+        }
+
+        $this->getPrinter()->info("Starting import... this might take a few minutes.");
+
+        try {
+            $devto->fetchAll();
+        } catch (ApiException $e) {
+            $this->getPrinter()->error($e->getMessage());
+        }
+
+        $this->getPrinter()->success("Import Finished.");
+    }
+}

Command/Import/DevController.php

@@ -0,0 +1,82 @@
+<?php
+
+namespace Provider;
+
+use Librarian\Content;
+use Librarian\Exception\ApiException;
+use Librarian\Exception\MissingConfigException;
+use Minicli\App;
+use Minicli\ServiceInterface;
+use Minicli\Curly\Client;
+
+class DevtoServiceProvider implements ServiceInterface
+{
+    /** @var string Dev.to username to pull articles from */
+    protected string $username;
+
+    /** @var string local path to save static markdown files from dev.to content */
+    protected string $data_path;
+
+    public static string $API_ARTICLES_ENDPOINT = 'https://dev.to/api/articles';
+
+    /**
+     * @param App $app
+     * @throws MissingConfigException
+     */
+    public function load(App $app): void
+    {
+        if (!$app->config->has('devto_username')) {
+            throw new MissingConfigException('devto_username config not found.');
+        }
+
+        if (!$app->config->has('devto_datadir')) {
+            throw new MissingConfigException('devto_datadir config not found.');
+        }
+
+        if (!$app->config->has('data_path')) {
+            throw new MissingConfigException('data_path config not found.');
+        }
+
+        $this->username = $app->config->devto_username;
+        $this->data_path = $app->config->data_path . '/' . $app->config->devto_datadir;
+    }
+
+    /**
+     * Fetches the latest dev.to articles and save them to local data dir as .md files.
+     * Warning: Existing content will be overwritten.
+     * @throws ApiException
+     */
+    public function fetchAll(): void
+    {
+        $crawler = new Client();
+
+        $articles_response = $crawler->get(self::$API_ARTICLES_ENDPOINT . '?username=' . $this->username);
+
+        if ($articles_response['code'] !== 200) {
+            throw new ApiException('Error while contacting the dev.to API.');
+        }
+
+        $articles = json_decode($articles_response['body'], true);
+
+        foreach ($articles as $article) {
+            $full_article_response = $crawler->get(self::$API_ARTICLES_ENDPOINT . '/' . $article['id']);
+
+            if ($full_article_response['code'] !== 200) {
+                throw new ApiException('Error while contacting the dev.to API.');
+            }
+
+            $full_article = json_decode($full_article_response['body'], true);
+
+            try {
+                $published = new \DateTime($full_article['published_timestamp']);
+            } catch (\Exception $e) {
+                $published = new \DateTime();
+            }
+
+            $date = $published->format('Ymd');
+
+            $content = new Content($full_article['body_markdown']);
+            $content->save($this->data_path . '/' . $date . '_' . $full_article['slug'] . '.md');
+        }
+    }
+}

Provider/DevtoServiceProvider.php

@@ -1,7 +1,7 @@
-# command-help
+# command-import
 
-Librarian's built-in help command.
+Librarian's built-in import command.
 
 ```shell
-./librarian help
+./librarian import dev
 ```

README.md

@@ -1,16 +1,33 @@
 {
-    "name": "librarianphp/command-help",
+    "name": "librarianphp/command-import",
     "type": "library",
-    "description": "Librarian's built-in help command",
+    "description": "Librarian's built-in import command",
     "license": "MIT",
-    "homepage": "https://github.com/librarianphp/command-demo",
-    "keywords": ["cli","command-line", "markdown"],
+    "homepage": "https://github.com/librarianphp/command-import",
+    "keywords": ["cli","command-line", "markdown", "devto"],
     "autoload": {
         "psr-4": {
-            "librarianphp\\": "Command/"
+            "librarianphp\\": "Command/",
+            "Provider\\": "Provider/"
         }
     },
     "require": {
-        "minicli/minicli": "^3.0"
+        "minicli/minicli": "^3.2.1",
+        "minicli/curly": "^0.2.2",
+        "librarianphp/librarian-core": "^3.1"
+    },
+    "require-dev": {
+        "pestphp/pest": "^2.5",
+        "friendsofphp/php-cs-fixer": "^3.16",
+        "mockery/mockery": "^1.5"
+    },
+    "scripts": {
+        "test" : ["pest"],
+        "csfix": ["php-cs-fixer fix"]
+    },
+    "config": {
+        "allow-plugins": {
+            "pestphp/pest-plugin": true
+        }
     }
 }