Added API

Author: GrahamCampbell

.env.example

@@ -0,0 +1,10 @@
+APP_ENV=production
+APP_DEBUG=false
+APP_KEY=SomeRandomKey
+
+CACHE_DRIVER=array
+SESSION_DRIVER=array
+QUEUE_DRIVER=sync
+
+CAT_GEN=path
+DOGE_GEN=path

.gitattributes

@@ -0,0 +1,8 @@
+* text=auto
+
+/tests export-ignore
+/.gitattributes export-ignore
+/.gitignore export-ignore
+/.travis.yml export-ignore
+/phpunit.xml.dist export-ignore
+/README.md export-ignore

.gitignore

@@ -0,0 +1,3 @@
+.env
+phpunit.xml
+vendor

.travis.yml

@@ -0,0 +1,10 @@
+language: php
+
+php:
+  - 7.0
+
+sudo: false
+
+install:  travis_retry composer install --no-interaction --prefer-source
+
+script: vendor/bin/phpunit

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Graham Campbell <[email protected]>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -0,0 +1 @@
+# SERVER

app/AppServiceProvider.php

@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App;
+
+use App\Generators\CatGenerator;
+use App\Generators\DogeGenerator;
+use App\Generators\ProcessRunner;
+use Illuminate\Contracts\Container\Container;
+use Illuminate\Support\ServiceProvider;
+
+/**
+ * This is the app service provider.
+ *
+ * @author Graham Campbell <[email protected]>
+ */
+class AppServiceProvider extends ServiceProvider
+{
+    /**
+     * Register the service provider.
+     *
+     * @return void
+     */
+    public function register()
+    {
+        $this->app->singleton(ProcessRunner::class, function () {
+            return new ProcessRunner();
+        });
+
+        $this->app->singleton(CatGenerator::class, function (Container $app) {
+            return new CatGenerator(
+                $app->make(ProcessRunner::class),
+                $app->config->get('services.meme.cat'),
+                $app->basePath('resources/img'),
+                $app->basePath('public/result')
+            );
+        });
+
+        $this->app->singleton(DogeGenerator::class, function (Container $app) {
+            return new DogeGenerator(
+                $app->make(ProcessRunner::class),
+                $app->config->get('services.meme.doge'),
+                $app->basePath('public/result')
+            );
+        });
+
+        $this->app->get('/', 'App\Controllers\MainController@show');
+
+        $this->app->post('cat', 'App\Controllers\MainController@cat');
+
+        $this->app->post('dodge', 'App\Controllers\MainController@doge');
+    }
+}

app/Controllers/MainController.php

@@ -0,0 +1,96 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Controllers;
+
+use App\Generators\CatGenerator;
+use App\Generators\DogeGenerator;
+use App\Generators\GeneratorInterface;
+use App\Generators\MultiGenerator;
+use App\Generators\ValidatingGenerator;
+use Illuminate\Contracts\Container\Container;
+use Illuminate\Contracts\View\Factory;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Laravel\Lumen\Routing\Controller;
+
+/**
+ * This is the main controller class.
+ *
+ * @author Graham Campbell <[email protected]>
+ */
+class MainController extends Controller
+{
+    /**
+     * Show the welcome message.
+     *
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function show()
+    {
+        return new JsonResponse([
+            'meta' => ['message' => 'Very image. Much server.'],
+        ]);
+    }
+
+    /**
+     * Generate cat memes.
+     *
+     * @param \Illuminate\Contracts\Container\Container $container
+     * @param \Illuminate\Http\Request                  $request
+     *
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function cat(Container $container, Request $request)
+    {
+        $inner = $container->make(CatGenerator::class);
+        $text = $request->get('text');
+        $quantity = $request->get('quantity', 1);
+
+        return $this->generate($inner, (string) $text, (int) $quantity);
+    }
+
+    /**
+     * Generate dodge memes.
+     *
+     * @param \Illuminate\Contracts\Container\Container $container
+     * @param \Illuminate\Http\Request                  $request
+     *
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function dodge(Container $container, Request $request)
+    {
+        $inner = $container->make(DogeGenerator::class);
+        $text = $request->get('text');
+        $quantity = $request->get('quantity', 1);
+
+        return $this->generate($inner, (string) $text, (int) $quantity);
+    }
+
+    /**
+     * Generate the memes.
+     *
+     * @param \App\Generators\GeneratorInterface $inner
+     * @param string                             $text
+     * @param int                                $quantity
+     *
+     * @return \Illuminate\Http\JsonResponse
+     */
+    protected function generate(GeneratorInterface $inner, string $text, int $quantity = 1)
+    {
+        $generator = new ValidatingGenerator(new MultiGenerator($inner, $quantity));
+
+        $images = [];
+
+        foreach ($generator->start($text)->wait() as $image) {
+            $images[] = "https://api.memetrash.co.uk/result/{$image}.jpg";
+        }
+
+        return new JsonResponse([
+            'success' => ['message' => 'Here are your memes!'],
+            'data'    => ['images' => $images],
+        ]);
+    }
+}

app/Generators/CatGenerator.php

@@ -0,0 +1,84 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Generators;
+
+/**
+ * This is the cat meme generator class.
+ *
+ * @author Graham Campbell <[email protected]>
+ */
+class CatGenerator implements GeneratorInterface
+{
+    /**
+     * The runner instance.
+     *
+     * @var \App\Generator\ProcessRunner
+     */
+    protected $runner;
+
+    /**
+     * The generator path.
+     *
+     * @var string
+     */
+    protected $generator;
+
+    /**
+     * The resources path.
+     *
+     * @var string
+     */
+    protected $resources;
+
+    /**
+     * The output path.
+     *
+     * @var string
+     */
+    protected $output;
+
+    /**
+     * Create a new cat meme generator instance.
+     *
+     * @param \App\Generator\ProcessRunner $runner
+     * @param string                       $generator
+     * @param string                       $resources
+     * @param string                       $output
+     *
+     * @return void
+     */
+    public function __construct(ProcessRunner $runner, string $generator, string $resources, string $output)
+    {
+        $this->runner = $runner;
+        $this->generator = $generator;
+        $this->resources = $resources;
+        $this->output = $output;
+    }
+
+    /**
+     * Start the meme generation.
+     *
+     * @param string $text
+     *
+     * @throws \App\Generators\ExceptionInterface
+     *
+     * @return \App\Generators\Promise
+     */
+    public function start(string $text)
+    {
+        $name = str_random(16);
+        $image = random_int(1, 70);
+
+        $command = "python {$this->generator}/run.py \"{$this->resources}/{$image}.jpg\" \"{$this->output}/{$name}.jpg\" \"{$this->generator}/resources\" \"{$text}\"";
+
+        $process = $this->runner->start($command);
+
+        return new Promise(function () use ($process, $name) {
+            $process->wait();
+
+            return [$name];
+        });
+    }
+}

app/Generators/DogeGenerator.php

@@ -0,0 +1,74 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Generators;
+
+/**
+ * This is the doge meme generator class.
+ *
+ * @author Graham Campbell <[email protected]>
+ */
+class DogeGenerator implements GeneratorInterface
+{
+    /**
+     * The runner instance.
+     *
+     * @var \App\Generator\ProcessRunner
+     */
+    protected $runner;
+
+    /**
+     * The generator path.
+     *
+     * @var string
+     */
+    protected $generator;
+
+    /**
+     * The output path.
+     *
+     * @var string
+     */
+    protected $output;
+
+    /**
+     * Create a new doge meme generator instance.
+     *
+     * @param \App\Generator\ProcessRunner $runner
+     * @param string                       $generator
+     * @param string                       $output
+     *
+     * @return void
+     */
+    public function __construct(ProcessRunner $runner, string $generator, string $output)
+    {
+        $this->runner = $runner;
+        $this->generator = $generator;
+        $this->output = $output;
+    }
+
+    /**
+     * Start the meme generation.
+     *
+     * @param string $text
+     *
+     * @throws \App\Generators\ExceptionInterface
+     *
+     * @return \App\Generators\Promise
+     */
+    public function start(string $text)
+    {
+        $name = str_random(16);
+
+        $command = "python {$this->generator}/run.py \"{$text}\" \"{$this->output}/{$name}.jpg\" \"{$this->generator}/resources\" 6";
+
+        $process = $this->runner->start($command);
+
+        return new Promise(function () use ($process, $name) {
+            $process->wait();
+
+            return [$name];
+        });
+    }
+}

app/Generators/ExceptionInterface.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Generators;
+
+/**
+ * This is the generator exception interface.
+ *
+ * @author Graham Campbell <[email protected]>
+ */
+interface ExceptionInterface
+{
+    //
+}