:construction: merge protocol files

rpc/tutorials/php/.gitignore

@@ -2,8 +2,5 @@
 /morus-client.json
 /queue.json
 
-/GPBMetadata/
-/Palm/
-
 /composer.lock
 /vendor/

rpc/tutorials/php/GPBMetadata/Morus.php

@@ -0,0 +1,25 @@
+<?php
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: morus.proto
+
+namespace GPBMetadata;
+
+class Morus
+{
+    public static $is_initialized = false;
+
+    public static function initOnce() {
+        $pool = \Google\Protobuf\Internal\DescriptorPool::getGeneratedPool();
+
+        if (static::$is_initialized == true) {
+          return;
+        }
+        $pool->internalAddGeneratedFile(
+            "\x0A\xD6\x02\x0A\x0Bmorus.proto\x12\x0Dpalm.morus.v1\":\x0A\x15MarkdownToHtmlRequest\x12\x0F\x0A\x07payload\x18\x01 \x01(\x09\x12\x10\x0A\x08sanitize\x18\x02 \x01(\x08\")\x0A\x16MarkdownToHtmlResponse\x12\x0F\x0A\x07payload\x18\x01 \x01(\x092c\x0A\x08Markdown\x12W\x0A\x06ToHtml\x12\$.palm.morus.v1.MarkdownToHtmlRequest\x1A%.palm.morus.v1.MarkdownToHtmlResponse\"\x00Bd\x0A+com.github.saturn_xiv.palm.plugins.morus.v1P\x01Z3github.com/saturn-xiv/palm/atropa/morus/services/v2b\x06proto3"
+        , true);
+
+        static::$is_initialized = true;
+    }
+}
+

rpc/tutorials/php/Palm/Lily/V1/Article.php

@@ -0,0 +1,32 @@
+<?php
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: lily.proto
+
+namespace Palm\Lily\V1;
+
+use Google\Protobuf\Internal\GPBType;
+use Google\Protobuf\Internal\RepeatedField;
+use Google\Protobuf\Internal\GPBUtil;
+
+/**
+ * Generated from protobuf message <code>palm.lily.v1.Article</code>
+ */
+class Article extends \Google\Protobuf\Internal\Message
+{
+
+    /**
+     * Constructor.
+     *
+     * @param array $data {
+     *     Optional. Data for populating the Message object.
+     *
+     * }
+     */
+    public function __construct($data = NULL) {
+        \GPBMetadata\Lily::initOnce();
+        parent::__construct($data);
+    }
+
+}
+

rpc/tutorials/php/Palm/Lily/V1/Book.php

@@ -0,0 +1,32 @@
+<?php
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: lily.proto
+
+namespace Palm\Lily\V1;
+
+use Google\Protobuf\Internal\GPBType;
+use Google\Protobuf\Internal\RepeatedField;
+use Google\Protobuf\Internal\GPBUtil;
+
+/**
+ * Generated from protobuf message <code>palm.lily.v1.Book</code>
+ */
+class Book extends \Google\Protobuf\Internal\Message
+{
+
+    /**
+     * Constructor.
+     *
+     * @param array $data {
+     *     Optional. Data for populating the Message object.
+     *
+     * }
+     */
+    public function __construct($data = NULL) {
+        \GPBMetadata\Lily::initOnce();
+        parent::__construct($data);
+    }
+
+}
+

rpc/tutorials/php/Palm/Lily/V1/PandocTask.php

@@ -0,0 +1,108 @@
+<?php
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: lily.proto
+
+namespace Palm\Lily\V1;
+
+use Google\Protobuf\Internal\GPBType;
+use Google\Protobuf\Internal\RepeatedField;
+use Google\Protobuf\Internal\GPBUtil;
+
+/**
+ * https://pandoc.org/MANUAL.html
+ *
+ * Generated from protobuf message <code>palm.lily.v1.PandocTask</code>
+ */
+class PandocTask extends \Google\Protobuf\Internal\Message
+{
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.PandocTask.Input input = 1;</code>
+     */
+    protected $input = null;
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.PandocTask.Output output = 2;</code>
+     */
+    protected $output = null;
+
+    /**
+     * Constructor.
+     *
+     * @param array $data {
+     *     Optional. Data for populating the Message object.
+     *
+     *     @type \Palm\Lily\V1\PandocTask\Input $input
+     *     @type \Palm\Lily\V1\PandocTask\Output $output
+     * }
+     */
+    public function __construct($data = NULL) {
+        \GPBMetadata\Lily::initOnce();
+        parent::__construct($data);
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.PandocTask.Input input = 1;</code>
+     * @return \Palm\Lily\V1\PandocTask\Input|null
+     */
+    public function getInput()
+    {
+        return $this->input;
+    }
+
+    public function hasInput()
+    {
+        return isset($this->input);
+    }
+
+    public function clearInput()
+    {
+        unset($this->input);
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.PandocTask.Input input = 1;</code>
+     * @param \Palm\Lily\V1\PandocTask\Input $var
+     * @return $this
+     */
+    public function setInput($var)
+    {
+        GPBUtil::checkMessage($var, \Palm\Lily\V1\PandocTask\Input::class);
+        $this->input = $var;
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.PandocTask.Output output = 2;</code>
+     * @return \Palm\Lily\V1\PandocTask\Output|null
+     */
+    public function getOutput()
+    {
+        return $this->output;
+    }
+
+    public function hasOutput()
+    {
+        return isset($this->output);
+    }
+
+    public function clearOutput()
+    {
+        unset($this->output);
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.PandocTask.Output output = 2;</code>
+     * @param \Palm\Lily\V1\PandocTask\Output $var
+     * @return $this
+     */
+    public function setOutput($var)
+    {
+        GPBUtil::checkMessage($var, \Palm\Lily\V1\PandocTask\Output::class);
+        $this->output = $var;
+
+        return $this;
+    }
+
+}
+

rpc/tutorials/php/Palm/Lily/V1/PandocTask/Format.php

@@ -0,0 +1,59 @@
+<?php
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: lily.proto
+
+namespace Palm\Lily\V1\PandocTask;
+
+use UnexpectedValueException;
+
+/**
+ * Protobuf type <code>palm.lily.v1.PandocTask.Format</code>
+ */
+class Format
+{
+    /**
+     * Generated from protobuf enum <code>Plain = 0;</code>
+     */
+    const Plain = 0;
+    /**
+     * Generated from protobuf enum <code>Markdown = 1;</code>
+     */
+    const Markdown = 1;
+    /**
+     * Generated from protobuf enum <code>Pdf = 2;</code>
+     */
+    const Pdf = 2;
+    /**
+     * Generated from protobuf enum <code>Docx = 3;</code>
+     */
+    const Docx = 3;
+
+    private static $valueToName = [
+        self::Plain => 'Plain',
+        self::Markdown => 'Markdown',
+        self::Pdf => 'Pdf',
+        self::Docx => 'Docx',
+    ];
+
+    public static function name($value)
+    {
+        if (!isset(self::$valueToName[$value])) {
+            throw new UnexpectedValueException(sprintf(
+                    'Enum %s has no name defined for value %s', __CLASS__, $value));
+        }
+        return self::$valueToName[$value];
+    }
+
+
+    public static function value($name)
+    {
+        $const = __CLASS__ . '::' . strtoupper($name);
+        if (!defined($const)) {
+            throw new UnexpectedValueException(sprintf(
+                    'Enum %s has no value defined for name %s', __CLASS__, $name));
+        }
+        return constant($const);
+    }
+}
+

rpc/tutorials/php/Palm/Lily/V1/PandocTask/Input.php

@@ -0,0 +1,86 @@
+<?php
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: lily.proto
+
+namespace Palm\Lily\V1\PandocTask;
+
+use Google\Protobuf\Internal\GPBType;
+use Google\Protobuf\Internal\RepeatedField;
+use Google\Protobuf\Internal\GPBUtil;
+
+/**
+ * Generated from protobuf message <code>palm.lily.v1.PandocTask.Input</code>
+ */
+class Input extends \Google\Protobuf\Internal\Message
+{
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.PandocTask.Format format = 1;</code>
+     */
+    protected $format = 0;
+    /**
+     * Generated from protobuf field <code>bytes payload = 2;</code>
+     */
+    protected $payload = '';
+
+    /**
+     * Constructor.
+     *
+     * @param array $data {
+     *     Optional. Data for populating the Message object.
+     *
+     *     @type int $format
+     *     @type string $payload
+     * }
+     */
+    public function __construct($data = NULL) {
+        \GPBMetadata\Lily::initOnce();
+        parent::__construct($data);
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.PandocTask.Format format = 1;</code>
+     * @return int
+     */
+    public function getFormat()
+    {
+        return $this->format;
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.PandocTask.Format format = 1;</code>
+     * @param int $var
+     * @return $this
+     */
+    public function setFormat($var)
+    {
+        GPBUtil::checkEnum($var, \Palm\Lily\V1\PandocTask\Format::class);
+        $this->format = $var;
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>bytes payload = 2;</code>
+     * @return string
+     */
+    public function getPayload()
+    {
+        return $this->payload;
+    }
+
+    /**
+     * Generated from protobuf field <code>bytes payload = 2;</code>
+     * @param string $var
+     * @return $this
+     */
+    public function setPayload($var)
+    {
+        GPBUtil::checkString($var, False);
+        $this->payload = $var;
+
+        return $this;
+    }
+
+}
+

rpc/tutorials/php/Palm/Lily/V1/PandocTask/Output.php

@@ -0,0 +1,113 @@
+<?php
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: lily.proto
+
+namespace Palm\Lily\V1\PandocTask;
+
+use Google\Protobuf\Internal\GPBType;
+use Google\Protobuf\Internal\RepeatedField;
+use Google\Protobuf\Internal\GPBUtil;
+
+/**
+ * Generated from protobuf message <code>palm.lily.v1.PandocTask.Output</code>
+ */
+class Output extends \Google\Protobuf\Internal\Message
+{
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.PandocTask.Format format = 1;</code>
+     */
+    protected $format = 0;
+    /**
+     * Generated from protobuf field <code>string bucket = 2;</code>
+     */
+    protected $bucket = '';
+    /**
+     * Generated from protobuf field <code>string object = 3;</code>
+     */
+    protected $object = '';
+
+    /**
+     * Constructor.
+     *
+     * @param array $data {
+     *     Optional. Data for populating the Message object.
+     *
+     *     @type int $format
+     *     @type string $bucket
+     *     @type string $object
+     * }
+     */
+    public function __construct($data = NULL) {
+        \GPBMetadata\Lily::initOnce();
+        parent::__construct($data);
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.PandocTask.Format format = 1;</code>
+     * @return int
+     */
+    public function getFormat()
+    {
+        return $this->format;
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.PandocTask.Format format = 1;</code>
+     * @param int $var
+     * @return $this
+     */
+    public function setFormat($var)
+    {
+        GPBUtil::checkEnum($var, \Palm\Lily\V1\PandocTask\Format::class);
+        $this->format = $var;
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>string bucket = 2;</code>
+     * @return string
+     */
+    public function getBucket()
+    {
+        return $this->bucket;
+    }
+
+    /**
+     * Generated from protobuf field <code>string bucket = 2;</code>
+     * @param string $var
+     * @return $this
+     */
+    public function setBucket($var)
+    {
+        GPBUtil::checkString($var, True);
+        $this->bucket = $var;
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>string object = 3;</code>
+     * @return string
+     */
+    public function getObject()
+    {
+        return $this->object;
+    }
+
+    /**
+     * Generated from protobuf field <code>string object = 3;</code>
+     * @param string $var
+     * @return $this
+     */
+    public function setObject($var)
+    {
+        GPBUtil::checkString($var, True);
+        $this->object = $var;
+
+        return $this;
+    }
+
+}
+

rpc/tutorials/php/Palm/Lily/V1/Section.php

@@ -0,0 +1,59 @@
+<?php
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: lily.proto
+
+namespace Palm\Lily\V1;
+
+use Google\Protobuf\Internal\GPBType;
+use Google\Protobuf\Internal\RepeatedField;
+use Google\Protobuf\Internal\GPBUtil;
+
+/**
+ * Generated from protobuf message <code>palm.lily.v1.Section</code>
+ */
+class Section extends \Google\Protobuf\Internal\Message
+{
+    /**
+     * Generated from protobuf field <code>repeated .palm.lily.v1.Section items = 1;</code>
+     */
+    private $items;
+
+    /**
+     * Constructor.
+     *
+     * @param array $data {
+     *     Optional. Data for populating the Message object.
+     *
+     *     @type array<\Palm\Lily\V1\Section>|\Google\Protobuf\Internal\RepeatedField $items
+     * }
+     */
+    public function __construct($data = NULL) {
+        \GPBMetadata\Lily::initOnce();
+        parent::__construct($data);
+    }
+
+    /**
+     * Generated from protobuf field <code>repeated .palm.lily.v1.Section items = 1;</code>
+     * @return \Google\Protobuf\Internal\RepeatedField
+     */
+    public function getItems()
+    {
+        return $this->items;
+    }
+
+    /**
+     * Generated from protobuf field <code>repeated .palm.lily.v1.Section items = 1;</code>
+     * @param array<\Palm\Lily\V1\Section>|\Google\Protobuf\Internal\RepeatedField $var
+     * @return $this
+     */
+    public function setItems($var)
+    {
+        $arr = GPBUtil::checkRepeatedField($var, \Google\Protobuf\Internal\GPBType::MESSAGE, \Palm\Lily\V1\Section::class);
+        $this->items = $arr;
+
+        return $this;
+    }
+
+}
+

rpc/tutorials/php/Palm/Lily/V1/Slideshow.php

@@ -0,0 +1,32 @@
+<?php
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: lily.proto
+
+namespace Palm\Lily\V1;
+
+use Google\Protobuf\Internal\GPBType;
+use Google\Protobuf\Internal\RepeatedField;
+use Google\Protobuf\Internal\GPBUtil;
+
+/**
+ * Generated from protobuf message <code>palm.lily.v1.Slideshow</code>
+ */
+class Slideshow extends \Google\Protobuf\Internal\Message
+{
+
+    /**
+     * Constructor.
+     *
+     * @param array $data {
+     *     Optional. Data for populating the Message object.
+     *
+     * }
+     */
+    public function __construct($data = NULL) {
+        \GPBMetadata\Lily::initOnce();
+        parent::__construct($data);
+    }
+
+}
+

rpc/tutorials/php/Palm/Lily/V1/Style.php

@@ -0,0 +1,66 @@
+<?php
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: lily.proto
+
+namespace Palm\Lily\V1;
+
+use UnexpectedValueException;
+
+/**
+ * https://owl.purdue.edu/owl/general_writing/general_writing_faqs.html
+ *
+ * Protobuf type <code>palm.lily.v1.Style</code>
+ */
+class Style
+{
+    /**
+     * https://apastyle.apa.org/
+     * https://owl.purdue.edu/owl/research_and_citation/apa_style/apa_formatting_and_style_guide/general_format.html
+     * https://www.ilc.cuhk.edu.hk/Chinese/APAMLA/APA/APAlayout.aspx
+     *
+     * Generated from protobuf enum <code>APA_7 = 0;</code>
+     */
+    const APA_7 = 0;
+    /**
+     * https://www.mla.org/MLA-Style
+     * https://owl.purdue.edu/owl/research_and_citation/mla_style/mla_formatting_and_style_guide/mla_formatting_and_style_guide.html#:~:text=MLA%20(Modern%20Language%20Association)%20style,the%20liberal%20arts%20and%20humanities.
+     *
+     * Generated from protobuf enum <code>MLA_8 = 10;</code>
+     */
+    const MLA_8 = 10;
+    /**
+     * https://www.chicagomanualofstyle.org/home.html
+     * https://owl.purdue.edu/owl/research_and_citation/chicago_manual_17th_edition/cmos_formatting_and_style_guide/chicago_manual_of_style_17th_edition.html
+     *
+     * Generated from protobuf enum <code>CMOS = 20;</code>
+     */
+    const CMOS = 20;
+
+    private static $valueToName = [
+        self::APA_7 => 'APA_7',
+        self::MLA_8 => 'MLA_8',
+        self::CMOS => 'CMOS',
+    ];
+
+    public static function name($value)
+    {
+        if (!isset(self::$valueToName[$value])) {
+            throw new UnexpectedValueException(sprintf(
+                    'Enum %s has no name defined for value %s', __CLASS__, $value));
+        }
+        return self::$valueToName[$value];
+    }
+
+
+    public static function value($name)
+    {
+        $const = __CLASS__ . '::' . strtoupper($name);
+        if (!defined($const)) {
+            throw new UnexpectedValueException(sprintf(
+                    'Enum %s has no value defined for name %s', __CLASS__, $name));
+        }
+        return constant($const);
+    }
+}
+

rpc/tutorials/php/Palm/Lily/V1/TeXLiveClient.php

@@ -0,0 +1,35 @@
+<?php
+// GENERATED CODE -- DO NOT EDIT!
+
+namespace Palm\Lily\V1;
+
+/**
+ * ----------------------------------------------------------------------------
+ *
+ */
+class TeXLiveClient extends \Grpc\BaseStub {
+
+    /**
+     * @param string $hostname hostname
+     * @param array $opts channel options
+     * @param \Grpc\Channel $channel (optional) re-use channel object
+     */
+    public function __construct($hostname, $opts, $channel = null) {
+        parent::__construct($hostname, $opts, $channel);
+    }
+
+    /**
+     * @param \Palm\Lily\V1\TeXLiveRequest $argument input argument
+     * @param array $metadata metadata
+     * @param array $options call options
+     * @return \Grpc\UnaryCall
+     */
+    public function ToPdf(\Palm\Lily\V1\TeXLiveRequest $argument,
+      $metadata = [], $options = []) {
+        return $this->_simpleRequest('/palm.lily.v1.TeXLive/ToPdf',
+        $argument,
+        ['\Palm\Lily\V1\TeXLiveResponse', 'decode'],
+        $metadata, $options);
+    }
+
+}

rpc/tutorials/php/Palm/Lily/V1/TeXLiveRequest.php

@@ -0,0 +1,297 @@
+<?php
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: lily.proto
+
+namespace Palm\Lily\V1;
+
+use Google\Protobuf\Internal\GPBType;
+use Google\Protobuf\Internal\RepeatedField;
+use Google\Protobuf\Internal\GPBUtil;
+
+/**
+ * Generated from protobuf message <code>palm.lily.v1.TeXLiveRequest</code>
+ */
+class TeXLiveRequest extends \Google\Protobuf\Internal\Message
+{
+    /**
+     * Generated from protobuf field <code>string name = 1;</code>
+     */
+    protected $name = '';
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.Style style = 2;</code>
+     */
+    protected $style = 0;
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.TeXLiveTask.Output.Format format = 3;</code>
+     */
+    protected $format = 0;
+    /**
+     * Generated from protobuf field <code>.google.protobuf.Duration ttl = 9;</code>
+     */
+    protected $ttl = null;
+    /**
+     * Generated from protobuf field <code>bytes entry = 98;</code>
+     */
+    protected $entry = '';
+    /**
+     * Generated from protobuf field <code>map<string, bytes> attachments = 99;</code>
+     */
+    private $attachments;
+    protected $Payload;
+
+    /**
+     * Constructor.
+     *
+     * @param array $data {
+     *     Optional. Data for populating the Message object.
+     *
+     *     @type string $name
+     *     @type int $style
+     *     @type int $format
+     *     @type \Google\Protobuf\Duration $ttl
+     *     @type \Palm\Lily\V1\Book $book
+     *     @type \Palm\Lily\V1\Article $article
+     *     @type \Palm\Lily\V1\Slideshow $slideshow
+     *     @type string $entry
+     *     @type array|\Google\Protobuf\Internal\MapField $attachments
+     * }
+     */
+    public function __construct($data = NULL) {
+        \GPBMetadata\Lily::initOnce();
+        parent::__construct($data);
+    }
+
+    /**
+     * Generated from protobuf field <code>string name = 1;</code>
+     * @return string
+     */
+    public function getName()
+    {
+        return $this->name;
+    }
+
+    /**
+     * Generated from protobuf field <code>string name = 1;</code>
+     * @param string $var
+     * @return $this
+     */
+    public function setName($var)
+    {
+        GPBUtil::checkString($var, True);
+        $this->name = $var;
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.Style style = 2;</code>
+     * @return int
+     */
+    public function getStyle()
+    {
+        return $this->style;
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.Style style = 2;</code>
+     * @param int $var
+     * @return $this
+     */
+    public function setStyle($var)
+    {
+        GPBUtil::checkEnum($var, \Palm\Lily\V1\Style::class);
+        $this->style = $var;
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.TeXLiveTask.Output.Format format = 3;</code>
+     * @return int
+     */
+    public function getFormat()
+    {
+        return $this->format;
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.TeXLiveTask.Output.Format format = 3;</code>
+     * @param int $var
+     * @return $this
+     */
+    public function setFormat($var)
+    {
+        GPBUtil::checkEnum($var, \Palm\Lily\V1\TeXLiveTask\Output\Format::class);
+        $this->format = $var;
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>.google.protobuf.Duration ttl = 9;</code>
+     * @return \Google\Protobuf\Duration|null
+     */
+    public function getTtl()
+    {
+        return $this->ttl;
+    }
+
+    public function hasTtl()
+    {
+        return isset($this->ttl);
+    }
+
+    public function clearTtl()
+    {
+        unset($this->ttl);
+    }
+
+    /**
+     * Generated from protobuf field <code>.google.protobuf.Duration ttl = 9;</code>
+     * @param \Google\Protobuf\Duration $var
+     * @return $this
+     */
+    public function setTtl($var)
+    {
+        GPBUtil::checkMessage($var, \Google\Protobuf\Duration::class);
+        $this->ttl = $var;
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.Book book = 11;</code>
+     * @return \Palm\Lily\V1\Book|null
+     */
+    public function getBook()
+    {
+        return $this->readOneof(11);
+    }
+
+    public function hasBook()
+    {
+        return $this->hasOneof(11);
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.Book book = 11;</code>
+     * @param \Palm\Lily\V1\Book $var
+     * @return $this
+     */
+    public function setBook($var)
+    {
+        GPBUtil::checkMessage($var, \Palm\Lily\V1\Book::class);
+        $this->writeOneof(11, $var);
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.Article article = 12;</code>
+     * @return \Palm\Lily\V1\Article|null
+     */
+    public function getArticle()
+    {
+        return $this->readOneof(12);
+    }
+
+    public function hasArticle()
+    {
+        return $this->hasOneof(12);
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.Article article = 12;</code>
+     * @param \Palm\Lily\V1\Article $var
+     * @return $this
+     */
+    public function setArticle($var)
+    {
+        GPBUtil::checkMessage($var, \Palm\Lily\V1\Article::class);
+        $this->writeOneof(12, $var);
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.Slideshow slideshow = 13;</code>
+     * @return \Palm\Lily\V1\Slideshow|null
+     */
+    public function getSlideshow()
+    {
+        return $this->readOneof(13);
+    }
+
+    public function hasSlideshow()
+    {
+        return $this->hasOneof(13);
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.Slideshow slideshow = 13;</code>
+     * @param \Palm\Lily\V1\Slideshow $var
+     * @return $this
+     */
+    public function setSlideshow($var)
+    {
+        GPBUtil::checkMessage($var, \Palm\Lily\V1\Slideshow::class);
+        $this->writeOneof(13, $var);
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>bytes entry = 98;</code>
+     * @return string
+     */
+    public function getEntry()
+    {
+        return $this->entry;
+    }
+
+    /**
+     * Generated from protobuf field <code>bytes entry = 98;</code>
+     * @param string $var
+     * @return $this
+     */
+    public function setEntry($var)
+    {
+        GPBUtil::checkString($var, False);
+        $this->entry = $var;
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>map<string, bytes> attachments = 99;</code>
+     * @return \Google\Protobuf\Internal\MapField
+     */
+    public function getAttachments()
+    {
+        return $this->attachments;
+    }
+
+    /**
+     * Generated from protobuf field <code>map<string, bytes> attachments = 99;</code>
+     * @param array|\Google\Protobuf\Internal\MapField $var
+     * @return $this
+     */
+    public function setAttachments($var)
+    {
+        $arr = GPBUtil::checkMapField($var, \Google\Protobuf\Internal\GPBType::STRING, \Google\Protobuf\Internal\GPBType::BYTES);
+        $this->attachments = $arr;
+
+        return $this;
+    }
+
+    /**
+     * @return string
+     */
+    public function getPayload()
+    {
+        return $this->whichOneof("Payload");
+    }
+
+}
+

rpc/tutorials/php/Palm/Lily/V1/TeXLiveResponse.php

@@ -0,0 +1,86 @@
+<?php
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: lily.proto
+
+namespace Palm\Lily\V1;
+
+use Google\Protobuf\Internal\GPBType;
+use Google\Protobuf\Internal\RepeatedField;
+use Google\Protobuf\Internal\GPBUtil;
+
+/**
+ * Generated from protobuf message <code>palm.lily.v1.TeXLiveResponse</code>
+ */
+class TeXLiveResponse extends \Google\Protobuf\Internal\Message
+{
+    /**
+     * Generated from protobuf field <code>string bucket = 1;</code>
+     */
+    protected $bucket = '';
+    /**
+     * Generated from protobuf field <code>string object = 2;</code>
+     */
+    protected $object = '';
+
+    /**
+     * Constructor.
+     *
+     * @param array $data {
+     *     Optional. Data for populating the Message object.
+     *
+     *     @type string $bucket
+     *     @type string $object
+     * }
+     */
+    public function __construct($data = NULL) {
+        \GPBMetadata\Lily::initOnce();
+        parent::__construct($data);
+    }
+
+    /**
+     * Generated from protobuf field <code>string bucket = 1;</code>
+     * @return string
+     */
+    public function getBucket()
+    {
+        return $this->bucket;
+    }
+
+    /**
+     * Generated from protobuf field <code>string bucket = 1;</code>
+     * @param string $var
+     * @return $this
+     */
+    public function setBucket($var)
+    {
+        GPBUtil::checkString($var, True);
+        $this->bucket = $var;
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>string object = 2;</code>
+     * @return string
+     */
+    public function getObject()
+    {
+        return $this->object;
+    }
+
+    /**
+     * Generated from protobuf field <code>string object = 2;</code>
+     * @param string $var
+     * @return $this
+     */
+    public function setObject($var)
+    {
+        GPBUtil::checkString($var, True);
+        $this->object = $var;
+
+        return $this;
+    }
+
+}
+

rpc/tutorials/php/Palm/Lily/V1/TeXLiveStub.php

@@ -0,0 +1,43 @@
+<?php
+// GENERATED CODE -- DO NOT EDIT!
+
+namespace Palm\Lily\V1;
+
+/**
+ * ----------------------------------------------------------------------------
+ *
+ */
+class TeXLiveStub {
+
+    /**
+     * @param \Palm\Lily\V1\TeXLiveRequest $request client request
+     * @param \Grpc\ServerContext $context server request context
+     * @return \Palm\Lily\V1\TeXLiveResponse for response data, null if if error occured
+     *     initial metadata (if any) and status (if not ok) should be set to $context
+     */
+    public function ToPdf(
+        \Palm\Lily\V1\TeXLiveRequest $request,
+        \Grpc\ServerContext $context
+    ): ?\Palm\Lily\V1\TeXLiveResponse {
+        $context->setStatus(\Grpc\Status::unimplemented());
+        return null;
+    }
+
+    /**
+     * Get the method descriptors of the service for server registration
+     *
+     * @return array of \Grpc\MethodDescriptor for the service methods
+     */
+    public final function getMethodDescriptors(): array
+    {
+        return [
+            '/palm.lily.v1.TeXLive/ToPdf' => new \Grpc\MethodDescriptor(
+                $this,
+                'ToPdf',
+                '\Palm\Lily\V1\TeXLiveRequest',
+                \Grpc\MethodDescriptor::UNARY_CALL
+            ),
+        ];
+    }
+
+}

rpc/tutorials/php/Palm/Lily/V1/TeXLiveTask.php

@@ -0,0 +1,123 @@
+<?php
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: lily.proto
+
+namespace Palm\Lily\V1;
+
+use Google\Protobuf\Internal\GPBType;
+use Google\Protobuf\Internal\RepeatedField;
+use Google\Protobuf\Internal\GPBUtil;
+
+/**
+ * Generated from protobuf message <code>palm.lily.v1.TeXLiveTask</code>
+ */
+class TeXLiveTask extends \Google\Protobuf\Internal\Message
+{
+    /**
+     * Generated from protobuf field <code>bytes entry = 1;</code>
+     */
+    protected $entry = '';
+    /**
+     * Generated from protobuf field <code>map<string, bytes> attachments = 3;</code>
+     */
+    private $attachments;
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.TeXLiveTask.Output output = 9;</code>
+     */
+    protected $output = null;
+
+    /**
+     * Constructor.
+     *
+     * @param array $data {
+     *     Optional. Data for populating the Message object.
+     *
+     *     @type string $entry
+     *     @type array|\Google\Protobuf\Internal\MapField $attachments
+     *     @type \Palm\Lily\V1\TeXLiveTask\Output $output
+     * }
+     */
+    public function __construct($data = NULL) {
+        \GPBMetadata\Lily::initOnce();
+        parent::__construct($data);
+    }
+
+    /**
+     * Generated from protobuf field <code>bytes entry = 1;</code>
+     * @return string
+     */
+    public function getEntry()
+    {
+        return $this->entry;
+    }
+
+    /**
+     * Generated from protobuf field <code>bytes entry = 1;</code>
+     * @param string $var
+     * @return $this
+     */
+    public function setEntry($var)
+    {
+        GPBUtil::checkString($var, False);
+        $this->entry = $var;
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>map<string, bytes> attachments = 3;</code>
+     * @return \Google\Protobuf\Internal\MapField
+     */
+    public function getAttachments()
+    {
+        return $this->attachments;
+    }
+
+    /**
+     * Generated from protobuf field <code>map<string, bytes> attachments = 3;</code>
+     * @param array|\Google\Protobuf\Internal\MapField $var
+     * @return $this
+     */
+    public function setAttachments($var)
+    {
+        $arr = GPBUtil::checkMapField($var, \Google\Protobuf\Internal\GPBType::STRING, \Google\Protobuf\Internal\GPBType::BYTES);
+        $this->attachments = $arr;
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.TeXLiveTask.Output output = 9;</code>
+     * @return \Palm\Lily\V1\TeXLiveTask\Output|null
+     */
+    public function getOutput()
+    {
+        return $this->output;
+    }
+
+    public function hasOutput()
+    {
+        return isset($this->output);
+    }
+
+    public function clearOutput()
+    {
+        unset($this->output);
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.TeXLiveTask.Output output = 9;</code>
+     * @param \Palm\Lily\V1\TeXLiveTask\Output $var
+     * @return $this
+     */
+    public function setOutput($var)
+    {
+        GPBUtil::checkMessage($var, \Palm\Lily\V1\TeXLiveTask\Output::class);
+        $this->output = $var;
+
+        return $this;
+    }
+
+}
+

rpc/tutorials/php/Palm/Lily/V1/TeXLiveTask/Output.php

@@ -0,0 +1,113 @@
+<?php
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: lily.proto
+
+namespace Palm\Lily\V1\TeXLiveTask;
+
+use Google\Protobuf\Internal\GPBType;
+use Google\Protobuf\Internal\RepeatedField;
+use Google\Protobuf\Internal\GPBUtil;
+
+/**
+ * Generated from protobuf message <code>palm.lily.v1.TeXLiveTask.Output</code>
+ */
+class Output extends \Google\Protobuf\Internal\Message
+{
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.TeXLiveTask.Output.Format format = 1;</code>
+     */
+    protected $format = 0;
+    /**
+     * Generated from protobuf field <code>string bucket = 2;</code>
+     */
+    protected $bucket = '';
+    /**
+     * Generated from protobuf field <code>string object = 3;</code>
+     */
+    protected $object = '';
+
+    /**
+     * Constructor.
+     *
+     * @param array $data {
+     *     Optional. Data for populating the Message object.
+     *
+     *     @type int $format
+     *     @type string $bucket
+     *     @type string $object
+     * }
+     */
+    public function __construct($data = NULL) {
+        \GPBMetadata\Lily::initOnce();
+        parent::__construct($data);
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.TeXLiveTask.Output.Format format = 1;</code>
+     * @return int
+     */
+    public function getFormat()
+    {
+        return $this->format;
+    }
+
+    /**
+     * Generated from protobuf field <code>.palm.lily.v1.TeXLiveTask.Output.Format format = 1;</code>
+     * @param int $var
+     * @return $this
+     */
+    public function setFormat($var)
+    {
+        GPBUtil::checkEnum($var, \Palm\Lily\V1\TeXLiveTask\Output\Format::class);
+        $this->format = $var;
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>string bucket = 2;</code>
+     * @return string
+     */
+    public function getBucket()
+    {
+        return $this->bucket;
+    }
+
+    /**
+     * Generated from protobuf field <code>string bucket = 2;</code>
+     * @param string $var
+     * @return $this
+     */
+    public function setBucket($var)
+    {
+        GPBUtil::checkString($var, True);
+        $this->bucket = $var;
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>string object = 3;</code>
+     * @return string
+     */
+    public function getObject()
+    {
+        return $this->object;
+    }
+
+    /**
+     * Generated from protobuf field <code>string object = 3;</code>
+     * @param string $var
+     * @return $this
+     */
+    public function setObject($var)
+    {
+        GPBUtil::checkString($var, True);
+        $this->object = $var;
+
+        return $this;
+    }
+
+}
+

rpc/tutorials/php/Palm/Lily/V1/TeXLiveTask/Output/Format.php

@@ -0,0 +1,44 @@
+<?php
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: lily.proto
+
+namespace Palm\Lily\V1\TeXLiveTask\Output;
+
+use UnexpectedValueException;
+
+/**
+ * Protobuf type <code>palm.lily.v1.TeXLiveTask.Output.Format</code>
+ */
+class Format
+{
+    /**
+     * Generated from protobuf enum <code>Pdf = 0;</code>
+     */
+    const Pdf = 0;
+
+    private static $valueToName = [
+        self::Pdf => 'Pdf',
+    ];
+
+    public static function name($value)
+    {
+        if (!isset(self::$valueToName[$value])) {
+            throw new UnexpectedValueException(sprintf(
+                    'Enum %s has no name defined for value %s', __CLASS__, $value));
+        }
+        return self::$valueToName[$value];
+    }
+
+
+    public static function value($name)
+    {
+        $const = __CLASS__ . '::' . strtoupper($name);
+        if (!defined($const)) {
+            throw new UnexpectedValueException(sprintf(
+                    'Enum %s has no value defined for name %s', __CLASS__, $name));
+        }
+        return constant($const);
+    }
+}
+

rpc/tutorials/php/Palm/Morus/V1/MarkdownClient.php

@@ -0,0 +1,33 @@
+<?php
+// GENERATED CODE -- DO NOT EDIT!
+
+namespace Palm\Morus\V1;
+
+/**
+ */
+class MarkdownClient extends \Grpc\BaseStub {
+
+    /**
+     * @param string $hostname hostname
+     * @param array $opts channel options
+     * @param \Grpc\Channel $channel (optional) re-use channel object
+     */
+    public function __construct($hostname, $opts, $channel = null) {
+        parent::__construct($hostname, $opts, $channel);
+    }
+
+    /**
+     * @param \Palm\Morus\V1\MarkdownToHtmlRequest $argument input argument
+     * @param array $metadata metadata
+     * @param array $options call options
+     * @return \Grpc\UnaryCall
+     */
+    public function ToHtml(\Palm\Morus\V1\MarkdownToHtmlRequest $argument,
+      $metadata = [], $options = []) {
+        return $this->_simpleRequest('/palm.morus.v1.Markdown/ToHtml',
+        $argument,
+        ['\Palm\Morus\V1\MarkdownToHtmlResponse', 'decode'],
+        $metadata, $options);
+    }
+
+}

rpc/tutorials/php/Palm/Morus/V1/MarkdownStub.php

@@ -0,0 +1,41 @@
+<?php
+// GENERATED CODE -- DO NOT EDIT!
+
+namespace Palm\Morus\V1;
+
+/**
+ */
+class MarkdownStub {
+
+    /**
+     * @param \Palm\Morus\V1\MarkdownToHtmlRequest $request client request
+     * @param \Grpc\ServerContext $context server request context
+     * @return \Palm\Morus\V1\MarkdownToHtmlResponse for response data, null if if error occured
+     *     initial metadata (if any) and status (if not ok) should be set to $context
+     */
+    public function ToHtml(
+        \Palm\Morus\V1\MarkdownToHtmlRequest $request,
+        \Grpc\ServerContext $context
+    ): ?\Palm\Morus\V1\MarkdownToHtmlResponse {
+        $context->setStatus(\Grpc\Status::unimplemented());
+        return null;
+    }
+
+    /**
+     * Get the method descriptors of the service for server registration
+     *
+     * @return array of \Grpc\MethodDescriptor for the service methods
+     */
+    public final function getMethodDescriptors(): array
+    {
+        return [
+            '/palm.morus.v1.Markdown/ToHtml' => new \Grpc\MethodDescriptor(
+                $this,
+                'ToHtml',
+                '\Palm\Morus\V1\MarkdownToHtmlRequest',
+                \Grpc\MethodDescriptor::UNARY_CALL
+            ),
+        ];
+    }
+
+}

rpc/tutorials/php/Palm/Morus/V1/MarkdownToHtmlRequest.php

@@ -0,0 +1,86 @@
+<?php
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: morus.proto
+
+namespace Palm\Morus\V1;
+
+use Google\Protobuf\Internal\GPBType;
+use Google\Protobuf\Internal\RepeatedField;
+use Google\Protobuf\Internal\GPBUtil;
+
+/**
+ * Generated from protobuf message <code>palm.morus.v1.MarkdownToHtmlRequest</code>
+ */
+class MarkdownToHtmlRequest extends \Google\Protobuf\Internal\Message
+{
+    /**
+     * Generated from protobuf field <code>string payload = 1;</code>
+     */
+    protected $payload = '';
+    /**
+     * Generated from protobuf field <code>bool sanitize = 2;</code>
+     */
+    protected $sanitize = false;
+
+    /**
+     * Constructor.
+     *
+     * @param array $data {
+     *     Optional. Data for populating the Message object.
+     *
+     *     @type string $payload
+     *     @type bool $sanitize
+     * }
+     */
+    public function __construct($data = NULL) {
+        \GPBMetadata\Morus::initOnce();
+        parent::__construct($data);
+    }
+
+    /**
+     * Generated from protobuf field <code>string payload = 1;</code>
+     * @return string
+     */
+    public function getPayload()
+    {
+        return $this->payload;
+    }
+
+    /**
+     * Generated from protobuf field <code>string payload = 1;</code>
+     * @param string $var
+     * @return $this
+     */
+    public function setPayload($var)
+    {
+        GPBUtil::checkString($var, True);
+        $this->payload = $var;
+
+        return $this;
+    }
+
+    /**
+     * Generated from protobuf field <code>bool sanitize = 2;</code>
+     * @return bool
+     */
+    public function getSanitize()
+    {
+        return $this->sanitize;
+    }
+
+    /**
+     * Generated from protobuf field <code>bool sanitize = 2;</code>
+     * @param bool $var
+     * @return $this
+     */
+    public function setSanitize($var)
+    {
+        GPBUtil::checkBool($var);
+        $this->sanitize = $var;
+
+        return $this;
+    }
+
+}
+

rpc/tutorials/php/Palm/Morus/V1/MarkdownToHtmlResponse.php

@@ -0,0 +1,59 @@
+<?php
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: morus.proto
+
+namespace Palm\Morus\V1;
+
+use Google\Protobuf\Internal\GPBType;
+use Google\Protobuf\Internal\RepeatedField;
+use Google\Protobuf\Internal\GPBUtil;
+
+/**
+ * Generated from protobuf message <code>palm.morus.v1.MarkdownToHtmlResponse</code>
+ */
+class MarkdownToHtmlResponse extends \Google\Protobuf\Internal\Message
+{
+    /**
+     * Generated from protobuf field <code>string payload = 1;</code>
+     */
+    protected $payload = '';
+
+    /**
+     * Constructor.
+     *
+     * @param array $data {
+     *     Optional. Data for populating the Message object.
+     *
+     *     @type string $payload
+     * }
+     */
+    public function __construct($data = NULL) {
+        \GPBMetadata\Morus::initOnce();
+        parent::__construct($data);
+    }
+
+    /**
+     * Generated from protobuf field <code>string payload = 1;</code>
+     * @return string
+     */
+    public function getPayload()
+    {
+        return $this->payload;
+    }
+
+    /**
+     * Generated from protobuf field <code>string payload = 1;</code>
+     * @param string $var
+     * @return $this
+     */
+    public function setPayload($var)
+    {
+        GPBUtil::checkString($var, True);
+        $this->payload = $var;
+
+        return $this;
+    }
+
+}
+