From 6209453817da9922f28bac1bb1522c6d380630ab Mon Sep 17 00:00:00 2001 From: nsfisis Date: Sat, 19 Nov 2022 14:23:32 +0900 Subject: Hugo to Asciidoctor --- .gitignore | 1 - Gemfile | 7 + Gemfile.lock | 17 + LICENSE | 22 + Makefile | 6 +- NOTE.md | 60 +- README.md | 31 + archetypes/default.md | 11 - config.toml | 15 - content/404.html | 32 + content/_index.md | 4 - content/posts/2021-03-05/my-first-post.adoc | 13 + content/posts/2021-03-05/my-first-post.md | 12 - content/posts/2021-03-30/phperkaigi-2021.adoc | 532 +++++ content/posts/2021-03-30/phperkaigi-2021.md | 554 ----- .../cpp-you-can-use-keywords-in-attributes.adoc | 106 + .../cpp-you-can-use-keywords-in-attributes.md | 95 - .../2021-10-02/python-unbound-local-error.adoc | 66 + .../posts/2021-10-02/python-unbound-local-error.md | 67 - .../ruby-detect-running-implementation.adoc | 72 + .../ruby-detect-running-implementation.md | 64 - .../2021-10-02/ruby-then-keyword-and-case-in.adoc | 226 ++ .../2021-10-02/ruby-then-keyword-and-case-in.md | 205 -- .../rust-where-are-primitive-types-from.adoc | 201 ++ .../rust-where-are-primitive-types-from.md | 175 -- ...e-between-autocmd-bufwrite-and-bufwritepre.adoc | 120 + ...nce-between-autocmd-bufwrite-and-bufwritepre.md | 106 - .../vim-swap-order-of-selected-lines.adoc | 165 ++ .../2021-10-02/vim-swap-order-of-selected-lines.md | 145 -- .../posts/2022-04-09/phperkaigi-2022-tokens.adoc | 469 ++++ content/posts/2022-04-09/phperkaigi-2022-tokens.md | 461 ---- ...nner-write-tool-showing-banner-in-terminal.adoc | 86 + ...banner-write-tool-showing-banner-in-terminal.md | 89 - content/posts/2022-05-01/phperkaigi-2022.adoc | 130 ++ content/posts/2022-05-01/phperkaigi-2022.md | 114 - .../php-conference-okinawa-code-golf.adoc | 91 + .../2022-08-27/php-conference-okinawa-code-golf.md | 79 - .../support-for-communty-is-employee-benefits.adoc | 46 + .../support-for-communty-is-employee-benefits.md | 47 - .../write-fizzbuzz-in-php-2-letters-per-line.adoc | 624 ++++++ .../write-fizzbuzz-in-php-2-letters-per-line.md | 577 ----- .../phperkaigi-2023-unused-token-quiz-1.adoc | 157 ++ .../phperkaigi-2023-unused-token-quiz-1.md | 143 -- .../2022-10-28/setup-server-for-this-site.adoc | 248 +++ .../posts/2022-10-28/setup-server-for-this-site.md | 230 -- docker-compose.local.yml | 2 +- docker-compose.yml | 2 +- docs/404.html | 42 - docs/an-old-hope.min.css | 1 - docs/custom.css | 26 - docs/favicon.svg | 62 - docs/feed.xml | 2348 -------------------- docs/highlight.min.js | 1122 ---------- docs/index.html | 170 -- docs/page/1/index.html | 10 - docs/page/2/index.html | 131 -- docs/posts/2021-03-05/my-first-post/index.html | 58 - docs/posts/2021-03-30/phperkaigi-2021/index.html | 532 ----- .../index.html | 129 -- .../python-unbound-local-error/index.html | 97 - .../ruby-detect-running-implementation/index.html | 125 -- .../ruby-then-keyword-and-case-in/index.html | 195 -- .../rust-where-are-primitive-types-from/index.html | 182 -- .../index.html | 132 -- .../vim-swap-order-of-selected-lines/index.html | 148 -- .../2022-04-09/phperkaigi-2022-tokens/index.html | 375 ---- .../index.html | 102 - docs/posts/2022-05-01/phperkaigi-2022/index.html | 133 -- .../php-conference-okinawa-code-golf/index.html | 102 - .../index.html | 74 - .../index.html | 520 ----- .../phperkaigi-2023-unused-token-quiz-1/index.html | 132 -- .../setup-server-for-this-site/index.html | 163 -- docs/posts/feed.xml | 2348 -------------------- docs/posts/index.html | 172 -- docs/posts/page/1/index.html | 10 - docs/posts/page/2/index.html | 133 -- docs/sitemap.xml | 107 - docs/style.css | 483 ---- docs/tags/conference/feed.xml | 944 -------- docs/tags/conference/index.html | 92 - docs/tags/conference/page/1/index.html | 10 - docs/tags/cpp/feed.xml | 89 - docs/tags/cpp/index.html | 56 - docs/tags/cpp/page/1/index.html | 10 - docs/tags/cpp17/feed.xml | 89 - docs/tags/cpp17/index.html | 56 - docs/tags/cpp17/page/1/index.html | 10 - docs/tags/feed.xml | 137 -- docs/tags/index.html | 44 - docs/tags/my-programs/feed.xml | 62 - docs/tags/my-programs/index.html | 56 - docs/tags/my-programs/page/1/index.html | 10 - docs/tags/note-to-self/feed.xml | 123 - docs/tags/note-to-self/index.html | 57 - docs/tags/note-to-self/page/1/index.html | 10 - docs/tags/page/1/index.html | 10 - docs/tags/php/feed.xml | 1493 ------------- docs/tags/php/index.html | 117 - docs/tags/php/page/1/index.html | 10 - docs/tags/phpcon/feed.xml | 61 - docs/tags/phpcon/index.html | 56 - docs/tags/phpcon/page/1/index.html | 10 - docs/tags/phperkaigi/feed.xml | 974 -------- docs/tags/phperkaigi/index.html | 93 - docs/tags/phperkaigi/page/1/index.html | 10 - docs/tags/python/feed.xml | 57 - docs/tags/python/index.html | 56 - docs/tags/python/page/1/index.html | 10 - docs/tags/python3/feed.xml | 57 - docs/tags/python3/index.html | 56 - docs/tags/python3/page/1/index.html | 10 - docs/tags/ruby/feed.xml | 230 -- docs/tags/ruby/index.html | 68 - docs/tags/ruby/page/1/index.html | 10 - docs/tags/ruby3/feed.xml | 155 -- docs/tags/ruby3/index.html | 56 - docs/tags/ruby3/page/1/index.html | 10 - docs/tags/rust/feed.xml | 143 -- docs/tags/rust/index.html | 56 - docs/tags/rust/page/1/index.html | 10 - docs/tags/vim/feed.xml | 191 -- docs/tags/vim/index.html | 68 - docs/tags/vim/page/1/index.html | 10 - lib/command.rb | 152 ++ lib/extensions/document_title_processor.rb | 15 + lib/extensions/lang_attribute_processor.rb | 9 + lib/extensions/revision_history_processor.rb | 27 + lib/extensions/section_id_validator.rb | 29 + lib/extensions/source_id_processor.rb | 12 + lib/extensions/source_id_validator.rb | 32 + lib/extensions/tags_processor.rb | 20 + lib/parser.rb | 54 + lib/revision.rb | 3 + lib/tag.rb | 26 + nginx.conf | 3 + nuldoc.rb | 24 + public/custom.css | 29 + public/favicon.svg | 62 + public/hl.css | 214 ++ public/posts/2021-03-05/my-first-post/index.html | 71 + public/posts/2021-03-30/phperkaigi-2021/index.html | 1195 ++++++++++ .../index.html | 209 ++ .../python-unbound-local-error/index.html | 131 ++ .../ruby-detect-running-implementation/index.html | 167 ++ .../ruby-then-keyword-and-case-in/index.html | 392 ++++ .../rust-where-are-primitive-types-from/index.html | 317 +++ .../index.html | 299 +++ .../vim-swap-order-of-selected-lines/index.html | 366 +++ .../2022-04-09/phperkaigi-2022-tokens/index.html | 876 ++++++++ .../index.html | 222 ++ public/posts/2022-05-01/phperkaigi-2022/index.html | 324 +++ .../php-conference-okinawa-code-golf/index.html | 276 +++ .../index.html | 140 ++ .../index.html | 929 ++++++++ .../phperkaigi-2023-unused-token-quiz-1/index.html | 291 +++ .../setup-server-for-this-site/index.html | 630 ++++++ public/posts/index.html | 315 +++ public/style.css | 480 ++++ public/tags/conference/index.html | 107 + public/tags/cpp/index.html | 59 + public/tags/cpp17/index.html | 59 + public/tags/note-to-self/index.html | 59 + public/tags/php/index.html | 139 ++ public/tags/phpcon/index.html | 59 + public/tags/phperkaigi/index.html | 107 + public/tags/python/index.html | 59 + public/tags/python3/index.html | 59 + public/tags/ruby/index.html | 75 + public/tags/ruby3/index.html | 59 + public/tags/rust/index.html | 59 + public/tags/vim/index.html | 75 + static/custom.css | 29 + static/favicon.svg | 62 + static/hl.css | 214 ++ static/style.css | 480 ++++ templates/document.html.erb | 69 + templates/feed.xml.erb | 27 + templates/posts_list.html.erb | 59 + templates/section.html.erb | 19 + templates/sitemap.xml.erb | 11 + templates/tag.html.erb | 59 + themes/mypaper/LICENSE | 22 - themes/mypaper/README.md | 1 - themes/mypaper/i18n/ja.yaml | 5 - themes/mypaper/layouts/404.html | 3 - themes/mypaper/layouts/_default/list.html | 45 - themes/mypaper/layouts/_default/rss.xml | 39 - themes/mypaper/layouts/_default/single.html | 30 - themes/mypaper/layouts/partials/footer.html | 12 - themes/mypaper/layouts/partials/header.html | 54 - themes/mypaper/layouts/shortcodes/collapse.html | 12 - themes/mypaper/layouts/sitemap.xml | 12 - themes/mypaper/static/an-old-hope.min.css | 1 - themes/mypaper/static/custom.css | 26 - themes/mypaper/static/favicon.svg | 62 - themes/mypaper/static/highlight.min.js | 1122 ---------- themes/mypaper/static/style.css | 483 ---- themes/mypaper/theme.toml | 25 - 199 files changed, 13869 insertions(+), 21461 deletions(-) create mode 100644 Gemfile create mode 100644 Gemfile.lock create mode 100644 LICENSE delete mode 100644 archetypes/default.md delete mode 100644 config.toml create mode 100644 content/404.html delete mode 100644 content/_index.md create mode 100644 content/posts/2021-03-05/my-first-post.adoc delete mode 100644 content/posts/2021-03-05/my-first-post.md create mode 100644 content/posts/2021-03-30/phperkaigi-2021.adoc delete mode 100644 content/posts/2021-03-30/phperkaigi-2021.md create mode 100644 content/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes.adoc delete mode 100644 content/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes.md create mode 100644 content/posts/2021-10-02/python-unbound-local-error.adoc delete mode 100644 content/posts/2021-10-02/python-unbound-local-error.md create mode 100644 content/posts/2021-10-02/ruby-detect-running-implementation.adoc delete mode 100644 content/posts/2021-10-02/ruby-detect-running-implementation.md create mode 100644 content/posts/2021-10-02/ruby-then-keyword-and-case-in.adoc delete mode 100644 content/posts/2021-10-02/ruby-then-keyword-and-case-in.md create mode 100644 content/posts/2021-10-02/rust-where-are-primitive-types-from.adoc delete mode 100644 content/posts/2021-10-02/rust-where-are-primitive-types-from.md create mode 100644 content/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre.adoc delete mode 100644 content/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre.md create mode 100644 content/posts/2021-10-02/vim-swap-order-of-selected-lines.adoc delete mode 100644 content/posts/2021-10-02/vim-swap-order-of-selected-lines.md create mode 100644 content/posts/2022-04-09/phperkaigi-2022-tokens.adoc delete mode 100644 content/posts/2022-04-09/phperkaigi-2022-tokens.md create mode 100644 content/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal.adoc delete mode 100644 content/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal.md create mode 100644 content/posts/2022-05-01/phperkaigi-2022.adoc delete mode 100644 content/posts/2022-05-01/phperkaigi-2022.md create mode 100644 content/posts/2022-08-27/php-conference-okinawa-code-golf.adoc delete mode 100644 content/posts/2022-08-27/php-conference-okinawa-code-golf.md create mode 100644 content/posts/2022-08-31/support-for-communty-is-employee-benefits.adoc delete mode 100644 content/posts/2022-08-31/support-for-communty-is-employee-benefits.md create mode 100644 content/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line.adoc delete mode 100644 content/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line.md create mode 100644 content/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1.adoc delete mode 100644 content/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1.md create mode 100644 content/posts/2022-10-28/setup-server-for-this-site.adoc delete mode 100644 content/posts/2022-10-28/setup-server-for-this-site.md delete mode 100644 docs/404.html delete mode 100644 docs/an-old-hope.min.css delete mode 100644 docs/custom.css delete mode 100644 docs/favicon.svg delete mode 100644 docs/feed.xml delete mode 100644 docs/highlight.min.js delete mode 100644 docs/index.html delete mode 100644 docs/page/1/index.html delete mode 100644 docs/page/2/index.html delete mode 100644 docs/posts/2021-03-05/my-first-post/index.html delete mode 100644 docs/posts/2021-03-30/phperkaigi-2021/index.html delete mode 100644 docs/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes/index.html delete mode 100644 docs/posts/2021-10-02/python-unbound-local-error/index.html delete mode 100644 docs/posts/2021-10-02/ruby-detect-running-implementation/index.html delete mode 100644 docs/posts/2021-10-02/ruby-then-keyword-and-case-in/index.html delete mode 100644 docs/posts/2021-10-02/rust-where-are-primitive-types-from/index.html delete mode 100644 docs/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre/index.html delete mode 100644 docs/posts/2021-10-02/vim-swap-order-of-selected-lines/index.html delete mode 100644 docs/posts/2022-04-09/phperkaigi-2022-tokens/index.html delete mode 100644 docs/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal/index.html delete mode 100644 docs/posts/2022-05-01/phperkaigi-2022/index.html delete mode 100644 docs/posts/2022-08-27/php-conference-okinawa-code-golf/index.html delete mode 100644 docs/posts/2022-08-31/support-for-communty-is-employee-benefits/index.html delete mode 100644 docs/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line/index.html delete mode 100644 docs/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1/index.html delete mode 100644 docs/posts/2022-10-28/setup-server-for-this-site/index.html delete mode 100644 docs/posts/feed.xml delete mode 100644 docs/posts/index.html delete mode 100644 docs/posts/page/1/index.html delete mode 100644 docs/posts/page/2/index.html delete mode 100644 docs/sitemap.xml delete mode 100644 docs/style.css delete mode 100644 docs/tags/conference/feed.xml delete mode 100644 docs/tags/conference/index.html delete mode 100644 docs/tags/conference/page/1/index.html delete mode 100644 docs/tags/cpp/feed.xml delete mode 100644 docs/tags/cpp/index.html delete mode 100644 docs/tags/cpp/page/1/index.html delete mode 100644 docs/tags/cpp17/feed.xml delete mode 100644 docs/tags/cpp17/index.html delete mode 100644 docs/tags/cpp17/page/1/index.html delete mode 100644 docs/tags/feed.xml delete mode 100644 docs/tags/index.html delete mode 100644 docs/tags/my-programs/feed.xml delete mode 100644 docs/tags/my-programs/index.html delete mode 100644 docs/tags/my-programs/page/1/index.html delete mode 100644 docs/tags/note-to-self/feed.xml delete mode 100644 docs/tags/note-to-self/index.html delete mode 100644 docs/tags/note-to-self/page/1/index.html delete mode 100644 docs/tags/page/1/index.html delete mode 100644 docs/tags/php/feed.xml delete mode 100644 docs/tags/php/index.html delete mode 100644 docs/tags/php/page/1/index.html delete mode 100644 docs/tags/phpcon/feed.xml delete mode 100644 docs/tags/phpcon/index.html delete mode 100644 docs/tags/phpcon/page/1/index.html delete mode 100644 docs/tags/phperkaigi/feed.xml delete mode 100644 docs/tags/phperkaigi/index.html delete mode 100644 docs/tags/phperkaigi/page/1/index.html delete mode 100644 docs/tags/python/feed.xml delete mode 100644 docs/tags/python/index.html delete mode 100644 docs/tags/python/page/1/index.html delete mode 100644 docs/tags/python3/feed.xml delete mode 100644 docs/tags/python3/index.html delete mode 100644 docs/tags/python3/page/1/index.html delete mode 100644 docs/tags/ruby/feed.xml delete mode 100644 docs/tags/ruby/index.html delete mode 100644 docs/tags/ruby/page/1/index.html delete mode 100644 docs/tags/ruby3/feed.xml delete mode 100644 docs/tags/ruby3/index.html delete mode 100644 docs/tags/ruby3/page/1/index.html delete mode 100644 docs/tags/rust/feed.xml delete mode 100644 docs/tags/rust/index.html delete mode 100644 docs/tags/rust/page/1/index.html delete mode 100644 docs/tags/vim/feed.xml delete mode 100644 docs/tags/vim/index.html delete mode 100644 docs/tags/vim/page/1/index.html create mode 100644 lib/command.rb create mode 100644 lib/extensions/document_title_processor.rb create mode 100644 lib/extensions/lang_attribute_processor.rb create mode 100644 lib/extensions/revision_history_processor.rb create mode 100644 lib/extensions/section_id_validator.rb create mode 100644 lib/extensions/source_id_processor.rb create mode 100644 lib/extensions/source_id_validator.rb create mode 100644 lib/extensions/tags_processor.rb create mode 100644 lib/parser.rb create mode 100644 lib/revision.rb create mode 100644 lib/tag.rb create mode 100644 nuldoc.rb create mode 100644 public/custom.css create mode 100644 public/favicon.svg create mode 100644 public/hl.css create mode 100644 public/posts/2021-03-05/my-first-post/index.html create mode 100644 public/posts/2021-03-30/phperkaigi-2021/index.html create mode 100644 public/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes/index.html create mode 100644 public/posts/2021-10-02/python-unbound-local-error/index.html create mode 100644 public/posts/2021-10-02/ruby-detect-running-implementation/index.html create mode 100644 public/posts/2021-10-02/ruby-then-keyword-and-case-in/index.html create mode 100644 public/posts/2021-10-02/rust-where-are-primitive-types-from/index.html create mode 100644 public/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre/index.html create mode 100644 public/posts/2021-10-02/vim-swap-order-of-selected-lines/index.html create mode 100644 public/posts/2022-04-09/phperkaigi-2022-tokens/index.html create mode 100644 public/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal/index.html create mode 100644 public/posts/2022-05-01/phperkaigi-2022/index.html create mode 100644 public/posts/2022-08-27/php-conference-okinawa-code-golf/index.html create mode 100644 public/posts/2022-08-31/support-for-communty-is-employee-benefits/index.html create mode 100644 public/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line/index.html create mode 100644 public/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1/index.html create mode 100644 public/posts/2022-10-28/setup-server-for-this-site/index.html create mode 100644 public/posts/index.html create mode 100644 public/style.css create mode 100644 public/tags/conference/index.html create mode 100644 public/tags/cpp/index.html create mode 100644 public/tags/cpp17/index.html create mode 100644 public/tags/note-to-self/index.html create mode 100644 public/tags/php/index.html create mode 100644 public/tags/phpcon/index.html create mode 100644 public/tags/phperkaigi/index.html create mode 100644 public/tags/python/index.html create mode 100644 public/tags/python3/index.html create mode 100644 public/tags/ruby/index.html create mode 100644 public/tags/ruby3/index.html create mode 100644 public/tags/rust/index.html create mode 100644 public/tags/vim/index.html create mode 100644 static/custom.css create mode 100644 static/favicon.svg create mode 100644 static/hl.css create mode 100644 static/style.css create mode 100644 templates/document.html.erb create mode 100644 templates/feed.xml.erb create mode 100644 templates/posts_list.html.erb create mode 100644 templates/section.html.erb create mode 100644 templates/sitemap.xml.erb create mode 100644 templates/tag.html.erb delete mode 100644 themes/mypaper/LICENSE delete mode 100644 themes/mypaper/README.md delete mode 100644 themes/mypaper/i18n/ja.yaml delete mode 100644 themes/mypaper/layouts/404.html delete mode 100644 themes/mypaper/layouts/_default/list.html delete mode 100644 themes/mypaper/layouts/_default/rss.xml delete mode 100644 themes/mypaper/layouts/_default/single.html delete mode 100644 themes/mypaper/layouts/partials/footer.html delete mode 100644 themes/mypaper/layouts/partials/header.html delete mode 100644 themes/mypaper/layouts/shortcodes/collapse.html delete mode 100644 themes/mypaper/layouts/sitemap.xml delete mode 100644 themes/mypaper/static/an-old-hope.min.css delete mode 100644 themes/mypaper/static/custom.css delete mode 100644 themes/mypaper/static/favicon.svg delete mode 100644 themes/mypaper/static/highlight.min.js delete mode 100644 themes/mypaper/static/style.css delete mode 100644 themes/mypaper/theme.toml diff --git a/.gitignore b/.gitignore index 2a8645f..e69de29 100644 --- a/.gitignore +++ b/.gitignore @@ -1 +0,0 @@ -.hugo_build.lock diff --git a/Gemfile b/Gemfile new file mode 100644 index 0000000..1784943 --- /dev/null +++ b/Gemfile @@ -0,0 +1,7 @@ +# frozen_string_literal: true + +source "https://rubygems.org" + +gem "asciidoctor" +gem "concurrent-ruby" +gem "rouge" diff --git a/Gemfile.lock b/Gemfile.lock new file mode 100644 index 0000000..af3d42c --- /dev/null +++ b/Gemfile.lock @@ -0,0 +1,17 @@ +GEM + remote: https://rubygems.org/ + specs: + asciidoctor (2.0.18) + concurrent-ruby (1.1.10) + rouge (4.0.0) + +PLATFORMS + x86_64-darwin-19 + +DEPENDENCIES + asciidoctor + concurrent-ruby + rouge + +BUNDLED WITH + 2.3.11 diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..415f6f2 --- /dev/null +++ b/LICENSE @@ -0,0 +1,22 @@ +MIT License + +Copyright (c) 2020 nanxiaobei +Copyright (c) 2022 nsfisis + +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. diff --git a/Makefile b/Makefile index befc090..50ef3db 100644 --- a/Makefile +++ b/Makefile @@ -20,10 +20,14 @@ serve: clean: docker-compose down +.PHONY: gen +gen: + @ruby nuldoc.rb + .PHONY: local_up local_up: docker-compose -f docker-compose.local.yml up -d - echo http://localhost:8080 + @echo http://localhost:8080 .PHONY: local_down local_down: diff --git a/NOTE.md b/NOTE.md index 727cc36..801c62c 100644 --- a/NOTE.md +++ b/NOTE.md @@ -5,18 +5,70 @@ Generate the site. ``` -$ hugo -d docs +$ make gen ``` Create a new post. ``` -$ hugo new posts/$(date +'%Y-%m-%d')/[TITLE].md +$ mkdir -p content/posts/$(date +'%Y-%m-%d') +$ touch content/posts/$(date +'%Y-%m-%d')/[TITLE].md ``` +## TODO -Update `highlight.min.js`. +* [x] Add /posts/ page +* [x] Stylesheets +* [x] Syntax highlight +* [ ] Add / page +* [ ] Add /about/ page +* [ ] Add navigation bar + * Site name + * Posts + * Tags + * About +* [ ] Paging + * /posts/ + * /posts/?p=1 => /posts/ +* [ ] RSS feed + * /posts/feed.xml + * /tags//feed.xml +* [ ] Redirect + * [x] Old URLs + * [ ] /posts/?p=1 + => /posts/ + => /posts/_page/1.html + * [ ] /posts/?p=2 + => /posts/_page/2.html + * [ ] / + => /posts/ +* [ ] Sitemap + * https://www.sitemaps.org/protocol.html + * https://developers.google.com/search/docs/crawling-indexing/sitemaps/build-sitemap?hl=ja + + +## Structure ``` -$ curl -sL https://raw.githubusercontent.com/highlightjs/cdn-release/main/build/highlight.min.js >| themes/mypaper/static/highlight.min.js +public +├── sitemap.xml +├── 404.html +├── posts +│   ├── 2021-03-05 +│   │   └── my-first-post +│   │   └── index.html +│   ├── feed.xml +│   ├── _page +│   │   ├── 1.html +│   │   └── 2.html +└── tags + ├── index.html + └── vim + ├── feed.xml + └── index.html ``` + + +## References + +* https://docs.asciidoctor.org/asciidoctor/latest/ diff --git a/README.md b/README.md index a98a85b..80ee313 100644 --- a/README.md +++ b/README.md @@ -1 +1,32 @@ Site: https://blog.nsfisis.dev + + + +# License + +`static/style.css` is a modified version of [paper](https://github.com/nanxiaobei/hugo-paper/) theme. + +``` +MIT License + +Copyright (c) 2020 nanxiaobei +Copyright (c) 2022 nsfisis + +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. +``` diff --git a/archetypes/default.md b/archetypes/default.md deleted file mode 100644 index 1ab8ddf..0000000 --- a/archetypes/default.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: "{{ replace .Name "-" " " | title }}" -date: {{ .Date }} -draft: true -tags: ["TODO"] -summary: | - TODO -changelog: - {{ .Date | time.Format "2006-01-02" }}: 公開 ---- - diff --git a/config.toml b/config.toml deleted file mode 100644 index 3aaf028..0000000 --- a/config.toml +++ /dev/null @@ -1,15 +0,0 @@ -baseURL = "https://blog.nsfisis.dev" -languageCode = "ja-JP" -hasCJKLanguage = true -timeZone = "Asia/Tokyo" -title = "REPL: Rest-Eat-Program Loop" -theme = "mypaper" - -[author] -name = "nsfisis" - -[taxonomies] -tag = "tags" - -[outputFormats.rss] -baseName = "feed" diff --git a/content/404.html b/content/404.html new file mode 100644 index 0000000..c0fb882 --- /dev/null +++ b/content/404.html @@ -0,0 +1,32 @@ + + + + + + + + + Page Not Found | REPL: Rest-Eat-Program Loop + + + + +
+ +
+
+
+
+ 404 +
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/content/_index.md b/content/_index.md deleted file mode 100644 index fb1e7ba..0000000 --- a/content/_index.md +++ /dev/null @@ -1,4 +0,0 @@ ---- -title: "" -date: 2021-03-31T01:36:49+09:00 ---- diff --git a/content/posts/2021-03-05/my-first-post.adoc b/content/posts/2021-03-05/my-first-post.adoc new file mode 100644 index 0000000..664dd5c --- /dev/null +++ b/content/posts/2021-03-05/my-first-post.adoc @@ -0,0 +1,13 @@ += My First Post +:description: これはテスト投稿です。これはテスト投稿です。これはテスト投稿です。 +:revision-1: 2021-03-05 公開 + +== Test + +Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod +tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim +veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea +commodo consequat. Duis aute irure dolor in reprehenderit in voluptate +velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint +occaecat cupidatat non proident, sunt in culpa qui officia deserunt +mollit anim id est laborum. diff --git a/content/posts/2021-03-05/my-first-post.md b/content/posts/2021-03-05/my-first-post.md deleted file mode 100644 index 217db9f..0000000 --- a/content/posts/2021-03-05/my-first-post.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: "My First Post" -date: 2021-03-05T23:38:21+09:00 -summary: | - これはテスト投稿です。これはテスト投稿です。これはテスト投稿です。 -changelog: - 2021-03-05: 公開 ---- - -# Test - -Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. diff --git a/content/posts/2021-03-30/phperkaigi-2021.adoc b/content/posts/2021-03-30/phperkaigi-2021.adoc new file mode 100644 index 0000000..e843e83 --- /dev/null +++ b/content/posts/2021-03-30/phperkaigi-2021.adoc @@ -0,0 +1,532 @@ += PHPerKaigi 2021 +:tags: conference, php, phperkaigi +:description: 2021-03-26 から 2021-03-28 にかけて開催された、PHPerKaigi 2021 に参加した。 +:revision-1: 2021-03-30 公開 + +== PHPerKaigi 2021 参加レポ + +2021-03-26 から 2021-03-28 +にかけて開催された、 https://phperkaigi.jp/2021/[PHPerKaigi 2021] +に一般参加者として参加した。 +弊社 https://www.dgcircus.com/[デジタルサーカス株式会社] +(今年1月から勤務) +はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。 + +このようなカンファレンスには初めて参加するのでかねてより心待ちにしていたのだが、生憎2日目から体調を崩してしまい、この記事も途中までとなっている。まだ見ていないセッションも多いが、ひとまず現時点での参加レポを書いておく。 + +発表はトラック A、B に分かれていたのだが、今回はすべて A +トラックを視聴している (切り替えるのが面倒だっただけ)。 + +=== 凡例 + +____ +発表・スライドのメモ (引用ではない) +____ + +感想など + +=== Day 0 前夜祭 (2021/03/27) + +==== 17:30 [A] + +PHP で AWS Lambda + +____ +Rails のプロジェクトを PHPer のメンバのみでメンテ →他のメンバもわかる +PHP にリプレースを検討 + +* サーバレス +* サーバ・インフラの管理が不要 +* アプリケーションコードの知識だけで保守可能 + +ゼロベースで作れる案件が (Railsの件とは別に) +あるため、そちらで試験的に導入? + +AWSの学習 AWS のドキュメント DevelopersIO + +AWS Lambda のカスタムランタイムで PHP を動かす + +サーバのセットアップや維持管理を気にしなくて良い サーバーレスで PHP +を動かすツールがすでにある サーバーレス構築はすんなり + +今は Laravel がルーティングしている Laravel Livewire を Lambda +に載せられないか？ デプロイ方法は？ バッチ処理は？ (Lambda は +15分の制限) + +Lambda でコンテナイメージがサポートされるように + +抽象化されたもの「だけ」しか知らないよりも具象の理解は助けになる +____ + +AWS Lambda のような Function as a Service +はマイクロサービス化における一つの到達点に思えるのだが、これを使って実際に +web サービスを作る具体的なイメージがまだ見えない (注: すべて for me +として書いている)。 + +PHP on AWS Lambda があれだけ簡単に動かせるのには驚いた。 + +勝手に AWS Lambda だとフットプリントの軽さが求められそう (= PHP + +Laravel などでは動かなさそう) +だという先入観を持っていたのだが、この発表のデモによればそうでもないらしい。 + +==== 18:10 [A] + +大規模サイトの SEO + +____ +大規模サイト (100万ページ以上) Google の基準 + +クロールバジェットを意識したSEO + +大規模サイトでコンテンツが中頻度 (1回/週) で更新 OR 中規模サイト +(10,000以上) でコンテンツが目まぐるしく変更される +これを満たさないなら、クロールバジェットを考えなくてもいい + +サーチコンソール 「カバレッジ」の「除外」 +多すぎるのは問題→クロールバジェットを浪費している + +* クエリの順番を決める +* 空の値のルールを決めておく +* リダイレクトすればインデックスはうまくいく +* リンクが存在する限りクロールはされる + +リニューアル前のURL + +インデックスは移行される +リンクのURLが存在する限り、別のURLとしてクロールされる +リダイレクトされるとはいえ、リニューアル前のURLは移行した方が良い +リニューアルで無視されるようになったパラメータも注意 + +robotes.txt で拒否しているのにクロールされる 一時的に拒否を外して 404 や +301 を読ませる 内部リンクを確認する JS でのリンクに書き換え + +クエリパラメータからURLのパスに `/tokyo?area=HOGE` → `/tokyo/HOGE` + +URL 設計だいじ +____ + +SEO (Search Engine Optimization) +は大して知らないので新鮮な話が多かった。その分語れることも少ない……。 + +==== 18:50 [A] + +____ +知覚可能 操作可能 理解可能 堅牢 ちゃんとしたHTMLを書く +(閉じタグ・入れ子構造など) + +* 標準の HTML を適切に使う +* WAI-ARIA +* キーボードフレンドリー +* マシンフレンドリー +* SEOフレンドリー + +button タグ →キーボード h1 タグ →スクリーンリーダー・クローラ a タグ + +WAI-ARIA HTML では表現できないセマンティクスを追加する + +* ロール +** 何をするのか？ +** ユーザーアクションによって変化しない +* プロパティ +** 関連づけられたデータ +* ステート +** 現在の状態 + +まずは標準の HTML 要素で解決する 何でもかんでも WAI-ARIA +を使えばいいというものではない + +マウスホバーでツールチップが出てくるが、キーボード操作では出てこない + +VoiceOver + +全ての属性を使う必要はない +あくまでアクセシビリティを上げるための方法の一つにすぎない +____ + +つい最近 WAI-ARIA +についての記事を読んだばかりだったので個人的にタイムリーな話題だった。(あまりこの言葉を使いたくないのだが) +いわゆる「健常者」にとって、こうした問題を普段の生活の中で意識するのは難しい。だからこそ情報へのアンテナは張っておくようにしたい。 + +==== 19:30 [A] + +PHP で FUSE + +個人的に楽しみだった発表。 + +____ +VFS (virtual filesystem) vs 具体的なファイルシステム + +最適な実装方法は状況により異なる + +アプリケーションに見せるAPIは変えずに実装を隠蔽する→VFS + +カーネルのプログラムを作るのは難しい +* 権限がデカすぎる +* システム全体がクラッシュ +* セキュリティリスク +* 開発サイクルを回しづらい +* ネイティブコードにコンパイルされる言語である必要がある + +Filesystem in USEr space (FUSE) + +* 特定の C の関数を呼ぶことで filesystem が作れる +* FFI を持つ言語なら FUSE が使える + +SSHFS / s3fs / Docker Desktop + +Linux 以外でも使える + +* dokany (on Windows) +* osxfuse + +VFS: システムコールが呼ばれると、ファイルシステムによってコール FUSE: +カーネル空間からユーザ空間へ通信 + +高レベルなラッパで型をつける + +PHP 以外では Wordpress を FUSE にマウントする実装がある (C, Python など) + +* grep できる +* sed できる +* 編集できる +____ + +期待通りの興味深い発表だった。FUSE +自体も今回の発表で知ったのだが、これ本体の実装を見るのも面白そうだ。 +この発表を聞きながらファイルシステムにマウントできそうなものを考えていたのだが、およそ木構造をしているものすべてと言えそうだ +(ハンマーしか持っていないと云々)。何かできそうだがなかなか思いつかない。 + +=== Day 1 (2021/03/27) + +==== 10:50 [A] + +ATDD + +____ +* ユーザーストーリー +* ユニットテスト +* CI/CD + +ユーザストーリーの受け入れ条件が曖昧になりがち +デグレチェックがユニットレベルでは収まらない場合、手動で同じシナリオをテストしている + +Q2の強化 アジャイルテストの4象限 + +技術面/ビジネス面 +開発チーム支援(コーディング前・コーディング中)/製品批評(コーディング後) + +* Q1: 技術面 & チーム支援 +** TDD +** ユニットテストなど +* Q2: ビジネス面 & チーム支援 +** ATDD +** ビジネス面の受け入れテストで駆動する + +Agile Alliance ユーザストーリーのスキルレベルを高める + +テストピラミッド + +* UI Tests +* Service Tests +* Unit Tests +* 異なる粒度のテストを書く +* 高レベルになるほど、持つべきテストは少なくなる +** ピラミッド型になる + +高レベルテストが多すぎる→アイスクリームコーン　アンチパターン + +ATDD (Acceptance TDD) API経由・UI経由での高レベルテスト E2E test + +ストーリ受け入れテスト + +入れ子のフィードバックループ ATDD(外側) と TDD(内側) + +外部品質・内部品質 + +バーティカルスライスのデリバリー + +* cucumber +* gauge +* behat + +ユビキタス言語 手動テストもspecに書く 自動化は可能だがコスパが悪い +失敗することがわかっているテスト(レッドテスト)はCIから外す +失敗時の原因究明が難しい 饒舌なエラーメッセージ 状況のスナップショット + +Continuous Testing +____ + +User Acceptance Test (UAT) +くらいの規模になると個人開発・趣味開発では触れない領域なので、大いに勉強になった。スライドに添付されている資料が相当に充実していたので、これを読むのが本番といった様相すら感じる。 +高レベルテストの自動化は現在のプロジェクトでも感じており、自動化のチャンスは伺っている。とはいえセッションでも指摘されているように自動化することにコストがかかりすぎる領域があるのも事実で、そのバランスが難しい。 + +==== 11:50 [A] + +型解析を用いたリファクタリング + +型のある世界で生きてきた身として大いに楽しみにしていた発表。 + +____ +* PHPStan +* Phan +* Psalm + +autoload も認識できる bootstrapFiles + +編集箇所と利用箇所を CI でチェック ルールレベルを徐々に引き上げていく +警告が多すぎると見落としてしまう・無視されやすくなる + +型がついていないことによるエラーが多い + +型よりも詳細な検査 `Util_Assert::min` + +SQL を静的解析 placeholder の型付け + +警告レベルを低いレベルから導入 タイプヒントを積極的に書いていく PHPStan +の拡張を追加する +____ + +昨今、動的型付き言語での型宣言・型アノテーション・型ヒントの導入が相次いでいる。長らく静的型付き言語を書いてきた私からすると、ようやく気づいたかといったところだが、ともかく型を導入する言語が増えてきた。 +今のプロジェクトでも新しく追加するコードには型をつけるよう努めているが、どうしても古いコードには型がついていない。個人的には型のないコードに対してどう型を自動的に付けるかという点に興味があり、その点で +Ruby の typeprof には注目している。 + +==== 12:30 [A] + +昼食をとっていた。事前に何か食料を買っておくべきだった。 + +==== 13:10 [A] + +Documentation as Code + +この発表も以前から非常に楽しみにしていた。 + +____ +開発開始までのオーバーヘッド 新規にチームにジョイン +担当範囲外の機能を理解 オンボーディングのコスト + +PHPerKaigi 2020 で発表あり + +継続的にシステムの理解を助けるドキュメント + +継続的ドキュメンテーション システムとドキュメントの乖離 + +書いてあることが間違っている・足りない * 徐々にずれていく * +システムの更新タイミングとドキュメントの更新タイミングに差がある + +システムとドキュメントは対応関係がある * 間違ったドキュメント * +存在しないドキュメント + +システムとドキュメントの乖離を定量化する 継続的に +システムの更新に近いタイミングで ドキュメントを更新し続ける + +Documentation as Code + +コードと同じツールでドキュメントを書く * issue tracker * vcs * plain +text markup * automation + +開発者 システム ドキュメント 構造化データ ソフトウェア + +システムから構造化データを抽出する PHPDoc OpenAPI + +ビュー 関心ごとに合わせてアーキテクチャを一つ以上の側面(断面)で説明する + +ビューの単位でドキュメントに + +スタックトレースからのドキュメント生成 +____ + +ドキュメントの管理は現プロジェクトでも課題と感じている。作られた当初は正しくても、実態と乖離していくのを止めるのは困難を極める。全体的に興味深い発表だったが、特にスタックトレースからのドキュメント生成というアイデアに惹かれるものを感じた。スタックトレースという実態と不可分な +(乖離しない) +情報を起点にするのは理にかなっている。問題はトレースをいつ、どう取るかだろうか。それを自動化しなければ、実態との乖離が避けられないだろう。 + +==== 14:10 [A] + +cookie による session 管理 + +全体的に基本的な話だったので特に触れない。Cookie +やセッションの話としては非常に分かりやすくまとめられていたので、知らない人が学ぶにはいい教材だろう。 + +==== 14:50 [A] + +PHP のエラーと例外 + +____ +エラー PHPエンジンがエラーを通知する 例外 プログラムが投げる + +PHP7-8とエラー + +PHPエンジンのエラーの一部が に変換されるようになった → try-catch +で捕捉できる + +は例外とは異なる + +PHP8 でエラーレベルの引き上げ + +* 捕捉すべきもの +** recoverable +* 捕捉すべきでないもの +** unrecoverable +** 開発時に対処できるもの + +例外 * 捕捉して事後処理 * 捕捉せず(or 捕捉した上で)さらに上に是非を問う + +開発段階で例外を把握し、ハンドリングを考えておく + +と + +はキャッチすべきでない + +* {blank} ++ +** 本番で起きてはいけない +* {blank} ++ +** 本番で起きてはいけない →生じないのだから捕捉もしない +* {blank} ++ +** 起こるかもしれないので本番環境でも考慮する + +捕捉して対応するのではなく、未然に防ぐ + +独自例外を使う を投げてしまうと、 catch ()せざるを得ない →catch +範囲が広すぎる + +SPL の例外を使う + +例外翻訳 +上位のレイヤが下位のレイヤの例外を捕捉し、上位レイヤのAPIに「翻訳」する +下位レイヤの知識に依存させない + +@throws 捕捉してほしい例外を書き連ねておく + +呼び出しもとに負わせたい責任 +____ + +PHP を学んでいる途中の私としては、今まさに聞きたい発表だった (現時点で +PHP を書き始めてから 4ヶ月ほどになる)。 + +個人的に例外やエラーを最もうまく扱っているのは Go、Swift、Rust、Haskell +などのエラーを「値として」扱う言語だと思っている。try-catch +は通常の処理フローを完全に壊してしまう上、構文としても重すぎる。値としてのエラー通知は +C言語時代への回帰ともいえるが、その頃と異なるのはエラーを暗黙のうちに握り潰すことがないということだ。これらの言語は型を持っており、静的に検証ができる +(C のそれはまともな型付けではない。念のため)。 + +PHP +のように、すでに例外が言語システムに根ざしている言語ではどうすればよいか。この場合も同じく静的検証の力を借りることになるだろう。 + +==== 15:30 [A] + +Laravel のメール認証 + +Laravel +の知識がない私にはまったくついていけなかった。また、個人的にタイトルがややミスリーディングに感じた。 + +==== 16:10 [A] + +gRPC + +____ +Unary RPCs Server streaming RPCs Client streaming RPCs Bidirectional +streaming RPCs + +Protobuf + +実装とAPIが乖離しにくい 自動生成 複数言語でも相互に使える + +マイクロサービスのサービス通信 スマホアプリ ゲームサーバ + +PHP では？ + +PHP ではストリーミングが難しい リクエストごとにプロセスが使い捨て + +PHP ではgRPCのクライアントしか対応していない + +gRPC-Web ブラウザで扱うためのJSライブラリ+プロトコル + +HTTP/1.1 でも使える Unary RPC と Server streaming RPC のみ + +Envoy Nginx などで相互に gRPC と gRPC-Web で変換 + +Amp イベント駆動な並行処理のフレームワーク + +HTTP/2 対応 + +C#のgRPC-Webが楽 +____ + +(発表の中でもまさに同じことをおっしゃっていたが) PHP +以外の方が向いているだろう、というのが第一の感想である。gRPC +はそれ自体というよりも Protobuf +というエコシステムに乗れることのメリットが大きいと感じる。そのエコシステムにうまく乗れない時点で、うーんという感じ。 + +==== 16:50 [A] + +アーキテクチャテスト + +____ +Independent Core Layer Pattern + +開発初期のアーキテクチャが崩れる +アーキテクチャ観点のコードレビューができない + +どこにクラスを置けばよいか？ ドキュメントがない + +アーキテクチャ設計に関する知識が属人化・暗黙知化 + +ガイドライン * 最初にルールを決めるのは簡単 * +ルール通り作り始めるのも簡単 * +→維持するのが難しい、人が決めたものゆえ壊れやすい + +PHP の特性 * クラスは public * 可視性の制御が public / protected / +private のみ * 依存関係の制御が困難 + +アーキテクチャテスト +クラスの依存関係や実装ルールをコードとして表現し、自動テスト化する + +* deptrac +* phpat + +Independent Core Layer Pattern + +アーキテクチャテストの失敗 * 実装誤り * or アーキテクチャが適切でない * +開発の過程でフィードバックしていく + +モジュラーモノリス→マイクロサービスへ +____ + +=== Day 2 (2021/03/28) + +冒頭に書いた通り、2日目から体調が悪くまともに聴けていない。途中までは頭痛を我慢しつつ見ていたのだが、まともに入ってこなかった。 + +残念ではあるが、いずれにせよ見られていない発表は他にもあるので、今週末にでもまとめて見ようと思う。 + +=== 全体の感想 + +Day 2 +にほとんど参加できなかったのは残念だが、イベント自体は大変楽しく、また興味深いものであった。自分がまったく知らない領域の話を聞けるのはこうしたイベントならではだと感じる。オンライン開催ゆえ現地に行く必要がなく、気軽に参加できたのも +(特に初参加者として) 嬉しいポイントだった。 + +今回、雑談/登壇者への質問等向けに Discord +サーバもあったのだが、こちらは参加こそしたものの ROM +のままになってしまった。発表に1ウィンドウ、メモを書くのに1ウィンドウ、Discord +表示に +1ウィンドウで私にはもう脳のリソースとディスプレイのスペースが追いつかなかった +(さらにいうと Zoom +でアンカンファレンスもやっていたようだ。こちらはまったく参加していない)。 + +1つ個人的な反省点としては、一つ一つのセッションを真剣に聞き過ぎたというものがある。もっと適当に聞いておけばよかった。これだけだと大変語弊があるのだが、言い方を変えると、Discord +しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。 +まあ初カンファレンスだし、とお茶を濁しておこう。 + +さて、カンファレンスで一つ気になったことがある。それは、Discord +という書き込み場所が増えたことでニコ生のコメントの流量が吸い取られてしまったのではないか、という点だ。ニコニコだけ見ていると過疎っているかのように見えた発表も、Discord +の方では盛り上がっている、というのを何度か見かけた。ニコニコのコメント方式は盛り上がりを如実に反映するが、逆もまたしかり。Discord +があったこと自体はプラスだったと思うが、この点はマイナスだったのではないかと感じる。 + +''''' + +最後になりましたが、毎年の PHPerKaigi +開催にご尽力されている皆様、スピーカーの皆様、楽しい3日間でした。ありがとうございました！ +(ずっと常体で書いてしまったのでいきなり仏頂面から笑顔になったようで気持ち悪い) + +ではまた来年。 diff --git a/content/posts/2021-03-30/phperkaigi-2021.md b/content/posts/2021-03-30/phperkaigi-2021.md deleted file mode 100644 index 8d76a36..0000000 --- a/content/posts/2021-03-30/phperkaigi-2021.md +++ /dev/null @@ -1,554 +0,0 @@ ---- -title: "PHPerKaigi 2021" -date: 2021-03-30T23:22:40+09:00 -tags: ["conference", "php", "phperkaigi"] -summary: | - 2021-03-26 から 2021-03-28 にかけて開催された、PHPerKaigi 2021 に参加した。 -changelog: - 2021-03-30: 公開 ---- - -# PHPerKaigi 2021 参加レポ - -2021-03-26 から 2021-03-28 にかけて開催された、[PHPerKaigi 2021](https://phperkaigi.jp/2021/) に一般参加者として参加した。 -弊社[デジタルサーカス株式会社](https://www.dgcircus.com/) (今年1月から勤務) はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。 - -このようなカンファレンスには初めて参加するのでかねてより心待ちにしていたのだが、生憎2日目から体調を崩してしまい、この記事も途中までとなっている。まだ見ていないセッションも多いが、ひとまず現時点での参加レポを書いておく。 - -発表はトラック A、B に分かれていたのだが、今回はすべて A トラックを視聴している (切り替えるのが面倒だっただけ)。 - - -## 凡例 - -> 発表・スライドのメモ (引用ではない) - -感想など - - -## Day 0 前夜祭 (2021/03/27) - -### 17:30 [A] - -PHP で AWS Lambda - -> Rails のプロジェクトを PHPer のメンバのみでメンテ -> →他のメンバもわかる PHP にリプレースを検討 -> -> サーバレス -> * サーバ・インフラの管理が不要 -> * アプリケーションコードの知識だけで保守可能 -> -> ゼロベースで作れる案件が (Railsの件とは別に) あるため、そちらで試験的に導入? -> -> AWSの学習 -> AWS のドキュメント -> DevelopersIO -> -> AWS Lambda のカスタムランタイムで PHP を動かす -> -> サーバのセットアップや維持管理を気にしなくて良い -> サーバーレスで PHP を動かすツールがすでにある -> サーバーレス構築はすんなり -> -> 今は Laravel がルーティングしている -> Laravel Livewire を Lambda に載せられないか？ -> デプロイ方法は？ -> バッチ処理は？ (Lambda は 15分の制限) -> -> Lambda でコンテナイメージがサポートされるように -> -> 抽象化されたもの「だけ」しか知らないよりも具象の理解は助けになる - -AWS Lambda のような Function as a Service はマイクロサービス化における一つの到達点に思えるのだが、これを使って実際に web サービスを作る具体的なイメージがまだ見えない (注: すべて for me として書いている)。 - -PHP on AWS Lambda があれだけ簡単に動かせるのには驚いた。 - -勝手に AWS Lambda だとフットプリントの軽さが求められそう (= PHP + Laravel などでは動かなさそう) だという先入観を持っていたのだが、この発表のデモによればそうでもないらしい。 - - - -### 18:10 [A] - -大規模サイトの SEO - -> 大規模サイト (100万ページ以上) -> Google の基準 -> -> クロールバジェットを意識したSEO -> -> 大規模サイトでコンテンツが中頻度 (1回/週) で更新 OR 中規模サイト (10,000以上) でコンテンツが目まぐるしく変更される -> これを満たさないなら、クロールバジェットを考えなくてもいい -> -> サーチコンソール -> 「カバレッジ」の「除外」 -> 多すぎるのは問題→クロールバジェットを浪費している -> -> * クエリの順番を決める -> * 空の値のルールを決めておく -> * リダイレクトすればインデックスはうまくいく -> * リンクが存在する限りクロールはされる -> -> リニューアル前のURL -> -> インデックスは移行される -> リンクのURLが存在する限り、別のURLとしてクロールされる -> リダイレクトされるとはいえ、リニューアル前のURLは移行した方が良い -> リニューアルで無視されるようになったパラメータも注意 -> -> robotes.txt で拒否しているのにクロールされる -> 一時的に拒否を外して 404 や 301 を読ませる -> 内部リンクを確認する -> JS でのリンクに書き換え -> -> クエリパラメータからURLのパスに -> `/tokyo?area=HOGE` → `/tokyo/HOGE` -> -> URL 設計だいじ - -SEO (Search Engine Optimization) は大して知らないので新鮮な話が多かった。その分語れることも少ない……。 - - -### 18:50 [A] - -> 知覚可能 -> 操作可能 -> 理解可能 -> 堅牢 ちゃんとしたHTMLを書く (閉じタグ・入れ子構造など) -> -> * 標準の HTML を適切に使う -> * WAI-ARIA -> -> * キーボードフレンドリー -> * マシンフレンドリー -> * SEOフレンドリー -> -> button タグ -> →キーボード -> h1 タグ -> →スクリーンリーダー・クローラ -> a タグ -> -> WAI-ARIA -> HTML では表現できないセマンティクスを追加する -> -> * ロール -> * 何をするのか？ -> * ユーザーアクションによって変化しない -> * プロパティ -> * 関連づけられたデータ -> * ステート -> * 現在の状態 -> -> まずは標準の HTML 要素で解決する -> 何でもかんでも WAI-ARIA を使えばいいというものではない -> -> マウスホバーでツールチップが出てくるが、キーボード操作では出てこない -> -> VoiceOver -> -> 全ての属性を使う必要はない -> あくまでアクセシビリティを上げるための方法の一つにすぎない - -つい最近 WAI-ARIA についての記事を読んだばかりだったので個人的にタイムリーな話題だった。(あまりこの言葉を使いたくないのだが) いわゆる「健常者」にとって、こうした問題を普段の生活の中で意識するのは難しい。だからこそ情報へのアンテナは張っておくようにしたい。 - - -### 19:30 [A] - -PHP で FUSE - -個人的に楽しみだった発表。 - -> VFS (virtual filesystem) vs 具体的なファイルシステム -> -> 最適な実装方法は状況により異なる -> -> アプリケーションに見せるAPIは変えずに実装を隠蔽する→VFS -> -> カーネルのプログラムを作るのは難しい -> * 権限がデカすぎる -> * システム全体がクラッシュ -> * セキュリティリスク -> * 開発サイクルを回しづらい -> * ネイティブコードにコンパイルされる言語である必要がある -> -> Filesystem in USEr space (FUSE) -> * 特定の C の関数を呼ぶことで filesystem が作れる -> * FFI を持つ言語なら FUSE が使える -> -> SSHFS / s3fs / Docker Desktop -> -> Linux 以外でも使える -> * dokany (on Windows) -> * osxfuse -> -> VFS: システムコールが呼ばれると、ファイルシステムによってコール -> FUSE: カーネル空間からユーザ空間へ通信 -> -> 高レベルなラッパで型をつける -> -> PHP 以外では Wordpress を FUSE にマウントする実装がある (C, Python など) -> -> * grep できる -> * sed できる -> * 編集できる - -期待通りの興味深い発表だった。FUSE 自体も今回の発表で知ったのだが、これ本体の実装を見るのも面白そうだ。 -この発表を聞きながらファイルシステムにマウントできそうなものを考えていたのだが、およそ木構造をしているものすべてと言えそうだ (ハンマーしか持っていないと云々)。何かできそうだがなかなか思いつかない。 - - - -## Day 1 (2021/03/27) - -### 10:50 [A] - -ATDD - -> * ユーザーストーリー -> * ユニットテスト -> * CI/CD -> -> ユーザストーリーの受け入れ条件が曖昧になりがち -> デグレチェックがユニットレベルでは収まらない場合、手動で同じシナリオをテストしている -> -> Q2の強化 -> アジャイルテストの4象限 -> -> 技術面/ビジネス面 -> 開発チーム支援(コーディング前・コーディング中)/製品批評(コーディング後) -> -> * Q1: 技術面 & チーム支援 -> * TDD -> * ユニットテストなど -> * Q2: ビジネス面 & チーム支援 -> * ATDD -> * ビジネス面の受け入れテストで駆動する -> -> Agile Alliance -> ユーザストーリーのスキルレベルを高める -> -> テストピラミッド -> -> * UI Tests -> * Service Tests -> * Unit Tests -> -> * 異なる粒度のテストを書く -> * 高レベルになるほど、持つべきテストは少なくなる -> * ピラミッド型になる -> -> 高レベルテストが多すぎる→アイスクリームコーン　アンチパターン -> -> ATDD (Acceptance TDD) -> API経由・UI経由での高レベルテスト E2E test -> -> ストーリ受け入れテスト -> -> 入れ子のフィードバックループ -> ATDD(外側) と TDD(内側) -> -> 外部品質・内部品質 -> -> バーティカルスライスのデリバリー -> -> * cucumber -> * gauge -> * behat -> -> ユビキタス言語 -> 手動テストもspecに書く -> 自動化は可能だがコスパが悪い -> 失敗することがわかっているテスト(レッドテスト)はCIから外す -> 失敗時の原因究明が難しい -> 饒舌なエラーメッセージ -> 状況のスナップショット -> -> Continuous Testing - -User Acceptance Test (UAT) くらいの規模になると個人開発・趣味開発では触れない領域なので、大いに勉強になった。スライドに添付されている資料が相当に充実していたので、これを読むのが本番といった様相すら感じる。 -高レベルテストの自動化は現在のプロジェクトでも感じており、自動化のチャンスは伺っている。とはいえセッションでも指摘されているように自動化することにコストがかかりすぎる領域があるのも事実で、そのバランスが難しい。 - - -### 11:50 [A] - -型解析を用いたリファクタリング - -型のある世界で生きてきた身として大いに楽しみにしていた発表。 - -> * PHPStan -> * Phan -> * Psalm -> -> autoload も認識できる -> bootstrapFiles -> -> 編集箇所と利用箇所を CI でチェック -> ルールレベルを徐々に引き上げていく -> 警告が多すぎると見落としてしまう・無視されやすくなる -> -> 型がついていないことによるエラーが多い -> -> 型よりも詳細な検査 `Util_Assert::min` -> -> SQL を静的解析 -> placeholder の型付け -> -> 警告レベルを低いレベルから導入 -> タイプヒントを積極的に書いていく -> PHPStan の拡張を追加する - -昨今、動的型付き言語での型宣言・型アノテーション・型ヒントの導入が相次いでいる。長らく静的型付き言語を書いてきた私からすると、ようやく気づいたかといったところだが、ともかく型を導入する言語が増えてきた。 -今のプロジェクトでも新しく追加するコードには型をつけるよう努めているが、どうしても古いコードには型がついていない。個人的には型のないコードに対してどう型を自動的に付けるかという点に興味があり、その点で Ruby の typeprof には注目している。 - - -### 12:30 [A] - -昼食をとっていた。事前に何か食料を買っておくべきだった。 - - -### 13:10 [A] - -Documentation as Code - -この発表も以前から非常に楽しみにしていた。 - -> 開発開始までのオーバーヘッド -> 新規にチームにジョイン -> 担当範囲外の機能を理解 -> オンボーディングのコスト -> -> PHPerKaigi 2020 で発表あり -> -> 継続的にシステムの理解を助けるドキュメント -> -> 継続的ドキュメンテーション -> システムとドキュメントの乖離 -> -> 書いてあることが間違っている・足りない -> * 徐々にずれていく -> * システムの更新タイミングとドキュメントの更新タイミングに差がある -> -> システムとドキュメントは対応関係がある -> * 間違ったドキュメント -> * 存在しないドキュメント -> -> システムとドキュメントの乖離を定量化する -> 継続的に -> システムの更新に近いタイミングで ドキュメントを更新し続ける -> -> Documentation as Code -> -> コードと同じツールでドキュメントを書く -> * issue tracker -> * vcs -> * plain text markup -> * automation -> -> 開発者 -> システム -> ドキュメント -> 構造化データ -> ソフトウェア -> -> システムから構造化データを抽出する -> PHPDoc -> OpenAPI -> -> ビュー 関心ごとに合わせてアーキテクチャを一つ以上の側面(断面)で説明する -> -> ビューの単位でドキュメントに -> -> スタックトレースからのドキュメント生成 - -ドキュメントの管理は現プロジェクトでも課題と感じている。作られた当初は正しくても、実態と乖離していくのを止めるのは困難を極める。全体的に興味深い発表だったが、特にスタックトレースからのドキュメント生成というアイデアに惹かれるものを感じた。スタックトレースという実態と不可分な (乖離しない) 情報を起点にするのは理にかなっている。問題はトレースをいつ、どう取るかだろうか。それを自動化しなければ、実態との乖離が避けられないだろう。 - - - -### 14:10 [A] - -cookie による session 管理 - -全体的に基本的な話だったので特に触れない。Cookie やセッションの話としては非常に分かりやすくまとめられていたので、知らない人が学ぶにはいい教材だろう。 - - - -### 14:50 [A] - -PHP のエラーと例外 - -> エラー PHPエンジンがエラーを通知する -> 例外 プログラムが投げる -> -> PHP7-8とエラー -> -> PHPエンジンのエラーの一部が \Error に変換されるようになった -> → try-catch で捕捉できる -> -> \Error は例外とは異なる -> -> PHP8 でエラーレベルの引き上げ -> -> * 捕捉すべきもの -> * recoverable -> * 捕捉すべきでないもの -> * unrecoverable -> * 開発時に対処できるもの -> -> 例外 -> * 捕捉して事後処理 -> * 捕捉せず(or 捕捉した上で)さらに上に是非を問う -> -> 開発段階で例外を把握し、ハンドリングを考えておく -> -> \Throwable \Exception と \Error -> -> \Error はキャッチすべきでない -> -> * \Error -> * 本番で起きてはいけない -> * \LogicException -> * 本番で起きてはいけない -> →生じないのだから捕捉もしない -> -> * \RuntimeException -> * 起こるかもしれないので本番環境でも考慮する -> -> 捕捉して対応するのではなく、未然に防ぐ -> -> 独自例外を使う -> \Exception を投げてしまうと、 -> catch (\Exception)せざるを得ない -> →catch 範囲が広すぎる -> -> SPL の例外を使う -> -> 例外翻訳 -> 上位のレイヤが下位のレイヤの例外を捕捉し、上位レイヤのAPIに「翻訳」する -> 下位レイヤの知識に依存させない -> -> @throws -> 捕捉してほしい例外を書き連ねておく -> -> 呼び出しもとに負わせたい責任 - -PHP を学んでいる途中の私としては、今まさに聞きたい発表だった (現時点で PHP を書き始めてから 4ヶ月ほどになる)。 - -個人的に例外やエラーを最もうまく扱っているのは Go、Swift、Rust、Haskell などのエラーを「値として」扱う言語だと思っている。try-catch は通常の処理フローを完全に壊してしまう上、構文としても重すぎる。値としてのエラー通知は C言語時代への回帰ともいえるが、その頃と異なるのはエラーを暗黙のうちに握り潰すことがないということだ。これらの言語は型を持っており、静的に検証ができる (C のそれはまともな型付けではない。念のため)。 - -PHP のように、すでに例外が言語システムに根ざしている言語ではどうすればよいか。この場合も同じく静的検証の力を借りることになるだろう。 - - -### 15:30 [A] - -Laravel のメール認証 - -Laravel の知識がない私にはまったくついていけなかった。また、個人的にタイトルがややミスリーディングに感じた。 - - -### 16:10 [A] - -gRPC - -> Unary RPCs -> Server streaming RPCs -> Client streaming RPCs -> Bidirectional streaming RPCs -> -> Protobuf -> -> 実装とAPIが乖離しにくい -> 自動生成 -> 複数言語でも相互に使える -> -> マイクロサービスのサービス通信 -> スマホアプリ -> ゲームサーバ -> -> PHP では？ -> -> PHP ではストリーミングが難しい -> リクエストごとにプロセスが使い捨て -> -> PHP ではgRPCのクライアントしか対応していない -> -> gRPC-Web -> ブラウザで扱うためのJSライブラリ+プロトコル -> -> HTTP/1.1 でも使える -> Unary RPC と Server streaming RPC のみ -> -> Envoy -> Nginx などで相互に gRPC と gRPC-Web で変換 -> -> Amp -> イベント駆動な並行処理のフレームワーク -> -> HTTP/2 対応 -> -> C#のgRPC-Webが楽 - -(発表の中でもまさに同じことをおっしゃっていたが) PHP 以外の方が向いているだろう、というのが第一の感想である。gRPC はそれ自体というよりも Protobuf というエコシステムに乗れることのメリットが大きいと感じる。そのエコシステムにうまく乗れない時点で、うーんという感じ。 - -### 16:50 [A] - -アーキテクチャテスト - -> Independent Core Layer Pattern -> -> 開発初期のアーキテクチャが崩れる -> アーキテクチャ観点のコードレビューができない -> -> どこにクラスを置けばよいか？ -> ドキュメントがない -> -> アーキテクチャ設計に関する知識が属人化・暗黙知化 -> -> ガイドライン -> * 最初にルールを決めるのは簡単 -> * ルール通り作り始めるのも簡単 -> * →維持するのが難しい、人が決めたものゆえ壊れやすい -> -> PHP の特性 -> * クラスは public -> * 可視性の制御が public / protected / private のみ -> * 依存関係の制御が困難 -> -> アーキテクチャテスト -> クラスの依存関係や実装ルールをコードとして表現し、自動テスト化する -> -> * deptrac -> * phpat -> -> Independent Core Layer Pattern -> -> アーキテクチャテストの失敗 -> * 実装誤り -> * or アーキテクチャが適切でない -> * 開発の過程でフィードバックしていく -> -> モジュラーモノリス→マイクロサービスへ - - -## Day 2 (2021/03/28) - -冒頭に書いた通り、2日目から体調が悪くまともに聴けていない。途中までは頭痛を我慢しつつ見ていたのだが、まともに入ってこなかった。 - -残念ではあるが、いずれにせよ見られていない発表は他にもあるので、今週末にでもまとめて見ようと思う。 - - -## 全体の感想 - -Day 2 にほとんど参加できなかったのは残念だが、イベント自体は大変楽しく、また興味深いものであった。自分がまったく知らない領域の話を聞けるのはこうしたイベントならではだと感じる。オンライン開催ゆえ現地に行く必要がなく、気軽に参加できたのも (特に初参加者として) 嬉しいポイントだった。 - -今回、雑談/登壇者への質問等向けに Discord サーバもあったのだが、こちらは参加こそしたものの ROM のままになってしまった。発表に1ウィンドウ、メモを書くのに1ウィンドウ、Discord 表示に 1ウィンドウで私にはもう脳のリソースとディスプレイのスペースが追いつかなかった (さらにいうと Zoom でアンカンファレンスもやっていたようだ。こちらはまったく参加していない)。 - -1つ個人的な反省点としては、一つ一つのセッションを真剣に聞き過ぎたというものがある。もっと適当に聞いておけばよかった。これだけだと大変語弊があるのだが、言い方を変えると、Discord しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。 -まあ初カンファレンスだし、とお茶を濁しておこう。 - -さて、カンファレンスで一つ気になったことがある。それは、Discord という書き込み場所が増えたことでニコ生のコメントの流量が吸い取られてしまったのではないか、という点だ。ニコニコだけ見ていると過疎っているかのように見えた発表も、Discord の方では盛り上がっている、というのを何度か見かけた。ニコニコのコメント方式は盛り上がりを如実に反映するが、逆もまたしかり。Discord があったこと自体はプラスだったと思うが、この点はマイナスだったのではないかと感じる。 - -------- - -最後になりましたが、毎年の PHPerKaigi 開催にご尽力されている皆様、スピーカーの皆様、楽しい3日間でした。ありがとうございました！ -(ずっと常体で書いてしまったのでいきなり仏頂面から笑顔になったようで気持ち悪い) - -ではまた来年。 diff --git a/content/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes.adoc b/content/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes.adoc new file mode 100644 index 0000000..afa0f3f --- /dev/null +++ b/content/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes.adoc @@ -0,0 +1,106 @@ += [C++] 属性構文の属性名にはキーワードが使える +:tags: cpp, cpp17 +:description: C++ の属性構文の属性名には、キーワードが使える。ネタ記事。 +:revision-1: 2021-10-02 Qiita から移植 + +この記事は Qiita から移植してきたものです。 元 URL: +https://qiita.com/nsfisis/items/94090937bcf860cfa93b + +''''' + +タイトル落ち。まずはこのコードを見て欲しい。 + +[source,cpp] +---- +#include + +[[alignas]] [[alignof]] [[and]] [[and_eq]] [[asm]] [[auto]] [[bitand]] +[[bitor]] [[bool]] [[break]] [[case]] [[catch]] [[char]] [[char16_t]] +[[char32_t]] [[class]] [[compl]] [[const]] [[const_cast]] [[constexpr]] +[[continue]] [[decltype]] [[default]] [[delete]] [[do]] [[double]] +[[dynamic_cast]] [[else]] [[enum]] [[explicit]] [[export]] [[extern]] [[false]] +[[final]] [[float]] [[for]] [[friend]] [[goto]] [[if]] [[inline]] [[int]] +[[long]] [[mutable]] [[namespace]] [[new]] [[noexcept]] [[not]] [[not_eq]] +[[nullptr]] [[operator]] [[or]] [[or_eq]] [[override]] [[private]] +[[protected]] [[public]] [[register]] [[reinterpret_cast]] [[return]] [[short]] +[[signed]] [[sizeof]] [[static]] [[static_assert]] [[static_cast]] [[struct]] +[[switch]] [[template]] [[this]] [[thread_local]] [[throw]] [[true]] [[try]] +[[typedef]] [[typeid]] [[typename]] [[union]] [[unsigned]] +[[virtual]] [[void]] [[volatile]] [[wchar_t]] [[while]] [[xor]] [[xor_eq]] +// [[using]] +int main() { + std::cout << "Hello, World!" << std::endl; +} +---- + +____ +コンパイラのバージョン $ clang++ –version Apple clang version 11.0.0 +(clang-1100.0.33.8) Target: x86_64-apple-darwin19.6.0 Thread model: +posix InstalledDir: +/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin + +コンパイルコマンド (C++17指定) $ clang++ –std=c++17 hoge.cpp +____ + +この記事から得られるものはこれ以上ないので以下は蛇足になる。 + +別件で cppreference.com の +https://en.cppreference.com/w/cpp/language/identifiers[identifier +のページ] を読んでいた時、次の文が目に止まった。 + +____ +* the identifiers that are keywords cannot be used for other purposes; +** The only place they can be used as non-keywords is in an +attribute-token. (e.g. [[private]] is a valid attribute) (since C++11) +____ + +キーワードでも属性として指定する場合は非キーワードとして使えるらしい。 +実際にやってみる。 + +同サイトの https://en.cppreference.com/w/cpp/keyword[keywords のページ] +から一覧を拝借し、上のコードが出来上がった (C++17 +においてキーワードでないものなど、一部省いている)。 大量の警告 (unknown +attribute `〇〇' ignored) +がコンパイラから出力されるが、コンパイルできる。 + +上のコードでは `[[using]]` をコメントアウトしているが、これは `using` +キーワードのみ属性構文の中で意味を持つからであり、このコメントアウトを外すとコンパイルに失敗する。 + +[source,cpp] +---- +// using の例 +[[using foo: attr1, attr2]] int x; // [[foo::attr1, foo::attr2]] の糖衣構文 +---- + +C++17 の仕様も見てみる (正確には標準化前のドラフト)。 + +引用元: https://timsong-cpp.github.io/cppwp/n4659/dcl.attr#grammar-4 + +____ +If a keyword or an alternative token that satisfies the syntactic +requirements of an identifier is contained in an attribute-token, it is +considered an identifier. +____ + +「`identifier` の構文上の要件を満たすキーワードまたは代替トークンが +`attribute-token` に含まれている場合、`identifier` +とみなされる」とある。どうやら間違いないようだ。 + +ところで、代替トークン (alternative token) とは `and` (`&`) や `bitor` +(`|`) などのことだが、`identifier` +の構文上の要件を満たさないような代替トークンなどあるのか？ +疑問に思って調べたところ、代替トークンという語にはダイグラフも含まれるらしい +(参考: +https://timsong-cpp.github.io/cppwp/n4659/lex.digraph[同ドラフト]) + +* `<%` → `{` +* `%>` → `}` +* `<:` → `[` +* `:>` → `]` +* `%:` → `#` +* `%:%:` → `##` + +「`identifier` +の構文上の要件を満たさないような代替トークン」はこれらが当てはまると思われる。 + +調べた感想: 字句解析器か構文解析器が辛そう diff --git a/content/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes.md b/content/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes.md deleted file mode 100644 index 87202cb..0000000 --- a/content/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes.md +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: "[C++] 属性構文の属性名にはキーワードが使える [[void]] [[for]]" -date: 2021-10-02T09:38:30+09:00 -tags: ["cpp", "cpp17"] -summary: | - C++ の属性構文の属性名には、キーワードが使える。ネタ記事。 -changelog: - 2021-10-02: Qiita から移植 ---- - - -この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/94090937bcf860cfa93b - - ------------------------------------ - - -タイトル落ち。まずはこのコードを見て欲しい。 - -```cpp -#include - -[[alignas]] [[alignof]] [[and]] [[and_eq]] [[asm]] [[auto]] [[bitand]] -[[bitor]] [[bool]] [[break]] [[case]] [[catch]] [[char]] [[char16_t]] -[[char32_t]] [[class]] [[compl]] [[const]] [[const_cast]] [[constexpr]] -[[continue]] [[decltype]] [[default]] [[delete]] [[do]] [[double]] -[[dynamic_cast]] [[else]] [[enum]] [[explicit]] [[export]] [[extern]] [[false]] -[[final]] [[float]] [[for]] [[friend]] [[goto]] [[if]] [[inline]] [[int]] -[[long]] [[mutable]] [[namespace]] [[new]] [[noexcept]] [[not]] [[not_eq]] -[[nullptr]] [[operator]] [[or]] [[or_eq]] [[override]] [[private]] -[[protected]] [[public]] [[register]] [[reinterpret_cast]] [[return]] [[short]] -[[signed]] [[sizeof]] [[static]] [[static_assert]] [[static_cast]] [[struct]] -[[switch]] [[template]] [[this]] [[thread_local]] [[throw]] [[true]] [[try]] -[[typedef]] [[typeid]] [[typename]] [[union]] [[unsigned]] -[[virtual]] [[void]] [[volatile]] [[wchar_t]] [[while]] [[xor]] [[xor_eq]] -// [[using]] -int main() { - std::cout << "Hello, World!" << std::endl; -} -``` - -> コンパイラのバージョン -> $ clang++ --version -> Apple clang version 11.0.0 (clang-1100.0.33.8) -> Target: x86_64-apple-darwin19.6.0 -> Thread model: posix -> InstalledDir: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin -> -> コンパイルコマンド (C++17指定) -> $ clang++ --std=c++17 hoge.cpp - -この記事から得られるものはこれ以上ないので以下は蛇足になる。 - -別件で cppreference.com の [identifier のページ](https://en.cppreference.com/w/cpp/language/identifiers) を読んでいた時、次の文が目に止まった。 - -> * the identifiers that are keywords cannot be used for other purposes; -> * The only place they can be used as non-keywords is in an attribute-token. (e.g. [[private]] is a valid attribute) (since C++11) - -キーワードでも属性として指定する場合は非キーワードとして使えるらしい。 -実際にやってみる。 - -同サイトの [keywords のページ] (https://en.cppreference.com/w/cpp/keyword) から一覧を拝借し、上のコードが出来上がった (C++17 においてキーワードでないものなど、一部省いている)。 -大量の警告 (unknown attribute '〇〇' ignored) がコンパイラから出力されるが、コンパイルできる。 - -上のコードでは `[[using]]` をコメントアウトしているが、これは `using` キーワードのみ属性構文の中で意味を持つからであり、このコメントアウトを外すとコンパイルに失敗する。 - -```cpp -// using の例 -[[using foo: attr1, attr2]] int x; // [[foo::attr1, foo::attr2]] の糖衣構文 -``` - -C++17 の仕様も見てみる (正確には標準化前のドラフト)。 - -引用元: https://timsong-cpp.github.io/cppwp/n4659/dcl.attr#grammar-4 - -> If a keyword or an alternative token that satisfies the syntactic requirements of an identifier is contained in an attribute-token, it is considered an identifier. - -「`identifier` の構文上の要件を満たすキーワードまたは代替トークンが `attribute-token` に含まれている場合、`identifier` とみなされる」とある。どうやら間違いないようだ。 - -ところで、代替トークン (alternative token) とは `and` (`&`) や `bitor` (`|`) などのことだが、`identifier` の構文上の要件を満たさないような代替トークンなどあるのか？ -疑問に思って調べたところ、代替トークンという語にはダイグラフも含まれるらしい (参考: [同ドラフト](https://timsong-cpp.github.io/cppwp/n4659/lex.digraph)) - -- `<%` → `{` -- `%>` → `}` -- `<:` → `[` -- `:>` → `]` -- `%:` → `#` -- `%:%:` → `##` - -「`identifier` の構文上の要件を満たさないような代替トークン」はこれらが当てはまると思われる。 - - -調べた感想: 字句解析器か構文解析器が辛そう - diff --git a/content/posts/2021-10-02/python-unbound-local-error.adoc b/content/posts/2021-10-02/python-unbound-local-error.adoc new file mode 100644 index 0000000..f68ae4d --- /dev/null +++ b/content/posts/2021-10-02/python-unbound-local-error.adoc @@ -0,0 +1,66 @@ += [Python] クロージャとUnboundLocalError: local variable 'x' referenced before assignment +:tags: python, python3 +:description: Python における UnboundLocalError の理由と対処法。 +:revision-1: 2021-10-02 Qiita から移植 + +この記事は Qiita から移植してきたものです。 元 URL: +https://qiita.com/nsfisis/items/5d733703afcb35bbf399 + +''''' + +本記事は Python 3.7.6 の動作結果を元にして書かれている。 + +Python でクロージャを作ろうと、次のようなコードを書いた。 + +[source,python] +---- +def f(): + x = 0 + def g(): + x += 1 + g() + +f() +---- + +関数 `g` から 関数 `f` のスコープ内で定義された変数 `x` を参照し、それに +1 を足そうとしている。 これを実行すると `x += 1` +の箇所でエラーが発生する。 + +____ +UnboundLocalError: local variable `x' referenced before assignment +____ + +local変数 `x` が代入前に参照された、とある。これは、`f` の `x` +を参照するのではなく、新しく別の変数を `g` 内に作ってしまっているため。 +前述のコードを宣言と代入を便宜上分けて書き直すと次のようになる。`var` +を変数宣言のための構文として擬似的に利用している。 + +[source,python] +---- +# 注: var は正しい Python の文法ではない。上記参照のこと +def f(): + var x # f の local変数 'x' を宣言 + x = 0 # x に 0 を代入 + def g(): # f の内部関数 g を定義 + var x # g の local変数 'x' を宣言 + # たまたま f にも同じ名前の変数があるが、それとは別の変数 + x += 1 # x に 1 を加算 (x = x + 1 の糖衣構文) + # 加算する前の値を参照しようとするが、まだ代入されていないためエラー + g() +---- + +当初の意図を表現するには、次のように書けばよい。 + +[source,python] +---- +def f(): + x = 0 + def g(): + nonlocal x ## (*) + x += 1 + g() +---- + +`(*)` のように、`nonlocal` を追加する。これにより一つ外側のスコープ (`g` +の一つ外側 = `f`) で定義されている `x` を探しに行くようになる。 diff --git a/content/posts/2021-10-02/python-unbound-local-error.md b/content/posts/2021-10-02/python-unbound-local-error.md deleted file mode 100644 index 6e1b871..0000000 --- a/content/posts/2021-10-02/python-unbound-local-error.md +++ /dev/null @@ -1,67 +0,0 @@ ---- -title: "[Python] クロージャとUnboundLocalError: local variable 'x' referenced before assignment" -date: 2021-10-02T09:32:37+09:00 -tags: ["python", "python3"] -summary: | - Python における UnboundLocalError の理由と対処法。 -changelog: - 2021-10-02: Qiita から移植 ---- - -この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/5d733703afcb35bbf399 - - ------------------------------------ - - -本記事は Python 3.7.6 の動作結果を元にして書かれている。 - - -Python でクロージャを作ろうと、次のようなコードを書いた。 - -```python -def f(): - x = 0 - def g(): - x += 1 - g() - -f() -``` - -関数 `g` から 関数 `f` のスコープ内で定義された変数 `x` を参照し、それに 1 を足そうとしている。 -これを実行すると `x += 1` の箇所でエラーが発生する。 - -> UnboundLocalError: local variable 'x' referenced before assignment - -local変数 `x` が代入前に参照された、とある。これは、`f` の `x` を参照するのではなく、新しく別の変数を `g` 内に作ってしまっているため。 -前述のコードを宣言と代入を便宜上分けて書き直すと次のようになる。`var` を変数宣言のための構文として擬似的に利用している。 - -```python -# 注: var は正しい Python の文法ではない。上記参照のこと -def f(): - var x # f の local変数 'x' を宣言 - x = 0 # x に 0 を代入 - def g(): # f の内部関数 g を定義 - var x # g の local変数 'x' を宣言 - # たまたま f にも同じ名前の変数があるが、それとは別の変数 - x += 1 # x に 1 を加算 (x = x + 1 の糖衣構文) - # 加算する前の値を参照しようとするが、まだ代入されていないためエラー - g() -``` - -当初の意図を表現するには、次のように書けばよい。 - -```python -def f(): - x = 0 - def g(): - nonlocal x ## (*) - x += 1 - g() -``` - -`(*)` のように、`nonlocal` を追加する。これにより一つ外側のスコープ (`g` の一つ外側 = `f`) で定義されている `x` を探しに行くようになる。 - - diff --git a/content/posts/2021-10-02/ruby-detect-running-implementation.adoc b/content/posts/2021-10-02/ruby-detect-running-implementation.adoc new file mode 100644 index 0000000..1434891 --- /dev/null +++ b/content/posts/2021-10-02/ruby-detect-running-implementation.adoc @@ -0,0 +1,72 @@ += [Ruby] 自身を実行している処理系の種類を判定する +:tags: ruby +:description: Ruby には複数の実装があるが、自身を実行している処理系の種類を \ + スクリプト上からどのように判定すればよいだろうか。 +:revision-1: 2021-10-02 Qiita から移植 + +この記事は Qiita から移植してきたものです。 元 URL: +https://qiita.com/nsfisis/items/74d7ffeeebc51b20d791 + +''''' + +Ruby +という言語には複数の実装があるが、それらをスクリプト上からどのようにして +programmatically に見分ければよいだろうか。 + +`Object` クラスに定義されている `RUBY_ENGINE` +という定数がこの用途に使える。 + +参考: +https://docs.ruby-lang.org/ja/latest/method/Object/c/RUBY_ENGINE.html[Object::RUBY_ENGINE] + +上記ページの例から引用する: + +[source,shell-session] +---- +$ ruby-1.9.1 -ve 'p RUBY_ENGINE' +ruby 1.9.1p0 (2009-03-04 revision 22762) [x86_64-linux] +"ruby" +$ jruby -ve 'p RUBY_ENGINE' +jruby 1.2.0 (ruby 1.8.6 patchlevel 287) (2009-03-16 rev 9419) [i386-java] +"jruby" +---- + +それぞれの処理系がどのような値を返すかだが、stack overflow +に良い質問と回答があった。 + +https://stackoverflow.com/a/9894232[What values for RUBY_ENGINE +correspond to which Ruby implementations?] より引用: + +____ +[cols="^,<",options="header",] +|=== +|RUBY_ENGINE |Implementation +| |MRI < 1.9 +|`ruby' |MRI >= 1.9 or REE +|`jruby' |JRuby +|`macruby' |MacRuby +|`rbx' |Rubinius +|`maglev' |MagLev +|`ironruby' |IronRuby +|`cardinal' |Cardinal +|=== +____ + +なお、この質問・回答は +2014年になされたものであり、値は変わっている可能性がある。MRI (aka +CRuby) については執筆時現在 (2020/12/8) も `'ruby'` +が返ってくることを確認済み。 + +この表にない主要な処理系として、https://mruby.org[mruby] は `'mruby'` +を返す。 + +https://github.com/mruby/mruby/blob/ed29d74bfd95362eaeb946fcf7e865d80346b62b/include/mruby/version.h#L32-L35[mruby +該当部分のソース] より引用: + +[source,c] +---- +/* + * Ruby engine. + */ +#define MRUBY_RUBY_ENGINE "mruby" +---- diff --git a/content/posts/2021-10-02/ruby-detect-running-implementation.md b/content/posts/2021-10-02/ruby-detect-running-implementation.md deleted file mode 100644 index 16b918d..0000000 --- a/content/posts/2021-10-02/ruby-detect-running-implementation.md +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: "[Ruby] 自身を実行している処理系の種類を判定する" -date: 2021-10-02T09:37:50+09:00 -tags: ["ruby"] -summary: | - Ruby には複数の実装があるが、自身を実行している処理系の種類をスクリプト上からどのように判定すればよいだろうか。 -changelog: - 2021-10-02: Qiita から移植 ---- - -この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/74d7ffeeebc51b20d791 - - ------------------------------------ - - - -Ruby という言語には複数の実装があるが、それらをスクリプト上からどのようにして programmatically に見分ければよいだろうか。 - -`Object` クラスに定義されている `RUBY_ENGINE` という定数がこの用途に使える。 - -参考: [Object::RUBY_ENGINE](https://docs.ruby-lang.org/ja/latest/method/Object/c/RUBY_ENGINE.html) - -上記ページの例から引用する: - -```shell-session -$ ruby-1.9.1 -ve 'p RUBY_ENGINE' -ruby 1.9.1p0 (2009-03-04 revision 22762) [x86_64-linux] -"ruby" -$ jruby -ve 'p RUBY_ENGINE' -jruby 1.2.0 (ruby 1.8.6 patchlevel 287) (2009-03-16 rev 9419) [i386-java] -"jruby" -``` - -それぞれの処理系がどのような値を返すかだが、stack overflow に良い質問と回答があった。 - -[What values for RUBY_ENGINE correspond to which Ruby implementations?](https://stackoverflow.com/a/9894232) より引用: - -> | RUBY_ENGINE | Implementation | -> |:-----------:|:------------------| -> | \ | MRI < 1.9 | -> | 'ruby' | MRI >= 1.9 or REE | -> | 'jruby' | JRuby | -> | 'macruby' | MacRuby | -> | 'rbx' | Rubinius | -> | 'maglev' | MagLev | -> | 'ironruby' | IronRuby | -> | 'cardinal' | Cardinal | - - -なお、この質問・回答は 2014年になされたものであり、値は変わっている可能性がある。MRI (aka CRuby) については執筆時現在 (2020/12/8) も `'ruby'` が返ってくることを確認済み。 - -この表にない主要な処理系として、[mruby](https://mruby.org) は `'mruby'` を返す。 - -[mruby 該当部分のソース](https://github.com/mruby/mruby/blob/ed29d74bfd95362eaeb946fcf7e865d80346b62b/include/mruby/version.h#L32-L35) より引用: - -```c -/* - * Ruby engine. - */ -#define MRUBY_RUBY_ENGINE "mruby" -``` - diff --git a/content/posts/2021-10-02/ruby-then-keyword-and-case-in.adoc b/content/posts/2021-10-02/ruby-then-keyword-and-case-in.adoc new file mode 100644 index 0000000..94fcf48 --- /dev/null +++ b/content/posts/2021-10-02/ruby-then-keyword-and-case-in.adoc @@ -0,0 +1,226 @@ += [Ruby] then キーワードと case in +:tags: ruby, ruby3 +:description: Ruby 3.0 で追加される case in 構文と、then キーワードについて。 +:revision-1: 2021-10-02 Qiita から移植 + +この記事は Qiita から移植してきたものです。 元 URL: +https://qiita.com/nsfisis/items/787a8cf888a304497223 + +''''' + +== TL; DR + +`case` - `in` によるパターンマッチング構文でも、`case` - `when` +と同じように `then` が使える (場合によっては使う必要がある)。 + +== `then` とは + +使われることは稀だが、Ruby では `then` +がキーワードになっている。次のように使う: + +[source,ruby] +---- +if cond then + puts "Y" +else + puts "N" +end +---- + +このキーワードが現れうる場所はいくつかあり、`if`、`unless`、`rescue`、`case` +構文がそれに当たる。 上記のように、何か条件を書いた後 `then` +を置き、式がそこで終了していることを示すマーカーとして機能する。 + +[source,ruby] +---- +# Example: + +if x then + a +end + +unless x then + a +end + +begin + a +rescue then + b +end + +case x +when p then + a +end +---- + +== なぜ普段は書かなくてもよいのか + +普通 Ruby のコードで `then` +を書くことはない。なぜか。次のコードを実行してみるとわかる。 + +[source,ruby] +---- +if true puts 'Hello, World!' end +---- + +次のような構文エラーが出力される。 + +.... +20:1: syntax error, unexpected local variable or method, expecting `then' or ';' or '\n' +if true puts 'Hello, World!' end + ^~~~ +20:1: syntax error, unexpected `end', expecting end-of-input +...f true puts 'Hello, World!' end +.... + +二つ目のメッセージは無視して一つ目を読むと、`then` か `;` +か改行が来るはずのところ変数だかメソッドだかが現れたことによりエラーとなっているようだ。 + +ポイントは改行が `then` (や `;`) の代わりとなることである。`true` +の後に改行を入れてみる。 + +[source,ruby] +---- +if true +puts 'Hello, World!' end +---- + +無事 Hello, World! と出力されるようになった。 + +== なぜ `then` や `;` や改行が必要か + +なぜ `then` や `;` や改行 (以下 「`then` 等」) +が必要なのだろうか。次の例を見てほしい: + +[source,ruby] +---- +if a b end +---- + +`then` も `;` +も改行もないのでエラーになるが、これは条件式がどこまで続いているのかわからないためだ。 +この例は二通りに解釈できる。 + +[source,ruby] +---- +# a という変数かメソッドの評価結果が truthy なら b という変数かメソッドを評価 +if a then + b +end +---- + +[source,ruby] +---- +# a というメソッドに b という変数かメソッドの評価結果を渡して呼び出し、 +# その結果が truthy なら何もしない +if a(b) then +end +---- + +`then` 等はこの曖昧性を排除するためにあり、条件式は `if` から `then` +等までの間にある、ということを明確にする。 C系の `if` 後に来る `(`/`)` +や、Python の `:`、Rust/Go/Swift などの `{` も同じ役割を持つ。 + +Ruby の場合、プログラマーが書きやすいよう改行でもって `then` +が代用できるので、ほとんどの場合 `then` は必要ない。 + +== `case` - `in` における `then` + +ようやく本題にたどり着いた。来る Ruby 3.0 では `case` と `in` +キーワードを使ったパターンマッチングの構文が入る予定である。この構文でもパターン部との区切りとして +`then` 等が必要になる。 (現在の) Ruby には formal +な形式での文法仕様は存在しないので、yacc の定義ファイルを参照した (yacc +の説明は省略)。 + +https://github.com/ruby/ruby/blob/221ca0f8281d39f0dfdfe13b2448875384bbf735/parse.y#L3961-L3986 + +[source,yacc] +---- +p_case_body : keyword_in + { + SET_LEX_STATE(EXPR_BEG|EXPR_LABEL); + p->command_start = FALSE; + $1 = p->ctxt; + p->ctxt.in_kwarg = 1; + $$ = push_pvtbl(p); + } + { + $$ = push_pktbl(p); + } + p_top_expr then + { + pop_pktbl(p, $3); + pop_pvtbl(p, $2); + p->ctxt.in_kwarg = $1.in_kwarg; + } + compstmt + p_cases + { + /*%%%*/ + $$ = NEW_IN($4, $7, $8, &@$); + /*% %*/ + /*% ripper: in!($4, $7, escape_Qundef($8)) %*/ + } + ; +---- + +簡略版: + +[source,yacc] +---- +p_case_body : keyword_in p_top_expr then compstmt p_cases + ; +---- + +ここで、`keyword_in` は文字通り `in`、`p_top_expr` +はいわゆるパターン、`then` は `then` +キーワードのことではなく、この記事で `then` 等と呼んでいるもの、つまり +`then` キーワード、`;`、改行のいずれかである。 + +これにより、`case` - `when` による従来の構文と同じように、`then` +等をパターンの後ろに挿入すればよいことがわかった。つまり次の3通りのいずれかになる: + +[source,ruby] +---- +case x +in 1 then a +in 2 then b +in 3 then c +end + +case x +in 1 + a +in 2 + b +in 3 + c +end + +case x +in 1; a +in 2; b +in 3; c +end +---- + +ところで、`p_top_expr` には `if` による guard clause +が書けるので、その場合は `if` - `then` と似たような見た目になる。 + +[source,ruby] +---- +case x +in 0 then a +in n if n < 0 then b +in n then c +end +---- + +== まとめ + +* `if` や `case` の条件の後ろには `then`、`;`、改行のいずれかが必要 +** 通常は改行しておけばよい +* 3.0 で入る予定の `case` - `in` でも `then` 等が必要になる +* Ruby の構文を正確に知るには (現状) `parse.y` を直接読めばよい diff --git a/content/posts/2021-10-02/ruby-then-keyword-and-case-in.md b/content/posts/2021-10-02/ruby-then-keyword-and-case-in.md deleted file mode 100644 index 5b5c352..0000000 --- a/content/posts/2021-10-02/ruby-then-keyword-and-case-in.md +++ /dev/null @@ -1,205 +0,0 @@ ---- -title: "[Ruby] then キーワードと case in" -date: 2021-10-02T09:38:50+09:00 -tags: ["ruby", "ruby3"] -summary: | - Ruby 3.0 で追加される case in 構文と、then キーワードについて。 -changelog: - 2021-10-02: Qiita から移植 ---- - -この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/787a8cf888a304497223 - - ------------------------------------ - - -# TL; DR - -`case` - `in` によるパターンマッチング構文でも、`case` - `when` と同じように `then` が使える (場合によっては使う必要がある)。 - -# `then` とは - -使われることは稀だが、Ruby では `then` がキーワードになっている。次のように使う: - -```ruby -if cond then - puts "Y" -else - puts "N" -end -``` - -このキーワードが現れうる場所はいくつかあり、`if`、`unless`、`rescue`、`case` 構文がそれに当たる。 -上記のように、何か条件を書いた後 `then` を置き、式がそこで終了していることを示すマーカーとして機能する。 - -```ruby -# Example: - -if x then - a -end - -unless x then - a -end - -begin - a -rescue then - b -end - -case x -when p then - a -end -``` - -# なぜ普段は書かなくてもよいのか - -普通 Ruby のコードで `then` を書くことはない。なぜか。次のコードを実行してみるとわかる。 - -```ruby -if true puts 'Hello, World!' end -``` - -次のような構文エラーが出力される。 - -``` -20:1: syntax error, unexpected local variable or method, expecting `then' or ';' or '\n' -if true puts 'Hello, World!' end - ^~~~ -20:1: syntax error, unexpected `end', expecting end-of-input -...f true puts 'Hello, World!' end -``` - -二つ目のメッセージは無視して一つ目を読むと、`then` か `;` か改行が来るはずのところ変数だかメソッドだかが現れたことによりエラーとなっているようだ。 - -ポイントは改行が `then` (や `;`) の代わりとなることである。`true` の後に改行を入れてみる。 - -```ruby -if true -puts 'Hello, World!' end -``` - -無事 Hello, World! と出力されるようになった。 - -# なぜ `then` や `;` や改行が必要か - -なぜ `then` や `;` や改行 (以下 「`then` 等」) が必要なのだろうか。次の例を見てほしい: - -```ruby -if a b end -``` - -`then` も `;` も改行もないのでエラーになるが、これは条件式がどこまで続いているのかわからないためだ。 -この例は二通りに解釈できる。 - -```ruby -# a という変数かメソッドの評価結果が truthy なら b という変数かメソッドを評価 -if a then - b -end -``` - -```ruby -# a というメソッドに b という変数かメソッドの評価結果を渡して呼び出し、 -# その結果が truthy なら何もしない -if a(b) then -end -``` - -`then` 等はこの曖昧性を排除するためにあり、条件式は `if` から `then` 等までの間にある、ということを明確にする。 -C系の `if` 後に来る `(`/`)` や、Python の `:`、Rust/Go/Swift などの `{` も同じ役割を持つ。 - -Ruby の場合、プログラマーが書きやすいよう改行でもって `then` が代用できるので、ほとんどの場合 `then` は必要ない。 - -# `case` - `in` における `then` - -ようやく本題にたどり着いた。来る Ruby 3.0 では `case` と `in` キーワードを使ったパターンマッチングの構文が入る予定である。この構文でもパターン部との区切りとして `then` 等が必要になる。 -(現在の) Ruby には formal な形式での文法仕様は存在しないので、yacc の定義ファイルを参照した (yacc の説明は省略)。 - -https://github.com/ruby/ruby/blob/221ca0f8281d39f0dfdfe13b2448875384bbf735/parse.y#L3961-L3986 - -```yacc -p_case_body : keyword_in - { - SET_LEX_STATE(EXPR_BEG|EXPR_LABEL); - p->command_start = FALSE; - $1 = p->ctxt; - p->ctxt.in_kwarg = 1; - $$ = push_pvtbl(p); - } - { - $$ = push_pktbl(p); - } - p_top_expr then - { - pop_pktbl(p, $3); - pop_pvtbl(p, $2); - p->ctxt.in_kwarg = $1.in_kwarg; - } - compstmt - p_cases - { - /*%%%*/ - $$ = NEW_IN($4, $7, $8, &@$); - /*% %*/ - /*% ripper: in!($4, $7, escape_Qundef($8)) %*/ - } - ; -``` - -簡略版: - -```yacc -p_case_body : keyword_in p_top_expr then compstmt p_cases - ; -``` - -ここで、`keyword_in` は文字通り `in`、`p_top_expr` はいわゆるパターン、`then` は `then` キーワードのことではなく、この記事で `then` 等と呼んでいるもの、つまり `then` キーワード、`;`、改行のいずれかである。 - -これにより、`case` - `when` による従来の構文と同じように、`then` 等をパターンの後ろに挿入すればよいことがわかった。つまり次の3通りのいずれかになる: - -```ruby -case x -in 1 then a -in 2 then b -in 3 then c -end - -case x -in 1 - a -in 2 - b -in 3 - c -end - -case x -in 1; a -in 2; b -in 3; c -end -``` - -ところで、`p_top_expr` には `if` による guard clause が書けるので、その場合は `if` - `then` と似たような見た目になる。 - -```ruby -case x -in 0 then a -in n if n < 0 then b -in n then c -end -``` - -# まとめ - -* `if` や `case` の条件の後ろには `then`、`;`、改行のいずれかが必要 - * 通常は改行しておけばよい -* 3.0 で入る予定の `case` - `in` でも `then` 等が必要になる -* Ruby の構文を正確に知るには (現状) `parse.y` を直接読めばよい - diff --git a/content/posts/2021-10-02/rust-where-are-primitive-types-from.adoc b/content/posts/2021-10-02/rust-where-are-primitive-types-from.adoc new file mode 100644 index 0000000..8fc70b4 --- /dev/null +++ b/content/posts/2021-10-02/rust-where-are-primitive-types-from.adoc @@ -0,0 +1,201 @@ += Rust のプリミティブ型はどこからやって来るか +:tags: rust +:description: Rust のプリミティブ型は予約語ではなく普通の識別子である。 \ + どのようにこれが名前解決されるのかを調べた。 +:revision-1: 2021-10-02 Qiita から移植 + +この記事は Qiita から移植してきたものです。 元 URL: +https://qiita.com/nsfisis/items/9a429432258bbcd6c565 + +''''' + +== 前置き + +Rust +において、プリミティブ型の名前は予約語でない。したがって、次のコードは合法である。 + +[source,rust] +---- +#![allow(non_camel_case_types)] +#![allow(dead_code)] + +struct bool; +struct char; +struct i8; +struct i16; +struct i32; +struct i64; +struct i128; +struct isize; +struct u8; +struct u16; +struct u32; +struct u64; +struct u128; +struct usize; +struct f32; +struct f64; +struct str; +---- + +では、普段単に `bool` と書いたとき、この `bool` +は一体どこから来ているのか。rustc のソースを追ってみた。 + +____ +前提知識: 一般的なコンパイラの構造、用語。`rustc` そのものの知識は不要 +(というよりも筆者自身がよく知らない) +____ + +== 調査 + +調査に使用したソース (調査時点での最新 master) + +https://github.com/rust-lang/rust/tree/511ed9f2356af365ad8affe046b3dd33f7ac3c98 + +どのようにして調べるか。rustc +の構造には詳しくないため、すぐに当たりをつけるのは難しい。 + +大雑把な構造としては、`compiler` フォルダ以下に `rustc_*` +という名前のクレートが数十個入っている。これがどうやら `rustc` +コマンドの実装部のようだ。 + +`rustc` はセルフホストされている (= `rustc` 自身が Rust で書かれている) +ので、`bool` や `char` +などで適当に検索をかけてもノイズが多すぎて話にならない。 +しかし、お誂え向きなことに `i128`/`u128` +というコンパイラ自身が使うことがなさそうな型が存在するのでこれを使って +`git grep` してみる。 + +.... +$ git grep "\bi128\b" | wc # i128 + 165 1069 15790 + +$ git grep "\bu128\b" | wc # u128 + 293 2127 26667 + +$ git grep "\bbool\b" | wc # cf. bool の結果 + 3563 23577 294659 +.... + +165 +程度であれば探すことができそうだ。今回は、クレート名を見ておおよその当たりをつけた。 + +.... +$ git grep "\bi128\b" +... +rustc_resolve/src/lib.rs: table.insert(sym::i128, Int(IntTy::I128)); +... +.... + +`rustc_resolve` +というのはいかにも名前解決を担いそうなクレート名である。該当箇所を見てみる。 + +[source,rust] +---- +/// Interns the names of the primitive types. +/// +/// All other types are defined somewhere and possibly imported, but the primitive ones need +/// special handling, since they have no place of origin. +struct PrimitiveTypeTable { + primitive_types: FxHashMap, +} + +impl PrimitiveTypeTable { + fn new() -> PrimitiveTypeTable { + let mut table = FxHashMap::default(); + + table.insert(sym::bool, Bool); + table.insert(sym::char, Char); + table.insert(sym::f32, Float(FloatTy::F32)); + table.insert(sym::f64, Float(FloatTy::F64)); + table.insert(sym::isize, Int(IntTy::Isize)); + table.insert(sym::i8, Int(IntTy::I8)); + table.insert(sym::i16, Int(IntTy::I16)); + table.insert(sym::i32, Int(IntTy::I32)); + table.insert(sym::i64, Int(IntTy::I64)); + table.insert(sym::i128, Int(IntTy::I128)); + table.insert(sym::str, Str); + table.insert(sym::usize, Uint(UintTy::Usize)); + table.insert(sym::u8, Uint(UintTy::U8)); + table.insert(sym::u16, Uint(UintTy::U16)); + table.insert(sym::u32, Uint(UintTy::U32)); + table.insert(sym::u64, Uint(UintTy::U64)); + table.insert(sym::u128, Uint(UintTy::U128)); + Self { primitive_types: table } + } +} +---- + +これは初めに列挙したプリミティブ型の一覧と一致している。doc comment +にも、 + +____ +All other types are defined somewhere and possibly imported, but the +primitive ones need special handling, since they have no place of +origin. +____ + +とある。次はこの struct +の使用箇所を追う。追うと言っても使われている箇所は次の一箇所しかない。なお説明に不要な箇所は大きく削っている。 + +[source,rust] +---- + /// This resolves the identifier `ident` in the namespace `ns` in the current lexical scope. + /// (略) + fn resolve_ident_in_lexical_scope( + &mut self, + mut ident: Ident, + ns: Namespace, + // (略) + ) -> Option> { + // (略) + + if ns == TypeNS { + if let Some(prim_ty) = self.primitive_type_table.primitive_types.get(&ident.name) { + let binding = + (Res::PrimTy(*prim_ty), ty::Visibility::Public, DUMMY_SP, ExpnId::root()) + .to_name_binding(self.arenas); + return Some(LexicalScopeBinding::Item(binding)); + } + } + + None + } +---- + +関数名や doc comment が示している通り、この関数は識別子 (identifier, +ident) を現在のレキシカルスコープ内で解決 (resolve) する。 +`if ns == TypeNS` のブロック内では、`primitive_type_table` (上記の +`PrimitiveTypeTable::new()` で作られた変数) に含まれている識別子 +(`bool`、`i32` など) +かどうか判定し、そうであればそれに紐づけられたプリミティブ型を返している。 + +なお、`ns` は「名前空間」を示す変数である。Rust +における名前空間はC言語におけるそれとほとんど同じで、今探している名前が関数名/変数名なのか型なのかマクロなのかを区別している。この +`if` +は、プリミティブ型に解決されるのは型を探しているときだけだ、と言っている。 + +重要なのは、これが `resolve_ident_in_lexical_scope()` +の最後に書かれている点である。つまり、最初に挙げたプリミティブ型の識別子は、「名前解決の最終段階で」、「他に同名の型が見つかっていなければ」プリミティブ型として解決される。 + +動作がわかったところで、例として次のコードを考える。 + +[source,rust] +---- +#![allow(non_camel_case_types)] + +struct bool; + +fn main() { + let _: bool = bool; +} +---- + +ここで `main()` の `bool` は `struct bool` +として解決される。なぜなら、プリミティブ型の判定をする前に `bool` +という名前の別の型が見つかるからだ。 + +== まとめ + +Rust +のプリミティブ型は予約語ではない。名前解決の最終段階で特別扱いされ、他に同名の型が見つかっていなければ対応するプリミティブ型に解決される。 diff --git a/content/posts/2021-10-02/rust-where-are-primitive-types-from.md b/content/posts/2021-10-02/rust-where-are-primitive-types-from.md deleted file mode 100644 index dc2630b..0000000 --- a/content/posts/2021-10-02/rust-where-are-primitive-types-from.md +++ /dev/null @@ -1,175 +0,0 @@ ---- -title: "Rust のプリミティブ型はどこからやって来るか" -date: 2021-10-02T09:39:27+09:00 -tags: ["rust"] -summary: | - Rust のプリミティブ型は予約語ではなく普通の識別子である。どのようにこれが名前解決されるのかを調べた。 -changelog: - 2021-10-02: Qiita から移植 ---- - -この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/9a429432258bbcd6c565 - - ------------------------------------ - - - -# 前置き - -Rust において、プリミティブ型の名前は予約語でない。したがって、次のコードは合法である。 - -```rust -#![allow(non_camel_case_types)] -#![allow(dead_code)] - -struct bool; -struct char; -struct i8; -struct i16; -struct i32; -struct i64; -struct i128; -struct isize; -struct u8; -struct u16; -struct u32; -struct u64; -struct u128; -struct usize; -struct f32; -struct f64; -struct str; -``` - -では、普段単に `bool` と書いたとき、この `bool` は一体どこから来ているのか。rustc のソースを追ってみた。 - -> 前提知識: 一般的なコンパイラの構造、用語。`rustc` そのものの知識は不要 (というよりも筆者自身がよく知らない) - -# 調査 - -調査に使用したソース (調査時点での最新 master) - -https://github.com/rust-lang/rust/tree/511ed9f2356af365ad8affe046b3dd33f7ac3c98 - -どのようにして調べるか。rustc の構造には詳しくないため、すぐに当たりをつけるのは難しい。 - -大雑把な構造としては、`compiler` フォルダ以下に `rustc_*` という名前のクレートが数十個入っている。これがどうやら `rustc` コマンドの実装部のようだ。 - -`rustc` はセルフホストされている (= `rustc` 自身が Rust で書かれている) ので、`bool` や `char` などで適当に検索をかけてもノイズが多すぎて話にならない。 -しかし、お誂え向きなことに `i128`/`u128` というコンパイラ自身が使うことがなさそうな型が存在するのでこれを使って `git grep` してみる。 - -``` -$ git grep "\bi128\b" | wc # i128 - 165 1069 15790 - -$ git grep "\bu128\b" | wc # u128 - 293 2127 26667 - -$ git grep "\bbool\b" | wc # cf. bool の結果 - 3563 23577 294659 -``` - -165 程度であれば探すことができそうだ。今回は、クレート名を見ておおよその当たりをつけた。 - -``` -$ git grep "\bi128\b" -... -rustc_resolve/src/lib.rs: table.insert(sym::i128, Int(IntTy::I128)); -... -``` - -`rustc_resolve` というのはいかにも名前解決を担いそうなクレート名である。該当箇所を見てみる。 - -```rust -/// Interns the names of the primitive types. -/// -/// All other types are defined somewhere and possibly imported, but the primitive ones need -/// special handling, since they have no place of origin. -struct PrimitiveTypeTable { - primitive_types: FxHashMap, -} - -impl PrimitiveTypeTable { - fn new() -> PrimitiveTypeTable { - let mut table = FxHashMap::default(); - - table.insert(sym::bool, Bool); - table.insert(sym::char, Char); - table.insert(sym::f32, Float(FloatTy::F32)); - table.insert(sym::f64, Float(FloatTy::F64)); - table.insert(sym::isize, Int(IntTy::Isize)); - table.insert(sym::i8, Int(IntTy::I8)); - table.insert(sym::i16, Int(IntTy::I16)); - table.insert(sym::i32, Int(IntTy::I32)); - table.insert(sym::i64, Int(IntTy::I64)); - table.insert(sym::i128, Int(IntTy::I128)); - table.insert(sym::str, Str); - table.insert(sym::usize, Uint(UintTy::Usize)); - table.insert(sym::u8, Uint(UintTy::U8)); - table.insert(sym::u16, Uint(UintTy::U16)); - table.insert(sym::u32, Uint(UintTy::U32)); - table.insert(sym::u64, Uint(UintTy::U64)); - table.insert(sym::u128, Uint(UintTy::U128)); - Self { primitive_types: table } - } -} -``` - -これは初めに列挙したプリミティブ型の一覧と一致している。doc comment にも、 - -> All other types are defined somewhere and possibly imported, but the primitive ones need special handling, since they have no place of origin. - -とある。次はこの struct の使用箇所を追う。追うと言っても使われている箇所は次の一箇所しかない。なお説明に不要な箇所は大きく削っている。 - -```rust - /// This resolves the identifier `ident` in the namespace `ns` in the current lexical scope. - /// (略) - fn resolve_ident_in_lexical_scope( - &mut self, - mut ident: Ident, - ns: Namespace, - // (略) - ) -> Option> { - // (略) - - if ns == TypeNS { - if let Some(prim_ty) = self.primitive_type_table.primitive_types.get(&ident.name) { - let binding = - (Res::PrimTy(*prim_ty), ty::Visibility::Public, DUMMY_SP, ExpnId::root()) - .to_name_binding(self.arenas); - return Some(LexicalScopeBinding::Item(binding)); - } - } - - None - } -``` - -関数名や doc comment が示している通り、この関数は識別子 (identifier, ident) を現在のレキシカルスコープ内で解決 (resolve) する。 -`if ns == TypeNS` のブロック内では、`primitive_type_table` (上記の `PrimitiveTypeTable::new()` で作られた変数) に含まれている識別子 (`bool`、`i32` など) かどうか判定し、そうであればそれに紐づけられたプリミティブ型を返している。 - -なお、`ns` は「名前空間」を示す変数である。Rust における名前空間はC言語におけるそれとほとんど同じで、今探している名前が関数名/変数名なのか型なのかマクロなのかを区別している。この `if` は、プリミティブ型に解決されるのは型を探しているときだけだ、と言っている。 - -重要なのは、これが `resolve_ident_in_lexical_scope()` の最後に書かれている点である。つまり、最初に挙げたプリミティブ型の識別子は、「名前解決の最終段階で」、「他に同名の型が見つかっていなければ」プリミティブ型として解決される。 - -動作がわかったところで、例として次のコードを考える。 - -```rust -#![allow(non_camel_case_types)] - -struct bool; - -fn main() { - let _: bool = bool; -} -``` - -ここで `main()` の `bool` は `struct bool` として解決される。なぜなら、プリミティブ型の判定をする前に `bool` という名前の別の型が見つかるからだ。 - - -# まとめ - -Rust のプリミティブ型は予約語ではない。名前解決の最終段階で特別扱いされ、他に同名の型が見つかっていなければ対応するプリミティブ型に解決される。 - diff --git a/content/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre.adoc b/content/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre.adoc new file mode 100644 index 0000000..061e764 --- /dev/null +++ b/content/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre.adoc @@ -0,0 +1,120 @@ += [Vim] autocmd events の BufWrite/BufWritePre の違い +:tags: vim +:description: Vim の autocmd events における BufWrite/BufWritePre がどう違うのかを調べた結果、 \ + 違いはないことがわかった。 +:revision-1: 2021-10-02 Qiita から移植 + +この記事は Qiita から移植してきたものです。 元 URL: +https://qiita.com/nsfisis/items/79ab4db8564032de0b25 + +''''' + +== TL; DR + +違いはない。ただのエイリアス。 + +== 調査記録 + +Vim の autocmd events には似通った名前のものがいくつかある。大抵は +`:help` +に説明があるが、この記事のタイトルにある2つを含めた以下のイベントには、その違いについて説明がない。 + +* `BufRead`/`BufReadPost` +* `BufWrite`/`BufWritePre` +* `BufAdd`/`BufCreate` + +このうち、`BufAdd`/`BufCreate` に関しては、`:help BufCreate` に + +____ +The BufCreate event is for historic reasons. +____ + +とあり、おそらくは `BufAdd` +のエイリアスであろうということがわかる。他の2組も同様ではないかと予想されるが、確認のため +vim と neovim のソースコードを調査した。 + +____ +ソースコードへのリンク +https://github.com/vim/vim/tree/8e6be34338f13a6a625f19bcef82019c9adc65f2[vim +(調査時点での master branch)] +https://github.com/neovim/neovim/tree/71d4f5851f068eeb432af34850dddda8cc1c71e3[neovim +(上に同じ)] +____ + +=== vim のソースコード + +以下は、autocmd events +の名前と内部で使われている整数値とのマッピングを定義している箇所である。見ての通り、上でエイリアスではないかと述べた3組には、それぞれ同じ内部値が使われている。 + +https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L85-L86 + +[source,c] +---- + {"BufAdd", EVENT_BUFADD}, + {"BufCreate", EVENT_BUFADD}, +---- + +https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L95-L97 + +[source,c] +---- + {"BufRead", EVENT_BUFREADPOST}, + {"BufReadCmd", EVENT_BUFREADCMD}, + {"BufReadPost", EVENT_BUFREADPOST}, +---- + +https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L103-L105 + +[source,c] +---- + {"BufWrite", EVENT_BUFWRITEPRE}, + {"BufWritePost", EVENT_BUFWRITEPOST}, + {"BufWritePre", EVENT_BUFWRITEPRE}, +---- + +=== neovim のソースコード + +neovim の場合でも同様のマッピングが定義されているが、こちらの場合は Lua +で書かれている。以下にある通り、はっきり `aliases` と書かれている。 + +https://github.com/neovim/neovim/blob/71d4f5851f068eeb432af34850dddda8cc1c71e3/src/nvim/auevents.lua#L119-L124 + +[source,lua] +---- + aliases = { + BufCreate = 'BufAdd', + BufRead = 'BufReadPost', + BufWrite = 'BufWritePre', + FileEncoding = 'EncodingChanged', + }, +---- + +ところで、上では取り上げなかった `FileEncoding` だが、これは +`:help FileEncoding` にしっかりと書いてある。 + +.... + *FileEncoding* +FileEncoding Obsolete. It still works and is equivalent + to |EncodingChanged|. +.... + +=== まとめ + +記事タイトルについて言えば、どちらも変わらないので好きな方を使えばよい。あえて言えば、次のようになるだろう。 + +* `BufAdd`/`BufCreate` +** → `BufCreate` は歴史的な理由により (``for historic reasons'') +存在しているため、新しい方 (`BufAdd`) を使う +* `BufRead`/`BufReadPost` +** → `BufReadPre` との対称性のため、あるいは `BufWritePost` +との対称性のため `BufReadPost` を使う +* `BufWrite`/`BufWritePre` +** → `BufWritePost` との対称性のため、あるいは `BufReadPre` +との対称性のため `BufWritePre` を使う +* `FileEncoding`/`EncodingChanged` +** → `FileEncoding` は ``Obsolete'' +と明言されているので、`EncodingChanged` を使う + +ところでこの調査で知ったのだが、`BufRead` と `BufWrite` +は上にある通り発火するタイミングが「後」と「前」で対称性がない。可能なら +`Pre`/`Post` 付きのものを使った方が分かりやすいだろう。 diff --git a/content/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre.md b/content/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre.md deleted file mode 100644 index 485c304..0000000 --- a/content/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre.md +++ /dev/null @@ -1,106 +0,0 @@ ---- -title: "[Vim] autocmd events の BufWrite/BufWritePre の違い" -date: 2021-10-02T09:37:12+09:00 -tags: ["vim"] -summary: | - Vim の autocmd events における BufWrite/BufWritePre がどう違うのかを調べた結果、違いはないことがわかった。 -changelog: - 2021-10-02: Qiita から移植 ---- - -この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/79ab4db8564032de0b25 - - ------------------------------------ - - - -# TL; DR - -違いはない。ただのエイリアス。 - - -# 調査記録 - -Vim の autocmd events には似通った名前のものがいくつかある。大抵は `:help` に説明があるが、この記事のタイトルにある2つを含めた以下のイベントには、その違いについて説明がない。 - -* `BufRead`/`BufReadPost` -* `BufWrite`/`BufWritePre` -* `BufAdd`/`BufCreate` - -このうち、`BufAdd`/`BufCreate` に関しては、`:help BufCreate` に - -> The BufCreate event is for historic reasons. - -とあり、おそらくは `BufAdd` のエイリアスであろうということがわかる。他の2組も同様ではないかと予想されるが、確認のため vim と neovim のソースコードを調査した。 - -> ソースコードへのリンク -> [vim (調査時点での master branch)](https://github.com/vim/vim/tree/8e6be34338f13a6a625f19bcef82019c9adc65f2) -> [neovim (上に同じ)](https://github.com/neovim/neovim/tree/71d4f5851f068eeb432af34850dddda8cc1c71e3) - -## vim のソースコード - -以下は、autocmd events の名前と内部で使われている整数値とのマッピングを定義している箇所である。見ての通り、上でエイリアスではないかと述べた3組には、それぞれ同じ内部値が使われている。 - -https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L85-L86 - -```c - {"BufAdd", EVENT_BUFADD}, - {"BufCreate", EVENT_BUFADD}, -``` - -https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L95-L97 - -```c - {"BufRead", EVENT_BUFREADPOST}, - {"BufReadCmd", EVENT_BUFREADCMD}, - {"BufReadPost", EVENT_BUFREADPOST}, -``` - -https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L103-L105 - -```c - {"BufWrite", EVENT_BUFWRITEPRE}, - {"BufWritePost", EVENT_BUFWRITEPOST}, - {"BufWritePre", EVENT_BUFWRITEPRE}, -``` - -## neovim のソースコード - -neovim の場合でも同様のマッピングが定義されているが、こちらの場合は Lua で書かれている。以下にある通り、はっきり `aliases` と書かれている。 - -https://github.com/neovim/neovim/blob/71d4f5851f068eeb432af34850dddda8cc1c71e3/src/nvim/auevents.lua#L119-L124 - -```lua - aliases = { - BufCreate = 'BufAdd', - BufRead = 'BufReadPost', - BufWrite = 'BufWritePre', - FileEncoding = 'EncodingChanged', - }, -``` - -ところで、上では取り上げなかった `FileEncoding` だが、これは `:help FileEncoding` にしっかりと書いてある。 - -``` - *FileEncoding* -FileEncoding Obsolete. It still works and is equivalent - to |EncodingChanged|. -``` - -## まとめ - -記事タイトルについて言えば、どちらも変わらないので好きな方を使えばよい。あえて言えば、次のようになるだろう。 - -* `BufAdd`/`BufCreate` - * → `BufCreate` は歴史的な理由により ("for historic reasons") 存在しているため、新しい方 (`BufAdd`) を使う -* `BufRead`/`BufReadPost` - * → `BufReadPre` との対称性のため、あるいは `BufWritePost` との対称性のため `BufReadPost` を使う -* `BufWrite`/`BufWritePre` - * → `BufWritePost` との対称性のため、あるいは `BufReadPre` との対称性のため `BufWritePre` を使う -* `FileEncoding`/`EncodingChanged` - * → `FileEncoding` は "Obsolete" と明言されているので、`EncodingChanged` を使う - -ところでこの調査で知ったのだが、`BufRead` と `BufWrite` は上にある通り発火するタイミングが「後」と「前」で対称性がない。可能なら `Pre`/`Post` 付きのものを使った方が分かりやすいだろう。 - diff --git a/content/posts/2021-10-02/vim-swap-order-of-selected-lines.adoc b/content/posts/2021-10-02/vim-swap-order-of-selected-lines.adoc new file mode 100644 index 0000000..b937625 --- /dev/null +++ b/content/posts/2021-10-02/vim-swap-order-of-selected-lines.adoc @@ -0,0 +1,165 @@ += Vimで選択した行の順番を入れ替える +:tags: vim +:description: Vim で選択した行の順番を入れ替える方法。 +:revision-1: 2021-10-02 Qiita から移植 + +この記事は Qiita から移植してきたものです。 元 URL: +https://qiita.com/nsfisis/items/4fefb361d9a693803520 + +''''' + +== バージョン情報 + +`:version` の一部 + +____ +VIM - Vi IMproved 8.2 (2019 Dec 12, compiled Jan 26 2020 11:30:30) macOS +version Included patches: 1-148 Huge version without GUI. +____ + +== よく紹介されている手法 + +=== `tac` / `tail` + +`tac` や `tail -r` などの外部コマンドを `!` +を使って呼び出し、置き換える。 + +____ +:h v_! +____ + +`tac` コマンドや `tail` の `-r` +オプションは環境によって利用できないことがあり、複数の環境を行き来する場合に採用しづらい + +=== `:g/^/m0` + +こちらは外部コマンドに頼らず、Vim の機能のみを使う。`g` は `:global` +コマンドの、`m` は `:move` コマンドの略 + +`:global` コマンドは `:[range]global/{pattern}/[command]` +のように使い、`[range]` で指定された範囲の行のうち、`{pattern}` +で指定された検索パターンにマッチする行に対して、順番に `[command]` +で指定された Ex コマンドを呼び出す。 + +____ +:h :global +____ + +`:move` コマンドは `[range]:move {address}` のように使い、`[range]` +で指定された範囲の行を `{address}` で指定された位置に移動させる。 + +____ +:h :move +____ + +`:g/^/m0` のように組み合わせると、「すべての行を1行ずつ +0行目(1行目の上)に動かす」という動きをする。これは確かに行の入れ替えになっている。 + +なお、`:g/^/m0` は全ての行を入れ替えるが、`:N,Mg/^/mN-1` とすることで +N行目から +M行目を処理範囲とするよう拡張できる。手でこれを入力するわけにはいかないので、次のようなコマンドを用意する。 + +[source,vim] +---- +command! -bar -range=% + \ Reverse + \ ,g/^/m-1 +---- + +これは望みの動作をするが、実際に実行してみると全行がハイライトされてしまう。次節で詳細を述べる。 + +== `:g/^/m0` の問題点 + +`:global` +コマンドは各行に対してマッチングを行う際、現在の検索パターンを上書きしてしまう。`^` +は行の先頭にマッチするため、結果として全ての行がハイライトされてしまう。`'hlsearch'` +オプションを無効にしている場合その限りではないが、その場合でも直前の検索パターンが失われてしまうと +`n` コマンドなどの際に不便である。 + +____ +:h @/ +____ + +== 解決策 + +____ +[2020/9/28追記] より簡潔な方法を見つけたので次節に追記した +____ + +前述した `:Reverse` コマンドの定義を少し変えて、次のようにする: + +[source,vim] +---- +function! s:reverse_lines(from, to) abort + execute printf("%d,%dg/^/m%d", a:from, a:to, a:from - 1) +endfunction + +command! -bar -range=% + \ Reverse + \ call reverse_lines(, ) +---- + +実行しているコマンドが変わったわけではないが、関数呼び出しを経由するようにした。これだけで前述の問題が解決する。 + +この理由は、ユーザー定義関数を実行する際は検索パターンが一度保存され、実行が終了したあと復元されるため。結果として検索パターンが +`^` で上書きされることがなくなる。 + +Vim のヘルプから該当箇所を引用する (強調は筆者による)。 + +____ +:h autocmd-searchpat + +*Autocommands do not change the current search patterns.* Vim saves the +current search patterns before executing autocommands then restores them +after the autocommands finish. This means that autocommands do not +affect the strings highlighted with the `hlsearch' option. +____ + +これは autocommand +の実行に関しての記述だが、これと同じことがユーザー定義関数の実行時にも適用される。このことは +`:nohlsearch` のヘルプにある。同じく該当箇所を引用する +(強調は筆者による)。 + +____ +:h :nohlsearch + +(略) This command doesn’t work in an autocommand, because the +highlighting state is saved and restored when executing autocommands +|autocmd-searchpat|. *Same thing for when invoking a user function.* +____ + +この仕様により、`:g/^/m0` +の呼び出しをユーザー定義関数に切り出すことで上述の問題を解決できる。 + +== 解決策 (改訂版) + +____ +[2020/9/28追記] より簡潔な方法を見つけたため追記する +____ + +[source,vim] +---- +command! -bar -range=% + \ Reverse + \ keeppatterns ,g/^/m-1 +---- + +まさにこのための Exコマンド、`:keeppatterns` +が存在する。`:keeppatterns {command}` +のように使い、読んで字の如く、後ろに続く +Exコマンドを「現在の検索パターンを保ったまま」実行する。はるかに分かりやすく意図を表現できる。 + +____ +:h :keeppatterns +____ + +== コピペ用再掲 + +[source,vim] +---- +" License: Public Domain + +command! -bar -range=% + \ Reverse + \ keeppatterns ,g/^/m-1 +---- diff --git a/content/posts/2021-10-02/vim-swap-order-of-selected-lines.md b/content/posts/2021-10-02/vim-swap-order-of-selected-lines.md deleted file mode 100644 index 10a6452..0000000 --- a/content/posts/2021-10-02/vim-swap-order-of-selected-lines.md +++ /dev/null @@ -1,145 +0,0 @@ ---- -title: "Vimで選択した行の順番を入れ替える" -date: 2021-10-02T09:37:25+09:00 -tags: ["vim"] -summary: | - Vim で選択した行の順番を入れ替える方法。 -changelog: - 2021-10-02: Qiita から移植 ---- - -この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/4fefb361d9a693803520 - - ------------------------------------ - - - -# バージョン情報 - -`:version` の一部 - -> VIM - Vi IMproved 8.2 (2019 Dec 12, compiled Jan 26 2020 11:30:30) -> macOS version -> Included patches: 1-148 -> Huge version without GUI. - - - -# よく紹介されている手法 - -## `tac` / `tail` - -`tac` や `tail -r` などの外部コマンドを `!` を使って呼び出し、置き換える。 - -> :h v_! - -`tac` コマンドや `tail` の `-r` オプションは環境によって利用できないことがあり、複数の環境を行き来する場合に採用しづらい - - - - -## `:g/^/m0` - -こちらは外部コマンドに頼らず、Vim の機能のみを使う。`g` は `:global` コマンドの、`m` は `:move` コマンドの略 - -`:global` コマンドは `:[range]global/{pattern}/[command]` のように使い、`[range]` で指定された範囲の行のうち、`{pattern}` で指定された検索パターンにマッチする行に対して、順番に `[command]` で指定された Ex コマンドを呼び出す。 - -> :h :global - -`:move` コマンドは `[range]:move {address}` のように使い、`[range]` で指定された範囲の行を `{address}` で指定された位置に移動させる。 - -> :h :move - -`:g/^/m0` のように組み合わせると、「すべての行を1行ずつ 0行目(1行目の上)に動かす」という動きをする。これは確かに行の入れ替えになっている。 - -なお、`:g/^/m0` は全ての行を入れ替えるが、`:N,Mg/^/mN-1` とすることで N行目から M行目を処理範囲とするよう拡張できる。手でこれを入力するわけにはいかないので、次のようなコマンドを用意する。 - -```vim -command! -bar -range=% - \ Reverse - \ ,g/^/m-1 -``` - -これは望みの動作をするが、実際に実行してみると全行がハイライトされてしまう。次節で詳細を述べる。 - - - -# `:g/^/m0` の問題点 - -`:global` コマンドは各行に対してマッチングを行う際、現在の検索パターンを上書きしてしまう。`^` は行の先頭にマッチするため、結果として全ての行がハイライトされてしまう。`'hlsearch'` オプションを無効にしている場合その限りではないが、その場合でも直前の検索パターンが失われてしまうと `n` コマンドなどの際に不便である。 - -> :h @/ - - - -# 解決策 - -> [2020/9/28追記] -> より簡潔な方法を見つけたので次節に追記した - -前述した `:Reverse` コマンドの定義を少し変えて、次のようにする: - -```vim -function! s:reverse_lines(from, to) abort - execute printf("%d,%dg/^/m%d", a:from, a:to, a:from - 1) -endfunction - -command! -bar -range=% - \ Reverse - \ call reverse_lines(, ) -``` - -実行しているコマンドが変わったわけではないが、関数呼び出しを経由するようにした。これだけで前述の問題が解決する。 - -この理由は、ユーザー定義関数を実行する際は検索パターンが一度保存され、実行が終了したあと復元されるため。結果として検索パターンが `^` で上書きされることがなくなる。 - -Vim のヘルプから該当箇所を引用する (強調は筆者による)。 - -> :h autocmd-searchpat -> -> **Autocommands do not change the current search patterns.** Vim saves the current -> search patterns before executing autocommands then restores them after the -> autocommands finish. This means that autocommands do not affect the strings -> highlighted with the 'hlsearch' option. - -これは autocommand の実行に関しての記述だが、これと同じことがユーザー定義関数の実行時にも適用される。このことは `:nohlsearch` のヘルプにある。同じく該当箇所を引用する (強調は筆者による)。 - -> :h :nohlsearch -> -> (略) This command doesn't work in an autocommand, because -> the highlighting state is saved and restored when -> executing autocommands |autocmd-searchpat|. -> **Same thing for when invoking a user function.** - -この仕様により、`:g/^/m0` の呼び出しをユーザー定義関数に切り出すことで上述の問題を解決できる。 - - -# 解決策 (改訂版) - -> [2020/9/28追記] -> より簡潔な方法を見つけたため追記する - -```vim -command! -bar -range=% - \ Reverse - \ keeppatterns ,g/^/m-1 -``` - -まさにこのための Exコマンド、`:keeppatterns` が存在する。`:keeppatterns {command}` のように使い、読んで字の如く、後ろに続く Exコマンドを「現在の検索パターンを保ったまま」実行する。はるかに分かりやすく意図を表現できる。 - -> :h :keeppatterns - - -# コピペ用再掲 - - -```vim -" License: Public Domain - -command! -bar -range=% - \ Reverse - \ keeppatterns ,g/^/m-1 -``` - diff --git a/content/posts/2022-04-09/phperkaigi-2022-tokens.adoc b/content/posts/2022-04-09/phperkaigi-2022-tokens.adoc new file mode 100644 index 0000000..51d9a36 --- /dev/null +++ b/content/posts/2022-04-09/phperkaigi-2022-tokens.adoc @@ -0,0 +1,469 @@ += PHPerKaigi 2022 トークン問題の解説 +:tags: conference, php, phperkaigi +:description: PHPerKaigi 2022 で私が作成した PHPer チャレンジ問題を解説する。 +:revision-1: 2022-04-09 公開 +:revision-2: 2022-04-16 2問目、3問目の解説を追加、1問目に加筆 + +== はじめに + +本日開始された https://phperkaigi.jp/2022/[PHPerKaigi 2022] の PHPer +チャレンジにおいて、弊社 +https://www.dgcircus.com/[デジタルサーカス株式会社] の問題を +3問作成した。この記事では、これらの問題の解説をおこなう。 + +リポジトリはこちら: https://github.com/nsfisis/PHPerKaigi2022-tokens + +== 第1問 brainf_ck.php + +ソースコードはこちら。実行には PHP 8.1 以上が必要なので注意。 + +[source,php] +---- + (fn($x) => $f(fn(...$xs) => $x($x)(...$xs)))(fn($x) => $f(fn(...$xs) => $x($x)(...$xs))); +$id = \spl_object_id(...); +$put = fn($c) => \printf('%c', $c); +$mm = fn($p, $n) => new \ArrayObject(\array_fill(+!![], $n, $p)); + +$👉 = fn($m, $p, $b, $e, $mp, $pc) => [++$mp, ++$pc]; +$👈 = fn($m, $p, $b, $e, $mp, $pc) => [--$mp, ++$pc]; +$👍 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, ++$m[$mp]]; +$👎 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, --$m[$mp]]; +$📝 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, $put($m[$mp])]; +$🤡 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) { + +!![] => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) { + $b => $loop(++$pc, ++$n), + $e => $n === +!![] ? ++$pc : $loop(++$pc, --$n), + default => $loop(++$pc, $n), + })($pc, -![])], + default => [$mp, ++$pc], +}; +$🎪 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) { + +!![] => [$mp, ++$pc], + default => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) { + $e => $loop(--$pc, ++$n), + $b => $n === +!![] ? $pc+![] : $loop(--$pc, --$n), + default => $loop(--$pc, $n), + })($pc, -![])], +}; +$🐘 = fn($p) => $z(fn($loop) => fn($m, $p, $b, $e, $mp, $pc) => + isset($p[$pc]) && $loop($m, $p, $b, $e, ...($p[$pc]($m, $p, $b, $e, $mp, $pc))) +)($mm(+!![], +(![].![])), $p, $id($🤡), $id($🎪), +!![], +!![]); + +$🐘([ + $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, + $🤡, + $👉, $👍, $👍, $👍, + $👉, $👍, $👍, $👍, $👍, $👍, + $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, + $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, + $👈, $👈, $👈, $👈, $👎, + $🎪, + $👉, $👍, $👍, $👍, $👍, $👍, $📝, + $👎, $👎, $📝, + $👉, $👎, $👎, $👎, $📝, + $👉, $👎, $👎, $👎, $📝, + $👎, $👎, $📝, + $👎, $📝, + $👈, $📝, + $👉, $👉, $👎, $👎, $📝, + $👍, $👍, $👍, $👍, $👍, $👍, $👍, $📝, + $👈, $👎, $👎, $👎, $👎, $📝, + $👈, $📝, + $👉, $👍, $👍, $📝, + $👉, $👎, $📝, + $👈, $📝, +]); +---- + +この問題は、単に適切なバージョンの PHP で動かせばトークンが得られる。 + +=== 解説 + +==== 絵文字 + +まず目につくのは大量の絵文字だろう。 PHP +は識別子に使用できる文字の範囲が広く、絵文字も使うことができる。 + +==== プログラム全体 + +Brainf*ck のインタプリタとプログラムになっている。 Brainf*ck +とは、難解プログラミング言語のひとつであり、ここで説明するよりも +Wikipedia の該当ページを読んだ方がよい。 + +https://ja.wikipedia.org/wiki/Brainfuck + +なお、brainf*ck プログラムを普通の書き方で書くと、次のようになる。 + +.... ++ + + + + + + + + + +[ + > + + + + > + + + + + + > + + + + + + + + + + + + + > + + + + + + + + + + + < < < < - +] +> + + + + + . +- - . +> - - - . +> - - - . +- - . +- . +< . +> > - - . ++ + + + + + + . +< - - - - . +< . +> + + . +> - . +< . +.... + +実行結果はこちら: https://ideone.com/22VWmb + +それぞれの絵文字で表された関数が、各命令に対応している。 + +* `$👉`: `>` +* `$👈`: `<` +* `$👍`: `+` +* `$👎`: `-` +* `$📝`: `.` +* `$🤡`: `[` +* `$🎪`: `]` + +`,` (入力) に対応する関数はない +(このプログラムでは使わないので用意していない)。 + +なお、`$🐘` はいわゆる main 関数であり、プログラムの実行部分である。 + +==== 絵文字の選択 + +おおよそ意味に合致するよう選んでいるが、`$🤡` と `$🎪` +は弊社デジタルサーカスにちなんでいる。 また、`$🐘` は PHP +のマスコットの象に由来する。 + +==== strict_types + +`declare` 文の `strict_types` に指定できるのは、`0` か `1` +の数値リテラルだが、 `0x0` や `0b1` のような値も受け付ける。 今回は、PHP +8.1 から追加された、`0O` または `0o` から始まる八進数リテラルを使った。 + +==== URL + +ソースコードのライセンスを示したこの部分だが、 + +[source,php] +---- +https://creativecommons.org/publicdomain/zero/1.0/ +---- + +完全に合法な PHP のコードである。 `https:` 部分はラベル、`//` +以降は行コメントになっている。 + +==== リテラルなしで数値を生成する + +ソースコード中に、ほとんど数値リテラルが書かれていないことにお気づきだろうか。 +PHP では、型変換を利用することで任意の整数を作り出すことができる。 + +[source,php] +---- +assert(0 === +!![]); +assert(1 === +![]); +assert(2 === ![]+![]); +assert(3 === ![]+![]+![]); +assert(10 === +(![].+!![])); +---- + +`[]` に `!` を適用すると `true` が返ってくる。それに `+` +を適用すると、`bool` から `int` ヘの型変換が走り、`1` が生成される。`10` +はさらにトリッキーだ。まず `1` と `0` を作り、`.` で文字列として結合する +(`'10'`)。これに `+` を適用すると、`string` から `int` +への型変換が走り、`10` が生まれる (コード量に頓着しないなら、`1` を 10 +個足し合わせてももちろん 10 が作れる)。 + +また、`error_reporting` に指定しているのは `-1` である。 これは、`!` +によって文字列を `false` にし、`+` によって `false` を `0` +にし、さらにビット反転して `-1` にしている。 + +==== `if` 文なしで条件分岐 + +三項演算子ないし `match` 式を使うことで、`if` +を一切書かずに条件分岐ができる。 また、`&&` / `||` も使えることがある。 +遅延評価が不要なケースでは、`[$t, $f][$cond]` +のような形で分岐することもできる。 + +==== `while`、`for` 文なしでループ + +不動点コンビネータを使って無名再帰する +(詳しい説明は省略する。これらの単語で検索してほしい)。 ここでは、一般に +Z コンビネータとして知られるものを使った (`$z`)。 + +実際のところ、`$🤡` や `$🎪`、`$🐘` は、一度 Scheme (Lisp の一種) +で書いてから PHP に翻訳する形で記述した。 + +なお、PHP は末尾再帰の最適化をおこなわない (少なくとも今のところは) +ので、 あまりに長い brainf*ck +プログラムを書くとスタックオーバーフローする。 + +== 第2問 riddle.php + +ソースコードはこちら。実行には PHP 8.0 以上が必要なので注意。 + +[source,php] +---- + vzcybqr(', ', $j), neenl_puhax(neenl_znc(sa($k) => fcevags('0k' . pue(37) . '07K', $k), $kf), 10)); +cevags($f, $g, fge_ebg13("<<<'Q'\a{$f}\aQ"), vzcybqr(",\a", $jf)); +Q; +$s = str_rot13($s); $xs = [ +0x0AFABEA, 0x1F294A7, 0x1F2109F, 0x1F294A7, 0x0002800, 0x1F2109F, 0x0117041, 0x1F294A7, 0x1FAD6B5, 0x1F295B7, +0x010FC21, 0x1FAD6B5, 0x1151151, 0x010FC21, 0x1F294A7, 0x1F295B7, 0x1FAD6B5, 0x1F294A7, 0x1F295B7, 0x1F8C63F, +0x1F8C631, 0x1FAD6B5, 0x17AD6BD, 0x17AD6BD, 0x1F8C63F, 0x1F295B7, +]; +$t = null.false; for ($i = 0; $i <= intdiv(__LINE__-035,6); ++$i) if (!isset($xs[$i])) break; else +$t .= implode("\n", str_split(str_replace(['0','1'], [' ','##'], sprintf(chr(37) . '025b', $xs[$i])), 012)) . "\n\n"; +$ws = array_map(fn($w) => implode(', ', $w), array_chunk(array_map(fn($x) => sprintf('0x' . chr(37) . '07X', $x), $xs), 10)); +printf($s, $t, str_rot13("<<<'D'\n{$s}\nD"), implode(",\n", $ws)); +---- + +コメントにもあるとおり、次のようにして実行すれば答えがでてくる。 + +[source,shell-session] +---- +$ php toquine.php | php | php | php | ... +---- + +実際にはもう少しパイプで繋げなければならない。 + +=== 解説 + +==== プログラム全体 + +コメントにもあるとおり、これは quine (風) のプログラムになっている。 +Quine +とは、自分のソースコードをそっくりそのまま出力するようなプログラムのことである。 + +このプログラムは、実行すると自身とほとんど同じプログラムを出力する。 +異なるのはトークンになっている部分のみである。 + +==== トークン + +`$xs` がトークンに対応している。変換のロジックは `riddle.php` +とほぼ同じなので省略する。 + +==== 状態保持 + +トークンの何文字目まで出力したかを、ソースコードを変えずに (quine +なので) 覚えておく必要がある。 +このプログラムでは、トークンが出力されるとソースコードがだんだんと長くなっていくのを利用して、`__LINE__` +から情報を取得している。 + +==== ROT 13 + +Quine は、素朴に書くとプログラムの一部が 2回記述されてしまう。 +これがあまり美しくないので、`toquine.php` では、ROT 13 +変換を使って難読化した。 + +それにしてもなぜこんなものが標準ライブラリに……。 + +== おわりに + +解いていただいたみなさん、また、難易度調整につきあっていただいた社内のみなさん、ありがとうございました。 + +今回は直前に作りはじめたのもあり、3問だけかつ使い古されたネタばかりになってしまいましたが、 +来年は 5問、より面白い問題を持っていきます。 + +実はもう作りはじめているので、どうか来年もありますように……。 diff --git a/content/posts/2022-04-09/phperkaigi-2022-tokens.md b/content/posts/2022-04-09/phperkaigi-2022-tokens.md deleted file mode 100644 index 5640b8f..0000000 --- a/content/posts/2022-04-09/phperkaigi-2022-tokens.md +++ /dev/null @@ -1,461 +0,0 @@ ---- -title: "PHPerKaigi 2022 トークン問題の解説" -date: 2022-04-09T21:50:19+09:00 -lastmod: 2022-04-16 -tags: ["conference", "php", "phperkaigi"] -summary: | - PHPerKaigi 2022 で私が作成した PHPer チャレンジ問題を解説する。 -changelog: - 2022-04-09: 公開 - 2022-04-16: 2問目、3問目の解説を追加、1問目に加筆 ---- - -# はじめに - -本日開始された [PHPerKaigi 2022](https://phperkaigi.jp/2022/) の PHPer チャレンジにおいて、弊社 [デジタルサーカス株式会社](https://www.dgcircus.com/) の問題を 3問作成した。この記事では、これらの問題の解説をおこなう。 - -リポジトリはこちら: https://github.com/nsfisis/PHPerKaigi2022-tokens - - - -# 第1問 brainf_ck.php - -ソースコードはこちら。実行には PHP 8.1 以上が必要なので注意。 - -```php - (fn($x) => $f(fn(...$xs) => $x($x)(...$xs)))(fn($x) => $f(fn(...$xs) => $x($x)(...$xs))); -$id = \spl_object_id(...); -$put = fn($c) => \printf('%c', $c); -$mm = fn($p, $n) => new \ArrayObject(\array_fill(+!![], $n, $p)); - -$👉 = fn($m, $p, $b, $e, $mp, $pc) => [++$mp, ++$pc]; -$👈 = fn($m, $p, $b, $e, $mp, $pc) => [--$mp, ++$pc]; -$👍 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, ++$m[$mp]]; -$👎 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, --$m[$mp]]; -$📝 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, $put($m[$mp])]; -$🤡 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) { - +!![] => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) { - $b => $loop(++$pc, ++$n), - $e => $n === +!![] ? ++$pc : $loop(++$pc, --$n), - default => $loop(++$pc, $n), - })($pc, -![])], - default => [$mp, ++$pc], -}; -$🎪 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) { - +!![] => [$mp, ++$pc], - default => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) { - $e => $loop(--$pc, ++$n), - $b => $n === +!![] ? $pc+![] : $loop(--$pc, --$n), - default => $loop(--$pc, $n), - })($pc, -![])], -}; -$🐘 = fn($p) => $z(fn($loop) => fn($m, $p, $b, $e, $mp, $pc) => - isset($p[$pc]) && $loop($m, $p, $b, $e, ...($p[$pc]($m, $p, $b, $e, $mp, $pc))) -)($mm(+!![], +(![].![])), $p, $id($🤡), $id($🎪), +!![], +!![]); - -$🐘([ - $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, - $🤡, - $👉, $👍, $👍, $👍, - $👉, $👍, $👍, $👍, $👍, $👍, - $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, - $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, - $👈, $👈, $👈, $👈, $👎, - $🎪, - $👉, $👍, $👍, $👍, $👍, $👍, $📝, - $👎, $👎, $📝, - $👉, $👎, $👎, $👎, $📝, - $👉, $👎, $👎, $👎, $📝, - $👎, $👎, $📝, - $👎, $📝, - $👈, $📝, - $👉, $👉, $👎, $👎, $📝, - $👍, $👍, $👍, $👍, $👍, $👍, $👍, $📝, - $👈, $👎, $👎, $👎, $👎, $📝, - $👈, $📝, - $👉, $👍, $👍, $📝, - $👉, $👎, $📝, - $👈, $📝, -]); -``` - -この問題は、単に適切なバージョンの PHP で動かせばトークンが得られる。 - - -## 解説 - -### 絵文字 - -まず目につくのは大量の絵文字だろう。 -PHP は識別子に使用できる文字の範囲が広く、絵文字も使うことができる。 - - -### プログラム全体 - -Brainf\*ck のインタプリタとプログラムになっている。 -Brainf\*ck とは、難解プログラミング言語のひとつであり、ここで説明するよりも Wikipedia の該当ページを読んだ方がよい。 - -https://ja.wikipedia.org/wiki/Brainfuck - -なお、brainf\*ck プログラムを普通の書き方で書くと、次のようになる。 - -``` -+ + + + + + + + + + -[ - > + + + - > + + + + + - > + + + + + + + + + + + + - > + + + + + + + + + + - < < < < - -] -> + + + + + . -- - . -> - - - . -> - - - . -- - . -- . -< . -> > - - . -+ + + + + + + . -< - - - - . -< . -> + + . -> - . -< . -``` - -実行結果はこちら: https://ideone.com/22VWmb - -それぞれの絵文字で表された関数が、各命令に対応している。 - -* `$👉`: `>` -* `$👈`: `<` -* `$👍`: `+` -* `$👎`: `-` -* `$📝`: `.` -* `$🤡`: `[` -* `$🎪`: `]` - -`,` (入力) に対応する関数はない (このプログラムでは使わないので用意していない)。 - -なお、`$🐘` はいわゆる main 関数であり、プログラムの実行部分である。 - - -### 絵文字の選択 - -おおよそ意味に合致するよう選んでいるが、`$🤡` と `$🎪` は弊社デジタルサーカスにちなんでいる。 -また、`$🐘` は PHP のマスコットの象に由来する。 - - -### strict_types - -`declare` 文の `strict_types` に指定できるのは、`0` か `1` の数値リテラルだが、 -`0x0` や `0b1` のような値も受け付ける。 -今回は、PHP 8.1 から追加された、`0O` または `0o` から始まる八進数リテラルを使った。 - - -### URL - -ソースコードのライセンスを示したこの部分だが、 - -```php -https://creativecommons.org/publicdomain/zero/1.0/ -``` - -完全に合法な PHP のコードである。 -`https:` 部分はラベル、`//` 以降は行コメントになっている。 - - -### リテラルなしで数値を生成する - -ソースコード中に、ほとんど数値リテラルが書かれていないことにお気づきだろうか。 -PHP では、型変換を利用することで任意の整数を作り出すことができる。 - -```php -assert(0 === +!![]); -assert(1 === +![]); -assert(2 === ![]+![]); -assert(3 === ![]+![]+![]); -assert(10 === +(![].+!![])); -``` - -`[]` に `!` を適用すると `true` が返ってくる。それに `+` -を適用すると、`bool` から `int` ヘの型変換が走り、`1` が生成される。`10` -はさらにトリッキーだ。まず `1` と `0` を作り、`.` で文字列として結合する -(`'10'`)。これに `+` を適用すると、`string` から `int` -への型変換が走り、`10` が生まれる (コード量に頓着しないなら、`1` を 10 -個足し合わせてももちろん 10 が作れる)。 - -また、`error_reporting` に指定しているのは `-1` である。 -これは、`!` によって文字列を `false` にし、`+` によって `false` を `0` にし、さらにビット反転して `-1` にしている。 - - -### `if` 文なしで条件分岐 - -三項演算子ないし `match` 式を使うことで、`if` を一切書かずに条件分岐ができる。 -また、`&&` / `||` も使えることがある。 -遅延評価が不要なケースでは、`[$t, $f][$cond]` のような形で分岐することもできる。 - -### `while`、`for` 文なしでループ - -不動点コンビネータを使って無名再帰する (詳しい説明は省略する。これらの単語で検索してほしい)。 -ここでは、一般に Z コンビネータとして知られるものを使った (`$z`)。 - -実際のところ、`$🤡` や `$🎪`、`$🐘` は、一度 Scheme (Lisp の一種) で書いてから PHP に翻訳する形で記述した。 - -なお、PHP は末尾再帰の最適化をおこなわない (少なくとも今のところは) ので、 -あまりに長い brainf\*ck プログラムを書くとスタックオーバーフローする。 - - -# 第2問 riddle.php - -ソースコードはこちら。実行には PHP 8.0 以上が必要なので注意。 - -```php - vzcybqr(', ', $j), neenl_puhax(neenl_znc(sa($k) => fcevags('0k' . pue(37) . '07K', $k), $kf), 10)); -cevags($f, $g, fge_ebg13("<<<'Q'\a{$f}\aQ"), vzcybqr(",\a", $jf)); -Q; -$s = str_rot13($s); $xs = [ -0x0AFABEA, 0x1F294A7, 0x1F2109F, 0x1F294A7, 0x0002800, 0x1F2109F, 0x0117041, 0x1F294A7, 0x1FAD6B5, 0x1F295B7, -0x010FC21, 0x1FAD6B5, 0x1151151, 0x010FC21, 0x1F294A7, 0x1F295B7, 0x1FAD6B5, 0x1F294A7, 0x1F295B7, 0x1F8C63F, -0x1F8C631, 0x1FAD6B5, 0x17AD6BD, 0x17AD6BD, 0x1F8C63F, 0x1F295B7, -]; -$t = null.false; for ($i = 0; $i <= intdiv(__LINE__-035,6); ++$i) if (!isset($xs[$i])) break; else -$t .= implode("\n", str_split(str_replace(['0','1'], [' ','##'], sprintf(chr(37) . '025b', $xs[$i])), 012)) . "\n\n"; -$ws = array_map(fn($w) => implode(', ', $w), array_chunk(array_map(fn($x) => sprintf('0x' . chr(37) . '07X', $x), $xs), 10)); -printf($s, $t, str_rot13("<<<'D'\n{$s}\nD"), implode(",\n", $ws)); -``` - -コメントにもあるとおり、次のようにして実行すれば答えがでてくる。 - -```shell-session -$ php toquine.php | php | php | php | ... -``` - -実際にはもう少しパイプで繋げなければならない。 - - -## 解説 - -### プログラム全体 - -コメントにもあるとおり、これは quine (風) のプログラムになっている。 -Quine とは、自分のソースコードをそっくりそのまま出力するようなプログラムのことである。 - -このプログラムは、実行すると自身とほとんど同じプログラムを出力する。 -異なるのはトークンになっている部分のみである。 - - -### トークン - -`$xs` がトークンに対応している。変換のロジックは `riddle.php` とほぼ同じなので省略する。 - - -### 状態保持 - -トークンの何文字目まで出力したかを、ソースコードを変えずに (quine なので) 覚えておく必要がある。 -このプログラムでは、トークンが出力されるとソースコードがだんだんと長くなっていくのを利用して、`__LINE__` から情報を取得している。 - - -### ROT 13 - -Quine は、素朴に書くとプログラムの一部が 2回記述されてしまう。 -これがあまり美しくないので、`toquine.php` では、ROT 13 変換を使って難読化した。 - -それにしてもなぜこんなものが標準ライブラリに……。 - - - -# おわりに - -解いていただいたみなさん、また、難易度調整につきあっていただいた社内のみなさん、ありがとうございました。 - -今回は直前に作りはじめたのもあり、3問だけかつ使い古されたネタばかりになってしまいましたが、 -来年は 5問、より面白い問題を持っていきます。 - -実はもう作りはじめているので、どうか来年もありますように……。 diff --git a/content/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal.adoc b/content/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal.adoc new file mode 100644 index 0000000..409f498 --- /dev/null +++ b/content/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal.adoc @@ -0,0 +1,86 @@ += term-banner: ターミナルにバナーを表示するツールを書いた +:description: ターミナルに任意の文字のバナーを表示するためのツールを Go で書いた。 +:revision-1: 2022-04-24 公開 +:revision-2: 2022-04-27 -f オプションについて追記 + +== はじめに + +こんなものを作った。 + +.... +$ term-banner 'Hello, World!' 'こんにちは、' '世界！' +.... + +image::https://raw.githubusercontent.com/nsfisis/term-banner/main/screenshot.png[term-banner +のスクリーンショット] + +コマンドライン引数として渡した文字列をターミナルに大きく表示する。 + +リポジトリはこちら: https://github.com/nsfisis/term-banner + +== Motivation + +以前、https://github.com/nsfisis/big-clock-mode[big-clock-mode] +という似たようなプログラムを書いた。 これは tmux の `:clock-mode` +コマンドに着想を得たもので、`:clock-mode` +よりも大きく現在時刻を表示する。 + +`big-clock-mode` +を開発したのは、次のようなシチュエーションで使うためである。 +弊社では現在リモートワークが基本だが、web +会議などで画面共有しているときに、休憩を挟んで特定の時刻から再開する、ということがある。 +こういったケースで、画面上に現在の時刻を大きめに表示しておくと、モニタから離れても遠くから時刻がわかるので便利である。 + +それこそタイマアプリか何かを使えばいいのだが、ターミナルに棲むいきものとしては、住処から離れたくないわけだ。 + +しばらく便利に使っていたのだが、ひとつ不満点が出てきた。それは、再開する時刻がいつだったかを覚えておかなければならないということだ。 +どこかにメモしておいてもいいが、せっかくなら現在時刻とともに表示させておきたい。 + +そんなわけで、「任意の文字列をターミナルに表示する」プログラムを書く運びとなった。 +まあ、作らなくても探せばあると思うが、作りたいものは作りたいので知ったことではない。 + +== プログラム + +全体の流れは次のようになっている。 + +[arabic] +. フォントファイルを読み込む +. コマンドライン引数を Shift-JIS に変換する (フォントが Shift-JIS +基準で並んでいるため) +. 1文字ずつレンダリングしていく + +`big-clock-mode` が Go 製なので、今回も Go で書いた。 PNG +が標準ライブラリにあったり、Shift-JIS +のエンコーディングが準標準ライブラリにあったりしたのは助かった。 + +フォントファイルは `go:embed` +で実行ファイルに埋め込んでいるので、ビルド後はワンバイナリで動く。 +仕事ではスクリプト言語ばかり書いているが、やはりコンパイル言語はいい。 + +== フォント + +フリーの 8x8 +ビットマップフォントである、https://littlelimit.net/misaki.htm[美咲フォント +2021-05-05a 版] を使わせていただいた。 + +はじめは自分でポチポチ打っていたのだが、「き」くらいまでやって挫折した。 +同じく 8x8 +で作っていたのだが、平仮名でさえも、この小さなキャンバスにはとても収められない。 + +美咲フォントは、平仮名・片仮名に留まらず、JIS +第一・第二水準の漢字までサポートしている。 +第二水準ともなると一生お目にかかることのない字の方が多いくらいだが、これをこの大きさで書くというのは、もはや芸術の域である。 + +さらに言うと、実のところ美咲フォントは実サイズ 7x7 +で作られており、余白が設けられている。 +これは、単純にそのまま並べても字間・行間を確保できるようにという配慮である。 +おかげでコーディングまで楽になった。 + +ゴシック体と明朝体があったが、私の好みで明朝体の方にした。 +ただ、ゴシック体の方が見やすい気がするので、フォントを選べるように後ほど拡張するかもしれない。 + +2022-04-27 追記: `-f` オプションで選べるようにした。 + +== おわりに + +あなたもターミナルに住んでみませんか？ diff --git a/content/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal.md b/content/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal.md deleted file mode 100644 index 3e234fb..0000000 --- a/content/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal.md +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: "term-banner: ターミナルにバナーを表示するツールを書いた" -date: 2022-04-24T13:22:52+09:00 -lastmod: 2022-04-27 -tags: ["my-programs"] -summary: | - ターミナルに任意の文字のバナーを表示するためのツールを Go で書いた。 -changelog: - 2022-04-24: 公開 - 2022-04-27: -f オプションについて追記 ---- - - - -# はじめに - -こんなものを作った。 - -``` -$ term-banner 'Hello, World!' 'こんにちは、' '世界！' -``` - -![term-banner のスクリーンショット](https://raw.githubusercontent.com/nsfisis/term-banner/main/screenshot.png) - -コマンドライン引数として渡した文字列をターミナルに大きく表示する。 - -リポジトリはこちら: https://github.com/nsfisis/term-banner - - - -# Motivation - -以前、[big-clock-mode](https://github.com/nsfisis/big-clock-mode) という似たようなプログラムを書いた。 -これは tmux の `:clock-mode` コマンドに着想を得たもので、`:clock-mode` よりも大きく現在時刻を表示する。 - -`big-clock-mode` を開発したのは、次のようなシチュエーションで使うためである。 -弊社では現在リモートワークが基本だが、web 会議などで画面共有しているときに、休憩を挟んで特定の時刻から再開する、ということがある。 -こういったケースで、画面上に現在の時刻を大きめに表示しておくと、モニタから離れても遠くから時刻がわかるので便利である。 - -それこそタイマアプリか何かを使えばいいのだが、ターミナルに棲むいきものとしては、住処から離れたくないわけだ。 - -しばらく便利に使っていたのだが、ひとつ不満点が出てきた。それは、再開する時刻がいつだったかを覚えておかなければならないということだ。 -どこかにメモしておいてもいいが、せっかくなら現在時刻とともに表示させておきたい。 - -そんなわけで、「任意の文字列をターミナルに表示する」プログラムを書く運びとなった。 -まあ、作らなくても探せばあると思うが、作りたいものは作りたいので知ったことではない。 - - - -# プログラム - -全体の流れは次のようになっている。 - -1. フォントファイルを読み込む -1. コマンドライン引数を Shift-JIS に変換する (フォントが Shift-JIS 基準で並んでいるため) -1. 1文字ずつレンダリングしていく - -`big-clock-mode` が Go 製なので、今回も Go で書いた。 -PNG が標準ライブラリにあったり、Shift-JIS のエンコーディングが準標準ライブラリにあったりしたのは助かった。 - -フォントファイルは `go:embed` で実行ファイルに埋め込んでいるので、ビルド後はワンバイナリで動く。 -仕事ではスクリプト言語ばかり書いているが、やはりコンパイル言語はいい。 - - - -# フォント - -フリーの 8x8 ビットマップフォントである、[美咲フォント 2021-05-05a 版](https://littlelimit.net/misaki.htm) を使わせていただいた。 - -はじめは自分でポチポチ打っていたのだが、「き」くらいまでやって挫折した。 -同じく 8x8 で作っていたのだが、平仮名でさえも、この小さなキャンバスにはとても収められない。 - -美咲フォントは、平仮名・片仮名に留まらず、JIS 第一・第二水準の漢字までサポートしている。 -第二水準ともなると一生お目にかかることのない字の方が多いくらいだが、これをこの大きさで書くというのは、もはや芸術の域である。 - -さらに言うと、実のところ美咲フォントは実サイズ 7x7 で作られており、余白が設けられている。 -これは、単純にそのまま並べても字間・行間を確保できるようにという配慮である。 -おかげでコーディングまで楽になった。 - -ゴシック体と明朝体があったが、私の好みで明朝体の方にした。 -ただ、ゴシック体の方が見やすい気がするので、フォントを選べるように後ほど拡張するかもしれない。 - -2022-04-27 追記: `-f` オプションで選べるようにした。 - - - -# おわりに - -あなたもターミナルに住んでみませんか？ diff --git a/content/posts/2022-05-01/phperkaigi-2022.adoc b/content/posts/2022-05-01/phperkaigi-2022.adoc new file mode 100644 index 0000000..863e30b --- /dev/null +++ b/content/posts/2022-05-01/phperkaigi-2022.adoc @@ -0,0 +1,130 @@ += PHPerKaigi 2022 +:tags: conference, php, phperkaigi +:description: 2022-04-09 から 2022-04-11 にかけて開催された、PHPerKaigi 2022 に参加した。 +:revision-1: 2022-05-01 公開 + +== はじめに + +2022-04-09 から 2022-04-11 +にかけて開催された、https://phperkaigi.jp/2022/[PHPerKaigi 2022] +に、一般参加者として参加した。 +弊社https://www.dgcircus.com/[デジタルサーカス株式会社] +はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。 + +昨年のレポートはlink:/posts/2021-03-30/phperkaigi-2021[こちら]。 + +== 感想 + +=== 厳選おすすめトーク + +多くの素晴らしいトークの中から、特におすすめのものを +5つ選んだ。是非聞いてほしい。引用部分は、リンク先プロポーザルから引用している。 + +https://fortee.jp/phperkaigi-2022/proposal/ef8cf4ed-63fe-42f8-8145-b3e70054458b[予防に勝る防御なし +- 堅牢なコードを導く様々な設計のヒント] + +____ +PHP +はバージョンを追う毎に型宣言、例外、表明、列挙型などの機能が大幅に強化され、堅牢なコードを書くための機能が充実してきました。それらの機能はどう使うと効果的なのでしょうか。 + +本講演では PHP 8.1 +をベースにして、誤りを想定してチェックするのではなく、そもそも誤りにくい設計とはどのようなものか、つまり「予防」の観点を軸足に、堅牢なコードを導くための様々な設計のヒントをご紹介します。 +____ + +https://fortee.jp/phperkaigi-2022/proposal/db00d49e-0dd6-453f-b54b-f731d112f10e[PHPのエラーを理解して適切なエラーハンドリングを学ぼう] + +____ +PHPを使ってるとよく遭遇する Fatal error / Parse error / Warning / Notice +理解していますか？ + +これらのエラー文を理解することで、すぐにエラーの原因に気付き適切に対象できる様になります！ + +またそれらを理解した上でのエラーハンドリングを学びましょう。 +____ + +https://fortee.jp/phperkaigi-2022/proposal/4a7e3ded-9134-4919-955c-ec7bf4491c0d[エラー監視とテスト体制への改善作戦] + +____ +毎日流れてくるエラーに皆さんはどう向き合ってますか？ + +エラーを出さない事が一番ですが、完全に塞ぐ事は難しいと考えます。 + +サービス運用の中で本番環境から発生するエラー（サーバー・クライアントサイド・サードパーティ起因のエラー）への監視体制と、 + +エラー・バグ防御のためチームで行っているテストコード文化づくりの話をします。 +____ + +https://fortee.jp/phperkaigi-2022/proposal/6f47daf8-c78f-4fb1-9b99-e9656e6fe7f7[ISUCON11のPHP実装は、何を考え、どのようにして作られていたのか] + +____ +昨年開催されたISUCON11にて問題（参考実装）のPHPへの移植を担当させていただきました。 + +最終的なソースコードこそシンプルなWebアプリケーションではありますが、その裏には + +・「（私の思う）良い設計」を実現するための意思決定 + +・「ISUCONの問題」という位置付けに由来する取捨選択 + +・移植中に遭遇したトラブルとその解決策 + +といった文脈や葛藤が存在しています。 + +本発表はそれらを共有することで + +・PHPアプリケーションの設計、実装事例として役立ててもらう + +・ISUCONの言語移植に興味を持ってもらう + +・ISUCON問題移植の「実装や設計の練習をする教材」としての可能性を知ってもらう + +ことを目的とします。 +____ + +https://fortee.jp/phperkaigi-2022/proposal/5a260e4e-542d-4d82-849d-ef3d6cb7c854[チームの仕事はまわっていたけど、メンバーはそれぞれモヤモヤを抱えていた話──40名の大規模開発チームで1on1ログを公開してみた] + +____ +サイボウズの大企業向けグループウェアのGaroon（ガルーン）は、PHPで開発されている20年目の製品です。ガルーン開発チームは日本で40名、ベトナムで50名の計90名ほどのチームになっています。また、コロナ禍でフルリモートでの活動がこの2年ほど継続してきました。 + +フルリモートになっても仕事はまわっており、継続的にリリースはしていましたが、一方でお互いの考えていることや感じている問題意識が見えづらくなり、モヤモヤを抱えているメンバーが増えていました。 + +このセッションでは、そういう状況で私がチーム外からジョインし、聴き役に徹しながら見える化することで状況を改善していった取り組みを紹介します。同じように大きなチームやリモートワークで難しさを感じている人に、難しさの原因への気づきや取り組みへのヒントがあれば幸いです。 +____ + +=== トークン問題の作成 + +今回は、PHPer チャレンジ用に弊社のトークン問題を +3題作成した。こちらについてはlink:/posts/2022-04-09/phperkaigi-2022-tokens[別途記事にしている]ので、そちらを参照されたい。 + +=== PHPer チャレンジ + +https://fortee.jp/phperkaigi-2022/challenge[1位]になった。 + +また、賞品として https://www.amazon.co.jp/dp/B08MQNJC9Z[Echo Show 15] +をいただいた。 + +=== カンファレンス全体への感想 + +link:/posts/2021-03-30/phperkaigi-2021[去年の参加レポ] +では、こんなことを書いた。 + +____ +1つ個人的な反省点としては、(中略) Discord +しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。 + +まあ初カンファレンスだし、とお茶を濁しておこう。 +____ + +この反省を踏まえ、今年は積極的にほかの場 (公式の Discord +サーバや、アンカンファレンス) にも参加した。 + +これにより、参加体験の質がはるかに向上した。特に Discord +に関しては、登壇者ご本人による補足や、質問への回答などがおこなわれる +(ことが多い) +ため、特別な理由のない限り、発言はしないまでも参加はしておいたほうが良いと思われる。 + +なお、アンカンファレンスについては、1日目の終わりにhttps://fortee.jp/phperkaigi-2022/unconference/view/d332797a-8921-4706-a7e2-ee72640c9b5e[トークン問題の解説放送]もおこなった。 + +また、今年はオフラインとオンラインのハイブリッド開催であったが、去年の全オンラインと比べて、オンライン参加の体験が落ちていなかったのは、特筆すべきであろう。 +今年は +3回目のワクチン接種が間に合わなかったこともあり現地参加は見送ったのだが、来年は是非オフラインで参加したい。 + +== そして来年へ……? + +PHPerKaigi 2023 があるかどうか存じ上げないが、あるとすれば、次の +4つを目標としたい。 + +* プロポーザルを出す +* PHPer チャレンジのトークン問題を 5題作成する +* 現地に行く +* PHPer チャレンジで圧勝する + +''''' + +最後になりましたが、PHPerKaigi +のスタッフ、スポンサー、スピーカーのみなさん、素敵な時間をありがとうございました。 + +ではまた来年。 diff --git a/content/posts/2022-05-01/phperkaigi-2022.md b/content/posts/2022-05-01/phperkaigi-2022.md deleted file mode 100644 index 8c9cdf2..0000000 --- a/content/posts/2022-05-01/phperkaigi-2022.md +++ /dev/null @@ -1,114 +0,0 @@ ---- -title: "PHPerKaigi 2022" -date: 2022-05-01T09:41:39+09:00 -tags: ["conference", "php", "phperkaigi"] -summary: | - 2022-04-09 から 2022-04-11 にかけて開催された、PHPerKaigi 2022 に参加した。 -changelog: - 2022-05-01: 公開 ---- - -# はじめに - -2022-04-09 から 2022-04-11 にかけて開催された、[PHPerKaigi 2022](https://phperkaigi.jp/2022/) に、一般参加者として参加した。 -弊社[デジタルサーカス株式会社](https://www.dgcircus.com/) はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。 - -昨年のレポートは[こちら](/posts/2021-03-30/phperkaigi-2021)。 - - - -# 感想 - -## 厳選おすすめトーク - -多くの素晴らしいトークの中から、特におすすめのものを 5つ選んだ。是非聞いてほしい。引用部分は、リンク先プロポーザルから引用している。 - -[予防に勝る防御なし - 堅牢なコードを導く様々な設計のヒント](https://fortee.jp/phperkaigi-2022/proposal/ef8cf4ed-63fe-42f8-8145-b3e70054458b) - -> PHP はバージョンを追う毎に型宣言、例外、表明、列挙型などの機能が大幅に強化され、堅牢なコードを書くための機能が充実してきました。それらの機能はどう使うと効果的なのでしょうか。 -> -> 本講演では PHP 8.1 をベースにして、誤りを想定してチェックするのではなく、そもそも誤りにくい設計とはどのようなものか、つまり「予防」の観点を軸足に、堅牢なコードを導くための様々な設計のヒントをご紹介します。 - -[PHPのエラーを理解して適切なエラーハンドリングを学ぼう](https://fortee.jp/phperkaigi-2022/proposal/db00d49e-0dd6-453f-b54b-f731d112f10e) - -> PHPを使ってるとよく遭遇する Fatal error / Parse error / Warning / Notice 理解していますか？ -> これらのエラー文を理解することで、すぐにエラーの原因に気付き適切に対象できる様になります！ -> またそれらを理解した上でのエラーハンドリングを学びましょう。 - -[エラー監視とテスト体制への改善作戦](https://fortee.jp/phperkaigi-2022/proposal/4a7e3ded-9134-4919-955c-ec7bf4491c0d) - -> 毎日流れてくるエラーに皆さんはどう向き合ってますか？ -> エラーを出さない事が一番ですが、完全に塞ぐ事は難しいと考えます。 -> サービス運用の中で本番環境から発生するエラー（サーバー・クライアントサイド・サードパーティ起因のエラー）への監視体制と、 -> エラー・バグ防御のためチームで行っているテストコード文化づくりの話をします。 - -[ISUCON11のPHP実装は、何を考え、どのようにして作られていたのか](https://fortee.jp/phperkaigi-2022/proposal/6f47daf8-c78f-4fb1-9b99-e9656e6fe7f7) - -> 昨年開催されたISUCON11にて問題（参考実装）のPHPへの移植を担当させていただきました。 -> -> 最終的なソースコードこそシンプルなWebアプリケーションではありますが、その裏には -> ・「（私の思う）良い設計」を実現するための意思決定 -> ・「ISUCONの問題」という位置付けに由来する取捨選択 -> ・移植中に遭遇したトラブルとその解決策 -> といった文脈や葛藤が存在しています。 -> -> 本発表はそれらを共有することで -> ・PHPアプリケーションの設計、実装事例として役立ててもらう -> ・ISUCONの言語移植に興味を持ってもらう -> ・ISUCON問題移植の「実装や設計の練習をする教材」としての可能性を知ってもらう -> ことを目的とします。 - -[チームの仕事はまわっていたけど、メンバーはそれぞれモヤモヤを抱えていた話──40名の大規模開発チームで1on1ログを公開してみた](https://fortee.jp/phperkaigi-2022/proposal/5a260e4e-542d-4d82-849d-ef3d6cb7c854) - -> サイボウズの大企業向けグループウェアのGaroon（ガルーン）は、PHPで開発されている20年目の製品です。ガルーン開発チームは日本で40名、ベトナムで50名の計90名ほどのチームになっています。また、コロナ禍でフルリモートでの活動がこの2年ほど継続してきました。 -> -> フルリモートになっても仕事はまわっており、継続的にリリースはしていましたが、一方でお互いの考えていることや感じている問題意識が見えづらくなり、モヤモヤを抱えているメンバーが増えていました。 -> -> このセッションでは、そういう状況で私がチーム外からジョインし、聴き役に徹しながら見える化することで状況を改善していった取り組みを紹介します。同じように大きなチームやリモートワークで難しさを感じている人に、難しさの原因への気づきや取り組みへのヒントがあれば幸いです。 - - - -## トークン問題の作成 - -今回は、PHPer チャレンジ用に弊社のトークン問題を 3題作成した。こちらについては[別途記事にしている](/posts/2022-04-09/phperkaigi-2022-tokens)ので、そちらを参照されたい。 - - - -## PHPer チャレンジ - -[1位](https://fortee.jp/phperkaigi-2022/challenge)になった。 -また、賞品として [Echo Show 15](https://www.amazon.co.jp/dp/B08MQNJC9Z) をいただいた。 - - - -## カンファレンス全体への感想 - -[去年の参加レポ](/posts/2021-03-30/phperkaigi-2021) では、こんなことを書いた。 - -> 1つ個人的な反省点としては、(中略) Discord しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。 -> まあ初カンファレンスだし、とお茶を濁しておこう。 - -この反省を踏まえ、今年は積極的にほかの場 (公式の Discord サーバや、アンカンファレンス) にも参加した。 -これにより、参加体験の質がはるかに向上した。特に Discord に関しては、登壇者ご本人による補足や、質問への回答などがおこなわれる (ことが多い) ため、特別な理由のない限り、発言はしないまでも参加はしておいたほうが良いと思われる。 - -なお、アンカンファレンスについては、1日目の終わりに[トークン問題の解説放送](https://fortee.jp/phperkaigi-2022/unconference/view/d332797a-8921-4706-a7e2-ee72640c9b5e)もおこなった。 - -また、今年はオフラインとオンラインのハイブリッド開催であったが、去年の全オンラインと比べて、オンライン参加の体験が落ちていなかったのは、特筆すべきであろう。 -今年は 3回目のワクチン接種が間に合わなかったこともあり現地参加は見送ったのだが、来年は是非オフラインで参加したい。 - - - -# そして来年へ……? - -PHPerKaigi 2023 があるかどうか存じ上げないが、あるとすれば、次の 4つを目標としたい。 - -* プロポーザルを出す -* PHPer チャレンジのトークン問題を 5題作成する -* 現地に行く -* PHPer チャレンジで圧勝する - --------------------------------------------------------------------------------- - -最後になりましたが、PHPerKaigi のスタッフ、スポンサー、スピーカーのみなさん、素敵な時間をありがとうございました。 - -ではまた来年。 diff --git a/content/posts/2022-08-27/php-conference-okinawa-code-golf.adoc b/content/posts/2022-08-27/php-conference-okinawa-code-golf.adoc new file mode 100644 index 0000000..86e3080 --- /dev/null +++ b/content/posts/2022-08-27/php-conference-okinawa-code-golf.adoc @@ -0,0 +1,91 @@ += PHP カンファレンス沖縄で出題されたコードゴルフの問題を解いてみた +:tags: conference, php, phpcon +:description: PHP カンファレンス沖縄の懇親会 LT で出題されたコードゴルフの問題を解いてみた。 +:revision-1: 2022-08-27 公開 + +== はじめに + +本日 https://phpcon.okinawa.jp/[PHP カンファレンス沖縄 2022] +が開催された (らしい)。 + +カンファレンスには参加できなかったものの、懇親会の LT +で出題されたコードゴルフの問題が Twitter に流れてきたので、解いてみた。 + +ツイート: https://twitter.com/m3m0r7/status/1563397620231712772 + +スライド: +https://speakerdeck.com/memory1994/php-conference-okinawa-2022-extra?slide=3 + +== 解 + +細かいレギュレーションは不明だったので、勝手に定めた。 + +* コマンドライン引数の第1引数で受けとる +* 結果は標準出力に出す +* コンマの直後にはスペースを1つ置く +* 末尾コンマは禁止 +* 数字でないものは入ってこないものとする +* 負数は入ってこないものとする + +書いたものがこちら: + +[source,php] +---- +[=$x;$n-=$x)$r[]=$x;echo implode(', ',$r??[]);?>] +---- + +しめて 123 バイトとなった (末尾改行を含めずにカウント)。 + +こちらは改行とスペースを追加したバージョン: + +[source,php] +---- +[= $x; $n -= $x) + $r[] = $x; +echo implode(', ', $r ?? []); + +?>] +---- + +== 使用したテクニック + +=== 指数表記 + +割と多くの言語のゴルフで使えるテクニック。`e` +を用いた指数表記で、大きな数を短く表す。このコードでは +`10000`、`5000`、`2000`、`1000` を指数表記している。 + +=== foreach や for の中身を1つの文に + +`foreach`、`for`、`if` などの後ろには、通常 `{` +を続けて複数の文を連ねるが、中身の文を1つにしてしまえば、`{` と `}` +を省略できる。C言語などでも使える。 + +=== $r に初期値を入れない + +PHP では、`$r[] = ...` +のような配列の末尾に追加する式を実行したとき、`$r` が未定義だった場合は +`$r` +を勝手に定義して空の配列で初期化してくれる。これを利用すると、`$r = [];` +のような初期化が不要になる。 + +ただし、プログラムに 0 が渡されるとループを一度も回らないので、`$r` +が未定義になってしまい、`implode()` +に渡すところでエラーになる。それを防ぐために `$r ?? []` を使っている。 + +もし 0 が渡されたケースを無視するなら、これが不要になるので 4 +バイト縮む。 + +=== PHP タグの外に文字列を置く + +PHP では、`` +で囲われた部分の外側にある文字列は、そのまま出力される。今回のケースでは、先頭と末尾に必ず +`[` と `]` を出力するので、そのまま書いてやればよい。 + +== おわりに + +最後になりましたが、https://twitter.com/m3m0r7[めもりー] +さん、楽しい問題をありがとうございました。 diff --git a/content/posts/2022-08-27/php-conference-okinawa-code-golf.md b/content/posts/2022-08-27/php-conference-okinawa-code-golf.md deleted file mode 100644 index 6042b65..0000000 --- a/content/posts/2022-08-27/php-conference-okinawa-code-golf.md +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: "PHP カンファレンス沖縄で出題されたコードゴルフの問題を解いてみた" -date: 2022-08-27T18:55:28+09:00 -tags: ["conference", "php", "phpcon"] -summary: | - PHP カンファレンス沖縄の懇親会 LT で出題されたコードゴルフの問題を解いてみた。 -changelog: - 2022-08-27: 公開 ---- - -# はじめに - -本日 [PHP カンファレンス沖縄 2022](https://phpcon.okinawa.jp/) が開催された (らしい)。 - -カンファレンスには参加できなかったものの、懇親会の LT で出題されたコードゴルフの問題が Twitter に流れてきたので、解いてみた。 - -ツイート: https://twitter.com/m3m0r7/status/1563397620231712772 \ -スライド: https://speakerdeck.com/memory1994/php-conference-okinawa-2022-extra?slide=3 - - -# 解 - -細かいレギュレーションは不明だったので、勝手に定めた。 - -* コマンドライン引数の第1引数で受けとる -* 結果は標準出力に出す -* コンマの直後にはスペースを1つ置く -* 末尾コンマは禁止 -* 数字でないものは入ってこないものとする -* 負数は入ってこないものとする - -書いたものがこちら: - -```php -[=$x;$n-=$x)$r[]=$x;echo implode(', ',$r??[]);?>] -``` - -しめて 123 バイトとなった (末尾改行を含めずにカウント)。 - -こちらは改行とスペースを追加したバージョン: - -```php -[= $x; $n -= $x) - $r[] = $x; -echo implode(', ', $r ?? []); - -?>] -``` - -# 使用したテクニック - -## 指数表記 - -割と多くの言語のゴルフで使えるテクニック。`e` を用いた指数表記で、大きな数を短く表す。このコードでは `10000`、`5000`、`2000`、`1000` を指数表記している。 - -## foreach や for の中身を1つの文に - -`foreach`、`for`、`if` などの後ろには、通常 `{` を続けて複数の文を連ねるが、中身の文を1つにしてしまえば、`{` と `}` を省略できる。C言語などでも使える。 - -## $r に初期値を入れない - -PHP では、`$r[] = ...` のような配列の末尾に追加する式を実行したとき、`$r` が未定義だった場合は `$r` を勝手に定義して空の配列で初期化してくれる。これを利用すると、`$r = [];` のような初期化が不要になる。 - -ただし、プログラムに 0 が渡されるとループを一度も回らないので、`$r` が未定義になってしまい、`implode()` に渡すところでエラーになる。それを防ぐために `$r ?? []` を使っている。 - -もし 0 が渡されたケースを無視するなら、これが不要になるので 4 バイト縮む。 - -## PHP タグの外に文字列を置く - -PHP では、`` で囲われた部分の外側にある文字列は、そのまま出力される。今回のケースでは、先頭と末尾に必ず `[` と `]` を出力するので、そのまま書いてやればよい。 - - -# おわりに - -最後になりましたが、[めもりー](https://twitter.com/m3m0r7) さん、楽しい問題をありがとうございました。 diff --git a/content/posts/2022-08-31/support-for-communty-is-employee-benefits.adoc b/content/posts/2022-08-31/support-for-communty-is-employee-benefits.adoc new file mode 100644 index 0000000..ba24d8c --- /dev/null +++ b/content/posts/2022-08-31/support-for-communty-is-employee-benefits.adoc @@ -0,0 +1,46 @@ += 弊社の PHP Foundation への寄付に寄せて +:description: 先日、私の勤めるデジタルサーカス株式会社が、PHP Foundation へ寄付をおこないました。 \ + 本件を社内でしつこく推進した1人として、推進の理由等を書き残しておきます。 +:revision-1: 2022-08-31 公開 + +== はじめに + +*注: +これは私個人の意見であり、所属する組織を代表するものではありません。* + +先日、私の勤める https://www.dgcircus.com/[デジタルサーカス株式会社] が +https://opencollective.com/phpfoundation[PHP Foundation] へ $2,000 +の寄付をおこないました。 + +記事: https://www.dgcircus.com/news/581 + +本件を社内でしつこく推進した1人として、推進の理由等を書き残しておきます。 + +== なぜ？ + +組織としての寄付理由は前掲した記事に譲るとして、ここでは、私が社内でこの件を推進した理由について書くことにします。 + +当時の考えを端的にまとめた社内チャットの投稿があったので、それを引用します: + +____ +結局これを通したい (私の中での) +最大の理由が、「自分の勤める会社が、これをやる会社であってほしい」というのがあり、↑にしても、感情ベースの理由しか出せていないというのが説得力に欠けている理由なのだと思いますが、寄付の報告が流れてきたり、OSS +のフリーライドの話が流れてきたりするたびに、自尊心が毀損される、というか +(これは大袈裟すぎる表現で、実際にはそこまで明確に傷ついているわけではありませんが)。 + +追記: 「肩身が狭くなる」というのがより適切でした。 +____ + +※文中の「↑にしても」は、ここに載せていない別の投稿を指しています。 + +OSS を金銭的に支援したり、技術カンファレンスへ協賛したり (あるいは +https://twitter.com/tomzoh[CTO] がカンファレンスを年2で主催したり: +https://iosdc.jp[iOSDC] https://phperkaigi.jp[PHPerKaigi]) +といった行為は、コミュニティへの貢献であると同時に、社員に対する精神的福利厚生でもあると言えるでしょう +(知らんけど)。これらは、技術や技術者を大切にする組織である、ということの、対外的にも対内的にも強力なメッセージなのです。 + +以上が、私が社内で寄付の件を進めた (かなり私的な) 理由です。 + +== おわりに + +最終的に社としての寄付まで漕ぎ着けられたのは、もちろん私の力ではなく役員の方々の決定によるものです。この場を借りて感謝申し上げます。 diff --git a/content/posts/2022-08-31/support-for-communty-is-employee-benefits.md b/content/posts/2022-08-31/support-for-communty-is-employee-benefits.md deleted file mode 100644 index fe23141..0000000 --- a/content/posts/2022-08-31/support-for-communty-is-employee-benefits.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: "弊社の PHP Foundation への寄付に寄せて" -date: 2022-08-31T22:25:02+09:00 -draft: false -tags: [] -summary: | - 先日、私の勤めるデジタルサーカス株式会社が、PHP Foundation へ寄付をおこないました。 - 本件を社内でしつこく推進した1人として、推進の理由等を書き残しておきます。 -changelog: - 2022-08-31: 公開 ---- - - - -# はじめに - -**注: これは私個人の意見であり、所属する組織を代表するものではありません。** - -先日、私の勤める [デジタルサーカス株式会社](https://www.dgcircus.com/) が [PHP Foundation](https://opencollective.com/phpfoundation) へ $2,000 の寄付をおこないました。 - -記事: https://www.dgcircus.com/news/581 - -本件を社内でしつこく推進した1人として、推進の理由等を書き残しておきます。 - - - -# なぜ？ - -組織としての寄付理由は前掲した記事に譲るとして、ここでは、私が社内でこの件を推進した理由について書くことにします。 - -当時の考えを端的にまとめた社内チャットの投稿があったので、それを引用します: - -> 結局これを通したい (私の中での) 最大の理由が、「自分の勤める会社が、これをやる会社であってほしい」というのがあり、↑にしても、感情ベースの理由しか出せていないというのが説得力に欠けている理由なのだと思いますが、寄付の報告が流れてきたり、OSS のフリーライドの話が流れてきたりするたびに、自尊心が毀損される、というか (これは大袈裟すぎる表現で、実際にはそこまで明確に傷ついているわけではありませんが)。 -> -> 追記: 「肩身が狭くなる」というのがより適切でした。 - -※文中の「↑にしても」は、ここに載せていない別の投稿を指しています。 - -OSS を金銭的に支援したり、技術カンファレンスへ協賛したり (あるいは [CTO](https://twitter.com/tomzoh) がカンファレンスを年2で主催したり: [iOSDC](https://iosdc.jp) [PHPerKaigi](https://phperkaigi.jp)) といった行為は、コミュニティへの貢献であると同時に、社員に対する精神的福利厚生でもあると言えるでしょう (知らんけど)。これらは、技術や技術者を大切にする組織である、ということの、対外的にも対内的にも強力なメッセージなのです。 - -以上が、私が社内で寄付の件を進めた (かなり私的な) 理由です。 - - - -# おわりに - -最終的に社としての寄付まで漕ぎ着けられたのは、もちろん私の力ではなく役員の方々の決定によるものです。この場を借りて感謝申し上げます。 diff --git a/content/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line.adoc b/content/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line.adoc new file mode 100644 index 0000000..247f9c1 --- /dev/null +++ b/content/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line.adoc @@ -0,0 +1,624 @@ += [PHP] fizzbuzz を書く。1行あたり2文字で。 +:tags: php +:description: PHP で、fizzbuzz を書いた。ただし、1行あたりに使える文字数は2文字まで。 +:revision-1: 2022-09-28 公開 +:revision-2: 2022-09-29 小さな文言の修正・変更 + +== 記事の構成について + +この記事は、普通の fizzbuzz +を徐々に変形して最終形にしていく、という構成で書かれている。最終形を見てどのような仕組みで動いているのか解読してから解説を読みたい、というかたがいれば、 +https://gist.github.com/nsfisis/04c227d5a419867472a0b23a83ad2919#file-fizzbuzz-php-2-letters-per-line-and-supports-php-8-x-without-warnings[このページ] +にソースコードがあるので、そちらを先に見てほしい。 + +== レギュレーション + +PHP で、次のような制約の下に fizzbuzz を書いた。 + +* 1行あたりの文字数は2文字までに収めること (ただし `\ +/* +*/ +i\ +n\ +t\ +/* +*/ +m\ +a\ +i\ +n( +){ +f\ +o\ +r( +i\ +n\ +t\ +/* +*/ +i= +1; +i< +1\ +0\ +0; +i\ ++\ ++) +if +(i +%\ +15 +== +0) +p\ +r\ +i\ +n\ +t\ +f( +"\ +F\ +i\ +z\ +z\ +B\ +u\ +z\ +z\ +%\ +c\ +", +10 +); + +/* あとは同じように普通のプログラムを変形するだけなので省略 */ +---- + +バックスラッシュを使った行継続がトークンを区切らない、というのがポイントだ。 + +さて、PHP +ではそもそもバックスラッシュを行継続に使うことができない。これにより、「3文字以上からなるトークンが一切使えない」という制約が課される。例えば、`echo` +で出力することや、`for` でループすること、`new` +でインスタンスを生成することができない。特に、出力は fizzbuzz +をどんなアルゴリズムで実装しようとおこなわなければならないので、できないのは致命的である。 + +当然、名前が3文字以上ある関数も使えない。なお、標準 PHP +の範囲内において、名前が 2文字以下の関数は以下のとおりである: + +* `_`: `gettext` のエイリアス +* `dl`: 拡張モジュールをロードする +* `pi`: 円周率を返す + +(環境によって多少は変わるかも) + +2文字の関数を定義しまくった拡張モジュールを用意しておいて `dl()` +で読み込む行為は、レギュレーションで定めた + +____ +* 標準的なインストール構成の PHP で実現できること +(デフォルトで有効になっていない拡張等を使わないこと) +____ + +に反する +(というより、「それだとおもしろくもなんともないので、このルールを足した」というのが正しい)。 + +また、2文字だと文字列がまともに書けないのも辛い。`''` だけで +2文字使うので、「1文字の文字列リテラル」というものを書くことができない。PHP +では文字列リテラル中に生の改行が書けるので + +[source,php] +---- +$a +=' +a' +;; +---- + +とすると `$a` は `"\na"` になるのだが、余計な改行が入ってしまう。 + +これらの障害をどのように乗り越えるのか、次節から見ていく。 + +== 解説 + +=== 普通の (?) fizzbuzz + +まずは普通に書くとしよう。 + +.... + + printf((($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n"), +); +---- + +`array_walk` や `range`、`printf` といった `for` +よりも長いトークンが現れてしまったが、これは次節で直すことにする。なお、`echo` +は文 (statement) であり式 (expression) ではないので、式である `printf` +に置き換えた。 + +=== 関数呼び出しの短縮 + +`range`、`array_walk`、`printf` +は長すぎるのでどうにかせねばならない。ここで、PHP +の可変関数を使う。可変関数とは、関数名が文字列として入った変数を経由して、関数を呼び出す機能である。 + +[source,php] +---- + + $p((($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n"), +); +---- + +これで関数を呼び出している所は短くなった。では、`$r` や `$w` や +`$p`、また `'Fizz'` や `'Buzz'` はどうやって +1行2文字に収めるのか。次のテクニックへ移ろう。 + +=== 余談: PHP 8.x で動作しなくてもいいなら + +今回使ったテクニックを説明する前に、余談として、文字列リテラルの短縮法として今回採用しなかったものを紹介する。 + +____ +* PHP 7.4〜8.1 で動作すること +____ + +というルールがない場合、「未定義の定数が評価された場合、その定数の名前が値になる」という +PHP 7.x までの仕様が利用できる。例えば、 `Fizz` +という文字列が欲しければ、次のようにする。 + +[source,php] +---- +$f +=F +.i +.z +.z +;; +---- + +こうして簡単に文字列を作れる。なお、この仕様は 7.x +時点でも警告を受けるので、`@` 演算子を使って抑制してやるとよい。 + +[source,php] +---- +$f +=@ +F. +@i +.# +@z +.# +@z +;; +---- + +むしろ、このことがわかっていたからこそ PHP 8.x +での動作を要件に課したところがある。 + +=== 文字列リテラルの短縮 + +実際に使った手法の説明に移る。 + +ずばり、文字列同士のビット演算を使う。PHP では、文字列同士でビット演算 +(`&`、`|`、`^`) +をした場合、文字列の各バイトごとに指定したビット演算がなされ、それを結合したものが演算結果となる。 + +[source,php] +---- +$a = "12345"; +$b = "world"; + +// $a ^ $b は次のコードと同じ +$result = ''; +for ($i = 0; $i < min(strlen($a), strlen($b)); $i++) { + $result .= $a[$i] ^ $b[$i]; +} + +echo $result; +// => F]AXQ +---- + +これを踏まえ、次のコードを見てみよう。 + +[source,php] +---- +$x = "x\nOm\n"; +$y = "\nk!\no"; +$r = $x ^ $y; +echo "$r\n"; +---- + +実行すると、`range` が表示される。さて、PHP +では文字列リテラル中に生の改行を直接書いてもよいのだった +(「主な障害」の節を参照のこと)。書きかえてみよう。 + +[source,php] +---- +$x +='x +Om +'; +$y +=' +k! +o' +; + +$r = $x ^ $y; +echo "$r\n"; +---- + +さらに `#` を使って適当に調整すると、次のようになる。 + +[source,php] +---- +$x +=# +'x +Om +'; +$y +=' +k! +o' +;# +$r +=# +$x +^# +$y +;# + +echo "$r\n"; +---- + +1行あたり2文字で、`range` +という文字列を生成することに成功した。他の必要な文字列にも、同様の処理をほどこす。 + +備考: `Buzz` 中にある小文字の `u` は、このロジックだと non-printable +な文字になってしまう。ここまでのテクニックを駆使すれば回避するのはそう難しくないので、考えてみてほしい。 + +== 完成系 + +完成したものがこちら。 + +[source,php] +---- + +$p +(( +(# +$i +%3 +?# +'' +:# +$f +). +(# +$i +%5 +?# +'' +:# +$b +)? +:# +$i +)# +.' +') +); +---- + +== 感想など + +PHP は、スクリプト言語の中だとシンタックスシュガーが少ない +(体感)。この挑戦は不可能に思われたが、PHP +マニュアルとにらめっこしていたらなんとかなった。 + +みんなもプログラムを細長くしよう。 + +== 余談2: 別解 + +PHP では、バッククォートを使ってシェルを呼び出せる。これは `shell_exec` +関数と等価である。さて、PHP +ではバックスラッシュによる行継続が使えないと書いたが、シェルでは使える +(当然だが、呼び出されるシェルに依存する。Bash +なら大丈夫だろう。知らんけど)。 + +[source,php] +---- +\ -/* -*/ -i\ -n\ -t\ -/* -*/ -m\ -a\ -i\ -n( -){ -f\ -o\ -r( -i\ -n\ -t\ -/* -*/ -i= -1; -i< -1\ -0\ -0; -i\ -+\ -+) -if -(i -%\ -15 -== -0) -p\ -r\ -i\ -n\ -t\ -f( -"\ -F\ -i\ -z\ -z\ -B\ -u\ -z\ -z\ -%\ -c\ -", -10 -); - -/* あとは同じように普通のプログラムを変形するだけなので省略 */ -``` - -バックスラッシュを使った行継続がトークンを区切らない、というのがポイントだ。 - -さて、PHP ではそもそもバックスラッシュを行継続に使うことができない。これにより、「3文字以上からなるトークンが一切使えない」という制約が課される。例えば、`echo` で出力することや、`for` でループすること、`new` でインスタンスを生成することができない。特に、出力は fizzbuzz をどんなアルゴリズムで実装しようとおこなわなければならないので、できないのは致命的である。 - -当然、名前が3文字以上ある関数も使えない。なお、標準 PHP の範囲内において、名前が 2文字以下の関数は以下のとおりである: - -* `_`: `gettext` のエイリアス -* `dl`: 拡張モジュールをロードする -* `pi`: 円周率を返す - -(環境によって多少は変わるかも) - -2文字の関数を定義しまくった拡張モジュールを用意しておいて `dl()` で読み込む行為は、レギュレーションで定めた - -> * 標準的なインストール構成の PHP で実現できること (デフォルトで有効になっていない拡張等を使わないこと) - -に反する (というより、「それだとおもしろくもなんともないので、このルールを足した」というのが正しい)。 - -また、2文字だと文字列がまともに書けないのも辛い。`''` だけで 2文字使うので、「1文字の文字列リテラル」というものを書くことができない。PHP では文字列リテラル中に生の改行が書けるので - -```php -$a -=' -a' -;; -``` - -とすると `$a` は `"\na"` になるのだが、余計な改行が入ってしまう。 - -これらの障害をどのように乗り越えるのか、次節から見ていく。 - - - -# 解説 - -## 普通の (?) fizzbuzz - -まずは普通に書くとしよう。 - -``` - - printf((($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n"), -); -``` - -`array_walk` や `range`、`printf` といった `for` よりも長いトークンが現れてしまったが、これは次節で直すことにする。なお、`echo` は文 (statement) であり式 (expression) ではないので、式である `printf` に置き換えた。 - - -## 関数呼び出しの短縮 - -`range`、`array_walk`、`printf` は長すぎるのでどうにかせねばならない。ここで、PHP の可変関数を使う。可変関数とは、関数名が文字列として入った変数を経由して、関数を呼び出す機能である。 - -```php - - $p((($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n"), -); -``` - -これで関数を呼び出している所は短くなった。では、`$r` や `$w` や `$p`、また `'Fizz'` や `'Buzz'` はどうやって 1行2文字に収めるのか。次のテクニックへ移ろう。 - - -## 余談: PHP 8.x で動作しなくてもいいなら - -今回使ったテクニックを説明する前に、余談として、文字列リテラルの短縮法として今回採用しなかったものを紹介する。 - -> * PHP 7.4〜8.1 で動作すること - -というルールがない場合、「未定義の定数が評価された場合、その定数の名前が値になる」という PHP 7.x までの仕様が利用できる。例えば、 `Fizz` という文字列が欲しければ、次のようにする。 - -```php -$f -=F -.i -.z -.z -;; -``` - -こうして簡単に文字列を作れる。なお、この仕様は 7.x 時点でも警告を受けるので、`@` 演算子を使って抑制してやるとよい。 - -```php -$f -=@ -F. -@i -.# -@z -.# -@z -;; -``` - -むしろ、このことがわかっていたからこそ PHP 8.x での動作を要件に課したところがある。 - - -## 文字列リテラルの短縮 - -実際に使った手法の説明に移る。 - -ずばり、文字列同士のビット演算を使う。PHP では、文字列同士でビット演算 (`&`、`|`、`^`) をした場合、文字列の各バイトごとに指定したビット演算がなされ、それを結合したものが演算結果となる。 - -```php -$a = "12345"; -$b = "world"; - -// $a ^ $b は次のコードと同じ -$result = ''; -for ($i = 0; $i < min(strlen($a), strlen($b)); $i++) { - $result .= $a[$i] ^ $b[$i]; -} - -echo $result; -// => F]AXQ -``` - -これを踏まえ、次のコードを見てみよう。 - -```php -$x = "x\nOm\n"; -$y = "\nk!\no"; -$r = $x ^ $y; -echo "$r\n"; -``` - -実行すると、`range` が表示される。さて、PHP では文字列リテラル中に生の改行を直接書いてもよいのだった (「主な障害」の節を参照のこと)。書きかえてみよう。 - -```php -$x -='x -Om -'; -$y -=' -k! -o' -; - -$r = $x ^ $y; -echo "$r\n"; -``` - -さらに `#` を使って適当に調整すると、次のようになる。 - -```php -$x -=# -'x -Om -'; -$y -=' -k! -o' -;# -$r -=# -$x -^# -$y -;# - -echo "$r\n"; -``` - -1行あたり2文字で、`range` という文字列を生成することに成功した。他の必要な文字列にも、同様の処理をほどこす。 - - -備考: `Buzz` 中にある小文字の `u` は、このロジックだと non-printable な文字になってしまう。ここまでのテクニックを駆使すれば回避するのはそう難しくないので、考えてみてほしい。 - - - -# 完成系 - -完成したものがこちら。 - -```php - -$p -(( -(# -$i -%3 -?# -'' -:# -$f -). -(# -$i -%5 -?# -'' -:# -$b -)? -:# -$i -)# -.' -') -); -``` - - - -# 感想など - -PHP は、スクリプト言語の中だとシンタックスシュガーが少ない (体感)。この挑戦は不可能に思われたが、PHP マニュアルとにらめっこしていたらなんとかなった。 - -みんなもプログラムを細長くしよう。 - - -# 余談2: 別解 - -PHP では、バッククォートを使ってシェルを呼び出せる。これは `shell_exec` 関数と等価である。さて、PHP ではバックスラッシュによる行継続が使えないと書いたが、シェルでは使える (当然だが、呼び出されるシェルに依存する。Bash なら大丈夫だろう。知らんけど)。 - -```php - * スペースやタブを使用しないこと - -に違反してしまう。スペースが使えないと引数とコマンドを区切れない。これは困った。 - -もうこれ以上は不可能だと思っていたのだが、この記事の執筆中に解決する方法を思いついたので載せておく。 - -```php - ABC +---- + +[source,php] +---- +preg_match('/(\x23.+?) /', $s, $m); +$t = $m[1] ?? ''; +---- + +正規表現でマッチングしている。`\x23` は `\#` +と同じであることに留意すると、この正規表現は「`#` から始まる 2 +以上の長さ (含 `#`) +の文字列で、最初に現れるスペースまで」にマッチする。つまりこれは、PHPerKaigi +におけるトークンである。 + +なお、`\#` を直接書いていないのは、`/#.+?) /` と書くと、`#.+?)` +という意図せぬトークンが登録されてしまうからである。 + +[source,php] +---- +if (md5($t) === '056e831a4146bf123e8ea16613303d2e') { + echo "Token: {$t}\n"; +} else { + echo "Failed.\n"; +} +---- + +最後にトークンのハッシュ値を見て、想定解かどうかを確認する。 + +== おわりに + +円周率を何桁も計算して ASCII +コード経由で文字列化すれば、トークンっぽいものがどこかで出てくるのではないか、と考えて生まれた作品。 + +最初は真面目に円周率の計算プログラムを組んでいたのだが、いざ動かしてみるとやけに浅いところにあったので驚いた +(ちなみに、それでも `M_PI` や `pi()` +では精度が足りない)。見つけたときは狂喜したものの、冷静になってみると大して面白くなかったのでボツになった。むしろ、100 +万桁目くらいに埋まっていてくれたほうがよかったかもしれない。 diff --git a/content/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1.md b/content/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1.md deleted file mode 100644 index 37f0a9a..0000000 --- a/content/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1.md +++ /dev/null @@ -1,143 +0,0 @@ ---- -title: "PHPerKaigi 2023: ボツになったトークン問題 その 1" -date: 2022-10-23T09:54:07+09:00 -draft: false -tags: ["php", "phperkaigi"] -summary: | - 来年の PHPerKaigi 2023 でデジタルサーカス株式会社から出題予定のトークン問題のうち、 - ボツになった問題を公開する (その 1)。 -changelog: - 2022-10-23: 公開 ---- - - - -# はじめに - -2023 年 3 月 23 日から 25 日にかけて開催予定 (記事執筆時点) の、[PHPerKaigi 2023](https://phperkaigi.jp/2023/) において、昨年と同様に、弊社[デジタルサーカス株式会社](https://www.dgcircus.com/) から、トークン問題を出題予定である。 - -昨年のトークン問題の記事はこちら: [PHPerKaigi 2022 トークン問題の解説](/posts/2022-04-09/phperkaigi-2022-tokens) - -すでに 2023 年用の問題は作成済みであるが、その制作過程の中でいくつかボツ問ができた。せっかくなので、PHPerKaigi 開催を待つ間に紹介しようと思う。 - -10 月から 2 月まで、毎月 1 記事ずつ公開していく予定 (忘れていなければ)。 - - - -# 問題 - -注意: これはボツ問なので、得られたトークンを PHPerKaigi で入力してもポイントにはならない。 - -```php - ABC -``` - -```php -preg_match('/(\x23.+?) /', $s, $m); -$t = $m[1] ?? ''; -``` - -正規表現でマッチングしている。`\x23` は `#` と同じであることに留意すると、この正規表現は「`#` から始まる 2 以上の長さ (含 `#`) の文字列で、最初に現れるスペースまで」にマッチする。つまりこれは、PHPerKaigi におけるトークンである。 - -なお、`#` を直接書いていないのは、`/#.+?) /` と書くと、`#.+?)` という意図せぬトークンが登録されてしまうからである。 - -```php -if (md5($t) === '056e831a4146bf123e8ea16613303d2e') { - echo "Token: {$t}\n"; -} else { - echo "Failed.\n"; -} -``` - -最後にトークンのハッシュ値を見て、想定解かどうかを確認する。 - - - -# おわりに - -円周率を何桁も計算して ASCII コード経由で文字列化すれば、トークンっぽいものがどこかで出てくるのではないか、と考えて生まれた作品。 - -最初は真面目に円周率の計算プログラムを組んでいたのだが、いざ動かしてみるとやけに浅いところにあったので驚いた (ちなみに、それでも `M_PI` や `pi()` では精度が足りない)。見つけたときは狂喜したものの、冷静になってみると大して面白くなかったのでボツになった。むしろ、100 万桁目くらいに埋まっていてくれたほうがよかったかもしれない。 diff --git a/content/posts/2022-10-28/setup-server-for-this-site.adoc b/content/posts/2022-10-28/setup-server-for-this-site.adoc new file mode 100644 index 0000000..8d2dad3 --- /dev/null +++ b/content/posts/2022-10-28/setup-server-for-this-site.adoc @@ -0,0 +1,248 @@ += [備忘録] このサイト用の VPS をセットアップしたときのメモ +:tags: note-to-self +:description: GitHub Pages でホストしていたこのサイトを VPS へ移行したので、 \ + そのときにやったことのメモ。99 % 自分用。 +:revision-1: 2022-10-28 公開 + +== はじめに + +これまでこの blog は GitHub Pages でホストしていたのだが、先日 VPS +に移行した。そのときにおこなったサーバのセットアップ作業を書き残しておく。99 +% 自分用の備忘録。別のベンダに移したりしたくなったら見に来る。 + +未来の自分へ: 特に自動化してないので、せいぜい苦しんでくれ。 + +== VPS + +https://vps.sakura.ad.jp/[さくらの VPS] の 2 GB +プラン。そこまで真面目に選定していないので、困ったら移動するかも。 + +== 事前準備 + +=== サーバのホスト名を決める + +モチベーションが上がるという効能がある。今回は藤原定家から取って +``teika'' +にした。たいていいつも源氏物語の帖か小倉百人一首の歌人から選んでいる。 + +=== SSH の鍵生成 + +ローカルマシンで鍵を生成する。 + +[source,shell-session] +---- +$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/teika.key +$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/github2teika.key +---- + +`teika.key` はローカルからサーバへの接続用、`github2teika.key` +は、GitHub Actions からサーバへのデプロイ用。 + +=== SSH の設定 + +`.ssh/config` に設定しておく。 + +[source,ssh_config] +---- +Host teika + HostName ********** + User ********** + Port ********** + IdentityFile ~/.ssh/teika.key +---- + +== 基本のセットアップ + +=== SSH 接続 + +VPS 契約時に設定した管理者ユーザとパスワードを使ってログインする。 + +=== ユーザを作成する + +管理者ユーザで作業すると危ないので、メインで使うユーザを作成する。`sudo` +グループに追加して `sudo` できるようにし、`su` で切り替え。 + +[source,shell-session] +---- +$ sudo adduser ********** +$ sudo adduser ********** sudo +$ su ********** +$ cd +---- + +=== ホスト名を変える + +[source,shell-session] +---- +$ sudo hostname teika +---- + +=== 公開鍵を置く + +[source,shell-session] +---- +$ mkdir ~/.ssh +$ chmod 700 ~/.ssh +$ vi ~/.ssh/authorized_keys +---- + +`authorized_keys` には、ローカルで生成した `~/.ssh/teika.key.pub` と +`~/.ssh/github2teika.key.pub` の内容をコピーする。 + +=== SSH の設定 + +SSH の設定を変更し、少しでも安全にしておく。 + +[source,shell-session] +---- +$ sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak +$ sudo vi /etc/ssh/sshd_config +---- + +* `Port` を変更 +* `PermitRootLogin` を `no` に +* `PasswordAuthentication` を `no` に + +そして設定を反映。 + +[source,shell-session] +---- +$ sudo systemctl restart sshd +$ sudo systemctl status sshd +---- + +=== SSH で接続確認 + +今の SSH +セッションは閉じずに、ターミナルを別途開いて疎通確認する。セッションを閉じてしまうと、SSH +の設定に不備があった場合に締め出しをくらう。 + +[source,shell-session] +---- +$ ssh teika +---- + +=== ポートの遮断 + +デフォルトの 22 番を閉じ、設定したポートだけ空ける。 + +[source,shell-session] +---- +$ sudo ufw deny ssh +$ sudo ufw allow ******* +$ sudo ufw enable +$ sudo ufw reload +$ sudo ufw status +---- + +ここでもう一度 SSH の接続確認を挟む。 + +=== GitHub 用の SSH 鍵 + +GitHub に置いてある private リポジトリをサーバから clone したいので、SSH +鍵を生成して置いておく。 + +[source,shell-session] +---- +$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/github.key +$ cat ~/.ssh/github.key.pub +---- + +https://github.com/settings/ssh[GitHub の設定画面] +から、この公開鍵を追加する。 + +[source,shell-session] +---- +$ vi ~/.ssh/config +---- + +設定はこう。 + +[source,ssh_config] +---- +Host github.com + HostName github.com + User git + IdentityFile ~/.ssh/github.key +---- + +最後に接続できるか確認しておく。 + +[source,shell-session] +---- +ssh -T github.com +---- + +=== パッケージの更新 + +[source,shell-session] +---- +$ sudo apt update +$ sudo apt upgrade +$ sudo apt update +$ sudo apt upgrade +$ sudo apt autoremove +---- + +== サイトホスティング用のセットアップ + +=== DNS に IP アドレスを登録する + +このサーバは固定の IP アドレスがあるので、`A` +レコードに直接入れるだけで済んだ。 + +=== 使うソフトウェアのインストール + +[source,shell-session] +---- +$ sudo apt install docker docker-compose git make +---- + +=== メインユーザが Docker を使えるように + +[source,shell-session] +---- +sudo adduser ********** docker +---- + +=== HTTP/HTTPS を通す + +80 番と 443 番を空ける。 + +[source,shell-session] +---- +$ sudo ufw allow 80/tcp +$ sudo ufw allow 443/tcp +$ sudo ufw reload +$ sudo ufw status +---- + +=== リポジトリのクローン + +[source,shell-session] +---- +$ cd +$ git clone git@github.com:nsfisis/nsfisis.dev.git +$ cd nsfisis.dev +$ git submodule update --init +---- + +=== certbot で証明書取得 + +[source,shell-session] +---- +$ docker-compose up -d acme-challenge +$ make setup +---- + +=== サーバを稼動させる + +[source,shell-session] +---- +$ make serve +---- + +== 感想 + +(業務でなく) +個人だと数年ぶりのサーバセットアップで、これだけでも割と時間を食ってしまった。とはいえ式年遷宮は楽しいので、これからも定期的にやっていきたい。コンテナデプロイにしたい気持ちもあるのだが、色々実験したい関係上、本物のサーバも欲しくはある。次の式年遷宮では、手順の一部だけでも自動化したいところ。 diff --git a/content/posts/2022-10-28/setup-server-for-this-site.md b/content/posts/2022-10-28/setup-server-for-this-site.md deleted file mode 100644 index c2d2f63..0000000 --- a/content/posts/2022-10-28/setup-server-for-this-site.md +++ /dev/null @@ -1,230 +0,0 @@ ---- -title: "[備忘録] このサイト用の VPS をセットアップしたときのメモ" -date: 2022-10-28T21:55:23+09:00 -draft: false -tags: ["note-to-self"] -summary: | - GitHub Pages でホストしていたこのサイトを VPS へ移行したので、 - そのときにやったことのメモ。99 % 自分用。 -changelog: - 2022-10-28: 公開 ---- - - - -# はじめに - -これまでこの blog は GitHub Pages でホストしていたのだが、先日 VPS に移行した。そのときにおこなったサーバのセットアップ作業を書き残しておく。99 % 自分用の備忘録。別のベンダに移したりしたくなったら見に来る。 - -未来の自分へ: 特に自動化してないので、せいぜい苦しんでくれ。 - - - -# VPS - -[さくらの VPS](https://vps.sakura.ad.jp/) の 2 GB プラン。そこまで真面目に選定していないので、困ったら移動するかも。 - - - -# 事前準備 - -## サーバのホスト名を決める - -モチベーションが上がるという効能がある。今回は藤原定家から取って "teika" にした。たいていいつも源氏物語の帖か小倉百人一首の歌人から選んでいる。 - -## SSH の鍵生成 - -ローカルマシンで鍵を生成する。 - -```shell-session -$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/teika.key -$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/github2teika.key -``` - -`teika.key` はローカルからサーバへの接続用、`github2teika.key` は、GitHub Actions からサーバへのデプロイ用。 - -## SSH の設定 - -`.ssh/config` に設定しておく。 - -```ssh_config -Host teika - HostName ********** - User ********** - Port ********** - IdentityFile ~/.ssh/teika.key -``` - - -# 基本のセットアップ - -## SSH 接続 - -VPS 契約時に設定した管理者ユーザとパスワードを使ってログインする。 - -## ユーザを作成する - -管理者ユーザで作業すると危ないので、メインで使うユーザを作成する。`sudo` グループに追加して `sudo` できるようにし、`su` で切り替え。 - -```shell-session -$ sudo adduser ********** -$ sudo adduser ********** sudo -$ su ********** -$ cd -``` - -## ホスト名を変える - -```shell-session -$ sudo hostname teika -``` - -## 公開鍵を置く - -```shell-session -$ mkdir ~/.ssh -$ chmod 700 ~/.ssh -$ vi ~/.ssh/authorized_keys -``` - -`authorized_keys` には、ローカルで生成した `~/.ssh/teika.key.pub` と `~/.ssh/github2teika.key.pub` の内容をコピーする。 - -## SSH の設定 - -SSH の設定を変更し、少しでも安全にしておく。 - -```shell-session -$ sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak -$ sudo vi /etc/ssh/sshd_config -``` - -* `Port` を変更 -* `PermitRootLogin` を `no` に -* `PasswordAuthentication` を `no` に - -そして設定を反映。 - -```shell-session -$ sudo systemctl restart sshd -$ sudo systemctl status sshd -``` - -## SSH で接続確認 - -今の SSH セッションは閉じずに、ターミナルを別途開いて疎通確認する。セッションを閉じてしまうと、SSH の設定に不備があった場合に締め出しをくらう。 - -```shell-session -$ ssh teika -``` - -## ポートの遮断 - -デフォルトの 22 番を閉じ、設定したポートだけ空ける。 - -```shell-session -$ sudo ufw deny ssh -$ sudo ufw allow ******* -$ sudo ufw enable -$ sudo ufw reload -$ sudo ufw status -``` - -ここでもう一度 SSH の接続確認を挟む。 - -## GitHub 用の SSH 鍵 - -GitHub に置いてある private リポジトリをサーバから clone したいので、SSH 鍵を生成して置いておく。 - -```shell-session -$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/github.key -$ cat ~/.ssh/github.key.pub -``` - -[GitHub の設定画面](https://github.com/settings/ssh) から、この公開鍵を追加する。 - -```shell-session -$ vi ~/.ssh/config -``` - -設定はこう。 - -```ssh_config -Host github.com - HostName github.com - User git - IdentityFile ~/.ssh/github.key -``` - -最後に接続できるか確認しておく。 - -```shell-session -ssh -T github.com -``` - -## パッケージの更新 - -```shell-session -$ sudo apt update -$ sudo apt upgrade -$ sudo apt update -$ sudo apt upgrade -$ sudo apt autoremove -``` - - -# サイトホスティング用のセットアップ - -## DNS に IP アドレスを登録する - -このサーバは固定の IP アドレスがあるので、`A` レコードに直接入れるだけで済んだ。 - -## 使うソフトウェアのインストール - -```shell-session -$ sudo apt install docker docker-compose git make -``` - -## メインユーザが Docker を使えるように - -```shell-session -sudo adduser ********** docker -``` - -## HTTP/HTTPS を通す - -80 番と 443 番を空ける。 - -```shell-session -$ sudo ufw allow 80/tcp -$ sudo ufw allow 443/tcp -$ sudo ufw reload -$ sudo ufw status -``` - -## リポジトリのクローン - -```shell-session -$ cd -$ git clone git@github.com:nsfisis/nsfisis.dev.git -$ cd nsfisis.dev -$ git submodule update --init -``` - -## certbot で証明書取得 - -```shell-session -$ docker-compose up -d acme-challenge -$ make setup -``` - -## サーバを稼動させる - -```shell-session -$ make serve -``` - - - -# 感想 - -(業務でなく) 個人だと数年ぶりのサーバセットアップで、これだけでも割と時間を食ってしまった。とはいえ式年遷宮は楽しいので、これからも定期的にやっていきたい。コンテナデプロイにしたい気持ちもあるのだが、色々実験したい関係上、本物のサーバも欲しくはある。次の式年遷宮では、手順の一部だけでも自動化したいところ。 diff --git a/docker-compose.local.yml b/docker-compose.local.yml index d082169..ea78e67 100644 --- a/docker-compose.local.yml +++ b/docker-compose.local.yml @@ -5,7 +5,7 @@ services: image: nginx volumes: - ./nginx.conf:/etc/nginx/conf.d/default.conf - - ./docs:/public + - ./public:/public ports: - 80:80 environment: diff --git a/docker-compose.yml b/docker-compose.yml index 7151b77..f6eef3d 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -5,7 +5,7 @@ services: image: nginx volumes: - ./nginx.conf:/etc/nginx/conf.d/default.conf - - ./docs:/public + - ./public:/public expose: - 80 environment: diff --git a/docs/404.html b/docs/404.html deleted file mode 100644 index 7936109..0000000 --- a/docs/404.html +++ /dev/null @@ -1,42 +0,0 @@ - - - - - - - - 404 Page not found | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- -
404
- - - - - - diff --git a/docs/an-old-hope.min.css b/docs/an-old-hope.min.css deleted file mode 100644 index 936fba3..0000000 --- a/docs/an-old-hope.min.css +++ /dev/null @@ -1 +0,0 @@ -.hljs-comment,.hljs-quote{color:#B6B18B}.hljs-variable,.hljs-template-variable,.hljs-tag,.hljs-name,.hljs-selector-id,.hljs-selector-class,.hljs-regexp,.hljs-deletion{color:#EB3C54}.hljs-number,.hljs-built_in,.hljs-builtin-name,.hljs-literal,.hljs-type,.hljs-params,.hljs-meta,.hljs-link{color:#E7CE56}.hljs-attribute{color:#EE7C2B}.hljs-string,.hljs-symbol,.hljs-bullet,.hljs-addition{color:#4FB4D7}.hljs-title,.hljs-section{color:#78BB65}.hljs-keyword,.hljs-selector-tag{color:#B45EA4}.hljs{display:block;overflow-x:auto;background:#1C1D21;color:#c0c5ce;padding:.5em}.hljs-emphasis{font-style:italic}.hljs-strong{font-weight:bold} \ No newline at end of file diff --git a/docs/custom.css b/docs/custom.css deleted file mode 100644 index f492b95..0000000 --- a/docs/custom.css +++ /dev/null @@ -1,26 +0,0 @@ -/* Place a custom css file in your own project to use this. */ -.post-content h1, -.post-content h2, -.post-content h3, -.post-content h4, -.post-content h5, -.post-content h6 { - border-bottom: var(--primary) solid 1px; -} - -.post-content h1::before, -.post-content h2::before, -.post-content h3::before, -.post-content h4::before, -.post-content h5::before, -.post-content h6::before { - color: var(--secondary); - padding-right: 0.3rem; -} - -.post-content h1::before { content: '#'; } -.post-content h2::before { content: '##'; } -.post-content h3::before { content: '###'; } -.post-content h4::before { content: '####'; } -.post-content h5::before { content: '#####'; } -.post-content h6::before { content: '######'; } diff --git a/docs/favicon.svg b/docs/favicon.svg deleted file mode 100644 index d122ea1..0000000 --- a/docs/favicon.svg +++ /dev/null @@ -1,62 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/docs/feed.xml b/docs/feed.xml deleted file mode 100644 index d39b645..0000000 --- a/docs/feed.xml +++ /dev/null @@ -1,2348 +0,0 @@ - - - - REPL: Rest-Eat-Program Loop - https://blog.nsfisis.dev/ - Recent content on REPL: Rest-Eat-Program Loop - Hugo -- gohugo.io - ja-JP - Wed, 31 Mar 2021 01:36:49 +0900 - - [備忘録] このサイト用の VPS をセットアップしたときのメモ - https://blog.nsfisis.dev/posts/2022-10-28/setup-server-for-this-site/ - Fri, 28 Oct 2022 21:55:23 +0900 - - https://blog.nsfisis.dev/posts/2022-10-28/setup-server-for-this-site/ - はじめに -

これまでこの blog は GitHub Pages でホストしていたのだが、先日 VPS に移行した。そのときにおこなったサーバのセットアップ作業を書き残しておく。99 % 自分用の備忘録。別のベンダに移したりしたくなったら見に来る。

-

未来の自分へ: 特に自動化してないので、せいぜい苦しんでくれ。

-

VPS

-

さくらの VPS の 2 GB プラン。そこまで真面目に選定していないので、困ったら移動するかも。

-

事前準備

-

サーバのホスト名を決める

-

モチベーションが上がるという効能がある。今回は藤原定家から取って “teika” にした。たいていいつも源氏物語の帖か小倉百人一首の歌人から選んでいる。

-

SSH の鍵生成

-

ローカルマシンで鍵を生成する。

-
$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/teika.key
-$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/github2teika.key
-

teika.key はローカルからサーバへの接続用、github2teika.key は、GitHub Actions からサーバへのデプロイ用。

-

SSH の設定

-

.ssh/config に設定しておく。

-
Host teika
-    HostName **********
-    User **********
-    Port **********
-    IdentityFile ~/.ssh/teika.key
-

基本のセットアップ

-

SSH 接続

-

VPS 契約時に設定した管理者ユーザとパスワードを使ってログインする。

-

ユーザを作成する

-

管理者ユーザで作業すると危ないので、メインで使うユーザを作成する。sudo グループに追加して sudo できるようにし、su で切り替え。

-
$ sudo adduser **********
-$ sudo adduser ********** sudo
-$ su **********
-$ cd
-

ホスト名を変える

-
$ sudo hostname teika
-

公開鍵を置く

-
$ mkdir ~/.ssh
-$ chmod 700 ~/.ssh
-$ vi ~/.ssh/authorized_keys
-

authorized_keys には、ローカルで生成した ~/.ssh/teika.key.pub と ~/.ssh/github2teika.key.pub の内容をコピーする。

-

SSH の設定

-

SSH の設定を変更し、少しでも安全にしておく。

-
$ sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak
-$ sudo vi /etc/ssh/sshd_config
-
    -
  • Port を変更
    • -
  • PermitRootLogin を no に
    • -
  • PasswordAuthentication を no に
    • -
-

そして設定を反映。

-
$ sudo systemctl restart sshd
-$ sudo systemctl status sshd
-

SSH で接続確認

-

今の SSH セッションは閉じずに、ターミナルを別途開いて疎通確認する。セッションを閉じてしまうと、SSH の設定に不備があった場合に締め出しをくらう。

-
$ ssh teika
-

ポートの遮断

-

デフォルトの 22 番を閉じ、設定したポートだけ空ける。

-
$ sudo ufw deny ssh
-$ sudo ufw allow *******
-$ sudo ufw enable
-$ sudo ufw reload
-$ sudo ufw status
-

ここでもう一度 SSH の接続確認を挟む。

-

GitHub 用の SSH 鍵

-

GitHub に置いてある private リポジトリをサーバから clone したいので、SSH 鍵を生成して置いておく。

-
$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/github.key
-$ cat ~/.ssh/github.key.pub
-

GitHub の設定画面 から、この公開鍵を追加する。

-
$ vi ~/.ssh/config
-

設定はこう。

-
Host github.com
-    HostName github.com
-    User git
-    IdentityFile ~/.ssh/github.key
-

最後に接続できるか確認しておく。

-
ssh -T github.com
-

パッケージの更新

-
$ sudo apt update
-$ sudo apt upgrade
-$ sudo apt update
-$ sudo apt upgrade
-$ sudo apt autoremove
-

サイトホスティング用のセットアップ

-

DNS に IP アドレスを登録する

-

このサーバは固定の IP アドレスがあるので、A レコードに直接入れるだけで済んだ。

-

使うソフトウェアのインストール

-
$ sudo apt install docker docker-compose git make
-

メインユーザが Docker を使えるように

-
sudo adduser ********** docker
-

HTTP/HTTPS を通す

-

80 番と 443 番を空ける。

-
$ sudo ufw allow 80/tcp
-$ sudo ufw allow 443/tcp
-$ sudo ufw reload
-$ sudo ufw status
-

リポジトリのクローン

-
$ cd
-$ git clone git@github.com:nsfisis/nsfisis.dev.git
-$ cd nsfisis.dev
-$ git submodule update --init
-

certbot で証明書取得

-
$ docker-compose up -d acme-challenge
-$ make setup
-

サーバを稼動させる

-
$ make serve
-

感想

-

(業務でなく) 個人だと数年ぶりのサーバセットアップで、これだけでも割と時間を食ってしまった。とはいえ式年遷宮は楽しいので、これからも定期的にやっていきたい。コンテナデプロイにしたい気持ちもあるのだが、色々実験したい関係上、本物のサーバも欲しくはある。次の式年遷宮では、手順の一部だけでも自動化したいところ。

-]]> - - - - PHPerKaigi 2023: ボツになったトークン問題 その 1 - https://blog.nsfisis.dev/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1/ - Sun, 23 Oct 2022 09:54:07 +0900 - - https://blog.nsfisis.dev/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1/ - はじめに -

2023 年 3 月 23 日から 25 日にかけて開催予定 (記事執筆時点) の、PHPerKaigi 2023 において、昨年と同様に、弊社デジタルサーカス株式会社 から、トークン問題を出題予定である。

-

昨年のトークン問題の記事はこちら: PHPerKaigi 2022 トークン問題の解説

-

すでに 2023 年用の問題は作成済みであるが、その制作過程の中でいくつかボツ問ができた。せっかくなので、PHPerKaigi 開催を待つ間に紹介しようと思う。

-

10 月から 2 月まで、毎月 1 記事ずつ公開していく予定 (忘れていなければ)。

-

問題

-

注意: これはボツ問なので、得られたトークンを PHPerKaigi で入力してもポイントにはならない。

-
<?php
-
-$π = $argv[1] ?? null;
-if ($π === null) {
-  exit('No input.');
-}
-$π = trim($π);
-if (!is_numeric($π)) {
-  exit('Invalid input.');
-}
-
-$s = implode(array_map(chr(...), str_split($π, 2)));
-
-preg_match('/(\x23.+?) /', $s, $m);
-$t = $m[1] ?? '';
-
-if (md5($t) === '056e831a4146bf123e8ea16613303d2e') {
-  echo "Token: {$t}\n";
-} else {
-  echo "Failed.\n";
-}
-

トークン入手方法

-

ソースを見るとわかるとおり、$argv[1] を参照している。それを $π なる変数に代入しているので、円周率を渡してみる。

-
$ php Q.php 3.14
-Failed.
-

失敗してしまった。精度を上げてみる。

-
$ php Q.php 3.1415
-Failed.
-

だめだった。これを成功するまで繰り返す。

-

最初にトークンが得られるのは、小数点以下 16 桁目まで入力したときで、こうなる。

-
$ php Q.php 3.1415926535897932
-Token: #YO
-

めでたくトークン「#YO」が手に入った。

-

解説

-

短いので頭から追っていく。

-
$π = $argv[1] ?? null;
-if ($π === null) {
-  exit('No input.');
-}
-$π = trim($π);
-if (!is_numeric($π)) {
-  exit('Invalid input.');
-}
-

入力のバリデーション部分。数値のみ受け付ける。

-
$s = implode(array_map(chr(...), str_split($π, 2)));
-

$π を 2 文字ごとに区切り (str_split)、数値を ASCII コードと見做して文字に変換 (chr) して結合 (implode) している。

-

例えば、$π が '656667' だったとすると、65、66、67 に対応した 'A'、'B'、'C' へと変換され、'ABC' になる。

-
$π = '656667';
-$s = implode(array_map(chr(...), str_split($π, 2)));
-echo $s;
-// => ABC
-
preg_match('/(\x23.+?) /', $s, $m);
-$t = $m[1] ?? '';
-

正規表現でマッチングしている。\x23 は # と同じであることに留意すると、この正規表現は「# から始まる 2 以上の長さ (含 #) の文字列で、最初に現れるスペースまで」にマッチする。つまりこれは、PHPerKaigi におけるトークンである。

-

なお、# を直接書いていないのは、/#.+?) / と書くと、#.+?) という意図せぬトークンが登録されてしまうからである。

-
if (md5($t) === '056e831a4146bf123e8ea16613303d2e') {
-  echo "Token: {$t}\n";
-} else {
-  echo "Failed.\n";
-}
-

最後にトークンのハッシュ値を見て、想定解かどうかを確認する。

-

おわりに

-

円周率を何桁も計算して ASCII コード経由で文字列化すれば、トークンっぽいものがどこかで出てくるのではないか、と考えて生まれた作品。

-

最初は真面目に円周率の計算プログラムを組んでいたのだが、いざ動かしてみるとやけに浅いところにあったので驚いた (ちなみに、それでも M_PI や pi() では精度が足りない)。見つけたときは狂喜したものの、冷静になってみると大して面白くなかったのでボツになった。むしろ、100 万桁目くらいに埋まっていてくれたほうがよかったかもしれない。

-]]> - - - - [PHP] fizzbuzz を書く。1行あたり2文字で。 - https://blog.nsfisis.dev/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line/ - Thu, 29 Sep 2022 00:50:52 +0900 - - https://blog.nsfisis.dev/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line/ - 記事の構成について -

この記事は、普通の fizzbuzz を徐々に変形して最終形にしていく、という構成で書かれている。最終形を見てどのような仕組みで動いているのか解読してから解説を読みたい、というかたがいれば、 このページ にソースコードがあるので、そちらを先に見てほしい。

-

レギュレーション

-

PHP で、次のような制約の下に fizzbuzz を書いた。

-
    -
  • 1行あたりの文字数は2文字までに収めること (ただし <?php タグは除く) -
      -
    • 厳密な定義: <?php タグ以降のソースコードが、2 byte ごとに ラインフィード (LF) で区切られること
      • -
    -
    • -
  • スペースやタブを使用しないこと
    • -
  • ループのアンロールをしないこと -
      -
    • 100 回ループの代わりに 100 回コードをコピペ、というのは禁止
      • -
    -
    • -
  • PHP 7.4〜8.1 で動作すること
    • -
  • 実行時に Notice や Warning が出ないこと
    • -
  • 標準的なインストール構成の PHP で実現できること (デフォルトで有効になっていない拡張等を使わないこと)
    • -
-

備考: PHP には short_open_tag というオプションがあり、これを有効にするとファイル冒頭の <?php の代わりに <? を使うことができ、文字どおり1行2文字で書ける。ただ、このオプションはデフォルト off になっている環境が多いようなので、今回は使わないことにした。

-

主な障害

-

1行あたりの文字数など、適当に改行を挟めばいいだけではないのか？

-

特に、C言語でこのような試みをおこなったことがあるかたならそう思うだろう。事実、Cでのこの制約はほとんど無意味に等しい。

-
#\
-i\
-n\
-c\
-l\
-u\
-d\
-e\
-<\
-s\
-t\
-d\
-i\
-o\
-.\
-h\
->\
-/*
-*/
-i\
-n\
-t\
-/*
-*/
-m\
-a\
-i\
-n(
-){
-f\
-o\
-r(
-i\
-n\
-t\
-/*
-*/
-i=
-1;
-i<
-1\
-0\
-0;
-i\
-+\
-+)
-if
-(i
-%\
-15
-==
-0)
-p\
-r\
-i\
-n\
-t\
-f(
-"\
-F\
-i\
-z\
-z\
-B\
-u\
-z\
-z\
-%\
-c\
-",
-10
-);
-
-/* あとは同じように普通のプログラムを変形するだけなので省略 */
-

バックスラッシュを使った行継続がトークンを区切らない、というのがポイントだ。

-

さて、PHP ではそもそもバックスラッシュを行継続に使うことができない。これにより、「3文字以上からなるトークンが一切使えない」という制約が課される。例えば、echo で出力することや、for でループすること、new でインスタンスを生成することができない。特に、出力は fizzbuzz をどんなアルゴリズムで実装しようとおこなわなければならないので、できないのは致命的である。

-

当然、名前が3文字以上ある関数も使えない。なお、標準 PHP の範囲内において、名前が 2文字以下の関数は以下のとおりである:

-
    -
  • _: gettext のエイリアス
    • -
  • dl: 拡張モジュールをロードする
    • -
  • pi: 円周率を返す
    • -
-

(環境によって多少は変わるかも)

-

2文字の関数を定義しまくった拡張モジュールを用意しておいて dl() で読み込む行為は、レギュレーションで定めた

-
-
    -
  • 標準的なインストール構成の PHP で実現できること (デフォルトで有効になっていない拡張等を使わないこと)
    • -
-
-

に反する (というより、「それだとおもしろくもなんともないので、このルールを足した」というのが正しい)。

-

また、2文字だと文字列がまともに書けないのも辛い。'' だけで 2文字使うので、「1文字の文字列リテラル」というものを書くことができない。PHP では文字列リテラル中に生の改行が書けるので

-
$a
-='
-a'
-;;
-

とすると $a は "\na" になるのだが、余計な改行が入ってしまう。

-

これらの障害をどのように乗り越えるのか、次節から見ていく。

-

解説

-

普通の (?) fizzbuzz

-

まずは普通に書くとしよう。

-
<?php
-
-for ($i = 1; $i < 100; $i++) {
-  echo (($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n";
-}
-

素直に書いた fizzbuzz とは言い難いが、このくらいは普通だということにしておかないと、この先がやっていられないので許してほしい。

-

for の排除

-

for は、3文字もある長いキーワードである。こんなものは使えない。array_ 系の関数を使って、適当に置き換えるとしよう。

-
<?php
-
-$s = range(1, 100);
-array_walk(
-  $s,
-  fn($i) =>
-    printf((($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n"),
-);
-

array_walk や range、printf といった for よりも長いトークンが現れてしまったが、これは次節で直すことにする。なお、echo は文 (statement) であり式 (expression) ではないので、式である printf に置き換えた。

-

関数呼び出しの短縮

-

range、array_walk、printf は長すぎるのでどうにかせねばならない。ここで、PHP の可変関数を使う。可変関数とは、関数名が文字列として入った変数を経由して、関数を呼び出す機能である。

-
<?php
-
-$r = 'range';
-$w = 'array_walk';
-$p = 'printf';
-
-$s = $r(1, 100);
-$w(
-  $s,
-  fn($i) =>
-    $p((($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n"),
-);
-

これで関数を呼び出している所は短くなった。では、$r や $w や $p、また 'Fizz' や 'Buzz' はどうやって 1行2文字に収めるのか。次のテクニックへ移ろう。

-

余談: PHP 8.x で動作しなくてもいいなら

-

今回使ったテクニックを説明する前に、余談として、文字列リテラルの短縮法として今回採用しなかったものを紹介する。

-
-
    -
  • PHP 7.4〜8.1 で動作すること
    • -
-
-

というルールがない場合、「未定義の定数が評価された場合、その定数の名前が値になる」という PHP 7.x までの仕様が利用できる。例えば、 Fizz という文字列が欲しければ、次のようにする。

-
$f
-=F
-.i
-.z
-.z
-;;
-

こうして簡単に文字列を作れる。なお、この仕様は 7.x 時点でも警告を受けるので、@ 演算子を使って抑制してやるとよい。

-
$f
-=@
-F.
-@i
-.#
-@z
-.#
-@z
-;;
-

むしろ、このことがわかっていたからこそ PHP 8.x での動作を要件に課したところがある。

-

文字列リテラルの短縮

-

実際に使った手法の説明に移る。

-

ずばり、文字列同士のビット演算を使う。PHP では、文字列同士でビット演算 (&、|、^) をした場合、文字列の各バイトごとに指定したビット演算がなされ、それを結合したものが演算結果となる。

-
$a = "12345";
-$b = "world";
-
-// $a ^ $b は次のコードと同じ
-$result = '';
-for ($i = 0; $i < min(strlen($a), strlen($b)); $i++) {
-  $result .= $a[$i] ^ $b[$i];
-}
-
-echo $result;
-// => F]AXQ
-

これを踏まえ、次のコードを見てみよう。

-
$x = "x\nOm\n";
-$y = "\nk!\no";
-$r = $x ^ $y;
-echo "$r\n";
-

実行すると、range が表示される。さて、PHP では文字列リテラル中に生の改行を直接書いてもよいのだった (「主な障害」の節を参照のこと)。書きかえてみよう。

-
$x
-='x
-Om
-';
-$y
-='
-k!
-o'
-;
-
-$r = $x ^ $y;
-echo "$r\n";
-

さらに # を使って適当に調整すると、次のようになる。

-
$x
-=#
-'x
-Om
-';
-$y
-='
-k!
-o'
-;#
-$r
-=#
-$x
-^#
-$y
-;#
-
-echo "$r\n";
-

1行あたり2文字で、range という文字列を生成することに成功した。他の必要な文字列にも、同様の処理をほどこす。

-

備考: Buzz 中にある小文字の u は、このロジックだと non-printable な文字になってしまう。ここまでのテクニックを駆使すれば回避するのはそう難しくないので、考えてみてほしい。

-

完成系

-

完成したものがこちら。

-
<?php
-
-$x
-=#
-'i
-S'
-;;
-$y
-='
-b!
-';
-$c
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'x
-Om
-';
-$y
-='
-k!
-o'
-;#
-$r
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'k
-Sk
-~}
-Ma
-';
-$y
-='
-x!
-s!
-k!
-';
-$w
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'z
-Hd
-G'
-;#
-$y
-='
-x!
-~!
-';
-$p
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'L
-[p
-';
-$y
-='
-c!
-';
-$f
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'H
-[p
-';
-$y
-='
-_!
-';
-$b
-=#
-$x
-^#
-$y
-;#
-$b
-[1
-]=
-$c
-(#
-13
-*9
-);
-$s
-=#
-$r
-(1
-,(
-10
-**
-2)
-);
-$w
-(#
-$s
-,#
-fn
-(#
-$i
-)#
-=>
-$p
-((
-(#
-$i
-%3
-?#
-''
-:#
-$f
-).
-(#
-$i
-%5
-?#
-''
-:#
-$b
-)?
-:#
-$i
-)#
-.'
-')
-);
-

感想など

-

PHP は、スクリプト言語の中だとシンタックスシュガーが少ない (体感)。この挑戦は不可能に思われたが、PHP マニュアルとにらめっこしていたらなんとかなった。

-

みんなもプログラムを細長くしよう。

-

余談2: 別解

-

PHP では、バッククォートを使ってシェルを呼び出せる。これは shell_exec 関数と等価である。さて、PHP ではバックスラッシュによる行継続が使えないと書いたが、シェルでは使える (当然だが、呼び出されるシェルに依存する。Bash なら大丈夫だろう。知らんけど)。

-
<?php
-
-printf(`
-e\
-c\
-h\
-o\
- \
-1\
-2\
-3\
-`);
-

なお、ここでは簡単のため出力に printf をそのまま使っているが、実際には printf という文字列を合成して可変関数で呼び出す。

-

ただし、これでは

-
-
    -
  • スペースやタブを使用しないこと
    • -
-
-

に違反してしまう。スペースが使えないと引数とコマンドを区切れない。これは困った。

-

もうこれ以上は不可能だと思っていたのだが、この記事の執筆中に解決する方法を思いついたので載せておく。

-
<?php
-
-$c = 'chr';
-
-${
-'_
-'}
-=#
-$c
-(#
-32
-).
-$c
-(#
-92
-);
-
-printf(`
-e\
-c\
-h\
-o\
-${
-'_
-'}
-1\
-2\
-3\
-`);
-

先程と同じく、chr や printf を生成する部分は長くなるので省いた。

-
${
-'_
-'}
-

は変数で、中にはスペースとエスケープが入っている (chr(32) . chr(92))。シェルに渡されている文字列は次のようになる。

-
e\
-c\
-h\
-o\
- \
-1\
-2\
-3\
-

これは、前掲したコマンドと同じだ。かくして、スペースを陽に書かずにシェルをおおよそ自由に扱えるようになった。Fizzbuzz のワンライナーくらいすぐ書けるだろうから、あとはなんとかなるだろう (試してないけど)。

-

ということでこれは別解ということにしておく。

-

ちなみに、PHP 8.2 からは、この記法で Warning が出るようになるようだ。

-
${
-'_
-'}
-

最新版で警告が出るというのも美しくないので、私としては本編の解法を推す。

-]]> - - - - 弊社の PHP Foundation への寄付に寄せて - https://blog.nsfisis.dev/posts/2022-08-31/support-for-communty-is-employee-benefits/ - Wed, 31 Aug 2022 22:25:02 +0900 - - https://blog.nsfisis.dev/posts/2022-08-31/support-for-communty-is-employee-benefits/ - はじめに -

注: これは私個人の意見であり、所属する組織を代表するものではありません。

-

先日、私の勤める デジタルサーカス株式会社 が PHP Foundation へ $2,000 の寄付をおこないました。

-

記事: https://www.dgcircus.com/news/581

-

本件を社内でしつこく推進した1人として、推進の理由等を書き残しておきます。

-

なぜ？

-

組織としての寄付理由は前掲した記事に譲るとして、ここでは、私が社内でこの件を推進した理由について書くことにします。

-

当時の考えを端的にまとめた社内チャットの投稿があったので、それを引用します:

-
-

結局これを通したい (私の中での) 最大の理由が、「自分の勤める会社が、これをやる会社であってほしい」というのがあり、↑にしても、感情ベースの理由しか出せていないというのが説得力に欠けている理由なのだと思いますが、寄付の報告が流れてきたり、OSS のフリーライドの話が流れてきたりするたびに、自尊心が毀損される、というか (これは大袈裟すぎる表現で、実際にはそこまで明確に傷ついているわけではありませんが)。

-

追記: 「肩身が狭くなる」というのがより適切でした。

-
-

※文中の「↑にしても」は、ここに載せていない別の投稿を指しています。

-

OSS を金銭的に支援したり、技術カンファレンスへ協賛したり (あるいは CTO がカンファレンスを年2で主催したり: iOSDC PHPerKaigi) といった行為は、コミュニティへの貢献であると同時に、社員に対する精神的福利厚生でもあると言えるでしょう (知らんけど)。これらは、技術や技術者を大切にする組織である、ということの、対外的にも対内的にも強力なメッセージなのです。

-

以上が、私が社内で寄付の件を進めた (かなり私的な) 理由です。

-

おわりに

-

最終的に社としての寄付まで漕ぎ着けられたのは、もちろん私の力ではなく役員の方々の決定によるものです。この場を借りて感謝申し上げます。

-]]> - - - - PHP カンファレンス沖縄で出題されたコードゴルフの問題を解いてみた - https://blog.nsfisis.dev/posts/2022-08-27/php-conference-okinawa-code-golf/ - Sat, 27 Aug 2022 18:55:28 +0900 - - https://blog.nsfisis.dev/posts/2022-08-27/php-conference-okinawa-code-golf/ - はじめに -

本日 PHP カンファレンス沖縄 2022 が開催された (らしい)。

-

カンファレンスには参加できなかったものの、懇親会の LT で出題されたコードゴルフの問題が Twitter に流れてきたので、解いてみた。

-

ツイート: https://twitter.com/m3m0r7/status/1563397620231712772
-スライド: https://speakerdeck.com/memory1994/php-conference-okinawa-2022-extra?slide=3

-

解

-

細かいレギュレーションは不明だったので、勝手に定めた。

-
    -
  • コマンドライン引数の第1引数で受けとる
    • -
  • 結果は標準出力に出す
    • -
  • コンマの直後にはスペースを1つ置く
    • -
  • 末尾コンマは禁止
    • -
  • 数字でないものは入ってこないものとする
    • -
  • 負数は入ってこないものとする
    • -
-

書いたものがこちら:

-
[<?php $n=$argv[1];foreach([1e4,5e3,2e3,1e3,500,100,50,10,5,1]as$x)for(;$n>=$x;$n-=$x)$r[]=$x;echo implode(', ',$r??[]);?>]
-

しめて 123 バイトとなった (末尾改行を含めずにカウント)。

-

こちらは改行とスペースを追加したバージョン:

-
[<?php
-
-$n = $argv[1];
-foreach ([1e4, 5e3, 2e3, 1e3, 500, 100, 50, 10, 5, 1] as $x)
-  for (; $n >= $x; $n -= $x)
-    $r[] = $x;
-echo implode(', ', $r ?? []);
-
-?>]
-

使用したテクニック

-

指数表記

-

割と多くの言語のゴルフで使えるテクニック。e を用いた指数表記で、大きな数を短く表す。このコードでは 10000、5000、2000、1000 を指数表記している。

-

foreach や for の中身を1つの文に

-

foreach、for、if などの後ろには、通常 { を続けて複数の文を連ねるが、中身の文を1つにしてしまえば、{ と } を省略できる。C言語などでも使える。

-

$r に初期値を入れない

-

PHP では、$r[] = ... のような配列の末尾に追加する式を実行したとき、$r が未定義だった場合は $r を勝手に定義して空の配列で初期化してくれる。これを利用すると、$r = []; のような初期化が不要になる。

-

ただし、プログラムに 0 が渡されるとループを一度も回らないので、$r が未定義になってしまい、implode() に渡すところでエラーになる。それを防ぐために $r ?? [] を使っている。

-

もし 0 が渡されたケースを無視するなら、これが不要になるので 4 バイト縮む。

-

PHP タグの外に文字列を置く

-

PHP では、<?php ?> で囲われた部分の外側にある文字列は、そのまま出力される。今回のケースでは、先頭と末尾に必ず [ と ] を出力するので、そのまま書いてやればよい。

-

おわりに

-

最後になりましたが、めもりー さん、楽しい問題をありがとうございました。

-]]> - - - - PHPerKaigi 2022 - https://blog.nsfisis.dev/posts/2022-05-01/phperkaigi-2022/ - Sun, 01 May 2022 09:41:39 +0900 - - https://blog.nsfisis.dev/posts/2022-05-01/phperkaigi-2022/ - はじめに -

2022-04-09 から 2022-04-11 にかけて開催された、PHPerKaigi 2022 に、一般参加者として参加した。 -弊社デジタルサーカス株式会社 はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。

-

昨年のレポートはこちら。

-

感想

-

厳選おすすめトーク

-

多くの素晴らしいトークの中から、特におすすめのものを 5つ選んだ。是非聞いてほしい。引用部分は、リンク先プロポーザルから引用している。

-

予防に勝る防御なし - 堅牢なコードを導く様々な設計のヒント

-
-

PHP はバージョンを追う毎に型宣言、例外、表明、列挙型などの機能が大幅に強化され、堅牢なコードを書くための機能が充実してきました。それらの機能はどう使うと効果的なのでしょうか。

-

本講演では PHP 8.1 をベースにして、誤りを想定してチェックするのではなく、そもそも誤りにくい設計とはどのようなものか、つまり「予防」の観点を軸足に、堅牢なコードを導くための様々な設計のヒントをご紹介します。

-
-

PHPのエラーを理解して適切なエラーハンドリングを学ぼう

-
-

PHPを使ってるとよく遭遇する Fatal error / Parse error / Warning / Notice 理解していますか？
-これらのエラー文を理解することで、すぐにエラーの原因に気付き適切に対象できる様になります！
-またそれらを理解した上でのエラーハンドリングを学びましょう。

-
-

エラー監視とテスト体制への改善作戦

-
-

毎日流れてくるエラーに皆さんはどう向き合ってますか？
-エラーを出さない事が一番ですが、完全に塞ぐ事は難しいと考えます。
-サービス運用の中で本番環境から発生するエラー（サーバー・クライアントサイド・サードパーティ起因のエラー）への監視体制と、
-エラー・バグ防御のためチームで行っているテストコード文化づくりの話をします。

-
-

ISUCON11のPHP実装は、何を考え、どのようにして作られていたのか

-
-

昨年開催されたISUCON11にて問題（参考実装）のPHPへの移植を担当させていただきました。

-

最終的なソースコードこそシンプルなWebアプリケーションではありますが、その裏には
-・「（私の思う）良い設計」を実現するための意思決定
-・「ISUCONの問題」という位置付けに由来する取捨選択
-・移植中に遭遇したトラブルとその解決策
-といった文脈や葛藤が存在しています。

-

本発表はそれらを共有することで
-・PHPアプリケーションの設計、実装事例として役立ててもらう
-・ISUCONの言語移植に興味を持ってもらう
-・ISUCON問題移植の「実装や設計の練習をする教材」としての可能性を知ってもらう
-ことを目的とします。

-
-

チームの仕事はまわっていたけど、メンバーはそれぞれモヤモヤを抱えていた話──40名の大規模開発チームで1on1ログを公開してみた

-
-

サイボウズの大企業向けグループウェアのGaroon（ガルーン）は、PHPで開発されている20年目の製品です。ガルーン開発チームは日本で40名、ベトナムで50名の計90名ほどのチームになっています。また、コロナ禍でフルリモートでの活動がこの2年ほど継続してきました。

-

フルリモートになっても仕事はまわっており、継続的にリリースはしていましたが、一方でお互いの考えていることや感じている問題意識が見えづらくなり、モヤモヤを抱えているメンバーが増えていました。

-

このセッションでは、そういう状況で私がチーム外からジョインし、聴き役に徹しながら見える化することで状況を改善していった取り組みを紹介します。同じように大きなチームやリモートワークで難しさを感じている人に、難しさの原因への気づきや取り組みへのヒントがあれば幸いです。

-
-

トークン問題の作成

-

今回は、PHPer チャレンジ用に弊社のトークン問題を 3題作成した。こちらについては別途記事にしているので、そちらを参照されたい。

-

PHPer チャレンジ

-

1位になった。
-また、賞品として Echo Show 15 をいただいた。

-

カンファレンス全体への感想

-

去年の参加レポ では、こんなことを書いた。

-
-

1つ個人的な反省点としては、(中略) Discord しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。
-まあ初カンファレンスだし、とお茶を濁しておこう。

-
-

この反省を踏まえ、今年は積極的にほかの場 (公式の Discord サーバや、アンカンファレンス) にも参加した。
-これにより、参加体験の質がはるかに向上した。特に Discord に関しては、登壇者ご本人による補足や、質問への回答などがおこなわれる (ことが多い) ため、特別な理由のない限り、発言はしないまでも参加はしておいたほうが良いと思われる。

-

なお、アンカンファレンスについては、1日目の終わりにトークン問題の解説放送もおこなった。

-

また、今年はオフラインとオンラインのハイブリッド開催であったが、去年の全オンラインと比べて、オンライン参加の体験が落ちていなかったのは、特筆すべきであろう。 -今年は 3回目のワクチン接種が間に合わなかったこともあり現地参加は見送ったのだが、来年は是非オフラインで参加したい。

-

そして来年へ……?

-

PHPerKaigi 2023 があるかどうか存じ上げないが、あるとすれば、次の 4つを目標としたい。

-
    -
  • プロポーザルを出す
    • -
  • PHPer チャレンジのトークン問題を 5題作成する
    • -
  • 現地に行く
    • -
  • PHPer チャレンジで圧勝する
    • -
-
-

最後になりましたが、PHPerKaigi のスタッフ、スポンサー、スピーカーのみなさん、素敵な時間をありがとうございました。

-

ではまた来年。

-]]> - - - - term-banner: ターミナルにバナーを表示するツールを書いた - https://blog.nsfisis.dev/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal/ - Sun, 24 Apr 2022 13:22:52 +0900 - - https://blog.nsfisis.dev/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal/ - はじめに -

こんなものを作った。

-
$ term-banner 'Hello, World!' 'こんにちは、' '世界！'
-

term-banner のスクリーンショット

-

コマンドライン引数として渡した文字列をターミナルに大きく表示する。

-

リポジトリはこちら: https://github.com/nsfisis/term-banner

-

Motivation

-

以前、big-clock-mode という似たようなプログラムを書いた。 -これは tmux の :clock-mode コマンドに着想を得たもので、:clock-mode よりも大きく現在時刻を表示する。

-

big-clock-mode を開発したのは、次のようなシチュエーションで使うためである。 -弊社では現在リモートワークが基本だが、web 会議などで画面共有しているときに、休憩を挟んで特定の時刻から再開する、ということがある。 -こういったケースで、画面上に現在の時刻を大きめに表示しておくと、モニタから離れても遠くから時刻がわかるので便利である。

-

それこそタイマアプリか何かを使えばいいのだが、ターミナルに棲むいきものとしては、住処から離れたくないわけだ。

-

しばらく便利に使っていたのだが、ひとつ不満点が出てきた。それは、再開する時刻がいつだったかを覚えておかなければならないということだ。 -どこかにメモしておいてもいいが、せっかくなら現在時刻とともに表示させておきたい。

-

そんなわけで、「任意の文字列をターミナルに表示する」プログラムを書く運びとなった。 -まあ、作らなくても探せばあると思うが、作りたいものは作りたいので知ったことではない。

-

プログラム

-

全体の流れは次のようになっている。

-
    -
  1. フォントファイルを読み込む
    2. -
  2. コマンドライン引数を Shift-JIS に変換する (フォントが Shift-JIS 基準で並んでいるため)
    3. -
  3. 1文字ずつレンダリングしていく
    4. -
-

big-clock-mode が Go 製なので、今回も Go で書いた。 -PNG が標準ライブラリにあったり、Shift-JIS のエンコーディングが準標準ライブラリにあったりしたのは助かった。

-

フォントファイルは go:embed で実行ファイルに埋め込んでいるので、ビルド後はワンバイナリで動く。 -仕事ではスクリプト言語ばかり書いているが、やはりコンパイル言語はいい。

-

フォント

-

フリーの 8x8 ビットマップフォントである、美咲フォント 2021-05-05a 版 を使わせていただいた。

-

はじめは自分でポチポチ打っていたのだが、「き」くらいまでやって挫折した。 -同じく 8x8 で作っていたのだが、平仮名でさえも、この小さなキャンバスにはとても収められない。

-

美咲フォントは、平仮名・片仮名に留まらず、JIS 第一・第二水準の漢字までサポートしている。 -第二水準ともなると一生お目にかかることのない字の方が多いくらいだが、これをこの大きさで書くというのは、もはや芸術の域である。

-

さらに言うと、実のところ美咲フォントは実サイズ 7x7 で作られており、余白が設けられている。 -これは、単純にそのまま並べても字間・行間を確保できるようにという配慮である。 -おかげでコーディングまで楽になった。

-

ゴシック体と明朝体があったが、私の好みで明朝体の方にした。 -ただ、ゴシック体の方が見やすい気がするので、フォントを選べるように後ほど拡張するかもしれない。

-

2022-04-27 追記: -f オプションで選べるようにした。

-

おわりに

-

あなたもターミナルに住んでみませんか？

-]]> - - - - PHPerKaigi 2022 トークン問題の解説 - https://blog.nsfisis.dev/posts/2022-04-09/phperkaigi-2022-tokens/ - Sat, 09 Apr 2022 21:50:19 +0900 - - https://blog.nsfisis.dev/posts/2022-04-09/phperkaigi-2022-tokens/ - はじめに -

本日開始された PHPerKaigi 2022 の PHPer チャレンジにおいて、弊社 デジタルサーカス株式会社 の問題を 3問作成した。この記事では、これらの問題の解説をおこなう。

-

リポジトリはこちら: https://github.com/nsfisis/PHPerKaigi2022-tokens

-

第1問 brainf_ck.php

-

ソースコードはこちら。実行には PHP 8.1 以上が必要なので注意。

-
<?php
-
-declare(strict_types=0O1);
-
-namespace Dgcircus\PHPerKaigi\Y2022;
-
-/**
- * @todo
- * Run this program to acquire a PHPer token.
- */
-
-https://creativecommons.org/publicdomain/zero/1.0/
-
-\error_reporting(~+!'We are hiring!');
-
-$z = fn($f) => (fn($x) => $f(fn(...$xs) => $x($x)(...$xs)))(fn($x) => $f(fn(...$xs) => $x($x)(...$xs)));
-$id = \spl_object_id(...);
-$put = fn($c) => \printf('%c', $c);
-$mm = fn($p, $n) => new \ArrayObject(\array_fill(+!![], $n, $p));
-
-$👉 = fn($m, $p, $b, $e, $mp, $pc) => [++$mp, ++$pc];
-$👈 = fn($m, $p, $b, $e, $mp, $pc) => [--$mp, ++$pc];
-$👍 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, ++$m[$mp]];
-$👎 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, --$m[$mp]];
-$📝 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, $put($m[$mp])];
-$🤡 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) {
-    +!![] => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) {
-      $b => $loop(++$pc, ++$n),
-      $e => $n === +!![] ? ++$pc : $loop(++$pc, --$n),
-      default => $loop(++$pc, $n),
-    })($pc, -![])],
-    default => [$mp, ++$pc],
-};
-$🎪 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) {
-    +!![] => [$mp, ++$pc],
-    default => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) {
-      $e => $loop(--$pc, ++$n),
-      $b => $n === +!![] ? $pc+![] : $loop(--$pc, --$n),
-      default => $loop(--$pc, $n),
-    })($pc, -![])],
-};
-$🐘 = fn($p) => $z(fn($loop) => fn($m, $p, $b, $e, $mp, $pc) =>
-  isset($p[$pc]) && $loop($m, $p, $b, $e, ...($p[$pc]($m, $p, $b, $e, $mp, $pc)))
-)($mm(+!![], +(![].![])), $p, $id($🤡), $id($🎪), +!![], +!![]);
-
-$🐘([
-  $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-  $🤡,
-    $👉, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-    $👈, $👈, $👈, $👈, $👎,
-  $🎪,
-  $👉, $👍, $👍, $👍, $👍, $👍, $📝,
-  $👎, $👎, $📝,
-  $👉, $👎, $👎, $👎, $📝,
-  $👉, $👎, $👎, $👎, $📝,
-  $👎, $👎, $📝,
-  $👎, $📝,
-  $👈, $📝,
-  $👉, $👉, $👎, $👎, $📝,
-  $👍, $👍, $👍, $👍, $👍, $👍, $👍, $📝,
-  $👈, $👎, $👎, $👎, $👎, $📝,
-  $👈, $📝,
-  $👉, $👍, $👍, $📝,
-  $👉, $👎, $📝,
-  $👈, $📝,
-]);
-

この問題は、単に適切なバージョンの PHP で動かせばトークンが得られる。

-

解説

-

絵文字

-

まず目につくのは大量の絵文字だろう。 -PHP は識別子に使用できる文字の範囲が広く、絵文字も使うことができる。

-

プログラム全体

-

Brainf*ck のインタプリタとプログラムになっている。 -Brainf*ck とは、難解プログラミング言語のひとつであり、ここで説明するよりも Wikipedia の該当ページを読んだ方がよい。

-

https://ja.wikipedia.org/wiki/Brainfuck

-

なお、brainf*ck プログラムを普通の書き方で書くと、次のようになる。

-
+ + + + + + + + + +
-[
-  > + + +
-  > + + + + +
-  > + + + + + + + + + + + +
-  > + + + + + + + + + +
-  < < < < -
-]
-> + + + + + .
-- - .
-> - - - .
-> - - - .
-- - .
-- .
-< .
-> > - - .
-+ + + + + + + .
-< - - - - .
-< .
-> + + .
-> - .
-< .
-

実行結果はこちら: https://ideone.com/22VWmb

-

それぞれの絵文字で表された関数が、各命令に対応している。

-
    -
  • $👉: >
    • -
  • $👈: <
    • -
  • $👍: +
    • -
  • $👎: -
    • -
  • $📝: .
    • -
  • $🤡: [
    • -
  • $🎪: ]
    • -
-

, (入力) に対応する関数はない (このプログラムでは使わないので用意していない)。

-

なお、$🐘 はいわゆる main 関数であり、プログラムの実行部分である。

-

絵文字の選択

-

おおよそ意味に合致するよう選んでいるが、$🤡 と $🎪 は弊社デジタルサーカスにちなんでいる。 -また、$🐘 は PHP のマスコットの象に由来する。

-

strict_types

-

declare 文の strict_types に指定できるのは、0 か 1 の数値リテラルだが、 -0x0 や 0b1 のような値も受け付ける。 -今回は、PHP 8.1 から追加された、0O または 0o から始まる八進数リテラルを使った。

-

URL

-

ソースコードのライセンスを示したこの部分だが、

-
https://creativecommons.org/publicdomain/zero/1.0/
-

完全に合法な PHP のコードである。 -https: 部分はラベル、// 以降は行コメントになっている。

-

リテラルなしで数値を生成する

-

ソースコード中に、ほとんど数値リテラルが書かれていないことにお気づきだろうか。 -PHP では、型変換を利用することで任意の整数を作り出すことができる。

-
assert(0 === +!![]);
-assert(1 === +![]);
-assert(2 === ![]+![]);
-assert(3 === ![]+![]+![]);
-assert(10 === +(![].+!![]));
-

[] に ! を適用すると true が返ってくる。それに + -を適用すると、bool から int ヘの型変換が走り、1 が生成される。10 -はさらにトリッキーだ。まず 1 と 0 を作り、. で文字列として結合する -('10')。これに + を適用すると、string から int -への型変換が走り、10 が生まれる (コード量に頓着しないなら、1 を 10 -個足し合わせてももちろん 10 が作れる)。

-

また、error_reporting に指定しているのは -1 である。 -これは、! によって文字列を false にし、+ によって false を 0 にし、さらにビット反転して -1 にしている。

-

if 文なしで条件分岐

-

三項演算子ないし match 式を使うことで、if を一切書かずに条件分岐ができる。 -また、&& / || も使えることがある。 -遅延評価が不要なケースでは、[$t, $f][$cond] のような形で分岐することもできる。

-

while、for 文なしでループ

-

不動点コンビネータを使って無名再帰する (詳しい説明は省略する。これらの単語で検索してほしい)。 -ここでは、一般に Z コンビネータとして知られるものを使った ($z)。

-

実際のところ、$🤡 や $🎪、$🐘 は、一度 Scheme (Lisp の一種) で書いてから PHP に翻訳する形で記述した。

-

なお、PHP は末尾再帰の最適化をおこなわない (少なくとも今のところは) ので、 -あまりに長い brainf*ck プログラムを書くとスタックオーバーフローする。

-

第2問 riddle.php

-

ソースコードはこちら。実行には PHP 8.0 以上が必要なので注意。

-
<?php
-
-/*********************************************************
- * This program displays a PHPer token.                  *
- * Guess 'N'.                                            *
- *                                                       *
- * Hints:                                                *
- * - N itself has no special meaning, e.g., 42, 8128,    *
- *   it is selected at random.                           *
- * - Each element of $token represents a single letter.  *
- * - One letter consists of 5x5 cells.                   *
- * - Remember, the output is a complete PHPer token.     *
- *                                                       *
- * License:                                              *
- *   https://creativecommons.org/publicdomain/zero/1.0/  *
- *********************************************************/
-const N = 0 /* Change it to your answer. */;
-assert(0 <= N && N <= 0b11111_11111_11111_11111_11111);
-
-$token = [
-  0x14B499C,
-  0x0BE34CC, 0x01C9C69,
-  0x0ECA069, 0x01C2449, 0x0FDB166, 0x01C9C69,
-  0x01C1C66, 0x0FC1C47, 0x01C1C66,
-  0x10C5858, 0x1E4E3B8, 0x1A2F2F8,
-];
-foreach ($token as $x) {
-  $x = $x ^ N;
-
-  $x = sprintf('%025b', $x);
-  $x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-  $x = implode("\n", str_split($x, length: 5));
-  echo "{$x}\n\n";
-}
-

さて、この問題はさきほどのように単純に実行しただけでは、謎のブロックが表示されるだけでトークンは得られない。 -トークンを得るためには、ソースコードを読み、定数 N を特定する必要がある。

-

ここでは、私の想定解を解説する。

-

読解

-

まずはソースコードを読んでいく。

-
$token = [
-  // 略
-];
-

数値からなる $token があり、各要素をループしている。

-
  $x = $x ^ N;
-

まずは排他的論理和 (xor) を取り、

-
  $x = sprintf('%025b', $x);
-

二進数に変換して、

-
  $x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-

0 を空白に、1 を # にし、

-
  $x = implode("\n", str_split($x, length: 5));
-

5文字ごとに区切ったあと、改行で結合している。

-

ヒント

-

次に、ソースコードに書いてあるヒントを読んでいく。

-
    -
  • N それ自体は、42 や 8128 といったような特別な意味を持たず、ランダムに決められている
    • -
  • $token の各要素は、1文字を表す
    • -
  • 1文字は 5x5 のセルからなる
    • -
  • 出力されるのは、完全な PHPer トークンである
    • -
-

ここで、PHPer トークンは必ず # 記号から始まることを思いだすと、 -$token の最初の数字 0x14B499C は、変換の結果 # になるのではないかと予想される (なお、このことは、リポジトリの README ファイルに追加ヒントとして書かれている)。

-

解く

-

ここまでわかれば、あと一歩で解ける。すなわち、0x14B499C が # に変換されるような N を見つければよい。

-

N は高々

-
assert(0 <= N && N <= 0b11111_11111_11111_11111_11111);
-

なのでブルートフォースしてもよいが、ここではブルートフォースしない方法を紹介する。

-
<?php
-
-$x = 0x14B499C;
-
-$x = $x ^ N;
-
-$x = sprintf('%025b', $x);
-$x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-$x = implode("\n", str_split($x, length: 5));
-
-assert($x ===
-  " # # \n" .
-  "#####\n" .
-  " # # \n" .
-  "#####\n" .
-  " # # ");
-

この一連の変換に対する逆変換を考えると、次のようになる。

-
<?php
-
-$x =
-  " # # \n" .
-  "#####\n" .
-  " # # \n" .
-  "#####\n" .
-  " # # ";
-
-$x = implode('', explode("\n", $x));
-$x = str_replace(search: [' ', '#'], replace: ['0', '1'], subject: $x);
-$x = bindec($x);
-
-$n = $x ^ 0x14B499C;
-
-echo "N = $n\n";
-

これを実行すると、N が得られる。

-

第3問 toquine.php

-

ソースコードはこちら。

-
<?php
-
-// License: https://creativecommons.org/publicdomain/zero/1.0/
-// This is a quine-like program to generate a PHPer token.
-// Execute it like this: php toquine.php | php | php | php | ...
-
-$s = <<<'Q'
-<?cuc
-// Yvprafr: uggcf://perngvirpbzzbaf.bet/choyvpqbznva/mreb/1.0/
-// Guvf vf n dhvar-yvxr cebtenz gb trarengr n CUCre gbxra.
-// Rkrphgr vg yvxr guvf: cuc gbdhvar.cuc | cuc | cuc | cuc | ...
-%f$f = %f;
-$f = fge_ebg13($f); $kf = [
-%f,
-];
-$g = ahyy.snyfr; sbe ($v = 0; $v <= vagqvi(__YVAR__-035,6); ++$v) vs (!vffrg($kf[$v])) oernx; ryfr
-$g .= vzcybqr("\a", fge_fcyvg(fge_ercynpr(['0','1'], ['  ','##'], fcevags(pue(37) . '025o', $kf[$v])), 012)) . "\a\a";
-$jf = neenl_znc(sa($j) => vzcybqr(', ', $j), neenl_puhax(neenl_znc(sa($k) => fcevags('0k' . pue(37) . '07K', $k), $kf), 10));
-cevags($f, $g, fge_ebg13("<<<'Q'\a{$f}\aQ"), vzcybqr(",\a", $jf));
-Q;
-$s = str_rot13($s); $xs = [
-0x0AFABEA, 0x1F294A7, 0x1F2109F, 0x1F294A7, 0x0002800, 0x1F2109F, 0x0117041, 0x1F294A7, 0x1FAD6B5, 0x1F295B7,
-0x010FC21, 0x1FAD6B5, 0x1151151, 0x010FC21, 0x1F294A7, 0x1F295B7, 0x1FAD6B5, 0x1F294A7, 0x1F295B7, 0x1F8C63F,
-0x1F8C631, 0x1FAD6B5, 0x17AD6BD, 0x17AD6BD, 0x1F8C63F, 0x1F295B7,
-];
-$t = null.false; for ($i = 0; $i <= intdiv(__LINE__-035,6); ++$i) if (!isset($xs[$i])) break; else
-$t .= implode("\n", str_split(str_replace(['0','1'], ['  ','##'], sprintf(chr(37) . '025b', $xs[$i])), 012)) . "\n\n";
-$ws = array_map(fn($w) => implode(', ', $w), array_chunk(array_map(fn($x) => sprintf('0x' . chr(37) . '07X', $x), $xs), 10));
-printf($s, $t, str_rot13("<<<'D'\n{$s}\nD"), implode(",\n", $ws));
-

コメントにもあるとおり、次のようにして実行すれば答えがでてくる。

-
$ php toquine.php | php | php | php | ...
-

実際にはもう少しパイプで繋げなければならない。

-

解説

-

プログラム全体

-

コメントにもあるとおり、これは quine (風) のプログラムになっている。 -Quine とは、自分のソースコードをそっくりそのまま出力するようなプログラムのことである。

-

このプログラムは、実行すると自身とほとんど同じプログラムを出力する。 -異なるのはトークンになっている部分のみである。

-

トークン

-

$xs がトークンに対応している。変換のロジックは riddle.php とほぼ同じなので省略する。

-

状態保持

-

トークンの何文字目まで出力したかを、ソースコードを変えずに (quine なので) 覚えておく必要がある。 -このプログラムでは、トークンが出力されるとソースコードがだんだんと長くなっていくのを利用して、__LINE__ から情報を取得している。

-

ROT 13

-

Quine は、素朴に書くとプログラムの一部が 2回記述されてしまう。 -これがあまり美しくないので、toquine.php では、ROT 13 変換を使って難読化した。

-

それにしてもなぜこんなものが標準ライブラリに……。

-

おわりに

-

解いていただいたみなさん、また、難易度調整につきあっていただいた社内のみなさん、ありがとうございました。

-

今回は直前に作りはじめたのもあり、3問だけかつ使い古されたネタばかりになってしまいましたが、 -来年は 5問、より面白い問題を持っていきます。

-

実はもう作りはじめているので、どうか来年もありますように……。

-]]> - - - - Rust のプリミティブ型はどこからやって来るか - https://blog.nsfisis.dev/posts/2021-10-02/rust-where-are-primitive-types-from/ - Sat, 02 Oct 2021 09:39:27 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/rust-where-are-primitive-types-from/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/9a429432258bbcd6c565

-
-

前置き

-

Rust において、プリミティブ型の名前は予約語でない。したがって、次のコードは合法である。

-
#![allow(non_camel_case_types)]
-#![allow(dead_code)]
-
-struct bool;
-struct char;
-struct i8;
-struct i16;
-struct i32;
-struct i64;
-struct i128;
-struct isize;
-struct u8;
-struct u16;
-struct u32;
-struct u64;
-struct u128;
-struct usize;
-struct f32;
-struct f64;
-struct str;
-

では、普段単に bool と書いたとき、この bool は一体どこから来ているのか。rustc のソースを追ってみた。

-
-

前提知識: 一般的なコンパイラの構造、用語。rustc そのものの知識は不要 (というよりも筆者自身がよく知らない)

-
-

調査

-

調査に使用したソース (調査時点での最新 master)

-

https://github.com/rust-lang/rust/tree/511ed9f2356af365ad8affe046b3dd33f7ac3c98

-

どのようにして調べるか。rustc の構造には詳しくないため、すぐに当たりをつけるのは難しい。

-

大雑把な構造としては、compiler フォルダ以下に rustc_* という名前のクレートが数十個入っている。これがどうやら rustc コマンドの実装部のようだ。

-

rustc はセルフホストされている (= rustc 自身が Rust で書かれている) ので、bool や char などで適当に検索をかけてもノイズが多すぎて話にならない。 -しかし、お誂え向きなことに i128/u128 というコンパイラ自身が使うことがなさそうな型が存在するのでこれを使って git grep してみる。

-
$ git grep "\bi128\b" | wc      # i128
-     165    1069   15790
-
-$ git grep "\bu128\b" | wc      # u128
-     293    2127   26667
-
-$ git grep "\bbool\b" | wc      # cf. bool の結果
-    3563   23577  294659
-

165 程度であれば探すことができそうだ。今回は、クレート名を見ておおよその当たりをつけた。

-
$ git grep "\bi128\b"
-...
-rustc_resolve/src/lib.rs:        table.insert(sym::i128, Int(IntTy::I128));
-...
-

rustc_resolve というのはいかにも名前解決を担いそうなクレート名である。該当箇所を見てみる。

-
/// Interns the names of the primitive types.
-///
-/// All other types are defined somewhere and possibly imported, but the primitive ones need
-/// special handling, since they have no place of origin.
-struct PrimitiveTypeTable {
-    primitive_types: FxHashMap<Symbol, PrimTy>,
-}
-
-impl PrimitiveTypeTable {
-    fn new() -> PrimitiveTypeTable {
-        let mut table = FxHashMap::default();
-
-        table.insert(sym::bool, Bool);
-        table.insert(sym::char, Char);
-        table.insert(sym::f32, Float(FloatTy::F32));
-        table.insert(sym::f64, Float(FloatTy::F64));
-        table.insert(sym::isize, Int(IntTy::Isize));
-        table.insert(sym::i8, Int(IntTy::I8));
-        table.insert(sym::i16, Int(IntTy::I16));
-        table.insert(sym::i32, Int(IntTy::I32));
-        table.insert(sym::i64, Int(IntTy::I64));
-        table.insert(sym::i128, Int(IntTy::I128));
-        table.insert(sym::str, Str);
-        table.insert(sym::usize, Uint(UintTy::Usize));
-        table.insert(sym::u8, Uint(UintTy::U8));
-        table.insert(sym::u16, Uint(UintTy::U16));
-        table.insert(sym::u32, Uint(UintTy::U32));
-        table.insert(sym::u64, Uint(UintTy::U64));
-        table.insert(sym::u128, Uint(UintTy::U128));
-        Self { primitive_types: table }
-    }
-}
-

これは初めに列挙したプリミティブ型の一覧と一致している。doc comment にも、

-
-

All other types are defined somewhere and possibly imported, but the primitive ones need special handling, since they have no place of origin.

-
-

とある。次はこの struct の使用箇所を追う。追うと言っても使われている箇所は次の一箇所しかない。なお説明に不要な箇所は大きく削っている。

-
    /// This resolves the identifier `ident` in the namespace `ns` in the current lexical scope.
-    /// (略)
-    fn resolve_ident_in_lexical_scope(
-        &mut self,
-        mut ident: Ident,
-        ns: Namespace,
-        // (略)
-    ) -> Option<LexicalScopeBinding<'a>> {
-        // (略)
-
-        if ns == TypeNS {
-            if let Some(prim_ty) = self.primitive_type_table.primitive_types.get(&ident.name) {
-                let binding =
-                    (Res::PrimTy(*prim_ty), ty::Visibility::Public, DUMMY_SP, ExpnId::root())
-                        .to_name_binding(self.arenas);
-                return Some(LexicalScopeBinding::Item(binding));
-            }
-        }
-
-        None
-    }
-

関数名や doc comment が示している通り、この関数は識別子 (identifier, ident) を現在のレキシカルスコープ内で解決 (resolve) する。 -if ns == TypeNS のブロック内では、primitive_type_table (上記の PrimitiveTypeTable::new() で作られた変数) に含まれている識別子 (bool、i32 など) かどうか判定し、そうであればそれに紐づけられたプリミティブ型を返している。

-

なお、ns は「名前空間」を示す変数である。Rust における名前空間はC言語におけるそれとほとんど同じで、今探している名前が関数名/変数名なのか型なのかマクロなのかを区別している。この if は、プリミティブ型に解決されるのは型を探しているときだけだ、と言っている。

-

重要なのは、これが resolve_ident_in_lexical_scope() の最後に書かれている点である。つまり、最初に挙げたプリミティブ型の識別子は、「名前解決の最終段階で」、「他に同名の型が見つかっていなければ」プリミティブ型として解決される。

-

動作がわかったところで、例として次のコードを考える。

-
#![allow(non_camel_case_types)]
-
-struct bool;
-
-fn main() {
-    let _: bool = bool;
-}
-

ここで main() の bool は struct bool として解決される。なぜなら、プリミティブ型の判定をする前に bool という名前の別の型が見つかるからだ。

-

まとめ

-

Rust のプリミティブ型は予約語ではない。名前解決の最終段階で特別扱いされ、他に同名の型が見つかっていなければ対応するプリミティブ型に解決される。

-]]> - - - - [Ruby] then キーワードと case in - https://blog.nsfisis.dev/posts/2021-10-02/ruby-then-keyword-and-case-in/ - Sat, 02 Oct 2021 09:38:50 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/ruby-then-keyword-and-case-in/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/787a8cf888a304497223

-
-

TL; DR

-

case - in によるパターンマッチング構文でも、case - when と同じように then が使える (場合によっては使う必要がある)。

-

then とは

-

使われることは稀だが、Ruby では then がキーワードになっている。次のように使う:

-
if cond then
-  puts "Y"
-else
-  puts "N"
-end
-

このキーワードが現れうる場所はいくつかあり、if、unless、rescue、case 構文がそれに当たる。 -上記のように、何か条件を書いた後 then を置き、式がそこで終了していることを示すマーカーとして機能する。

-
# Example:
-
-if x then
-  a
-end
-
-unless x then
-  a
-end
-
-begin
-  a
-rescue then
-  b
-end
-
-case x
-when p then
-  a
-end
-

なぜ普段は書かなくてもよいのか

-

普通 Ruby のコードで then を書くことはない。なぜか。次のコードを実行してみるとわかる。

-
if true puts 'Hello, World!' end
-

次のような構文エラーが出力される。

-
20:1: syntax error, unexpected local variable or method, expecting `then' or ';' or '\n'
-if true puts 'Hello, World!' end
-        ^~~~
-20:1: syntax error, unexpected `end', expecting end-of-input
-...f true puts 'Hello, World!' end
-

二つ目のメッセージは無視して一つ目を読むと、then か ; か改行が来るはずのところ変数だかメソッドだかが現れたことによりエラーとなっているようだ。

-

ポイントは改行が then (や ;) の代わりとなることである。true の後に改行を入れてみる。

-
if true
-puts 'Hello, World!' end
-

無事 Hello, World! と出力されるようになった。

-

なぜ then や ; や改行が必要か

-

なぜ then や ; や改行 (以下 「then 等」) が必要なのだろうか。次の例を見てほしい:

-
if a b end
-

then も ; も改行もないのでエラーになるが、これは条件式がどこまで続いているのかわからないためだ。 -この例は二通りに解釈できる。

-
# a という変数かメソッドの評価結果が truthy なら b という変数かメソッドを評価
-if a then
-  b
-end
-
# a というメソッドに b という変数かメソッドの評価結果を渡して呼び出し、
-# その結果が truthy なら何もしない
-if a(b) then
-end
-

then 等はこの曖昧性を排除するためにあり、条件式は if から then 等までの間にある、ということを明確にする。 -C系の if 後に来る (/) や、Python の :、Rust/Go/Swift などの { も同じ役割を持つ。

-

Ruby の場合、プログラマーが書きやすいよう改行でもって then が代用できるので、ほとんどの場合 then は必要ない。

-

case - in における then

-

ようやく本題にたどり着いた。来る Ruby 3.0 では case と in キーワードを使ったパターンマッチングの構文が入る予定である。この構文でもパターン部との区切りとして then 等が必要になる。 -(現在の) Ruby には formal な形式での文法仕様は存在しないので、yacc の定義ファイルを参照した (yacc の説明は省略)。

-

https://github.com/ruby/ruby/blob/221ca0f8281d39f0dfdfe13b2448875384bbf735/parse.y#L3961-L3986

-
p_case_body	: keyword_in
-		    {
-			SET_LEX_STATE(EXPR_BEG|EXPR_LABEL);
-			p->command_start = FALSE;
-			$<ctxt>1 = p->ctxt;
-			p->ctxt.in_kwarg = 1;
-			$<tbl>$ = push_pvtbl(p);
-		    }
-		    {
-			$<tbl>$ = push_pktbl(p);
-		    }
-		  p_top_expr then
-		    {
-			pop_pktbl(p, $<tbl>3);
-			pop_pvtbl(p, $<tbl>2);
-			p->ctxt.in_kwarg = $<ctxt>1.in_kwarg;
-		    }
-		  compstmt
-		  p_cases
-		    {
-		    /*%%%*/
-			$$ = NEW_IN($4, $7, $8, &@$);
-		    /*% %*/
-		    /*% ripper: in!($4, $7, escape_Qundef($8)) %*/
-		    }
-		;
-

簡略版:

-
p_case_body	: keyword_in p_top_expr then compstmt p_cases
-		;
-

ここで、keyword_in は文字通り in、p_top_expr はいわゆるパターン、then は then キーワードのことではなく、この記事で then 等と呼んでいるもの、つまり then キーワード、;、改行のいずれかである。

-

これにより、case - when による従来の構文と同じように、then 等をパターンの後ろに挿入すればよいことがわかった。つまり次の3通りのいずれかになる:

-
case x
-in 1 then a
-in 2 then b
-in 3 then c
-end
-
-case x
-in 1
-  a
-in 2
-  b
-in 3
-  c
-end
-
-case x
-in 1; a
-in 2; b
-in 3; c
-end
-

ところで、p_top_expr には if による guard clause が書けるので、その場合は if - then と似たような見た目になる。

-
case x
-in 0 then a
-in n if n < 0 then b
-in n then c
-end
-

まとめ

-
    -
  • if や case の条件の後ろには then、;、改行のいずれかが必要 -
      -
    • 通常は改行しておけばよい
      • -
    -
    • -
  • 3.0 で入る予定の case - in でも then 等が必要になる
    • -
  • Ruby の構文を正確に知るには (現状) parse.y を直接読めばよい
    • -
-]]> - - - - [C++] 属性構文の属性名にはキーワードが使える [[void]] [[for]] - https://blog.nsfisis.dev/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes/ - Sat, 02 Oct 2021 09:38:30 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/94090937bcf860cfa93b

-
-

タイトル落ち。まずはこのコードを見て欲しい。

-
#include <iostream>
-
-[[alignas]] [[alignof]] [[and]] [[and_eq]] [[asm]] [[auto]] [[bitand]]
-[[bitor]] [[bool]] [[break]] [[case]] [[catch]] [[char]] [[char16_t]]
-[[char32_t]] [[class]] [[compl]] [[const]] [[const_cast]] [[constexpr]]
-[[continue]] [[decltype]] [[default]] [[delete]] [[do]] [[double]]
-[[dynamic_cast]] [[else]] [[enum]] [[explicit]] [[export]] [[extern]] [[false]]
-[[final]] [[float]] [[for]] [[friend]] [[goto]] [[if]] [[inline]] [[int]]
-[[long]] [[mutable]] [[namespace]] [[new]] [[noexcept]] [[not]] [[not_eq]]
-[[nullptr]] [[operator]] [[or]] [[or_eq]] [[override]] [[private]]
-[[protected]] [[public]] [[register]] [[reinterpret_cast]] [[return]] [[short]]
-[[signed]] [[sizeof]] [[static]] [[static_assert]] [[static_cast]] [[struct]]
-[[switch]] [[template]] [[this]] [[thread_local]] [[throw]] [[true]] [[try]]
-[[typedef]] [[typeid]] [[typename]] [[union]] [[unsigned]]
-[[virtual]] [[void]] [[volatile]] [[wchar_t]] [[while]] [[xor]] [[xor_eq]]
-// [[using]]
-int main() {
-    std::cout << "Hello, World!" << std::endl;
-}
-
-

コンパイラのバージョン -$ clang++ –version -Apple clang version 11.0.0 (clang-1100.0.33.8) -Target: x86_64-apple-darwin19.6.0 -Thread model: posix -InstalledDir: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin

-

コンパイルコマンド (C++17指定) -$ clang++ –std=c++17 hoge.cpp

-
-

この記事から得られるものはこれ以上ないので以下は蛇足になる。

-

別件で cppreference.com の identifier のページ を読んでいた時、次の文が目に止まった。

-
-
    -
  • the identifiers that are keywords cannot be used for other purposes; -
      -
    • The only place they can be used as non-keywords is in an attribute-token. (e.g. [[private]] is a valid attribute) (since C++11)
      • -
    -
    • -
-
-

キーワードでも属性として指定する場合は非キーワードとして使えるらしい。 -実際にやってみる。

-

同サイトの [keywords のページ] (https://en.cppreference.com/w/cpp/keyword) から一覧を拝借し、上のコードが出来上がった (C++17 においてキーワードでないものなど、一部省いている)。 -大量の警告 (unknown attribute ‘〇〇’ ignored) がコンパイラから出力されるが、コンパイルできる。

-

上のコードでは [[using]] をコメントアウトしているが、これは using キーワードのみ属性構文の中で意味を持つからであり、このコメントアウトを外すとコンパイルに失敗する。

-
// using の例
-[[using foo: attr1, attr2]] int x; // [[foo::attr1, foo::attr2]] の糖衣構文
-

C++17 の仕様も見てみる (正確には標準化前のドラフト)。

-

引用元: https://timsong-cpp.github.io/cppwp/n4659/dcl.attr#grammar-4

-
-

If a keyword or an alternative token that satisfies the syntactic requirements of an identifier is contained in an attribute-token, it is considered an identifier.

-
-

「identifier の構文上の要件を満たすキーワードまたは代替トークンが attribute-token に含まれている場合、identifier とみなされる」とある。どうやら間違いないようだ。

-

ところで、代替トークン (alternative token) とは and (&) や bitor (|) などのことだが、identifier の構文上の要件を満たさないような代替トークンなどあるのか？ -疑問に思って調べたところ、代替トークンという語にはダイグラフも含まれるらしい (参考: 同ドラフト)

-
    -
  • <% → {
    • -
  • %> → }
    • -
  • <: → [
    • -
  • :> → ]
    • -
  • %: → #
    • -
  • %:%: → ##
    • -
-

「identifier の構文上の要件を満たさないような代替トークン」はこれらが当てはまると思われる。

-

調べた感想: 字句解析器か構文解析器が辛そう

-]]> - - - - [Ruby] 自身を実行している処理系の種類を判定する - https://blog.nsfisis.dev/posts/2021-10-02/ruby-detect-running-implementation/ - Sat, 02 Oct 2021 09:37:50 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/ruby-detect-running-implementation/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/74d7ffeeebc51b20d791

-
-

Ruby という言語には複数の実装があるが、それらをスクリプト上からどのようにして programmatically に見分ければよいだろうか。

-

Object クラスに定義されている RUBY_ENGINE という定数がこの用途に使える。

-

参考: Object::RUBY_ENGINE

-

上記ページの例から引用する:

-
$ ruby-1.9.1 -ve 'p RUBY_ENGINE'
-ruby 1.9.1p0 (2009-03-04 revision 22762) [x86_64-linux]
-"ruby"
-$ jruby -ve 'p RUBY_ENGINE'
-jruby 1.2.0 (ruby 1.8.6 patchlevel 287) (2009-03-16 rev 9419) [i386-java]
-"jruby"
-

それぞれの処理系がどのような値を返すかだが、stack overflow に良い質問と回答があった。

-

What values for RUBY_ENGINE correspond to which Ruby implementations? より引用:

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
RUBY_ENGINEImplementation
<undefined>MRI < 1.9
‘ruby’MRI >= 1.9 or REE
‘jruby’JRuby
‘macruby’MacRuby
‘rbx’Rubinius
‘maglev’MagLev
‘ironruby’IronRuby
‘cardinal’Cardinal
-
-

なお、この質問・回答は 2014年になされたものであり、値は変わっている可能性がある。MRI (aka CRuby) については執筆時現在 (2020/12/8) も 'ruby' が返ってくることを確認済み。

-

この表にない主要な処理系として、mruby は 'mruby' を返す。

-

mruby 該当部分のソース より引用:

-
/*
- * Ruby engine.
- */
-#define MRUBY_RUBY_ENGINE  "mruby"
-
]]> - - - - Vimで選択した行の順番を入れ替える - https://blog.nsfisis.dev/posts/2021-10-02/vim-swap-order-of-selected-lines/ - Sat, 02 Oct 2021 09:37:25 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/vim-swap-order-of-selected-lines/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/4fefb361d9a693803520

-
-

バージョン情報

-

:version の一部

-
-

VIM - Vi IMproved 8.2 (2019 Dec 12, compiled Jan 26 2020 11:30:30) -macOS version -Included patches: 1-148 -Huge version without GUI.

-
-

よく紹介されている手法

-

tac / tail

-

tac や tail -r などの外部コマンドを ! を使って呼び出し、置き換える。

-
-

:h v_!

-
-

tac コマンドや tail の -r オプションは環境によって利用できないことがあり、複数の環境を行き来する場合に採用しづらい

-

:g/^/m0

-

こちらは外部コマンドに頼らず、Vim の機能のみを使う。g は :global コマンドの、m は :move コマンドの略

-

:global コマンドは :[range]global/{pattern}/[command] のように使い、[range] で指定された範囲の行のうち、{pattern} で指定された検索パターンにマッチする行に対して、順番に [command] で指定された Ex コマンドを呼び出す。

-
-

:h :global

-
-

:move コマンドは [range]:move {address} のように使い、[range] で指定された範囲の行を {address} で指定された位置に移動させる。

-
-

:h :move

-
-

:g/^/m0 のように組み合わせると、「すべての行を1行ずつ 0行目(1行目の上)に動かす」という動きをする。これは確かに行の入れ替えになっている。

-

なお、:g/^/m0 は全ての行を入れ替えるが、:N,Mg/^/mN-1 とすることで N行目から M行目を処理範囲とするよう拡張できる。手でこれを入力するわけにはいかないので、次のようなコマンドを用意する。

-
command! -bar -range=%
-    \ Reverse
-    \ <line1>,<line2>g/^/m<line1>-1
-

これは望みの動作をするが、実際に実行してみると全行がハイライトされてしまう。次節で詳細を述べる。

-

:g/^/m0 の問題点

-

:global コマンドは各行に対してマッチングを行う際、現在の検索パターンを上書きしてしまう。^ は行の先頭にマッチするため、結果として全ての行がハイライトされてしまう。'hlsearch' オプションを無効にしている場合その限りではないが、その場合でも直前の検索パターンが失われてしまうと n コマンドなどの際に不便である。

-
-

:h @/

-
-

解決策

-
-

[2020/9/28追記] -より簡潔な方法を見つけたので次節に追記した

-
-

前述した :Reverse コマンドの定義を少し変えて、次のようにする:

-
function! s:reverse_lines(from, to) abort
-    execute printf("%d,%dg/^/m%d", a:from, a:to, a:from - 1)
-endfunction
-
-command! -bar -range=%
-    \ Reverse
-    \ call <SID>reverse_lines(<line1>, <line2>)
-

実行しているコマンドが変わったわけではないが、関数呼び出しを経由するようにした。これだけで前述の問題が解決する。

-

この理由は、ユーザー定義関数を実行する際は検索パターンが一度保存され、実行が終了したあと復元されるため。結果として検索パターンが ^ で上書きされることがなくなる。

-

Vim のヘルプから該当箇所を引用する (強調は筆者による)。

-
-

:h autocmd-searchpat

-

Autocommands do not change the current search patterns. Vim saves the current -search patterns before executing autocommands then restores them after the -autocommands finish. This means that autocommands do not affect the strings -highlighted with the ‘hlsearch’ option.

-
-

これは autocommand の実行に関しての記述だが、これと同じことがユーザー定義関数の実行時にも適用される。このことは :nohlsearch のヘルプにある。同じく該当箇所を引用する (強調は筆者による)。

-
-

:h :nohlsearch

-

(略) This command doesn’t work in an autocommand, because -the highlighting state is saved and restored when -executing autocommands |autocmd-searchpat|. -Same thing for when invoking a user function.

-
-

この仕様により、:g/^/m0 の呼び出しをユーザー定義関数に切り出すことで上述の問題を解決できる。

-

解決策 (改訂版)

-
-

[2020/9/28追記] -より簡潔な方法を見つけたため追記する

-
-
command! -bar -range=%
-    \ Reverse
-    \ keeppatterns <line1>,<line2>g/^/m<line1>-1
-

まさにこのための Exコマンド、:keeppatterns が存在する。:keeppatterns {command} のように使い、読んで字の如く、後ろに続く Exコマンドを「現在の検索パターンを保ったまま」実行する。はるかに分かりやすく意図を表現できる。

-
-

:h :keeppatterns

-
-

コピペ用再掲

-
" License: Public Domain
-
-command! -bar -range=%
-    \ Reverse
-    \ keeppatterns <line1>,<line2>g/^/m<line1>-1
-
]]> - - - - [Vim] autocmd events の BufWrite/BufWritePre の違い - https://blog.nsfisis.dev/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre/ - Sat, 02 Oct 2021 09:37:12 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/79ab4db8564032de0b25

-
-

TL; DR

-

違いはない。ただのエイリアス。

-

調査記録

-

Vim の autocmd events には似通った名前のものがいくつかある。大抵は :help に説明があるが、この記事のタイトルにある2つを含めた以下のイベントには、その違いについて説明がない。

-
    -
  • BufRead/BufReadPost
    • -
  • BufWrite/BufWritePre
    • -
  • BufAdd/BufCreate
    • -
-

このうち、BufAdd/BufCreate に関しては、:help BufCreate に

-
-

The BufCreate event is for historic reasons.

-
-

とあり、おそらくは BufAdd のエイリアスであろうということがわかる。他の2組も同様ではないかと予想されるが、確認のため vim と neovim のソースコードを調査した。

-
-

ソースコードへのリンク -vim (調査時点での master branch) -neovim (上に同じ)

-
-

vim のソースコード

-

以下は、autocmd events の名前と内部で使われている整数値とのマッピングを定義している箇所である。見ての通り、上でエイリアスではないかと述べた3組には、それぞれ同じ内部値が使われている。

-

https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L85-L86

-
    {"BufAdd",		EVENT_BUFADD},
-    {"BufCreate",	EVENT_BUFADD},
-

https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L95-L97

-
    {"BufRead",		EVENT_BUFREADPOST},
-    {"BufReadCmd",	EVENT_BUFREADCMD},
-    {"BufReadPost",	EVENT_BUFREADPOST},
-

https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L103-L105

-
    {"BufWrite",	EVENT_BUFWRITEPRE},
-    {"BufWritePost",	EVENT_BUFWRITEPOST},
-    {"BufWritePre",	EVENT_BUFWRITEPRE},
-

neovim のソースコード

-

neovim の場合でも同様のマッピングが定義されているが、こちらの場合は Lua で書かれている。以下にある通り、はっきり aliases と書かれている。

-

https://github.com/neovim/neovim/blob/71d4f5851f068eeb432af34850dddda8cc1c71e3/src/nvim/auevents.lua#L119-L124

-
  aliases = {
-    BufCreate = 'BufAdd',
-    BufRead = 'BufReadPost',
-    BufWrite = 'BufWritePre',
-    FileEncoding = 'EncodingChanged',
-  },
-

ところで、上では取り上げなかった FileEncoding だが、これは :help FileEncoding にしっかりと書いてある。

-
                                                           *FileEncoding*
-FileEncoding                    Obsolete.  It still works and is equivalent
-                                to |EncodingChanged|.
-

まとめ

-

記事タイトルについて言えば、どちらも変わらないので好きな方を使えばよい。あえて言えば、次のようになるだろう。

-
    -
  • BufAdd/BufCreate -
      -
    • → BufCreate は歴史的な理由により (“for historic reasons”) 存在しているため、新しい方 (BufAdd) を使う
      • -
    -
    • -
  • BufRead/BufReadPost -
      -
    • → BufReadPre との対称性のため、あるいは BufWritePost との対称性のため BufReadPost を使う
      • -
    -
    • -
  • BufWrite/BufWritePre -
      -
    • → BufWritePost との対称性のため、あるいは BufReadPre との対称性のため BufWritePre を使う
      • -
    -
    • -
  • FileEncoding/EncodingChanged -
      -
    • → FileEncoding は “Obsolete” と明言されているので、EncodingChanged を使う
      • -
    -
    • -
-

ところでこの調査で知ったのだが、BufRead と BufWrite は上にある通り発火するタイミングが「後」と「前」で対称性がない。可能なら Pre/Post 付きのものを使った方が分かりやすいだろう。

-]]> - - - - [Python] クロージャとUnboundLocalError: local variable 'x' referenced before assignment - https://blog.nsfisis.dev/posts/2021-10-02/python-unbound-local-error/ - Sat, 02 Oct 2021 09:32:37 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/python-unbound-local-error/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/5d733703afcb35bbf399

-
-

本記事は Python 3.7.6 の動作結果を元にして書かれている。

-

Python でクロージャを作ろうと、次のようなコードを書いた。

-
def f():
-    x = 0
-    def g():
-        x += 1
-    g()
-
-f()
-

関数 g から 関数 f のスコープ内で定義された変数 x を参照し、それに 1 を足そうとしている。 -これを実行すると x += 1 の箇所でエラーが発生する。

-
-

UnboundLocalError: local variable ‘x’ referenced before assignment

-
-

local変数 x が代入前に参照された、とある。これは、f の x を参照するのではなく、新しく別の変数を g 内に作ってしまっているため。 -前述のコードを宣言と代入を便宜上分けて書き直すと次のようになる。var を変数宣言のための構文として擬似的に利用している。

-
# 注: var は正しい Python の文法ではない。上記参照のこと
-def f():
-    var x           #  f の local変数 'x' を宣言
-    x = 0           #  x に 0 を代入
-    def g():        #  f の内部関数 g を定義
-        var x       #  g の local変数 'x' を宣言
-                    #  たまたま f にも同じ名前の変数があるが、それとは別の変数
-        x += 1      #  x に 1 を加算 (x = x + 1 の糖衣構文)
-                    #  加算する前の値を参照しようとするが、まだ代入されていないためエラー
-    g()
-

当初の意図を表現するには、次のように書けばよい。

-
def f():
-    x = 0
-    def g():
-        nonlocal x   ## (*)
-        x += 1
-    g()
-

(*) のように、nonlocal を追加する。これにより一つ外側のスコープ (g の一つ外側 = f) で定義されている x を探しに行くようになる。

-]]> - - - - PHPerKaigi 2021 - https://blog.nsfisis.dev/posts/2021-03-30/phperkaigi-2021/ - Tue, 30 Mar 2021 23:22:40 +0900 - - https://blog.nsfisis.dev/posts/2021-03-30/phperkaigi-2021/ - PHPerKaigi 2021 参加レポ -

2021-03-26 から 2021-03-28 にかけて開催された、PHPerKaigi 2021 に一般参加者として参加した。 -弊社デジタルサーカス株式会社 (今年1月から勤務) はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。

-

このようなカンファレンスには初めて参加するのでかねてより心待ちにしていたのだが、生憎2日目から体調を崩してしまい、この記事も途中までとなっている。まだ見ていないセッションも多いが、ひとまず現時点での参加レポを書いておく。

-

発表はトラック A、B に分かれていたのだが、今回はすべて A トラックを視聴している (切り替えるのが面倒だっただけ)。

-

凡例

-
-

発表・スライドのメモ (引用ではない)

-
-

感想など

-

Day 0 前夜祭 (2021/03/27)

-

17:30 [A]

-

PHP で AWS Lambda

-
-

Rails のプロジェクトを PHPer のメンバのみでメンテ -→他のメンバもわかる PHP にリプレースを検討

-

サーバレス

-
    -
  • サーバ・インフラの管理が不要
    • -
  • アプリケーションコードの知識だけで保守可能
    • -
-

ゼロベースで作れる案件が (Railsの件とは別に) あるため、そちらで試験的に導入?

-

AWSの学習 -AWS のドキュメント -DevelopersIO

-

AWS Lambda のカスタムランタイムで PHP を動かす

-

サーバのセットアップや維持管理を気にしなくて良い -サーバーレスで PHP を動かすツールがすでにある -サーバーレス構築はすんなり

-

今は Laravel がルーティングしている -Laravel Livewire を Lambda に載せられないか？ -デプロイ方法は？ -バッチ処理は？ (Lambda は 15分の制限)

-

Lambda でコンテナイメージがサポートされるように

-

抽象化されたもの「だけ」しか知らないよりも具象の理解は助けになる

-
-

AWS Lambda のような Function as a Service はマイクロサービス化における一つの到達点に思えるのだが、これを使って実際に web サービスを作る具体的なイメージがまだ見えない (注: すべて for me として書いている)。

-

PHP on AWS Lambda があれだけ簡単に動かせるのには驚いた。

-

勝手に AWS Lambda だとフットプリントの軽さが求められそう (= PHP + Laravel などでは動かなさそう) だという先入観を持っていたのだが、この発表のデモによればそうでもないらしい。

-

18:10 [A]

-

大規模サイトの SEO

-
-

大規模サイト (100万ページ以上) -Google の基準

-

クロールバジェットを意識したSEO

-

大規模サイトでコンテンツが中頻度 (1回/週) で更新 OR 中規模サイト (10,000以上) でコンテンツが目まぐるしく変更される -これを満たさないなら、クロールバジェットを考えなくてもいい

-

サーチコンソール -「カバレッジ」の「除外」 -多すぎるのは問題→クロールバジェットを浪費している

-
    -
  • クエリの順番を決める
    • -
  • 空の値のルールを決めておく
    • -
  • リダイレクトすればインデックスはうまくいく
    • -
  • リンクが存在する限りクロールはされる
    • -
-

リニューアル前のURL

-

インデックスは移行される -リンクのURLが存在する限り、別のURLとしてクロールされる -リダイレクトされるとはいえ、リニューアル前のURLは移行した方が良い -リニューアルで無視されるようになったパラメータも注意

-

robotes.txt で拒否しているのにクロールされる -一時的に拒否を外して 404 や 301 を読ませる -内部リンクを確認する -JS でのリンクに書き換え

-

クエリパラメータからURLのパスに -/tokyo?area=HOGE → /tokyo/HOGE

-

URL 設計だいじ

-
-

SEO (Search Engine Optimization) は大して知らないので新鮮な話が多かった。その分語れることも少ない……。

-

18:50 [A]

-
-

知覚可能 -操作可能 -理解可能 -堅牢 ちゃんとしたHTMLを書く (閉じタグ・入れ子構造など)

-
    -
  • -

    標準の HTML を適切に使う

    -
    • -
  • -

    WAI-ARIA

    -
    • -
  • -

    キーボードフレンドリー

    -
    • -
  • -

    マシンフレンドリー

    -
    • -
  • -

    SEOフレンドリー

    -
    • -
-

button タグ -→キーボード -h1 タグ -→スクリーンリーダー・クローラ -a タグ

-

WAI-ARIA -HTML では表現できないセマンティクスを追加する

-
    -
  • ロール -
      -
    • 何をするのか？
      • -
    • ユーザーアクションによって変化しない
      • -
    -
    • -
  • プロパティ -
      -
    • 関連づけられたデータ
      • -
    -
    • -
  • ステート -
      -
    • 現在の状態
      • -
    -
    • -
-

まずは標準の HTML 要素で解決する -何でもかんでも WAI-ARIA を使えばいいというものではない

-

マウスホバーでツールチップが出てくるが、キーボード操作では出てこない

-

VoiceOver

-

全ての属性を使う必要はない -あくまでアクセシビリティを上げるための方法の一つにすぎない

-
-

つい最近 WAI-ARIA についての記事を読んだばかりだったので個人的にタイムリーな話題だった。(あまりこの言葉を使いたくないのだが) いわゆる「健常者」にとって、こうした問題を普段の生活の中で意識するのは難しい。だからこそ情報へのアンテナは張っておくようにしたい。

-

19:30 [A]

-

PHP で FUSE

-

個人的に楽しみだった発表。

-
-

VFS (virtual filesystem) vs 具体的なファイルシステム

-

最適な実装方法は状況により異なる

-

アプリケーションに見せるAPIは変えずに実装を隠蔽する→VFS

-

カーネルのプログラムを作るのは難しい

-
    -
  • 権限がデカすぎる
    • -
  • システム全体がクラッシュ
    • -
  • セキュリティリスク
    • -
  • 開発サイクルを回しづらい
    • -
  • ネイティブコードにコンパイルされる言語である必要がある
    • -
-

Filesystem in USEr space (FUSE)

-
    -
  • 特定の C の関数を呼ぶことで filesystem が作れる
    • -
  • FFI を持つ言語なら FUSE が使える
    • -
-

SSHFS / s3fs / Docker Desktop

-

Linux 以外でも使える

-
    -
  • dokany (on Windows)
    • -
  • osxfuse
    • -
-

VFS: システムコールが呼ばれると、ファイルシステムによってコール -FUSE: カーネル空間からユーザ空間へ通信

-

高レベルなラッパで型をつける

-

PHP 以外では Wordpress を FUSE にマウントする実装がある (C, Python など)

-
    -
  • grep できる
    • -
  • sed できる
    • -
  • 編集できる
    • -
-
-

期待通りの興味深い発表だった。FUSE 自体も今回の発表で知ったのだが、これ本体の実装を見るのも面白そうだ。 -この発表を聞きながらファイルシステムにマウントできそうなものを考えていたのだが、およそ木構造をしているものすべてと言えそうだ (ハンマーしか持っていないと云々)。何かできそうだがなかなか思いつかない。

-

Day 1 (2021/03/27)

-

10:50 [A]

-

ATDD

-
-
    -
  • ユーザーストーリー
    • -
  • ユニットテスト
    • -
  • CI/CD
    • -
-

ユーザストーリーの受け入れ条件が曖昧になりがち -デグレチェックがユニットレベルでは収まらない場合、手動で同じシナリオをテストしている

-

Q2の強化 -アジャイルテストの4象限

-

技術面/ビジネス面 -開発チーム支援(コーディング前・コーディング中)/製品批評(コーディング後)

-
    -
  • Q1: 技術面 & チーム支援 -
      -
    • TDD
      • -
    • ユニットテストなど
      • -
    -
    • -
  • Q2: ビジネス面 & チーム支援 -
      -
    • ATDD
      • -
    • ビジネス面の受け入れテストで駆動する
      • -
    -
    • -
-

Agile Alliance -ユーザストーリーのスキルレベルを高める

-

テストピラミッド

-
    -
  • -

    UI Tests

    -
    • -
  • -

    Service Tests

    -
    • -
  • -

    Unit Tests

    -
    • -
  • -

    異なる粒度のテストを書く

    -
    • -
  • -

    高レベルになるほど、持つべきテストは少なくなる

    -
      -
    • ピラミッド型になる
      • -
    -
    • -
-

高レベルテストが多すぎる→アイスクリームコーン　アンチパターン

-

ATDD (Acceptance TDD) -API経由・UI経由での高レベルテスト E2E test

-

ストーリ受け入れテスト

-

入れ子のフィードバックループ -ATDD(外側) と TDD(内側)

-

外部品質・内部品質

-

バーティカルスライスのデリバリー

-
    -
  • cucumber
    • -
  • gauge
    • -
  • behat
    • -
-

ユビキタス言語 -手動テストもspecに書く -自動化は可能だがコスパが悪い -失敗することがわかっているテスト(レッドテスト)はCIから外す -失敗時の原因究明が難しい -饒舌なエラーメッセージ -状況のスナップショット

-

Continuous Testing

-
-

User Acceptance Test (UAT) くらいの規模になると個人開発・趣味開発では触れない領域なので、大いに勉強になった。スライドに添付されている資料が相当に充実していたので、これを読むのが本番といった様相すら感じる。 -高レベルテストの自動化は現在のプロジェクトでも感じており、自動化のチャンスは伺っている。とはいえセッションでも指摘されているように自動化することにコストがかかりすぎる領域があるのも事実で、そのバランスが難しい。

-

11:50 [A]

-

型解析を用いたリファクタリング

-

型のある世界で生きてきた身として大いに楽しみにしていた発表。

-
-
    -
  • PHPStan
    • -
  • Phan
    • -
  • Psalm
    • -
-

autoload も認識できる -bootstrapFiles

-

編集箇所と利用箇所を CI でチェック -ルールレベルを徐々に引き上げていく -警告が多すぎると見落としてしまう・無視されやすくなる

-

型がついていないことによるエラーが多い

-

型よりも詳細な検査 Util_Assert::min

-

SQL を静的解析 -placeholder の型付け

-

警告レベルを低いレベルから導入 -タイプヒントを積極的に書いていく -PHPStan の拡張を追加する

-
-

昨今、動的型付き言語での型宣言・型アノテーション・型ヒントの導入が相次いでいる。長らく静的型付き言語を書いてきた私からすると、ようやく気づいたかといったところだが、ともかく型を導入する言語が増えてきた。 -今のプロジェクトでも新しく追加するコードには型をつけるよう努めているが、どうしても古いコードには型がついていない。個人的には型のないコードに対してどう型を自動的に付けるかという点に興味があり、その点で Ruby の typeprof には注目している。

-

12:30 [A]

-

昼食をとっていた。事前に何か食料を買っておくべきだった。

-

13:10 [A]

-

Documentation as Code

-

この発表も以前から非常に楽しみにしていた。

-
-

開発開始までのオーバーヘッド -新規にチームにジョイン -担当範囲外の機能を理解 -オンボーディングのコスト

-

PHPerKaigi 2020 で発表あり

-

継続的にシステムの理解を助けるドキュメント

-

継続的ドキュメンテーション -システムとドキュメントの乖離

-

書いてあることが間違っている・足りない

-
    -
  • 徐々にずれていく
    • -
  • システムの更新タイミングとドキュメントの更新タイミングに差がある
    • -
-

システムとドキュメントは対応関係がある

-
    -
  • 間違ったドキュメント
    • -
  • 存在しないドキュメント
    • -
-

システムとドキュメントの乖離を定量化する -継続的に -システムの更新に近いタイミングで ドキュメントを更新し続ける

-

Documentation as Code

-

コードと同じツールでドキュメントを書く

-
    -
  • issue tracker
    • -
  • vcs
    • -
  • plain text markup
    • -
  • automation
    • -
-

開発者 -システム -ドキュメント -構造化データ -ソフトウェア

-

システムから構造化データを抽出する -PHPDoc -OpenAPI

-

ビュー 関心ごとに合わせてアーキテクチャを一つ以上の側面(断面)で説明する

-

ビューの単位でドキュメントに

-

スタックトレースからのドキュメント生成

-
-

ドキュメントの管理は現プロジェクトでも課題と感じている。作られた当初は正しくても、実態と乖離していくのを止めるのは困難を極める。全体的に興味深い発表だったが、特にスタックトレースからのドキュメント生成というアイデアに惹かれるものを感じた。スタックトレースという実態と不可分な (乖離しない) 情報を起点にするのは理にかなっている。問題はトレースをいつ、どう取るかだろうか。それを自動化しなければ、実態との乖離が避けられないだろう。

-

14:10 [A]

-

cookie による session 管理

-

全体的に基本的な話だったので特に触れない。Cookie やセッションの話としては非常に分かりやすくまとめられていたので、知らない人が学ぶにはいい教材だろう。

-

14:50 [A]

-

PHP のエラーと例外

-
-

エラー PHPエンジンがエラーを通知する -例外 プログラムが投げる

-

PHP7-8とエラー

-

PHPエンジンのエラーの一部が \Error に変換されるようになった -→ try-catch で捕捉できる

-

\Error は例外とは異なる

-

PHP8 でエラーレベルの引き上げ

-
    -
  • 捕捉すべきもの -
      -
    • recoverable
      • -
    -
    • -
  • 捕捉すべきでないもの -
      -
    • unrecoverable
      • -
    • 開発時に対処できるもの
      • -
    -
    • -
-

例外

-
    -
  • 捕捉して事後処理
    • -
  • 捕捉せず(or 捕捉した上で)さらに上に是非を問う
    • -
-

開発段階で例外を把握し、ハンドリングを考えておく

-

\Throwable \Exception と \Error

-

\Error はキャッチすべきでない

-
    -
  • -

    \Error

    -
      -
    • 本番で起きてはいけない
      • -
    -
    • -
  • -

    \LogicException

    -
      -
    • 本番で起きてはいけない -→生じないのだから捕捉もしない
      • -
    -
    • -
  • -

    \RuntimeException

    -
      -
    • 起こるかもしれないので本番環境でも考慮する
      • -
    -
    • -
-

捕捉して対応するのではなく、未然に防ぐ

-

独自例外を使う -\Exception を投げてしまうと、 -catch (\Exception)せざるを得ない -→catch 範囲が広すぎる

-

SPL の例外を使う

-

例外翻訳 -上位のレイヤが下位のレイヤの例外を捕捉し、上位レイヤのAPIに「翻訳」する -下位レイヤの知識に依存させない

-

@throws -捕捉してほしい例外を書き連ねておく

-

呼び出しもとに負わせたい責任

-
-

PHP を学んでいる途中の私としては、今まさに聞きたい発表だった (現時点で PHP を書き始めてから 4ヶ月ほどになる)。

-

個人的に例外やエラーを最もうまく扱っているのは Go、Swift、Rust、Haskell などのエラーを「値として」扱う言語だと思っている。try-catch は通常の処理フローを完全に壊してしまう上、構文としても重すぎる。値としてのエラー通知は C言語時代への回帰ともいえるが、その頃と異なるのはエラーを暗黙のうちに握り潰すことがないということだ。これらの言語は型を持っており、静的に検証ができる (C のそれはまともな型付けではない。念のため)。

-

PHP のように、すでに例外が言語システムに根ざしている言語ではどうすればよいか。この場合も同じく静的検証の力を借りることになるだろう。

-

15:30 [A]

-

Laravel のメール認証

-

Laravel の知識がない私にはまったくついていけなかった。また、個人的にタイトルがややミスリーディングに感じた。

-

16:10 [A]

-

gRPC

-
-

Unary RPCs -Server streaming RPCs -Client streaming RPCs -Bidirectional streaming RPCs

-

Protobuf

-

実装とAPIが乖離しにくい -自動生成 -複数言語でも相互に使える

-

マイクロサービスのサービス通信 -スマホアプリ -ゲームサーバ

-

PHP では？

-

PHP ではストリーミングが難しい -リクエストごとにプロセスが使い捨て

-

PHP ではgRPCのクライアントしか対応していない

-

gRPC-Web -ブラウザで扱うためのJSライブラリ+プロトコル

-

HTTP/1.1 でも使える -Unary RPC と Server streaming RPC のみ

-

Envoy -Nginx などで相互に gRPC と gRPC-Web で変換

-

Amp -イベント駆動な並行処理のフレームワーク

-

HTTP/2 対応

-

C#のgRPC-Webが楽

-
-

(発表の中でもまさに同じことをおっしゃっていたが) PHP 以外の方が向いているだろう、というのが第一の感想である。gRPC はそれ自体というよりも Protobuf というエコシステムに乗れることのメリットが大きいと感じる。そのエコシステムにうまく乗れない時点で、うーんという感じ。

-

16:50 [A]

-

アーキテクチャテスト

-
-

Independent Core Layer Pattern

-

開発初期のアーキテクチャが崩れる -アーキテクチャ観点のコードレビューができない

-

どこにクラスを置けばよいか？ -ドキュメントがない

-

アーキテクチャ設計に関する知識が属人化・暗黙知化

-

ガイドライン

-
    -
  • 最初にルールを決めるのは簡単
    • -
  • ルール通り作り始めるのも簡単 -
      -
    • →維持するのが難しい、人が決めたものゆえ壊れやすい
      • -
    -
    • -
-

PHP の特性

-
    -
  • クラスは public
    • -
  • 可視性の制御が public / protected / private のみ
    • -
  • 依存関係の制御が困難
    • -
-

アーキテクチャテスト -クラスの依存関係や実装ルールをコードとして表現し、自動テスト化する

-
    -
  • deptrac
    • -
  • phpat
    • -
-

Independent Core Layer Pattern

-

アーキテクチャテストの失敗

-
    -
  • 実装誤り
    • -
  • or アーキテクチャが適切でない -
      -
    • 開発の過程でフィードバックしていく
      • -
    -
    • -
-

モジュラーモノリス→マイクロサービスへ

-
-

Day 2 (2021/03/28)

-

冒頭に書いた通り、2日目から体調が悪くまともに聴けていない。途中までは頭痛を我慢しつつ見ていたのだが、まともに入ってこなかった。

-

残念ではあるが、いずれにせよ見られていない発表は他にもあるので、今週末にでもまとめて見ようと思う。

-

全体の感想

-

Day 2 にほとんど参加できなかったのは残念だが、イベント自体は大変楽しく、また興味深いものであった。自分がまったく知らない領域の話を聞けるのはこうしたイベントならではだと感じる。オンライン開催ゆえ現地に行く必要がなく、気軽に参加できたのも (特に初参加者として) 嬉しいポイントだった。

-

今回、雑談/登壇者への質問等向けに Discord サーバもあったのだが、こちらは参加こそしたものの ROM のままになってしまった。発表に1ウィンドウ、メモを書くのに1ウィンドウ、Discord 表示に 1ウィンドウで私にはもう脳のリソースとディスプレイのスペースが追いつかなかった (さらにいうと Zoom でアンカンファレンスもやっていたようだ。こちらはまったく参加していない)。

-

1つ個人的な反省点としては、一つ一つのセッションを真剣に聞き過ぎたというものがある。もっと適当に聞いておけばよかった。これだけだと大変語弊があるのだが、言い方を変えると、Discord しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。 -まあ初カンファレンスだし、とお茶を濁しておこう。

-

さて、カンファレンスで一つ気になったことがある。それは、Discord という書き込み場所が増えたことでニコ生のコメントの流量が吸い取られてしまったのではないか、という点だ。ニコニコだけ見ていると過疎っているかのように見えた発表も、Discord の方では盛り上がっている、というのを何度か見かけた。ニコニコのコメント方式は盛り上がりを如実に反映するが、逆もまたしかり。Discord があったこと自体はプラスだったと思うが、この点はマイナスだったのではないかと感じる。

-
-

最後になりましたが、毎年の PHPerKaigi 開催にご尽力されている皆様、スピーカーの皆様、楽しい3日間でした。ありがとうございました！ -(ずっと常体で書いてしまったのでいきなり仏頂面から笑顔になったようで気持ち悪い)

-

ではまた来年。

-]]> - - - - My First Post - https://blog.nsfisis.dev/posts/2021-03-05/my-first-post/ - Fri, 05 Mar 2021 23:38:21 +0900 - - https://blog.nsfisis.dev/posts/2021-03-05/my-first-post/ - Test -

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

-]]> - - - - diff --git a/docs/highlight.min.js b/docs/highlight.min.js deleted file mode 100644 index ce50ad7..0000000 --- a/docs/highlight.min.js +++ /dev/null @@ -1,1122 +0,0 @@ -/*! - Highlight.js v11.0.0-beta1 (git: bc7ef3d912) - (c) 2006-2021 Ivan Sagalaev and other contributors - License: BSD-3-Clause - */ -var hljs=function(){"use strict";var e={exports:{}};function n(e){ -return e instanceof Map?e.clear=e.delete=e.set=()=>{ -throw Error("map is read-only")}:e instanceof Set&&(e.add=e.clear=e.delete=()=>{ -throw Error("set is read-only") -}),Object.freeze(e),Object.getOwnPropertyNames(e).forEach((t=>{var a=e[t] -;"object"!=typeof a||Object.isFrozen(a)||n(a)})),e} -e.exports=n,e.exports.default=n;var t=e.exports;class a{constructor(e){ -void 0===e.data&&(e.data={}),this.data=e.data,this.isMatchIgnored=!1} -ignoreMatch(){this.isMatchIgnored=!0}}function i(e){ -return e.replace(/&/g,"&").replace(//g,">").replace(/"/g,""").replace(/'/g,"'") -}function s(e,...n){const t=Object.create(null);for(const n in e)t[n]=e[n] -;return n.forEach((e=>{for(const n in e)t[n]=e[n]})),t}const r=e=>!!e.kind -;class o{constructor(e,n){ -this.buffer="",this.classPrefix=n.classPrefix,e.walk(this)}addText(e){ -this.buffer+=i(e)}openNode(e){if(!r(e))return;let n=e.kind -;n=e.sublanguage?"language-"+n:((e,{prefix:n})=>{if(e.includes(".")){ -const t=e.split(".") -;return[`${n}${t.shift()}`,...t.map(((e,n)=>`${e}${"_".repeat(n+1)}`))].join(" ") -}return`${n}${e}`})(n,{prefix:this.classPrefix}),this.span(n)}closeNode(e){ -r(e)&&(this.buffer+="")}value(){return this.buffer}span(e){ -this.buffer+=``}}class l{constructor(){this.rootNode={ -children:[]},this.stack=[this.rootNode]}get top(){ -return this.stack[this.stack.length-1]}get root(){return this.rootNode}add(e){ -this.top.children.push(e)}openNode(e){const n={kind:e,children:[]} -;this.add(n),this.stack.push(n)}closeNode(){ -if(this.stack.length>1)return this.stack.pop()}closeAllNodes(){ -for(;this.closeNode(););}toJSON(){return JSON.stringify(this.rootNode,null,4)} -walk(e){return this.constructor._walk(e,this.rootNode)}static _walk(e,n){ -return"string"==typeof n?e.addText(n):n.children&&(e.openNode(n), -n.children.forEach((n=>this._walk(e,n))),e.closeNode(n)),e}static _collapse(e){ -"string"!=typeof e&&e.children&&(e.children.every((e=>"string"==typeof e))?e.children=[e.children.join("")]:e.children.forEach((e=>{ -l._collapse(e)})))}}class c extends l{constructor(e){super(),this.options=e} -addKeyword(e,n){""!==e&&(this.openNode(n),this.addText(e),this.closeNode())} -addText(e){""!==e&&this.add(e)}addSublanguage(e,n){const t=e.root -;t.kind=n,t.sublanguage=!0,this.add(t)}toHTML(){ -return new o(this,this.options).value()}finalize(){return!0}}function d(e){ -return e?"string"==typeof e?e:e.source:null}function g(e){return b("(?=",e,")")} -function u(e){return b("(?:",e,")?")}function b(...e){ -return e.map((e=>d(e))).join("")}function m(...e){return"("+((e=>{ -const n=e[e.length-1] -;return"object"==typeof n&&n.constructor===Object?(e.splice(e.length-1,1),n):{} -})(e).capture?"":"?:")+e.map((e=>d(e))).join("|")+")"}function p(e){ -return RegExp(e.toString()+"|").exec("").length-1} -const _=/\[(?:[^\\\]]|\\.)*\]|\(\??|\\([1-9][0-9]*)|\\./ -;function f(e,{joinWith:n}){let t=0;return e.map((e=>{t+=1;const n=t -;let a=d(e),i="";for(;a.length>0;){const e=_.exec(a);if(!e){i+=a;break} -i+=a.substring(0,e.index), -a=a.substring(e.index+e[0].length),"\\"===e[0][0]&&e[1]?i+="\\"+(Number(e[1])+n):(i+=e[0], -"("===e[0]&&t++)}return i})).map((e=>`(${e})`)).join(n)} -const h="[a-zA-Z]\\w*",E="[a-zA-Z_]\\w*",y="\\b\\d+(\\.\\d+)?",N="(-?)(\\b0[xX][a-fA-F0-9]+|(\\b\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?)",w="\\b(0b[01]+)",v={ -begin:"\\\\[\\s\\S]",relevance:0},O={scope:"string",begin:"'",end:"'", -illegal:"\\n",contains:[v]},M={scope:"string",begin:'"',end:'"',illegal:"\\n", -contains:[v]},x=(e,n,t={})=>{const a=s({scope:"comment",begin:e,end:n, -contains:[]},t);a.contains.push({scope:"doctag", -begin:"[ ]*(?=(TODO|FIXME|NOTE|BUG|OPTIMIZE|HACK|XXX):)", -end:/(TODO|FIXME|NOTE|BUG|OPTIMIZE|HACK|XXX):/,excludeBegin:!0,relevance:0}) -;const i=m("I","a","is","so","us","to","at","if","in","it","on",/[A-Za-z]+['](d|ve|re|ll|t|s|n)/,/[A-Za-z]+[-][a-z]+/,/[A-Za-z][a-z]{2,}/) -;return a.contains.push({begin:b(/[ ]+/,"(",i,/[.]?[:]?([.][ ]|[ ])/,"){3}")}),a -},S=x("//","$"),k=x("/\\*","\\*/"),A=x("#","$");var C=Object.freeze({ -__proto__:null,MATCH_NOTHING_RE:/\b\B/,IDENT_RE:h,UNDERSCORE_IDENT_RE:E, -NUMBER_RE:y,C_NUMBER_RE:N,BINARY_NUMBER_RE:w, -RE_STARTERS_RE:"!|!=|!==|%|%=|&|&&|&=|\\*|\\*=|\\+|\\+=|,|-|-=|/=|/|:|;|<<|<<=|<=|<|===|==|=|>>>=|>>=|>=|>>>|>>|>|\\?|\\[|\\{|\\(|\\^|\\^=|\\||\\|=|\\|\\||~", -SHEBANG:(e={})=>{const n=/^#![ ]*\// -;return e.binary&&(e.begin=b(n,/.*\b/,e.binary,/\b.*/)),s({scope:"meta",begin:n, -end:/$/,relevance:0,"on:begin":(e,n)=>{0!==e.index&&n.ignoreMatch()}},e)}, -BACKSLASH_ESCAPE:v,APOS_STRING_MODE:O,QUOTE_STRING_MODE:M,PHRASAL_WORDS_MODE:{ -begin:/\b(a|an|the|are|I'm|isn't|don't|doesn't|won't|but|just|should|pretty|simply|enough|gonna|going|wtf|so|such|will|you|your|they|like|more)\b/ -},COMMENT:x,C_LINE_COMMENT_MODE:S,C_BLOCK_COMMENT_MODE:k,HASH_COMMENT_MODE:A, -NUMBER_MODE:{scope:"number",begin:y,relevance:0},C_NUMBER_MODE:{scope:"number", -begin:N,relevance:0},BINARY_NUMBER_MODE:{scope:"number",begin:w,relevance:0}, -REGEXP_MODE:{begin:/(?=\/[^/\n]*\/)/,contains:[{scope:"regexp",begin:/\//, -end:/\/[gimuy]*/,illegal:/\n/,contains:[v,{begin:/\[/,end:/\]/,relevance:0, -contains:[v]}]}]},TITLE_MODE:{scope:"title",begin:h,relevance:0}, -UNDERSCORE_TITLE_MODE:{scope:"title",begin:E,relevance:0},METHOD_GUARD:{ -begin:"\\.\\s*[a-zA-Z_]\\w*",relevance:0},END_SAME_AS_BEGIN:e=>Object.assign(e,{ -"on:begin":(e,n)=>{n.data._beginMatch=e[1]},"on:end":(e,n)=>{ -n.data._beginMatch!==e[1]&&n.ignoreMatch()}})});function T(e,n){ -"."===e.input[e.index-1]&&n.ignoreMatch()}function R(e,n){ -void 0!==e.className&&(e.scope=e.className,delete e.className)}function D(e,n){ -n&&e.beginKeywords&&(e.begin="\\b("+e.beginKeywords.split(" ").join("|")+")(?!\\.)(?=\\b|\\s)", -e.__beforeBegin=T,e.keywords=e.keywords||e.beginKeywords,delete e.beginKeywords, -void 0===e.relevance&&(e.relevance=0))}function I(e,n){ -Array.isArray(e.illegal)&&(e.illegal=m(...e.illegal))}function B(e,n){ -if(e.match){ -if(e.begin||e.end)throw Error("begin & end are not supported with match") -;e.begin=e.match,delete e.match}}function L(e,n){ -void 0===e.relevance&&(e.relevance=1)}const $=(e,n)=>{if(!e.beforeMatch)return -;if(e.starts)throw Error("beforeMatch cannot be used with starts") -;const t=Object.assign({},e);Object.keys(e).forEach((n=>{delete e[n] -})),e.keywords=t.keywords,e.begin=b(t.beforeMatch,g(t.begin)),e.starts={ -relevance:0,contains:[Object.assign(t,{endsParent:!0})] -},e.relevance=0,delete t.beforeMatch -},z=["of","and","for","in","not","or","if","then","parent","list","value"] -;function F(e,n,t="keyword"){const a=Object.create(null) -;return"string"==typeof e?i(t,e.split(" ")):Array.isArray(e)?i(t,e):Object.keys(e).forEach((t=>{ -Object.assign(a,F(e[t],n,t))})),a;function i(e,t){ -n&&(t=t.map((e=>e.toLowerCase()))),t.forEach((n=>{const t=n.split("|") -;a[t[0]]=[e,j(t[0],t[1])]}))}}function j(e,n){ -return n?Number(n):(e=>z.includes(e.toLowerCase()))(e)?0:1}const U={},P=e=>{ -console.error(e)},K=(e,...n)=>{console.log("WARN: "+e,...n)},q=(e,n)=>{ -U[`${e}/${n}`]||(console.log(`Deprecated as of ${e}. ${n}`),U[`${e}/${n}`]=!0) -},H=Error();function Z(e,n,{key:t}){let a=0;const i=e[t],s={},r={} -;for(let e=1;e<=n.length;e++)r[e+a]=i[e],s[e+a]=!0,a+=p(n[e-1]) -;e[t]=r,e[t]._emit=s,e[t]._multi=!0}function G(e){(e=>{ -e.scope&&"object"==typeof e.scope&&null!==e.scope&&(e.beginScope=e.scope, -delete e.scope)})(e),"string"==typeof e.beginScope&&(e.beginScope={ -_wrap:e.beginScope}),"string"==typeof e.endScope&&(e.endScope={_wrap:e.endScope -}),(e=>{if(Array.isArray(e.begin)){ -if(e.skip||e.excludeBegin||e.returnBegin)throw P("skip, excludeBegin, returnBegin not compatible with beginScope: {}"), -H -;if("object"!=typeof e.beginScope||null===e.beginScope)throw P("beginScope must be object"), -H;Z(e,e.begin,{key:"beginScope"}),e.begin=f(e.begin,{joinWith:""})}})(e),(e=>{ -if(Array.isArray(e.end)){ -if(e.skip||e.excludeEnd||e.returnEnd)throw P("skip, excludeEnd, returnEnd not compatible with endScope: {}"), -H -;if("object"!=typeof e.endScope||null===e.endScope)throw P("endScope must be object"), -H;Z(e,e.end,{key:"endScope"}),e.end=f(e.end,{joinWith:""})}})(e)}function W(e){ -function n(n,t){return RegExp(d(n),"m"+(e.case_insensitive?"i":"")+(t?"g":""))} -class t{constructor(){ -this.matchIndexes={},this.regexes=[],this.matchAt=1,this.position=0} -addRule(e,n){ -n.position=this.position++,this.matchIndexes[this.matchAt]=n,this.regexes.push([n,e]), -this.matchAt+=p(e)+1}compile(){0===this.regexes.length&&(this.exec=()=>null) -;const e=this.regexes.map((e=>e[1]));this.matcherRe=n(f(e,{joinWith:"|" -}),!0),this.lastIndex=0}exec(e){this.matcherRe.lastIndex=this.lastIndex -;const n=this.matcherRe.exec(e);if(!n)return null -;const t=n.findIndex(((e,n)=>n>0&&void 0!==e)),a=this.matchIndexes[t] -;return n.splice(0,t),Object.assign(n,a)}}class a{constructor(){ -this.rules=[],this.multiRegexes=[], -this.count=0,this.lastIndex=0,this.regexIndex=0}getMatcher(e){ -if(this.multiRegexes[e])return this.multiRegexes[e];const n=new t -;return this.rules.slice(e).forEach((([e,t])=>n.addRule(e,t))), -n.compile(),this.multiRegexes[e]=n,n}resumingScanAtSamePosition(){ -return 0!==this.regexIndex}considerAll(){this.regexIndex=0}addRule(e,n){ -this.rules.push([e,n]),"begin"===n.type&&this.count++}exec(e){ -const n=this.getMatcher(this.regexIndex);n.lastIndex=this.lastIndex -;let t=n.exec(e) -;if(this.resumingScanAtSamePosition())if(t&&t.index===this.lastIndex);else{ -const n=this.getMatcher(0);n.lastIndex=this.lastIndex+1,t=n.exec(e)} -return t&&(this.regexIndex+=t.position+1, -this.regexIndex===this.count&&this.considerAll()),t}} -if(e.compilerExtensions||(e.compilerExtensions=[]), -e.contains&&e.contains.includes("self"))throw Error("ERR: contains `self` is not supported at the top-level of a language. See documentation.") -;return e.classNameAliases=s(e.classNameAliases||{}),function t(i,r){const o=i -;if(i.isCompiled)return o -;[R,B,G,$].forEach((e=>e(i,r))),e.compilerExtensions.forEach((e=>e(i,r))), -i.__beforeBegin=null,[D,I,L].forEach((e=>e(i,r))),i.isCompiled=!0;let l=null -;return"object"==typeof i.keywords&&i.keywords.$pattern&&(i.keywords=Object.assign({},i.keywords), -l=i.keywords.$pattern, -delete i.keywords.$pattern),l=l||/\w+/,i.keywords&&(i.keywords=F(i.keywords,e.case_insensitive)), -o.keywordPatternRe=n(l,!0), -r&&(i.begin||(i.begin=/\B|\b/),o.beginRe=n(i.begin),i.end||i.endsWithParent||(i.end=/\B|\b/), -i.end&&(o.endRe=n(i.end)), -o.terminatorEnd=d(i.end)||"",i.endsWithParent&&r.terminatorEnd&&(o.terminatorEnd+=(i.end?"|":"")+r.terminatorEnd)), -i.illegal&&(o.illegalRe=n(i.illegal)), -i.contains||(i.contains=[]),i.contains=[].concat(...i.contains.map((e=>(e=>(e.variants&&!e.cachedVariants&&(e.cachedVariants=e.variants.map((n=>s(e,{ -variants:null},n)))),e.cachedVariants?e.cachedVariants:Q(e)?s(e,{ -starts:e.starts?s(e.starts):null -}):Object.isFrozen(e)?s(e):e))("self"===e?i:e)))),i.contains.forEach((e=>{t(e,o) -})),i.starts&&t(i.starts,r),o.matcher=(e=>{const n=new a -;return e.contains.forEach((e=>n.addRule(e.begin,{rule:e,type:"begin" -}))),e.terminatorEnd&&n.addRule(e.terminatorEnd,{type:"end" -}),e.illegal&&n.addRule(e.illegal,{type:"illegal"}),n})(o),o}(e)}function Q(e){ -return!!e&&(e.endsWithParent||Q(e.starts))}const X=i,V=s,J=Symbol("nomatch") -;var Y=(e=>{const n=Object.create(null),i=Object.create(null),s=[];let r=!0 -;const o="Could not find the language '{}', did you forget to load/include a language module?",l={ -disableAutodetect:!0,name:"Plain text",contains:[]};let d={ -ignoreUnescapedHTML:!1,noHighlightRe:/^(no-?highlight)$/i, -languageDetectRe:/\blang(?:uage)?-([\w-]+)\b/i,classPrefix:"hljs-", -cssSelector:"pre code",languages:null,__emitter:c};function g(e){ -return d.noHighlightRe.test(e)}function u(e,n,t,a){let i="",s="" -;"object"==typeof n?(i=e, -t=n.ignoreIllegals,s=n.language,a=void 0):(q("10.7.0","highlight(lang, code, ...args) has been deprecated."), -q("10.7.0","Please use highlight(code, options) instead.\nhttps://github.com/highlightjs/highlight.js/issues/2277"), -s=e,i=n),void 0===t&&(t=!0);const r={code:i,language:s};N("before:highlight",r) -;const o=r.result?r.result:b(r.language,r.code,t,a) -;return o.code=r.code,N("after:highlight",o),o}function b(e,t,i,s){ -const l=Object.create(null);function c(){if(!M.keywords)return void S.addText(k) -;let e=0;M.keywordPatternRe.lastIndex=0;let n=M.keywordPatternRe.exec(k),t="" -;for(;n;){t+=k.substring(e,n.index) -;const i=w.case_insensitive?n[0].toLowerCase():n[0],s=(a=i,M.keywords[a]);if(s){ -const[e,a]=s -;if(S.addText(t),t="",l[i]=(l[i]||0)+1,l[i]<=7&&(A+=a),e.startsWith("_"))t+=n[0];else{ -const t=w.classNameAliases[e]||e;S.addKeyword(n[0],t)}}else t+=n[0] -;e=M.keywordPatternRe.lastIndex,n=M.keywordPatternRe.exec(k)}var a -;t+=k.substr(e),S.addText(t)}function g(){null!=M.subLanguage?(()=>{ -if(""===k)return;let e=null;if("string"==typeof M.subLanguage){ -if(!n[M.subLanguage])return void S.addText(k) -;e=b(M.subLanguage,k,!0,x[M.subLanguage]),x[M.subLanguage]=e._top -}else e=m(k,M.subLanguage.length?M.subLanguage:null) -;M.relevance>0&&(A+=e.relevance),S.addSublanguage(e._emitter,e.language) -})():c(),k=""}function u(e,n){let t=1;for(;void 0!==n[t];){if(!e._emit[t]){t++ -;continue}const a=w.classNameAliases[e[t]]||e[t],i=n[t] -;a?S.addKeyword(i,a):(k=i,c(),k=""),t++}}function p(e,n){ -return e.scope&&"string"==typeof e.scope&&S.openNode(w.classNameAliases[e.scope]||e.scope), -e.beginScope&&(e.beginScope._wrap?(S.addKeyword(k,w.classNameAliases[e.beginScope._wrap]||e.beginScope._wrap), -k=""):e.beginScope._multi&&(u(e.beginScope,n),k="")),M=Object.create(e,{parent:{ -value:M}}),M}function _(e,n,t){let i=((e,n)=>{const t=e&&e.exec(n) -;return t&&0===t.index})(e.endRe,t);if(i){if(e["on:end"]){const t=new a(e) -;e["on:end"](n,t),t.isMatchIgnored&&(i=!1)}if(i){ -for(;e.endsParent&&e.parent;)e=e.parent;return e}} -if(e.endsWithParent)return _(e.parent,n,t)}function f(e){ -return 0===M.matcher.regexIndex?(k+=e[0],1):(R=!0,0)}function E(e){ -const n=e[0],a=t.substr(e.index),i=_(M,e,a);if(!i)return J;const s=M -;M.endScope&&M.endScope._wrap?(g(), -S.addKeyword(n,M.endScope._wrap)):M.endScope&&M.endScope._multi?(g(), -u(M.endScope,e)):s.skip?k+=n:(s.returnEnd||s.excludeEnd||(k+=n), -g(),s.excludeEnd&&(k=n));do{ -M.scope&&!M.isMultiClass&&S.closeNode(),M.skip||M.subLanguage||(A+=M.relevance), -M=M.parent}while(M!==i.parent) -;return i.starts&&p(i.starts,e),s.returnEnd?0:n.length}let y={};function N(n,s){ -const o=s&&s[0];if(k+=n,null==o)return g(),0 -;if("begin"===y.type&&"end"===s.type&&y.index===s.index&&""===o){ -if(k+=t.slice(s.index,s.index+1),!r){const n=Error(`0 width match regex (${e})`) -;throw n.languageName=e,n.badRule=y.rule,n}return 1} -if(y=s,"begin"===s.type)return(e=>{ -const n=e[0],t=e.rule,i=new a(t),s=[t.__beforeBegin,t["on:begin"]] -;for(const t of s)if(t&&(t(e,i),i.isMatchIgnored))return f(n) -;return t.skip?k+=n:(t.excludeBegin&&(k+=n), -g(),t.returnBegin||t.excludeBegin||(k=n)),p(t,e),t.returnBegin?0:n.length})(s) -;if("illegal"===s.type&&!i){ -const e=Error('Illegal lexeme "'+o+'" for mode "'+(M.scope||"")+'"') -;throw e.mode=M,e}if("end"===s.type){const e=E(s);if(e!==J)return e} -if("illegal"===s.type&&""===o)return 1 -;if(T>1e5&&T>3*s.index)throw Error("potential infinite loop, way more iterations than matches") -;return k+=o,o.length}const w=h(e) -;if(!w)throw P(o.replace("{}",e)),Error('Unknown language: "'+e+'"') -;const v=W(w);let O="",M=s||v;const x={},S=new d.__emitter(d);(()=>{const e=[] -;for(let n=M;n!==w;n=n.parent)n.scope&&e.unshift(n.scope) -;e.forEach((e=>S.openNode(e)))})();let k="",A=0,C=0,T=0,R=!1;try{ -for(M.matcher.considerAll();;){ -T++,R?R=!1:M.matcher.considerAll(),M.matcher.lastIndex=C -;const e=M.matcher.exec(t);if(!e)break;const n=N(t.substring(C,e.index),e) -;C=e.index+n}return N(t.substr(C)),S.closeAllNodes(),S.finalize(),O=S.toHTML(),{ -language:e,value:O,relevance:A,illegal:!1,_emitter:S,_top:M}}catch(n){ -if(n.message&&n.message.includes("Illegal"))return{language:e,value:X(t), -illegal:!0,relevance:0,_illegalBy:{message:n.message,index:C, -context:t.slice(C-100,C+100),mode:n.mode,resultSoFar:O},_emitter:S};if(r)return{ -language:e,value:X(t),illegal:!1,relevance:0,errorRaised:n,_emitter:S,_top:M} -;throw n}}function m(e,t){t=t||d.languages||Object.keys(n);const a=(e=>{ -const n={value:X(e),illegal:!1,relevance:0,_top:l,_emitter:new d.__emitter(d)} -;return n._emitter.addText(e),n})(e),i=t.filter(h).filter(y).map((n=>b(n,e,!1))) -;i.unshift(a);const s=i.sort(((e,n)=>{ -if(e.relevance!==n.relevance)return n.relevance-e.relevance -;if(e.language&&n.language){if(h(e.language).supersetOf===n.language)return 1 -;if(h(n.language).supersetOf===e.language)return-1}return 0})),[r,o]=s,c=r -;return c.secondBest=o,c}function p(e){let n=null;const t=(e=>{ -let n=e.className+" ";n+=e.parentNode?e.parentNode.className:"" -;const t=d.languageDetectRe.exec(n);if(t){const n=h(t[1]) -;return n||(K(o.replace("{}",t[1])), -K("Falling back to no-highlight mode for this block.",e)),n?t[1]:"no-highlight"} -return n.split(/\s+/).find((e=>g(e)||h(e)))})(e);if(g(t))return -;N("before:highlightElement",{el:e,language:t -}),!d.ignoreUnescapedHTML&&e.children.length>0&&(console.warn("One of your code blocks includes unescaped HTML. This is a potentially serious security risk."), -console.warn("https://github.com/highlightjs/highlight.js/issues/2886"), -console.warn(e)),n=e;const a=n.textContent,s=t?u(a,{language:t,ignoreIllegals:!0 -}):m(a);N("after:highlightElement",{el:e,result:s,text:a -}),e.innerHTML=s.value,((e,n,t)=>{const a=n&&i[n]||t -;e.classList.add("hljs"),e.classList.add("language-"+a) -})(e,t,s.language),e.result={language:s.language,re:s.relevance, -relevance:s.relevance},s.secondBest&&(e.secondBest={ -language:s.secondBest.language,relevance:s.secondBest.relevance})}let _=!1 -;function f(){ -"loading"!==document.readyState?document.querySelectorAll(d.cssSelector).forEach(p):_=!0 -}function h(e){return e=(e||"").toLowerCase(),n[e]||n[i[e]]} -function E(e,{languageName:n}){"string"==typeof e&&(e=[e]),e.forEach((e=>{ -i[e.toLowerCase()]=n}))}function y(e){const n=h(e) -;return n&&!n.disableAutodetect}function N(e,n){const t=e;s.forEach((e=>{ -e[t]&&e[t](n)}))} -"undefined"!=typeof window&&window.addEventListener&&window.addEventListener("DOMContentLoaded",(()=>{ -_&&f()}),!1),Object.assign(e,{highlight:u,highlightAuto:m,highlightAll:f, -highlightElement:p, -highlightBlock:e=>(q("10.7.0","highlightBlock will be removed entirely in v12.0"), -q("10.7.0","Please use highlightElement now."),p(e)),configure:e=>{d=V(d,e)}, -initHighlighting:()=>{ -f(),q("10.6.0","initHighlighting() deprecated. Use highlightAll() now.")}, -initHighlightingOnLoad:()=>{ -f(),q("10.6.0","initHighlightingOnLoad() deprecated. Use highlightAll() now.") -},registerLanguage:(t,a)=>{let i=null;try{i=a(e)}catch(e){ -if(P("Language definition for '{}' could not be registered.".replace("{}",t)), -!r)throw e;P(e),i=l} -i.name||(i.name=t),n[t]=i,i.rawDefinition=a.bind(null,e),i.aliases&&E(i.aliases,{ -languageName:t})},unregisterLanguage:e=>{delete n[e] -;for(const n of Object.keys(i))i[n]===e&&delete i[n]}, -listLanguages:()=>Object.keys(n),getLanguage:h,registerAliases:E, -autoDetection:y,inherit:V,addPlugin:e=>{(e=>{ -e["before:highlightBlock"]&&!e["before:highlightElement"]&&(e["before:highlightElement"]=n=>{ -e["before:highlightBlock"](Object.assign({block:n.el},n)) -}),e["after:highlightBlock"]&&!e["after:highlightElement"]&&(e["after:highlightElement"]=n=>{ -e["after:highlightBlock"](Object.assign({block:n.el},n))})})(e),s.push(e)} -}),e.debugMode=()=>{r=!1},e.safeMode=()=>{r=!0},e.versionString="11.0.0-beta1" -;for(const e in C)"object"==typeof C[e]&&t(C[e]);return Object.assign(e,C),e -})({});const ee=e=>({IMPORTANT:{scope:"meta",begin:"!important"},HEXCOLOR:{ -scope:"number",begin:"#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})"}, -ATTRIBUTE_SELECTOR_MODE:{scope:"selector-attr",begin:/\[/,end:/\]/,illegal:"$", -contains:[e.APOS_STRING_MODE,e.QUOTE_STRING_MODE]},CSS_NUMBER_MODE:{ -scope:"number", -begin:e.NUMBER_RE+"(%|em|ex|ch|rem|vw|vh|vmin|vmax|cm|mm|in|pt|pc|px|deg|grad|rad|turn|s|ms|Hz|kHz|dpi|dpcm|dppx)?", -relevance:0} -}),ne=["a","abbr","address","article","aside","audio","b","blockquote","body","button","canvas","caption","cite","code","dd","del","details","dfn","div","dl","dt","em","fieldset","figcaption","figure","footer","form","h1","h2","h3","h4","h5","h6","header","hgroup","html","i","iframe","img","input","ins","kbd","label","legend","li","main","mark","menu","nav","object","ol","p","q","quote","samp","section","span","strong","summary","sup","table","tbody","td","textarea","tfoot","th","thead","time","tr","ul","var","video"],te=["any-hover","any-pointer","aspect-ratio","color","color-gamut","color-index","device-aspect-ratio","device-height","device-width","display-mode","forced-colors","grid","height","hover","inverted-colors","monochrome","orientation","overflow-block","overflow-inline","pointer","prefers-color-scheme","prefers-contrast","prefers-reduced-motion","prefers-reduced-transparency","resolution","scan","scripting","update","width","min-width","max-width","min-height","max-height"],ae=["active","any-link","blank","checked","current","default","defined","dir","disabled","drop","empty","enabled","first","first-child","first-of-type","fullscreen","future","focus","focus-visible","focus-within","has","host","host-context","hover","indeterminate","in-range","invalid","is","lang","last-child","last-of-type","left","link","local-link","not","nth-child","nth-col","nth-last-child","nth-last-col","nth-last-of-type","nth-of-type","only-child","only-of-type","optional","out-of-range","past","placeholder-shown","read-only","read-write","required","right","root","scope","target","target-within","user-invalid","valid","visited","where"],ie=["after","backdrop","before","cue","cue-region","first-letter","first-line","grammar-error","marker","part","placeholder","selection","slotted","spelling-error"],se=["align-content","align-items","align-self","animation","animation-delay","animation-direction","animation-duration","animation-fill-mode","animation-iteration-count","animation-name","animation-play-state","animation-timing-function","auto","backface-visibility","background","background-attachment","background-clip","background-color","background-image","background-origin","background-position","background-repeat","background-size","border","border-bottom","border-bottom-color","border-bottom-left-radius","border-bottom-right-radius","border-bottom-style","border-bottom-width","border-collapse","border-color","border-image","border-image-outset","border-image-repeat","border-image-slice","border-image-source","border-image-width","border-left","border-left-color","border-left-style","border-left-width","border-radius","border-right","border-right-color","border-right-style","border-right-width","border-spacing","border-style","border-top","border-top-color","border-top-left-radius","border-top-right-radius","border-top-style","border-top-width","border-width","bottom","box-decoration-break","box-shadow","box-sizing","break-after","break-before","break-inside","caption-side","clear","clip","clip-path","color","column-count","column-fill","column-gap","column-rule","column-rule-color","column-rule-style","column-rule-width","column-span","column-width","columns","content","counter-increment","counter-reset","cursor","direction","display","empty-cells","filter","flex","flex-basis","flex-direction","flex-flow","flex-grow","flex-shrink","flex-wrap","float","font","font-display","font-family","font-feature-settings","font-kerning","font-language-override","font-size","font-size-adjust","font-smoothing","font-stretch","font-style","font-variant","font-variant-ligatures","font-variation-settings","font-weight","height","hyphens","icon","image-orientation","image-rendering","image-resolution","ime-mode","inherit","initial","justify-content","left","letter-spacing","line-height","list-style","list-style-image","list-style-position","list-style-type","margin","margin-bottom","margin-left","margin-right","margin-top","marks","mask","max-height","max-width","min-height","min-width","nav-down","nav-index","nav-left","nav-right","nav-up","none","normal","object-fit","object-position","opacity","order","orphans","outline","outline-color","outline-offset","outline-style","outline-width","overflow","overflow-wrap","overflow-x","overflow-y","padding","padding-bottom","padding-left","padding-right","padding-top","page-break-after","page-break-before","page-break-inside","perspective","perspective-origin","pointer-events","position","quotes","resize","right","src","tab-size","table-layout","text-align","text-align-last","text-decoration","text-decoration-color","text-decoration-line","text-decoration-style","text-indent","text-overflow","text-rendering","text-shadow","text-transform","text-underline-position","top","transform","transform-origin","transform-style","transition","transition-delay","transition-duration","transition-property","transition-timing-function","unicode-bidi","vertical-align","visibility","white-space","widows","width","word-break","word-spacing","word-wrap","z-index"].reverse(),re=ae.concat(ie) -;var oe="\\.([0-9](_*[0-9])*)",le="[0-9a-fA-F](_*[0-9a-fA-F])*",ce={ -className:"number",variants:[{ -begin:`(\\b([0-9](_*[0-9])*)((${oe})|\\.)?|(${oe}))[eE][+-]?([0-9](_*[0-9])*)[fFdD]?\\b` -},{begin:`\\b([0-9](_*[0-9])*)((${oe})[fFdD]?\\b|\\.([fFdD]\\b)?)`},{ -begin:`(${oe})[fFdD]?\\b`},{begin:"\\b([0-9](_*[0-9])*)[fFdD]\\b"},{ -begin:`\\b0[xX]((${le})\\.?|(${le})?\\.(${le}))[pP][+-]?([0-9](_*[0-9])*)[fFdD]?\\b` -},{begin:"\\b(0|[1-9](_*[0-9])*)[lL]?\\b"},{begin:`\\b0[xX](${le})[lL]?\\b`},{ -begin:"\\b0(_*[0-7])*[lL]?\\b"},{begin:"\\b0[bB][01](_*[01])*[lL]?\\b"}], -relevance:0};function de(e,n,t){return-1===t?"":e.replace(n,(a=>de(e,n,t-1)))} -const ge="[A-Za-z$_][0-9A-Za-z$_]*",ue=["as","in","of","if","for","while","finally","var","new","function","do","return","void","else","break","catch","instanceof","with","throw","case","default","try","switch","continue","typeof","delete","let","yield","const","class","debugger","async","await","static","import","from","export","extends"],be=["true","false","null","undefined","NaN","Infinity"],me=["Intl","DataView","Number","Math","Date","String","RegExp","Object","Function","Boolean","Error","Symbol","Set","Map","WeakSet","WeakMap","Proxy","Reflect","JSON","Promise","Float64Array","Int16Array","Int32Array","Int8Array","Uint16Array","Uint32Array","Float32Array","Array","Uint8Array","Uint8ClampedArray","ArrayBuffer","BigInt64Array","BigUint64Array","BigInt"],pe=["EvalError","InternalError","RangeError","ReferenceError","SyntaxError","TypeError","URIError"],_e=["setInterval","setTimeout","clearInterval","clearTimeout","require","exports","eval","isFinite","isNaN","parseFloat","parseInt","decodeURI","decodeURIComponent","encodeURI","encodeURIComponent","escape","unescape"],fe=["arguments","this","super","console","window","document","localStorage","module","global"],he=[].concat(_e,me,pe) -;function Ee(e){const n=ge,t={begin:/<[A-Za-z0-9\\._:-]+/, -end:/\/[A-Za-z0-9\\._:-]+>|\/>/,isTrulyOpeningTag:(e,n)=>{ -const t=e[0].length+e.index,a=e.input[t];"<"!==a?">"===a&&(((e,{after:n})=>{ -const t="",x={ -match:[/const|var|let/,/\s+/,n,/\s*/,/=\s*/,g(M)],className:{1:"keyword", -3:"title.function"},contains:[f]};return{name:"Javascript", -aliases:["js","jsx","mjs","cjs"],keywords:a,exports:{PARAMS_CONTAINS:_}, -illegal:/#(?![$_A-z])/,contains:[e.SHEBANG({label:"shebang",binary:"node", -relevance:5}),{label:"use_strict",className:"meta",relevance:10, -begin:/^\s*['"]use (strict|asm)['"]/ -},e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,l,c,d,u,r,E,{className:"attr", -begin:n+g(":"),relevance:0},x,{ -begin:"("+e.RE_STARTERS_RE+"|\\b(case|return|throw)\\b)\\s*", -keywords:"return throw case",relevance:0,contains:[u,e.REGEXP_MODE,{ -className:"function",begin:M,returnBegin:!0,end:"\\s*=>",contains:[{ -className:"params",variants:[{begin:e.UNDERSCORE_IDENT_RE,relevance:0},{ -className:null,begin:/\(\s*\)/,skip:!0},{begin:/\(/,end:/\)/,excludeBegin:!0, -excludeEnd:!0,keywords:a,contains:_}]}]},{begin:/,/,relevance:0},{match:/\s+/, -relevance:0},{variants:[{begin:"<>",end:""},{begin:t.begin, -"on:begin":t.isTrulyOpeningTag,end:t.end}],subLanguage:"xml",contains:[{ -begin:t.begin,end:t.end,skip:!0,contains:["self"]}]}]},y,{ -beginKeywords:"while if switch catch for"},{ -begin:"\\b(?!function)"+e.UNDERSCORE_IDENT_RE+"\\([^()]*(\\([^()]*(\\([^()]*\\)[^()]*)*\\)[^()]*)*\\)\\s*\\{", -returnBegin:!0,label:"func.def",contains:[f,e.inherit(e.TITLE_MODE,{begin:n, -className:"title.function"})]},{match:/\.\.\./,relevance:0},v,{match:"\\$"+n, -relevance:0},{match:[/\bconstructor(?=\s*\()/],className:{1:"title.function"}, -contains:[f]},N,{relevance:0,match:/\b[A-Z][A-Z_]+\b/, -className:"variable.constant"},h,O,{match:/\$[(.]/}]}} -const ye=e=>b(/\b/,e,/\w$/.test(e)?/\b/:/\B/),Ne=["Protocol","Type"].map(ye),we=["init","self"].map(ye),ve=["Any","Self"],Oe=["actor","associatedtype","async","await",/as\?/,/as!/,"as","break","case","catch","class","continue","convenience","default","defer","deinit","didSet","do","dynamic","else","enum","extension","fallthrough",/fileprivate\(set\)/,"fileprivate","final","for","func","get","guard","if","import","indirect","infix",/init\?/,/init!/,"inout",/internal\(set\)/,"internal","in","is","lazy","let","mutating","nonmutating",/open\(set\)/,"open","operator","optional","override","postfix","precedencegroup","prefix",/private\(set\)/,"private","protocol",/public\(set\)/,"public","repeat","required","rethrows","return","set","some","static","struct","subscript","super","switch","throws","throw",/try\?/,/try!/,"try","typealias",/unowned\(safe\)/,/unowned\(unsafe\)/,"unowned","var","weak","where","while","willSet"],Me=["false","nil","true"],xe=["assignment","associativity","higherThan","left","lowerThan","none","right"],Se=["#colorLiteral","#column","#dsohandle","#else","#elseif","#endif","#error","#file","#fileID","#fileLiteral","#filePath","#function","#if","#imageLiteral","#keyPath","#line","#selector","#sourceLocation","#warn_unqualified_access","#warning"],ke=["abs","all","any","assert","assertionFailure","debugPrint","dump","fatalError","getVaList","isKnownUniquelyReferenced","max","min","numericCast","pointwiseMax","pointwiseMin","precondition","preconditionFailure","print","readLine","repeatElement","sequence","stride","swap","swift_unboxFromSwiftValueWithType","transcode","type","unsafeBitCast","unsafeDowncast","withExtendedLifetime","withUnsafeMutablePointer","withUnsafePointer","withVaList","withoutActuallyEscaping","zip"],Ae=m(/[/=\-+!*%<>&|^~?]/,/[\u00A1-\u00A7]/,/[\u00A9\u00AB]/,/[\u00AC\u00AE]/,/[\u00B0\u00B1]/,/[\u00B6\u00BB\u00BF\u00D7\u00F7]/,/[\u2016-\u2017]/,/[\u2020-\u2027]/,/[\u2030-\u203E]/,/[\u2041-\u2053]/,/[\u2055-\u205E]/,/[\u2190-\u23FF]/,/[\u2500-\u2775]/,/[\u2794-\u2BFF]/,/[\u2E00-\u2E7F]/,/[\u3001-\u3003]/,/[\u3008-\u3020]/,/[\u3030]/),Ce=m(Ae,/[\u0300-\u036F]/,/[\u1DC0-\u1DFF]/,/[\u20D0-\u20FF]/,/[\uFE00-\uFE0F]/,/[\uFE20-\uFE2F]/),Te=b(Ae,Ce,"*"),Re=m(/[a-zA-Z_]/,/[\u00A8\u00AA\u00AD\u00AF\u00B2-\u00B5\u00B7-\u00BA]/,/[\u00BC-\u00BE\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF]/,/[\u0100-\u02FF\u0370-\u167F\u1681-\u180D\u180F-\u1DBF]/,/[\u1E00-\u1FFF]/,/[\u200B-\u200D\u202A-\u202E\u203F-\u2040\u2054\u2060-\u206F]/,/[\u2070-\u20CF\u2100-\u218F\u2460-\u24FF\u2776-\u2793]/,/[\u2C00-\u2DFF\u2E80-\u2FFF]/,/[\u3004-\u3007\u3021-\u302F\u3031-\u303F\u3040-\uD7FF]/,/[\uF900-\uFD3D\uFD40-\uFDCF\uFDF0-\uFE1F\uFE30-\uFE44]/,/[\uFE47-\uFEFE\uFF00-\uFFFD]/),De=m(Re,/\d/,/[\u0300-\u036F\u1DC0-\u1DFF\u20D0-\u20FF\uFE20-\uFE2F]/),Ie=b(Re,De,"*"),Be=b(/[A-Z]/,De,"*"),Le=["autoclosure",b(/convention\(/,m("swift","block","c"),/\)/),"discardableResult","dynamicCallable","dynamicMemberLookup","escaping","frozen","GKInspectable","IBAction","IBDesignable","IBInspectable","IBOutlet","IBSegueAction","inlinable","main","nonobjc","NSApplicationMain","NSCopying","NSManaged",b(/objc\(/,Ie,/\)/),"objc","objcMembers","propertyWrapper","requires_stored_property_inits","resultBuilder","testable","UIApplicationMain","unknown","usableFromInline"],$e=["iOS","iOSApplicationExtension","macOS","macOSApplicationExtension","macCatalyst","macCatalystApplicationExtension","watchOS","watchOSApplicationExtension","tvOS","tvOSApplicationExtension","swift"] -;var ze=Object.freeze({__proto__:null,grmr_bash:e=>{const n={},t={begin:/\$\{/, -end:/\}/,contains:["self",{begin:/:-/,contains:[n]}]};Object.assign(n,{ -className:"variable",variants:[{ -begin:b(/\$[\w\d#@][\w\d_]*/,"(?![\\w\\d])(?![$])")},t]});const a={ -className:"subst",begin:/\$\(/,end:/\)/,contains:[e.BACKSLASH_ESCAPE]},i={ -begin:/<<-?\s*(?=\w+)/,starts:{contains:[e.END_SAME_AS_BEGIN({begin:/(\w+)/, -end:/(\w+)/,className:"string"})]}},s={className:"string",begin:/"/,end:/"/, -contains:[e.BACKSLASH_ESCAPE,n,a]};a.contains.push(s);const r={begin:/\$\(\(/, -end:/\)\)/,contains:[{begin:/\d+#[0-9a-f]+/,className:"number"},e.NUMBER_MODE,n] -},o=e.SHEBANG({binary:"(fish|bash|zsh|sh|csh|ksh|tcsh|dash|scsh)",relevance:10 -}),l={className:"function",begin:/\w[\w\d_]*\s*\(\s*\)\s*\{/,returnBegin:!0, -contains:[e.inherit(e.TITLE_MODE,{begin:/\w[\w\d_]*/})],relevance:0};return{ -name:"Bash",aliases:["sh"],keywords:{$pattern:/\b[a-z._-]+\b/, -keyword:["if","then","else","elif","fi","for","while","in","do","done","case","esac","function"], -literal:["true","false"], -built_in:"break cd continue eval exec exit export getopts hash pwd readonly return shift test times trap umask unset alias bind builtin caller command declare echo enable help let local logout mapfile printf read readarray source type typeset ulimit unalias set shopt autoload bg bindkey bye cap chdir clone comparguments compcall compctl compdescribe compfiles compgroups compquote comptags comptry compvalues dirs disable disown echotc echoti emulate fc fg float functions getcap getln history integer jobs kill limit log noglob popd print pushd pushln rehash sched setcap setopt stat suspend ttyctl unfunction unhash unlimit unsetopt vared wait whence where which zcompile zformat zftp zle zmodload zparseopts zprof zpty zregexparse zsocket zstyle ztcp" -},contains:[o,e.SHEBANG(),l,r,e.HASH_COMMENT_MODE,i,s,{className:"",begin:/\\"/ -},{className:"string",begin:/'/,end:/'/},n]}},grmr_c:e=>{ -const n=e.COMMENT("//","$",{contains:[{begin:/\\\n/}] -}),t="[a-zA-Z_]\\w*::",a="(decltype\\(auto\\)|"+u(t)+"[a-zA-Z_]\\w*"+u("<[^<>]+>")+")",i={ -className:"type",variants:[{begin:"\\b[a-z\\d_]*_t\\b"},{ -match:/\batomic_[a-z]{3,6}\b/}]},s={className:"string",variants:[{ -begin:'(u8?|U|L)?"',end:'"',illegal:"\\n",contains:[e.BACKSLASH_ESCAPE]},{ -begin:"(u8?|U|L)?'(\\\\(x[0-9A-Fa-f]{2}|u[0-9A-Fa-f]{4,8}|[0-7]{3}|\\S)|.)", -end:"'",illegal:"."},e.END_SAME_AS_BEGIN({ -begin:/(?:u8?|U|L)?R"([^()\\ ]{0,16})\(/,end:/\)([^()\\ ]{0,16})"/})]},r={ -className:"number",variants:[{begin:"\\b(0b[01']+)"},{ -begin:"(-?)\\b([\\d']+(\\.[\\d']*)?|\\.[\\d']+)((ll|LL|l|L)(u|U)?|(u|U)(ll|LL|l|L)?|f|F|b|B)" -},{ -begin:"(-?)(\\b0[xX][a-fA-F0-9']+|(\\b[\\d']+(\\.[\\d']*)?|\\.[\\d']+)([eE][-+]?[\\d']+)?)" -}],relevance:0},o={className:"meta",begin:/#\s*[a-z]+\b/,end:/$/,keywords:{ -keyword:"if else elif endif define undef warning error line pragma _Pragma ifdef ifndef include" -},contains:[{begin:/\\\n/,relevance:0},e.inherit(s,{className:"string"}),{ -className:"string",begin:/<.*?>/},n,e.C_BLOCK_COMMENT_MODE]},l={ -className:"title",begin:u(t)+e.IDENT_RE,relevance:0 -},c=u(t)+e.IDENT_RE+"\\s*\\(",d={ -keyword:["asm","auto","break","case","const","continue","default","do","else","enum","extern","for","fortran","goto","if","inline","register","restrict","return","sizeof","static","struct","switch","typedef","union","volatile","while","_Alignas","_Alignof","_Atomic","_Generic","_Noreturn","_Static_assert","_Thread_local","alignas","alignof","noreturn","static_assert","thread_local","_Pragma"], -type:["float","double","signed","unsigned","int","short","long","char","void","_Bool","_Complex","_Imaginary","_Decimal32","_Decimal64","_Decimal128","complex","bool","imaginary"], -literal:"true false NULL", -built_in:"std string wstring cin cout cerr clog stdin stdout stderr stringstream istringstream ostringstream auto_ptr deque list queue stack vector map set pair bitset multiset multimap unordered_set unordered_map unordered_multiset unordered_multimap priority_queue make_pair array shared_ptr abort terminate abs acos asin atan2 atan calloc ceil cosh cos exit exp fabs floor fmod fprintf fputs free frexp fscanf future isalnum isalpha iscntrl isdigit isgraph islower isprint ispunct isspace isupper isxdigit tolower toupper labs ldexp log10 log malloc realloc memchr memcmp memcpy memset modf pow printf putchar puts scanf sinh sin snprintf sprintf sqrt sscanf strcat strchr strcmp strcpy strcspn strlen strncat strncmp strncpy strpbrk strrchr strspn strstr tanh tan vfprintf vprintf vsprintf endl initializer_list unique_ptr" -},g=[o,i,n,e.C_BLOCK_COMMENT_MODE,r,s],b={variants:[{begin:/=/,end:/;/},{ -begin:/\(/,end:/\)/},{beginKeywords:"new throw return else",end:/;/}], -keywords:d,contains:g.concat([{begin:/\(/,end:/\)/,keywords:d, -contains:g.concat(["self"]),relevance:0}]),relevance:0},m={ -begin:"("+a+"[\\*&\\s]+)+"+c,returnBegin:!0,end:/[{;=]/,excludeEnd:!0, -keywords:d,illegal:/[^\w\s\*&:<>.]/,contains:[{begin:"decltype\\(auto\\)", -keywords:d,relevance:0},{begin:c,returnBegin:!0,contains:[e.inherit(l,{ -className:"title.function"})],relevance:0},{relevance:0,match:/,/},{ -className:"params",begin:/\(/,end:/\)/,keywords:d,relevance:0, -contains:[n,e.C_BLOCK_COMMENT_MODE,s,r,i,{begin:/\(/,end:/\)/,keywords:d, -relevance:0,contains:["self",n,e.C_BLOCK_COMMENT_MODE,s,r,i]}] -},i,n,e.C_BLOCK_COMMENT_MODE,o]};return{name:"C",aliases:["h"],keywords:d, -disableAutodetect:!0,illegal:"=]/,contains:[{ -beginKeywords:"final class struct"},e.TITLE_MODE]}]),exports:{preprocessor:o, -strings:s,keywords:d}}},grmr_cpp:e=>{const n=e.COMMENT("//","$",{contains:[{ -begin:/\\\n/}] -}),t="[a-zA-Z_]\\w*::",a="(?!struct)(decltype\\(auto\\)|"+u(t)+"[a-zA-Z_]\\w*"+u("<[^<>]+>")+")",i={ -className:"type",begin:"\\b[a-z\\d_]*_t\\b"},s={className:"string",variants:[{ -begin:'(u8?|U|L)?"',end:'"',illegal:"\\n",contains:[e.BACKSLASH_ESCAPE]},{ -begin:"(u8?|U|L)?'(\\\\(x[0-9A-Fa-f]{2}|u[0-9A-Fa-f]{4,8}|[0-7]{3}|\\S)|.)", -end:"'",illegal:"."},e.END_SAME_AS_BEGIN({ -begin:/(?:u8?|U|L)?R"([^()\\ ]{0,16})\(/,end:/\)([^()\\ ]{0,16})"/})]},r={ -className:"number",variants:[{begin:"\\b(0b[01']+)"},{ -begin:"(-?)\\b([\\d']+(\\.[\\d']*)?|\\.[\\d']+)((ll|LL|l|L)(u|U)?|(u|U)(ll|LL|l|L)?|f|F|b|B)" -},{ -begin:"(-?)(\\b0[xX][a-fA-F0-9']+|(\\b[\\d']+(\\.[\\d']*)?|\\.[\\d']+)([eE][-+]?[\\d']+)?)" -}],relevance:0},o={className:"meta",begin:/#\s*[a-z]+\b/,end:/$/,keywords:{ -keyword:"if else elif endif define undef warning error line pragma _Pragma ifdef ifndef include" -},contains:[{begin:/\\\n/,relevance:0},e.inherit(s,{className:"string"}),{ -className:"string",begin:/<.*?>/},n,e.C_BLOCK_COMMENT_MODE]},l={ -className:"title",begin:u(t)+e.IDENT_RE,relevance:0 -},c=u(t)+e.IDENT_RE+"\\s*\\(",d={ -type:["bool","char","char16_t","char32_t","char8_t","double","float","int","long","short","void","wchar_t","any","array","async","auto_ptr","barrier","binary_semaphore","bitset","complex","condition_variable","condition_variable_any","counting_semaphore","deque","false_type","function","future","imaginary","initializer_list","istringstream","jthread","latch","list","lock_guard","map","multimap","multiset","mutex","optional","ostringstream","packaged_task","pair","promise","priority_queue","queue","recursive_mutex","recursive_timed_mutex","scoped_lock","set","shared_future","shared_lock","shared_mutex","shared_timed_mutex","shared_ptr","stack","string","string_view","stringstream","timed_mutex","thread","true_type","tuple","unique_lock","unique_ptr","unordered_map","unordered_multimap","unordered_multiset","unordered_set","variant","vector","weak_ptr","wstring","wstring_view"], -keyword:["alignas","alignof","and","and_eq","asm","atomic_cancel","atomic_commit","atomic_noexcept","auto","bitand","bitor","break","case","catch","class","co_await","co_return","co_yield","compl","concept","const","const_cast|10","consteval","constexpr","constinit","continue","decltype","default","delete","do","dynamic_cast|10","else","enum","explicit","export","extern","false","final","for","friend","goto","if","import","inline","module","mutable","namespace","new","noexcept","not","not_eq","nullptr","operator","or","or_eq","override","private","protected","public","reflexpr","register","reinterpret_cast|10","requires","return","signed","sizeof","static","static_assert","static_cast|10","struct","switch","synchronized","template","this","thread_local","throw","transaction_safe","transaction_safe_dynamic","true","try","typedef","typeid","typename","union","unsigned","using","virtual","volatile","while","xor","xor_eq,"], -built_in:["_Bool","_Complex","_Imaginary"], -literal:["NULL","false","nullopt","nullptr","true"]},m={ -className:"function.dispatch",relevance:0,keywords:{ -_hint:["abort","abs","acos","apply","as_const","asin","atan","atan2","calloc","ceil","cerr","cin","clog","cos","cosh","cout","declval","endl","exchange","exit","exp","fabs","floor","fmod","forward","fprintf","fputs","free","frexp","fscanf","future","invoke","isalnum","isalpha","iscntrl","isdigit","isgraph","islower","isprint","ispunct","isspace","isupper","isxdigit","labs","launder","ldexp","log","log10","make_pair","make_shared","make_shared_for_overwrite","make_tuple","make_unique","malloc","memchr","memcmp","memcpy","memset","modf","move","pow","printf","putchar","puts","realloc","scanf","sin","sinh","snprintf","sprintf","sqrt","sscanf","std","stderr","stdin","stdout","strcat","strchr","strcmp","strcpy","strcspn","strlen","strncat","strncmp","strncpy","strpbrk","strrchr","strspn","strstr","swap","tan","tanh","terminate","to_underlying","tolower","toupper","vfprintf","visit","vprintf","vsprintf"] -}, -begin:b(/\b/,/(?!decltype)/,/(?!if)/,/(?!for)/,/(?!while)/,e.IDENT_RE,g(/(<[^<>]+>|)\s*\(/)) -},p=[m,o,i,n,e.C_BLOCK_COMMENT_MODE,r,s],_={variants:[{begin:/=/,end:/;/},{ -begin:/\(/,end:/\)/},{beginKeywords:"new throw return else",end:/;/}], -keywords:d,contains:p.concat([{begin:/\(/,end:/\)/,keywords:d, -contains:p.concat(["self"]),relevance:0}]),relevance:0},f={className:"function", -begin:"("+a+"[\\*&\\s]+)+"+c,returnBegin:!0,end:/[{;=]/,excludeEnd:!0, -keywords:d,illegal:/[^\w\s\*&:<>.]/,contains:[{begin:"decltype\\(auto\\)", -keywords:d,relevance:0},{begin:c,returnBegin:!0,contains:[l],relevance:0},{ -begin:/::/,relevance:0},{begin:/:/,endsWithParent:!0,contains:[s,r]},{ -relevance:0,match:/,/},{className:"params",begin:/\(/,end:/\)/,keywords:d, -relevance:0,contains:[n,e.C_BLOCK_COMMENT_MODE,s,r,i,{begin:/\(/,end:/\)/, -keywords:d,relevance:0,contains:["self",n,e.C_BLOCK_COMMENT_MODE,s,r,i]}] -},i,n,e.C_BLOCK_COMMENT_MODE,o]};return{name:"C++", -aliases:["cc","c++","h++","hpp","hh","hxx","cxx"],keywords:d,illegal:"",keywords:d,contains:["self",i]},{begin:e.IDENT_RE+"::",keywords:d},{ -match:[/\b(?:enum(?:\s+(?:class|struct))?|class|struct|union)/,/\s+/,/\w+/], -className:{1:"keyword",3:"title.class"}}])}},grmr_csharp:e=>{const n={ -keyword:["abstract","as","base","break","case","class","const","continue","do","else","event","explicit","extern","finally","fixed","for","foreach","goto","if","implicit","in","interface","internal","is","lock","namespace","new","operator","out","override","params","private","protected","public","readonly","record","ref","return","sealed","sizeof","stackalloc","static","struct","switch","this","throw","try","typeof","unchecked","unsafe","using","virtual","void","volatile","while"].concat(["add","alias","and","ascending","async","await","by","descending","equals","from","get","global","group","init","into","join","let","nameof","not","notnull","on","or","orderby","partial","remove","select","set","unmanaged","value|0","var","when","where","with","yield"]), -built_in:["bool","byte","char","decimal","delegate","double","dynamic","enum","float","int","long","nint","nuint","object","sbyte","short","string","ulong","uint","ushort"], -literal:["default","false","null","true"]},t=e.inherit(e.TITLE_MODE,{ -begin:"[a-zA-Z](\\.?\\w)*"}),a={className:"number",variants:[{ -begin:"\\b(0b[01']+)"},{ -begin:"(-?)\\b([\\d']+(\\.[\\d']*)?|\\.[\\d']+)(u|U|l|L|ul|UL|f|F|b|B)"},{ -begin:"(-?)(\\b0[xX][a-fA-F0-9']+|(\\b[\\d']+(\\.[\\d']*)?|\\.[\\d']+)([eE][-+]?[\\d']+)?)" -}],relevance:0},i={className:"string",begin:'@"',end:'"',contains:[{begin:'""'}] -},s=e.inherit(i,{illegal:/\n/}),r={className:"subst",begin:/\{/,end:/\}/, -keywords:n},o=e.inherit(r,{illegal:/\n/}),l={className:"string",begin:/\$"/, -end:'"',illegal:/\n/,contains:[{begin:/\{\{/},{begin:/\}\}/ -},e.BACKSLASH_ESCAPE,o]},c={className:"string",begin:/\$@"/,end:'"',contains:[{ -begin:/\{\{/},{begin:/\}\}/},{begin:'""'},r]},d=e.inherit(c,{illegal:/\n/, -contains:[{begin:/\{\{/},{begin:/\}\}/},{begin:'""'},o]}) -;r.contains=[c,l,i,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,a,e.C_BLOCK_COMMENT_MODE], -o.contains=[d,l,s,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,a,e.inherit(e.C_BLOCK_COMMENT_MODE,{ -illegal:/\n/})];const g={variants:[c,l,i,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE] -},u={begin:"<",end:">",contains:[{beginKeywords:"in out"},t] -},b=e.IDENT_RE+"(<"+e.IDENT_RE+"(\\s*,\\s*"+e.IDENT_RE+")*>)?(\\[\\])?",m={ -begin:"@"+e.IDENT_RE,relevance:0};return{name:"C#",aliases:["cs","c#"], -keywords:n,illegal:/::/,contains:[e.COMMENT("///","$",{returnBegin:!0, -contains:[{className:"doctag",variants:[{begin:"///",relevance:0},{ -begin:"\x3c!--|--\x3e"},{begin:""}]}] -}),e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,{className:"meta",begin:"#", -end:"$",keywords:{ -keyword:"if else elif endif define undef warning error line region endregion pragma checksum" -}},g,a,{beginKeywords:"class interface",relevance:0,end:/[{;=]/, -illegal:/[^\s:,]/,contains:[{beginKeywords:"where class" -},t,u,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{beginKeywords:"namespace", -relevance:0,end:/[{;=]/,illegal:/[^\s:]/, -contains:[t,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{ -beginKeywords:"record",relevance:0,end:/[{;=]/,illegal:/[^\s:]/, -contains:[t,u,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{className:"meta", -begin:"^\\s*\\[(?=[\\w])",excludeBegin:!0,end:"\\]",excludeEnd:!0,contains:[{ -className:"string",begin:/"/,end:/"/}]},{ -beginKeywords:"new return throw await else",relevance:0},{className:"function", -begin:"("+b+"\\s+)+"+e.IDENT_RE+"\\s*(<.+>\\s*)?\\(",returnBegin:!0, -end:/\s*[{;=]/,excludeEnd:!0,keywords:n,contains:[{ -beginKeywords:"public private protected static internal protected abstract async extern override unsafe virtual new sealed partial", -relevance:0},{begin:e.IDENT_RE+"\\s*(<.+>\\s*)?\\(",returnBegin:!0, -contains:[e.TITLE_MODE,u],relevance:0},{className:"params",begin:/\(/,end:/\)/, -excludeBegin:!0,excludeEnd:!0,keywords:n,relevance:0, -contains:[g,a,e.C_BLOCK_COMMENT_MODE] -},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},m]}},grmr_css:e=>{ -const n=ee(e),t=[e.APOS_STRING_MODE,e.QUOTE_STRING_MODE];return{name:"CSS", -case_insensitive:!0,illegal:/[=|'\$]/,keywords:{keyframePosition:"from to"}, -classNameAliases:{keyframePosition:"selector-tag"}, -contains:[e.C_BLOCK_COMMENT_MODE,{begin:/-(webkit|moz|ms|o)-(?=[a-z])/ -},n.CSS_NUMBER_MODE,{className:"selector-id",begin:/#[A-Za-z0-9_-]+/,relevance:0 -},{className:"selector-class",begin:"\\.[a-zA-Z-][a-zA-Z0-9_-]*",relevance:0 -},n.ATTRIBUTE_SELECTOR_MODE,{className:"selector-pseudo",variants:[{ -begin:":("+ae.join("|")+")"},{begin:"::("+ie.join("|")+")"}]},{ -className:"attribute",begin:"\\b("+se.join("|")+")\\b"},{begin:":",end:"[;}]", -contains:[n.HEXCOLOR,n.IMPORTANT,n.CSS_NUMBER_MODE,...t,{ -begin:/(url|data-uri)\(/,end:/\)/,relevance:0,keywords:{built_in:"url data-uri" -},contains:[{className:"string",begin:/[^)]/,endsWithParent:!0,excludeEnd:!0}] -},{className:"built_in",begin:/[\w-]+(?=\()/}]},{begin:g(/@/),end:"[{;]", -relevance:0,illegal:/:/,contains:[{className:"keyword",begin:/@-?\w[\w]*(-\w+)*/ -},{begin:/\s/,endsWithParent:!0,excludeEnd:!0,relevance:0,keywords:{ -$pattern:/[a-z-]+/,keyword:"and or not only",attribute:te.join(" ")},contains:[{ -begin:/[a-z-]+(?=:)/,className:"attribute"},...t,n.CSS_NUMBER_MODE]}]},{ -className:"selector-tag",begin:"\\b("+ne.join("|")+")\\b"}]}},grmr_diff:e=>({ -name:"Diff",aliases:["patch"],contains:[{className:"meta",relevance:10, -match:m(/^@@ +-\d+,\d+ +\+\d+,\d+ +@@/,/^\*\*\* +\d+,\d+ +\*\*\*\*$/,/^--- +\d+,\d+ +----$/) -},{className:"comment",variants:[{ -begin:m(/Index: /,/^index/,/={3,}/,/^-{3}/,/^\*{3} /,/^\+{3}/,/^diff --git/), -end:/$/},{match:/^\*{15}$/}]},{className:"addition",begin:/^\+/,end:/$/},{ -className:"deletion",begin:/^-/,end:/$/},{className:"addition",begin:/^!/, -end:/$/}]}),grmr_go:e=>{const n={ -keyword:["break","default","func","interface","select","case","map","struct","chan","else","goto","package","switch","const","fallthrough","if","range","type","continue","for","import","return","var","go","defer","bool","byte","complex64","complex128","float32","float64","int8","int16","int32","int64","string","uint8","uint16","uint32","uint64","int","uint","uintptr","rune"], -literal:["true","false","iota","nil"], -built_in:["append","cap","close","complex","copy","imag","len","make","new","panic","print","println","real","recover","delete"] -};return{name:"Go",aliases:["golang"],keywords:n,illegal:"{const n={ -className:"number",relevance:0,variants:[{begin:/([+-]+)?[\d]+_[\d_]+/},{ -begin:e.NUMBER_RE}]},t=e.COMMENT();t.variants=[{begin:/;/,end:/$/},{begin:/#/, -end:/$/}];const a={className:"variable",variants:[{begin:/\$[\w\d"][\w\d_]*/},{ -begin:/\$\{(.*?)\}/}]},i={className:"literal", -begin:/\bon|off|true|false|yes|no\b/},s={className:"string", -contains:[e.BACKSLASH_ESCAPE],variants:[{begin:"'''",end:"'''",relevance:10},{ -begin:'"""',end:'"""',relevance:10},{begin:'"',end:'"'},{begin:"'",end:"'"}] -},r={begin:/\[/,end:/\]/,contains:[t,i,a,s,n,"self"],relevance:0 -},o=m(/[A-Za-z0-9_-]+/,/"(\\"|[^"])*"/,/'[^']*'/);return{name:"TOML, also INI", -aliases:["toml"],case_insensitive:!0,illegal:/\S/,contains:[t,{ -className:"section",begin:/\[+/,end:/\]+/},{ -begin:b(o,"(\\s*\\.\\s*",o,")*",g(/\s*=\s*[^#\s]/)),className:"attr",starts:{ -end:/$/,contains:[t,r,i,a,s,n]}}]}},grmr_java:e=>{ -const n="[\xc0-\u02b8a-zA-Z_$][\xc0-\u02b8a-zA-Z_$0-9]*",t=n+de("(?:<"+n+"~~~(?:\\s*,\\s*"+n+"~~~)*>)?",/~~~/g,2),a={ -keyword:["synchronized","abstract","private","var","static","if","const ","for","while","strictfp","finally","protected","import","native","final","void","enum","else","break","transient","catch","instanceof","volatile","case","assert","package","default","public","try","switch","continue","throws","protected","public","private","module","requires","exports","do"], -literal:["false","true","null"], -type:["char","boolean","long","float","int","byte","short","double"], -built_in:["super","this"]},i={className:"meta",begin:"@"+n,contains:[{ -begin:/\(/,end:/\)/,contains:["self"]}]},s={className:"params",begin:/\(/, -end:/\)/,keywords:a,relevance:0,contains:[e.C_BLOCK_COMMENT_MODE],endsParent:!0} -;return{name:"Java",aliases:["jsp"],keywords:a,illegal:/<\/|#/, -contains:[e.COMMENT("/\\*\\*","\\*/",{relevance:0,contains:[{begin:/\w+@/, -relevance:0},{className:"doctag",begin:"@[A-Za-z]+"}]}),{ -begin:/import java\.[a-z]+\./,keywords:"import",relevance:2 -},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,{ -match:[/\b(?:class|interface|enum|extends|implements|new)/,/\s+/,n],className:{ -1:"keyword",3:"title.class"}},{begin:[n,/\s+/,n,/\s+/,/=/],className:{1:"type", -3:"variable",5:"operator"}},{begin:[/record/,/\s+/,n],className:{1:"keyword", -3:"title.class"},contains:[s,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{ -beginKeywords:"new throw return else",relevance:0},{ -begin:["(?:"+t+"\\s+)",e.UNDERSCORE_IDENT_RE,/\s*(?=\()/],className:{ -2:"title.function"},keywords:a,contains:[{className:"params",begin:/\(/, -end:/\)/,keywords:a,relevance:0, -contains:[i,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,ce,e.C_BLOCK_COMMENT_MODE] -},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},ce,i]}},grmr_javascript:Ee, -grmr_json:e=>({name:"JSON",contains:[{className:"attr", -begin:/"(\\.|[^\\"\r\n])*"(?=\s*:)/,relevance:1.01},{match:/[{}[\],:]/, -className:"punctuation",relevance:0},e.QUOTE_STRING_MODE,{ -beginKeywords:"true false null" -},e.C_NUMBER_MODE,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE],illegal:"\\S"}), -grmr_kotlin:e=>{const n={ -keyword:"abstract as val var vararg get set class object open private protected public noinline crossinline dynamic final enum if else do while for when throw try catch finally import package is in fun override companion reified inline lateinit init interface annotation data sealed internal infix operator out by constructor super tailrec where const inner suspend typealias external expect actual", -built_in:"Byte Short Char Int Long Boolean Float Double Void Unit Nothing", -literal:"true false null"},t={className:"symbol",begin:e.UNDERSCORE_IDENT_RE+"@" -},a={className:"subst",begin:/\$\{/,end:/\}/,contains:[e.C_NUMBER_MODE]},i={ -className:"variable",begin:"\\$"+e.UNDERSCORE_IDENT_RE},s={className:"string", -variants:[{begin:'"""',end:'"""(?=[^"])',contains:[i,a]},{begin:"'",end:"'", -illegal:/\n/,contains:[e.BACKSLASH_ESCAPE]},{begin:'"',end:'"',illegal:/\n/, -contains:[e.BACKSLASH_ESCAPE,i,a]}]};a.contains.push(s);const r={ -className:"meta", -begin:"@(?:file|property|field|get|set|receiver|param|setparam|delegate)\\s*:(?:\\s*"+e.UNDERSCORE_IDENT_RE+")?" -},o={className:"meta",begin:"@"+e.UNDERSCORE_IDENT_RE,contains:[{begin:/\(/, -end:/\)/,contains:[e.inherit(s,{className:"string"})]}] -},l=ce,c=e.COMMENT("/\\*","\\*/",{contains:[e.C_BLOCK_COMMENT_MODE]}),d={ -variants:[{className:"type",begin:e.UNDERSCORE_IDENT_RE},{begin:/\(/,end:/\)/, -contains:[]}]},g=d;return g.variants[1].contains=[d],d.variants[1].contains=[g], -{name:"Kotlin",aliases:["kt","kts"],keywords:n, -contains:[e.COMMENT("/\\*\\*","\\*/",{relevance:0,contains:[{className:"doctag", -begin:"@[A-Za-z]+"}]}),e.C_LINE_COMMENT_MODE,c,{className:"keyword", -begin:/\b(break|continue|return|this)\b/,starts:{contains:[{className:"symbol", -begin:/@\w+/}]}},t,r,o,{className:"function",beginKeywords:"fun",end:"[(]|$", -returnBegin:!0,excludeEnd:!0,keywords:n,relevance:5,contains:[{ -begin:e.UNDERSCORE_IDENT_RE+"\\s*\\(",returnBegin:!0,relevance:0, -contains:[e.UNDERSCORE_TITLE_MODE]},{className:"type",begin://, -keywords:"reified",relevance:0},{className:"params",begin:/\(/,end:/\)/, -endsParent:!0,keywords:n,relevance:0,contains:[{begin:/:/,end:/[=,\/]/, -endsWithParent:!0,contains:[d,e.C_LINE_COMMENT_MODE,c],relevance:0 -},e.C_LINE_COMMENT_MODE,c,r,o,s,e.C_NUMBER_MODE]},c]},{className:"class", -beginKeywords:"class interface trait",end:/[:\{(]|$/,excludeEnd:!0, -illegal:"extends implements",contains:[{ -beginKeywords:"public protected internal private constructor" -},e.UNDERSCORE_TITLE_MODE,{className:"type",begin://,excludeBegin:!0, -excludeEnd:!0,relevance:0},{className:"type",begin:/[,:]\s*/,end:/[<\(,]|$/, -excludeBegin:!0,returnEnd:!0},r,o]},s,{className:"meta",begin:"^#!/usr/bin/env", -end:"$",illegal:"\n"},l]}},grmr_less:e=>{ -const n=ee(e),t=re,a="([\\w-]+|@\\{[\\w-]+\\})",i=[],s=[],r=e=>({ -className:"string",begin:"~?"+e+".*?"+e}),o=(e,n,t)=>({className:e,begin:n, -relevance:t}),l={$pattern:/[a-z-]+/,keyword:"and or not only", -attribute:te.join(" ")},c={begin:"\\(",end:"\\)",contains:s,keywords:l, -relevance:0} -;s.push(e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,r("'"),r('"'),n.CSS_NUMBER_MODE,{ -begin:"(url|data-uri)\\(",starts:{className:"string",end:"[\\)\\n]", -excludeEnd:!0} -},n.HEXCOLOR,c,o("variable","@@?[\\w-]+",10),o("variable","@\\{[\\w-]+\\}"),o("built_in","~?`[^`]*?`"),{ -className:"attribute",begin:"[\\w-]+\\s*:",end:":",returnBegin:!0,excludeEnd:!0 -},n.IMPORTANT);const d=s.concat({begin:/\{/,end:/\}/,contains:i}),g={ -beginKeywords:"when",endsWithParent:!0,contains:[{beginKeywords:"and not" -}].concat(s)},u={begin:a+"\\s*:",returnBegin:!0,end:/[;}]/,relevance:0, -contains:[{begin:/-(webkit|moz|ms|o)-/},{className:"attribute", -begin:"\\b("+se.join("|")+")\\b",end:/(?=:)/,starts:{endsWithParent:!0, -illegal:"[<=$]",relevance:0,contains:s}}]},b={className:"keyword", -begin:"@(import|media|charset|font-face|(-[a-z]+-)?keyframes|supports|document|namespace|page|viewport|host)\\b", -starts:{end:"[;{}]",keywords:l,returnEnd:!0,contains:s,relevance:0}},m={ -className:"variable",variants:[{begin:"@[\\w-]+\\s*:",relevance:15},{ -begin:"@[\\w-]+"}],starts:{end:"[;}]",returnEnd:!0,contains:d}},p={variants:[{ -begin:"[\\.#:&\\[>]",end:"[;{}]"},{begin:a,end:/\{/}],returnBegin:!0, -returnEnd:!0,illegal:"[<='$\"]",relevance:0, -contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,g,o("keyword","all\\b"),o("variable","@\\{[\\w-]+\\}"),{ -begin:"\\b("+ne.join("|")+")\\b",className:"selector-tag" -},o("selector-tag",a+"%?",0),o("selector-id","#"+a),o("selector-class","\\."+a,0),o("selector-tag","&",0),n.ATTRIBUTE_SELECTOR_MODE,{ -className:"selector-pseudo",begin:":("+ae.join("|")+")"},{ -className:"selector-pseudo",begin:"::("+ie.join("|")+")"},{begin:/\(/,end:/\)/, -relevance:0,contains:d},{begin:"!important"}]},_={ -begin:`[\\w-]+:(:)?(${t.join("|")})`,returnBegin:!0,contains:[p]} -;return i.push(e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,b,m,_,u,p),{ -name:"Less",case_insensitive:!0,illegal:"[=>'/<($\"]",contains:i}},grmr_lua:e=>{ -const n="\\[=*\\[",t="\\]=*\\]",a={begin:n,end:t,contains:["self"] -},i=[e.COMMENT("--(?!\\[=*\\[)","$"),e.COMMENT("--\\[=*\\[",t,{contains:[a], -relevance:10})];return{name:"Lua",keywords:{$pattern:e.UNDERSCORE_IDENT_RE, -literal:"true false nil", -keyword:"and break do else elseif end for goto if in local not or repeat return then until while", -built_in:"_G _ENV _VERSION __index __newindex __mode __call __metatable __tostring __len __gc __add __sub __mul __div __mod __pow __concat __unm __eq __lt __le assert collectgarbage dofile error getfenv getmetatable ipairs load loadfile loadstring module next pairs pcall print rawequal rawget rawset require select setfenv setmetatable tonumber tostring type unpack xpcall arg self coroutine resume yield status wrap create running debug getupvalue debug sethook getmetatable gethook setmetatable setlocal traceback setfenv getinfo setupvalue getlocal getregistry getfenv io lines write close flush open output type read stderr stdin input stdout popen tmpfile math log max acos huge ldexp pi cos tanh pow deg tan cosh sinh random randomseed frexp ceil floor rad abs sqrt modf asin min mod fmod log10 atan2 exp sin atan os exit setlocale date getenv difftime remove time clock tmpname rename execute package preload loadlib loaded loaders cpath config path seeall string sub upper len gfind rep find match char dump gmatch reverse byte format gsub lower table setn insert getn foreachi maxn foreach concat sort remove" -},contains:i.concat([{className:"function",beginKeywords:"function",end:"\\)", -contains:[e.inherit(e.TITLE_MODE,{ -begin:"([_a-zA-Z]\\w*\\.)*([_a-zA-Z]\\w*:)?[_a-zA-Z]\\w*"}),{className:"params", -begin:"\\(",endsWithParent:!0,contains:i}].concat(i) -},e.C_NUMBER_MODE,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,{className:"string", -begin:n,end:t,contains:[a],relevance:5}])}},grmr_makefile:e=>{const n={ -className:"variable",variants:[{begin:"\\$\\("+e.UNDERSCORE_IDENT_RE+"\\)", -contains:[e.BACKSLASH_ESCAPE]},{begin:/\$[@%{ -const n=b(/[A-Z_]/,u(/[A-Z0-9_.-]*:/),/[A-Z0-9_.-]*/),t={className:"symbol", -begin:/&[a-z]+;|&#[0-9]+;|&#x[a-f0-9]+;/},a={begin:/\s/,contains:[{ -className:"keyword",begin:/#?[a-z_][a-z1-9_-]+/,illegal:/\n/}]},i=e.inherit(a,{ -begin:/\(/,end:/\)/}),s=e.inherit(e.APOS_STRING_MODE,{className:"string" -}),r=e.inherit(e.QUOTE_STRING_MODE,{className:"string"}),o={endsWithParent:!0, -illegal:/`]+/}]}]}]};return{name:"HTML, XML", -aliases:["html","xhtml","rss","atom","xjb","xsd","xsl","plist","wsf","svg"], -case_insensitive:!0,contains:[{className:"meta",begin://, -relevance:10,contains:[a,r,s,i,{begin:/\[/,end:/\]/,contains:[{className:"meta", -begin://,contains:[a,i,r,s]}]}]},e.COMMENT(//,{ -relevance:10}),{begin://,relevance:10},t,{ -className:"meta",begin:/<\?xml/,end:/\?>/,relevance:10},{className:"tag", -begin:/)/,end:/>/,keywords:{name:"style"},contains:[o],starts:{ -end:/<\/style>/,returnEnd:!0,subLanguage:["css","xml"]}},{className:"tag", -begin:/)/,end:/>/,keywords:{name:"script"},contains:[o],starts:{ -end:/<\/script>/,returnEnd:!0,subLanguage:["javascript","handlebars","xml"]}},{ -className:"tag",begin:/<>|<\/>/},{className:"tag", -begin:b(//,/>/,/\s/)))),end:/\/?>/,contains:[{className:"name", -begin:n,relevance:0,starts:o}]},{className:"tag",begin:b(/<\//,g(b(n,/>/))), -contains:[{className:"name",begin:n,relevance:0},{begin:/>/,relevance:0, -endsParent:!0}]}]}},grmr_markdown:e=>{const n={begin:/<\/?[A-Za-z_]/,end:">", -subLanguage:"xml",relevance:0},t={variants:[{begin:/\[.+?\]\[.*?\]/,relevance:0 -},{begin:/\[.+?\]\(((data|javascript|mailto):|(?:http|ftp)s?:\/\/).*?\)/, -relevance:2},{begin:b(/\[.+?\]\(/,/[A-Za-z][A-Za-z0-9+.-]*/,/:\/\/.*?\)/), -relevance:2},{begin:/\[.+?\]\([./?&#].*?\)/,relevance:1},{ -begin:/\[.+?\]\(.*?\)/,relevance:0}],returnBegin:!0,contains:[{ -className:"string",relevance:0,begin:"\\[",end:"\\]",excludeBegin:!0, -returnEnd:!0},{className:"link",relevance:0,begin:"\\]\\(",end:"\\)", -excludeBegin:!0,excludeEnd:!0},{className:"symbol",relevance:0,begin:"\\]\\[", -end:"\\]",excludeBegin:!0,excludeEnd:!0}]},a={className:"strong",contains:[], -variants:[{begin:/_{2}/,end:/_{2}/},{begin:/\*{2}/,end:/\*{2}/}]},i={ -className:"emphasis",contains:[],variants:[{begin:/\*(?!\*)/,end:/\*/},{ -begin:/_(?!_)/,end:/_/,relevance:0}]};a.contains.push(i),i.contains.push(a) -;let s=[n,t] -;return a.contains=a.contains.concat(s),i.contains=i.contains.concat(s), -s=s.concat(a,i),{name:"Markdown",aliases:["md","mkdown","mkd"],contains:[{ -className:"section",variants:[{begin:"^#{1,6}",end:"$",contains:s},{ -begin:"(?=^.+?\\n[=-]{2,}$)",contains:[{begin:"^[=-]*$"},{begin:"^",end:"\\n", -contains:s}]}]},n,{className:"bullet",begin:"^[ \t]*([*+-]|(\\d+\\.))(?=\\s+)", -end:"\\s+",excludeEnd:!0},a,i,{className:"quote",begin:"^>\\s+",contains:s, -end:"$"},{className:"code",variants:[{begin:"(`{3,})[^`](.|\\n)*?\\1`*[ ]*"},{ -begin:"(~{3,})[^~](.|\\n)*?\\1~*[ ]*"},{begin:"```",end:"```+[ ]*$"},{ -begin:"~~~",end:"~~~+[ ]*$"},{begin:"`.+?`"},{begin:"(?=^( {4}|\\t))", -contains:[{begin:"^( {4}|\\t)",end:"(\\n)$"}],relevance:0}]},{ -begin:"^[-\\*]{3,}",end:"$"},t,{begin:/^\[[^\n]+\]:/,returnBegin:!0,contains:[{ -className:"symbol",begin:/\[/,end:/\]/,excludeBegin:!0,excludeEnd:!0},{ -className:"link",begin:/:\s*/,end:/$/,excludeBegin:!0}]}]}},grmr_objectivec:e=>{ -const n=/[a-zA-Z@][a-zA-Z0-9_]*/,t={$pattern:n, -keyword:["@interface","@class","@protocol","@implementation"]};return{ -name:"Objective-C",aliases:["mm","objc","obj-c","obj-c++","objective-c++"], -keywords:{$pattern:n, -keyword:["int","float","while","char","export","sizeof","typedef","const","struct","for","union","unsigned","long","volatile","static","bool","mutable","if","do","return","goto","void","enum","else","break","extern","asm","case","short","default","double","register","explicit","signed","typename","this","switch","continue","wchar_t","inline","readonly","assign","readwrite","self","@synchronized","id","typeof","nonatomic","super","unichar","IBOutlet","IBAction","strong","weak","copy","in","out","inout","bycopy","byref","oneway","__strong","__weak","__block","__autoreleasing","@private","@protected","@public","@try","@property","@end","@throw","@catch","@finally","@autoreleasepool","@synthesize","@dynamic","@selector","@optional","@required","@encode","@package","@import","@defs","@compatibility_alias","__bridge","__bridge_transfer","__bridge_retained","__bridge_retain","__covariant","__contravariant","__kindof","_Nonnull","_Nullable","_Null_unspecified","__FUNCTION__","__PRETTY_FUNCTION__","__attribute__","getter","setter","retain","unsafe_unretained","nonnull","nullable","null_unspecified","null_resettable","class","instancetype","NS_DESIGNATED_INITIALIZER","NS_UNAVAILABLE","NS_REQUIRES_SUPER","NS_RETURNS_INNER_POINTER","NS_INLINE","NS_AVAILABLE","NS_DEPRECATED","NS_ENUM","NS_OPTIONS","NS_SWIFT_UNAVAILABLE","NS_ASSUME_NONNULL_BEGIN","NS_ASSUME_NONNULL_END","NS_REFINED_FOR_SWIFT","NS_SWIFT_NAME","NS_SWIFT_NOTHROW","NS_DURING","NS_HANDLER","NS_ENDHANDLER","NS_VALUERETURN","NS_VOIDRETURN"], -literal:["false","true","FALSE","TRUE","nil","YES","NO","NULL"], -built_in:["BOOL","dispatch_once_t","dispatch_queue_t","dispatch_sync","dispatch_async","dispatch_once"] -},illegal:"/,end:/$/,illegal:"\\n" -},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{className:"class", -begin:"("+t.keyword.join("|")+")\\b",end:/(\{|$)/,excludeEnd:!0,keywords:t, -contains:[e.UNDERSCORE_TITLE_MODE]},{begin:"\\."+e.UNDERSCORE_IDENT_RE, -relevance:0}]}},grmr_perl:e=>{const n=/[dualxmsipngr]{0,12}/,t={ -$pattern:/[\w.]+/, -keyword:"abs accept alarm and atan2 bind binmode bless break caller chdir chmod chomp chop chown chr chroot close closedir connect continue cos crypt dbmclose dbmopen defined delete die do dump each else elsif endgrent endhostent endnetent endprotoent endpwent endservent eof eval exec exists exit exp fcntl fileno flock for foreach fork format formline getc getgrent getgrgid getgrnam gethostbyaddr gethostbyname gethostent getlogin getnetbyaddr getnetbyname getnetent getpeername getpgrp getpriority getprotobyname getprotobynumber getprotoent getpwent getpwnam getpwuid getservbyname getservbyport getservent getsockname getsockopt given glob gmtime goto grep gt hex if index int ioctl join keys kill last lc lcfirst length link listen local localtime log lstat lt ma map mkdir msgctl msgget msgrcv msgsnd my ne next no not oct open opendir or ord our pack package pipe pop pos print printf prototype push q|0 qq quotemeta qw qx rand read readdir readline readlink readpipe recv redo ref rename require reset return reverse rewinddir rindex rmdir say scalar seek seekdir select semctl semget semop send setgrent sethostent setnetent setpgrp setpriority setprotoent setpwent setservent setsockopt shift shmctl shmget shmread shmwrite shutdown sin sleep socket socketpair sort splice split sprintf sqrt srand stat state study sub substr symlink syscall sysopen sysread sysseek system syswrite tell telldir tie tied time times tr truncate uc ucfirst umask undef unless unlink unpack unshift untie until use utime values vec wait waitpid wantarray warn when while write x|0 xor y|0" -},a={className:"subst",begin:"[$@]\\{",end:"\\}",keywords:t},i={begin:/->\{/, -end:/\}/},s={variants:[{begin:/\$\d/},{ -begin:b(/[$%@](\^\w\b|#\w+(::\w+)*|\{\w+\}|\w+(::\w*)*)/,"(?![A-Za-z])(?![@$%])") -},{begin:/[$%@][^\s\w{]/,relevance:0}] -},r=[e.BACKSLASH_ESCAPE,a,s],o=[/!/,/\//,/\|/,/\?/,/'/,/"/,/#/],l=(e,t,a="\\1")=>{ -const i="\\1"===a?a:b(a,t) -;return b(b("(?:",e,")"),t,/(?:\\.|[^\\\/])*?/,i,/(?:\\.|[^\\\/])*?/,a,n) -},c=(e,t,a)=>b(b("(?:",e,")"),t,/(?:\\.|[^\\\/])*?/,a,n),d=[s,e.HASH_COMMENT_MODE,e.COMMENT(/^=\w/,/=cut/,{ -endsWithParent:!0}),i,{className:"string",contains:r,variants:[{ -begin:"q[qwxr]?\\s*\\(",end:"\\)",relevance:5},{begin:"q[qwxr]?\\s*\\[", -end:"\\]",relevance:5},{begin:"q[qwxr]?\\s*\\{",end:"\\}",relevance:5},{ -begin:"q[qwxr]?\\s*\\|",end:"\\|",relevance:5},{begin:"q[qwxr]?\\s*<",end:">", -relevance:5},{begin:"qw\\s+q",end:"q",relevance:5},{begin:"'",end:"'", -contains:[e.BACKSLASH_ESCAPE]},{begin:'"',end:'"'},{begin:"`",end:"`", -contains:[e.BACKSLASH_ESCAPE]},{begin:/\{\w+\}/,relevance:0},{ -begin:"-?\\w+\\s*=>",relevance:0}]},{className:"number", -begin:"(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b", -relevance:0},{ -begin:"(\\/\\/|"+e.RE_STARTERS_RE+"|\\b(split|return|print|reverse|grep)\\b)\\s*", -keywords:"split return print reverse grep",relevance:0, -contains:[e.HASH_COMMENT_MODE,{className:"regexp",variants:[{ -begin:l("s|tr|y",m(...o,{capture:!0}))},{begin:l("s|tr|y","\\(","\\)")},{ -begin:l("s|tr|y","\\[","\\]")},{begin:l("s|tr|y","\\{","\\}")}],relevance:2},{ -className:"regexp",variants:[{begin:/(m|qr)\/\//,relevance:0},{ -begin:c("(?:m|qr)?",/\//,/\//)},{begin:c("m|qr",m(...o,{capture:!0}),/\1/)},{ -begin:c("m|qr",/\(/,/\)/)},{begin:c("m|qr",/\[/,/\]/)},{ -begin:c("m|qr",/\{/,/\}/)}]}]},{className:"function",beginKeywords:"sub", -end:"(\\s*\\(.*?\\))?[;{]",excludeEnd:!0,relevance:5,contains:[e.TITLE_MODE]},{ -begin:"-\\w\\b",relevance:0},{begin:"^__DATA__$",end:"^__END__$", -subLanguage:"mojolicious",contains:[{begin:"^@@.*",end:"$",className:"comment"}] -}];return a.contains=d,i.contains=d,{name:"Perl",aliases:["pl","pm"],keywords:t, -contains:d}},grmr_php:e=>{const n={className:"variable", -begin:"\\$+[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*(?![A-Za-z0-9])(?![$])"},t={ -className:"meta",variants:[{begin:/<\?php/,relevance:10},{begin:/<\?[=]?/},{ -begin:/\?>/}]},a={className:"subst",variants:[{begin:/\$\w+/},{begin:/\{\$/, -end:/\}/}]},i=e.inherit(e.APOS_STRING_MODE,{illegal:null -}),s=e.inherit(e.QUOTE_STRING_MODE,{illegal:null, -contains:e.QUOTE_STRING_MODE.contains.concat(a)}),r=e.END_SAME_AS_BEGIN({ -begin:/<<<[ \t]*(\w+)\n/,end:/[ \t]*(\w+)\b/, -contains:e.QUOTE_STRING_MODE.contains.concat(a)}),o={className:"string", -contains:[e.BACKSLASH_ESCAPE,t],variants:[e.inherit(i,{begin:"b'",end:"'" -}),e.inherit(s,{begin:'b"',end:'"'}),s,i,r]},l={className:"number",variants:[{ -begin:"\\b0b[01]+(?:_[01]+)*\\b"},{begin:"\\b0o[0-7]+(?:_[0-7]+)*\\b"},{ -begin:"\\b0x[\\da-f]+(?:_[\\da-f]+)*\\b"},{ -begin:"(?:\\b\\d+(?:_\\d+)*(\\.(?:\\d+(?:_\\d+)*))?|\\B\\.\\d+)(?:e[+-]?\\d+)?" -}],relevance:0},c={ -keyword:"__CLASS__ __DIR__ __FILE__ __FUNCTION__ __LINE__ __METHOD__ __NAMESPACE__ __TRAIT__ die echo exit include include_once print require require_once array abstract and as binary bool boolean break callable case catch class clone const continue declare default do double else elseif empty enddeclare endfor endforeach endif endswitch endwhile enum eval extends final finally float for foreach from global goto if implements instanceof insteadof int integer interface isset iterable list match|0 mixed new object or private protected public real return string switch throw trait try unset use var void while xor yield", -literal:"false null true", -built_in:"Error|0 AppendIterator ArgumentCountError ArithmeticError ArrayIterator ArrayObject AssertionError BadFunctionCallException BadMethodCallException CachingIterator CallbackFilterIterator CompileError Countable DirectoryIterator DivisionByZeroError DomainException EmptyIterator ErrorException Exception FilesystemIterator FilterIterator GlobIterator InfiniteIterator InvalidArgumentException IteratorIterator LengthException LimitIterator LogicException MultipleIterator NoRewindIterator OutOfBoundsException OutOfRangeException OuterIterator OverflowException ParentIterator ParseError RangeException RecursiveArrayIterator RecursiveCachingIterator RecursiveCallbackFilterIterator RecursiveDirectoryIterator RecursiveFilterIterator RecursiveIterator RecursiveIteratorIterator RecursiveRegexIterator RecursiveTreeIterator RegexIterator RuntimeException SeekableIterator SplDoublyLinkedList SplFileInfo SplFileObject SplFixedArray SplHeap SplMaxHeap SplMinHeap SplObjectStorage SplObserver SplObserver SplPriorityQueue SplQueue SplStack SplSubject SplSubject SplTempFileObject TypeError UnderflowException UnexpectedValueException UnhandledMatchError ArrayAccess Closure Generator Iterator IteratorAggregate Serializable Stringable Throwable Traversable WeakReference WeakMap Directory __PHP_Incomplete_Class parent php_user_filter self static stdClass" -};return{case_insensitive:!0,keywords:c, -contains:[e.HASH_COMMENT_MODE,e.COMMENT("//","$",{contains:[t] -}),e.COMMENT("/\\*","\\*/",{contains:[{className:"doctag",begin:"@[A-Za-z]+"}] -}),e.COMMENT("__halt_compiler.+?;",!1,{endsWithParent:!0, -keywords:"__halt_compiler"}),t,{className:"keyword",begin:/\$this\b/},n,{ -begin:/(::|->)+[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*/},{className:"function", -relevance:0,beginKeywords:"fn function",end:/[;{]/,excludeEnd:!0, -illegal:"[$%\\[]",contains:[{beginKeywords:"use"},e.UNDERSCORE_TITLE_MODE,{ -begin:"=>",endsParent:!0},{className:"params",begin:"\\(",end:"\\)", -excludeBegin:!0,excludeEnd:!0,keywords:c, -contains:["self",n,e.C_BLOCK_COMMENT_MODE,o,l]}]},{className:"class",variants:[{ -beginKeywords:"enum",illegal:/[($"]/},{beginKeywords:"class interface trait", -illegal:/[:($"]/}],relevance:0,end:/\{/,excludeEnd:!0,contains:[{ -beginKeywords:"extends implements"},e.UNDERSCORE_TITLE_MODE]},{ -beginKeywords:"namespace",relevance:0,end:";",illegal:/[.']/, -contains:[e.UNDERSCORE_TITLE_MODE]},{beginKeywords:"use",relevance:0,end:";", -contains:[e.UNDERSCORE_TITLE_MODE]},o,l]}},grmr_php_template:e=>({ -name:"PHP template",subLanguage:"xml",contains:[{begin:/<\?(php|=)?/,end:/\?>/, -subLanguage:"php",contains:[{begin:"/\\*",end:"\\*/",skip:!0},{begin:'b"', -end:'"',skip:!0},{begin:"b'",end:"'",skip:!0},e.inherit(e.APOS_STRING_MODE,{ -illegal:null,className:null,contains:null,skip:!0 -}),e.inherit(e.QUOTE_STRING_MODE,{illegal:null,className:null,contains:null, -skip:!0})]}]}),grmr_plaintext:e=>({name:"Plain text",aliases:["text","txt"], -disableAutodetect:!0}),grmr_python:e=>{const n={$pattern:/[A-Za-z]\w+|__\w+__/, -keyword:["and","as","assert","async","await","break","class","continue","def","del","elif","else","except","finally","for","from","global","if","import","in","is","lambda","nonlocal|10","not","or","pass","raise","return","try","while","with","yield"], -built_in:["__import__","abs","all","any","ascii","bin","bool","breakpoint","bytearray","bytes","callable","chr","classmethod","compile","complex","delattr","dict","dir","divmod","enumerate","eval","exec","filter","float","format","frozenset","getattr","globals","hasattr","hash","help","hex","id","input","int","isinstance","issubclass","iter","len","list","locals","map","max","memoryview","min","next","object","oct","open","ord","pow","print","property","range","repr","reversed","round","set","setattr","slice","sorted","staticmethod","str","sum","super","tuple","type","vars","zip"], -literal:["__debug__","Ellipsis","False","None","NotImplemented","True"], -type:["Any","Callable","Coroutine","Dict","List","Literal","Generic","Optional","Sequence","Set","Tuple","Type","Union"] -},t={className:"meta",begin:/^(>>>|\.\.\.) /},a={className:"subst",begin:/\{/, -end:/\}/,keywords:n,illegal:/#/},i={begin:/\{\{/,relevance:0},s={ -className:"string",contains:[e.BACKSLASH_ESCAPE],variants:[{ -begin:/([uU]|[bB]|[rR]|[bB][rR]|[rR][bB])?'''/,end:/'''/, -contains:[e.BACKSLASH_ESCAPE,t],relevance:10},{ -begin:/([uU]|[bB]|[rR]|[bB][rR]|[rR][bB])?"""/,end:/"""/, -contains:[e.BACKSLASH_ESCAPE,t],relevance:10},{ -begin:/([fF][rR]|[rR][fF]|[fF])'''/,end:/'''/, -contains:[e.BACKSLASH_ESCAPE,t,i,a]},{begin:/([fF][rR]|[rR][fF]|[fF])"""/, -end:/"""/,contains:[e.BACKSLASH_ESCAPE,t,i,a]},{begin:/([uU]|[rR])'/,end:/'/, -relevance:10},{begin:/([uU]|[rR])"/,end:/"/,relevance:10},{ -begin:/([bB]|[bB][rR]|[rR][bB])'/,end:/'/},{begin:/([bB]|[bB][rR]|[rR][bB])"/, -end:/"/},{begin:/([fF][rR]|[rR][fF]|[fF])'/,end:/'/, -contains:[e.BACKSLASH_ESCAPE,i,a]},{begin:/([fF][rR]|[rR][fF]|[fF])"/,end:/"/, -contains:[e.BACKSLASH_ESCAPE,i,a]},e.APOS_STRING_MODE,e.QUOTE_STRING_MODE] -},r="[0-9](_?[0-9])*",o=`(\\b(${r}))?\\.(${r})|\\b(${r})\\.`,l={ -className:"number",relevance:0,variants:[{ -begin:`(\\b(${r})|(${o}))[eE][+-]?(${r})[jJ]?\\b`},{begin:`(${o})[jJ]?`},{ -begin:"\\b([1-9](_?[0-9])*|0+(_?0)*)[lLjJ]?\\b"},{ -begin:"\\b0[bB](_?[01])+[lL]?\\b"},{begin:"\\b0[oO](_?[0-7])+[lL]?\\b"},{ -begin:"\\b0[xX](_?[0-9a-fA-F])+[lL]?\\b"},{begin:`\\b(${r})[jJ]\\b`}]},c={ -className:"comment",begin:g(/# type:/),end:/$/,keywords:n,contains:[{ -begin:/# type:/},{begin:/#/,end:/\b\B/,endsWithParent:!0}]},d={ -className:"params",variants:[{className:"",begin:/\(\s*\)/,skip:!0},{begin:/\(/, -end:/\)/,excludeBegin:!0,excludeEnd:!0,keywords:n, -contains:["self",t,l,s,e.HASH_COMMENT_MODE]}]};return a.contains=[s,l,t],{ -name:"Python",aliases:["py","gyp","ipython"],keywords:n, -illegal:/(<\/|->|\?)|=>/,contains:[t,l,{begin:/\bself\b/},{beginKeywords:"if", -relevance:0},s,c,e.HASH_COMMENT_MODE,{match:[/def/,/\s+/,h],scope:{1:"keyword", -3:"title.function"},contains:[d]},{variants:[{ -match:[/class/,/\s+/,h,/\s*/,/\(\s*/,h,/\s*\)/]},{match:[/class/,/\s+/,h]}], -scope:{1:"keyword",3:"title.class",6:"title.class.inherited"}},{ -className:"meta",begin:/^[\t ]*@/,end:/(?=#)|$/,contains:[l,d,s]}]}}, -grmr_python_repl:e=>({aliases:["pycon"],contains:[{className:"meta",starts:{ -end:/ |$/,starts:{end:"$",subLanguage:"python"}},variants:[{ -begin:/^>>>(?=[ ]|$)/},{begin:/^\.\.\.(?=[ ]|$)/}]}]}),grmr_r:e=>{ -const n=/(?:(?:[a-zA-Z]|\.[._a-zA-Z])[._a-zA-Z0-9]*)|\.(?!\d)/;return{name:"R", -illegal:/->/,keywords:{$pattern:n, -keyword:"function if in break next repeat else for while", -literal:"NULL NA TRUE FALSE Inf NaN NA_integer_|10 NA_real_|10 NA_character_|10 NA_complex_|10", -built_in:"LETTERS letters month.abb month.name pi T F abs acos acosh all any anyNA Arg as.call as.character as.complex as.double as.environment as.integer as.logical as.null.default as.numeric as.raw asin asinh atan atanh attr attributes baseenv browser c call ceiling class Conj cos cosh cospi cummax cummin cumprod cumsum digamma dim dimnames emptyenv exp expression floor forceAndCall gamma gc.time globalenv Im interactive invisible is.array is.atomic is.call is.character is.complex is.double is.environment is.expression is.finite is.function is.infinite is.integer is.language is.list is.logical is.matrix is.na is.name is.nan is.null is.numeric is.object is.pairlist is.raw is.recursive is.single is.symbol lazyLoadDBfetch length lgamma list log max min missing Mod names nargs nzchar oldClass on.exit pos.to.env proc.time prod quote range Re rep retracemem return round seq_along seq_len seq.int sign signif sin sinh sinpi sqrt standardGeneric substitute sum switch tan tanh tanpi tracemem trigamma trunc unclass untracemem UseMethod xtfrm" -},contains:[e.COMMENT(/#'/,/$/,{contains:[{className:"doctag",begin:"@examples", -starts:{contains:[{begin:/\n/},{begin:/#'\s*(?=@[a-zA-Z]+)/,endsParent:!0},{ -begin:/#'/,end:/$/,excludeBegin:!0}]}},{className:"doctag",begin:"@param", -end:/$/,contains:[{className:"variable",variants:[{begin:n},{ -begin:/`(?:\\.|[^`\\])+`/}],endsParent:!0}]},{className:"doctag", -begin:/@[a-zA-Z]+/},{className:"keyword",begin:/\\[a-zA-Z]+/}] -}),e.HASH_COMMENT_MODE,{className:"string",contains:[e.BACKSLASH_ESCAPE], -variants:[e.END_SAME_AS_BEGIN({begin:/[rR]"(-*)\(/,end:/\)(-*)"/ -}),e.END_SAME_AS_BEGIN({begin:/[rR]"(-*)\{/,end:/\}(-*)"/ -}),e.END_SAME_AS_BEGIN({begin:/[rR]"(-*)\[/,end:/\](-*)"/ -}),e.END_SAME_AS_BEGIN({begin:/[rR]'(-*)\(/,end:/\)(-*)'/ -}),e.END_SAME_AS_BEGIN({begin:/[rR]'(-*)\{/,end:/\}(-*)'/ -}),e.END_SAME_AS_BEGIN({begin:/[rR]'(-*)\[/,end:/\](-*)'/}),{begin:'"',end:'"', -relevance:0},{begin:"'",end:"'",relevance:0}]},{relevance:0,className:{ -2:"number"},variants:[{ -match:[/[^a-zA-Z0-9._]/,/0[xX][0-9a-fA-F]+\.[0-9a-fA-F]*[pP][+-]?\d+i?/]},{ -match:[/[^a-zA-Z0-9._]/,/0[xX][0-9a-fA-F]+(?:[pP][+-]?\d+)?[Li]?/]},{ -match:[/[^a-zA-Z0-9._]/,/(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?[Li]?/]}]},{ -begin:"%",end:"%"},{begin:b(/[a-zA-Z][a-zA-Z_0-9]*/,"\\s+<-\\s+")},{begin:"`", -end:"`",contains:[{begin:/\\./}]}]}},grmr_ruby:e=>{ -const n="([a-zA-Z_]\\w*[!?=]?|[-+~]@|<<|>>|=~|===?|<=>|[<>]=?|\\*\\*|[-/+%^&*~`|]|\\[\\]=?)",t={ -keyword:"and then defined module in return redo if BEGIN retry end for self when next until do begin unless END rescue else break undef not super class case require yield alias while ensure elsif or include attr_reader attr_writer attr_accessor __FILE__", -built_in:"proc lambda",literal:"true false nil"},a={className:"doctag", -begin:"@[A-Za-z]+"},i={begin:"#<",end:">"},s=[e.COMMENT("#","$",{contains:[a] -}),e.COMMENT("^=begin","^=end",{contains:[a],relevance:10 -}),e.COMMENT("^__END__","\\n$")],r={className:"subst",begin:/#\{/,end:/\}/, -keywords:t},o={className:"string",contains:[e.BACKSLASH_ESCAPE,r],variants:[{ -begin:/'/,end:/'/},{begin:/"/,end:/"/},{begin:/`/,end:/`/},{begin:/%[qQwWx]?\(/, -end:/\)/},{begin:/%[qQwWx]?\[/,end:/\]/},{begin:/%[qQwWx]?\{/,end:/\}/},{ -begin:/%[qQwWx]?/},{begin:/%[qQwWx]?\//,end:/\//},{begin:/%[qQwWx]?%/, -end:/%/},{begin:/%[qQwWx]?-/,end:/-/},{begin:/%[qQwWx]?\|/,end:/\|/},{ -begin:/\B\?(\\\d{1,3})/},{begin:/\B\?(\\x[A-Fa-f0-9]{1,2})/},{ -begin:/\B\?(\\u\{?[A-Fa-f0-9]{1,6}\}?)/},{ -begin:/\B\?(\\M-\\C-|\\M-\\c|\\c\\M-|\\M-|\\C-\\M-)[\x20-\x7e]/},{ -begin:/\B\?\\(c|C-)[\x20-\x7e]/},{begin:/\B\?\\?\S/},{ -begin:b(/<<[-~]?'?/,g(/(\w+)(?=\W)[^\n]*\n(?:[^\n]*\n)*?\s*\1\b/)), -contains:[e.END_SAME_AS_BEGIN({begin:/(\w+)/,end:/(\w+)/, -contains:[e.BACKSLASH_ESCAPE,r]})]}]},l="[0-9](_?[0-9])*",c={className:"number", -relevance:0,variants:[{ -begin:`\\b([1-9](_?[0-9])*|0)(\\.(${l}))?([eE][+-]?(${l})|r)?i?\\b`},{ -begin:"\\b0[dD][0-9](_?[0-9])*r?i?\\b"},{begin:"\\b0[bB][0-1](_?[0-1])*r?i?\\b" -},{begin:"\\b0[oO][0-7](_?[0-7])*r?i?\\b"},{ -begin:"\\b0[xX][0-9a-fA-F](_?[0-9a-fA-F])*r?i?\\b"},{ -begin:"\\b0(_?[0-7])+r?i?\\b"}]},d={className:"params",begin:"\\(",end:"\\)", -endsParent:!0,keywords:t},u=[o,{className:"class",beginKeywords:"class module", -end:"$|;",illegal:/=/,contains:[e.inherit(e.TITLE_MODE,{ -begin:"[A-Za-z_]\\w*(::\\w+)*(\\?|!)?"}),{begin:"<\\s*",contains:[{ -begin:"("+e.IDENT_RE+"::)?"+e.IDENT_RE,relevance:0}]}].concat(s)},{ -className:"function",begin:b(/def\s+/,g(n+"\\s*(\\(|;|$)")),relevance:0, -keywords:"def",end:"$|;",contains:[e.inherit(e.TITLE_MODE,{begin:n -}),d].concat(s)},{begin:e.IDENT_RE+"::"},{className:"symbol", -begin:e.UNDERSCORE_IDENT_RE+"(!|\\?)?:",relevance:0},{className:"symbol", -begin:":(?!\\s)",contains:[o,{begin:n}],relevance:0},c,{className:"variable", -begin:"(\\$\\W)|((\\$|@@?)(\\w+))(?=[^@$?])(?![A-Za-z])(?![@$?'])"},{ -className:"params",begin:/\|/,end:/\|/,relevance:0,keywords:t},{ -begin:"("+e.RE_STARTERS_RE+"|unless)\\s*",keywords:"unless",contains:[{ -className:"regexp",contains:[e.BACKSLASH_ESCAPE,r],illegal:/\n/,variants:[{ -begin:"/",end:"/[a-z]*"},{begin:/%r\{/,end:/\}[a-z]*/},{begin:"%r\\(", -end:"\\)[a-z]*"},{begin:"%r!",end:"![a-z]*"},{begin:"%r\\[",end:"\\][a-z]*"}] -}].concat(i,s),relevance:0}].concat(i,s);r.contains=u,d.contains=u;const m=[{ -begin:/^\s*=>/,starts:{end:"$",contains:u}},{className:"meta", -begin:"^([>?]>|[\\w#]+\\(\\w+\\):\\d+:\\d+>|(\\w+-)?\\d+\\.\\d+\\.\\d+(p\\d+)?[^\\d][^>]+>)(?=[ ])", -starts:{end:"$",contains:u}}];return s.unshift(i),{name:"Ruby", -aliases:["rb","gemspec","podspec","thor","irb"],keywords:t,illegal:/\/\*/, -contains:[e.SHEBANG({binary:"ruby"})].concat(m).concat(s).concat(u)}}, -grmr_rust:e=>{const n={className:"title.function.invoke",relevance:0, -begin:b(/\b/,/(?!let\b)/,e.IDENT_RE,g(/\s*\(/)) -},t="([ui](8|16|32|64|128|size)|f(32|64))?",a=["drop ","Copy","Send","Sized","Sync","Drop","Fn","FnMut","FnOnce","ToOwned","Clone","Debug","PartialEq","PartialOrd","Eq","Ord","AsRef","AsMut","Into","From","Default","Iterator","Extend","IntoIterator","DoubleEndedIterator","ExactSizeIterator","SliceConcatExt","ToString","assert!","assert_eq!","bitflags!","bytes!","cfg!","col!","concat!","concat_idents!","debug_assert!","debug_assert_eq!","env!","panic!","file!","format!","format_args!","include_bin!","include_str!","line!","local_data_key!","module_path!","option_env!","print!","println!","select!","stringify!","try!","unimplemented!","unreachable!","vec!","write!","writeln!","macro_rules!","assert_ne!","debug_assert_ne!"] -;return{name:"Rust",aliases:["rs"],keywords:{$pattern:e.IDENT_RE+"!?", -type:["i8","i16","i32","i64","i128","isize","u8","u16","u32","u64","u128","usize","f32","f64","str","char","bool","Box","Option","Result","String","Vec"], -keyword:["abstract","as","async","await","become","box","break","const","continue","crate","do","dyn","else","enum","extern","false","final","fn","for","if","impl","in","let","loop","macro","match","mod","move","mut","override","priv","pub","ref","return","self","Self","static","struct","super","trait","true","try","type","typeof","unsafe","unsized","use","virtual","where","while","yield"], -literal:["true","false","Some","None","Ok","Err"],built_in:a},illegal:""},n]}}, -grmr_scss:e=>{const n=ee(e),t=ie,a=ae,i="@[a-z-]+",s={className:"variable", -begin:"(\\$[a-zA-Z-][a-zA-Z0-9_-]*)\\b"};return{name:"SCSS",case_insensitive:!0, -illegal:"[=/|']",contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,{ -className:"selector-id",begin:"#[A-Za-z0-9_-]+",relevance:0},{ -className:"selector-class",begin:"\\.[A-Za-z0-9_-]+",relevance:0 -},n.ATTRIBUTE_SELECTOR_MODE,{className:"selector-tag", -begin:"\\b("+ne.join("|")+")\\b",relevance:0},{className:"selector-pseudo", -begin:":("+a.join("|")+")"},{className:"selector-pseudo", -begin:"::("+t.join("|")+")"},s,{begin:/\(/,end:/\)/,contains:[n.CSS_NUMBER_MODE] -},{className:"attribute",begin:"\\b("+se.join("|")+")\\b"},{ -begin:"\\b(whitespace|wait|w-resize|visible|vertical-text|vertical-ideographic|uppercase|upper-roman|upper-alpha|underline|transparent|top|thin|thick|text|text-top|text-bottom|tb-rl|table-header-group|table-footer-group|sw-resize|super|strict|static|square|solid|small-caps|separate|se-resize|scroll|s-resize|rtl|row-resize|ridge|right|repeat|repeat-y|repeat-x|relative|progress|pointer|overline|outside|outset|oblique|nowrap|not-allowed|normal|none|nw-resize|no-repeat|no-drop|newspaper|ne-resize|n-resize|move|middle|medium|ltr|lr-tb|lowercase|lower-roman|lower-alpha|loose|list-item|line|line-through|line-edge|lighter|left|keep-all|justify|italic|inter-word|inter-ideograph|inside|inset|inline|inline-block|inherit|inactive|ideograph-space|ideograph-parenthesis|ideograph-numeric|ideograph-alpha|horizontal|hidden|help|hand|groove|fixed|ellipsis|e-resize|double|dotted|distribute|distribute-space|distribute-letter|distribute-all-lines|disc|disabled|default|decimal|dashed|crosshair|collapse|col-resize|circle|char|center|capitalize|break-word|break-all|bottom|both|bolder|bold|block|bidi-override|below|baseline|auto|always|all-scroll|absolute|table|table-cell)\\b" -},{begin:":",end:";", -contains:[s,n.HEXCOLOR,n.CSS_NUMBER_MODE,e.QUOTE_STRING_MODE,e.APOS_STRING_MODE,n.IMPORTANT] -},{begin:"@(page|font-face)",keywords:{$pattern:i,keyword:"@page @font-face"}},{ -begin:"@",end:"[{;]",returnBegin:!0,keywords:{$pattern:/[a-z-]+/, -keyword:"and or not only",attribute:te.join(" ")},contains:[{begin:i, -className:"keyword"},{begin:/[a-z-]+(?=:)/,className:"attribute" -},s,e.QUOTE_STRING_MODE,e.APOS_STRING_MODE,n.HEXCOLOR,n.CSS_NUMBER_MODE]}]}}, -grmr_shell:e=>({name:"Shell Session",aliases:["console","shellsession"], -contains:[{className:"meta",begin:/^\s{0,3}[/~\w\d[\]()@-]*[>%$#][ ]?/,starts:{ -end:/[^\\](?=\s*$)/,subLanguage:"bash"}}]}),grmr_sql:e=>{ -const n=e.COMMENT("--","$"),t=["true","false","unknown"],a=["bigint","binary","blob","boolean","char","character","clob","date","dec","decfloat","decimal","float","int","integer","interval","nchar","nclob","national","numeric","real","row","smallint","time","timestamp","varchar","varying","varbinary"],i=["abs","acos","array_agg","asin","atan","avg","cast","ceil","ceiling","coalesce","corr","cos","cosh","count","covar_pop","covar_samp","cume_dist","dense_rank","deref","element","exp","extract","first_value","floor","json_array","json_arrayagg","json_exists","json_object","json_objectagg","json_query","json_table","json_table_primitive","json_value","lag","last_value","lead","listagg","ln","log","log10","lower","max","min","mod","nth_value","ntile","nullif","percent_rank","percentile_cont","percentile_disc","position","position_regex","power","rank","regr_avgx","regr_avgy","regr_count","regr_intercept","regr_r2","regr_slope","regr_sxx","regr_sxy","regr_syy","row_number","sin","sinh","sqrt","stddev_pop","stddev_samp","substring","substring_regex","sum","tan","tanh","translate","translate_regex","treat","trim","trim_array","unnest","upper","value_of","var_pop","var_samp","width_bucket"],s=["create table","insert into","primary key","foreign key","not null","alter table","add constraint","grouping sets","on overflow","character set","respect nulls","ignore nulls","nulls first","nulls last","depth first","breadth first"],r=i,o=["abs","acos","all","allocate","alter","and","any","are","array","array_agg","array_max_cardinality","as","asensitive","asin","asymmetric","at","atan","atomic","authorization","avg","begin","begin_frame","begin_partition","between","bigint","binary","blob","boolean","both","by","call","called","cardinality","cascaded","case","cast","ceil","ceiling","char","char_length","character","character_length","check","classifier","clob","close","coalesce","collate","collect","column","commit","condition","connect","constraint","contains","convert","copy","corr","corresponding","cos","cosh","count","covar_pop","covar_samp","create","cross","cube","cume_dist","current","current_catalog","current_date","current_default_transform_group","current_path","current_role","current_row","current_schema","current_time","current_timestamp","current_path","current_role","current_transform_group_for_type","current_user","cursor","cycle","date","day","deallocate","dec","decimal","decfloat","declare","default","define","delete","dense_rank","deref","describe","deterministic","disconnect","distinct","double","drop","dynamic","each","element","else","empty","end","end_frame","end_partition","end-exec","equals","escape","every","except","exec","execute","exists","exp","external","extract","false","fetch","filter","first_value","float","floor","for","foreign","frame_row","free","from","full","function","fusion","get","global","grant","group","grouping","groups","having","hold","hour","identity","in","indicator","initial","inner","inout","insensitive","insert","int","integer","intersect","intersection","interval","into","is","join","json_array","json_arrayagg","json_exists","json_object","json_objectagg","json_query","json_table","json_table_primitive","json_value","lag","language","large","last_value","lateral","lead","leading","left","like","like_regex","listagg","ln","local","localtime","localtimestamp","log","log10","lower","match","match_number","match_recognize","matches","max","member","merge","method","min","minute","mod","modifies","module","month","multiset","national","natural","nchar","nclob","new","no","none","normalize","not","nth_value","ntile","null","nullif","numeric","octet_length","occurrences_regex","of","offset","old","omit","on","one","only","open","or","order","out","outer","over","overlaps","overlay","parameter","partition","pattern","per","percent","percent_rank","percentile_cont","percentile_disc","period","portion","position","position_regex","power","precedes","precision","prepare","primary","procedure","ptf","range","rank","reads","real","recursive","ref","references","referencing","regr_avgx","regr_avgy","regr_count","regr_intercept","regr_r2","regr_slope","regr_sxx","regr_sxy","regr_syy","release","result","return","returns","revoke","right","rollback","rollup","row","row_number","rows","running","savepoint","scope","scroll","search","second","seek","select","sensitive","session_user","set","show","similar","sin","sinh","skip","smallint","some","specific","specifictype","sql","sqlexception","sqlstate","sqlwarning","sqrt","start","static","stddev_pop","stddev_samp","submultiset","subset","substring","substring_regex","succeeds","sum","symmetric","system","system_time","system_user","table","tablesample","tan","tanh","then","time","timestamp","timezone_hour","timezone_minute","to","trailing","translate","translate_regex","translation","treat","trigger","trim","trim_array","true","truncate","uescape","union","unique","unknown","unnest","update","upper","user","using","value","values","value_of","var_pop","var_samp","varbinary","varchar","varying","versioning","when","whenever","where","width_bucket","window","with","within","without","year","add","asc","collation","desc","final","first","last","view"].filter((e=>!i.includes(e))),l={ -begin:b(/\b/,m(...r),/\s*\(/),relevance:0,keywords:{built_in:r}};return{ -name:"SQL",case_insensitive:!0,illegal:/[{}]|<\//,keywords:{ -$pattern:/\b[\w\.]+/,keyword:((e,{exceptions:n,when:t}={})=>{const a=t -;return n=n||[],e.map((e=>e.match(/\|\d+$/)||n.includes(e)?e:a(e)?e+"|0":e)) -})(o,{when:e=>e.length<3}),literal:t,type:a, -built_in:["current_catalog","current_date","current_default_transform_group","current_path","current_role","current_schema","current_transform_group_for_type","current_user","session_user","system_time","system_user","current_time","localtime","current_timestamp","localtimestamp"] -},contains:[{begin:m(...s),relevance:0,keywords:{$pattern:/[\w\.]+/, -keyword:o.concat(s),literal:t,type:a}},{className:"type", -begin:m("double precision","large object","with timezone","without timezone") -},l,{className:"variable",begin:/@[a-z0-9]+/},{className:"string",variants:[{ -begin:/'/,end:/'/,contains:[{begin:/''/}]}]},{begin:/"/,end:/"/,contains:[{ -begin:/""/}]},e.C_NUMBER_MODE,e.C_BLOCK_COMMENT_MODE,n,{className:"operator", -begin:/[-+*/=%^~]|&&?|\|\|?|!=?|<(?:=>?|<|>)?|>[>=]?/,relevance:0}]}}, -grmr_swift:e=>{const n={match:/\s+/,relevance:0},t=e.COMMENT("/\\*","\\*/",{ -contains:["self"]}),a=[e.C_LINE_COMMENT_MODE,t],i={match:[/\./,m(...Ne,...we)], -className:{2:"keyword"}},s={match:b(/\./,m(...Oe)),relevance:0 -},r=Oe.filter((e=>"string"==typeof e)).concat(["_|0"]),o={variants:[{ -className:"keyword", -match:m(...Oe.filter((e=>"string"!=typeof e)).concat(ve).map(ye),...we)}]},l={ -$pattern:m(/\b\w+/,/#\w+/),keyword:r.concat(Se),literal:Me},c=[i,s,o],d=[{ -match:b(/\./,m(...ke)),relevance:0},{className:"built_in", -match:b(/\b/,m(...ke),/(?=\()/)}],u={match:/->/,relevance:0},p=[u,{ -className:"operator",relevance:0,variants:[{match:Te},{match:`\\.(\\.|${Ce})+`}] -}],_="([0-9a-fA-F]_*)+",f={className:"number",relevance:0,variants:[{ -match:"\\b(([0-9]_*)+)(\\.(([0-9]_*)+))?([eE][+-]?(([0-9]_*)+))?\\b"},{ -match:`\\b0x(${_})(\\.(${_}))?([pP][+-]?(([0-9]_*)+))?\\b`},{ -match:/\b0o([0-7]_*)+\b/},{match:/\b0b([01]_*)+\b/}]},h=(e="")=>({ -className:"subst",variants:[{match:b(/\\/,e,/[0\\tnr"']/)},{ -match:b(/\\/,e,/u\{[0-9a-fA-F]{1,8}\}/)}]}),E=(e="")=>({className:"subst", -match:b(/\\/,e,/[\t ]*(?:[\r\n]|\r\n)/)}),y=(e="")=>({className:"subst", -label:"interpol",begin:b(/\\/,e,/\(/),end:/\)/}),N=(e="")=>({begin:b(e,/"""/), -end:b(/"""/,e),contains:[h(e),E(e),y(e)]}),w=(e="")=>({begin:b(e,/"/), -end:b(/"/,e),contains:[h(e),y(e)]}),v={className:"string", -variants:[N(),N("#"),N("##"),N("###"),w(),w("#"),w("##"),w("###")]},O={ -match:b(/`/,Ie,/`/)},M=[O,{className:"variable",match:/\$\d+/},{ -className:"variable",match:`\\$${De}+`}],x=[{match:/(@|#)available/, -className:"keyword",starts:{contains:[{begin:/\(/,end:/\)/,keywords:$e, -contains:[...p,f,v]}]}},{className:"keyword",match:b(/@/,m(...Le))},{ -className:"meta",match:b(/@/,Ie)}],S={match:g(/\b[A-Z]/),relevance:0,contains:[{ -className:"type", -match:b(/(AV|CA|CF|CG|CI|CL|CM|CN|CT|MK|MP|MTK|MTL|NS|SCN|SK|UI|WK|XC)/,De,"+") -},{className:"type",match:Be,relevance:0},{match:/[?!]+/,relevance:0},{ -match:/\.\.\./,relevance:0},{match:b(/\s+&\s+/,g(Be)),relevance:0}]},k={ -begin://,keywords:l,contains:[...a,...c,...x,u,S]};S.contains.push(k) -;const A={begin:/\(/,end:/\)/,relevance:0,keywords:l,contains:["self",{ -match:b(Ie,/\s*:/),keywords:"_|0",relevance:0 -},...a,...c,...d,...p,f,v,...M,...x,S]},C={begin://,contains:[...a,S] -},T={begin:/\(/,end:/\)/,keywords:l,contains:[{ -begin:m(g(b(Ie,/\s*:/)),g(b(Ie,/\s+/,Ie,/\s*:/))),end:/:/,relevance:0, -contains:[{className:"keyword",match:/\b_\b/},{className:"params",match:Ie}] -},...a,...c,...p,f,v,...x,S,A],endsParent:!0,illegal:/["']/},R={ -match:[/func/,/\s+/,m(O.match,Ie,Te)],className:{1:"keyword",3:"title.function" -},contains:[C,T,n],illegal:[/\[/,/%/]},D={ -match:[/\b(?:subscript|init[?!]?)/,/\s*(?=[<(])/],className:{1:"keyword"}, -contains:[C,T,n],illegal:/\[|%/},I={match:[/operator/,/\s+/,Te],className:{ -1:"keyword",3:"title"}},B={begin:[/precedencegroup/,/\s+/,Be],className:{ -1:"keyword",3:"title"},contains:[S],keywords:[...xe,...Me],end:/}/} -;for(const e of v.variants){const n=e.contains.find((e=>"interpol"===e.label)) -;n.keywords=l;const t=[...c,...d,...p,f,v,...M];n.contains=[...t,{begin:/\(/, -end:/\)/,contains:["self",...t]}]}return{name:"Swift",keywords:l, -contains:[...a,R,D,{beginKeywords:"struct protocol class extension enum actor", -end:"\\{",excludeEnd:!0,keywords:l,contains:[e.inherit(e.TITLE_MODE,{ -className:"title.class",begin:/[A-Za-z$_][\u00C0-\u02B80-9A-Za-z$_]*/}),...c] -},I,B,{beginKeywords:"import",end:/$/,contains:[...a],relevance:0 -},...c,...d,...p,f,v,...M,...x,S,A]}},grmr_typescript:e=>{const n={$pattern:ge, -keyword:ue.concat(["type","namespace","typedef","interface","public","private","protected","implements","declare","abstract","readonly"]), -literal:be, -built_in:he.concat(["any","void","number","boolean","string","object","never","enum"]), -"variable.language":fe},t={className:"meta",begin:"@[A-Za-z$_][0-9A-Za-z$_]*" -},a=(e,n,t)=>{const a=e.contains.findIndex((e=>e.label===n)) -;if(-1===a)throw Error("can not find mode to replace");e.contains.splice(a,1,t) -},i=Ee(e) -;return Object.assign(i.keywords,n),i.exports.PARAMS_CONTAINS.push(t),i.contains=i.contains.concat([t,{ -beginKeywords:"namespace",end:/\{/,excludeEnd:!0},{beginKeywords:"interface", -end:/\{/,excludeEnd:!0,keywords:"interface extends" -}]),a(i,"shebang",e.SHEBANG()),a(i,"use_strict",{className:"meta",relevance:10, -begin:/^\s*['"]use strict['"]/ -}),i.contains.find((e=>"func.def"===e.label)).relevance=0,Object.assign(i,{ -name:"TypeScript",aliases:["ts","tsx"]}),i},grmr_vbnet:e=>{ -const n=/\d{1,2}\/\d{1,2}\/\d{4}/,t=/\d{4}-\d{1,2}-\d{1,2}/,a=/(\d|1[012])(:\d+){0,2} *(AM|PM)/,i=/\d{1,2}(:\d{1,2}){1,2}/,s={ -className:"literal",variants:[{begin:b(/# */,m(t,n),/ *#/)},{ -begin:b(/# */,i,/ *#/)},{begin:b(/# */,a,/ *#/)},{ -begin:b(/# */,m(t,n),/ +/,m(a,i),/ *#/)}]},r=e.COMMENT(/'''/,/$/,{contains:[{ -className:"doctag",begin:/<\/?/,end:/>/}]}),o=e.COMMENT(null,/$/,{variants:[{ -begin:/'/},{begin:/([\t ]|^)REM(?=\s)/}]});return{name:"Visual Basic .NET", -aliases:["vb"],case_insensitive:!0,classNameAliases:{label:"symbol"},keywords:{ -keyword:"addhandler alias aggregate ansi as async assembly auto binary by byref byval call case catch class compare const continue custom declare default delegate dim distinct do each equals else elseif end enum erase error event exit explicit finally for friend from function get global goto group handles if implements imports in inherits interface into iterator join key let lib loop me mid module mustinherit mustoverride mybase myclass namespace narrowing new next notinheritable notoverridable of off on operator option optional order overloads overridable overrides paramarray partial preserve private property protected public raiseevent readonly redim removehandler resume return select set shadows shared skip static step stop structure strict sub synclock take text then throw to try unicode until using when where while widening with withevents writeonly yield", -built_in:"addressof and andalso await directcast gettype getxmlnamespace is isfalse isnot istrue like mod nameof new not or orelse trycast typeof xor cbool cbyte cchar cdate cdbl cdec cint clng cobj csbyte cshort csng cstr cuint culng cushort", -type:"boolean byte char date decimal double integer long object sbyte short single string uinteger ulong ushort", -literal:"true false nothing"}, -illegal:"//|\\{|\\}|endif|gosub|variant|wend|^\\$ ",contains:[{ -className:"string",begin:/"(""|[^/n])"C\b/},{className:"string",begin:/"/, -end:/"/,illegal:/\n/,contains:[{begin:/""/}]},s,{className:"number",relevance:0, -variants:[{begin:/\b\d[\d_]*((\.[\d_]+(E[+-]?[\d_]+)?)|(E[+-]?[\d_]+))[RFD@!#]?/ -},{begin:/\b\d[\d_]*((U?[SIL])|[%&])?/},{begin:/&H[\dA-F_]+((U?[SIL])|[%&])?/},{ -begin:/&O[0-7_]+((U?[SIL])|[%&])?/},{begin:/&B[01_]+((U?[SIL])|[%&])?/}]},{ -className:"label",begin:/^\w+:/},r,o,{className:"meta", -begin:/[\t ]*#(const|disable|else|elseif|enable|end|externalsource|if|region)\b/, -end:/$/,keywords:{ -keyword:"const disable else elseif enable end externalsource if region then"}, -contains:[o]}]}},grmr_yaml:e=>{ -const n="true false yes no null",t="[\\w#;/?:@&=+$,.~*'()[\\]]+",a={ -className:"string",relevance:0,variants:[{begin:/'/,end:/'/},{begin:/"/,end:/"/ -},{begin:/\S+/}],contains:[e.BACKSLASH_ESCAPE,{className:"template-variable", -variants:[{begin:/\{\{/,end:/\}\}/},{begin:/%\{/,end:/\}/}]}]},i=e.inherit(a,{ -variants:[{begin:/'/,end:/'/},{begin:/"/,end:/"/},{begin:/[^\s,{}[\]]+/}]}),s={ -end:",",endsWithParent:!0,excludeEnd:!0,keywords:n,relevance:0},r={begin:/\{/, -end:/\}/,contains:[s],illegal:"\\n",relevance:0},o={begin:"\\[",end:"\\]", -contains:[s],illegal:"\\n",relevance:0},l=[{className:"attr",variants:[{ -begin:"\\w[\\w :\\/.-]*:(?=[ \t]|$)"},{begin:'"\\w[\\w :\\/.-]*":(?=[ \t]|$)'},{ -begin:"'\\w[\\w :\\/.-]*':(?=[ \t]|$)"}]},{className:"meta",begin:"^---\\s*$", -relevance:10},{className:"string", -begin:"[\\|>]([1-9]?[+-])?[ ]*\\n( +)[^ ][^\\n]*\\n(\\2[^\\n]+\\n?)*"},{ -begin:"<%[%=-]?",end:"[%-]?%>",subLanguage:"ruby",excludeBegin:!0,excludeEnd:!0, -relevance:0},{className:"type",begin:"!\\w+!"+t},{className:"type", -begin:"!<"+t+">"},{className:"type",begin:"!"+t},{className:"type",begin:"!!"+t -},{className:"meta",begin:"&"+e.UNDERSCORE_IDENT_RE+"$"},{className:"meta", -begin:"\\*"+e.UNDERSCORE_IDENT_RE+"$"},{className:"bullet",begin:"-(?=[ ]|$)", -relevance:0},e.HASH_COMMENT_MODE,{beginKeywords:n,keywords:{literal:n}},{ -className:"number", -begin:"\\b[0-9]{4}(-[0-9][0-9]){0,2}([Tt \\t][0-9][0-9]?(:[0-9][0-9]){2})?(\\.[0-9]*)?([ \\t])*(Z|[-+][0-9][0-9]?(:[0-9][0-9])?)?\\b" -},{className:"number",begin:e.C_NUMBER_RE+"\\b",relevance:0},r,o,a],c=[...l] -;return c.pop(),c.push(i),s.contains=c,{name:"YAML",case_insensitive:!0, -aliases:["yml"],contains:l}}});const Fe=Y;for(const e of Object.keys(ze)){ -const n=e.replace("grmr_","");Fe.registerLanguage(n,ze[e])}return Fe}() -;"object"==typeof exports&&"undefined"!=typeof module&&(module.exports=hljs); \ No newline at end of file diff --git a/docs/index.html b/docs/index.html deleted file mode 100644 index 95e2382..0000000 --- a/docs/index.html +++ /dev/null @@ -1,170 +0,0 @@ - - - - - - - - REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -
-
-

[備忘録] このサイト用の VPS をセットアップしたときのメモ

-
-
-

GitHub Pages でホストしていたこのサイトを VPS へ移行したので、 -そのときにやったことのメモ。99 % 自分用。

-
-
- Posted on -
- -
-
-
-

PHPerKaigi 2023: ボツになったトークン問題 その 1

-
-
-

来年の PHPerKaigi 2023 でデジタルサーカス株式会社から出題予定のトークン問題のうち、 -ボツになった問題を公開する (その 1)。

-
-
- Posted on -
- -
-
-
-

[PHP] fizzbuzz を書く。1行あたり2文字で。

-
-
-

PHP で、fizzbuzz を書いた。ただし、1行あたりに使える文字数は2文字まで。

-
-
- Posted on -
- -
-
-
-

弊社の PHP Foundation への寄付に寄せて

-
-
-

先日、私の勤めるデジタルサーカス株式会社が、PHP Foundation へ寄付をおこないました。 -本件を社内でしつこく推進した1人として、推進の理由等を書き残しておきます。

-
-
- Posted on -
- -
-
-
-

PHP カンファレンス沖縄で出題されたコードゴルフの問題を解いてみた

-
-
-

PHP カンファレンス沖縄の懇親会 LT で出題されたコードゴルフの問題を解いてみた。

-
-
- Posted on -
- -
-
-
-

PHPerKaigi 2022

-
-
-

2022-04-09 から 2022-04-11 にかけて開催された、PHPerKaigi 2022 に参加した。

-
-
- Posted on -
- -
-
-
-

term-banner: ターミナルにバナーを表示するツールを書いた

-
-
-

ターミナルに任意の文字のバナーを表示するためのツールを Go で書いた。

-
-
- Posted on , updated on -
- -
-
-
-

PHPerKaigi 2022 トークン問題の解説

-
-
-

PHPerKaigi 2022 で私が作成した PHPer チャレンジ問題を解説する。

-
-
- Posted on , updated on -
- -
-
-
-

Rust のプリミティブ型はどこからやって来るか

-
-
-

Rust のプリミティブ型は予約語ではなく普通の識別子である。どのようにこれが名前解決されるのかを調べた。

-
-
- Posted on -
- -
-
-
-

[Ruby] then キーワードと case in

-
-
-

Ruby 3.0 で追加される case in 構文と、then キーワードについて。

-
-
- Posted on -
- -
-
- - - - - - diff --git a/docs/page/1/index.html b/docs/page/1/index.html deleted file mode 100644 index 81da958..0000000 --- a/docs/page/1/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - - https://blog.nsfisis.dev/ - - - - - - diff --git a/docs/page/2/index.html b/docs/page/2/index.html deleted file mode 100644 index 5d6af1b..0000000 --- a/docs/page/2/index.html +++ /dev/null @@ -1,131 +0,0 @@ - - - - - - - - REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -
-
-

[C++] 属性構文の属性名にはキーワードが使える [[void]] [[for]]

-
-
-

C++ の属性構文の属性名には、キーワードが使える。ネタ記事。

-
-
- Posted on -
- -
-
-
-

[Ruby] 自身を実行している処理系の種類を判定する

-
-
-

Ruby には複数の実装があるが、自身を実行している処理系の種類をスクリプト上からどのように判定すればよいだろうか。

-
-
- Posted on -
- -
-
-
-

Vimで選択した行の順番を入れ替える

-
-
-

Vim で選択した行の順番を入れ替える方法。

-
-
- Posted on -
- -
-
-
-

[Vim] autocmd events の BufWrite/BufWritePre の違い

-
-
-

Vim の autocmd events における BufWrite/BufWritePre がどう違うのかを調べた結果、違いはないことがわかった。

-
-
- Posted on -
- -
-
-
-

[Python] クロージャとUnboundLocalError: local variable 'x' referenced before assignment

-
-
-

Python における UnboundLocalError の理由と対処法。

-
-
- Posted on -
- -
-
-
-

PHPerKaigi 2021

-
-
-

2021-03-26 から 2021-03-28 にかけて開催された、PHPerKaigi 2021 に参加した。

-
-
- Posted on -
- -
-
-
-

My First Post

-
-
-

これはテスト投稿です。これはテスト投稿です。これはテスト投稿です。

-
-
- Posted on -
- -
-
- - - - - - diff --git a/docs/posts/2021-03-05/my-first-post/index.html b/docs/posts/2021-03-05/my-first-post/index.html deleted file mode 100644 index cd1bbe8..0000000 --- a/docs/posts/2021-03-05/my-first-post/index.html +++ /dev/null @@ -1,58 +0,0 @@ - - - - - - - - My First Post | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- - -
-
-

My First Post

-
-
-
-

更新履歴

-
    -
  • 2021-03-05: 公開
    • -
-
-

Test

-

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

- -
-
- - - - - - diff --git a/docs/posts/2021-03-30/phperkaigi-2021/index.html b/docs/posts/2021-03-30/phperkaigi-2021/index.html deleted file mode 100644 index a10cc08..0000000 --- a/docs/posts/2021-03-30/phperkaigi-2021/index.html +++ /dev/null @@ -1,532 +0,0 @@ - - - - - - - - PHPerKaigi 2021 | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- - -
-
-

PHPerKaigi 2021

- -
-
-
-

更新履歴

-
    -
  • 2021-03-30: 公開
    • -
-
-

PHPerKaigi 2021 参加レポ

-

2021-03-26 から 2021-03-28 にかけて開催された、PHPerKaigi 2021 に一般参加者として参加した。 -弊社デジタルサーカス株式会社 (今年1月から勤務) はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。

-

このようなカンファレンスには初めて参加するのでかねてより心待ちにしていたのだが、生憎2日目から体調を崩してしまい、この記事も途中までとなっている。まだ見ていないセッションも多いが、ひとまず現時点での参加レポを書いておく。

-

発表はトラック A、B に分かれていたのだが、今回はすべて A トラックを視聴している (切り替えるのが面倒だっただけ)。

-

凡例

-
-

発表・スライドのメモ (引用ではない)

-
-

感想など

-

Day 0 前夜祭 (2021/03/27)

-

17:30 [A]

-

PHP で AWS Lambda

-
-

Rails のプロジェクトを PHPer のメンバのみでメンテ -→他のメンバもわかる PHP にリプレースを検討

-

サーバレス

-
    -
  • サーバ・インフラの管理が不要
    • -
  • アプリケーションコードの知識だけで保守可能
    • -
-

ゼロベースで作れる案件が (Railsの件とは別に) あるため、そちらで試験的に導入?

-

AWSの学習 -AWS のドキュメント -DevelopersIO

-

AWS Lambda のカスタムランタイムで PHP を動かす

-

サーバのセットアップや維持管理を気にしなくて良い -サーバーレスで PHP を動かすツールがすでにある -サーバーレス構築はすんなり

-

今は Laravel がルーティングしている -Laravel Livewire を Lambda に載せられないか？ -デプロイ方法は？ -バッチ処理は？ (Lambda は 15分の制限)

-

Lambda でコンテナイメージがサポートされるように

-

抽象化されたもの「だけ」しか知らないよりも具象の理解は助けになる

-
-

AWS Lambda のような Function as a Service はマイクロサービス化における一つの到達点に思えるのだが、これを使って実際に web サービスを作る具体的なイメージがまだ見えない (注: すべて for me として書いている)。

-

PHP on AWS Lambda があれだけ簡単に動かせるのには驚いた。

-

勝手に AWS Lambda だとフットプリントの軽さが求められそう (= PHP + Laravel などでは動かなさそう) だという先入観を持っていたのだが、この発表のデモによればそうでもないらしい。

-

18:10 [A]

-

大規模サイトの SEO

-
-

大規模サイト (100万ページ以上) -Google の基準

-

クロールバジェットを意識したSEO

-

大規模サイトでコンテンツが中頻度 (1回/週) で更新 OR 中規模サイト (10,000以上) でコンテンツが目まぐるしく変更される -これを満たさないなら、クロールバジェットを考えなくてもいい

-

サーチコンソール -「カバレッジ」の「除外」 -多すぎるのは問題→クロールバジェットを浪費している

-
    -
  • クエリの順番を決める
    • -
  • 空の値のルールを決めておく
    • -
  • リダイレクトすればインデックスはうまくいく
    • -
  • リンクが存在する限りクロールはされる
    • -
-

リニューアル前のURL

-

インデックスは移行される -リンクのURLが存在する限り、別のURLとしてクロールされる -リダイレクトされるとはいえ、リニューアル前のURLは移行した方が良い -リニューアルで無視されるようになったパラメータも注意

-

robotes.txt で拒否しているのにクロールされる -一時的に拒否を外して 404 や 301 を読ませる -内部リンクを確認する -JS でのリンクに書き換え

-

クエリパラメータからURLのパスに -/tokyo?area=HOGE → /tokyo/HOGE

-

URL 設計だいじ

-
-

SEO (Search Engine Optimization) は大して知らないので新鮮な話が多かった。その分語れることも少ない……。

-

18:50 [A]

-
-

知覚可能 -操作可能 -理解可能 -堅牢 ちゃんとしたHTMLを書く (閉じタグ・入れ子構造など)

-
    -
  • -

    標準の HTML を適切に使う

    -
    • -
  • -

    WAI-ARIA

    -
    • -
  • -

    キーボードフレンドリー

    -
    • -
  • -

    マシンフレンドリー

    -
    • -
  • -

    SEOフレンドリー

    -
    • -
-

button タグ -→キーボード -h1 タグ -→スクリーンリーダー・クローラ -a タグ

-

WAI-ARIA -HTML では表現できないセマンティクスを追加する

-
    -
  • ロール -
      -
    • 何をするのか？
      • -
    • ユーザーアクションによって変化しない
      • -
    -
    • -
  • プロパティ -
      -
    • 関連づけられたデータ
      • -
    -
    • -
  • ステート -
      -
    • 現在の状態
      • -
    -
    • -
-

まずは標準の HTML 要素で解決する -何でもかんでも WAI-ARIA を使えばいいというものではない

-

マウスホバーでツールチップが出てくるが、キーボード操作では出てこない

-

VoiceOver

-

全ての属性を使う必要はない -あくまでアクセシビリティを上げるための方法の一つにすぎない

-
-

つい最近 WAI-ARIA についての記事を読んだばかりだったので個人的にタイムリーな話題だった。(あまりこの言葉を使いたくないのだが) いわゆる「健常者」にとって、こうした問題を普段の生活の中で意識するのは難しい。だからこそ情報へのアンテナは張っておくようにしたい。

-

19:30 [A]

-

PHP で FUSE

-

個人的に楽しみだった発表。

-
-

VFS (virtual filesystem) vs 具体的なファイルシステム

-

最適な実装方法は状況により異なる

-

アプリケーションに見せるAPIは変えずに実装を隠蔽する→VFS

-

カーネルのプログラムを作るのは難しい

-
    -
  • 権限がデカすぎる
    • -
  • システム全体がクラッシュ
    • -
  • セキュリティリスク
    • -
  • 開発サイクルを回しづらい
    • -
  • ネイティブコードにコンパイルされる言語である必要がある
    • -
-

Filesystem in USEr space (FUSE)

-
    -
  • 特定の C の関数を呼ぶことで filesystem が作れる
    • -
  • FFI を持つ言語なら FUSE が使える
    • -
-

SSHFS / s3fs / Docker Desktop

-

Linux 以外でも使える

-
    -
  • dokany (on Windows)
    • -
  • osxfuse
    • -
-

VFS: システムコールが呼ばれると、ファイルシステムによってコール -FUSE: カーネル空間からユーザ空間へ通信

-

高レベルなラッパで型をつける

-

PHP 以外では Wordpress を FUSE にマウントする実装がある (C, Python など)

-
    -
  • grep できる
    • -
  • sed できる
    • -
  • 編集できる
    • -
-
-

期待通りの興味深い発表だった。FUSE 自体も今回の発表で知ったのだが、これ本体の実装を見るのも面白そうだ。 -この発表を聞きながらファイルシステムにマウントできそうなものを考えていたのだが、およそ木構造をしているものすべてと言えそうだ (ハンマーしか持っていないと云々)。何かできそうだがなかなか思いつかない。

-

Day 1 (2021/03/27)

-

10:50 [A]

-

ATDD

-
-
    -
  • ユーザーストーリー
    • -
  • ユニットテスト
    • -
  • CI/CD
    • -
-

ユーザストーリーの受け入れ条件が曖昧になりがち -デグレチェックがユニットレベルでは収まらない場合、手動で同じシナリオをテストしている

-

Q2の強化 -アジャイルテストの4象限

-

技術面/ビジネス面 -開発チーム支援(コーディング前・コーディング中)/製品批評(コーディング後)

-
    -
  • Q1: 技術面 & チーム支援 -
      -
    • TDD
      • -
    • ユニットテストなど
      • -
    -
    • -
  • Q2: ビジネス面 & チーム支援 -
      -
    • ATDD
      • -
    • ビジネス面の受け入れテストで駆動する
      • -
    -
    • -
-

Agile Alliance -ユーザストーリーのスキルレベルを高める

-

テストピラミッド

-
    -
  • -

    UI Tests

    -
    • -
  • -

    Service Tests

    -
    • -
  • -

    Unit Tests

    -
    • -
  • -

    異なる粒度のテストを書く

    -
    • -
  • -

    高レベルになるほど、持つべきテストは少なくなる

    -
      -
    • ピラミッド型になる
      • -
    -
    • -
-

高レベルテストが多すぎる→アイスクリームコーン　アンチパターン

-

ATDD (Acceptance TDD) -API経由・UI経由での高レベルテスト E2E test

-

ストーリ受け入れテスト

-

入れ子のフィードバックループ -ATDD(外側) と TDD(内側)

-

外部品質・内部品質

-

バーティカルスライスのデリバリー

-
    -
  • cucumber
    • -
  • gauge
    • -
  • behat
    • -
-

ユビキタス言語 -手動テストもspecに書く -自動化は可能だがコスパが悪い -失敗することがわかっているテスト(レッドテスト)はCIから外す -失敗時の原因究明が難しい -饒舌なエラーメッセージ -状況のスナップショット

-

Continuous Testing

-
-

User Acceptance Test (UAT) くらいの規模になると個人開発・趣味開発では触れない領域なので、大いに勉強になった。スライドに添付されている資料が相当に充実していたので、これを読むのが本番といった様相すら感じる。 -高レベルテストの自動化は現在のプロジェクトでも感じており、自動化のチャンスは伺っている。とはいえセッションでも指摘されているように自動化することにコストがかかりすぎる領域があるのも事実で、そのバランスが難しい。

-

11:50 [A]

-

型解析を用いたリファクタリング

-

型のある世界で生きてきた身として大いに楽しみにしていた発表。

-
-
    -
  • PHPStan
    • -
  • Phan
    • -
  • Psalm
    • -
-

autoload も認識できる -bootstrapFiles

-

編集箇所と利用箇所を CI でチェック -ルールレベルを徐々に引き上げていく -警告が多すぎると見落としてしまう・無視されやすくなる

-

型がついていないことによるエラーが多い

-

型よりも詳細な検査 Util_Assert::min

-

SQL を静的解析 -placeholder の型付け

-

警告レベルを低いレベルから導入 -タイプヒントを積極的に書いていく -PHPStan の拡張を追加する

-
-

昨今、動的型付き言語での型宣言・型アノテーション・型ヒントの導入が相次いでいる。長らく静的型付き言語を書いてきた私からすると、ようやく気づいたかといったところだが、ともかく型を導入する言語が増えてきた。 -今のプロジェクトでも新しく追加するコードには型をつけるよう努めているが、どうしても古いコードには型がついていない。個人的には型のないコードに対してどう型を自動的に付けるかという点に興味があり、その点で Ruby の typeprof には注目している。

-

12:30 [A]

-

昼食をとっていた。事前に何か食料を買っておくべきだった。

-

13:10 [A]

-

Documentation as Code

-

この発表も以前から非常に楽しみにしていた。

-
-

開発開始までのオーバーヘッド -新規にチームにジョイン -担当範囲外の機能を理解 -オンボーディングのコスト

-

PHPerKaigi 2020 で発表あり

-

継続的にシステムの理解を助けるドキュメント

-

継続的ドキュメンテーション -システムとドキュメントの乖離

-

書いてあることが間違っている・足りない

-
    -
  • 徐々にずれていく
    • -
  • システムの更新タイミングとドキュメントの更新タイミングに差がある
    • -
-

システムとドキュメントは対応関係がある

-
    -
  • 間違ったドキュメント
    • -
  • 存在しないドキュメント
    • -
-

システムとドキュメントの乖離を定量化する -継続的に -システムの更新に近いタイミングで ドキュメントを更新し続ける

-

Documentation as Code

-

コードと同じツールでドキュメントを書く

-
    -
  • issue tracker
    • -
  • vcs
    • -
  • plain text markup
    • -
  • automation
    • -
-

開発者 -システム -ドキュメント -構造化データ -ソフトウェア

-

システムから構造化データを抽出する -PHPDoc -OpenAPI

-

ビュー 関心ごとに合わせてアーキテクチャを一つ以上の側面(断面)で説明する

-

ビューの単位でドキュメントに

-

スタックトレースからのドキュメント生成

-
-

ドキュメントの管理は現プロジェクトでも課題と感じている。作られた当初は正しくても、実態と乖離していくのを止めるのは困難を極める。全体的に興味深い発表だったが、特にスタックトレースからのドキュメント生成というアイデアに惹かれるものを感じた。スタックトレースという実態と不可分な (乖離しない) 情報を起点にするのは理にかなっている。問題はトレースをいつ、どう取るかだろうか。それを自動化しなければ、実態との乖離が避けられないだろう。

-

14:10 [A]

-

cookie による session 管理

-

全体的に基本的な話だったので特に触れない。Cookie やセッションの話としては非常に分かりやすくまとめられていたので、知らない人が学ぶにはいい教材だろう。

-

14:50 [A]

-

PHP のエラーと例外

-
-

エラー PHPエンジンがエラーを通知する -例外 プログラムが投げる

-

PHP7-8とエラー

-

PHPエンジンのエラーの一部が \Error に変換されるようになった -→ try-catch で捕捉できる

-

\Error は例外とは異なる

-

PHP8 でエラーレベルの引き上げ

-
    -
  • 捕捉すべきもの -
      -
    • recoverable
      • -
    -
    • -
  • 捕捉すべきでないもの -
      -
    • unrecoverable
      • -
    • 開発時に対処できるもの
      • -
    -
    • -
-

例外

-
    -
  • 捕捉して事後処理
    • -
  • 捕捉せず(or 捕捉した上で)さらに上に是非を問う
    • -
-

開発段階で例外を把握し、ハンドリングを考えておく

-

\Throwable \Exception と \Error

-

\Error はキャッチすべきでない

-
    -
  • -

    \Error

    -
      -
    • 本番で起きてはいけない
      • -
    -
    • -
  • -

    \LogicException

    -
      -
    • 本番で起きてはいけない -→生じないのだから捕捉もしない
      • -
    -
    • -
  • -

    \RuntimeException

    -
      -
    • 起こるかもしれないので本番環境でも考慮する
      • -
    -
    • -
-

捕捉して対応するのではなく、未然に防ぐ

-

独自例外を使う -\Exception を投げてしまうと、 -catch (\Exception)せざるを得ない -→catch 範囲が広すぎる

-

SPL の例外を使う

-

例外翻訳 -上位のレイヤが下位のレイヤの例外を捕捉し、上位レイヤのAPIに「翻訳」する -下位レイヤの知識に依存させない

-

@throws -捕捉してほしい例外を書き連ねておく

-

呼び出しもとに負わせたい責任

-
-

PHP を学んでいる途中の私としては、今まさに聞きたい発表だった (現時点で PHP を書き始めてから 4ヶ月ほどになる)。

-

個人的に例外やエラーを最もうまく扱っているのは Go、Swift、Rust、Haskell などのエラーを「値として」扱う言語だと思っている。try-catch は通常の処理フローを完全に壊してしまう上、構文としても重すぎる。値としてのエラー通知は C言語時代への回帰ともいえるが、その頃と異なるのはエラーを暗黙のうちに握り潰すことがないということだ。これらの言語は型を持っており、静的に検証ができる (C のそれはまともな型付けではない。念のため)。

-

PHP のように、すでに例外が言語システムに根ざしている言語ではどうすればよいか。この場合も同じく静的検証の力を借りることになるだろう。

-

15:30 [A]

-

Laravel のメール認証

-

Laravel の知識がない私にはまったくついていけなかった。また、個人的にタイトルがややミスリーディングに感じた。

-

16:10 [A]

-

gRPC

-
-

Unary RPCs -Server streaming RPCs -Client streaming RPCs -Bidirectional streaming RPCs

-

Protobuf

-

実装とAPIが乖離しにくい -自動生成 -複数言語でも相互に使える

-

マイクロサービスのサービス通信 -スマホアプリ -ゲームサーバ

-

PHP では？

-

PHP ではストリーミングが難しい -リクエストごとにプロセスが使い捨て

-

PHP ではgRPCのクライアントしか対応していない

-

gRPC-Web -ブラウザで扱うためのJSライブラリ+プロトコル

-

HTTP/1.1 でも使える -Unary RPC と Server streaming RPC のみ

-

Envoy -Nginx などで相互に gRPC と gRPC-Web で変換

-

Amp -イベント駆動な並行処理のフレームワーク

-

HTTP/2 対応

-

C#のgRPC-Webが楽

-
-

(発表の中でもまさに同じことをおっしゃっていたが) PHP 以外の方が向いているだろう、というのが第一の感想である。gRPC はそれ自体というよりも Protobuf というエコシステムに乗れることのメリットが大きいと感じる。そのエコシステムにうまく乗れない時点で、うーんという感じ。

-

16:50 [A]

-

アーキテクチャテスト

-
-

Independent Core Layer Pattern

-

開発初期のアーキテクチャが崩れる -アーキテクチャ観点のコードレビューができない

-

どこにクラスを置けばよいか？ -ドキュメントがない

-

アーキテクチャ設計に関する知識が属人化・暗黙知化

-

ガイドライン

-
    -
  • 最初にルールを決めるのは簡単
    • -
  • ルール通り作り始めるのも簡単 -
      -
    • →維持するのが難しい、人が決めたものゆえ壊れやすい
      • -
    -
    • -
-

PHP の特性

-
    -
  • クラスは public
    • -
  • 可視性の制御が public / protected / private のみ
    • -
  • 依存関係の制御が困難
    • -
-

アーキテクチャテスト -クラスの依存関係や実装ルールをコードとして表現し、自動テスト化する

-
    -
  • deptrac
    • -
  • phpat
    • -
-

Independent Core Layer Pattern

-

アーキテクチャテストの失敗

-
    -
  • 実装誤り
    • -
  • or アーキテクチャが適切でない -
      -
    • 開発の過程でフィードバックしていく
      • -
    -
    • -
-

モジュラーモノリス→マイクロサービスへ

-
-

Day 2 (2021/03/28)

-

冒頭に書いた通り、2日目から体調が悪くまともに聴けていない。途中までは頭痛を我慢しつつ見ていたのだが、まともに入ってこなかった。

-

残念ではあるが、いずれにせよ見られていない発表は他にもあるので、今週末にでもまとめて見ようと思う。

-

全体の感想

-

Day 2 にほとんど参加できなかったのは残念だが、イベント自体は大変楽しく、また興味深いものであった。自分がまったく知らない領域の話を聞けるのはこうしたイベントならではだと感じる。オンライン開催ゆえ現地に行く必要がなく、気軽に参加できたのも (特に初参加者として) 嬉しいポイントだった。

-

今回、雑談/登壇者への質問等向けに Discord サーバもあったのだが、こちらは参加こそしたものの ROM のままになってしまった。発表に1ウィンドウ、メモを書くのに1ウィンドウ、Discord 表示に 1ウィンドウで私にはもう脳のリソースとディスプレイのスペースが追いつかなかった (さらにいうと Zoom でアンカンファレンスもやっていたようだ。こちらはまったく参加していない)。

-

1つ個人的な反省点としては、一つ一つのセッションを真剣に聞き過ぎたというものがある。もっと適当に聞いておけばよかった。これだけだと大変語弊があるのだが、言い方を変えると、Discord しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。 -まあ初カンファレンスだし、とお茶を濁しておこう。

-

さて、カンファレンスで一つ気になったことがある。それは、Discord という書き込み場所が増えたことでニコ生のコメントの流量が吸い取られてしまったのではないか、という点だ。ニコニコだけ見ていると過疎っているかのように見えた発表も、Discord の方では盛り上がっている、というのを何度か見かけた。ニコニコのコメント方式は盛り上がりを如実に反映するが、逆もまたしかり。Discord があったこと自体はプラスだったと思うが、この点はマイナスだったのではないかと感じる。

-
-

最後になりましたが、毎年の PHPerKaigi 開催にご尽力されている皆様、スピーカーの皆様、楽しい3日間でした。ありがとうございました！ -(ずっと常体で書いてしまったのでいきなり仏頂面から笑顔になったようで気持ち悪い)

-

ではまた来年。

- -
-
- - - - - - diff --git a/docs/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes/index.html b/docs/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes/index.html deleted file mode 100644 index 38c34aa..0000000 --- a/docs/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes/index.html +++ /dev/null @@ -1,129 +0,0 @@ - - - - - - - - [C++] 属性構文の属性名にはキーワードが使える [[void]] [[for]] | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- - -
-
-

[C++] 属性構文の属性名にはキーワードが使える [[void]] [[for]]

- -
-
-
-

更新履歴

-
    -
  • 2021-10-02: Qiita から移植
    • -
-
-

この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/94090937bcf860cfa93b

-
-

タイトル落ち。まずはこのコードを見て欲しい。

-
#include <iostream>
-
-[[alignas]] [[alignof]] [[and]] [[and_eq]] [[asm]] [[auto]] [[bitand]]
-[[bitor]] [[bool]] [[break]] [[case]] [[catch]] [[char]] [[char16_t]]
-[[char32_t]] [[class]] [[compl]] [[const]] [[const_cast]] [[constexpr]]
-[[continue]] [[decltype]] [[default]] [[delete]] [[do]] [[double]]
-[[dynamic_cast]] [[else]] [[enum]] [[explicit]] [[export]] [[extern]] [[false]]
-[[final]] [[float]] [[for]] [[friend]] [[goto]] [[if]] [[inline]] [[int]]
-[[long]] [[mutable]] [[namespace]] [[new]] [[noexcept]] [[not]] [[not_eq]]
-[[nullptr]] [[operator]] [[or]] [[or_eq]] [[override]] [[private]]
-[[protected]] [[public]] [[register]] [[reinterpret_cast]] [[return]] [[short]]
-[[signed]] [[sizeof]] [[static]] [[static_assert]] [[static_cast]] [[struct]]
-[[switch]] [[template]] [[this]] [[thread_local]] [[throw]] [[true]] [[try]]
-[[typedef]] [[typeid]] [[typename]] [[union]] [[unsigned]]
-[[virtual]] [[void]] [[volatile]] [[wchar_t]] [[while]] [[xor]] [[xor_eq]]
-// [[using]]
-int main() {
-    std::cout << "Hello, World!" << std::endl;
-}
-
-

コンパイラのバージョン -$ clang++ –version -Apple clang version 11.0.0 (clang-1100.0.33.8) -Target: x86_64-apple-darwin19.6.0 -Thread model: posix -InstalledDir: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin

-

コンパイルコマンド (C++17指定) -$ clang++ –std=c++17 hoge.cpp

-
-

この記事から得られるものはこれ以上ないので以下は蛇足になる。

-

別件で cppreference.com の identifier のページ を読んでいた時、次の文が目に止まった。

-
-
    -
  • the identifiers that are keywords cannot be used for other purposes; -
      -
    • The only place they can be used as non-keywords is in an attribute-token. (e.g. [[private]] is a valid attribute) (since C++11)
      • -
    -
    • -
-
-

キーワードでも属性として指定する場合は非キーワードとして使えるらしい。 -実際にやってみる。

-

同サイトの [keywords のページ] (https://en.cppreference.com/w/cpp/keyword) から一覧を拝借し、上のコードが出来上がった (C++17 においてキーワードでないものなど、一部省いている)。 -大量の警告 (unknown attribute ‘〇〇’ ignored) がコンパイラから出力されるが、コンパイルできる。

-

上のコードでは [[using]] をコメントアウトしているが、これは using キーワードのみ属性構文の中で意味を持つからであり、このコメントアウトを外すとコンパイルに失敗する。

-
// using の例
-[[using foo: attr1, attr2]] int x; // [[foo::attr1, foo::attr2]] の糖衣構文
-

C++17 の仕様も見てみる (正確には標準化前のドラフト)。

-

引用元: https://timsong-cpp.github.io/cppwp/n4659/dcl.attr#grammar-4

-
-

If a keyword or an alternative token that satisfies the syntactic requirements of an identifier is contained in an attribute-token, it is considered an identifier.

-
-

「identifier の構文上の要件を満たすキーワードまたは代替トークンが attribute-token に含まれている場合、identifier とみなされる」とある。どうやら間違いないようだ。

-

ところで、代替トークン (alternative token) とは and (&) や bitor (|) などのことだが、identifier の構文上の要件を満たさないような代替トークンなどあるのか？ -疑問に思って調べたところ、代替トークンという語にはダイグラフも含まれるらしい (参考: 同ドラフト)

-
    -
  • <% → {
    • -
  • %> → }
    • -
  • <: → [
    • -
  • :> → ]
    • -
  • %: → #
    • -
  • %:%: → ##
    • -
-

「identifier の構文上の要件を満たさないような代替トークン」はこれらが当てはまると思われる。

-

調べた感想: 字句解析器か構文解析器が辛そう

- -
-
- - - - - - diff --git a/docs/posts/2021-10-02/python-unbound-local-error/index.html b/docs/posts/2021-10-02/python-unbound-local-error/index.html deleted file mode 100644 index 35a880d..0000000 --- a/docs/posts/2021-10-02/python-unbound-local-error/index.html +++ /dev/null @@ -1,97 +0,0 @@ - - - - - - - - [Python] クロージャとUnboundLocalError: local variable 'x' referenced before assignment | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- - -
-
-

[Python] クロージャとUnboundLocalError: local variable 'x' referenced before assignment

- -
-
-
-

更新履歴

-
    -
  • 2021-10-02: Qiita から移植
    • -
-
-

この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/5d733703afcb35bbf399

-
-

本記事は Python 3.7.6 の動作結果を元にして書かれている。

-

Python でクロージャを作ろうと、次のようなコードを書いた。

-
def f():
-    x = 0
-    def g():
-        x += 1
-    g()
-
-f()
-

関数 g から 関数 f のスコープ内で定義された変数 x を参照し、それに 1 を足そうとしている。 -これを実行すると x += 1 の箇所でエラーが発生する。

-
-

UnboundLocalError: local variable ‘x’ referenced before assignment

-
-

local変数 x が代入前に参照された、とある。これは、f の x を参照するのではなく、新しく別の変数を g 内に作ってしまっているため。 -前述のコードを宣言と代入を便宜上分けて書き直すと次のようになる。var を変数宣言のための構文として擬似的に利用している。

-
# 注: var は正しい Python の文法ではない。上記参照のこと
-def f():
-    var x           #  f の local変数 'x' を宣言
-    x = 0           #  x に 0 を代入
-    def g():        #  f の内部関数 g を定義
-        var x       #  g の local変数 'x' を宣言
-                    #  たまたま f にも同じ名前の変数があるが、それとは別の変数
-        x += 1      #  x に 1 を加算 (x = x + 1 の糖衣構文)
-                    #  加算する前の値を参照しようとするが、まだ代入されていないためエラー
-    g()
-

当初の意図を表現するには、次のように書けばよい。

-
def f():
-    x = 0
-    def g():
-        nonlocal x   ## (*)
-        x += 1
-    g()
-

(*) のように、nonlocal を追加する。これにより一つ外側のスコープ (g の一つ外側 = f) で定義されている x を探しに行くようになる。

- -
-
- - - - - - diff --git a/docs/posts/2021-10-02/ruby-detect-running-implementation/index.html b/docs/posts/2021-10-02/ruby-detect-running-implementation/index.html deleted file mode 100644 index 71eadba..0000000 --- a/docs/posts/2021-10-02/ruby-detect-running-implementation/index.html +++ /dev/null @@ -1,125 +0,0 @@ - - - - - - - - [Ruby] 自身を実行している処理系の種類を判定する | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- - -
-
-

[Ruby] 自身を実行している処理系の種類を判定する

- -
-
-
-

更新履歴

-
    -
  • 2021-10-02: Qiita から移植
    • -
-
-

この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/74d7ffeeebc51b20d791

-
-

Ruby という言語には複数の実装があるが、それらをスクリプト上からどのようにして programmatically に見分ければよいだろうか。

-

Object クラスに定義されている RUBY_ENGINE という定数がこの用途に使える。

-

参考: Object::RUBY_ENGINE

-

上記ページの例から引用する:

-
$ ruby-1.9.1 -ve 'p RUBY_ENGINE'
-ruby 1.9.1p0 (2009-03-04 revision 22762) [x86_64-linux]
-"ruby"
-$ jruby -ve 'p RUBY_ENGINE'
-jruby 1.2.0 (ruby 1.8.6 patchlevel 287) (2009-03-16 rev 9419) [i386-java]
-"jruby"
-

それぞれの処理系がどのような値を返すかだが、stack overflow に良い質問と回答があった。

-

What values for RUBY_ENGINE correspond to which Ruby implementations? より引用:

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
RUBY_ENGINEImplementation
<undefined>MRI < 1.9
‘ruby’MRI >= 1.9 or REE
‘jruby’JRuby
‘macruby’MacRuby
‘rbx’Rubinius
‘maglev’MagLev
‘ironruby’IronRuby
‘cardinal’Cardinal
-
-

なお、この質問・回答は 2014年になされたものであり、値は変わっている可能性がある。MRI (aka CRuby) については執筆時現在 (2020/12/8) も 'ruby' が返ってくることを確認済み。

-

この表にない主要な処理系として、mruby は 'mruby' を返す。

-

mruby 該当部分のソース より引用:

-
/*
- * Ruby engine.
- */
-#define MRUBY_RUBY_ENGINE  "mruby"
-
-
-
- - - - - - diff --git a/docs/posts/2021-10-02/ruby-then-keyword-and-case-in/index.html b/docs/posts/2021-10-02/ruby-then-keyword-and-case-in/index.html deleted file mode 100644 index 7d62273..0000000 --- a/docs/posts/2021-10-02/ruby-then-keyword-and-case-in/index.html +++ /dev/null @@ -1,195 +0,0 @@ - - - - - - - - [Ruby] then キーワードと case in | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- - -
-
-

[Ruby] then キーワードと case in

- -
-
-
-

更新履歴

-
    -
  • 2021-10-02: Qiita から移植
    • -
-
-

この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/787a8cf888a304497223

-
-

TL; DR

-

case - in によるパターンマッチング構文でも、case - when と同じように then が使える (場合によっては使う必要がある)。

-

then とは

-

使われることは稀だが、Ruby では then がキーワードになっている。次のように使う:

-
if cond then
-  puts "Y"
-else
-  puts "N"
-end
-

このキーワードが現れうる場所はいくつかあり、if、unless、rescue、case 構文がそれに当たる。 -上記のように、何か条件を書いた後 then を置き、式がそこで終了していることを示すマーカーとして機能する。

-
# Example:
-
-if x then
-  a
-end
-
-unless x then
-  a
-end
-
-begin
-  a
-rescue then
-  b
-end
-
-case x
-when p then
-  a
-end
-

なぜ普段は書かなくてもよいのか

-

普通 Ruby のコードで then を書くことはない。なぜか。次のコードを実行してみるとわかる。

-
if true puts 'Hello, World!' end
-

次のような構文エラーが出力される。

-
20:1: syntax error, unexpected local variable or method, expecting `then' or ';' or '\n'
-if true puts 'Hello, World!' end
-        ^~~~
-20:1: syntax error, unexpected `end', expecting end-of-input
-...f true puts 'Hello, World!' end
-

二つ目のメッセージは無視して一つ目を読むと、then か ; か改行が来るはずのところ変数だかメソッドだかが現れたことによりエラーとなっているようだ。

-

ポイントは改行が then (や ;) の代わりとなることである。true の後に改行を入れてみる。

-
if true
-puts 'Hello, World!' end
-

無事 Hello, World! と出力されるようになった。

-

なぜ then や ; や改行が必要か

-

なぜ then や ; や改行 (以下 「then 等」) が必要なのだろうか。次の例を見てほしい:

-
if a b end
-

then も ; も改行もないのでエラーになるが、これは条件式がどこまで続いているのかわからないためだ。 -この例は二通りに解釈できる。

-
# a という変数かメソッドの評価結果が truthy なら b という変数かメソッドを評価
-if a then
-  b
-end
-
# a というメソッドに b という変数かメソッドの評価結果を渡して呼び出し、
-# その結果が truthy なら何もしない
-if a(b) then
-end
-

then 等はこの曖昧性を排除するためにあり、条件式は if から then 等までの間にある、ということを明確にする。 -C系の if 後に来る (/) や、Python の :、Rust/Go/Swift などの { も同じ役割を持つ。

-

Ruby の場合、プログラマーが書きやすいよう改行でもって then が代用できるので、ほとんどの場合 then は必要ない。

-

case - in における then

-

ようやく本題にたどり着いた。来る Ruby 3.0 では case と in キーワードを使ったパターンマッチングの構文が入る予定である。この構文でもパターン部との区切りとして then 等が必要になる。 -(現在の) Ruby には formal な形式での文法仕様は存在しないので、yacc の定義ファイルを参照した (yacc の説明は省略)。

-

https://github.com/ruby/ruby/blob/221ca0f8281d39f0dfdfe13b2448875384bbf735/parse.y#L3961-L3986

-
p_case_body	: keyword_in
-		    {
-			SET_LEX_STATE(EXPR_BEG|EXPR_LABEL);
-			p->command_start = FALSE;
-			$<ctxt>1 = p->ctxt;
-			p->ctxt.in_kwarg = 1;
-			$<tbl>$ = push_pvtbl(p);
-		    }
-		    {
-			$<tbl>$ = push_pktbl(p);
-		    }
-		  p_top_expr then
-		    {
-			pop_pktbl(p, $<tbl>3);
-			pop_pvtbl(p, $<tbl>2);
-			p->ctxt.in_kwarg = $<ctxt>1.in_kwarg;
-		    }
-		  compstmt
-		  p_cases
-		    {
-		    /*%%%*/
-			$$ = NEW_IN($4, $7, $8, &@$);
-		    /*% %*/
-		    /*% ripper: in!($4, $7, escape_Qundef($8)) %*/
-		    }
-		;
-

簡略版:

-
p_case_body	: keyword_in p_top_expr then compstmt p_cases
-		;
-

ここで、keyword_in は文字通り in、p_top_expr はいわゆるパターン、then は then キーワードのことではなく、この記事で then 等と呼んでいるもの、つまり then キーワード、;、改行のいずれかである。

-

これにより、case - when による従来の構文と同じように、then 等をパターンの後ろに挿入すればよいことがわかった。つまり次の3通りのいずれかになる:

-
case x
-in 1 then a
-in 2 then b
-in 3 then c
-end
-
-case x
-in 1
-  a
-in 2
-  b
-in 3
-  c
-end
-
-case x
-in 1; a
-in 2; b
-in 3; c
-end
-

ところで、p_top_expr には if による guard clause が書けるので、その場合は if - then と似たような見た目になる。

-
case x
-in 0 then a
-in n if n < 0 then b
-in n then c
-end
-

まとめ

-
    -
  • if や case の条件の後ろには then、;、改行のいずれかが必要 -
      -
    • 通常は改行しておけばよい
      • -
    -
    • -
  • 3.0 で入る予定の case - in でも then 等が必要になる
    • -
  • Ruby の構文を正確に知るには (現状) parse.y を直接読めばよい
    • -
- -
-
- - - - - - diff --git a/docs/posts/2021-10-02/rust-where-are-primitive-types-from/index.html b/docs/posts/2021-10-02/rust-where-are-primitive-types-from/index.html deleted file mode 100644 index 3aba89f..0000000 --- a/docs/posts/2021-10-02/rust-where-are-primitive-types-from/index.html +++ /dev/null @@ -1,182 +0,0 @@ - - - - - - - - Rust のプリミティブ型はどこからやって来るか | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- - -
-
-

Rust のプリミティブ型はどこからやって来るか

- -
-
-
-

更新履歴

-
    -
  • 2021-10-02: Qiita から移植
    • -
-
-

この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/9a429432258bbcd6c565

-
-

前置き

-

Rust において、プリミティブ型の名前は予約語でない。したがって、次のコードは合法である。

-
#![allow(non_camel_case_types)]
-#![allow(dead_code)]
-
-struct bool;
-struct char;
-struct i8;
-struct i16;
-struct i32;
-struct i64;
-struct i128;
-struct isize;
-struct u8;
-struct u16;
-struct u32;
-struct u64;
-struct u128;
-struct usize;
-struct f32;
-struct f64;
-struct str;
-

では、普段単に bool と書いたとき、この bool は一体どこから来ているのか。rustc のソースを追ってみた。

-
-

前提知識: 一般的なコンパイラの構造、用語。rustc そのものの知識は不要 (というよりも筆者自身がよく知らない)

-
-

調査

-

調査に使用したソース (調査時点での最新 master)

-

https://github.com/rust-lang/rust/tree/511ed9f2356af365ad8affe046b3dd33f7ac3c98

-

どのようにして調べるか。rustc の構造には詳しくないため、すぐに当たりをつけるのは難しい。

-

大雑把な構造としては、compiler フォルダ以下に rustc_* という名前のクレートが数十個入っている。これがどうやら rustc コマンドの実装部のようだ。

-

rustc はセルフホストされている (= rustc 自身が Rust で書かれている) ので、bool や char などで適当に検索をかけてもノイズが多すぎて話にならない。 -しかし、お誂え向きなことに i128/u128 というコンパイラ自身が使うことがなさそうな型が存在するのでこれを使って git grep してみる。

-
$ git grep "\bi128\b" | wc      # i128
-     165    1069   15790
-
-$ git grep "\bu128\b" | wc      # u128
-     293    2127   26667
-
-$ git grep "\bbool\b" | wc      # cf. bool の結果
-    3563   23577  294659
-

165 程度であれば探すことができそうだ。今回は、クレート名を見ておおよその当たりをつけた。

-
$ git grep "\bi128\b"
-...
-rustc_resolve/src/lib.rs:        table.insert(sym::i128, Int(IntTy::I128));
-...
-

rustc_resolve というのはいかにも名前解決を担いそうなクレート名である。該当箇所を見てみる。

-
/// Interns the names of the primitive types.
-///
-/// All other types are defined somewhere and possibly imported, but the primitive ones need
-/// special handling, since they have no place of origin.
-struct PrimitiveTypeTable {
-    primitive_types: FxHashMap<Symbol, PrimTy>,
-}
-
-impl PrimitiveTypeTable {
-    fn new() -> PrimitiveTypeTable {
-        let mut table = FxHashMap::default();
-
-        table.insert(sym::bool, Bool);
-        table.insert(sym::char, Char);
-        table.insert(sym::f32, Float(FloatTy::F32));
-        table.insert(sym::f64, Float(FloatTy::F64));
-        table.insert(sym::isize, Int(IntTy::Isize));
-        table.insert(sym::i8, Int(IntTy::I8));
-        table.insert(sym::i16, Int(IntTy::I16));
-        table.insert(sym::i32, Int(IntTy::I32));
-        table.insert(sym::i64, Int(IntTy::I64));
-        table.insert(sym::i128, Int(IntTy::I128));
-        table.insert(sym::str, Str);
-        table.insert(sym::usize, Uint(UintTy::Usize));
-        table.insert(sym::u8, Uint(UintTy::U8));
-        table.insert(sym::u16, Uint(UintTy::U16));
-        table.insert(sym::u32, Uint(UintTy::U32));
-        table.insert(sym::u64, Uint(UintTy::U64));
-        table.insert(sym::u128, Uint(UintTy::U128));
-        Self { primitive_types: table }
-    }
-}
-

これは初めに列挙したプリミティブ型の一覧と一致している。doc comment にも、

-
-

All other types are defined somewhere and possibly imported, but the primitive ones need special handling, since they have no place of origin.

-
-

とある。次はこの struct の使用箇所を追う。追うと言っても使われている箇所は次の一箇所しかない。なお説明に不要な箇所は大きく削っている。

-
    /// This resolves the identifier `ident` in the namespace `ns` in the current lexical scope.
-    /// (略)
-    fn resolve_ident_in_lexical_scope(
-        &mut self,
-        mut ident: Ident,
-        ns: Namespace,
-        // (略)
-    ) -> Option<LexicalScopeBinding<'a>> {
-        // (略)
-
-        if ns == TypeNS {
-            if let Some(prim_ty) = self.primitive_type_table.primitive_types.get(&ident.name) {
-                let binding =
-                    (Res::PrimTy(*prim_ty), ty::Visibility::Public, DUMMY_SP, ExpnId::root())
-                        .to_name_binding(self.arenas);
-                return Some(LexicalScopeBinding::Item(binding));
-            }
-        }
-
-        None
-    }
-

関数名や doc comment が示している通り、この関数は識別子 (identifier, ident) を現在のレキシカルスコープ内で解決 (resolve) する。 -if ns == TypeNS のブロック内では、primitive_type_table (上記の PrimitiveTypeTable::new() で作られた変数) に含まれている識別子 (bool、i32 など) かどうか判定し、そうであればそれに紐づけられたプリミティブ型を返している。

-

なお、ns は「名前空間」を示す変数である。Rust における名前空間はC言語におけるそれとほとんど同じで、今探している名前が関数名/変数名なのか型なのかマクロなのかを区別している。この if は、プリミティブ型に解決されるのは型を探しているときだけだ、と言っている。

-

重要なのは、これが resolve_ident_in_lexical_scope() の最後に書かれている点である。つまり、最初に挙げたプリミティブ型の識別子は、「名前解決の最終段階で」、「他に同名の型が見つかっていなければ」プリミティブ型として解決される。

-

動作がわかったところで、例として次のコードを考える。

-
#![allow(non_camel_case_types)]
-
-struct bool;
-
-fn main() {
-    let _: bool = bool;
-}
-

ここで main() の bool は struct bool として解決される。なぜなら、プリミティブ型の判定をする前に bool という名前の別の型が見つかるからだ。

-

まとめ

-

Rust のプリミティブ型は予約語ではない。名前解決の最終段階で特別扱いされ、他に同名の型が見つかっていなければ対応するプリミティブ型に解決される。

- -
-
- - - - - - diff --git a/docs/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre/index.html b/docs/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre/index.html deleted file mode 100644 index 91708ad..0000000 --- a/docs/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre/index.html +++ /dev/null @@ -1,132 +0,0 @@ - - - - - - - - [Vim] autocmd events の BufWrite/BufWritePre の違い | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- - -
-
-

[Vim] autocmd events の BufWrite/BufWritePre の違い

- -
-
-
-

更新履歴

-
    -
  • 2021-10-02: Qiita から移植
    • -
-
-

この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/79ab4db8564032de0b25

-
-

TL; DR

-

違いはない。ただのエイリアス。

-

調査記録

-

Vim の autocmd events には似通った名前のものがいくつかある。大抵は :help に説明があるが、この記事のタイトルにある2つを含めた以下のイベントには、その違いについて説明がない。

-
    -
  • BufRead/BufReadPost
    • -
  • BufWrite/BufWritePre
    • -
  • BufAdd/BufCreate
    • -
-

このうち、BufAdd/BufCreate に関しては、:help BufCreate に

-
-

The BufCreate event is for historic reasons.

-
-

とあり、おそらくは BufAdd のエイリアスであろうということがわかる。他の2組も同様ではないかと予想されるが、確認のため vim と neovim のソースコードを調査した。

-
-

ソースコードへのリンク -vim (調査時点での master branch) -neovim (上に同じ)

-
-

vim のソースコード

-

以下は、autocmd events の名前と内部で使われている整数値とのマッピングを定義している箇所である。見ての通り、上でエイリアスではないかと述べた3組には、それぞれ同じ内部値が使われている。

-

https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L85-L86

-
    {"BufAdd",		EVENT_BUFADD},
-    {"BufCreate",	EVENT_BUFADD},
-

https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L95-L97

-
    {"BufRead",		EVENT_BUFREADPOST},
-    {"BufReadCmd",	EVENT_BUFREADCMD},
-    {"BufReadPost",	EVENT_BUFREADPOST},
-

https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L103-L105

-
    {"BufWrite",	EVENT_BUFWRITEPRE},
-    {"BufWritePost",	EVENT_BUFWRITEPOST},
-    {"BufWritePre",	EVENT_BUFWRITEPRE},
-

neovim のソースコード

-

neovim の場合でも同様のマッピングが定義されているが、こちらの場合は Lua で書かれている。以下にある通り、はっきり aliases と書かれている。

-

https://github.com/neovim/neovim/blob/71d4f5851f068eeb432af34850dddda8cc1c71e3/src/nvim/auevents.lua#L119-L124

-
  aliases = {
-    BufCreate = 'BufAdd',
-    BufRead = 'BufReadPost',
-    BufWrite = 'BufWritePre',
-    FileEncoding = 'EncodingChanged',
-  },
-

ところで、上では取り上げなかった FileEncoding だが、これは :help FileEncoding にしっかりと書いてある。

-
                                                           *FileEncoding*
-FileEncoding                    Obsolete.  It still works and is equivalent
-                                to |EncodingChanged|.
-

まとめ

-

記事タイトルについて言えば、どちらも変わらないので好きな方を使えばよい。あえて言えば、次のようになるだろう。

-
    -
  • BufAdd/BufCreate -
      -
    • → BufCreate は歴史的な理由により (“for historic reasons”) 存在しているため、新しい方 (BufAdd) を使う
      • -
    -
    • -
  • BufRead/BufReadPost -
      -
    • → BufReadPre との対称性のため、あるいは BufWritePost との対称性のため BufReadPost を使う
      • -
    -
    • -
  • BufWrite/BufWritePre -
      -
    • → BufWritePost との対称性のため、あるいは BufReadPre との対称性のため BufWritePre を使う
      • -
    -
    • -
  • FileEncoding/EncodingChanged -
      -
    • → FileEncoding は “Obsolete” と明言されているので、EncodingChanged を使う
      • -
    -
    • -
-

ところでこの調査で知ったのだが、BufRead と BufWrite は上にある通り発火するタイミングが「後」と「前」で対称性がない。可能なら Pre/Post 付きのものを使った方が分かりやすいだろう。

- -
-
- - - - - - diff --git a/docs/posts/2021-10-02/vim-swap-order-of-selected-lines/index.html b/docs/posts/2021-10-02/vim-swap-order-of-selected-lines/index.html deleted file mode 100644 index eac828f..0000000 --- a/docs/posts/2021-10-02/vim-swap-order-of-selected-lines/index.html +++ /dev/null @@ -1,148 +0,0 @@ - - - - - - - - Vimで選択した行の順番を入れ替える | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- - -
-
-

Vimで選択した行の順番を入れ替える

- -
-
-
-

更新履歴

-
    -
  • 2021-10-02: Qiita から移植
    • -
-
-

この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/4fefb361d9a693803520

-
-

バージョン情報

-

:version の一部

-
-

VIM - Vi IMproved 8.2 (2019 Dec 12, compiled Jan 26 2020 11:30:30) -macOS version -Included patches: 1-148 -Huge version without GUI.

-
-

よく紹介されている手法

-

tac / tail

-

tac や tail -r などの外部コマンドを ! を使って呼び出し、置き換える。

-
-

:h v_!

-
-

tac コマンドや tail の -r オプションは環境によって利用できないことがあり、複数の環境を行き来する場合に採用しづらい

-

:g/^/m0

-

こちらは外部コマンドに頼らず、Vim の機能のみを使う。g は :global コマンドの、m は :move コマンドの略

-

:global コマンドは :[range]global/{pattern}/[command] のように使い、[range] で指定された範囲の行のうち、{pattern} で指定された検索パターンにマッチする行に対して、順番に [command] で指定された Ex コマンドを呼び出す。

-
-

:h :global

-
-

:move コマンドは [range]:move {address} のように使い、[range] で指定された範囲の行を {address} で指定された位置に移動させる。

-
-

:h :move

-
-

:g/^/m0 のように組み合わせると、「すべての行を1行ずつ 0行目(1行目の上)に動かす」という動きをする。これは確かに行の入れ替えになっている。

-

なお、:g/^/m0 は全ての行を入れ替えるが、:N,Mg/^/mN-1 とすることで N行目から M行目を処理範囲とするよう拡張できる。手でこれを入力するわけにはいかないので、次のようなコマンドを用意する。

-
command! -bar -range=%
-    \ Reverse
-    \ <line1>,<line2>g/^/m<line1>-1
-

これは望みの動作をするが、実際に実行してみると全行がハイライトされてしまう。次節で詳細を述べる。

-

:g/^/m0 の問題点

-

:global コマンドは各行に対してマッチングを行う際、現在の検索パターンを上書きしてしまう。^ は行の先頭にマッチするため、結果として全ての行がハイライトされてしまう。'hlsearch' オプションを無効にしている場合その限りではないが、その場合でも直前の検索パターンが失われてしまうと n コマンドなどの際に不便である。

-
-

:h @/

-
-

解決策

-
-

[2020/9/28追記] -より簡潔な方法を見つけたので次節に追記した

-
-

前述した :Reverse コマンドの定義を少し変えて、次のようにする:

-
function! s:reverse_lines(from, to) abort
-    execute printf("%d,%dg/^/m%d", a:from, a:to, a:from - 1)
-endfunction
-
-command! -bar -range=%
-    \ Reverse
-    \ call <SID>reverse_lines(<line1>, <line2>)
-

実行しているコマンドが変わったわけではないが、関数呼び出しを経由するようにした。これだけで前述の問題が解決する。

-

この理由は、ユーザー定義関数を実行する際は検索パターンが一度保存され、実行が終了したあと復元されるため。結果として検索パターンが ^ で上書きされることがなくなる。

-

Vim のヘルプから該当箇所を引用する (強調は筆者による)。

-
-

:h autocmd-searchpat

-

Autocommands do not change the current search patterns. Vim saves the current -search patterns before executing autocommands then restores them after the -autocommands finish. This means that autocommands do not affect the strings -highlighted with the ‘hlsearch’ option.

-
-

これは autocommand の実行に関しての記述だが、これと同じことがユーザー定義関数の実行時にも適用される。このことは :nohlsearch のヘルプにある。同じく該当箇所を引用する (強調は筆者による)。

-
-

:h :nohlsearch

-

(略) This command doesn’t work in an autocommand, because -the highlighting state is saved and restored when -executing autocommands |autocmd-searchpat|. -Same thing for when invoking a user function.

-
-

この仕様により、:g/^/m0 の呼び出しをユーザー定義関数に切り出すことで上述の問題を解決できる。

-

解決策 (改訂版)

-
-

[2020/9/28追記] -より簡潔な方法を見つけたため追記する

-
-
command! -bar -range=%
-    \ Reverse
-    \ keeppatterns <line1>,<line2>g/^/m<line1>-1
-

まさにこのための Exコマンド、:keeppatterns が存在する。:keeppatterns {command} のように使い、読んで字の如く、後ろに続く Exコマンドを「現在の検索パターンを保ったまま」実行する。はるかに分かりやすく意図を表現できる。

-
-

:h :keeppatterns

-
-

コピペ用再掲

-
" License: Public Domain
-
-command! -bar -range=%
-    \ Reverse
-    \ keeppatterns <line1>,<line2>g/^/m<line1>-1
-
-
-
- - - - - - diff --git a/docs/posts/2022-04-09/phperkaigi-2022-tokens/index.html b/docs/posts/2022-04-09/phperkaigi-2022-tokens/index.html deleted file mode 100644 index 4d4918e..0000000 --- a/docs/posts/2022-04-09/phperkaigi-2022-tokens/index.html +++ /dev/null @@ -1,375 +0,0 @@ - - - - - - - - PHPerKaigi 2022 トークン問題の解説 | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- - -
-
-

PHPerKaigi 2022 トークン問題の解説

- -
-
-
-

更新履歴

-
    -
  • 2022-04-09: 公開
    • -
  • 2022-04-16: 2問目、3問目の解説を追加、1問目に加筆
    • -
-
-

はじめに

-

本日開始された PHPerKaigi 2022 の PHPer チャレンジにおいて、弊社 デジタルサーカス株式会社 の問題を 3問作成した。この記事では、これらの問題の解説をおこなう。

-

リポジトリはこちら: https://github.com/nsfisis/PHPerKaigi2022-tokens

-

第1問 brainf_ck.php

-

ソースコードはこちら。実行には PHP 8.1 以上が必要なので注意。

-
<?php
-
-declare(strict_types=0O1);
-
-namespace Dgcircus\PHPerKaigi\Y2022;
-
-/**
- * @todo
- * Run this program to acquire a PHPer token.
- */
-
-https://creativecommons.org/publicdomain/zero/1.0/
-
-\error_reporting(~+!'We are hiring!');
-
-$z = fn($f) => (fn($x) => $f(fn(...$xs) => $x($x)(...$xs)))(fn($x) => $f(fn(...$xs) => $x($x)(...$xs)));
-$id = \spl_object_id(...);
-$put = fn($c) => \printf('%c', $c);
-$mm = fn($p, $n) => new \ArrayObject(\array_fill(+!![], $n, $p));
-
-$👉 = fn($m, $p, $b, $e, $mp, $pc) => [++$mp, ++$pc];
-$👈 = fn($m, $p, $b, $e, $mp, $pc) => [--$mp, ++$pc];
-$👍 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, ++$m[$mp]];
-$👎 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, --$m[$mp]];
-$📝 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, $put($m[$mp])];
-$🤡 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) {
-    +!![] => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) {
-      $b => $loop(++$pc, ++$n),
-      $e => $n === +!![] ? ++$pc : $loop(++$pc, --$n),
-      default => $loop(++$pc, $n),
-    })($pc, -![])],
-    default => [$mp, ++$pc],
-};
-$🎪 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) {
-    +!![] => [$mp, ++$pc],
-    default => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) {
-      $e => $loop(--$pc, ++$n),
-      $b => $n === +!![] ? $pc+![] : $loop(--$pc, --$n),
-      default => $loop(--$pc, $n),
-    })($pc, -![])],
-};
-$🐘 = fn($p) => $z(fn($loop) => fn($m, $p, $b, $e, $mp, $pc) =>
-  isset($p[$pc]) && $loop($m, $p, $b, $e, ...($p[$pc]($m, $p, $b, $e, $mp, $pc)))
-)($mm(+!![], +(![].![])), $p, $id($🤡), $id($🎪), +!![], +!![]);
-
-$🐘([
-  $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-  $🤡,
-    $👉, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-    $👈, $👈, $👈, $👈, $👎,
-  $🎪,
-  $👉, $👍, $👍, $👍, $👍, $👍, $📝,
-  $👎, $👎, $📝,
-  $👉, $👎, $👎, $👎, $📝,
-  $👉, $👎, $👎, $👎, $📝,
-  $👎, $👎, $📝,
-  $👎, $📝,
-  $👈, $📝,
-  $👉, $👉, $👎, $👎, $📝,
-  $👍, $👍, $👍, $👍, $👍, $👍, $👍, $📝,
-  $👈, $👎, $👎, $👎, $👎, $📝,
-  $👈, $📝,
-  $👉, $👍, $👍, $📝,
-  $👉, $👎, $📝,
-  $👈, $📝,
-]);
-

この問題は、単に適切なバージョンの PHP で動かせばトークンが得られる。

-

解説

-

絵文字

-

まず目につくのは大量の絵文字だろう。 -PHP は識別子に使用できる文字の範囲が広く、絵文字も使うことができる。

-

プログラム全体

-

Brainf*ck のインタプリタとプログラムになっている。 -Brainf*ck とは、難解プログラミング言語のひとつであり、ここで説明するよりも Wikipedia の該当ページを読んだ方がよい。

-

https://ja.wikipedia.org/wiki/Brainfuck

-

なお、brainf*ck プログラムを普通の書き方で書くと、次のようになる。

-
+ + + + + + + + + +
-[
-  > + + +
-  > + + + + +
-  > + + + + + + + + + + + +
-  > + + + + + + + + + +
-  < < < < -
-]
-> + + + + + .
-- - .
-> - - - .
-> - - - .
-- - .
-- .
-< .
-> > - - .
-+ + + + + + + .
-< - - - - .
-< .
-> + + .
-> - .
-< .
-

実行結果はこちら: https://ideone.com/22VWmb

-

それぞれの絵文字で表された関数が、各命令に対応している。

-
    -
  • $👉: >
    • -
  • $👈: <
    • -
  • $👍: +
    • -
  • $👎: -
    • -
  • $📝: .
    • -
  • $🤡: [
    • -
  • $🎪: ]
    • -
-

, (入力) に対応する関数はない (このプログラムでは使わないので用意していない)。

-

なお、$🐘 はいわゆる main 関数であり、プログラムの実行部分である。

-

絵文字の選択

-

おおよそ意味に合致するよう選んでいるが、$🤡 と $🎪 は弊社デジタルサーカスにちなんでいる。 -また、$🐘 は PHP のマスコットの象に由来する。

-

strict_types

-

declare 文の strict_types に指定できるのは、0 か 1 の数値リテラルだが、 -0x0 や 0b1 のような値も受け付ける。 -今回は、PHP 8.1 から追加された、0O または 0o から始まる八進数リテラルを使った。

-

URL

-

ソースコードのライセンスを示したこの部分だが、

-
https://creativecommons.org/publicdomain/zero/1.0/
-

完全に合法な PHP のコードである。 -https: 部分はラベル、// 以降は行コメントになっている。

-

リテラルなしで数値を生成する

-

ソースコード中に、ほとんど数値リテラルが書かれていないことにお気づきだろうか。 -PHP では、型変換を利用することで任意の整数を作り出すことができる。

-
assert(0 === +!![]);
-assert(1 === +![]);
-assert(2 === ![]+![]);
-assert(3 === ![]+![]+![]);
-assert(10 === +(![].+!![]));
-

[] に ! を適用すると true が返ってくる。それに + -を適用すると、bool から int ヘの型変換が走り、1 が生成される。10 -はさらにトリッキーだ。まず 1 と 0 を作り、. で文字列として結合する -('10')。これに + を適用すると、string から int -への型変換が走り、10 が生まれる (コード量に頓着しないなら、1 を 10 -個足し合わせてももちろん 10 が作れる)。

-

また、error_reporting に指定しているのは -1 である。 -これは、! によって文字列を false にし、+ によって false を 0 にし、さらにビット反転して -1 にしている。

-

if 文なしで条件分岐

-

三項演算子ないし match 式を使うことで、if を一切書かずに条件分岐ができる。 -また、&& / || も使えることがある。 -遅延評価が不要なケースでは、[$t, $f][$cond] のような形で分岐することもできる。

-

while、for 文なしでループ

-

不動点コンビネータを使って無名再帰する (詳しい説明は省略する。これらの単語で検索してほしい)。 -ここでは、一般に Z コンビネータとして知られるものを使った ($z)。

-

実際のところ、$🤡 や $🎪、$🐘 は、一度 Scheme (Lisp の一種) で書いてから PHP に翻訳する形で記述した。

-

なお、PHP は末尾再帰の最適化をおこなわない (少なくとも今のところは) ので、 -あまりに長い brainf*ck プログラムを書くとスタックオーバーフローする。

-

第2問 riddle.php

-

ソースコードはこちら。実行には PHP 8.0 以上が必要なので注意。

-
<?php
-
-/*********************************************************
- * This program displays a PHPer token.                  *
- * Guess 'N'.                                            *
- *                                                       *
- * Hints:                                                *
- * - N itself has no special meaning, e.g., 42, 8128,    *
- *   it is selected at random.                           *
- * - Each element of $token represents a single letter.  *
- * - One letter consists of 5x5 cells.                   *
- * - Remember, the output is a complete PHPer token.     *
- *                                                       *
- * License:                                              *
- *   https://creativecommons.org/publicdomain/zero/1.0/  *
- *********************************************************/
-const N = 0 /* Change it to your answer. */;
-assert(0 <= N && N <= 0b11111_11111_11111_11111_11111);
-
-$token = [
-  0x14B499C,
-  0x0BE34CC, 0x01C9C69,
-  0x0ECA069, 0x01C2449, 0x0FDB166, 0x01C9C69,
-  0x01C1C66, 0x0FC1C47, 0x01C1C66,
-  0x10C5858, 0x1E4E3B8, 0x1A2F2F8,
-];
-foreach ($token as $x) {
-  $x = $x ^ N;
-
-  $x = sprintf('%025b', $x);
-  $x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-  $x = implode("\n", str_split($x, length: 5));
-  echo "{$x}\n\n";
-}
-

さて、この問題はさきほどのように単純に実行しただけでは、謎のブロックが表示されるだけでトークンは得られない。 -トークンを得るためには、ソースコードを読み、定数 N を特定する必要がある。

-

ここでは、私の想定解を解説する。

-

読解

-

まずはソースコードを読んでいく。

-
$token = [
-  // 略
-];
-

数値からなる $token があり、各要素をループしている。

-
  $x = $x ^ N;
-

まずは排他的論理和 (xor) を取り、

-
  $x = sprintf('%025b', $x);
-

二進数に変換して、

-
  $x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-

0 を空白に、1 を # にし、

-
  $x = implode("\n", str_split($x, length: 5));
-

5文字ごとに区切ったあと、改行で結合している。

-

ヒント

-

次に、ソースコードに書いてあるヒントを読んでいく。

-
    -
  • N それ自体は、42 や 8128 といったような特別な意味を持たず、ランダムに決められている
    • -
  • $token の各要素は、1文字を表す
    • -
  • 1文字は 5x5 のセルからなる
    • -
  • 出力されるのは、完全な PHPer トークンである
    • -
-

ここで、PHPer トークンは必ず # 記号から始まることを思いだすと、 -$token の最初の数字 0x14B499C は、変換の結果 # になるのではないかと予想される (なお、このことは、リポジトリの README ファイルに追加ヒントとして書かれている)。

-

解く

-

ここまでわかれば、あと一歩で解ける。すなわち、0x14B499C が # に変換されるような N を見つければよい。

-

N は高々

-
assert(0 <= N && N <= 0b11111_11111_11111_11111_11111);
-

なのでブルートフォースしてもよいが、ここではブルートフォースしない方法を紹介する。

-
<?php
-
-$x = 0x14B499C;
-
-$x = $x ^ N;
-
-$x = sprintf('%025b', $x);
-$x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-$x = implode("\n", str_split($x, length: 5));
-
-assert($x ===
-  " # # \n" .
-  "#####\n" .
-  " # # \n" .
-  "#####\n" .
-  " # # ");
-

この一連の変換に対する逆変換を考えると、次のようになる。

-
<?php
-
-$x =
-  " # # \n" .
-  "#####\n" .
-  " # # \n" .
-  "#####\n" .
-  " # # ";
-
-$x = implode('', explode("\n", $x));
-$x = str_replace(search: [' ', '#'], replace: ['0', '1'], subject: $x);
-$x = bindec($x);
-
-$n = $x ^ 0x14B499C;
-
-echo "N = $n\n";
-

これを実行すると、N が得られる。

-

第3問 toquine.php

-

ソースコードはこちら。

-
<?php
-
-// License: https://creativecommons.org/publicdomain/zero/1.0/
-// This is a quine-like program to generate a PHPer token.
-// Execute it like this: php toquine.php | php | php | php | ...
-
-$s = <<<'Q'
-<?cuc
-// Yvprafr: uggcf://perngvirpbzzbaf.bet/choyvpqbznva/mreb/1.0/
-// Guvf vf n dhvar-yvxr cebtenz gb trarengr n CUCre gbxra.
-// Rkrphgr vg yvxr guvf: cuc gbdhvar.cuc | cuc | cuc | cuc | ...
-%f$f = %f;
-$f = fge_ebg13($f); $kf = [
-%f,
-];
-$g = ahyy.snyfr; sbe ($v = 0; $v <= vagqvi(__YVAR__-035,6); ++$v) vs (!vffrg($kf[$v])) oernx; ryfr
-$g .= vzcybqr("\a", fge_fcyvg(fge_ercynpr(['0','1'], ['  ','##'], fcevags(pue(37) . '025o', $kf[$v])), 012)) . "\a\a";
-$jf = neenl_znc(sa($j) => vzcybqr(', ', $j), neenl_puhax(neenl_znc(sa($k) => fcevags('0k' . pue(37) . '07K', $k), $kf), 10));
-cevags($f, $g, fge_ebg13("<<<'Q'\a{$f}\aQ"), vzcybqr(",\a", $jf));
-Q;
-$s = str_rot13($s); $xs = [
-0x0AFABEA, 0x1F294A7, 0x1F2109F, 0x1F294A7, 0x0002800, 0x1F2109F, 0x0117041, 0x1F294A7, 0x1FAD6B5, 0x1F295B7,
-0x010FC21, 0x1FAD6B5, 0x1151151, 0x010FC21, 0x1F294A7, 0x1F295B7, 0x1FAD6B5, 0x1F294A7, 0x1F295B7, 0x1F8C63F,
-0x1F8C631, 0x1FAD6B5, 0x17AD6BD, 0x17AD6BD, 0x1F8C63F, 0x1F295B7,
-];
-$t = null.false; for ($i = 0; $i <= intdiv(__LINE__-035,6); ++$i) if (!isset($xs[$i])) break; else
-$t .= implode("\n", str_split(str_replace(['0','1'], ['  ','##'], sprintf(chr(37) . '025b', $xs[$i])), 012)) . "\n\n";
-$ws = array_map(fn($w) => implode(', ', $w), array_chunk(array_map(fn($x) => sprintf('0x' . chr(37) . '07X', $x), $xs), 10));
-printf($s, $t, str_rot13("<<<'D'\n{$s}\nD"), implode(",\n", $ws));
-

コメントにもあるとおり、次のようにして実行すれば答えがでてくる。

-
$ php toquine.php | php | php | php | ...
-

実際にはもう少しパイプで繋げなければならない。

-

解説

-

プログラム全体

-

コメントにもあるとおり、これは quine (風) のプログラムになっている。 -Quine とは、自分のソースコードをそっくりそのまま出力するようなプログラムのことである。

-

このプログラムは、実行すると自身とほとんど同じプログラムを出力する。 -異なるのはトークンになっている部分のみである。

-

トークン

-

$xs がトークンに対応している。変換のロジックは riddle.php とほぼ同じなので省略する。

-

状態保持

-

トークンの何文字目まで出力したかを、ソースコードを変えずに (quine なので) 覚えておく必要がある。 -このプログラムでは、トークンが出力されるとソースコードがだんだんと長くなっていくのを利用して、__LINE__ から情報を取得している。

-

ROT 13

-

Quine は、素朴に書くとプログラムの一部が 2回記述されてしまう。 -これがあまり美しくないので、toquine.php では、ROT 13 変換を使って難読化した。

-

それにしてもなぜこんなものが標準ライブラリに……。

-

おわりに

-

解いていただいたみなさん、また、難易度調整につきあっていただいた社内のみなさん、ありがとうございました。

-

今回は直前に作りはじめたのもあり、3問だけかつ使い古されたネタばかりになってしまいましたが、 -来年は 5問、より面白い問題を持っていきます。

-

実はもう作りはじめているので、どうか来年もありますように……。

- -
-
- - - - - - diff --git a/docs/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal/index.html b/docs/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal/index.html deleted file mode 100644 index a1e9ca7..0000000 --- a/docs/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal/index.html +++ /dev/null @@ -1,102 +0,0 @@ - - - - - - - - term-banner: ターミナルにバナーを表示するツールを書いた | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- - -
-
-

term-banner: ターミナルにバナーを表示するツールを書いた

- -
-
-
-

更新履歴

-
    -
  • 2022-04-24: 公開
    • -
  • 2022-04-27: -f オプションについて追記
    • -
-
-

はじめに

-

こんなものを作った。

-
$ term-banner 'Hello, World!' 'こんにちは、' '世界！'
-

term-banner のスクリーンショット

-

コマンドライン引数として渡した文字列をターミナルに大きく表示する。

-

リポジトリはこちら: https://github.com/nsfisis/term-banner

-

Motivation

-

以前、big-clock-mode という似たようなプログラムを書いた。 -これは tmux の :clock-mode コマンドに着想を得たもので、:clock-mode よりも大きく現在時刻を表示する。

-

big-clock-mode を開発したのは、次のようなシチュエーションで使うためである。 -弊社では現在リモートワークが基本だが、web 会議などで画面共有しているときに、休憩を挟んで特定の時刻から再開する、ということがある。 -こういったケースで、画面上に現在の時刻を大きめに表示しておくと、モニタから離れても遠くから時刻がわかるので便利である。

-

それこそタイマアプリか何かを使えばいいのだが、ターミナルに棲むいきものとしては、住処から離れたくないわけだ。

-

しばらく便利に使っていたのだが、ひとつ不満点が出てきた。それは、再開する時刻がいつだったかを覚えておかなければならないということだ。 -どこかにメモしておいてもいいが、せっかくなら現在時刻とともに表示させておきたい。

-

そんなわけで、「任意の文字列をターミナルに表示する」プログラムを書く運びとなった。 -まあ、作らなくても探せばあると思うが、作りたいものは作りたいので知ったことではない。

-

プログラム

-

全体の流れは次のようになっている。

-
    -
  1. フォントファイルを読み込む
    2. -
  2. コマンドライン引数を Shift-JIS に変換する (フォントが Shift-JIS 基準で並んでいるため)
    3. -
  3. 1文字ずつレンダリングしていく
    4. -
-

big-clock-mode が Go 製なので、今回も Go で書いた。 -PNG が標準ライブラリにあったり、Shift-JIS のエンコーディングが準標準ライブラリにあったりしたのは助かった。

-

フォントファイルは go:embed で実行ファイルに埋め込んでいるので、ビルド後はワンバイナリで動く。 -仕事ではスクリプト言語ばかり書いているが、やはりコンパイル言語はいい。

-

フォント

-

フリーの 8x8 ビットマップフォントである、美咲フォント 2021-05-05a 版 を使わせていただいた。

-

はじめは自分でポチポチ打っていたのだが、「き」くらいまでやって挫折した。 -同じく 8x8 で作っていたのだが、平仮名でさえも、この小さなキャンバスにはとても収められない。

-

美咲フォントは、平仮名・片仮名に留まらず、JIS 第一・第二水準の漢字までサポートしている。 -第二水準ともなると一生お目にかかることのない字の方が多いくらいだが、これをこの大きさで書くというのは、もはや芸術の域である。

-

さらに言うと、実のところ美咲フォントは実サイズ 7x7 で作られており、余白が設けられている。 -これは、単純にそのまま並べても字間・行間を確保できるようにという配慮である。 -おかげでコーディングまで楽になった。

-

ゴシック体と明朝体があったが、私の好みで明朝体の方にした。 -ただ、ゴシック体の方が見やすい気がするので、フォントを選べるように後ほど拡張するかもしれない。

-

2022-04-27 追記: -f オプションで選べるようにした。

-

おわりに

-

あなたもターミナルに住んでみませんか？

- -
-
- - - - - - diff --git a/docs/posts/2022-05-01/phperkaigi-2022/index.html b/docs/posts/2022-05-01/phperkaigi-2022/index.html deleted file mode 100644 index b56c70a..0000000 --- a/docs/posts/2022-05-01/phperkaigi-2022/index.html +++ /dev/null @@ -1,133 +0,0 @@ - - - - - - - - PHPerKaigi 2022 | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- - -
-
-

PHPerKaigi 2022

- -
-
-
-

更新履歴

-
    -
  • 2022-05-01: 公開
    • -
-
-

はじめに

-

2022-04-09 から 2022-04-11 にかけて開催された、PHPerKaigi 2022 に、一般参加者として参加した。 -弊社デジタルサーカス株式会社 はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。

-

昨年のレポートはこちら。

-

感想

-

厳選おすすめトーク

-

多くの素晴らしいトークの中から、特におすすめのものを 5つ選んだ。是非聞いてほしい。引用部分は、リンク先プロポーザルから引用している。

-

予防に勝る防御なし - 堅牢なコードを導く様々な設計のヒント

-
-

PHP はバージョンを追う毎に型宣言、例外、表明、列挙型などの機能が大幅に強化され、堅牢なコードを書くための機能が充実してきました。それらの機能はどう使うと効果的なのでしょうか。

-

本講演では PHP 8.1 をベースにして、誤りを想定してチェックするのではなく、そもそも誤りにくい設計とはどのようなものか、つまり「予防」の観点を軸足に、堅牢なコードを導くための様々な設計のヒントをご紹介します。

-
-

PHPのエラーを理解して適切なエラーハンドリングを学ぼう

-
-

PHPを使ってるとよく遭遇する Fatal error / Parse error / Warning / Notice 理解していますか？
-これらのエラー文を理解することで、すぐにエラーの原因に気付き適切に対象できる様になります！
-またそれらを理解した上でのエラーハンドリングを学びましょう。

-
-

エラー監視とテスト体制への改善作戦

-
-

毎日流れてくるエラーに皆さんはどう向き合ってますか？
-エラーを出さない事が一番ですが、完全に塞ぐ事は難しいと考えます。
-サービス運用の中で本番環境から発生するエラー（サーバー・クライアントサイド・サードパーティ起因のエラー）への監視体制と、
-エラー・バグ防御のためチームで行っているテストコード文化づくりの話をします。

-
-

ISUCON11のPHP実装は、何を考え、どのようにして作られていたのか

-
-

昨年開催されたISUCON11にて問題（参考実装）のPHPへの移植を担当させていただきました。

-

最終的なソースコードこそシンプルなWebアプリケーションではありますが、その裏には
-・「（私の思う）良い設計」を実現するための意思決定
-・「ISUCONの問題」という位置付けに由来する取捨選択
-・移植中に遭遇したトラブルとその解決策
-といった文脈や葛藤が存在しています。

-

本発表はそれらを共有することで
-・PHPアプリケーションの設計、実装事例として役立ててもらう
-・ISUCONの言語移植に興味を持ってもらう
-・ISUCON問題移植の「実装や設計の練習をする教材」としての可能性を知ってもらう
-ことを目的とします。

-
-

チームの仕事はまわっていたけど、メンバーはそれぞれモヤモヤを抱えていた話──40名の大規模開発チームで1on1ログを公開してみた

-
-

サイボウズの大企業向けグループウェアのGaroon（ガルーン）は、PHPで開発されている20年目の製品です。ガルーン開発チームは日本で40名、ベトナムで50名の計90名ほどのチームになっています。また、コロナ禍でフルリモートでの活動がこの2年ほど継続してきました。

-

フルリモートになっても仕事はまわっており、継続的にリリースはしていましたが、一方でお互いの考えていることや感じている問題意識が見えづらくなり、モヤモヤを抱えているメンバーが増えていました。

-

このセッションでは、そういう状況で私がチーム外からジョインし、聴き役に徹しながら見える化することで状況を改善していった取り組みを紹介します。同じように大きなチームやリモートワークで難しさを感じている人に、難しさの原因への気づきや取り組みへのヒントがあれば幸いです。

-
-

トークン問題の作成

-

今回は、PHPer チャレンジ用に弊社のトークン問題を 3題作成した。こちらについては別途記事にしているので、そちらを参照されたい。

-

PHPer チャレンジ

-

1位になった。
-また、賞品として Echo Show 15 をいただいた。

-

カンファレンス全体への感想

-

去年の参加レポ では、こんなことを書いた。

-
-

1つ個人的な反省点としては、(中略) Discord しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。
-まあ初カンファレンスだし、とお茶を濁しておこう。

-
-

この反省を踏まえ、今年は積極的にほかの場 (公式の Discord サーバや、アンカンファレンス) にも参加した。
-これにより、参加体験の質がはるかに向上した。特に Discord に関しては、登壇者ご本人による補足や、質問への回答などがおこなわれる (ことが多い) ため、特別な理由のない限り、発言はしないまでも参加はしておいたほうが良いと思われる。

-

なお、アンカンファレンスについては、1日目の終わりにトークン問題の解説放送もおこなった。

-

また、今年はオフラインとオンラインのハイブリッド開催であったが、去年の全オンラインと比べて、オンライン参加の体験が落ちていなかったのは、特筆すべきであろう。 -今年は 3回目のワクチン接種が間に合わなかったこともあり現地参加は見送ったのだが、来年は是非オフラインで参加したい。

-

そして来年へ……?

-

PHPerKaigi 2023 があるかどうか存じ上げないが、あるとすれば、次の 4つを目標としたい。

-
    -
  • プロポーザルを出す
    • -
  • PHPer チャレンジのトークン問題を 5題作成する
    • -
  • 現地に行く
    • -
  • PHPer チャレンジで圧勝する
    • -
-
-

最後になりましたが、PHPerKaigi のスタッフ、スポンサー、スピーカーのみなさん、素敵な時間をありがとうございました。

-

ではまた来年。

- -
-
- - - - - - diff --git a/docs/posts/2022-08-27/php-conference-okinawa-code-golf/index.html b/docs/posts/2022-08-27/php-conference-okinawa-code-golf/index.html deleted file mode 100644 index b9c337e..0000000 --- a/docs/posts/2022-08-27/php-conference-okinawa-code-golf/index.html +++ /dev/null @@ -1,102 +0,0 @@ - - - - - - - - PHP カンファレンス沖縄で出題されたコードゴルフの問題を解いてみた | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- - -
-
-

PHP カンファレンス沖縄で出題されたコードゴルフの問題を解いてみた

- -
-
-
-

更新履歴

-
    -
  • 2022-08-27: 公開
    • -
-
-

はじめに

-

本日 PHP カンファレンス沖縄 2022 が開催された (らしい)。

-

カンファレンスには参加できなかったものの、懇親会の LT で出題されたコードゴルフの問題が Twitter に流れてきたので、解いてみた。

-

ツイート: https://twitter.com/m3m0r7/status/1563397620231712772
-スライド: https://speakerdeck.com/memory1994/php-conference-okinawa-2022-extra?slide=3

-

解

-

細かいレギュレーションは不明だったので、勝手に定めた。

-
    -
  • コマンドライン引数の第1引数で受けとる
    • -
  • 結果は標準出力に出す
    • -
  • コンマの直後にはスペースを1つ置く
    • -
  • 末尾コンマは禁止
    • -
  • 数字でないものは入ってこないものとする
    • -
  • 負数は入ってこないものとする
    • -
-

書いたものがこちら:

-
[<?php $n=$argv[1];foreach([1e4,5e3,2e3,1e3,500,100,50,10,5,1]as$x)for(;$n>=$x;$n-=$x)$r[]=$x;echo implode(', ',$r??[]);?>]
-

しめて 123 バイトとなった (末尾改行を含めずにカウント)。

-

こちらは改行とスペースを追加したバージョン:

-
[<?php
-
-$n = $argv[1];
-foreach ([1e4, 5e3, 2e3, 1e3, 500, 100, 50, 10, 5, 1] as $x)
-  for (; $n >= $x; $n -= $x)
-    $r[] = $x;
-echo implode(', ', $r ?? []);
-
-?>]
-

使用したテクニック

-

指数表記

-

割と多くの言語のゴルフで使えるテクニック。e を用いた指数表記で、大きな数を短く表す。このコードでは 10000、5000、2000、1000 を指数表記している。

-

foreach や for の中身を1つの文に

-

foreach、for、if などの後ろには、通常 { を続けて複数の文を連ねるが、中身の文を1つにしてしまえば、{ と } を省略できる。C言語などでも使える。

-

$r に初期値を入れない

-

PHP では、$r[] = ... のような配列の末尾に追加する式を実行したとき、$r が未定義だった場合は $r を勝手に定義して空の配列で初期化してくれる。これを利用すると、$r = []; のような初期化が不要になる。

-

ただし、プログラムに 0 が渡されるとループを一度も回らないので、$r が未定義になってしまい、implode() に渡すところでエラーになる。それを防ぐために $r ?? [] を使っている。

-

もし 0 が渡されたケースを無視するなら、これが不要になるので 4 バイト縮む。

-

PHP タグの外に文字列を置く

-

PHP では、<?php ?> で囲われた部分の外側にある文字列は、そのまま出力される。今回のケースでは、先頭と末尾に必ず [ と ] を出力するので、そのまま書いてやればよい。

-

おわりに

-

最後になりましたが、めもりー さん、楽しい問題をありがとうございました。

- -
-
- - - - - - diff --git a/docs/posts/2022-08-31/support-for-communty-is-employee-benefits/index.html b/docs/posts/2022-08-31/support-for-communty-is-employee-benefits/index.html deleted file mode 100644 index bf217ca..0000000 --- a/docs/posts/2022-08-31/support-for-communty-is-employee-benefits/index.html +++ /dev/null @@ -1,74 +0,0 @@ - - - - - - - - 弊社の PHP Foundation への寄付に寄せて | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- - -
-
-

弊社の PHP Foundation への寄付に寄せて

-
-
-
-

更新履歴

-
    -
  • 2022-08-31: 公開
    • -
-
-

はじめに

-

注: これは私個人の意見であり、所属する組織を代表するものではありません。

-

先日、私の勤める デジタルサーカス株式会社 が PHP Foundation へ $2,000 の寄付をおこないました。

-

記事: https://www.dgcircus.com/news/581

-

本件を社内でしつこく推進した1人として、推進の理由等を書き残しておきます。

-

なぜ？

-

組織としての寄付理由は前掲した記事に譲るとして、ここでは、私が社内でこの件を推進した理由について書くことにします。

-

当時の考えを端的にまとめた社内チャットの投稿があったので、それを引用します:

-
-

結局これを通したい (私の中での) 最大の理由が、「自分の勤める会社が、これをやる会社であってほしい」というのがあり、↑にしても、感情ベースの理由しか出せていないというのが説得力に欠けている理由なのだと思いますが、寄付の報告が流れてきたり、OSS のフリーライドの話が流れてきたりするたびに、自尊心が毀損される、というか (これは大袈裟すぎる表現で、実際にはそこまで明確に傷ついているわけではありませんが)。

-

追記: 「肩身が狭くなる」というのがより適切でした。

-
-

※文中の「↑にしても」は、ここに載せていない別の投稿を指しています。

-

OSS を金銭的に支援したり、技術カンファレンスへ協賛したり (あるいは CTO がカンファレンスを年2で主催したり: iOSDC PHPerKaigi) といった行為は、コミュニティへの貢献であると同時に、社員に対する精神的福利厚生でもあると言えるでしょう (知らんけど)。これらは、技術や技術者を大切にする組織である、ということの、対外的にも対内的にも強力なメッセージなのです。

-

以上が、私が社内で寄付の件を進めた (かなり私的な) 理由です。

-

おわりに

-

最終的に社としての寄付まで漕ぎ着けられたのは、もちろん私の力ではなく役員の方々の決定によるものです。この場を借りて感謝申し上げます。

- -
-
- - - - - - diff --git a/docs/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line/index.html b/docs/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line/index.html deleted file mode 100644 index 921a607..0000000 --- a/docs/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line/index.html +++ /dev/null @@ -1,520 +0,0 @@ - - - - - - - - [PHP] fizzbuzz を書く。1行あたり2文字で。 | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- - -
-
-

[PHP] fizzbuzz を書く。1行あたり2文字で。

- -
-
-
-

更新履歴

-
    -
  • 2022-09-28: 公開
    • -
  • 2022-09-29: 小さな文言の修正・変更
    • -
-
-

記事の構成について

-

この記事は、普通の fizzbuzz を徐々に変形して最終形にしていく、という構成で書かれている。最終形を見てどのような仕組みで動いているのか解読してから解説を読みたい、というかたがいれば、 このページ にソースコードがあるので、そちらを先に見てほしい。

-

レギュレーション

-

PHP で、次のような制約の下に fizzbuzz を書いた。

-
    -
  • 1行あたりの文字数は2文字までに収めること (ただし <?php タグは除く) -
      -
    • 厳密な定義: <?php タグ以降のソースコードが、2 byte ごとに ラインフィード (LF) で区切られること
      • -
    -
    • -
  • スペースやタブを使用しないこと
    • -
  • ループのアンロールをしないこと -
      -
    • 100 回ループの代わりに 100 回コードをコピペ、というのは禁止
      • -
    -
    • -
  • PHP 7.4〜8.1 で動作すること
    • -
  • 実行時に Notice や Warning が出ないこと
    • -
  • 標準的なインストール構成の PHP で実現できること (デフォルトで有効になっていない拡張等を使わないこと)
    • -
-

備考: PHP には short_open_tag というオプションがあり、これを有効にするとファイル冒頭の <?php の代わりに <? を使うことができ、文字どおり1行2文字で書ける。ただ、このオプションはデフォルト off になっている環境が多いようなので、今回は使わないことにした。

-

主な障害

-

1行あたりの文字数など、適当に改行を挟めばいいだけではないのか？

-

特に、C言語でこのような試みをおこなったことがあるかたならそう思うだろう。事実、Cでのこの制約はほとんど無意味に等しい。

-
#\
-i\
-n\
-c\
-l\
-u\
-d\
-e\
-<\
-s\
-t\
-d\
-i\
-o\
-.\
-h\
->\
-/*
-*/
-i\
-n\
-t\
-/*
-*/
-m\
-a\
-i\
-n(
-){
-f\
-o\
-r(
-i\
-n\
-t\
-/*
-*/
-i=
-1;
-i<
-1\
-0\
-0;
-i\
-+\
-+)
-if
-(i
-%\
-15
-==
-0)
-p\
-r\
-i\
-n\
-t\
-f(
-"\
-F\
-i\
-z\
-z\
-B\
-u\
-z\
-z\
-%\
-c\
-",
-10
-);
-
-/* あとは同じように普通のプログラムを変形するだけなので省略 */
-

バックスラッシュを使った行継続がトークンを区切らない、というのがポイントだ。

-

さて、PHP ではそもそもバックスラッシュを行継続に使うことができない。これにより、「3文字以上からなるトークンが一切使えない」という制約が課される。例えば、echo で出力することや、for でループすること、new でインスタンスを生成することができない。特に、出力は fizzbuzz をどんなアルゴリズムで実装しようとおこなわなければならないので、できないのは致命的である。

-

当然、名前が3文字以上ある関数も使えない。なお、標準 PHP の範囲内において、名前が 2文字以下の関数は以下のとおりである:

-
    -
  • _: gettext のエイリアス
    • -
  • dl: 拡張モジュールをロードする
    • -
  • pi: 円周率を返す
    • -
-

(環境によって多少は変わるかも)

-

2文字の関数を定義しまくった拡張モジュールを用意しておいて dl() で読み込む行為は、レギュレーションで定めた

-
-
    -
  • 標準的なインストール構成の PHP で実現できること (デフォルトで有効になっていない拡張等を使わないこと)
    • -
-
-

に反する (というより、「それだとおもしろくもなんともないので、このルールを足した」というのが正しい)。

-

また、2文字だと文字列がまともに書けないのも辛い。'' だけで 2文字使うので、「1文字の文字列リテラル」というものを書くことができない。PHP では文字列リテラル中に生の改行が書けるので

-
$a
-='
-a'
-;;
-

とすると $a は "\na" になるのだが、余計な改行が入ってしまう。

-

これらの障害をどのように乗り越えるのか、次節から見ていく。

-

解説

-

普通の (?) fizzbuzz

-

まずは普通に書くとしよう。

-
<?php
-
-for ($i = 1; $i < 100; $i++) {
-  echo (($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n";
-}
-

素直に書いた fizzbuzz とは言い難いが、このくらいは普通だということにしておかないと、この先がやっていられないので許してほしい。

-

for の排除

-

for は、3文字もある長いキーワードである。こんなものは使えない。array_ 系の関数を使って、適当に置き換えるとしよう。

-
<?php
-
-$s = range(1, 100);
-array_walk(
-  $s,
-  fn($i) =>
-    printf((($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n"),
-);
-

array_walk や range、printf といった for よりも長いトークンが現れてしまったが、これは次節で直すことにする。なお、echo は文 (statement) であり式 (expression) ではないので、式である printf に置き換えた。

-

関数呼び出しの短縮

-

range、array_walk、printf は長すぎるのでどうにかせねばならない。ここで、PHP の可変関数を使う。可変関数とは、関数名が文字列として入った変数を経由して、関数を呼び出す機能である。

-
<?php
-
-$r = 'range';
-$w = 'array_walk';
-$p = 'printf';
-
-$s = $r(1, 100);
-$w(
-  $s,
-  fn($i) =>
-    $p((($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n"),
-);
-

これで関数を呼び出している所は短くなった。では、$r や $w や $p、また 'Fizz' や 'Buzz' はどうやって 1行2文字に収めるのか。次のテクニックへ移ろう。

-

余談: PHP 8.x で動作しなくてもいいなら

-

今回使ったテクニックを説明する前に、余談として、文字列リテラルの短縮法として今回採用しなかったものを紹介する。

-
-
    -
  • PHP 7.4〜8.1 で動作すること
    • -
-
-

というルールがない場合、「未定義の定数が評価された場合、その定数の名前が値になる」という PHP 7.x までの仕様が利用できる。例えば、 Fizz という文字列が欲しければ、次のようにする。

-
$f
-=F
-.i
-.z
-.z
-;;
-

こうして簡単に文字列を作れる。なお、この仕様は 7.x 時点でも警告を受けるので、@ 演算子を使って抑制してやるとよい。

-
$f
-=@
-F.
-@i
-.#
-@z
-.#
-@z
-;;
-

むしろ、このことがわかっていたからこそ PHP 8.x での動作を要件に課したところがある。

-

文字列リテラルの短縮

-

実際に使った手法の説明に移る。

-

ずばり、文字列同士のビット演算を使う。PHP では、文字列同士でビット演算 (&、|、^) をした場合、文字列の各バイトごとに指定したビット演算がなされ、それを結合したものが演算結果となる。

-
$a = "12345";
-$b = "world";
-
-// $a ^ $b は次のコードと同じ
-$result = '';
-for ($i = 0; $i < min(strlen($a), strlen($b)); $i++) {
-  $result .= $a[$i] ^ $b[$i];
-}
-
-echo $result;
-// => F]AXQ
-

これを踏まえ、次のコードを見てみよう。

-
$x = "x\nOm\n";
-$y = "\nk!\no";
-$r = $x ^ $y;
-echo "$r\n";
-

実行すると、range が表示される。さて、PHP では文字列リテラル中に生の改行を直接書いてもよいのだった (「主な障害」の節を参照のこと)。書きかえてみよう。

-
$x
-='x
-Om
-';
-$y
-='
-k!
-o'
-;
-
-$r = $x ^ $y;
-echo "$r\n";
-

さらに # を使って適当に調整すると、次のようになる。

-
$x
-=#
-'x
-Om
-';
-$y
-='
-k!
-o'
-;#
-$r
-=#
-$x
-^#
-$y
-;#
-
-echo "$r\n";
-

1行あたり2文字で、range という文字列を生成することに成功した。他の必要な文字列にも、同様の処理をほどこす。

-

備考: Buzz 中にある小文字の u は、このロジックだと non-printable な文字になってしまう。ここまでのテクニックを駆使すれば回避するのはそう難しくないので、考えてみてほしい。

-

完成系

-

完成したものがこちら。

-
<?php
-
-$x
-=#
-'i
-S'
-;;
-$y
-='
-b!
-';
-$c
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'x
-Om
-';
-$y
-='
-k!
-o'
-;#
-$r
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'k
-Sk
-~}
-Ma
-';
-$y
-='
-x!
-s!
-k!
-';
-$w
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'z
-Hd
-G'
-;#
-$y
-='
-x!
-~!
-';
-$p
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'L
-[p
-';
-$y
-='
-c!
-';
-$f
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'H
-[p
-';
-$y
-='
-_!
-';
-$b
-=#
-$x
-^#
-$y
-;#
-$b
-[1
-]=
-$c
-(#
-13
-*9
-);
-$s
-=#
-$r
-(1
-,(
-10
-**
-2)
-);
-$w
-(#
-$s
-,#
-fn
-(#
-$i
-)#
-=>
-$p
-((
-(#
-$i
-%3
-?#
-''
-:#
-$f
-).
-(#
-$i
-%5
-?#
-''
-:#
-$b
-)?
-:#
-$i
-)#
-.'
-')
-);
-

感想など

-

PHP は、スクリプト言語の中だとシンタックスシュガーが少ない (体感)。この挑戦は不可能に思われたが、PHP マニュアルとにらめっこしていたらなんとかなった。

-

みんなもプログラムを細長くしよう。

-

余談2: 別解

-

PHP では、バッククォートを使ってシェルを呼び出せる。これは shell_exec 関数と等価である。さて、PHP ではバックスラッシュによる行継続が使えないと書いたが、シェルでは使える (当然だが、呼び出されるシェルに依存する。Bash なら大丈夫だろう。知らんけど)。

-
<?php
-
-printf(`
-e\
-c\
-h\
-o\
- \
-1\
-2\
-3\
-`);
-

なお、ここでは簡単のため出力に printf をそのまま使っているが、実際には printf という文字列を合成して可変関数で呼び出す。

-

ただし、これでは

-
-
    -
  • スペースやタブを使用しないこと
    • -
-
-

に違反してしまう。スペースが使えないと引数とコマンドを区切れない。これは困った。

-

もうこれ以上は不可能だと思っていたのだが、この記事の執筆中に解決する方法を思いついたので載せておく。

-
<?php
-
-$c = 'chr';
-
-${
-'_
-'}
-=#
-$c
-(#
-32
-).
-$c
-(#
-92
-);
-
-printf(`
-e\
-c\
-h\
-o\
-${
-'_
-'}
-1\
-2\
-3\
-`);
-

先程と同じく、chr や printf を生成する部分は長くなるので省いた。

-
${
-'_
-'}
-

は変数で、中にはスペースとエスケープが入っている (chr(32) . chr(92))。シェルに渡されている文字列は次のようになる。

-
e\
-c\
-h\
-o\
- \
-1\
-2\
-3\
-

これは、前掲したコマンドと同じだ。かくして、スペースを陽に書かずにシェルをおおよそ自由に扱えるようになった。Fizzbuzz のワンライナーくらいすぐ書けるだろうから、あとはなんとかなるだろう (試してないけど)。

-

ということでこれは別解ということにしておく。

-

ちなみに、PHP 8.2 からは、この記法で Warning が出るようになるようだ。

-
${
-'_
-'}
-

最新版で警告が出るというのも美しくないので、私としては本編の解法を推す。

- -
-
- - - - - - diff --git a/docs/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1/index.html b/docs/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1/index.html deleted file mode 100644 index b785a95..0000000 --- a/docs/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1/index.html +++ /dev/null @@ -1,132 +0,0 @@ - - - - - - - - PHPerKaigi 2023: ボツになったトークン問題 その 1 | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- - -
-
-

PHPerKaigi 2023: ボツになったトークン問題 その 1

- -
-
-
-

更新履歴

-
    -
  • 2022-10-23: 公開
    • -
-
-

はじめに

-

2023 年 3 月 23 日から 25 日にかけて開催予定 (記事執筆時点) の、PHPerKaigi 2023 において、昨年と同様に、弊社デジタルサーカス株式会社 から、トークン問題を出題予定である。

-

昨年のトークン問題の記事はこちら: PHPerKaigi 2022 トークン問題の解説

-

すでに 2023 年用の問題は作成済みであるが、その制作過程の中でいくつかボツ問ができた。せっかくなので、PHPerKaigi 開催を待つ間に紹介しようと思う。

-

10 月から 2 月まで、毎月 1 記事ずつ公開していく予定 (忘れていなければ)。

-

問題

-

注意: これはボツ問なので、得られたトークンを PHPerKaigi で入力してもポイントにはならない。

-
<?php
-
-$π = $argv[1] ?? null;
-if ($π === null) {
-  exit('No input.');
-}
-$π = trim($π);
-if (!is_numeric($π)) {
-  exit('Invalid input.');
-}
-
-$s = implode(array_map(chr(...), str_split($π, 2)));
-
-preg_match('/(\x23.+?) /', $s, $m);
-$t = $m[1] ?? '';
-
-if (md5($t) === '056e831a4146bf123e8ea16613303d2e') {
-  echo "Token: {$t}\n";
-} else {
-  echo "Failed.\n";
-}
-

トークン入手方法

-

ソースを見るとわかるとおり、$argv[1] を参照している。それを $π なる変数に代入しているので、円周率を渡してみる。

-
$ php Q.php 3.14
-Failed.
-

失敗してしまった。精度を上げてみる。

-
$ php Q.php 3.1415
-Failed.
-

だめだった。これを成功するまで繰り返す。

-

最初にトークンが得られるのは、小数点以下 16 桁目まで入力したときで、こうなる。

-
$ php Q.php 3.1415926535897932
-Token: #YO
-

めでたくトークン「#YO」が手に入った。

-

解説

-

短いので頭から追っていく。

-
$π = $argv[1] ?? null;
-if ($π === null) {
-  exit('No input.');
-}
-$π = trim($π);
-if (!is_numeric($π)) {
-  exit('Invalid input.');
-}
-

入力のバリデーション部分。数値のみ受け付ける。

-
$s = implode(array_map(chr(...), str_split($π, 2)));
-

$π を 2 文字ごとに区切り (str_split)、数値を ASCII コードと見做して文字に変換 (chr) して結合 (implode) している。

-

例えば、$π が '656667' だったとすると、65、66、67 に対応した 'A'、'B'、'C' へと変換され、'ABC' になる。

-
$π = '656667';
-$s = implode(array_map(chr(...), str_split($π, 2)));
-echo $s;
-// => ABC
-
preg_match('/(\x23.+?) /', $s, $m);
-$t = $m[1] ?? '';
-

正規表現でマッチングしている。\x23 は # と同じであることに留意すると、この正規表現は「# から始まる 2 以上の長さ (含 #) の文字列で、最初に現れるスペースまで」にマッチする。つまりこれは、PHPerKaigi におけるトークンである。

-

なお、# を直接書いていないのは、/#.+?) / と書くと、#.+?) という意図せぬトークンが登録されてしまうからである。

-
if (md5($t) === '056e831a4146bf123e8ea16613303d2e') {
-  echo "Token: {$t}\n";
-} else {
-  echo "Failed.\n";
-}
-

最後にトークンのハッシュ値を見て、想定解かどうかを確認する。

-

おわりに

-

円周率を何桁も計算して ASCII コード経由で文字列化すれば、トークンっぽいものがどこかで出てくるのではないか、と考えて生まれた作品。

-

最初は真面目に円周率の計算プログラムを組んでいたのだが、いざ動かしてみるとやけに浅いところにあったので驚いた (ちなみに、それでも M_PI や pi() では精度が足りない)。見つけたときは狂喜したものの、冷静になってみると大して面白くなかったのでボツになった。むしろ、100 万桁目くらいに埋まっていてくれたほうがよかったかもしれない。

- -
-
- - - - - - diff --git a/docs/posts/2022-10-28/setup-server-for-this-site/index.html b/docs/posts/2022-10-28/setup-server-for-this-site/index.html deleted file mode 100644 index e886a29..0000000 --- a/docs/posts/2022-10-28/setup-server-for-this-site/index.html +++ /dev/null @@ -1,163 +0,0 @@ - - - - - - - - [備忘録] このサイト用の VPS をセットアップしたときのメモ | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - -
- -
-
- - -
-
-

[備忘録] このサイト用の VPS をセットアップしたときのメモ

- -
-
-
-

更新履歴

-
    -
  • 2022-10-28: 公開
    • -
-
-

はじめに

-

これまでこの blog は GitHub Pages でホストしていたのだが、先日 VPS に移行した。そのときにおこなったサーバのセットアップ作業を書き残しておく。99 % 自分用の備忘録。別のベンダに移したりしたくなったら見に来る。

-

未来の自分へ: 特に自動化してないので、せいぜい苦しんでくれ。

-

VPS

-

さくらの VPS の 2 GB プラン。そこまで真面目に選定していないので、困ったら移動するかも。

-

事前準備

-

サーバのホスト名を決める

-

モチベーションが上がるという効能がある。今回は藤原定家から取って “teika” にした。たいていいつも源氏物語の帖か小倉百人一首の歌人から選んでいる。

-

SSH の鍵生成

-

ローカルマシンで鍵を生成する。

-
$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/teika.key
-$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/github2teika.key
-

teika.key はローカルからサーバへの接続用、github2teika.key は、GitHub Actions からサーバへのデプロイ用。

-

SSH の設定

-

.ssh/config に設定しておく。

-
Host teika
-    HostName **********
-    User **********
-    Port **********
-    IdentityFile ~/.ssh/teika.key
-

基本のセットアップ

-

SSH 接続

-

VPS 契約時に設定した管理者ユーザとパスワードを使ってログインする。

-

ユーザを作成する

-

管理者ユーザで作業すると危ないので、メインで使うユーザを作成する。sudo グループに追加して sudo できるようにし、su で切り替え。

-
$ sudo adduser **********
-$ sudo adduser ********** sudo
-$ su **********
-$ cd
-

ホスト名を変える

-
$ sudo hostname teika
-

公開鍵を置く

-
$ mkdir ~/.ssh
-$ chmod 700 ~/.ssh
-$ vi ~/.ssh/authorized_keys
-

authorized_keys には、ローカルで生成した ~/.ssh/teika.key.pub と ~/.ssh/github2teika.key.pub の内容をコピーする。

-

SSH の設定

-

SSH の設定を変更し、少しでも安全にしておく。

-
$ sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak
-$ sudo vi /etc/ssh/sshd_config
-
    -
  • Port を変更
    • -
  • PermitRootLogin を no に
    • -
  • PasswordAuthentication を no に
    • -
-

そして設定を反映。

-
$ sudo systemctl restart sshd
-$ sudo systemctl status sshd
-

SSH で接続確認

-

今の SSH セッションは閉じずに、ターミナルを別途開いて疎通確認する。セッションを閉じてしまうと、SSH の設定に不備があった場合に締め出しをくらう。

-
$ ssh teika
-

ポートの遮断

-

デフォルトの 22 番を閉じ、設定したポートだけ空ける。

-
$ sudo ufw deny ssh
-$ sudo ufw allow *******
-$ sudo ufw enable
-$ sudo ufw reload
-$ sudo ufw status
-

ここでもう一度 SSH の接続確認を挟む。

-

GitHub 用の SSH 鍵

-

GitHub に置いてある private リポジトリをサーバから clone したいので、SSH 鍵を生成して置いておく。

-
$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/github.key
-$ cat ~/.ssh/github.key.pub
-

GitHub の設定画面 から、この公開鍵を追加する。

-
$ vi ~/.ssh/config
-

設定はこう。

-
Host github.com
-    HostName github.com
-    User git
-    IdentityFile ~/.ssh/github.key
-

最後に接続できるか確認しておく。

-
ssh -T github.com
-

パッケージの更新

-
$ sudo apt update
-$ sudo apt upgrade
-$ sudo apt update
-$ sudo apt upgrade
-$ sudo apt autoremove
-

サイトホスティング用のセットアップ

-

DNS に IP アドレスを登録する

-

このサーバは固定の IP アドレスがあるので、A レコードに直接入れるだけで済んだ。

-

使うソフトウェアのインストール

-
$ sudo apt install docker docker-compose git make
-

メインユーザが Docker を使えるように

-
sudo adduser ********** docker
-

HTTP/HTTPS を通す

-

80 番と 443 番を空ける。

-
$ sudo ufw allow 80/tcp
-$ sudo ufw allow 443/tcp
-$ sudo ufw reload
-$ sudo ufw status
-

リポジトリのクローン

-
$ cd
-$ git clone git@github.com:nsfisis/nsfisis.dev.git
-$ cd nsfisis.dev
-$ git submodule update --init
-

certbot で証明書取得

-
$ docker-compose up -d acme-challenge
-$ make setup
-

サーバを稼動させる

-
$ make serve
-

感想

-

(業務でなく) 個人だと数年ぶりのサーバセットアップで、これだけでも割と時間を食ってしまった。とはいえ式年遷宮は楽しいので、これからも定期的にやっていきたい。コンテナデプロイにしたい気持ちもあるのだが、色々実験したい関係上、本物のサーバも欲しくはある。次の式年遷宮では、手順の一部だけでも自動化したいところ。

- -
-
- - - - - - diff --git a/docs/posts/feed.xml b/docs/posts/feed.xml deleted file mode 100644 index ab1cbfc..0000000 --- a/docs/posts/feed.xml +++ /dev/null @@ -1,2348 +0,0 @@ - - - - Posts on REPL: Rest-Eat-Program Loop - https://blog.nsfisis.dev/posts/ - Recent content in Posts on REPL: Rest-Eat-Program Loop - Hugo -- gohugo.io - ja-JP - Fri, 28 Oct 2022 21:55:23 +0900 - - [備忘録] このサイト用の VPS をセットアップしたときのメモ - https://blog.nsfisis.dev/posts/2022-10-28/setup-server-for-this-site/ - Fri, 28 Oct 2022 21:55:23 +0900 - - https://blog.nsfisis.dev/posts/2022-10-28/setup-server-for-this-site/ - はじめに -

これまでこの blog は GitHub Pages でホストしていたのだが、先日 VPS に移行した。そのときにおこなったサーバのセットアップ作業を書き残しておく。99 % 自分用の備忘録。別のベンダに移したりしたくなったら見に来る。

-

未来の自分へ: 特に自動化してないので、せいぜい苦しんでくれ。

-

VPS

-

さくらの VPS の 2 GB プラン。そこまで真面目に選定していないので、困ったら移動するかも。

-

事前準備

-

サーバのホスト名を決める

-

モチベーションが上がるという効能がある。今回は藤原定家から取って “teika” にした。たいていいつも源氏物語の帖か小倉百人一首の歌人から選んでいる。

-

SSH の鍵生成

-

ローカルマシンで鍵を生成する。

-
$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/teika.key
-$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/github2teika.key
-

teika.key はローカルからサーバへの接続用、github2teika.key は、GitHub Actions からサーバへのデプロイ用。

-

SSH の設定

-

.ssh/config に設定しておく。

-
Host teika
-    HostName **********
-    User **********
-    Port **********
-    IdentityFile ~/.ssh/teika.key
-

基本のセットアップ

-

SSH 接続

-

VPS 契約時に設定した管理者ユーザとパスワードを使ってログインする。

-

ユーザを作成する

-

管理者ユーザで作業すると危ないので、メインで使うユーザを作成する。sudo グループに追加して sudo できるようにし、su で切り替え。

-
$ sudo adduser **********
-$ sudo adduser ********** sudo
-$ su **********
-$ cd
-

ホスト名を変える

-
$ sudo hostname teika
-

公開鍵を置く

-
$ mkdir ~/.ssh
-$ chmod 700 ~/.ssh
-$ vi ~/.ssh/authorized_keys
-

authorized_keys には、ローカルで生成した ~/.ssh/teika.key.pub と ~/.ssh/github2teika.key.pub の内容をコピーする。

-

SSH の設定

-

SSH の設定を変更し、少しでも安全にしておく。

-
$ sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak
-$ sudo vi /etc/ssh/sshd_config
-
    -
  • Port を変更
    • -
  • PermitRootLogin を no に
    • -
  • PasswordAuthentication を no に
    • -
-

そして設定を反映。

-
$ sudo systemctl restart sshd
-$ sudo systemctl status sshd
-

SSH で接続確認

-

今の SSH セッションは閉じずに、ターミナルを別途開いて疎通確認する。セッションを閉じてしまうと、SSH の設定に不備があった場合に締め出しをくらう。

-
$ ssh teika
-

ポートの遮断

-

デフォルトの 22 番を閉じ、設定したポートだけ空ける。

-
$ sudo ufw deny ssh
-$ sudo ufw allow *******
-$ sudo ufw enable
-$ sudo ufw reload
-$ sudo ufw status
-

ここでもう一度 SSH の接続確認を挟む。

-

GitHub 用の SSH 鍵

-

GitHub に置いてある private リポジトリをサーバから clone したいので、SSH 鍵を生成して置いておく。

-
$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/github.key
-$ cat ~/.ssh/github.key.pub
-

GitHub の設定画面 から、この公開鍵を追加する。

-
$ vi ~/.ssh/config
-

設定はこう。

-
Host github.com
-    HostName github.com
-    User git
-    IdentityFile ~/.ssh/github.key
-

最後に接続できるか確認しておく。

-
ssh -T github.com
-

パッケージの更新

-
$ sudo apt update
-$ sudo apt upgrade
-$ sudo apt update
-$ sudo apt upgrade
-$ sudo apt autoremove
-

サイトホスティング用のセットアップ

-

DNS に IP アドレスを登録する

-

このサーバは固定の IP アドレスがあるので、A レコードに直接入れるだけで済んだ。

-

使うソフトウェアのインストール

-
$ sudo apt install docker docker-compose git make
-

メインユーザが Docker を使えるように

-
sudo adduser ********** docker
-

HTTP/HTTPS を通す

-

80 番と 443 番を空ける。

-
$ sudo ufw allow 80/tcp
-$ sudo ufw allow 443/tcp
-$ sudo ufw reload
-$ sudo ufw status
-

リポジトリのクローン

-
$ cd
-$ git clone git@github.com:nsfisis/nsfisis.dev.git
-$ cd nsfisis.dev
-$ git submodule update --init
-

certbot で証明書取得

-
$ docker-compose up -d acme-challenge
-$ make setup
-

サーバを稼動させる

-
$ make serve
-

感想

-

(業務でなく) 個人だと数年ぶりのサーバセットアップで、これだけでも割と時間を食ってしまった。とはいえ式年遷宮は楽しいので、これからも定期的にやっていきたい。コンテナデプロイにしたい気持ちもあるのだが、色々実験したい関係上、本物のサーバも欲しくはある。次の式年遷宮では、手順の一部だけでも自動化したいところ。

-]]> - - - - PHPerKaigi 2023: ボツになったトークン問題 その 1 - https://blog.nsfisis.dev/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1/ - Sun, 23 Oct 2022 09:54:07 +0900 - - https://blog.nsfisis.dev/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1/ - はじめに -

2023 年 3 月 23 日から 25 日にかけて開催予定 (記事執筆時点) の、PHPerKaigi 2023 において、昨年と同様に、弊社デジタルサーカス株式会社 から、トークン問題を出題予定である。

-

昨年のトークン問題の記事はこちら: PHPerKaigi 2022 トークン問題の解説

-

すでに 2023 年用の問題は作成済みであるが、その制作過程の中でいくつかボツ問ができた。せっかくなので、PHPerKaigi 開催を待つ間に紹介しようと思う。

-

10 月から 2 月まで、毎月 1 記事ずつ公開していく予定 (忘れていなければ)。

-

問題

-

注意: これはボツ問なので、得られたトークンを PHPerKaigi で入力してもポイントにはならない。

-
<?php
-
-$π = $argv[1] ?? null;
-if ($π === null) {
-  exit('No input.');
-}
-$π = trim($π);
-if (!is_numeric($π)) {
-  exit('Invalid input.');
-}
-
-$s = implode(array_map(chr(...), str_split($π, 2)));
-
-preg_match('/(\x23.+?) /', $s, $m);
-$t = $m[1] ?? '';
-
-if (md5($t) === '056e831a4146bf123e8ea16613303d2e') {
-  echo "Token: {$t}\n";
-} else {
-  echo "Failed.\n";
-}
-

トークン入手方法

-

ソースを見るとわかるとおり、$argv[1] を参照している。それを $π なる変数に代入しているので、円周率を渡してみる。

-
$ php Q.php 3.14
-Failed.
-

失敗してしまった。精度を上げてみる。

-
$ php Q.php 3.1415
-Failed.
-

だめだった。これを成功するまで繰り返す。

-

最初にトークンが得られるのは、小数点以下 16 桁目まで入力したときで、こうなる。

-
$ php Q.php 3.1415926535897932
-Token: #YO
-

めでたくトークン「#YO」が手に入った。

-

解説

-

短いので頭から追っていく。

-
$π = $argv[1] ?? null;
-if ($π === null) {
-  exit('No input.');
-}
-$π = trim($π);
-if (!is_numeric($π)) {
-  exit('Invalid input.');
-}
-

入力のバリデーション部分。数値のみ受け付ける。

-
$s = implode(array_map(chr(...), str_split($π, 2)));
-

$π を 2 文字ごとに区切り (str_split)、数値を ASCII コードと見做して文字に変換 (chr) して結合 (implode) している。

-

例えば、$π が '656667' だったとすると、65、66、67 に対応した 'A'、'B'、'C' へと変換され、'ABC' になる。

-
$π = '656667';
-$s = implode(array_map(chr(...), str_split($π, 2)));
-echo $s;
-// => ABC
-
preg_match('/(\x23.+?) /', $s, $m);
-$t = $m[1] ?? '';
-

正規表現でマッチングしている。\x23 は # と同じであることに留意すると、この正規表現は「# から始まる 2 以上の長さ (含 #) の文字列で、最初に現れるスペースまで」にマッチする。つまりこれは、PHPerKaigi におけるトークンである。

-

なお、# を直接書いていないのは、/#.+?) / と書くと、#.+?) という意図せぬトークンが登録されてしまうからである。

-
if (md5($t) === '056e831a4146bf123e8ea16613303d2e') {
-  echo "Token: {$t}\n";
-} else {
-  echo "Failed.\n";
-}
-

最後にトークンのハッシュ値を見て、想定解かどうかを確認する。

-

おわりに

-

円周率を何桁も計算して ASCII コード経由で文字列化すれば、トークンっぽいものがどこかで出てくるのではないか、と考えて生まれた作品。

-

最初は真面目に円周率の計算プログラムを組んでいたのだが、いざ動かしてみるとやけに浅いところにあったので驚いた (ちなみに、それでも M_PI や pi() では精度が足りない)。見つけたときは狂喜したものの、冷静になってみると大して面白くなかったのでボツになった。むしろ、100 万桁目くらいに埋まっていてくれたほうがよかったかもしれない。

-]]> - - - - [PHP] fizzbuzz を書く。1行あたり2文字で。 - https://blog.nsfisis.dev/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line/ - Thu, 29 Sep 2022 00:50:52 +0900 - - https://blog.nsfisis.dev/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line/ - 記事の構成について -

この記事は、普通の fizzbuzz を徐々に変形して最終形にしていく、という構成で書かれている。最終形を見てどのような仕組みで動いているのか解読してから解説を読みたい、というかたがいれば、 このページ にソースコードがあるので、そちらを先に見てほしい。

-

レギュレーション

-

PHP で、次のような制約の下に fizzbuzz を書いた。

-
    -
  • 1行あたりの文字数は2文字までに収めること (ただし <?php タグは除く) -
      -
    • 厳密な定義: <?php タグ以降のソースコードが、2 byte ごとに ラインフィード (LF) で区切られること
      • -
    -
    • -
  • スペースやタブを使用しないこと
    • -
  • ループのアンロールをしないこと -
      -
    • 100 回ループの代わりに 100 回コードをコピペ、というのは禁止
      • -
    -
    • -
  • PHP 7.4〜8.1 で動作すること
    • -
  • 実行時に Notice や Warning が出ないこと
    • -
  • 標準的なインストール構成の PHP で実現できること (デフォルトで有効になっていない拡張等を使わないこと)
    • -
-

備考: PHP には short_open_tag というオプションがあり、これを有効にするとファイル冒頭の <?php の代わりに <? を使うことができ、文字どおり1行2文字で書ける。ただ、このオプションはデフォルト off になっている環境が多いようなので、今回は使わないことにした。

-

主な障害

-

1行あたりの文字数など、適当に改行を挟めばいいだけではないのか？

-

特に、C言語でこのような試みをおこなったことがあるかたならそう思うだろう。事実、Cでのこの制約はほとんど無意味に等しい。

-
#\
-i\
-n\
-c\
-l\
-u\
-d\
-e\
-<\
-s\
-t\
-d\
-i\
-o\
-.\
-h\
->\
-/*
-*/
-i\
-n\
-t\
-/*
-*/
-m\
-a\
-i\
-n(
-){
-f\
-o\
-r(
-i\
-n\
-t\
-/*
-*/
-i=
-1;
-i<
-1\
-0\
-0;
-i\
-+\
-+)
-if
-(i
-%\
-15
-==
-0)
-p\
-r\
-i\
-n\
-t\
-f(
-"\
-F\
-i\
-z\
-z\
-B\
-u\
-z\
-z\
-%\
-c\
-",
-10
-);
-
-/* あとは同じように普通のプログラムを変形するだけなので省略 */
-

バックスラッシュを使った行継続がトークンを区切らない、というのがポイントだ。

-

さて、PHP ではそもそもバックスラッシュを行継続に使うことができない。これにより、「3文字以上からなるトークンが一切使えない」という制約が課される。例えば、echo で出力することや、for でループすること、new でインスタンスを生成することができない。特に、出力は fizzbuzz をどんなアルゴリズムで実装しようとおこなわなければならないので、できないのは致命的である。

-

当然、名前が3文字以上ある関数も使えない。なお、標準 PHP の範囲内において、名前が 2文字以下の関数は以下のとおりである:

-
    -
  • _: gettext のエイリアス
    • -
  • dl: 拡張モジュールをロードする
    • -
  • pi: 円周率を返す
    • -
-

(環境によって多少は変わるかも)

-

2文字の関数を定義しまくった拡張モジュールを用意しておいて dl() で読み込む行為は、レギュレーションで定めた

-
-
    -
  • 標準的なインストール構成の PHP で実現できること (デフォルトで有効になっていない拡張等を使わないこと)
    • -
-
-

に反する (というより、「それだとおもしろくもなんともないので、このルールを足した」というのが正しい)。

-

また、2文字だと文字列がまともに書けないのも辛い。'' だけで 2文字使うので、「1文字の文字列リテラル」というものを書くことができない。PHP では文字列リテラル中に生の改行が書けるので

-
$a
-='
-a'
-;;
-

とすると $a は "\na" になるのだが、余計な改行が入ってしまう。

-

これらの障害をどのように乗り越えるのか、次節から見ていく。

-

解説

-

普通の (?) fizzbuzz

-

まずは普通に書くとしよう。

-
<?php
-
-for ($i = 1; $i < 100; $i++) {
-  echo (($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n";
-}
-

素直に書いた fizzbuzz とは言い難いが、このくらいは普通だということにしておかないと、この先がやっていられないので許してほしい。

-

for の排除

-

for は、3文字もある長いキーワードである。こんなものは使えない。array_ 系の関数を使って、適当に置き換えるとしよう。

-
<?php
-
-$s = range(1, 100);
-array_walk(
-  $s,
-  fn($i) =>
-    printf((($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n"),
-);
-

array_walk や range、printf といった for よりも長いトークンが現れてしまったが、これは次節で直すことにする。なお、echo は文 (statement) であり式 (expression) ではないので、式である printf に置き換えた。

-

関数呼び出しの短縮

-

range、array_walk、printf は長すぎるのでどうにかせねばならない。ここで、PHP の可変関数を使う。可変関数とは、関数名が文字列として入った変数を経由して、関数を呼び出す機能である。

-
<?php
-
-$r = 'range';
-$w = 'array_walk';
-$p = 'printf';
-
-$s = $r(1, 100);
-$w(
-  $s,
-  fn($i) =>
-    $p((($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n"),
-);
-

これで関数を呼び出している所は短くなった。では、$r や $w や $p、また 'Fizz' や 'Buzz' はどうやって 1行2文字に収めるのか。次のテクニックへ移ろう。

-

余談: PHP 8.x で動作しなくてもいいなら

-

今回使ったテクニックを説明する前に、余談として、文字列リテラルの短縮法として今回採用しなかったものを紹介する。

-
-
    -
  • PHP 7.4〜8.1 で動作すること
    • -
-
-

というルールがない場合、「未定義の定数が評価された場合、その定数の名前が値になる」という PHP 7.x までの仕様が利用できる。例えば、 Fizz という文字列が欲しければ、次のようにする。

-
$f
-=F
-.i
-.z
-.z
-;;
-

こうして簡単に文字列を作れる。なお、この仕様は 7.x 時点でも警告を受けるので、@ 演算子を使って抑制してやるとよい。

-
$f
-=@
-F.
-@i
-.#
-@z
-.#
-@z
-;;
-

むしろ、このことがわかっていたからこそ PHP 8.x での動作を要件に課したところがある。

-

文字列リテラルの短縮

-

実際に使った手法の説明に移る。

-

ずばり、文字列同士のビット演算を使う。PHP では、文字列同士でビット演算 (&、|、^) をした場合、文字列の各バイトごとに指定したビット演算がなされ、それを結合したものが演算結果となる。

-
$a = "12345";
-$b = "world";
-
-// $a ^ $b は次のコードと同じ
-$result = '';
-for ($i = 0; $i < min(strlen($a), strlen($b)); $i++) {
-  $result .= $a[$i] ^ $b[$i];
-}
-
-echo $result;
-// => F]AXQ
-

これを踏まえ、次のコードを見てみよう。

-
$x = "x\nOm\n";
-$y = "\nk!\no";
-$r = $x ^ $y;
-echo "$r\n";
-

実行すると、range が表示される。さて、PHP では文字列リテラル中に生の改行を直接書いてもよいのだった (「主な障害」の節を参照のこと)。書きかえてみよう。

-
$x
-='x
-Om
-';
-$y
-='
-k!
-o'
-;
-
-$r = $x ^ $y;
-echo "$r\n";
-

さらに # を使って適当に調整すると、次のようになる。

-
$x
-=#
-'x
-Om
-';
-$y
-='
-k!
-o'
-;#
-$r
-=#
-$x
-^#
-$y
-;#
-
-echo "$r\n";
-

1行あたり2文字で、range という文字列を生成することに成功した。他の必要な文字列にも、同様の処理をほどこす。

-

備考: Buzz 中にある小文字の u は、このロジックだと non-printable な文字になってしまう。ここまでのテクニックを駆使すれば回避するのはそう難しくないので、考えてみてほしい。

-

完成系

-

完成したものがこちら。

-
<?php
-
-$x
-=#
-'i
-S'
-;;
-$y
-='
-b!
-';
-$c
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'x
-Om
-';
-$y
-='
-k!
-o'
-;#
-$r
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'k
-Sk
-~}
-Ma
-';
-$y
-='
-x!
-s!
-k!
-';
-$w
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'z
-Hd
-G'
-;#
-$y
-='
-x!
-~!
-';
-$p
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'L
-[p
-';
-$y
-='
-c!
-';
-$f
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'H
-[p
-';
-$y
-='
-_!
-';
-$b
-=#
-$x
-^#
-$y
-;#
-$b
-[1
-]=
-$c
-(#
-13
-*9
-);
-$s
-=#
-$r
-(1
-,(
-10
-**
-2)
-);
-$w
-(#
-$s
-,#
-fn
-(#
-$i
-)#
-=>
-$p
-((
-(#
-$i
-%3
-?#
-''
-:#
-$f
-).
-(#
-$i
-%5
-?#
-''
-:#
-$b
-)?
-:#
-$i
-)#
-.'
-')
-);
-

感想など

-

PHP は、スクリプト言語の中だとシンタックスシュガーが少ない (体感)。この挑戦は不可能に思われたが、PHP マニュアルとにらめっこしていたらなんとかなった。

-

みんなもプログラムを細長くしよう。

-

余談2: 別解

-

PHP では、バッククォートを使ってシェルを呼び出せる。これは shell_exec 関数と等価である。さて、PHP ではバックスラッシュによる行継続が使えないと書いたが、シェルでは使える (当然だが、呼び出されるシェルに依存する。Bash なら大丈夫だろう。知らんけど)。

-
<?php
-
-printf(`
-e\
-c\
-h\
-o\
- \
-1\
-2\
-3\
-`);
-

なお、ここでは簡単のため出力に printf をそのまま使っているが、実際には printf という文字列を合成して可変関数で呼び出す。

-

ただし、これでは

-
-
    -
  • スペースやタブを使用しないこと
    • -
-
-

に違反してしまう。スペースが使えないと引数とコマンドを区切れない。これは困った。

-

もうこれ以上は不可能だと思っていたのだが、この記事の執筆中に解決する方法を思いついたので載せておく。

-
<?php
-
-$c = 'chr';
-
-${
-'_
-'}
-=#
-$c
-(#
-32
-).
-$c
-(#
-92
-);
-
-printf(`
-e\
-c\
-h\
-o\
-${
-'_
-'}
-1\
-2\
-3\
-`);
-

先程と同じく、chr や printf を生成する部分は長くなるので省いた。

-
${
-'_
-'}
-

は変数で、中にはスペースとエスケープが入っている (chr(32) . chr(92))。シェルに渡されている文字列は次のようになる。

-
e\
-c\
-h\
-o\
- \
-1\
-2\
-3\
-

これは、前掲したコマンドと同じだ。かくして、スペースを陽に書かずにシェルをおおよそ自由に扱えるようになった。Fizzbuzz のワンライナーくらいすぐ書けるだろうから、あとはなんとかなるだろう (試してないけど)。

-

ということでこれは別解ということにしておく。

-

ちなみに、PHP 8.2 からは、この記法で Warning が出るようになるようだ。

-
${
-'_
-'}
-

最新版で警告が出るというのも美しくないので、私としては本編の解法を推す。

-]]> - - - - 弊社の PHP Foundation への寄付に寄せて - https://blog.nsfisis.dev/posts/2022-08-31/support-for-communty-is-employee-benefits/ - Wed, 31 Aug 2022 22:25:02 +0900 - - https://blog.nsfisis.dev/posts/2022-08-31/support-for-communty-is-employee-benefits/ - はじめに -

注: これは私個人の意見であり、所属する組織を代表するものではありません。

-

先日、私の勤める デジタルサーカス株式会社 が PHP Foundation へ $2,000 の寄付をおこないました。

-

記事: https://www.dgcircus.com/news/581

-

本件を社内でしつこく推進した1人として、推進の理由等を書き残しておきます。

-

なぜ？

-

組織としての寄付理由は前掲した記事に譲るとして、ここでは、私が社内でこの件を推進した理由について書くことにします。

-

当時の考えを端的にまとめた社内チャットの投稿があったので、それを引用します:

-
-

結局これを通したい (私の中での) 最大の理由が、「自分の勤める会社が、これをやる会社であってほしい」というのがあり、↑にしても、感情ベースの理由しか出せていないというのが説得力に欠けている理由なのだと思いますが、寄付の報告が流れてきたり、OSS のフリーライドの話が流れてきたりするたびに、自尊心が毀損される、というか (これは大袈裟すぎる表現で、実際にはそこまで明確に傷ついているわけではありませんが)。

-

追記: 「肩身が狭くなる」というのがより適切でした。

-
-

※文中の「↑にしても」は、ここに載せていない別の投稿を指しています。

-

OSS を金銭的に支援したり、技術カンファレンスへ協賛したり (あるいは CTO がカンファレンスを年2で主催したり: iOSDC PHPerKaigi) といった行為は、コミュニティへの貢献であると同時に、社員に対する精神的福利厚生でもあると言えるでしょう (知らんけど)。これらは、技術や技術者を大切にする組織である、ということの、対外的にも対内的にも強力なメッセージなのです。

-

以上が、私が社内で寄付の件を進めた (かなり私的な) 理由です。

-

おわりに

-

最終的に社としての寄付まで漕ぎ着けられたのは、もちろん私の力ではなく役員の方々の決定によるものです。この場を借りて感謝申し上げます。

-]]> - - - - PHP カンファレンス沖縄で出題されたコードゴルフの問題を解いてみた - https://blog.nsfisis.dev/posts/2022-08-27/php-conference-okinawa-code-golf/ - Sat, 27 Aug 2022 18:55:28 +0900 - - https://blog.nsfisis.dev/posts/2022-08-27/php-conference-okinawa-code-golf/ - はじめに -

本日 PHP カンファレンス沖縄 2022 が開催された (らしい)。

-

カンファレンスには参加できなかったものの、懇親会の LT で出題されたコードゴルフの問題が Twitter に流れてきたので、解いてみた。

-

ツイート: https://twitter.com/m3m0r7/status/1563397620231712772
-スライド: https://speakerdeck.com/memory1994/php-conference-okinawa-2022-extra?slide=3

-

解

-

細かいレギュレーションは不明だったので、勝手に定めた。

-
    -
  • コマンドライン引数の第1引数で受けとる
    • -
  • 結果は標準出力に出す
    • -
  • コンマの直後にはスペースを1つ置く
    • -
  • 末尾コンマは禁止
    • -
  • 数字でないものは入ってこないものとする
    • -
  • 負数は入ってこないものとする
    • -
-

書いたものがこちら:

-
[<?php $n=$argv[1];foreach([1e4,5e3,2e3,1e3,500,100,50,10,5,1]as$x)for(;$n>=$x;$n-=$x)$r[]=$x;echo implode(', ',$r??[]);?>]
-

しめて 123 バイトとなった (末尾改行を含めずにカウント)。

-

こちらは改行とスペースを追加したバージョン:

-
[<?php
-
-$n = $argv[1];
-foreach ([1e4, 5e3, 2e3, 1e3, 500, 100, 50, 10, 5, 1] as $x)
-  for (; $n >= $x; $n -= $x)
-    $r[] = $x;
-echo implode(', ', $r ?? []);
-
-?>]
-

使用したテクニック

-

指数表記

-

割と多くの言語のゴルフで使えるテクニック。e を用いた指数表記で、大きな数を短く表す。このコードでは 10000、5000、2000、1000 を指数表記している。

-

foreach や for の中身を1つの文に

-

foreach、for、if などの後ろには、通常 { を続けて複数の文を連ねるが、中身の文を1つにしてしまえば、{ と } を省略できる。C言語などでも使える。

-

$r に初期値を入れない

-

PHP では、$r[] = ... のような配列の末尾に追加する式を実行したとき、$r が未定義だった場合は $r を勝手に定義して空の配列で初期化してくれる。これを利用すると、$r = []; のような初期化が不要になる。

-

ただし、プログラムに 0 が渡されるとループを一度も回らないので、$r が未定義になってしまい、implode() に渡すところでエラーになる。それを防ぐために $r ?? [] を使っている。

-

もし 0 が渡されたケースを無視するなら、これが不要になるので 4 バイト縮む。

-

PHP タグの外に文字列を置く

-

PHP では、<?php ?> で囲われた部分の外側にある文字列は、そのまま出力される。今回のケースでは、先頭と末尾に必ず [ と ] を出力するので、そのまま書いてやればよい。

-

おわりに

-

最後になりましたが、めもりー さん、楽しい問題をありがとうございました。

-]]> - - - - PHPerKaigi 2022 - https://blog.nsfisis.dev/posts/2022-05-01/phperkaigi-2022/ - Sun, 01 May 2022 09:41:39 +0900 - - https://blog.nsfisis.dev/posts/2022-05-01/phperkaigi-2022/ - はじめに -

2022-04-09 から 2022-04-11 にかけて開催された、PHPerKaigi 2022 に、一般参加者として参加した。 -弊社デジタルサーカス株式会社 はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。

-

昨年のレポートはこちら。

-

感想

-

厳選おすすめトーク

-

多くの素晴らしいトークの中から、特におすすめのものを 5つ選んだ。是非聞いてほしい。引用部分は、リンク先プロポーザルから引用している。

-

予防に勝る防御なし - 堅牢なコードを導く様々な設計のヒント

-
-

PHP はバージョンを追う毎に型宣言、例外、表明、列挙型などの機能が大幅に強化され、堅牢なコードを書くための機能が充実してきました。それらの機能はどう使うと効果的なのでしょうか。

-

本講演では PHP 8.1 をベースにして、誤りを想定してチェックするのではなく、そもそも誤りにくい設計とはどのようなものか、つまり「予防」の観点を軸足に、堅牢なコードを導くための様々な設計のヒントをご紹介します。

-
-

PHPのエラーを理解して適切なエラーハンドリングを学ぼう

-
-

PHPを使ってるとよく遭遇する Fatal error / Parse error / Warning / Notice 理解していますか？
-これらのエラー文を理解することで、すぐにエラーの原因に気付き適切に対象できる様になります！
-またそれらを理解した上でのエラーハンドリングを学びましょう。

-
-

エラー監視とテスト体制への改善作戦

-
-

毎日流れてくるエラーに皆さんはどう向き合ってますか？
-エラーを出さない事が一番ですが、完全に塞ぐ事は難しいと考えます。
-サービス運用の中で本番環境から発生するエラー（サーバー・クライアントサイド・サードパーティ起因のエラー）への監視体制と、
-エラー・バグ防御のためチームで行っているテストコード文化づくりの話をします。

-
-

ISUCON11のPHP実装は、何を考え、どのようにして作られていたのか

-
-

昨年開催されたISUCON11にて問題（参考実装）のPHPへの移植を担当させていただきました。

-

最終的なソースコードこそシンプルなWebアプリケーションではありますが、その裏には
-・「（私の思う）良い設計」を実現するための意思決定
-・「ISUCONの問題」という位置付けに由来する取捨選択
-・移植中に遭遇したトラブルとその解決策
-といった文脈や葛藤が存在しています。

-

本発表はそれらを共有することで
-・PHPアプリケーションの設計、実装事例として役立ててもらう
-・ISUCONの言語移植に興味を持ってもらう
-・ISUCON問題移植の「実装や設計の練習をする教材」としての可能性を知ってもらう
-ことを目的とします。

-
-

チームの仕事はまわっていたけど、メンバーはそれぞれモヤモヤを抱えていた話──40名の大規模開発チームで1on1ログを公開してみた

-
-

サイボウズの大企業向けグループウェアのGaroon（ガルーン）は、PHPで開発されている20年目の製品です。ガルーン開発チームは日本で40名、ベトナムで50名の計90名ほどのチームになっています。また、コロナ禍でフルリモートでの活動がこの2年ほど継続してきました。

-

フルリモートになっても仕事はまわっており、継続的にリリースはしていましたが、一方でお互いの考えていることや感じている問題意識が見えづらくなり、モヤモヤを抱えているメンバーが増えていました。

-

このセッションでは、そういう状況で私がチーム外からジョインし、聴き役に徹しながら見える化することで状況を改善していった取り組みを紹介します。同じように大きなチームやリモートワークで難しさを感じている人に、難しさの原因への気づきや取り組みへのヒントがあれば幸いです。

-
-

トークン問題の作成

-

今回は、PHPer チャレンジ用に弊社のトークン問題を 3題作成した。こちらについては別途記事にしているので、そちらを参照されたい。

-

PHPer チャレンジ

-

1位になった。
-また、賞品として Echo Show 15 をいただいた。

-

カンファレンス全体への感想

-

去年の参加レポ では、こんなことを書いた。

-
-

1つ個人的な反省点としては、(中略) Discord しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。
-まあ初カンファレンスだし、とお茶を濁しておこう。

-
-

この反省を踏まえ、今年は積極的にほかの場 (公式の Discord サーバや、アンカンファレンス) にも参加した。
-これにより、参加体験の質がはるかに向上した。特に Discord に関しては、登壇者ご本人による補足や、質問への回答などがおこなわれる (ことが多い) ため、特別な理由のない限り、発言はしないまでも参加はしておいたほうが良いと思われる。

-

なお、アンカンファレンスについては、1日目の終わりにトークン問題の解説放送もおこなった。

-

また、今年はオフラインとオンラインのハイブリッド開催であったが、去年の全オンラインと比べて、オンライン参加の体験が落ちていなかったのは、特筆すべきであろう。 -今年は 3回目のワクチン接種が間に合わなかったこともあり現地参加は見送ったのだが、来年は是非オフラインで参加したい。

-

そして来年へ……?

-

PHPerKaigi 2023 があるかどうか存じ上げないが、あるとすれば、次の 4つを目標としたい。

-
    -
  • プロポーザルを出す
    • -
  • PHPer チャレンジのトークン問題を 5題作成する
    • -
  • 現地に行く
    • -
  • PHPer チャレンジで圧勝する
    • -
-
-

最後になりましたが、PHPerKaigi のスタッフ、スポンサー、スピーカーのみなさん、素敵な時間をありがとうございました。

-

ではまた来年。

-]]> - - - - term-banner: ターミナルにバナーを表示するツールを書いた - https://blog.nsfisis.dev/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal/ - Sun, 24 Apr 2022 13:22:52 +0900 - - https://blog.nsfisis.dev/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal/ - はじめに -

こんなものを作った。

-
$ term-banner 'Hello, World!' 'こんにちは、' '世界！'
-

term-banner のスクリーンショット

-

コマンドライン引数として渡した文字列をターミナルに大きく表示する。

-

リポジトリはこちら: https://github.com/nsfisis/term-banner

-

Motivation

-

以前、big-clock-mode という似たようなプログラムを書いた。 -これは tmux の :clock-mode コマンドに着想を得たもので、:clock-mode よりも大きく現在時刻を表示する。

-

big-clock-mode を開発したのは、次のようなシチュエーションで使うためである。 -弊社では現在リモートワークが基本だが、web 会議などで画面共有しているときに、休憩を挟んで特定の時刻から再開する、ということがある。 -こういったケースで、画面上に現在の時刻を大きめに表示しておくと、モニタから離れても遠くから時刻がわかるので便利である。

-

それこそタイマアプリか何かを使えばいいのだが、ターミナルに棲むいきものとしては、住処から離れたくないわけだ。

-

しばらく便利に使っていたのだが、ひとつ不満点が出てきた。それは、再開する時刻がいつだったかを覚えておかなければならないということだ。 -どこかにメモしておいてもいいが、せっかくなら現在時刻とともに表示させておきたい。

-

そんなわけで、「任意の文字列をターミナルに表示する」プログラムを書く運びとなった。 -まあ、作らなくても探せばあると思うが、作りたいものは作りたいので知ったことではない。

-

プログラム

-

全体の流れは次のようになっている。

-
    -
  1. フォントファイルを読み込む
    2. -
  2. コマンドライン引数を Shift-JIS に変換する (フォントが Shift-JIS 基準で並んでいるため)
    3. -
  3. 1文字ずつレンダリングしていく
    4. -
-

big-clock-mode が Go 製なので、今回も Go で書いた。 -PNG が標準ライブラリにあったり、Shift-JIS のエンコーディングが準標準ライブラリにあったりしたのは助かった。

-

フォントファイルは go:embed で実行ファイルに埋め込んでいるので、ビルド後はワンバイナリで動く。 -仕事ではスクリプト言語ばかり書いているが、やはりコンパイル言語はいい。

-

フォント

-

フリーの 8x8 ビットマップフォントである、美咲フォント 2021-05-05a 版 を使わせていただいた。

-

はじめは自分でポチポチ打っていたのだが、「き」くらいまでやって挫折した。 -同じく 8x8 で作っていたのだが、平仮名でさえも、この小さなキャンバスにはとても収められない。

-

美咲フォントは、平仮名・片仮名に留まらず、JIS 第一・第二水準の漢字までサポートしている。 -第二水準ともなると一生お目にかかることのない字の方が多いくらいだが、これをこの大きさで書くというのは、もはや芸術の域である。

-

さらに言うと、実のところ美咲フォントは実サイズ 7x7 で作られており、余白が設けられている。 -これは、単純にそのまま並べても字間・行間を確保できるようにという配慮である。 -おかげでコーディングまで楽になった。

-

ゴシック体と明朝体があったが、私の好みで明朝体の方にした。 -ただ、ゴシック体の方が見やすい気がするので、フォントを選べるように後ほど拡張するかもしれない。

-

2022-04-27 追記: -f オプションで選べるようにした。

-

おわりに

-

あなたもターミナルに住んでみませんか？

-]]> - - - - PHPerKaigi 2022 トークン問題の解説 - https://blog.nsfisis.dev/posts/2022-04-09/phperkaigi-2022-tokens/ - Sat, 09 Apr 2022 21:50:19 +0900 - - https://blog.nsfisis.dev/posts/2022-04-09/phperkaigi-2022-tokens/ - はじめに -

本日開始された PHPerKaigi 2022 の PHPer チャレンジにおいて、弊社 デジタルサーカス株式会社 の問題を 3問作成した。この記事では、これらの問題の解説をおこなう。

-

リポジトリはこちら: https://github.com/nsfisis/PHPerKaigi2022-tokens

-

第1問 brainf_ck.php

-

ソースコードはこちら。実行には PHP 8.1 以上が必要なので注意。

-
<?php
-
-declare(strict_types=0O1);
-
-namespace Dgcircus\PHPerKaigi\Y2022;
-
-/**
- * @todo
- * Run this program to acquire a PHPer token.
- */
-
-https://creativecommons.org/publicdomain/zero/1.0/
-
-\error_reporting(~+!'We are hiring!');
-
-$z = fn($f) => (fn($x) => $f(fn(...$xs) => $x($x)(...$xs)))(fn($x) => $f(fn(...$xs) => $x($x)(...$xs)));
-$id = \spl_object_id(...);
-$put = fn($c) => \printf('%c', $c);
-$mm = fn($p, $n) => new \ArrayObject(\array_fill(+!![], $n, $p));
-
-$👉 = fn($m, $p, $b, $e, $mp, $pc) => [++$mp, ++$pc];
-$👈 = fn($m, $p, $b, $e, $mp, $pc) => [--$mp, ++$pc];
-$👍 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, ++$m[$mp]];
-$👎 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, --$m[$mp]];
-$📝 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, $put($m[$mp])];
-$🤡 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) {
-    +!![] => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) {
-      $b => $loop(++$pc, ++$n),
-      $e => $n === +!![] ? ++$pc : $loop(++$pc, --$n),
-      default => $loop(++$pc, $n),
-    })($pc, -![])],
-    default => [$mp, ++$pc],
-};
-$🎪 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) {
-    +!![] => [$mp, ++$pc],
-    default => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) {
-      $e => $loop(--$pc, ++$n),
-      $b => $n === +!![] ? $pc+![] : $loop(--$pc, --$n),
-      default => $loop(--$pc, $n),
-    })($pc, -![])],
-};
-$🐘 = fn($p) => $z(fn($loop) => fn($m, $p, $b, $e, $mp, $pc) =>
-  isset($p[$pc]) && $loop($m, $p, $b, $e, ...($p[$pc]($m, $p, $b, $e, $mp, $pc)))
-)($mm(+!![], +(![].![])), $p, $id($🤡), $id($🎪), +!![], +!![]);
-
-$🐘([
-  $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-  $🤡,
-    $👉, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-    $👈, $👈, $👈, $👈, $👎,
-  $🎪,
-  $👉, $👍, $👍, $👍, $👍, $👍, $📝,
-  $👎, $👎, $📝,
-  $👉, $👎, $👎, $👎, $📝,
-  $👉, $👎, $👎, $👎, $📝,
-  $👎, $👎, $📝,
-  $👎, $📝,
-  $👈, $📝,
-  $👉, $👉, $👎, $👎, $📝,
-  $👍, $👍, $👍, $👍, $👍, $👍, $👍, $📝,
-  $👈, $👎, $👎, $👎, $👎, $📝,
-  $👈, $📝,
-  $👉, $👍, $👍, $📝,
-  $👉, $👎, $📝,
-  $👈, $📝,
-]);
-

この問題は、単に適切なバージョンの PHP で動かせばトークンが得られる。

-

解説

-

絵文字

-

まず目につくのは大量の絵文字だろう。 -PHP は識別子に使用できる文字の範囲が広く、絵文字も使うことができる。

-

プログラム全体

-

Brainf*ck のインタプリタとプログラムになっている。 -Brainf*ck とは、難解プログラミング言語のひとつであり、ここで説明するよりも Wikipedia の該当ページを読んだ方がよい。

-

https://ja.wikipedia.org/wiki/Brainfuck

-

なお、brainf*ck プログラムを普通の書き方で書くと、次のようになる。

-
+ + + + + + + + + +
-[
-  > + + +
-  > + + + + +
-  > + + + + + + + + + + + +
-  > + + + + + + + + + +
-  < < < < -
-]
-> + + + + + .
-- - .
-> - - - .
-> - - - .
-- - .
-- .
-< .
-> > - - .
-+ + + + + + + .
-< - - - - .
-< .
-> + + .
-> - .
-< .
-

実行結果はこちら: https://ideone.com/22VWmb

-

それぞれの絵文字で表された関数が、各命令に対応している。

-
    -
  • $👉: >
    • -
  • $👈: <
    • -
  • $👍: +
    • -
  • $👎: -
    • -
  • $📝: .
    • -
  • $🤡: [
    • -
  • $🎪: ]
    • -
-

, (入力) に対応する関数はない (このプログラムでは使わないので用意していない)。

-

なお、$🐘 はいわゆる main 関数であり、プログラムの実行部分である。

-

絵文字の選択

-

おおよそ意味に合致するよう選んでいるが、$🤡 と $🎪 は弊社デジタルサーカスにちなんでいる。 -また、$🐘 は PHP のマスコットの象に由来する。

-

strict_types

-

declare 文の strict_types に指定できるのは、0 か 1 の数値リテラルだが、 -0x0 や 0b1 のような値も受け付ける。 -今回は、PHP 8.1 から追加された、0O または 0o から始まる八進数リテラルを使った。

-

URL

-

ソースコードのライセンスを示したこの部分だが、

-
https://creativecommons.org/publicdomain/zero/1.0/
-

完全に合法な PHP のコードである。 -https: 部分はラベル、// 以降は行コメントになっている。

-

リテラルなしで数値を生成する

-

ソースコード中に、ほとんど数値リテラルが書かれていないことにお気づきだろうか。 -PHP では、型変換を利用することで任意の整数を作り出すことができる。

-
assert(0 === +!![]);
-assert(1 === +![]);
-assert(2 === ![]+![]);
-assert(3 === ![]+![]+![]);
-assert(10 === +(![].+!![]));
-

[] に ! を適用すると true が返ってくる。それに + -を適用すると、bool から int ヘの型変換が走り、1 が生成される。10 -はさらにトリッキーだ。まず 1 と 0 を作り、. で文字列として結合する -('10')。これに + を適用すると、string から int -への型変換が走り、10 が生まれる (コード量に頓着しないなら、1 を 10 -個足し合わせてももちろん 10 が作れる)。

-

また、error_reporting に指定しているのは -1 である。 -これは、! によって文字列を false にし、+ によって false を 0 にし、さらにビット反転して -1 にしている。

-

if 文なしで条件分岐

-

三項演算子ないし match 式を使うことで、if を一切書かずに条件分岐ができる。 -また、&& / || も使えることがある。 -遅延評価が不要なケースでは、[$t, $f][$cond] のような形で分岐することもできる。

-

while、for 文なしでループ

-

不動点コンビネータを使って無名再帰する (詳しい説明は省略する。これらの単語で検索してほしい)。 -ここでは、一般に Z コンビネータとして知られるものを使った ($z)。

-

実際のところ、$🤡 や $🎪、$🐘 は、一度 Scheme (Lisp の一種) で書いてから PHP に翻訳する形で記述した。

-

なお、PHP は末尾再帰の最適化をおこなわない (少なくとも今のところは) ので、 -あまりに長い brainf*ck プログラムを書くとスタックオーバーフローする。

-

第2問 riddle.php

-

ソースコードはこちら。実行には PHP 8.0 以上が必要なので注意。

-
<?php
-
-/*********************************************************
- * This program displays a PHPer token.                  *
- * Guess 'N'.                                            *
- *                                                       *
- * Hints:                                                *
- * - N itself has no special meaning, e.g., 42, 8128,    *
- *   it is selected at random.                           *
- * - Each element of $token represents a single letter.  *
- * - One letter consists of 5x5 cells.                   *
- * - Remember, the output is a complete PHPer token.     *
- *                                                       *
- * License:                                              *
- *   https://creativecommons.org/publicdomain/zero/1.0/  *
- *********************************************************/
-const N = 0 /* Change it to your answer. */;
-assert(0 <= N && N <= 0b11111_11111_11111_11111_11111);
-
-$token = [
-  0x14B499C,
-  0x0BE34CC, 0x01C9C69,
-  0x0ECA069, 0x01C2449, 0x0FDB166, 0x01C9C69,
-  0x01C1C66, 0x0FC1C47, 0x01C1C66,
-  0x10C5858, 0x1E4E3B8, 0x1A2F2F8,
-];
-foreach ($token as $x) {
-  $x = $x ^ N;
-
-  $x = sprintf('%025b', $x);
-  $x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-  $x = implode("\n", str_split($x, length: 5));
-  echo "{$x}\n\n";
-}
-

さて、この問題はさきほどのように単純に実行しただけでは、謎のブロックが表示されるだけでトークンは得られない。 -トークンを得るためには、ソースコードを読み、定数 N を特定する必要がある。

-

ここでは、私の想定解を解説する。

-

読解

-

まずはソースコードを読んでいく。

-
$token = [
-  // 略
-];
-

数値からなる $token があり、各要素をループしている。

-
  $x = $x ^ N;
-

まずは排他的論理和 (xor) を取り、

-
  $x = sprintf('%025b', $x);
-

二進数に変換して、

-
  $x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-

0 を空白に、1 を # にし、

-
  $x = implode("\n", str_split($x, length: 5));
-

5文字ごとに区切ったあと、改行で結合している。

-

ヒント

-

次に、ソースコードに書いてあるヒントを読んでいく。

-
    -
  • N それ自体は、42 や 8128 といったような特別な意味を持たず、ランダムに決められている
    • -
  • $token の各要素は、1文字を表す
    • -
  • 1文字は 5x5 のセルからなる
    • -
  • 出力されるのは、完全な PHPer トークンである
    • -
-

ここで、PHPer トークンは必ず # 記号から始まることを思いだすと、 -$token の最初の数字 0x14B499C は、変換の結果 # になるのではないかと予想される (なお、このことは、リポジトリの README ファイルに追加ヒントとして書かれている)。

-

解く

-

ここまでわかれば、あと一歩で解ける。すなわち、0x14B499C が # に変換されるような N を見つければよい。

-

N は高々

-
assert(0 <= N && N <= 0b11111_11111_11111_11111_11111);
-

なのでブルートフォースしてもよいが、ここではブルートフォースしない方法を紹介する。

-
<?php
-
-$x = 0x14B499C;
-
-$x = $x ^ N;
-
-$x = sprintf('%025b', $x);
-$x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-$x = implode("\n", str_split($x, length: 5));
-
-assert($x ===
-  " # # \n" .
-  "#####\n" .
-  " # # \n" .
-  "#####\n" .
-  " # # ");
-

この一連の変換に対する逆変換を考えると、次のようになる。

-
<?php
-
-$x =
-  " # # \n" .
-  "#####\n" .
-  " # # \n" .
-  "#####\n" .
-  " # # ";
-
-$x = implode('', explode("\n", $x));
-$x = str_replace(search: [' ', '#'], replace: ['0', '1'], subject: $x);
-$x = bindec($x);
-
-$n = $x ^ 0x14B499C;
-
-echo "N = $n\n";
-

これを実行すると、N が得られる。

-

第3問 toquine.php

-

ソースコードはこちら。

-
<?php
-
-// License: https://creativecommons.org/publicdomain/zero/1.0/
-// This is a quine-like program to generate a PHPer token.
-// Execute it like this: php toquine.php | php | php | php | ...
-
-$s = <<<'Q'
-<?cuc
-// Yvprafr: uggcf://perngvirpbzzbaf.bet/choyvpqbznva/mreb/1.0/
-// Guvf vf n dhvar-yvxr cebtenz gb trarengr n CUCre gbxra.
-// Rkrphgr vg yvxr guvf: cuc gbdhvar.cuc | cuc | cuc | cuc | ...
-%f$f = %f;
-$f = fge_ebg13($f); $kf = [
-%f,
-];
-$g = ahyy.snyfr; sbe ($v = 0; $v <= vagqvi(__YVAR__-035,6); ++$v) vs (!vffrg($kf[$v])) oernx; ryfr
-$g .= vzcybqr("\a", fge_fcyvg(fge_ercynpr(['0','1'], ['  ','##'], fcevags(pue(37) . '025o', $kf[$v])), 012)) . "\a\a";
-$jf = neenl_znc(sa($j) => vzcybqr(', ', $j), neenl_puhax(neenl_znc(sa($k) => fcevags('0k' . pue(37) . '07K', $k), $kf), 10));
-cevags($f, $g, fge_ebg13("<<<'Q'\a{$f}\aQ"), vzcybqr(",\a", $jf));
-Q;
-$s = str_rot13($s); $xs = [
-0x0AFABEA, 0x1F294A7, 0x1F2109F, 0x1F294A7, 0x0002800, 0x1F2109F, 0x0117041, 0x1F294A7, 0x1FAD6B5, 0x1F295B7,
-0x010FC21, 0x1FAD6B5, 0x1151151, 0x010FC21, 0x1F294A7, 0x1F295B7, 0x1FAD6B5, 0x1F294A7, 0x1F295B7, 0x1F8C63F,
-0x1F8C631, 0x1FAD6B5, 0x17AD6BD, 0x17AD6BD, 0x1F8C63F, 0x1F295B7,
-];
-$t = null.false; for ($i = 0; $i <= intdiv(__LINE__-035,6); ++$i) if (!isset($xs[$i])) break; else
-$t .= implode("\n", str_split(str_replace(['0','1'], ['  ','##'], sprintf(chr(37) . '025b', $xs[$i])), 012)) . "\n\n";
-$ws = array_map(fn($w) => implode(', ', $w), array_chunk(array_map(fn($x) => sprintf('0x' . chr(37) . '07X', $x), $xs), 10));
-printf($s, $t, str_rot13("<<<'D'\n{$s}\nD"), implode(",\n", $ws));
-

コメントにもあるとおり、次のようにして実行すれば答えがでてくる。

-
$ php toquine.php | php | php | php | ...
-

実際にはもう少しパイプで繋げなければならない。

-

解説

-

プログラム全体

-

コメントにもあるとおり、これは quine (風) のプログラムになっている。 -Quine とは、自分のソースコードをそっくりそのまま出力するようなプログラムのことである。

-

このプログラムは、実行すると自身とほとんど同じプログラムを出力する。 -異なるのはトークンになっている部分のみである。

-

トークン

-

$xs がトークンに対応している。変換のロジックは riddle.php とほぼ同じなので省略する。

-

状態保持

-

トークンの何文字目まで出力したかを、ソースコードを変えずに (quine なので) 覚えておく必要がある。 -このプログラムでは、トークンが出力されるとソースコードがだんだんと長くなっていくのを利用して、__LINE__ から情報を取得している。

-

ROT 13

-

Quine は、素朴に書くとプログラムの一部が 2回記述されてしまう。 -これがあまり美しくないので、toquine.php では、ROT 13 変換を使って難読化した。

-

それにしてもなぜこんなものが標準ライブラリに……。

-

おわりに

-

解いていただいたみなさん、また、難易度調整につきあっていただいた社内のみなさん、ありがとうございました。

-

今回は直前に作りはじめたのもあり、3問だけかつ使い古されたネタばかりになってしまいましたが、 -来年は 5問、より面白い問題を持っていきます。

-

実はもう作りはじめているので、どうか来年もありますように……。

-]]> - - - - Rust のプリミティブ型はどこからやって来るか - https://blog.nsfisis.dev/posts/2021-10-02/rust-where-are-primitive-types-from/ - Sat, 02 Oct 2021 09:39:27 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/rust-where-are-primitive-types-from/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/9a429432258bbcd6c565

-
-

前置き

-

Rust において、プリミティブ型の名前は予約語でない。したがって、次のコードは合法である。

-
#![allow(non_camel_case_types)]
-#![allow(dead_code)]
-
-struct bool;
-struct char;
-struct i8;
-struct i16;
-struct i32;
-struct i64;
-struct i128;
-struct isize;
-struct u8;
-struct u16;
-struct u32;
-struct u64;
-struct u128;
-struct usize;
-struct f32;
-struct f64;
-struct str;
-

では、普段単に bool と書いたとき、この bool は一体どこから来ているのか。rustc のソースを追ってみた。

-
-

前提知識: 一般的なコンパイラの構造、用語。rustc そのものの知識は不要 (というよりも筆者自身がよく知らない)

-
-

調査

-

調査に使用したソース (調査時点での最新 master)

-

https://github.com/rust-lang/rust/tree/511ed9f2356af365ad8affe046b3dd33f7ac3c98

-

どのようにして調べるか。rustc の構造には詳しくないため、すぐに当たりをつけるのは難しい。

-

大雑把な構造としては、compiler フォルダ以下に rustc_* という名前のクレートが数十個入っている。これがどうやら rustc コマンドの実装部のようだ。

-

rustc はセルフホストされている (= rustc 自身が Rust で書かれている) ので、bool や char などで適当に検索をかけてもノイズが多すぎて話にならない。 -しかし、お誂え向きなことに i128/u128 というコンパイラ自身が使うことがなさそうな型が存在するのでこれを使って git grep してみる。

-
$ git grep "\bi128\b" | wc      # i128
-     165    1069   15790
-
-$ git grep "\bu128\b" | wc      # u128
-     293    2127   26667
-
-$ git grep "\bbool\b" | wc      # cf. bool の結果
-    3563   23577  294659
-

165 程度であれば探すことができそうだ。今回は、クレート名を見ておおよその当たりをつけた。

-
$ git grep "\bi128\b"
-...
-rustc_resolve/src/lib.rs:        table.insert(sym::i128, Int(IntTy::I128));
-...
-

rustc_resolve というのはいかにも名前解決を担いそうなクレート名である。該当箇所を見てみる。

-
/// Interns the names of the primitive types.
-///
-/// All other types are defined somewhere and possibly imported, but the primitive ones need
-/// special handling, since they have no place of origin.
-struct PrimitiveTypeTable {
-    primitive_types: FxHashMap<Symbol, PrimTy>,
-}
-
-impl PrimitiveTypeTable {
-    fn new() -> PrimitiveTypeTable {
-        let mut table = FxHashMap::default();
-
-        table.insert(sym::bool, Bool);
-        table.insert(sym::char, Char);
-        table.insert(sym::f32, Float(FloatTy::F32));
-        table.insert(sym::f64, Float(FloatTy::F64));
-        table.insert(sym::isize, Int(IntTy::Isize));
-        table.insert(sym::i8, Int(IntTy::I8));
-        table.insert(sym::i16, Int(IntTy::I16));
-        table.insert(sym::i32, Int(IntTy::I32));
-        table.insert(sym::i64, Int(IntTy::I64));
-        table.insert(sym::i128, Int(IntTy::I128));
-        table.insert(sym::str, Str);
-        table.insert(sym::usize, Uint(UintTy::Usize));
-        table.insert(sym::u8, Uint(UintTy::U8));
-        table.insert(sym::u16, Uint(UintTy::U16));
-        table.insert(sym::u32, Uint(UintTy::U32));
-        table.insert(sym::u64, Uint(UintTy::U64));
-        table.insert(sym::u128, Uint(UintTy::U128));
-        Self { primitive_types: table }
-    }
-}
-

これは初めに列挙したプリミティブ型の一覧と一致している。doc comment にも、

-
-

All other types are defined somewhere and possibly imported, but the primitive ones need special handling, since they have no place of origin.

-
-

とある。次はこの struct の使用箇所を追う。追うと言っても使われている箇所は次の一箇所しかない。なお説明に不要な箇所は大きく削っている。

-
    /// This resolves the identifier `ident` in the namespace `ns` in the current lexical scope.
-    /// (略)
-    fn resolve_ident_in_lexical_scope(
-        &mut self,
-        mut ident: Ident,
-        ns: Namespace,
-        // (略)
-    ) -> Option<LexicalScopeBinding<'a>> {
-        // (略)
-
-        if ns == TypeNS {
-            if let Some(prim_ty) = self.primitive_type_table.primitive_types.get(&ident.name) {
-                let binding =
-                    (Res::PrimTy(*prim_ty), ty::Visibility::Public, DUMMY_SP, ExpnId::root())
-                        .to_name_binding(self.arenas);
-                return Some(LexicalScopeBinding::Item(binding));
-            }
-        }
-
-        None
-    }
-

関数名や doc comment が示している通り、この関数は識別子 (identifier, ident) を現在のレキシカルスコープ内で解決 (resolve) する。 -if ns == TypeNS のブロック内では、primitive_type_table (上記の PrimitiveTypeTable::new() で作られた変数) に含まれている識別子 (bool、i32 など) かどうか判定し、そうであればそれに紐づけられたプリミティブ型を返している。

-

なお、ns は「名前空間」を示す変数である。Rust における名前空間はC言語におけるそれとほとんど同じで、今探している名前が関数名/変数名なのか型なのかマクロなのかを区別している。この if は、プリミティブ型に解決されるのは型を探しているときだけだ、と言っている。

-

重要なのは、これが resolve_ident_in_lexical_scope() の最後に書かれている点である。つまり、最初に挙げたプリミティブ型の識別子は、「名前解決の最終段階で」、「他に同名の型が見つかっていなければ」プリミティブ型として解決される。

-

動作がわかったところで、例として次のコードを考える。

-
#![allow(non_camel_case_types)]
-
-struct bool;
-
-fn main() {
-    let _: bool = bool;
-}
-

ここで main() の bool は struct bool として解決される。なぜなら、プリミティブ型の判定をする前に bool という名前の別の型が見つかるからだ。

-

まとめ

-

Rust のプリミティブ型は予約語ではない。名前解決の最終段階で特別扱いされ、他に同名の型が見つかっていなければ対応するプリミティブ型に解決される。

-]]> - - - - [Ruby] then キーワードと case in - https://blog.nsfisis.dev/posts/2021-10-02/ruby-then-keyword-and-case-in/ - Sat, 02 Oct 2021 09:38:50 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/ruby-then-keyword-and-case-in/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/787a8cf888a304497223

-
-

TL; DR

-

case - in によるパターンマッチング構文でも、case - when と同じように then が使える (場合によっては使う必要がある)。

-

then とは

-

使われることは稀だが、Ruby では then がキーワードになっている。次のように使う:

-
if cond then
-  puts "Y"
-else
-  puts "N"
-end
-

このキーワードが現れうる場所はいくつかあり、if、unless、rescue、case 構文がそれに当たる。 -上記のように、何か条件を書いた後 then を置き、式がそこで終了していることを示すマーカーとして機能する。

-
# Example:
-
-if x then
-  a
-end
-
-unless x then
-  a
-end
-
-begin
-  a
-rescue then
-  b
-end
-
-case x
-when p then
-  a
-end
-

なぜ普段は書かなくてもよいのか

-

普通 Ruby のコードで then を書くことはない。なぜか。次のコードを実行してみるとわかる。

-
if true puts 'Hello, World!' end
-

次のような構文エラーが出力される。

-
20:1: syntax error, unexpected local variable or method, expecting `then' or ';' or '\n'
-if true puts 'Hello, World!' end
-        ^~~~
-20:1: syntax error, unexpected `end', expecting end-of-input
-...f true puts 'Hello, World!' end
-

二つ目のメッセージは無視して一つ目を読むと、then か ; か改行が来るはずのところ変数だかメソッドだかが現れたことによりエラーとなっているようだ。

-

ポイントは改行が then (や ;) の代わりとなることである。true の後に改行を入れてみる。

-
if true
-puts 'Hello, World!' end
-

無事 Hello, World! と出力されるようになった。

-

なぜ then や ; や改行が必要か

-

なぜ then や ; や改行 (以下 「then 等」) が必要なのだろうか。次の例を見てほしい:

-
if a b end
-

then も ; も改行もないのでエラーになるが、これは条件式がどこまで続いているのかわからないためだ。 -この例は二通りに解釈できる。

-
# a という変数かメソッドの評価結果が truthy なら b という変数かメソッドを評価
-if a then
-  b
-end
-
# a というメソッドに b という変数かメソッドの評価結果を渡して呼び出し、
-# その結果が truthy なら何もしない
-if a(b) then
-end
-

then 等はこの曖昧性を排除するためにあり、条件式は if から then 等までの間にある、ということを明確にする。 -C系の if 後に来る (/) や、Python の :、Rust/Go/Swift などの { も同じ役割を持つ。

-

Ruby の場合、プログラマーが書きやすいよう改行でもって then が代用できるので、ほとんどの場合 then は必要ない。

-

case - in における then

-

ようやく本題にたどり着いた。来る Ruby 3.0 では case と in キーワードを使ったパターンマッチングの構文が入る予定である。この構文でもパターン部との区切りとして then 等が必要になる。 -(現在の) Ruby には formal な形式での文法仕様は存在しないので、yacc の定義ファイルを参照した (yacc の説明は省略)。

-

https://github.com/ruby/ruby/blob/221ca0f8281d39f0dfdfe13b2448875384bbf735/parse.y#L3961-L3986

-
p_case_body	: keyword_in
-		    {
-			SET_LEX_STATE(EXPR_BEG|EXPR_LABEL);
-			p->command_start = FALSE;
-			$<ctxt>1 = p->ctxt;
-			p->ctxt.in_kwarg = 1;
-			$<tbl>$ = push_pvtbl(p);
-		    }
-		    {
-			$<tbl>$ = push_pktbl(p);
-		    }
-		  p_top_expr then
-		    {
-			pop_pktbl(p, $<tbl>3);
-			pop_pvtbl(p, $<tbl>2);
-			p->ctxt.in_kwarg = $<ctxt>1.in_kwarg;
-		    }
-		  compstmt
-		  p_cases
-		    {
-		    /*%%%*/
-			$$ = NEW_IN($4, $7, $8, &@$);
-		    /*% %*/
-		    /*% ripper: in!($4, $7, escape_Qundef($8)) %*/
-		    }
-		;
-

簡略版:

-
p_case_body	: keyword_in p_top_expr then compstmt p_cases
-		;
-

ここで、keyword_in は文字通り in、p_top_expr はいわゆるパターン、then は then キーワードのことではなく、この記事で then 等と呼んでいるもの、つまり then キーワード、;、改行のいずれかである。

-

これにより、case - when による従来の構文と同じように、then 等をパターンの後ろに挿入すればよいことがわかった。つまり次の3通りのいずれかになる:

-
case x
-in 1 then a
-in 2 then b
-in 3 then c
-end
-
-case x
-in 1
-  a
-in 2
-  b
-in 3
-  c
-end
-
-case x
-in 1; a
-in 2; b
-in 3; c
-end
-

ところで、p_top_expr には if による guard clause が書けるので、その場合は if - then と似たような見た目になる。

-
case x
-in 0 then a
-in n if n < 0 then b
-in n then c
-end
-

まとめ

-
    -
  • if や case の条件の後ろには then、;、改行のいずれかが必要 -
      -
    • 通常は改行しておけばよい
      • -
    -
    • -
  • 3.0 で入る予定の case - in でも then 等が必要になる
    • -
  • Ruby の構文を正確に知るには (現状) parse.y を直接読めばよい
    • -
-]]> - - - - [C++] 属性構文の属性名にはキーワードが使える [[void]] [[for]] - https://blog.nsfisis.dev/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes/ - Sat, 02 Oct 2021 09:38:30 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/94090937bcf860cfa93b

-
-

タイトル落ち。まずはこのコードを見て欲しい。

-
#include <iostream>
-
-[[alignas]] [[alignof]] [[and]] [[and_eq]] [[asm]] [[auto]] [[bitand]]
-[[bitor]] [[bool]] [[break]] [[case]] [[catch]] [[char]] [[char16_t]]
-[[char32_t]] [[class]] [[compl]] [[const]] [[const_cast]] [[constexpr]]
-[[continue]] [[decltype]] [[default]] [[delete]] [[do]] [[double]]
-[[dynamic_cast]] [[else]] [[enum]] [[explicit]] [[export]] [[extern]] [[false]]
-[[final]] [[float]] [[for]] [[friend]] [[goto]] [[if]] [[inline]] [[int]]
-[[long]] [[mutable]] [[namespace]] [[new]] [[noexcept]] [[not]] [[not_eq]]
-[[nullptr]] [[operator]] [[or]] [[or_eq]] [[override]] [[private]]
-[[protected]] [[public]] [[register]] [[reinterpret_cast]] [[return]] [[short]]
-[[signed]] [[sizeof]] [[static]] [[static_assert]] [[static_cast]] [[struct]]
-[[switch]] [[template]] [[this]] [[thread_local]] [[throw]] [[true]] [[try]]
-[[typedef]] [[typeid]] [[typename]] [[union]] [[unsigned]]
-[[virtual]] [[void]] [[volatile]] [[wchar_t]] [[while]] [[xor]] [[xor_eq]]
-// [[using]]
-int main() {
-    std::cout << "Hello, World!" << std::endl;
-}
-
-

コンパイラのバージョン -$ clang++ –version -Apple clang version 11.0.0 (clang-1100.0.33.8) -Target: x86_64-apple-darwin19.6.0 -Thread model: posix -InstalledDir: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin

-

コンパイルコマンド (C++17指定) -$ clang++ –std=c++17 hoge.cpp

-
-

この記事から得られるものはこれ以上ないので以下は蛇足になる。

-

別件で cppreference.com の identifier のページ を読んでいた時、次の文が目に止まった。

-
-
    -
  • the identifiers that are keywords cannot be used for other purposes; -
      -
    • The only place they can be used as non-keywords is in an attribute-token. (e.g. [[private]] is a valid attribute) (since C++11)
      • -
    -
    • -
-
-

キーワードでも属性として指定する場合は非キーワードとして使えるらしい。 -実際にやってみる。

-

同サイトの [keywords のページ] (https://en.cppreference.com/w/cpp/keyword) から一覧を拝借し、上のコードが出来上がった (C++17 においてキーワードでないものなど、一部省いている)。 -大量の警告 (unknown attribute ‘〇〇’ ignored) がコンパイラから出力されるが、コンパイルできる。

-

上のコードでは [[using]] をコメントアウトしているが、これは using キーワードのみ属性構文の中で意味を持つからであり、このコメントアウトを外すとコンパイルに失敗する。

-
// using の例
-[[using foo: attr1, attr2]] int x; // [[foo::attr1, foo::attr2]] の糖衣構文
-

C++17 の仕様も見てみる (正確には標準化前のドラフト)。

-

引用元: https://timsong-cpp.github.io/cppwp/n4659/dcl.attr#grammar-4

-
-

If a keyword or an alternative token that satisfies the syntactic requirements of an identifier is contained in an attribute-token, it is considered an identifier.

-
-

「identifier の構文上の要件を満たすキーワードまたは代替トークンが attribute-token に含まれている場合、identifier とみなされる」とある。どうやら間違いないようだ。

-

ところで、代替トークン (alternative token) とは and (&) や bitor (|) などのことだが、identifier の構文上の要件を満たさないような代替トークンなどあるのか？ -疑問に思って調べたところ、代替トークンという語にはダイグラフも含まれるらしい (参考: 同ドラフト)

-
    -
  • <% → {
    • -
  • %> → }
    • -
  • <: → [
    • -
  • :> → ]
    • -
  • %: → #
    • -
  • %:%: → ##
    • -
-

「identifier の構文上の要件を満たさないような代替トークン」はこれらが当てはまると思われる。

-

調べた感想: 字句解析器か構文解析器が辛そう

-]]> - - - - [Ruby] 自身を実行している処理系の種類を判定する - https://blog.nsfisis.dev/posts/2021-10-02/ruby-detect-running-implementation/ - Sat, 02 Oct 2021 09:37:50 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/ruby-detect-running-implementation/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/74d7ffeeebc51b20d791

-
-

Ruby という言語には複数の実装があるが、それらをスクリプト上からどのようにして programmatically に見分ければよいだろうか。

-

Object クラスに定義されている RUBY_ENGINE という定数がこの用途に使える。

-

参考: Object::RUBY_ENGINE

-

上記ページの例から引用する:

-
$ ruby-1.9.1 -ve 'p RUBY_ENGINE'
-ruby 1.9.1p0 (2009-03-04 revision 22762) [x86_64-linux]
-"ruby"
-$ jruby -ve 'p RUBY_ENGINE'
-jruby 1.2.0 (ruby 1.8.6 patchlevel 287) (2009-03-16 rev 9419) [i386-java]
-"jruby"
-

それぞれの処理系がどのような値を返すかだが、stack overflow に良い質問と回答があった。

-

What values for RUBY_ENGINE correspond to which Ruby implementations? より引用:

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
RUBY_ENGINEImplementation
<undefined>MRI < 1.9
‘ruby’MRI >= 1.9 or REE
‘jruby’JRuby
‘macruby’MacRuby
‘rbx’Rubinius
‘maglev’MagLev
‘ironruby’IronRuby
‘cardinal’Cardinal
-
-

なお、この質問・回答は 2014年になされたものであり、値は変わっている可能性がある。MRI (aka CRuby) については執筆時現在 (2020/12/8) も 'ruby' が返ってくることを確認済み。

-

この表にない主要な処理系として、mruby は 'mruby' を返す。

-

mruby 該当部分のソース より引用:

-
/*
- * Ruby engine.
- */
-#define MRUBY_RUBY_ENGINE  "mruby"
-
]]> - - - - Vimで選択した行の順番を入れ替える - https://blog.nsfisis.dev/posts/2021-10-02/vim-swap-order-of-selected-lines/ - Sat, 02 Oct 2021 09:37:25 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/vim-swap-order-of-selected-lines/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/4fefb361d9a693803520

-
-

バージョン情報

-

:version の一部

-
-

VIM - Vi IMproved 8.2 (2019 Dec 12, compiled Jan 26 2020 11:30:30) -macOS version -Included patches: 1-148 -Huge version without GUI.

-
-

よく紹介されている手法

-

tac / tail

-

tac や tail -r などの外部コマンドを ! を使って呼び出し、置き換える。

-
-

:h v_!

-
-

tac コマンドや tail の -r オプションは環境によって利用できないことがあり、複数の環境を行き来する場合に採用しづらい

-

:g/^/m0

-

こちらは外部コマンドに頼らず、Vim の機能のみを使う。g は :global コマンドの、m は :move コマンドの略

-

:global コマンドは :[range]global/{pattern}/[command] のように使い、[range] で指定された範囲の行のうち、{pattern} で指定された検索パターンにマッチする行に対して、順番に [command] で指定された Ex コマンドを呼び出す。

-
-

:h :global

-
-

:move コマンドは [range]:move {address} のように使い、[range] で指定された範囲の行を {address} で指定された位置に移動させる。

-
-

:h :move

-
-

:g/^/m0 のように組み合わせると、「すべての行を1行ずつ 0行目(1行目の上)に動かす」という動きをする。これは確かに行の入れ替えになっている。

-

なお、:g/^/m0 は全ての行を入れ替えるが、:N,Mg/^/mN-1 とすることで N行目から M行目を処理範囲とするよう拡張できる。手でこれを入力するわけにはいかないので、次のようなコマンドを用意する。

-
command! -bar -range=%
-    \ Reverse
-    \ <line1>,<line2>g/^/m<line1>-1
-

これは望みの動作をするが、実際に実行してみると全行がハイライトされてしまう。次節で詳細を述べる。

-

:g/^/m0 の問題点

-

:global コマンドは各行に対してマッチングを行う際、現在の検索パターンを上書きしてしまう。^ は行の先頭にマッチするため、結果として全ての行がハイライトされてしまう。'hlsearch' オプションを無効にしている場合その限りではないが、その場合でも直前の検索パターンが失われてしまうと n コマンドなどの際に不便である。

-
-

:h @/

-
-

解決策

-
-

[2020/9/28追記] -より簡潔な方法を見つけたので次節に追記した

-
-

前述した :Reverse コマンドの定義を少し変えて、次のようにする:

-
function! s:reverse_lines(from, to) abort
-    execute printf("%d,%dg/^/m%d", a:from, a:to, a:from - 1)
-endfunction
-
-command! -bar -range=%
-    \ Reverse
-    \ call <SID>reverse_lines(<line1>, <line2>)
-

実行しているコマンドが変わったわけではないが、関数呼び出しを経由するようにした。これだけで前述の問題が解決する。

-

この理由は、ユーザー定義関数を実行する際は検索パターンが一度保存され、実行が終了したあと復元されるため。結果として検索パターンが ^ で上書きされることがなくなる。

-

Vim のヘルプから該当箇所を引用する (強調は筆者による)。

-
-

:h autocmd-searchpat

-

Autocommands do not change the current search patterns. Vim saves the current -search patterns before executing autocommands then restores them after the -autocommands finish. This means that autocommands do not affect the strings -highlighted with the ‘hlsearch’ option.

-
-

これは autocommand の実行に関しての記述だが、これと同じことがユーザー定義関数の実行時にも適用される。このことは :nohlsearch のヘルプにある。同じく該当箇所を引用する (強調は筆者による)。

-
-

:h :nohlsearch

-

(略) This command doesn’t work in an autocommand, because -the highlighting state is saved and restored when -executing autocommands |autocmd-searchpat|. -Same thing for when invoking a user function.

-
-

この仕様により、:g/^/m0 の呼び出しをユーザー定義関数に切り出すことで上述の問題を解決できる。

-

解決策 (改訂版)

-
-

[2020/9/28追記] -より簡潔な方法を見つけたため追記する

-
-
command! -bar -range=%
-    \ Reverse
-    \ keeppatterns <line1>,<line2>g/^/m<line1>-1
-

まさにこのための Exコマンド、:keeppatterns が存在する。:keeppatterns {command} のように使い、読んで字の如く、後ろに続く Exコマンドを「現在の検索パターンを保ったまま」実行する。はるかに分かりやすく意図を表現できる。

-
-

:h :keeppatterns

-
-

コピペ用再掲

-
" License: Public Domain
-
-command! -bar -range=%
-    \ Reverse
-    \ keeppatterns <line1>,<line2>g/^/m<line1>-1
-
]]> - - - - [Vim] autocmd events の BufWrite/BufWritePre の違い - https://blog.nsfisis.dev/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre/ - Sat, 02 Oct 2021 09:37:12 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/79ab4db8564032de0b25

-
-

TL; DR

-

違いはない。ただのエイリアス。

-

調査記録

-

Vim の autocmd events には似通った名前のものがいくつかある。大抵は :help に説明があるが、この記事のタイトルにある2つを含めた以下のイベントには、その違いについて説明がない。

-
    -
  • BufRead/BufReadPost
    • -
  • BufWrite/BufWritePre
    • -
  • BufAdd/BufCreate
    • -
-

このうち、BufAdd/BufCreate に関しては、:help BufCreate に

-
-

The BufCreate event is for historic reasons.

-
-

とあり、おそらくは BufAdd のエイリアスであろうということがわかる。他の2組も同様ではないかと予想されるが、確認のため vim と neovim のソースコードを調査した。

-
-

ソースコードへのリンク -vim (調査時点での master branch) -neovim (上に同じ)

-
-

vim のソースコード

-

以下は、autocmd events の名前と内部で使われている整数値とのマッピングを定義している箇所である。見ての通り、上でエイリアスではないかと述べた3組には、それぞれ同じ内部値が使われている。

-

https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L85-L86

-
    {"BufAdd",		EVENT_BUFADD},
-    {"BufCreate",	EVENT_BUFADD},
-

https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L95-L97

-
    {"BufRead",		EVENT_BUFREADPOST},
-    {"BufReadCmd",	EVENT_BUFREADCMD},
-    {"BufReadPost",	EVENT_BUFREADPOST},
-

https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L103-L105

-
    {"BufWrite",	EVENT_BUFWRITEPRE},
-    {"BufWritePost",	EVENT_BUFWRITEPOST},
-    {"BufWritePre",	EVENT_BUFWRITEPRE},
-

neovim のソースコード

-

neovim の場合でも同様のマッピングが定義されているが、こちらの場合は Lua で書かれている。以下にある通り、はっきり aliases と書かれている。

-

https://github.com/neovim/neovim/blob/71d4f5851f068eeb432af34850dddda8cc1c71e3/src/nvim/auevents.lua#L119-L124

-
  aliases = {
-    BufCreate = 'BufAdd',
-    BufRead = 'BufReadPost',
-    BufWrite = 'BufWritePre',
-    FileEncoding = 'EncodingChanged',
-  },
-

ところで、上では取り上げなかった FileEncoding だが、これは :help FileEncoding にしっかりと書いてある。

-
                                                           *FileEncoding*
-FileEncoding                    Obsolete.  It still works and is equivalent
-                                to |EncodingChanged|.
-

まとめ

-

記事タイトルについて言えば、どちらも変わらないので好きな方を使えばよい。あえて言えば、次のようになるだろう。

-
    -
  • BufAdd/BufCreate -
      -
    • → BufCreate は歴史的な理由により (“for historic reasons”) 存在しているため、新しい方 (BufAdd) を使う
      • -
    -
    • -
  • BufRead/BufReadPost -
      -
    • → BufReadPre との対称性のため、あるいは BufWritePost との対称性のため BufReadPost を使う
      • -
    -
    • -
  • BufWrite/BufWritePre -
      -
    • → BufWritePost との対称性のため、あるいは BufReadPre との対称性のため BufWritePre を使う
      • -
    -
    • -
  • FileEncoding/EncodingChanged -
      -
    • → FileEncoding は “Obsolete” と明言されているので、EncodingChanged を使う
      • -
    -
    • -
-

ところでこの調査で知ったのだが、BufRead と BufWrite は上にある通り発火するタイミングが「後」と「前」で対称性がない。可能なら Pre/Post 付きのものを使った方が分かりやすいだろう。

-]]> - - - - [Python] クロージャとUnboundLocalError: local variable 'x' referenced before assignment - https://blog.nsfisis.dev/posts/2021-10-02/python-unbound-local-error/ - Sat, 02 Oct 2021 09:32:37 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/python-unbound-local-error/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/5d733703afcb35bbf399

-
-

本記事は Python 3.7.6 の動作結果を元にして書かれている。

-

Python でクロージャを作ろうと、次のようなコードを書いた。

-
def f():
-    x = 0
-    def g():
-        x += 1
-    g()
-
-f()
-

関数 g から 関数 f のスコープ内で定義された変数 x を参照し、それに 1 を足そうとしている。 -これを実行すると x += 1 の箇所でエラーが発生する。

-
-

UnboundLocalError: local variable ‘x’ referenced before assignment

-
-

local変数 x が代入前に参照された、とある。これは、f の x を参照するのではなく、新しく別の変数を g 内に作ってしまっているため。 -前述のコードを宣言と代入を便宜上分けて書き直すと次のようになる。var を変数宣言のための構文として擬似的に利用している。

-
# 注: var は正しい Python の文法ではない。上記参照のこと
-def f():
-    var x           #  f の local変数 'x' を宣言
-    x = 0           #  x に 0 を代入
-    def g():        #  f の内部関数 g を定義
-        var x       #  g の local変数 'x' を宣言
-                    #  たまたま f にも同じ名前の変数があるが、それとは別の変数
-        x += 1      #  x に 1 を加算 (x = x + 1 の糖衣構文)
-                    #  加算する前の値を参照しようとするが、まだ代入されていないためエラー
-    g()
-

当初の意図を表現するには、次のように書けばよい。

-
def f():
-    x = 0
-    def g():
-        nonlocal x   ## (*)
-        x += 1
-    g()
-

(*) のように、nonlocal を追加する。これにより一つ外側のスコープ (g の一つ外側 = f) で定義されている x を探しに行くようになる。

-]]> - - - - PHPerKaigi 2021 - https://blog.nsfisis.dev/posts/2021-03-30/phperkaigi-2021/ - Tue, 30 Mar 2021 23:22:40 +0900 - - https://blog.nsfisis.dev/posts/2021-03-30/phperkaigi-2021/ - PHPerKaigi 2021 参加レポ -

2021-03-26 から 2021-03-28 にかけて開催された、PHPerKaigi 2021 に一般参加者として参加した。 -弊社デジタルサーカス株式会社 (今年1月から勤務) はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。

-

このようなカンファレンスには初めて参加するのでかねてより心待ちにしていたのだが、生憎2日目から体調を崩してしまい、この記事も途中までとなっている。まだ見ていないセッションも多いが、ひとまず現時点での参加レポを書いておく。

-

発表はトラック A、B に分かれていたのだが、今回はすべて A トラックを視聴している (切り替えるのが面倒だっただけ)。

-

凡例

-
-

発表・スライドのメモ (引用ではない)

-
-

感想など

-

Day 0 前夜祭 (2021/03/27)

-

17:30 [A]

-

PHP で AWS Lambda

-
-

Rails のプロジェクトを PHPer のメンバのみでメンテ -→他のメンバもわかる PHP にリプレースを検討

-

サーバレス

-
    -
  • サーバ・インフラの管理が不要
    • -
  • アプリケーションコードの知識だけで保守可能
    • -
-

ゼロベースで作れる案件が (Railsの件とは別に) あるため、そちらで試験的に導入?

-

AWSの学習 -AWS のドキュメント -DevelopersIO

-

AWS Lambda のカスタムランタイムで PHP を動かす

-

サーバのセットアップや維持管理を気にしなくて良い -サーバーレスで PHP を動かすツールがすでにある -サーバーレス構築はすんなり

-

今は Laravel がルーティングしている -Laravel Livewire を Lambda に載せられないか？ -デプロイ方法は？ -バッチ処理は？ (Lambda は 15分の制限)

-

Lambda でコンテナイメージがサポートされるように

-

抽象化されたもの「だけ」しか知らないよりも具象の理解は助けになる

-
-

AWS Lambda のような Function as a Service はマイクロサービス化における一つの到達点に思えるのだが、これを使って実際に web サービスを作る具体的なイメージがまだ見えない (注: すべて for me として書いている)。

-

PHP on AWS Lambda があれだけ簡単に動かせるのには驚いた。

-

勝手に AWS Lambda だとフットプリントの軽さが求められそう (= PHP + Laravel などでは動かなさそう) だという先入観を持っていたのだが、この発表のデモによればそうでもないらしい。

-

18:10 [A]

-

大規模サイトの SEO

-
-

大規模サイト (100万ページ以上) -Google の基準

-

クロールバジェットを意識したSEO

-

大規模サイトでコンテンツが中頻度 (1回/週) で更新 OR 中規模サイト (10,000以上) でコンテンツが目まぐるしく変更される -これを満たさないなら、クロールバジェットを考えなくてもいい

-

サーチコンソール -「カバレッジ」の「除外」 -多すぎるのは問題→クロールバジェットを浪費している

-
    -
  • クエリの順番を決める
    • -
  • 空の値のルールを決めておく
    • -
  • リダイレクトすればインデックスはうまくいく
    • -
  • リンクが存在する限りクロールはされる
    • -
-

リニューアル前のURL

-

インデックスは移行される -リンクのURLが存在する限り、別のURLとしてクロールされる -リダイレクトされるとはいえ、リニューアル前のURLは移行した方が良い -リニューアルで無視されるようになったパラメータも注意

-

robotes.txt で拒否しているのにクロールされる -一時的に拒否を外して 404 や 301 を読ませる -内部リンクを確認する -JS でのリンクに書き換え

-

クエリパラメータからURLのパスに -/tokyo?area=HOGE → /tokyo/HOGE

-

URL 設計だいじ

-
-

SEO (Search Engine Optimization) は大して知らないので新鮮な話が多かった。その分語れることも少ない……。

-

18:50 [A]

-
-

知覚可能 -操作可能 -理解可能 -堅牢 ちゃんとしたHTMLを書く (閉じタグ・入れ子構造など)

-
    -
  • -

    標準の HTML を適切に使う

    -
    • -
  • -

    WAI-ARIA

    -
    • -
  • -

    キーボードフレンドリー

    -
    • -
  • -

    マシンフレンドリー

    -
    • -
  • -

    SEOフレンドリー

    -
    • -
-

button タグ -→キーボード -h1 タグ -→スクリーンリーダー・クローラ -a タグ

-

WAI-ARIA -HTML では表現できないセマンティクスを追加する

-
    -
  • ロール -
      -
    • 何をするのか？
      • -
    • ユーザーアクションによって変化しない
      • -
    -
    • -
  • プロパティ -
      -
    • 関連づけられたデータ
      • -
    -
    • -
  • ステート -
      -
    • 現在の状態
      • -
    -
    • -
-

まずは標準の HTML 要素で解決する -何でもかんでも WAI-ARIA を使えばいいというものではない

-

マウスホバーでツールチップが出てくるが、キーボード操作では出てこない

-

VoiceOver

-

全ての属性を使う必要はない -あくまでアクセシビリティを上げるための方法の一つにすぎない

-
-

つい最近 WAI-ARIA についての記事を読んだばかりだったので個人的にタイムリーな話題だった。(あまりこの言葉を使いたくないのだが) いわゆる「健常者」にとって、こうした問題を普段の生活の中で意識するのは難しい。だからこそ情報へのアンテナは張っておくようにしたい。

-

19:30 [A]

-

PHP で FUSE

-

個人的に楽しみだった発表。

-
-

VFS (virtual filesystem) vs 具体的なファイルシステム

-

最適な実装方法は状況により異なる

-

アプリケーションに見せるAPIは変えずに実装を隠蔽する→VFS

-

カーネルのプログラムを作るのは難しい

-
    -
  • 権限がデカすぎる
    • -
  • システム全体がクラッシュ
    • -
  • セキュリティリスク
    • -
  • 開発サイクルを回しづらい
    • -
  • ネイティブコードにコンパイルされる言語である必要がある
    • -
-

Filesystem in USEr space (FUSE)

-
    -
  • 特定の C の関数を呼ぶことで filesystem が作れる
    • -
  • FFI を持つ言語なら FUSE が使える
    • -
-

SSHFS / s3fs / Docker Desktop

-

Linux 以外でも使える

-
    -
  • dokany (on Windows)
    • -
  • osxfuse
    • -
-

VFS: システムコールが呼ばれると、ファイルシステムによってコール -FUSE: カーネル空間からユーザ空間へ通信

-

高レベルなラッパで型をつける

-

PHP 以外では Wordpress を FUSE にマウントする実装がある (C, Python など)

-
    -
  • grep できる
    • -
  • sed できる
    • -
  • 編集できる
    • -
-
-

期待通りの興味深い発表だった。FUSE 自体も今回の発表で知ったのだが、これ本体の実装を見るのも面白そうだ。 -この発表を聞きながらファイルシステムにマウントできそうなものを考えていたのだが、およそ木構造をしているものすべてと言えそうだ (ハンマーしか持っていないと云々)。何かできそうだがなかなか思いつかない。

-

Day 1 (2021/03/27)

-

10:50 [A]

-

ATDD

-
-
    -
  • ユーザーストーリー
    • -
  • ユニットテスト
    • -
  • CI/CD
    • -
-

ユーザストーリーの受け入れ条件が曖昧になりがち -デグレチェックがユニットレベルでは収まらない場合、手動で同じシナリオをテストしている

-

Q2の強化 -アジャイルテストの4象限

-

技術面/ビジネス面 -開発チーム支援(コーディング前・コーディング中)/製品批評(コーディング後)

-
    -
  • Q1: 技術面 & チーム支援 -
      -
    • TDD
      • -
    • ユニットテストなど
      • -
    -
    • -
  • Q2: ビジネス面 & チーム支援 -
      -
    • ATDD
      • -
    • ビジネス面の受け入れテストで駆動する
      • -
    -
    • -
-

Agile Alliance -ユーザストーリーのスキルレベルを高める

-

テストピラミッド

-
    -
  • -

    UI Tests

    -
    • -
  • -

    Service Tests

    -
    • -
  • -

    Unit Tests

    -
    • -
  • -

    異なる粒度のテストを書く

    -
    • -
  • -

    高レベルになるほど、持つべきテストは少なくなる

    -
      -
    • ピラミッド型になる
      • -
    -
    • -
-

高レベルテストが多すぎる→アイスクリームコーン　アンチパターン

-

ATDD (Acceptance TDD) -API経由・UI経由での高レベルテスト E2E test

-

ストーリ受け入れテスト

-

入れ子のフィードバックループ -ATDD(外側) と TDD(内側)

-

外部品質・内部品質

-

バーティカルスライスのデリバリー

-
    -
  • cucumber
    • -
  • gauge
    • -
  • behat
    • -
-

ユビキタス言語 -手動テストもspecに書く -自動化は可能だがコスパが悪い -失敗することがわかっているテスト(レッドテスト)はCIから外す -失敗時の原因究明が難しい -饒舌なエラーメッセージ -状況のスナップショット

-

Continuous Testing

-
-

User Acceptance Test (UAT) くらいの規模になると個人開発・趣味開発では触れない領域なので、大いに勉強になった。スライドに添付されている資料が相当に充実していたので、これを読むのが本番といった様相すら感じる。 -高レベルテストの自動化は現在のプロジェクトでも感じており、自動化のチャンスは伺っている。とはいえセッションでも指摘されているように自動化することにコストがかかりすぎる領域があるのも事実で、そのバランスが難しい。

-

11:50 [A]

-

型解析を用いたリファクタリング

-

型のある世界で生きてきた身として大いに楽しみにしていた発表。

-
-
    -
  • PHPStan
    • -
  • Phan
    • -
  • Psalm
    • -
-

autoload も認識できる -bootstrapFiles

-

編集箇所と利用箇所を CI でチェック -ルールレベルを徐々に引き上げていく -警告が多すぎると見落としてしまう・無視されやすくなる

-

型がついていないことによるエラーが多い

-

型よりも詳細な検査 Util_Assert::min

-

SQL を静的解析 -placeholder の型付け

-

警告レベルを低いレベルから導入 -タイプヒントを積極的に書いていく -PHPStan の拡張を追加する

-
-

昨今、動的型付き言語での型宣言・型アノテーション・型ヒントの導入が相次いでいる。長らく静的型付き言語を書いてきた私からすると、ようやく気づいたかといったところだが、ともかく型を導入する言語が増えてきた。 -今のプロジェクトでも新しく追加するコードには型をつけるよう努めているが、どうしても古いコードには型がついていない。個人的には型のないコードに対してどう型を自動的に付けるかという点に興味があり、その点で Ruby の typeprof には注目している。

-

12:30 [A]

-

昼食をとっていた。事前に何か食料を買っておくべきだった。

-

13:10 [A]

-

Documentation as Code

-

この発表も以前から非常に楽しみにしていた。

-
-

開発開始までのオーバーヘッド -新規にチームにジョイン -担当範囲外の機能を理解 -オンボーディングのコスト

-

PHPerKaigi 2020 で発表あり

-

継続的にシステムの理解を助けるドキュメント

-

継続的ドキュメンテーション -システムとドキュメントの乖離

-

書いてあることが間違っている・足りない

-
    -
  • 徐々にずれていく
    • -
  • システムの更新タイミングとドキュメントの更新タイミングに差がある
    • -
-

システムとドキュメントは対応関係がある

-
    -
  • 間違ったドキュメント
    • -
  • 存在しないドキュメント
    • -
-

システムとドキュメントの乖離を定量化する -継続的に -システムの更新に近いタイミングで ドキュメントを更新し続ける

-

Documentation as Code

-

コードと同じツールでドキュメントを書く

-
    -
  • issue tracker
    • -
  • vcs
    • -
  • plain text markup
    • -
  • automation
    • -
-

開発者 -システム -ドキュメント -構造化データ -ソフトウェア

-

システムから構造化データを抽出する -PHPDoc -OpenAPI

-

ビュー 関心ごとに合わせてアーキテクチャを一つ以上の側面(断面)で説明する

-

ビューの単位でドキュメントに

-

スタックトレースからのドキュメント生成

-
-

ドキュメントの管理は現プロジェクトでも課題と感じている。作られた当初は正しくても、実態と乖離していくのを止めるのは困難を極める。全体的に興味深い発表だったが、特にスタックトレースからのドキュメント生成というアイデアに惹かれるものを感じた。スタックトレースという実態と不可分な (乖離しない) 情報を起点にするのは理にかなっている。問題はトレースをいつ、どう取るかだろうか。それを自動化しなければ、実態との乖離が避けられないだろう。

-

14:10 [A]

-

cookie による session 管理

-

全体的に基本的な話だったので特に触れない。Cookie やセッションの話としては非常に分かりやすくまとめられていたので、知らない人が学ぶにはいい教材だろう。

-

14:50 [A]

-

PHP のエラーと例外

-
-

エラー PHPエンジンがエラーを通知する -例外 プログラムが投げる

-

PHP7-8とエラー

-

PHPエンジンのエラーの一部が \Error に変換されるようになった -→ try-catch で捕捉できる

-

\Error は例外とは異なる

-

PHP8 でエラーレベルの引き上げ

-
    -
  • 捕捉すべきもの -
      -
    • recoverable
      • -
    -
    • -
  • 捕捉すべきでないもの -
      -
    • unrecoverable
      • -
    • 開発時に対処できるもの
      • -
    -
    • -
-

例外

-
    -
  • 捕捉して事後処理
    • -
  • 捕捉せず(or 捕捉した上で)さらに上に是非を問う
    • -
-

開発段階で例外を把握し、ハンドリングを考えておく

-

\Throwable \Exception と \Error

-

\Error はキャッチすべきでない

-
    -
  • -

    \Error

    -
      -
    • 本番で起きてはいけない
      • -
    -
    • -
  • -

    \LogicException

    -
      -
    • 本番で起きてはいけない -→生じないのだから捕捉もしない
      • -
    -
    • -
  • -

    \RuntimeException

    -
      -
    • 起こるかもしれないので本番環境でも考慮する
      • -
    -
    • -
-

捕捉して対応するのではなく、未然に防ぐ

-

独自例外を使う -\Exception を投げてしまうと、 -catch (\Exception)せざるを得ない -→catch 範囲が広すぎる

-

SPL の例外を使う

-

例外翻訳 -上位のレイヤが下位のレイヤの例外を捕捉し、上位レイヤのAPIに「翻訳」する -下位レイヤの知識に依存させない

-

@throws -捕捉してほしい例外を書き連ねておく

-

呼び出しもとに負わせたい責任

-
-

PHP を学んでいる途中の私としては、今まさに聞きたい発表だった (現時点で PHP を書き始めてから 4ヶ月ほどになる)。

-

個人的に例外やエラーを最もうまく扱っているのは Go、Swift、Rust、Haskell などのエラーを「値として」扱う言語だと思っている。try-catch は通常の処理フローを完全に壊してしまう上、構文としても重すぎる。値としてのエラー通知は C言語時代への回帰ともいえるが、その頃と異なるのはエラーを暗黙のうちに握り潰すことがないということだ。これらの言語は型を持っており、静的に検証ができる (C のそれはまともな型付けではない。念のため)。

-

PHP のように、すでに例外が言語システムに根ざしている言語ではどうすればよいか。この場合も同じく静的検証の力を借りることになるだろう。

-

15:30 [A]

-

Laravel のメール認証

-

Laravel の知識がない私にはまったくついていけなかった。また、個人的にタイトルがややミスリーディングに感じた。

-

16:10 [A]

-

gRPC

-
-

Unary RPCs -Server streaming RPCs -Client streaming RPCs -Bidirectional streaming RPCs

-

Protobuf

-

実装とAPIが乖離しにくい -自動生成 -複数言語でも相互に使える

-

マイクロサービスのサービス通信 -スマホアプリ -ゲームサーバ

-

PHP では？

-

PHP ではストリーミングが難しい -リクエストごとにプロセスが使い捨て

-

PHP ではgRPCのクライアントしか対応していない

-

gRPC-Web -ブラウザで扱うためのJSライブラリ+プロトコル

-

HTTP/1.1 でも使える -Unary RPC と Server streaming RPC のみ

-

Envoy -Nginx などで相互に gRPC と gRPC-Web で変換

-

Amp -イベント駆動な並行処理のフレームワーク

-

HTTP/2 対応

-

C#のgRPC-Webが楽

-
-

(発表の中でもまさに同じことをおっしゃっていたが) PHP 以外の方が向いているだろう、というのが第一の感想である。gRPC はそれ自体というよりも Protobuf というエコシステムに乗れることのメリットが大きいと感じる。そのエコシステムにうまく乗れない時点で、うーんという感じ。

-

16:50 [A]

-

アーキテクチャテスト

-
-

Independent Core Layer Pattern

-

開発初期のアーキテクチャが崩れる -アーキテクチャ観点のコードレビューができない

-

どこにクラスを置けばよいか？ -ドキュメントがない

-

アーキテクチャ設計に関する知識が属人化・暗黙知化

-

ガイドライン

-
    -
  • 最初にルールを決めるのは簡単
    • -
  • ルール通り作り始めるのも簡単 -
      -
    • →維持するのが難しい、人が決めたものゆえ壊れやすい
      • -
    -
    • -
-

PHP の特性

-
    -
  • クラスは public
    • -
  • 可視性の制御が public / protected / private のみ
    • -
  • 依存関係の制御が困難
    • -
-

アーキテクチャテスト -クラスの依存関係や実装ルールをコードとして表現し、自動テスト化する

-
    -
  • deptrac
    • -
  • phpat
    • -
-

Independent Core Layer Pattern

-

アーキテクチャテストの失敗

-
    -
  • 実装誤り
    • -
  • or アーキテクチャが適切でない -
      -
    • 開発の過程でフィードバックしていく
      • -
    -
    • -
-

モジュラーモノリス→マイクロサービスへ

-
-

Day 2 (2021/03/28)

-

冒頭に書いた通り、2日目から体調が悪くまともに聴けていない。途中までは頭痛を我慢しつつ見ていたのだが、まともに入ってこなかった。

-

残念ではあるが、いずれにせよ見られていない発表は他にもあるので、今週末にでもまとめて見ようと思う。

-

全体の感想

-

Day 2 にほとんど参加できなかったのは残念だが、イベント自体は大変楽しく、また興味深いものであった。自分がまったく知らない領域の話を聞けるのはこうしたイベントならではだと感じる。オンライン開催ゆえ現地に行く必要がなく、気軽に参加できたのも (特に初参加者として) 嬉しいポイントだった。

-

今回、雑談/登壇者への質問等向けに Discord サーバもあったのだが、こちらは参加こそしたものの ROM のままになってしまった。発表に1ウィンドウ、メモを書くのに1ウィンドウ、Discord 表示に 1ウィンドウで私にはもう脳のリソースとディスプレイのスペースが追いつかなかった (さらにいうと Zoom でアンカンファレンスもやっていたようだ。こちらはまったく参加していない)。

-

1つ個人的な反省点としては、一つ一つのセッションを真剣に聞き過ぎたというものがある。もっと適当に聞いておけばよかった。これだけだと大変語弊があるのだが、言い方を変えると、Discord しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。 -まあ初カンファレンスだし、とお茶を濁しておこう。

-

さて、カンファレンスで一つ気になったことがある。それは、Discord という書き込み場所が増えたことでニコ生のコメントの流量が吸い取られてしまったのではないか、という点だ。ニコニコだけ見ていると過疎っているかのように見えた発表も、Discord の方では盛り上がっている、というのを何度か見かけた。ニコニコのコメント方式は盛り上がりを如実に反映するが、逆もまたしかり。Discord があったこと自体はプラスだったと思うが、この点はマイナスだったのではないかと感じる。

-
-

最後になりましたが、毎年の PHPerKaigi 開催にご尽力されている皆様、スピーカーの皆様、楽しい3日間でした。ありがとうございました！ -(ずっと常体で書いてしまったのでいきなり仏頂面から笑顔になったようで気持ち悪い)

-

ではまた来年。

-]]> - - - - My First Post - https://blog.nsfisis.dev/posts/2021-03-05/my-first-post/ - Fri, 05 Mar 2021 23:38:21 +0900 - - https://blog.nsfisis.dev/posts/2021-03-05/my-first-post/ - Test -

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

-]]> - - - - diff --git a/docs/posts/index.html b/docs/posts/index.html deleted file mode 100644 index 56aee42..0000000 --- a/docs/posts/index.html +++ /dev/null @@ -1,172 +0,0 @@ - - - - - - - - Posts | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -

Posts

- -
-
-

[備忘録] このサイト用の VPS をセットアップしたときのメモ

-
-
-

GitHub Pages でホストしていたこのサイトを VPS へ移行したので、 -そのときにやったことのメモ。99 % 自分用。

-
-
- Posted on -
- -
-
-
-

PHPerKaigi 2023: ボツになったトークン問題 その 1

-
-
-

来年の PHPerKaigi 2023 でデジタルサーカス株式会社から出題予定のトークン問題のうち、 -ボツになった問題を公開する (その 1)。

-
-
- Posted on -
- -
-
-
-

[PHP] fizzbuzz を書く。1行あたり2文字で。

-
-
-

PHP で、fizzbuzz を書いた。ただし、1行あたりに使える文字数は2文字まで。

-
-
- Posted on -
- -
-
-
-

弊社の PHP Foundation への寄付に寄せて

-
-
-

先日、私の勤めるデジタルサーカス株式会社が、PHP Foundation へ寄付をおこないました。 -本件を社内でしつこく推進した1人として、推進の理由等を書き残しておきます。

-
-
- Posted on -
- -
-
-
-

PHP カンファレンス沖縄で出題されたコードゴルフの問題を解いてみた

-
-
-

PHP カンファレンス沖縄の懇親会 LT で出題されたコードゴルフの問題を解いてみた。

-
-
- Posted on -
- -
-
-
-

PHPerKaigi 2022

-
-
-

2022-04-09 から 2022-04-11 にかけて開催された、PHPerKaigi 2022 に参加した。

-
-
- Posted on -
- -
-
-
-

term-banner: ターミナルにバナーを表示するツールを書いた

-
-
-

ターミナルに任意の文字のバナーを表示するためのツールを Go で書いた。

-
-
- Posted on , updated on -
- -
-
-
-

PHPerKaigi 2022 トークン問題の解説

-
-
-

PHPerKaigi 2022 で私が作成した PHPer チャレンジ問題を解説する。

-
-
- Posted on , updated on -
- -
-
-
-

Rust のプリミティブ型はどこからやって来るか

-
-
-

Rust のプリミティブ型は予約語ではなく普通の識別子である。どのようにこれが名前解決されるのかを調べた。

-
-
- Posted on -
- -
-
-
-

[Ruby] then キーワードと case in

-
-
-

Ruby 3.0 で追加される case in 構文と、then キーワードについて。

-
-
- Posted on -
- -
-
- - - - - - diff --git a/docs/posts/page/1/index.html b/docs/posts/page/1/index.html deleted file mode 100644 index 1439f8c..0000000 --- a/docs/posts/page/1/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - - https://blog.nsfisis.dev/posts/ - - - - - - diff --git a/docs/posts/page/2/index.html b/docs/posts/page/2/index.html deleted file mode 100644 index 52466e0..0000000 --- a/docs/posts/page/2/index.html +++ /dev/null @@ -1,133 +0,0 @@ - - - - - - - - Posts | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -

Posts

- -
-
-

[C++] 属性構文の属性名にはキーワードが使える [[void]] [[for]]

-
-
-

C++ の属性構文の属性名には、キーワードが使える。ネタ記事。

-
-
- Posted on -
- -
-
-
-

[Ruby] 自身を実行している処理系の種類を判定する

-
-
-

Ruby には複数の実装があるが、自身を実行している処理系の種類をスクリプト上からどのように判定すればよいだろうか。

-
-
- Posted on -
- -
-
-
-

Vimで選択した行の順番を入れ替える

-
-
-

Vim で選択した行の順番を入れ替える方法。

-
-
- Posted on -
- -
-
-
-

[Vim] autocmd events の BufWrite/BufWritePre の違い

-
-
-

Vim の autocmd events における BufWrite/BufWritePre がどう違うのかを調べた結果、違いはないことがわかった。

-
-
- Posted on -
- -
-
-
-

[Python] クロージャとUnboundLocalError: local variable 'x' referenced before assignment

-
-
-

Python における UnboundLocalError の理由と対処法。

-
-
- Posted on -
- -
-
-
-

PHPerKaigi 2021

-
-
-

2021-03-26 から 2021-03-28 にかけて開催された、PHPerKaigi 2021 に参加した。

-
-
- Posted on -
- -
-
-
-

My First Post

-
-
-

これはテスト投稿です。これはテスト投稿です。これはテスト投稿です。

-
-
- Posted on -
- -
-
- - - - - - diff --git a/docs/sitemap.xml b/docs/sitemap.xml deleted file mode 100644 index d16785d..0000000 --- a/docs/sitemap.xml +++ /dev/null @@ -1,107 +0,0 @@ - - - - https://blog.nsfisis.dev/posts/2022-10-28/setup-server-for-this-site/ - 2022-10-28+09:00 - - https://blog.nsfisis.dev/tags/note-to-self/ - 2022-10-28+09:00 - - https://blog.nsfisis.dev/posts/ - 2022-10-28+09:00 - - https://blog.nsfisis.dev/tags/ - 2022-10-28+09:00 - - https://blog.nsfisis.dev/tags/php/ - 2022-10-23+09:00 - - https://blog.nsfisis.dev/tags/phperkaigi/ - 2022-10-23+09:00 - - https://blog.nsfisis.dev/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1/ - 2022-10-23+09:00 - - https://blog.nsfisis.dev/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line/ - 2022-09-29+09:00 - - https://blog.nsfisis.dev/posts/2022-08-31/support-for-communty-is-employee-benefits/ - 2022-08-31+09:00 - - https://blog.nsfisis.dev/tags/conference/ - 2022-08-27+09:00 - - https://blog.nsfisis.dev/posts/2022-08-27/php-conference-okinawa-code-golf/ - 2022-08-27+09:00 - - https://blog.nsfisis.dev/tags/phpcon/ - 2022-08-27+09:00 - - https://blog.nsfisis.dev/posts/2022-05-01/phperkaigi-2022/ - 2022-05-01+09:00 - - https://blog.nsfisis.dev/tags/my-programs/ - 2022-04-27+09:00 - - https://blog.nsfisis.dev/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal/ - 2022-04-27+09:00 - - https://blog.nsfisis.dev/posts/2022-04-09/phperkaigi-2022-tokens/ - 2022-04-16+09:00 - - https://blog.nsfisis.dev/tags/rust/ - 2021-10-02+09:00 - - https://blog.nsfisis.dev/posts/2021-10-02/rust-where-are-primitive-types-from/ - 2021-10-02+09:00 - - https://blog.nsfisis.dev/posts/2021-10-02/ruby-then-keyword-and-case-in/ - 2021-10-02+09:00 - - https://blog.nsfisis.dev/tags/ruby/ - 2021-10-02+09:00 - - https://blog.nsfisis.dev/tags/ruby3/ - 2021-10-02+09:00 - - https://blog.nsfisis.dev/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes/ - 2021-10-02+09:00 - - https://blog.nsfisis.dev/tags/cpp/ - 2021-10-02+09:00 - - https://blog.nsfisis.dev/tags/cpp17/ - 2021-10-02+09:00 - - https://blog.nsfisis.dev/posts/2021-10-02/ruby-detect-running-implementation/ - 2021-10-02+09:00 - - https://blog.nsfisis.dev/tags/vim/ - 2021-10-02+09:00 - - https://blog.nsfisis.dev/posts/2021-10-02/vim-swap-order-of-selected-lines/ - 2021-10-02+09:00 - - https://blog.nsfisis.dev/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre/ - 2021-10-02+09:00 - - https://blog.nsfisis.dev/posts/2021-10-02/python-unbound-local-error/ - 2021-10-02+09:00 - - https://blog.nsfisis.dev/tags/python/ - 2021-10-02+09:00 - - https://blog.nsfisis.dev/tags/python3/ - 2021-10-02+09:00 - - https://blog.nsfisis.dev/ - 2021-03-31+09:00 - - https://blog.nsfisis.dev/posts/2021-03-30/phperkaigi-2021/ - 2021-03-30+09:00 - - https://blog.nsfisis.dev/posts/2021-03-05/my-first-post/ - 2021-03-05+09:00 - - diff --git a/docs/style.css b/docs/style.css deleted file mode 100644 index 3666589..0000000 --- a/docs/style.css +++ /dev/null @@ -1,483 +0,0 @@ -/* - * Paper - * A simple, clean, flexible Hugo theme - * https://github.com/nanxiaobei/hugo-paper - * Designed by MR.LEE (https://mrlee.me/) - * Updated in 2020.6.12 - */ - -/* Theme --------------------------------------------------- */ -:root { - --gap: 24px; - --content-gap: 40px; - --nav-width: 1024px; - --main-width: 640px; - --header-height: 60px; - --footer-height: 60px; - --radius: 8px; - - --theme: #fff; - --entry: #fff; - --primary: rgba(0, 0, 0, 0.88); - --secondary: rgba(0, 0, 0, 0.56); - --tertiary: rgba(0, 0, 0, 0.16); - --content: rgba(0, 0, 0, 0.88); - - --hljs-bg: #1c1d21; - --code-bg: #f5f5f5; - --border: #eee; -} -.list { - background: var(--code-bg); -} -/* Reset --------------------------------------------------- */ -*, -*::before, -*::after { - box-sizing: border-box; -} -html { - -webkit-tap-highlight-color: transparent; -} -body { - margin: 0; - color: var(--primary); - font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, - 'Open Sans', 'Helvetica Neue', sans-serif; - font-size: 18px; - line-height: 1.8; - word-break: break-word; - background: var(--theme); -} -article, -aside, -figcaption, -figure, -footer, -header, -hgroup, -main, -nav, -section { - display: block; -} -h1, -h2, -h3, -h4, -h5, -h6 { - margin-top: 0; - margin-bottom: 0; - color: var(--primary); - line-height: 1.2; -} -p { - margin-top: 0; - margin-bottom: 0; -} -strong, -b { - font-weight: bold; -} -ul { - margin: 0; - padding: 0; -} -a { - color: var(--primary); - text-decoration: none; -} -figure { - margin: 0; -} -table { - width: 100%; - border-collapse: collapse; - border-spacing: 0; -} -button, -input, -textarea { - padding: 0; - font: inherit; - background: transparent; - border: 0; - -webkit-appearance: none; -} -button, -input[type='button'], -input[type='submit'] { - cursor: pointer; -} -input, -textarea { - padding: 0; - border: 0; - outline: 0; -} -input:-webkit-autofill, -textarea:-webkit-autofill { - box-shadow: 0 0 0 50px var(--theme) inset; -} -img { - display: block; - max-width: 100%; -} -/* Header --------------------------------------------------- */ -.nav { - display: flex; - flex-wrap: wrap; - justify-content: space-between; - max-width: calc(var(--nav-width) + var(--gap) * 2); - margin-left: auto; - margin-right: auto; -} -.nav a { - display: block; - line-height: var(--header-height); -} -.logo, -.menu { - margin-left: var(--gap); - margin-right: var(--gap); -} -.logo a { - font-size: 24px; - font-weight: 700; -} -.menu { - display: flex; - list-style: none; - word-break: keep-all; - overflow-x: auto; -} -.menu li + li { - margin-left: var(--gap); -} -.menu a { - font-size: 16px; -} -/* Main --------------------------------------------------- */ -.main { - position: relative; - min-height: calc(100vh - var(--header-height) - var(--footer-height)); - max-width: calc(var(--main-width) + var(--gap) * 2); - margin-left: auto; - margin-right: auto; - padding: var(--gap); -} -.page-header { - margin-bottom: 24px; -} -.page-header h1 { - font-size: 40px; -} -.pagination { - display: flex; -} -.pagination a { - color: var(--theme); - font-size: 13px; - line-height: 36px; - background: var(--primary); - border-radius: calc(36px / 2); -} -.pagination .prev { - padding-left: 16px; - padding-right: 18px; -} -.pagination .next { - margin-left: auto; - padding-left: 18px; - padding-right: 16px; -} -/* Post entry --------------------------------------------------- */ -.post-entry { - position: relative; - margin-bottom: var(--gap); - padding: var(--gap); - background: var(--entry); - border-radius: var(--radius); - transition: transform 0.1s; -} -.post-entry:active { - transform: scale(0.96); -} -.tag-entry .entry-content, -.tag-entry .entry-footer { - display: none; -} -.entry-header h2 { - font-size: 24px; -} -.entry-content { - margin-top: 8px; - margin-bottom: 8px; - color: var(--secondary); - font-size: 14px; - line-height: 1.6; - overflow: hidden; - display: -webkit-box; - -webkit-box-orient: vertical; - -webkit-line-clamp: 2; -} -.entry-footer { - color: var(--secondary); - font-size: 13px; -} -.entry-link { - position: absolute; - left: 0; - right: 0; - top: 0; - bottom: 0; -} -/* Post single --------------------------------------------------- */ -.post-header { - margin-top: 24px; - margin-bottom: var(--content-gap); -} -.post-title { - margin-bottom: 2px; - font-size: 40px; - transform: translateX(-2px); -} -.post-meta { - color: var(--secondary); - font-size: 14px; -} -.post-content { - color: var(--content); -} -.post-content h1 { - margin-top: 40px; - margin-bottom: 32px; -} -.post-content h2 { - margin-top: 32px; - margin-bottom: 24px; -} -.post-content h3, -.post-content h4, -.post-content h5, -.post-content h6 { - margin-top: 24px; - margin-bottom: 16px; -} -.post-content h1 { - font-size: 40px; -} -.post-content h2 { - font-size: 32px; -} -.post-content h3 { - font-size: 24px; -} -.post-content h4 { - font-size: 16px; -} -.post-content h5 { - font-size: 14px; -} -.post-content h6 { - font-size: 12px; -} -.post-content a { - box-shadow: 0 1px 0 var(--primary); -} -.post-content a code { - margin-left: 0; - margin-right: 0; - border-radius: 0; - box-shadow: 0 -1px 0 var(--primary) inset; -} -.post-content del { - text-decoration: none; - background: linear-gradient(to right, var(--primary) 100%, transparent 0) 0 50% / 1px 1px repeat-x; -} -.post-content p, -.post-content ul, -.post-content ol, -.post-content dl { - margin-bottom: var(--content-gap); -} -.post-content ul, -.post-content ol { - padding-left: 20px; -} -.post-content li { - margin-top: 5px; -} -.post-content li p { - margin-bottom: 0; -} -.post-content dl { - display: flex; - flex-wrap: wrap; - margin: 0; -} -.post-content dt { - width: 25%; - font-weight: 700; -} -.post-content dd { - width: 75%; - margin-left: 0; - padding-left: 10px; -} -.post-content dt ~ dt, -.post-content dd ~ dd { - margin-top: 10px; -} -.post-content table { - margin-bottom: 32px; -} -.post-content table th, -.post-content table:not(.highlighttable) td { - min-width: 80px; - padding: 12px 8px; - line-height: 1.5; - border-bottom: 1px solid var(--border); -} -.post-content table th { - font-size: 14px; - text-align: left; -} -.post-content table:not(.highlighttable) td code:only-child { - margin-left: 0; - margin-right: 0; -} -.post-content .highlight, -.post-content pre { - margin-left: calc(var(--gap) * -1); - margin-right: calc(var(--gap) * -1); - margin-bottom: 32px; - background: var(--hljs-bg) !important; - border-radius: var(--radius); - overflow-x: auto; -} -.post-content ul pre { - margin-left: calc(var(--gap) * -2); -} -.post-content .highlight pre { - margin: 0; -} -/* table */ -.post-content .highlighttable { - table-layout: fixed; -} -.post-content .highlighttable td:first-child { - width: 40px; -} -.post-content .highlighttable td .linenodiv { - padding-right: 0 !important; -} -.post-content .highlighttable td .linenodiv pre, -.post-content .highlighttable td .highlight { - margin-bottom: 0; -} -.post-content .highlighttable td .highlight pre code::-webkit-scrollbar { - display: none; -} -/* inline */ -.post-content .highlight span { - background: transparent !important; -} - -.post-content code { - margin-left: 4px; - margin-right: 4px; - padding: 4px 6px; - font-family: Menlo, Monaco, 'Courier New', Courier, monospace; - font-size: 0.78em; - line-height: 1.5; - background: var(--code-bg); - border-radius: 2px; -} -.post-content pre code { - display: block; - margin-left: 0; - margin-right: 0; - padding: var(--gap); - color: rgba(255, 255, 255, 0.8); - background: transparent; - border-radius: 0; -} -.post-content blockquote { - margin: 0 0 0 calc(var(--gap) * -1); - padding: 0 0 0 21px; - border-left: 3px solid var(--primary); -} -.post-content hr { - height: 1px; - margin-top: 56px; - margin-bottom: 56px; - background: var(--tertiary); - border-top: 0; - border-bottom: 0; -} -.post-content iframe { - max-width: 100%; -} -.post-tags li { - display: inline-block; -} -.post-tags li + li { - margin-left: 3px; -} -.post-tags a { - display: block; - padding-left: 14px; - padding-right: 14px; - color: var(--secondary); - font-size: 14px; - line-height: 34px; - background: var(--code-bg); - border-radius: 4px; -} -.post-tags a:hover { - background: var(--border); -} -/* Footer --------------------------------------------------- */ -.footer { - max-width: calc(var(--main-width) + var(--gap) * 2); - margin-left: auto; - margin-right: auto; - padding: calc((var(--footer-height) - var(--gap)) / 2) var(--gap); - color: var(--secondary); - font-size: 12px; - text-align: center; - line-height: 24px; -} -.footer span { - margin-left: 1px; - margin-right: 1px; -} -.footer a { - color: inherit; -} -.footer a:hover { - color: var(--primary); - border-bottom: 1px solid var(--primary); -} -/* 404 --------------------------------------------------- */ -.not-found { - position: absolute; - left: 0; - right: 0; - display: flex; - align-items: center; - justify-content: center; - height: 80%; - font-size: 160px; - font-weight: 700; -} diff --git a/docs/tags/conference/feed.xml b/docs/tags/conference/feed.xml deleted file mode 100644 index f536cbb..0000000 --- a/docs/tags/conference/feed.xml +++ /dev/null @@ -1,944 +0,0 @@ - - - - conference on REPL: Rest-Eat-Program Loop - https://blog.nsfisis.dev/tags/conference/ - Recent content in conference on REPL: Rest-Eat-Program Loop - Hugo -- gohugo.io - ja-JP - Sat, 27 Aug 2022 18:55:28 +0900 - - PHP カンファレンス沖縄で出題されたコードゴルフの問題を解いてみた - https://blog.nsfisis.dev/posts/2022-08-27/php-conference-okinawa-code-golf/ - Sat, 27 Aug 2022 18:55:28 +0900 - - https://blog.nsfisis.dev/posts/2022-08-27/php-conference-okinawa-code-golf/ - はじめに -

本日 PHP カンファレンス沖縄 2022 が開催された (らしい)。

-

カンファレンスには参加できなかったものの、懇親会の LT で出題されたコードゴルフの問題が Twitter に流れてきたので、解いてみた。

-

ツイート: https://twitter.com/m3m0r7/status/1563397620231712772
-スライド: https://speakerdeck.com/memory1994/php-conference-okinawa-2022-extra?slide=3

-

解

-

細かいレギュレーションは不明だったので、勝手に定めた。

-
    -
  • コマンドライン引数の第1引数で受けとる
    • -
  • 結果は標準出力に出す
    • -
  • コンマの直後にはスペースを1つ置く
    • -
  • 末尾コンマは禁止
    • -
  • 数字でないものは入ってこないものとする
    • -
  • 負数は入ってこないものとする
    • -
-

書いたものがこちら:

-
[<?php $n=$argv[1];foreach([1e4,5e3,2e3,1e3,500,100,50,10,5,1]as$x)for(;$n>=$x;$n-=$x)$r[]=$x;echo implode(', ',$r??[]);?>]
-

しめて 123 バイトとなった (末尾改行を含めずにカウント)。

-

こちらは改行とスペースを追加したバージョン:

-
[<?php
-
-$n = $argv[1];
-foreach ([1e4, 5e3, 2e3, 1e3, 500, 100, 50, 10, 5, 1] as $x)
-  for (; $n >= $x; $n -= $x)
-    $r[] = $x;
-echo implode(', ', $r ?? []);
-
-?>]
-

使用したテクニック

-

指数表記

-

割と多くの言語のゴルフで使えるテクニック。e を用いた指数表記で、大きな数を短く表す。このコードでは 10000、5000、2000、1000 を指数表記している。

-

foreach や for の中身を1つの文に

-

foreach、for、if などの後ろには、通常 { を続けて複数の文を連ねるが、中身の文を1つにしてしまえば、{ と } を省略できる。C言語などでも使える。

-

$r に初期値を入れない

-

PHP では、$r[] = ... のような配列の末尾に追加する式を実行したとき、$r が未定義だった場合は $r を勝手に定義して空の配列で初期化してくれる。これを利用すると、$r = []; のような初期化が不要になる。

-

ただし、プログラムに 0 が渡されるとループを一度も回らないので、$r が未定義になってしまい、implode() に渡すところでエラーになる。それを防ぐために $r ?? [] を使っている。

-

もし 0 が渡されたケースを無視するなら、これが不要になるので 4 バイト縮む。

-

PHP タグの外に文字列を置く

-

PHP では、<?php ?> で囲われた部分の外側にある文字列は、そのまま出力される。今回のケースでは、先頭と末尾に必ず [ と ] を出力するので、そのまま書いてやればよい。

-

おわりに

-

最後になりましたが、めもりー さん、楽しい問題をありがとうございました。

-]]> - - - - PHPerKaigi 2022 - https://blog.nsfisis.dev/posts/2022-05-01/phperkaigi-2022/ - Sun, 01 May 2022 09:41:39 +0900 - - https://blog.nsfisis.dev/posts/2022-05-01/phperkaigi-2022/ - はじめに -

2022-04-09 から 2022-04-11 にかけて開催された、PHPerKaigi 2022 に、一般参加者として参加した。 -弊社デジタルサーカス株式会社 はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。

-

昨年のレポートはこちら。

-

感想

-

厳選おすすめトーク

-

多くの素晴らしいトークの中から、特におすすめのものを 5つ選んだ。是非聞いてほしい。引用部分は、リンク先プロポーザルから引用している。

-

予防に勝る防御なし - 堅牢なコードを導く様々な設計のヒント

-
-

PHP はバージョンを追う毎に型宣言、例外、表明、列挙型などの機能が大幅に強化され、堅牢なコードを書くための機能が充実してきました。それらの機能はどう使うと効果的なのでしょうか。

-

本講演では PHP 8.1 をベースにして、誤りを想定してチェックするのではなく、そもそも誤りにくい設計とはどのようなものか、つまり「予防」の観点を軸足に、堅牢なコードを導くための様々な設計のヒントをご紹介します。

-
-

PHPのエラーを理解して適切なエラーハンドリングを学ぼう

-
-

PHPを使ってるとよく遭遇する Fatal error / Parse error / Warning / Notice 理解していますか？
-これらのエラー文を理解することで、すぐにエラーの原因に気付き適切に対象できる様になります！
-またそれらを理解した上でのエラーハンドリングを学びましょう。

-
-

エラー監視とテスト体制への改善作戦

-
-

毎日流れてくるエラーに皆さんはどう向き合ってますか？
-エラーを出さない事が一番ですが、完全に塞ぐ事は難しいと考えます。
-サービス運用の中で本番環境から発生するエラー（サーバー・クライアントサイド・サードパーティ起因のエラー）への監視体制と、
-エラー・バグ防御のためチームで行っているテストコード文化づくりの話をします。

-
-

ISUCON11のPHP実装は、何を考え、どのようにして作られていたのか

-
-

昨年開催されたISUCON11にて問題（参考実装）のPHPへの移植を担当させていただきました。

-

最終的なソースコードこそシンプルなWebアプリケーションではありますが、その裏には
-・「（私の思う）良い設計」を実現するための意思決定
-・「ISUCONの問題」という位置付けに由来する取捨選択
-・移植中に遭遇したトラブルとその解決策
-といった文脈や葛藤が存在しています。

-

本発表はそれらを共有することで
-・PHPアプリケーションの設計、実装事例として役立ててもらう
-・ISUCONの言語移植に興味を持ってもらう
-・ISUCON問題移植の「実装や設計の練習をする教材」としての可能性を知ってもらう
-ことを目的とします。

-
-

チームの仕事はまわっていたけど、メンバーはそれぞれモヤモヤを抱えていた話──40名の大規模開発チームで1on1ログを公開してみた

-
-

サイボウズの大企業向けグループウェアのGaroon（ガルーン）は、PHPで開発されている20年目の製品です。ガルーン開発チームは日本で40名、ベトナムで50名の計90名ほどのチームになっています。また、コロナ禍でフルリモートでの活動がこの2年ほど継続してきました。

-

フルリモートになっても仕事はまわっており、継続的にリリースはしていましたが、一方でお互いの考えていることや感じている問題意識が見えづらくなり、モヤモヤを抱えているメンバーが増えていました。

-

このセッションでは、そういう状況で私がチーム外からジョインし、聴き役に徹しながら見える化することで状況を改善していった取り組みを紹介します。同じように大きなチームやリモートワークで難しさを感じている人に、難しさの原因への気づきや取り組みへのヒントがあれば幸いです。

-
-

トークン問題の作成

-

今回は、PHPer チャレンジ用に弊社のトークン問題を 3題作成した。こちらについては別途記事にしているので、そちらを参照されたい。

-

PHPer チャレンジ

-

1位になった。
-また、賞品として Echo Show 15 をいただいた。

-

カンファレンス全体への感想

-

去年の参加レポ では、こんなことを書いた。

-
-

1つ個人的な反省点としては、(中略) Discord しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。
-まあ初カンファレンスだし、とお茶を濁しておこう。

-
-

この反省を踏まえ、今年は積極的にほかの場 (公式の Discord サーバや、アンカンファレンス) にも参加した。
-これにより、参加体験の質がはるかに向上した。特に Discord に関しては、登壇者ご本人による補足や、質問への回答などがおこなわれる (ことが多い) ため、特別な理由のない限り、発言はしないまでも参加はしておいたほうが良いと思われる。

-

なお、アンカンファレンスについては、1日目の終わりにトークン問題の解説放送もおこなった。

-

また、今年はオフラインとオンラインのハイブリッド開催であったが、去年の全オンラインと比べて、オンライン参加の体験が落ちていなかったのは、特筆すべきであろう。 -今年は 3回目のワクチン接種が間に合わなかったこともあり現地参加は見送ったのだが、来年は是非オフラインで参加したい。

-

そして来年へ……?

-

PHPerKaigi 2023 があるかどうか存じ上げないが、あるとすれば、次の 4つを目標としたい。

-
    -
  • プロポーザルを出す
    • -
  • PHPer チャレンジのトークン問題を 5題作成する
    • -
  • 現地に行く
    • -
  • PHPer チャレンジで圧勝する
    • -
-
-

最後になりましたが、PHPerKaigi のスタッフ、スポンサー、スピーカーのみなさん、素敵な時間をありがとうございました。

-

ではまた来年。

-]]> - - - - PHPerKaigi 2022 トークン問題の解説 - https://blog.nsfisis.dev/posts/2022-04-09/phperkaigi-2022-tokens/ - Sat, 09 Apr 2022 21:50:19 +0900 - - https://blog.nsfisis.dev/posts/2022-04-09/phperkaigi-2022-tokens/ - はじめに -

本日開始された PHPerKaigi 2022 の PHPer チャレンジにおいて、弊社 デジタルサーカス株式会社 の問題を 3問作成した。この記事では、これらの問題の解説をおこなう。

-

リポジトリはこちら: https://github.com/nsfisis/PHPerKaigi2022-tokens

-

第1問 brainf_ck.php

-

ソースコードはこちら。実行には PHP 8.1 以上が必要なので注意。

-
<?php
-
-declare(strict_types=0O1);
-
-namespace Dgcircus\PHPerKaigi\Y2022;
-
-/**
- * @todo
- * Run this program to acquire a PHPer token.
- */
-
-https://creativecommons.org/publicdomain/zero/1.0/
-
-\error_reporting(~+!'We are hiring!');
-
-$z = fn($f) => (fn($x) => $f(fn(...$xs) => $x($x)(...$xs)))(fn($x) => $f(fn(...$xs) => $x($x)(...$xs)));
-$id = \spl_object_id(...);
-$put = fn($c) => \printf('%c', $c);
-$mm = fn($p, $n) => new \ArrayObject(\array_fill(+!![], $n, $p));
-
-$👉 = fn($m, $p, $b, $e, $mp, $pc) => [++$mp, ++$pc];
-$👈 = fn($m, $p, $b, $e, $mp, $pc) => [--$mp, ++$pc];
-$👍 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, ++$m[$mp]];
-$👎 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, --$m[$mp]];
-$📝 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, $put($m[$mp])];
-$🤡 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) {
-    +!![] => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) {
-      $b => $loop(++$pc, ++$n),
-      $e => $n === +!![] ? ++$pc : $loop(++$pc, --$n),
-      default => $loop(++$pc, $n),
-    })($pc, -![])],
-    default => [$mp, ++$pc],
-};
-$🎪 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) {
-    +!![] => [$mp, ++$pc],
-    default => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) {
-      $e => $loop(--$pc, ++$n),
-      $b => $n === +!![] ? $pc+![] : $loop(--$pc, --$n),
-      default => $loop(--$pc, $n),
-    })($pc, -![])],
-};
-$🐘 = fn($p) => $z(fn($loop) => fn($m, $p, $b, $e, $mp, $pc) =>
-  isset($p[$pc]) && $loop($m, $p, $b, $e, ...($p[$pc]($m, $p, $b, $e, $mp, $pc)))
-)($mm(+!![], +(![].![])), $p, $id($🤡), $id($🎪), +!![], +!![]);
-
-$🐘([
-  $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-  $🤡,
-    $👉, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-    $👈, $👈, $👈, $👈, $👎,
-  $🎪,
-  $👉, $👍, $👍, $👍, $👍, $👍, $📝,
-  $👎, $👎, $📝,
-  $👉, $👎, $👎, $👎, $📝,
-  $👉, $👎, $👎, $👎, $📝,
-  $👎, $👎, $📝,
-  $👎, $📝,
-  $👈, $📝,
-  $👉, $👉, $👎, $👎, $📝,
-  $👍, $👍, $👍, $👍, $👍, $👍, $👍, $📝,
-  $👈, $👎, $👎, $👎, $👎, $📝,
-  $👈, $📝,
-  $👉, $👍, $👍, $📝,
-  $👉, $👎, $📝,
-  $👈, $📝,
-]);
-

この問題は、単に適切なバージョンの PHP で動かせばトークンが得られる。

-

解説

-

絵文字

-

まず目につくのは大量の絵文字だろう。 -PHP は識別子に使用できる文字の範囲が広く、絵文字も使うことができる。

-

プログラム全体

-

Brainf*ck のインタプリタとプログラムになっている。 -Brainf*ck とは、難解プログラミング言語のひとつであり、ここで説明するよりも Wikipedia の該当ページを読んだ方がよい。

-

https://ja.wikipedia.org/wiki/Brainfuck

-

なお、brainf*ck プログラムを普通の書き方で書くと、次のようになる。

-
+ + + + + + + + + +
-[
-  > + + +
-  > + + + + +
-  > + + + + + + + + + + + +
-  > + + + + + + + + + +
-  < < < < -
-]
-> + + + + + .
-- - .
-> - - - .
-> - - - .
-- - .
-- .
-< .
-> > - - .
-+ + + + + + + .
-< - - - - .
-< .
-> + + .
-> - .
-< .
-

実行結果はこちら: https://ideone.com/22VWmb

-

それぞれの絵文字で表された関数が、各命令に対応している。

-
    -
  • $👉: >
    • -
  • $👈: <
    • -
  • $👍: +
    • -
  • $👎: -
    • -
  • $📝: .
    • -
  • $🤡: [
    • -
  • $🎪: ]
    • -
-

, (入力) に対応する関数はない (このプログラムでは使わないので用意していない)。

-

なお、$🐘 はいわゆる main 関数であり、プログラムの実行部分である。

-

絵文字の選択

-

おおよそ意味に合致するよう選んでいるが、$🤡 と $🎪 は弊社デジタルサーカスにちなんでいる。 -また、$🐘 は PHP のマスコットの象に由来する。

-

strict_types

-

declare 文の strict_types に指定できるのは、0 か 1 の数値リテラルだが、 -0x0 や 0b1 のような値も受け付ける。 -今回は、PHP 8.1 から追加された、0O または 0o から始まる八進数リテラルを使った。

-

URL

-

ソースコードのライセンスを示したこの部分だが、

-
https://creativecommons.org/publicdomain/zero/1.0/
-

完全に合法な PHP のコードである。 -https: 部分はラベル、// 以降は行コメントになっている。

-

リテラルなしで数値を生成する

-

ソースコード中に、ほとんど数値リテラルが書かれていないことにお気づきだろうか。 -PHP では、型変換を利用することで任意の整数を作り出すことができる。

-
assert(0 === +!![]);
-assert(1 === +![]);
-assert(2 === ![]+![]);
-assert(3 === ![]+![]+![]);
-assert(10 === +(![].+!![]));
-

[] に ! を適用すると true が返ってくる。それに + -を適用すると、bool から int ヘの型変換が走り、1 が生成される。10 -はさらにトリッキーだ。まず 1 と 0 を作り、. で文字列として結合する -('10')。これに + を適用すると、string から int -への型変換が走り、10 が生まれる (コード量に頓着しないなら、1 を 10 -個足し合わせてももちろん 10 が作れる)。

-

また、error_reporting に指定しているのは -1 である。 -これは、! によって文字列を false にし、+ によって false を 0 にし、さらにビット反転して -1 にしている。

-

if 文なしで条件分岐

-

三項演算子ないし match 式を使うことで、if を一切書かずに条件分岐ができる。 -また、&& / || も使えることがある。 -遅延評価が不要なケースでは、[$t, $f][$cond] のような形で分岐することもできる。

-

while、for 文なしでループ

-

不動点コンビネータを使って無名再帰する (詳しい説明は省略する。これらの単語で検索してほしい)。 -ここでは、一般に Z コンビネータとして知られるものを使った ($z)。

-

実際のところ、$🤡 や $🎪、$🐘 は、一度 Scheme (Lisp の一種) で書いてから PHP に翻訳する形で記述した。

-

なお、PHP は末尾再帰の最適化をおこなわない (少なくとも今のところは) ので、 -あまりに長い brainf*ck プログラムを書くとスタックオーバーフローする。

-

第2問 riddle.php

-

ソースコードはこちら。実行には PHP 8.0 以上が必要なので注意。

-
<?php
-
-/*********************************************************
- * This program displays a PHPer token.                  *
- * Guess 'N'.                                            *
- *                                                       *
- * Hints:                                                *
- * - N itself has no special meaning, e.g., 42, 8128,    *
- *   it is selected at random.                           *
- * - Each element of $token represents a single letter.  *
- * - One letter consists of 5x5 cells.                   *
- * - Remember, the output is a complete PHPer token.     *
- *                                                       *
- * License:                                              *
- *   https://creativecommons.org/publicdomain/zero/1.0/  *
- *********************************************************/
-const N = 0 /* Change it to your answer. */;
-assert(0 <= N && N <= 0b11111_11111_11111_11111_11111);
-
-$token = [
-  0x14B499C,
-  0x0BE34CC, 0x01C9C69,
-  0x0ECA069, 0x01C2449, 0x0FDB166, 0x01C9C69,
-  0x01C1C66, 0x0FC1C47, 0x01C1C66,
-  0x10C5858, 0x1E4E3B8, 0x1A2F2F8,
-];
-foreach ($token as $x) {
-  $x = $x ^ N;
-
-  $x = sprintf('%025b', $x);
-  $x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-  $x = implode("\n", str_split($x, length: 5));
-  echo "{$x}\n\n";
-}
-

さて、この問題はさきほどのように単純に実行しただけでは、謎のブロックが表示されるだけでトークンは得られない。 -トークンを得るためには、ソースコードを読み、定数 N を特定する必要がある。

-

ここでは、私の想定解を解説する。

-

読解

-

まずはソースコードを読んでいく。

-
$token = [
-  // 略
-];
-

数値からなる $token があり、各要素をループしている。

-
  $x = $x ^ N;
-

まずは排他的論理和 (xor) を取り、

-
  $x = sprintf('%025b', $x);
-

二進数に変換して、

-
  $x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-

0 を空白に、1 を # にし、

-
  $x = implode("\n", str_split($x, length: 5));
-

5文字ごとに区切ったあと、改行で結合している。

-

ヒント

-

次に、ソースコードに書いてあるヒントを読んでいく。

-
    -
  • N それ自体は、42 や 8128 といったような特別な意味を持たず、ランダムに決められている
    • -
  • $token の各要素は、1文字を表す
    • -
  • 1文字は 5x5 のセルからなる
    • -
  • 出力されるのは、完全な PHPer トークンである
    • -
-

ここで、PHPer トークンは必ず # 記号から始まることを思いだすと、 -$token の最初の数字 0x14B499C は、変換の結果 # になるのではないかと予想される (なお、このことは、リポジトリの README ファイルに追加ヒントとして書かれている)。

-

解く

-

ここまでわかれば、あと一歩で解ける。すなわち、0x14B499C が # に変換されるような N を見つければよい。

-

N は高々

-
assert(0 <= N && N <= 0b11111_11111_11111_11111_11111);
-

なのでブルートフォースしてもよいが、ここではブルートフォースしない方法を紹介する。

-
<?php
-
-$x = 0x14B499C;
-
-$x = $x ^ N;
-
-$x = sprintf('%025b', $x);
-$x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-$x = implode("\n", str_split($x, length: 5));
-
-assert($x ===
-  " # # \n" .
-  "#####\n" .
-  " # # \n" .
-  "#####\n" .
-  " # # ");
-

この一連の変換に対する逆変換を考えると、次のようになる。

-
<?php
-
-$x =
-  " # # \n" .
-  "#####\n" .
-  " # # \n" .
-  "#####\n" .
-  " # # ";
-
-$x = implode('', explode("\n", $x));
-$x = str_replace(search: [' ', '#'], replace: ['0', '1'], subject: $x);
-$x = bindec($x);
-
-$n = $x ^ 0x14B499C;
-
-echo "N = $n\n";
-

これを実行すると、N が得られる。

-

第3問 toquine.php

-

ソースコードはこちら。

-
<?php
-
-// License: https://creativecommons.org/publicdomain/zero/1.0/
-// This is a quine-like program to generate a PHPer token.
-// Execute it like this: php toquine.php | php | php | php | ...
-
-$s = <<<'Q'
-<?cuc
-// Yvprafr: uggcf://perngvirpbzzbaf.bet/choyvpqbznva/mreb/1.0/
-// Guvf vf n dhvar-yvxr cebtenz gb trarengr n CUCre gbxra.
-// Rkrphgr vg yvxr guvf: cuc gbdhvar.cuc | cuc | cuc | cuc | ...
-%f$f = %f;
-$f = fge_ebg13($f); $kf = [
-%f,
-];
-$g = ahyy.snyfr; sbe ($v = 0; $v <= vagqvi(__YVAR__-035,6); ++$v) vs (!vffrg($kf[$v])) oernx; ryfr
-$g .= vzcybqr("\a", fge_fcyvg(fge_ercynpr(['0','1'], ['  ','##'], fcevags(pue(37) . '025o', $kf[$v])), 012)) . "\a\a";
-$jf = neenl_znc(sa($j) => vzcybqr(', ', $j), neenl_puhax(neenl_znc(sa($k) => fcevags('0k' . pue(37) . '07K', $k), $kf), 10));
-cevags($f, $g, fge_ebg13("<<<'Q'\a{$f}\aQ"), vzcybqr(",\a", $jf));
-Q;
-$s = str_rot13($s); $xs = [
-0x0AFABEA, 0x1F294A7, 0x1F2109F, 0x1F294A7, 0x0002800, 0x1F2109F, 0x0117041, 0x1F294A7, 0x1FAD6B5, 0x1F295B7,
-0x010FC21, 0x1FAD6B5, 0x1151151, 0x010FC21, 0x1F294A7, 0x1F295B7, 0x1FAD6B5, 0x1F294A7, 0x1F295B7, 0x1F8C63F,
-0x1F8C631, 0x1FAD6B5, 0x17AD6BD, 0x17AD6BD, 0x1F8C63F, 0x1F295B7,
-];
-$t = null.false; for ($i = 0; $i <= intdiv(__LINE__-035,6); ++$i) if (!isset($xs[$i])) break; else
-$t .= implode("\n", str_split(str_replace(['0','1'], ['  ','##'], sprintf(chr(37) . '025b', $xs[$i])), 012)) . "\n\n";
-$ws = array_map(fn($w) => implode(', ', $w), array_chunk(array_map(fn($x) => sprintf('0x' . chr(37) . '07X', $x), $xs), 10));
-printf($s, $t, str_rot13("<<<'D'\n{$s}\nD"), implode(",\n", $ws));
-

コメントにもあるとおり、次のようにして実行すれば答えがでてくる。

-
$ php toquine.php | php | php | php | ...
-

実際にはもう少しパイプで繋げなければならない。

-

解説

-

プログラム全体

-

コメントにもあるとおり、これは quine (風) のプログラムになっている。 -Quine とは、自分のソースコードをそっくりそのまま出力するようなプログラムのことである。

-

このプログラムは、実行すると自身とほとんど同じプログラムを出力する。 -異なるのはトークンになっている部分のみである。

-

トークン

-

$xs がトークンに対応している。変換のロジックは riddle.php とほぼ同じなので省略する。

-

状態保持

-

トークンの何文字目まで出力したかを、ソースコードを変えずに (quine なので) 覚えておく必要がある。 -このプログラムでは、トークンが出力されるとソースコードがだんだんと長くなっていくのを利用して、__LINE__ から情報を取得している。

-

ROT 13

-

Quine は、素朴に書くとプログラムの一部が 2回記述されてしまう。 -これがあまり美しくないので、toquine.php では、ROT 13 変換を使って難読化した。

-

それにしてもなぜこんなものが標準ライブラリに……。

-

おわりに

-

解いていただいたみなさん、また、難易度調整につきあっていただいた社内のみなさん、ありがとうございました。

-

今回は直前に作りはじめたのもあり、3問だけかつ使い古されたネタばかりになってしまいましたが、 -来年は 5問、より面白い問題を持っていきます。

-

実はもう作りはじめているので、どうか来年もありますように……。

-]]> - - - - PHPerKaigi 2021 - https://blog.nsfisis.dev/posts/2021-03-30/phperkaigi-2021/ - Tue, 30 Mar 2021 23:22:40 +0900 - - https://blog.nsfisis.dev/posts/2021-03-30/phperkaigi-2021/ - PHPerKaigi 2021 参加レポ -

2021-03-26 から 2021-03-28 にかけて開催された、PHPerKaigi 2021 に一般参加者として参加した。 -弊社デジタルサーカス株式会社 (今年1月から勤務) はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。

-

このようなカンファレンスには初めて参加するのでかねてより心待ちにしていたのだが、生憎2日目から体調を崩してしまい、この記事も途中までとなっている。まだ見ていないセッションも多いが、ひとまず現時点での参加レポを書いておく。

-

発表はトラック A、B に分かれていたのだが、今回はすべて A トラックを視聴している (切り替えるのが面倒だっただけ)。

-

凡例

-
-

発表・スライドのメモ (引用ではない)

-
-

感想など

-

Day 0 前夜祭 (2021/03/27)

-

17:30 [A]

-

PHP で AWS Lambda

-
-

Rails のプロジェクトを PHPer のメンバのみでメンテ -→他のメンバもわかる PHP にリプレースを検討

-

サーバレス

-
    -
  • サーバ・インフラの管理が不要
    • -
  • アプリケーションコードの知識だけで保守可能
    • -
-

ゼロベースで作れる案件が (Railsの件とは別に) あるため、そちらで試験的に導入?

-

AWSの学習 -AWS のドキュメント -DevelopersIO

-

AWS Lambda のカスタムランタイムで PHP を動かす

-

サーバのセットアップや維持管理を気にしなくて良い -サーバーレスで PHP を動かすツールがすでにある -サーバーレス構築はすんなり

-

今は Laravel がルーティングしている -Laravel Livewire を Lambda に載せられないか？ -デプロイ方法は？ -バッチ処理は？ (Lambda は 15分の制限)

-

Lambda でコンテナイメージがサポートされるように

-

抽象化されたもの「だけ」しか知らないよりも具象の理解は助けになる

-
-

AWS Lambda のような Function as a Service はマイクロサービス化における一つの到達点に思えるのだが、これを使って実際に web サービスを作る具体的なイメージがまだ見えない (注: すべて for me として書いている)。

-

PHP on AWS Lambda があれだけ簡単に動かせるのには驚いた。

-

勝手に AWS Lambda だとフットプリントの軽さが求められそう (= PHP + Laravel などでは動かなさそう) だという先入観を持っていたのだが、この発表のデモによればそうでもないらしい。

-

18:10 [A]

-

大規模サイトの SEO

-
-

大規模サイト (100万ページ以上) -Google の基準

-

クロールバジェットを意識したSEO

-

大規模サイトでコンテンツが中頻度 (1回/週) で更新 OR 中規模サイト (10,000以上) でコンテンツが目まぐるしく変更される -これを満たさないなら、クロールバジェットを考えなくてもいい

-

サーチコンソール -「カバレッジ」の「除外」 -多すぎるのは問題→クロールバジェットを浪費している

-
    -
  • クエリの順番を決める
    • -
  • 空の値のルールを決めておく
    • -
  • リダイレクトすればインデックスはうまくいく
    • -
  • リンクが存在する限りクロールはされる
    • -
-

リニューアル前のURL

-

インデックスは移行される -リンクのURLが存在する限り、別のURLとしてクロールされる -リダイレクトされるとはいえ、リニューアル前のURLは移行した方が良い -リニューアルで無視されるようになったパラメータも注意

-

robotes.txt で拒否しているのにクロールされる -一時的に拒否を外して 404 や 301 を読ませる -内部リンクを確認する -JS でのリンクに書き換え

-

クエリパラメータからURLのパスに -/tokyo?area=HOGE → /tokyo/HOGE

-

URL 設計だいじ

-
-

SEO (Search Engine Optimization) は大して知らないので新鮮な話が多かった。その分語れることも少ない……。

-

18:50 [A]

-
-

知覚可能 -操作可能 -理解可能 -堅牢 ちゃんとしたHTMLを書く (閉じタグ・入れ子構造など)

-
    -
  • -

    標準の HTML を適切に使う

    -
    • -
  • -

    WAI-ARIA

    -
    • -
  • -

    キーボードフレンドリー

    -
    • -
  • -

    マシンフレンドリー

    -
    • -
  • -

    SEOフレンドリー

    -
    • -
-

button タグ -→キーボード -h1 タグ -→スクリーンリーダー・クローラ -a タグ

-

WAI-ARIA -HTML では表現できないセマンティクスを追加する

-
    -
  • ロール -
      -
    • 何をするのか？
      • -
    • ユーザーアクションによって変化しない
      • -
    -
    • -
  • プロパティ -
      -
    • 関連づけられたデータ
      • -
    -
    • -
  • ステート -
      -
    • 現在の状態
      • -
    -
    • -
-

まずは標準の HTML 要素で解決する -何でもかんでも WAI-ARIA を使えばいいというものではない

-

マウスホバーでツールチップが出てくるが、キーボード操作では出てこない

-

VoiceOver

-

全ての属性を使う必要はない -あくまでアクセシビリティを上げるための方法の一つにすぎない

-
-

つい最近 WAI-ARIA についての記事を読んだばかりだったので個人的にタイムリーな話題だった。(あまりこの言葉を使いたくないのだが) いわゆる「健常者」にとって、こうした問題を普段の生活の中で意識するのは難しい。だからこそ情報へのアンテナは張っておくようにしたい。

-

19:30 [A]

-

PHP で FUSE

-

個人的に楽しみだった発表。

-
-

VFS (virtual filesystem) vs 具体的なファイルシステム

-

最適な実装方法は状況により異なる

-

アプリケーションに見せるAPIは変えずに実装を隠蔽する→VFS

-

カーネルのプログラムを作るのは難しい

-
    -
  • 権限がデカすぎる
    • -
  • システム全体がクラッシュ
    • -
  • セキュリティリスク
    • -
  • 開発サイクルを回しづらい
    • -
  • ネイティブコードにコンパイルされる言語である必要がある
    • -
-

Filesystem in USEr space (FUSE)

-
    -
  • 特定の C の関数を呼ぶことで filesystem が作れる
    • -
  • FFI を持つ言語なら FUSE が使える
    • -
-

SSHFS / s3fs / Docker Desktop

-

Linux 以外でも使える

-
    -
  • dokany (on Windows)
    • -
  • osxfuse
    • -
-

VFS: システムコールが呼ばれると、ファイルシステムによってコール -FUSE: カーネル空間からユーザ空間へ通信

-

高レベルなラッパで型をつける

-

PHP 以外では Wordpress を FUSE にマウントする実装がある (C, Python など)

-
    -
  • grep できる
    • -
  • sed できる
    • -
  • 編集できる
    • -
-
-

期待通りの興味深い発表だった。FUSE 自体も今回の発表で知ったのだが、これ本体の実装を見るのも面白そうだ。 -この発表を聞きながらファイルシステムにマウントできそうなものを考えていたのだが、およそ木構造をしているものすべてと言えそうだ (ハンマーしか持っていないと云々)。何かできそうだがなかなか思いつかない。

-

Day 1 (2021/03/27)

-

10:50 [A]

-

ATDD

-
-
    -
  • ユーザーストーリー
    • -
  • ユニットテスト
    • -
  • CI/CD
    • -
-

ユーザストーリーの受け入れ条件が曖昧になりがち -デグレチェックがユニットレベルでは収まらない場合、手動で同じシナリオをテストしている

-

Q2の強化 -アジャイルテストの4象限

-

技術面/ビジネス面 -開発チーム支援(コーディング前・コーディング中)/製品批評(コーディング後)

-
    -
  • Q1: 技術面 & チーム支援 -
      -
    • TDD
      • -
    • ユニットテストなど
      • -
    -
    • -
  • Q2: ビジネス面 & チーム支援 -
      -
    • ATDD
      • -
    • ビジネス面の受け入れテストで駆動する
      • -
    -
    • -
-

Agile Alliance -ユーザストーリーのスキルレベルを高める

-

テストピラミッド

-
    -
  • -

    UI Tests

    -
    • -
  • -

    Service Tests

    -
    • -
  • -

    Unit Tests

    -
    • -
  • -

    異なる粒度のテストを書く

    -
    • -
  • -

    高レベルになるほど、持つべきテストは少なくなる

    -
      -
    • ピラミッド型になる
      • -
    -
    • -
-

高レベルテストが多すぎる→アイスクリームコーン　アンチパターン

-

ATDD (Acceptance TDD) -API経由・UI経由での高レベルテスト E2E test

-

ストーリ受け入れテスト

-

入れ子のフィードバックループ -ATDD(外側) と TDD(内側)

-

外部品質・内部品質

-

バーティカルスライスのデリバリー

-
    -
  • cucumber
    • -
  • gauge
    • -
  • behat
    • -
-

ユビキタス言語 -手動テストもspecに書く -自動化は可能だがコスパが悪い -失敗することがわかっているテスト(レッドテスト)はCIから外す -失敗時の原因究明が難しい -饒舌なエラーメッセージ -状況のスナップショット

-

Continuous Testing

-
-

User Acceptance Test (UAT) くらいの規模になると個人開発・趣味開発では触れない領域なので、大いに勉強になった。スライドに添付されている資料が相当に充実していたので、これを読むのが本番といった様相すら感じる。 -高レベルテストの自動化は現在のプロジェクトでも感じており、自動化のチャンスは伺っている。とはいえセッションでも指摘されているように自動化することにコストがかかりすぎる領域があるのも事実で、そのバランスが難しい。

-

11:50 [A]

-

型解析を用いたリファクタリング

-

型のある世界で生きてきた身として大いに楽しみにしていた発表。

-
-
    -
  • PHPStan
    • -
  • Phan
    • -
  • Psalm
    • -
-

autoload も認識できる -bootstrapFiles

-

編集箇所と利用箇所を CI でチェック -ルールレベルを徐々に引き上げていく -警告が多すぎると見落としてしまう・無視されやすくなる

-

型がついていないことによるエラーが多い

-

型よりも詳細な検査 Util_Assert::min

-

SQL を静的解析 -placeholder の型付け

-

警告レベルを低いレベルから導入 -タイプヒントを積極的に書いていく -PHPStan の拡張を追加する

-
-

昨今、動的型付き言語での型宣言・型アノテーション・型ヒントの導入が相次いでいる。長らく静的型付き言語を書いてきた私からすると、ようやく気づいたかといったところだが、ともかく型を導入する言語が増えてきた。 -今のプロジェクトでも新しく追加するコードには型をつけるよう努めているが、どうしても古いコードには型がついていない。個人的には型のないコードに対してどう型を自動的に付けるかという点に興味があり、その点で Ruby の typeprof には注目している。

-

12:30 [A]

-

昼食をとっていた。事前に何か食料を買っておくべきだった。

-

13:10 [A]

-

Documentation as Code

-

この発表も以前から非常に楽しみにしていた。

-
-

開発開始までのオーバーヘッド -新規にチームにジョイン -担当範囲外の機能を理解 -オンボーディングのコスト

-

PHPerKaigi 2020 で発表あり

-

継続的にシステムの理解を助けるドキュメント

-

継続的ドキュメンテーション -システムとドキュメントの乖離

-

書いてあることが間違っている・足りない

-
    -
  • 徐々にずれていく
    • -
  • システムの更新タイミングとドキュメントの更新タイミングに差がある
    • -
-

システムとドキュメントは対応関係がある

-
    -
  • 間違ったドキュメント
    • -
  • 存在しないドキュメント
    • -
-

システムとドキュメントの乖離を定量化する -継続的に -システムの更新に近いタイミングで ドキュメントを更新し続ける

-

Documentation as Code

-

コードと同じツールでドキュメントを書く

-
    -
  • issue tracker
    • -
  • vcs
    • -
  • plain text markup
    • -
  • automation
    • -
-

開発者 -システム -ドキュメント -構造化データ -ソフトウェア

-

システムから構造化データを抽出する -PHPDoc -OpenAPI

-

ビュー 関心ごとに合わせてアーキテクチャを一つ以上の側面(断面)で説明する

-

ビューの単位でドキュメントに

-

スタックトレースからのドキュメント生成

-
-

ドキュメントの管理は現プロジェクトでも課題と感じている。作られた当初は正しくても、実態と乖離していくのを止めるのは困難を極める。全体的に興味深い発表だったが、特にスタックトレースからのドキュメント生成というアイデアに惹かれるものを感じた。スタックトレースという実態と不可分な (乖離しない) 情報を起点にするのは理にかなっている。問題はトレースをいつ、どう取るかだろうか。それを自動化しなければ、実態との乖離が避けられないだろう。

-

14:10 [A]

-

cookie による session 管理

-

全体的に基本的な話だったので特に触れない。Cookie やセッションの話としては非常に分かりやすくまとめられていたので、知らない人が学ぶにはいい教材だろう。

-

14:50 [A]

-

PHP のエラーと例外

-
-

エラー PHPエンジンがエラーを通知する -例外 プログラムが投げる

-

PHP7-8とエラー

-

PHPエンジンのエラーの一部が \Error に変換されるようになった -→ try-catch で捕捉できる

-

\Error は例外とは異なる

-

PHP8 でエラーレベルの引き上げ

-
    -
  • 捕捉すべきもの -
      -
    • recoverable
      • -
    -
    • -
  • 捕捉すべきでないもの -
      -
    • unrecoverable
      • -
    • 開発時に対処できるもの
      • -
    -
    • -
-

例外

-
    -
  • 捕捉して事後処理
    • -
  • 捕捉せず(or 捕捉した上で)さらに上に是非を問う
    • -
-

開発段階で例外を把握し、ハンドリングを考えておく

-

\Throwable \Exception と \Error

-

\Error はキャッチすべきでない

-
    -
  • -

    \Error

    -
      -
    • 本番で起きてはいけない
      • -
    -
    • -
  • -

    \LogicException

    -
      -
    • 本番で起きてはいけない -→生じないのだから捕捉もしない
      • -
    -
    • -
  • -

    \RuntimeException

    -
      -
    • 起こるかもしれないので本番環境でも考慮する
      • -
    -
    • -
-

捕捉して対応するのではなく、未然に防ぐ

-

独自例外を使う -\Exception を投げてしまうと、 -catch (\Exception)せざるを得ない -→catch 範囲が広すぎる

-

SPL の例外を使う

-

例外翻訳 -上位のレイヤが下位のレイヤの例外を捕捉し、上位レイヤのAPIに「翻訳」する -下位レイヤの知識に依存させない

-

@throws -捕捉してほしい例外を書き連ねておく

-

呼び出しもとに負わせたい責任

-
-

PHP を学んでいる途中の私としては、今まさに聞きたい発表だった (現時点で PHP を書き始めてから 4ヶ月ほどになる)。

-

個人的に例外やエラーを最もうまく扱っているのは Go、Swift、Rust、Haskell などのエラーを「値として」扱う言語だと思っている。try-catch は通常の処理フローを完全に壊してしまう上、構文としても重すぎる。値としてのエラー通知は C言語時代への回帰ともいえるが、その頃と異なるのはエラーを暗黙のうちに握り潰すことがないということだ。これらの言語は型を持っており、静的に検証ができる (C のそれはまともな型付けではない。念のため)。

-

PHP のように、すでに例外が言語システムに根ざしている言語ではどうすればよいか。この場合も同じく静的検証の力を借りることになるだろう。

-

15:30 [A]

-

Laravel のメール認証

-

Laravel の知識がない私にはまったくついていけなかった。また、個人的にタイトルがややミスリーディングに感じた。

-

16:10 [A]

-

gRPC

-
-

Unary RPCs -Server streaming RPCs -Client streaming RPCs -Bidirectional streaming RPCs

-

Protobuf

-

実装とAPIが乖離しにくい -自動生成 -複数言語でも相互に使える

-

マイクロサービスのサービス通信 -スマホアプリ -ゲームサーバ

-

PHP では？

-

PHP ではストリーミングが難しい -リクエストごとにプロセスが使い捨て

-

PHP ではgRPCのクライアントしか対応していない

-

gRPC-Web -ブラウザで扱うためのJSライブラリ+プロトコル

-

HTTP/1.1 でも使える -Unary RPC と Server streaming RPC のみ

-

Envoy -Nginx などで相互に gRPC と gRPC-Web で変換

-

Amp -イベント駆動な並行処理のフレームワーク

-

HTTP/2 対応

-

C#のgRPC-Webが楽

-
-

(発表の中でもまさに同じことをおっしゃっていたが) PHP 以外の方が向いているだろう、というのが第一の感想である。gRPC はそれ自体というよりも Protobuf というエコシステムに乗れることのメリットが大きいと感じる。そのエコシステムにうまく乗れない時点で、うーんという感じ。

-

16:50 [A]

-

アーキテクチャテスト

-
-

Independent Core Layer Pattern

-

開発初期のアーキテクチャが崩れる -アーキテクチャ観点のコードレビューができない

-

どこにクラスを置けばよいか？ -ドキュメントがない

-

アーキテクチャ設計に関する知識が属人化・暗黙知化

-

ガイドライン

-
    -
  • 最初にルールを決めるのは簡単
    • -
  • ルール通り作り始めるのも簡単 -
      -
    • →維持するのが難しい、人が決めたものゆえ壊れやすい
      • -
    -
    • -
-

PHP の特性

-
    -
  • クラスは public
    • -
  • 可視性の制御が public / protected / private のみ
    • -
  • 依存関係の制御が困難
    • -
-

アーキテクチャテスト -クラスの依存関係や実装ルールをコードとして表現し、自動テスト化する

-
    -
  • deptrac
    • -
  • phpat
    • -
-

Independent Core Layer Pattern

-

アーキテクチャテストの失敗

-
    -
  • 実装誤り
    • -
  • or アーキテクチャが適切でない -
      -
    • 開発の過程でフィードバックしていく
      • -
    -
    • -
-

モジュラーモノリス→マイクロサービスへ

-
-

Day 2 (2021/03/28)

-

冒頭に書いた通り、2日目から体調が悪くまともに聴けていない。途中までは頭痛を我慢しつつ見ていたのだが、まともに入ってこなかった。

-

残念ではあるが、いずれにせよ見られていない発表は他にもあるので、今週末にでもまとめて見ようと思う。

-

全体の感想

-

Day 2 にほとんど参加できなかったのは残念だが、イベント自体は大変楽しく、また興味深いものであった。自分がまったく知らない領域の話を聞けるのはこうしたイベントならではだと感じる。オンライン開催ゆえ現地に行く必要がなく、気軽に参加できたのも (特に初参加者として) 嬉しいポイントだった。

-

今回、雑談/登壇者への質問等向けに Discord サーバもあったのだが、こちらは参加こそしたものの ROM のままになってしまった。発表に1ウィンドウ、メモを書くのに1ウィンドウ、Discord 表示に 1ウィンドウで私にはもう脳のリソースとディスプレイのスペースが追いつかなかった (さらにいうと Zoom でアンカンファレンスもやっていたようだ。こちらはまったく参加していない)。

-

1つ個人的な反省点としては、一つ一つのセッションを真剣に聞き過ぎたというものがある。もっと適当に聞いておけばよかった。これだけだと大変語弊があるのだが、言い方を変えると、Discord しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。 -まあ初カンファレンスだし、とお茶を濁しておこう。

-

さて、カンファレンスで一つ気になったことがある。それは、Discord という書き込み場所が増えたことでニコ生のコメントの流量が吸い取られてしまったのではないか、という点だ。ニコニコだけ見ていると過疎っているかのように見えた発表も、Discord の方では盛り上がっている、というのを何度か見かけた。ニコニコのコメント方式は盛り上がりを如実に反映するが、逆もまたしかり。Discord があったこと自体はプラスだったと思うが、この点はマイナスだったのではないかと感じる。

-
-

最後になりましたが、毎年の PHPerKaigi 開催にご尽力されている皆様、スピーカーの皆様、楽しい3日間でした。ありがとうございました！ -(ずっと常体で書いてしまったのでいきなり仏頂面から笑顔になったようで気持ち悪い)

-

ではまた来年。

-]]> - - - - diff --git a/docs/tags/conference/index.html b/docs/tags/conference/index.html deleted file mode 100644 index 40c8675..0000000 --- a/docs/tags/conference/index.html +++ /dev/null @@ -1,92 +0,0 @@ - - - - - - - - conference | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -

conference

- -
-
-

PHP カンファレンス沖縄で出題されたコードゴルフの問題を解いてみた

-
-
-

PHP カンファレンス沖縄の懇親会 LT で出題されたコードゴルフの問題を解いてみた。

-
-
- Posted on -
- -
-
-
-

PHPerKaigi 2022

-
-
-

2022-04-09 から 2022-04-11 にかけて開催された、PHPerKaigi 2022 に参加した。

-
-
- Posted on -
- -
-
-
-

PHPerKaigi 2022 トークン問題の解説

-
-
-

PHPerKaigi 2022 で私が作成した PHPer チャレンジ問題を解説する。

-
-
- Posted on , updated on -
- -
-
-
-

PHPerKaigi 2021

-
-
-

2021-03-26 から 2021-03-28 にかけて開催された、PHPerKaigi 2021 に参加した。

-
-
- Posted on -
- -
- - - - - - diff --git a/docs/tags/conference/page/1/index.html b/docs/tags/conference/page/1/index.html deleted file mode 100644 index 740f29e..0000000 --- a/docs/tags/conference/page/1/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - - https://blog.nsfisis.dev/tags/conference/ - - - - - - diff --git a/docs/tags/cpp/feed.xml b/docs/tags/cpp/feed.xml deleted file mode 100644 index 435e2f9..0000000 --- a/docs/tags/cpp/feed.xml +++ /dev/null @@ -1,89 +0,0 @@ - - - - cpp on REPL: Rest-Eat-Program Loop - https://blog.nsfisis.dev/tags/cpp/ - Recent content in cpp on REPL: Rest-Eat-Program Loop - Hugo -- gohugo.io - ja-JP - Sat, 02 Oct 2021 09:38:30 +0900 - - [C++] 属性構文の属性名にはキーワードが使える [[void]] [[for]] - https://blog.nsfisis.dev/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes/ - Sat, 02 Oct 2021 09:38:30 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/94090937bcf860cfa93b

-
-

タイトル落ち。まずはこのコードを見て欲しい。

-
#include <iostream>
-
-[[alignas]] [[alignof]] [[and]] [[and_eq]] [[asm]] [[auto]] [[bitand]]
-[[bitor]] [[bool]] [[break]] [[case]] [[catch]] [[char]] [[char16_t]]
-[[char32_t]] [[class]] [[compl]] [[const]] [[const_cast]] [[constexpr]]
-[[continue]] [[decltype]] [[default]] [[delete]] [[do]] [[double]]
-[[dynamic_cast]] [[else]] [[enum]] [[explicit]] [[export]] [[extern]] [[false]]
-[[final]] [[float]] [[for]] [[friend]] [[goto]] [[if]] [[inline]] [[int]]
-[[long]] [[mutable]] [[namespace]] [[new]] [[noexcept]] [[not]] [[not_eq]]
-[[nullptr]] [[operator]] [[or]] [[or_eq]] [[override]] [[private]]
-[[protected]] [[public]] [[register]] [[reinterpret_cast]] [[return]] [[short]]
-[[signed]] [[sizeof]] [[static]] [[static_assert]] [[static_cast]] [[struct]]
-[[switch]] [[template]] [[this]] [[thread_local]] [[throw]] [[true]] [[try]]
-[[typedef]] [[typeid]] [[typename]] [[union]] [[unsigned]]
-[[virtual]] [[void]] [[volatile]] [[wchar_t]] [[while]] [[xor]] [[xor_eq]]
-// [[using]]
-int main() {
-    std::cout << "Hello, World!" << std::endl;
-}
-
-

コンパイラのバージョン -$ clang++ –version -Apple clang version 11.0.0 (clang-1100.0.33.8) -Target: x86_64-apple-darwin19.6.0 -Thread model: posix -InstalledDir: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin

-

コンパイルコマンド (C++17指定) -$ clang++ –std=c++17 hoge.cpp

-
-

この記事から得られるものはこれ以上ないので以下は蛇足になる。

-

別件で cppreference.com の identifier のページ を読んでいた時、次の文が目に止まった。

-
-
    -
  • the identifiers that are keywords cannot be used for other purposes; -
      -
    • The only place they can be used as non-keywords is in an attribute-token. (e.g. [[private]] is a valid attribute) (since C++11)
      • -
    -
    • -
-
-

キーワードでも属性として指定する場合は非キーワードとして使えるらしい。 -実際にやってみる。

-

同サイトの [keywords のページ] (https://en.cppreference.com/w/cpp/keyword) から一覧を拝借し、上のコードが出来上がった (C++17 においてキーワードでないものなど、一部省いている)。 -大量の警告 (unknown attribute ‘〇〇’ ignored) がコンパイラから出力されるが、コンパイルできる。

-

上のコードでは [[using]] をコメントアウトしているが、これは using キーワードのみ属性構文の中で意味を持つからであり、このコメントアウトを外すとコンパイルに失敗する。

-
// using の例
-[[using foo: attr1, attr2]] int x; // [[foo::attr1, foo::attr2]] の糖衣構文
-

C++17 の仕様も見てみる (正確には標準化前のドラフト)。

-

引用元: https://timsong-cpp.github.io/cppwp/n4659/dcl.attr#grammar-4

-
-

If a keyword or an alternative token that satisfies the syntactic requirements of an identifier is contained in an attribute-token, it is considered an identifier.

-
-

「identifier の構文上の要件を満たすキーワードまたは代替トークンが attribute-token に含まれている場合、identifier とみなされる」とある。どうやら間違いないようだ。

-

ところで、代替トークン (alternative token) とは and (&) や bitor (|) などのことだが、identifier の構文上の要件を満たさないような代替トークンなどあるのか？ -疑問に思って調べたところ、代替トークンという語にはダイグラフも含まれるらしい (参考: 同ドラフト)

-
    -
  • <% → {
    • -
  • %> → }
    • -
  • <: → [
    • -
  • :> → ]
    • -
  • %: → #
    • -
  • %:%: → ##
    • -
-

「identifier の構文上の要件を満たさないような代替トークン」はこれらが当てはまると思われる。

-

調べた感想: 字句解析器か構文解析器が辛そう

-]]> - - - - diff --git a/docs/tags/cpp/index.html b/docs/tags/cpp/index.html deleted file mode 100644 index 73b29b1..0000000 --- a/docs/tags/cpp/index.html +++ /dev/null @@ -1,56 +0,0 @@ - - - - - - - - cpp | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -

cpp

- -
-
-

[C++] 属性構文の属性名にはキーワードが使える [[void]] [[for]]

-
-
-

C++ の属性構文の属性名には、キーワードが使える。ネタ記事。

-
-
- Posted on -
- -
- - - - - - diff --git a/docs/tags/cpp/page/1/index.html b/docs/tags/cpp/page/1/index.html deleted file mode 100644 index ee45690..0000000 --- a/docs/tags/cpp/page/1/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - - https://blog.nsfisis.dev/tags/cpp/ - - - - - - diff --git a/docs/tags/cpp17/feed.xml b/docs/tags/cpp17/feed.xml deleted file mode 100644 index b1be398..0000000 --- a/docs/tags/cpp17/feed.xml +++ /dev/null @@ -1,89 +0,0 @@ - - - - cpp17 on REPL: Rest-Eat-Program Loop - https://blog.nsfisis.dev/tags/cpp17/ - Recent content in cpp17 on REPL: Rest-Eat-Program Loop - Hugo -- gohugo.io - ja-JP - Sat, 02 Oct 2021 09:38:30 +0900 - - [C++] 属性構文の属性名にはキーワードが使える [[void]] [[for]] - https://blog.nsfisis.dev/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes/ - Sat, 02 Oct 2021 09:38:30 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/94090937bcf860cfa93b

-
-

タイトル落ち。まずはこのコードを見て欲しい。

-
#include <iostream>
-
-[[alignas]] [[alignof]] [[and]] [[and_eq]] [[asm]] [[auto]] [[bitand]]
-[[bitor]] [[bool]] [[break]] [[case]] [[catch]] [[char]] [[char16_t]]
-[[char32_t]] [[class]] [[compl]] [[const]] [[const_cast]] [[constexpr]]
-[[continue]] [[decltype]] [[default]] [[delete]] [[do]] [[double]]
-[[dynamic_cast]] [[else]] [[enum]] [[explicit]] [[export]] [[extern]] [[false]]
-[[final]] [[float]] [[for]] [[friend]] [[goto]] [[if]] [[inline]] [[int]]
-[[long]] [[mutable]] [[namespace]] [[new]] [[noexcept]] [[not]] [[not_eq]]
-[[nullptr]] [[operator]] [[or]] [[or_eq]] [[override]] [[private]]
-[[protected]] [[public]] [[register]] [[reinterpret_cast]] [[return]] [[short]]
-[[signed]] [[sizeof]] [[static]] [[static_assert]] [[static_cast]] [[struct]]
-[[switch]] [[template]] [[this]] [[thread_local]] [[throw]] [[true]] [[try]]
-[[typedef]] [[typeid]] [[typename]] [[union]] [[unsigned]]
-[[virtual]] [[void]] [[volatile]] [[wchar_t]] [[while]] [[xor]] [[xor_eq]]
-// [[using]]
-int main() {
-    std::cout << "Hello, World!" << std::endl;
-}
-
-

コンパイラのバージョン -$ clang++ –version -Apple clang version 11.0.0 (clang-1100.0.33.8) -Target: x86_64-apple-darwin19.6.0 -Thread model: posix -InstalledDir: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin

-

コンパイルコマンド (C++17指定) -$ clang++ –std=c++17 hoge.cpp

-
-

この記事から得られるものはこれ以上ないので以下は蛇足になる。

-

別件で cppreference.com の identifier のページ を読んでいた時、次の文が目に止まった。

-
-
    -
  • the identifiers that are keywords cannot be used for other purposes; -
      -
    • The only place they can be used as non-keywords is in an attribute-token. (e.g. [[private]] is a valid attribute) (since C++11)
      • -
    -
    • -
-
-

キーワードでも属性として指定する場合は非キーワードとして使えるらしい。 -実際にやってみる。

-

同サイトの [keywords のページ] (https://en.cppreference.com/w/cpp/keyword) から一覧を拝借し、上のコードが出来上がった (C++17 においてキーワードでないものなど、一部省いている)。 -大量の警告 (unknown attribute ‘〇〇’ ignored) がコンパイラから出力されるが、コンパイルできる。

-

上のコードでは [[using]] をコメントアウトしているが、これは using キーワードのみ属性構文の中で意味を持つからであり、このコメントアウトを外すとコンパイルに失敗する。

-
// using の例
-[[using foo: attr1, attr2]] int x; // [[foo::attr1, foo::attr2]] の糖衣構文
-

C++17 の仕様も見てみる (正確には標準化前のドラフト)。

-

引用元: https://timsong-cpp.github.io/cppwp/n4659/dcl.attr#grammar-4

-
-

If a keyword or an alternative token that satisfies the syntactic requirements of an identifier is contained in an attribute-token, it is considered an identifier.

-
-

「identifier の構文上の要件を満たすキーワードまたは代替トークンが attribute-token に含まれている場合、identifier とみなされる」とある。どうやら間違いないようだ。

-

ところで、代替トークン (alternative token) とは and (&) や bitor (|) などのことだが、identifier の構文上の要件を満たさないような代替トークンなどあるのか？ -疑問に思って調べたところ、代替トークンという語にはダイグラフも含まれるらしい (参考: 同ドラフト)

-
    -
  • <% → {
    • -
  • %> → }
    • -
  • <: → [
    • -
  • :> → ]
    • -
  • %: → #
    • -
  • %:%: → ##
    • -
-

「identifier の構文上の要件を満たさないような代替トークン」はこれらが当てはまると思われる。

-

調べた感想: 字句解析器か構文解析器が辛そう

-]]> - - - - diff --git a/docs/tags/cpp17/index.html b/docs/tags/cpp17/index.html deleted file mode 100644 index 3dd9d68..0000000 --- a/docs/tags/cpp17/index.html +++ /dev/null @@ -1,56 +0,0 @@ - - - - - - - - cpp17 | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -

cpp17

- -
-
-

[C++] 属性構文の属性名にはキーワードが使える [[void]] [[for]]

-
-
-

C++ の属性構文の属性名には、キーワードが使える。ネタ記事。

-
-
- Posted on -
- -
- - - - - - diff --git a/docs/tags/cpp17/page/1/index.html b/docs/tags/cpp17/page/1/index.html deleted file mode 100644 index 74e12d4..0000000 --- a/docs/tags/cpp17/page/1/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - - https://blog.nsfisis.dev/tags/cpp17/ - - - - - - diff --git a/docs/tags/feed.xml b/docs/tags/feed.xml deleted file mode 100644 index b2ed11e..0000000 --- a/docs/tags/feed.xml +++ /dev/null @@ -1,137 +0,0 @@ - - - - Tags on REPL: Rest-Eat-Program Loop - https://blog.nsfisis.dev/tags/ - Recent content in Tags on REPL: Rest-Eat-Program Loop - Hugo -- gohugo.io - ja-JP - Fri, 28 Oct 2022 21:55:23 +0900 - - note-to-self - https://blog.nsfisis.dev/tags/note-to-self/ - Fri, 28 Oct 2022 21:55:23 +0900 - - https://blog.nsfisis.dev/tags/note-to-self/ - - - - - php - https://blog.nsfisis.dev/tags/php/ - Sun, 23 Oct 2022 09:54:07 +0900 - - https://blog.nsfisis.dev/tags/php/ - - - - - phperkaigi - https://blog.nsfisis.dev/tags/phperkaigi/ - Sun, 23 Oct 2022 09:54:07 +0900 - - https://blog.nsfisis.dev/tags/phperkaigi/ - - - - - conference - https://blog.nsfisis.dev/tags/conference/ - Sat, 27 Aug 2022 18:55:28 +0900 - - https://blog.nsfisis.dev/tags/conference/ - - - - - phpcon - https://blog.nsfisis.dev/tags/phpcon/ - Sat, 27 Aug 2022 18:55:28 +0900 - - https://blog.nsfisis.dev/tags/phpcon/ - - - - - my-programs - https://blog.nsfisis.dev/tags/my-programs/ - Sun, 24 Apr 2022 13:22:52 +0900 - - https://blog.nsfisis.dev/tags/my-programs/ - - - - - rust - https://blog.nsfisis.dev/tags/rust/ - Sat, 02 Oct 2021 09:39:27 +0900 - - https://blog.nsfisis.dev/tags/rust/ - - - - - ruby - https://blog.nsfisis.dev/tags/ruby/ - Sat, 02 Oct 2021 09:38:50 +0900 - - https://blog.nsfisis.dev/tags/ruby/ - - - - - ruby3 - https://blog.nsfisis.dev/tags/ruby3/ - Sat, 02 Oct 2021 09:38:50 +0900 - - https://blog.nsfisis.dev/tags/ruby3/ - - - - - cpp - https://blog.nsfisis.dev/tags/cpp/ - Sat, 02 Oct 2021 09:38:30 +0900 - - https://blog.nsfisis.dev/tags/cpp/ - - - - - cpp17 - https://blog.nsfisis.dev/tags/cpp17/ - Sat, 02 Oct 2021 09:38:30 +0900 - - https://blog.nsfisis.dev/tags/cpp17/ - - - - - vim - https://blog.nsfisis.dev/tags/vim/ - Sat, 02 Oct 2021 09:37:25 +0900 - - https://blog.nsfisis.dev/tags/vim/ - - - - - python - https://blog.nsfisis.dev/tags/python/ - Sat, 02 Oct 2021 09:32:37 +0900 - - https://blog.nsfisis.dev/tags/python/ - - - - - python3 - https://blog.nsfisis.dev/tags/python3/ - Sat, 02 Oct 2021 09:32:37 +0900 - - https://blog.nsfisis.dev/tags/python3/ - - - - - diff --git a/docs/tags/index.html b/docs/tags/index.html deleted file mode 100644 index 79ef62b..0000000 --- a/docs/tags/index.html +++ /dev/null @@ -1,44 +0,0 @@ - - - - - - - - Tags | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -

Tags

-
- - - - - - diff --git a/docs/tags/my-programs/feed.xml b/docs/tags/my-programs/feed.xml deleted file mode 100644 index 34cd4bb..0000000 --- a/docs/tags/my-programs/feed.xml +++ /dev/null @@ -1,62 +0,0 @@ - - - - my-programs on REPL: Rest-Eat-Program Loop - https://blog.nsfisis.dev/tags/my-programs/ - Recent content in my-programs on REPL: Rest-Eat-Program Loop - Hugo -- gohugo.io - ja-JP - Sun, 24 Apr 2022 13:22:52 +0900 - - term-banner: ターミナルにバナーを表示するツールを書いた - https://blog.nsfisis.dev/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal/ - Sun, 24 Apr 2022 13:22:52 +0900 - - https://blog.nsfisis.dev/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal/ - はじめに -

こんなものを作った。

-
$ term-banner 'Hello, World!' 'こんにちは、' '世界！'
-

term-banner のスクリーンショット

-

コマンドライン引数として渡した文字列をターミナルに大きく表示する。

-

リポジトリはこちら: https://github.com/nsfisis/term-banner

-

Motivation

-

以前、big-clock-mode という似たようなプログラムを書いた。 -これは tmux の :clock-mode コマンドに着想を得たもので、:clock-mode よりも大きく現在時刻を表示する。

-

big-clock-mode を開発したのは、次のようなシチュエーションで使うためである。 -弊社では現在リモートワークが基本だが、web 会議などで画面共有しているときに、休憩を挟んで特定の時刻から再開する、ということがある。 -こういったケースで、画面上に現在の時刻を大きめに表示しておくと、モニタから離れても遠くから時刻がわかるので便利である。

-

それこそタイマアプリか何かを使えばいいのだが、ターミナルに棲むいきものとしては、住処から離れたくないわけだ。

-

しばらく便利に使っていたのだが、ひとつ不満点が出てきた。それは、再開する時刻がいつだったかを覚えておかなければならないということだ。 -どこかにメモしておいてもいいが、せっかくなら現在時刻とともに表示させておきたい。

-

そんなわけで、「任意の文字列をターミナルに表示する」プログラムを書く運びとなった。 -まあ、作らなくても探せばあると思うが、作りたいものは作りたいので知ったことではない。

-

プログラム

-

全体の流れは次のようになっている。

-
    -
  1. フォントファイルを読み込む
    2. -
  2. コマンドライン引数を Shift-JIS に変換する (フォントが Shift-JIS 基準で並んでいるため)
    3. -
  3. 1文字ずつレンダリングしていく
    4. -
-

big-clock-mode が Go 製なので、今回も Go で書いた。 -PNG が標準ライブラリにあったり、Shift-JIS のエンコーディングが準標準ライブラリにあったりしたのは助かった。

-

フォントファイルは go:embed で実行ファイルに埋め込んでいるので、ビルド後はワンバイナリで動く。 -仕事ではスクリプト言語ばかり書いているが、やはりコンパイル言語はいい。

-

フォント

-

フリーの 8x8 ビットマップフォントである、美咲フォント 2021-05-05a 版 を使わせていただいた。

-

はじめは自分でポチポチ打っていたのだが、「き」くらいまでやって挫折した。 -同じく 8x8 で作っていたのだが、平仮名でさえも、この小さなキャンバスにはとても収められない。

-

美咲フォントは、平仮名・片仮名に留まらず、JIS 第一・第二水準の漢字までサポートしている。 -第二水準ともなると一生お目にかかることのない字の方が多いくらいだが、これをこの大きさで書くというのは、もはや芸術の域である。

-

さらに言うと、実のところ美咲フォントは実サイズ 7x7 で作られており、余白が設けられている。 -これは、単純にそのまま並べても字間・行間を確保できるようにという配慮である。 -おかげでコーディングまで楽になった。

-

ゴシック体と明朝体があったが、私の好みで明朝体の方にした。 -ただ、ゴシック体の方が見やすい気がするので、フォントを選べるように後ほど拡張するかもしれない。

-

2022-04-27 追記: -f オプションで選べるようにした。

-

おわりに

-

あなたもターミナルに住んでみませんか？

-]]> - - - - diff --git a/docs/tags/my-programs/index.html b/docs/tags/my-programs/index.html deleted file mode 100644 index bc71599..0000000 --- a/docs/tags/my-programs/index.html +++ /dev/null @@ -1,56 +0,0 @@ - - - - - - - - my-programs | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -

my-programs

- -
-
-

term-banner: ターミナルにバナーを表示するツールを書いた

-
-
-

ターミナルに任意の文字のバナーを表示するためのツールを Go で書いた。

-
-
- Posted on , updated on -
- -
- - - - - - diff --git a/docs/tags/my-programs/page/1/index.html b/docs/tags/my-programs/page/1/index.html deleted file mode 100644 index 36f7d78..0000000 --- a/docs/tags/my-programs/page/1/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - - https://blog.nsfisis.dev/tags/my-programs/ - - - - - - diff --git a/docs/tags/note-to-self/feed.xml b/docs/tags/note-to-self/feed.xml deleted file mode 100644 index 2a8f961..0000000 --- a/docs/tags/note-to-self/feed.xml +++ /dev/null @@ -1,123 +0,0 @@ - - - - note-to-self on REPL: Rest-Eat-Program Loop - https://blog.nsfisis.dev/tags/note-to-self/ - Recent content in note-to-self on REPL: Rest-Eat-Program Loop - Hugo -- gohugo.io - ja-JP - Fri, 28 Oct 2022 21:55:23 +0900 - - [備忘録] このサイト用の VPS をセットアップしたときのメモ - https://blog.nsfisis.dev/posts/2022-10-28/setup-server-for-this-site/ - Fri, 28 Oct 2022 21:55:23 +0900 - - https://blog.nsfisis.dev/posts/2022-10-28/setup-server-for-this-site/ - はじめに -

これまでこの blog は GitHub Pages でホストしていたのだが、先日 VPS に移行した。そのときにおこなったサーバのセットアップ作業を書き残しておく。99 % 自分用の備忘録。別のベンダに移したりしたくなったら見に来る。

-

未来の自分へ: 特に自動化してないので、せいぜい苦しんでくれ。

-

VPS

-

さくらの VPS の 2 GB プラン。そこまで真面目に選定していないので、困ったら移動するかも。

-

事前準備

-

サーバのホスト名を決める

-

モチベーションが上がるという効能がある。今回は藤原定家から取って “teika” にした。たいていいつも源氏物語の帖か小倉百人一首の歌人から選んでいる。

-

SSH の鍵生成

-

ローカルマシンで鍵を生成する。

-
$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/teika.key
-$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/github2teika.key
-

teika.key はローカルからサーバへの接続用、github2teika.key は、GitHub Actions からサーバへのデプロイ用。

-

SSH の設定

-

.ssh/config に設定しておく。

-
Host teika
-    HostName **********
-    User **********
-    Port **********
-    IdentityFile ~/.ssh/teika.key
-

基本のセットアップ

-

SSH 接続

-

VPS 契約時に設定した管理者ユーザとパスワードを使ってログインする。

-

ユーザを作成する

-

管理者ユーザで作業すると危ないので、メインで使うユーザを作成する。sudo グループに追加して sudo できるようにし、su で切り替え。

-
$ sudo adduser **********
-$ sudo adduser ********** sudo
-$ su **********
-$ cd
-

ホスト名を変える

-
$ sudo hostname teika
-

公開鍵を置く

-
$ mkdir ~/.ssh
-$ chmod 700 ~/.ssh
-$ vi ~/.ssh/authorized_keys
-

authorized_keys には、ローカルで生成した ~/.ssh/teika.key.pub と ~/.ssh/github2teika.key.pub の内容をコピーする。

-

SSH の設定

-

SSH の設定を変更し、少しでも安全にしておく。

-
$ sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak
-$ sudo vi /etc/ssh/sshd_config
-
    -
  • Port を変更
    • -
  • PermitRootLogin を no に
    • -
  • PasswordAuthentication を no に
    • -
-

そして設定を反映。

-
$ sudo systemctl restart sshd
-$ sudo systemctl status sshd
-

SSH で接続確認

-

今の SSH セッションは閉じずに、ターミナルを別途開いて疎通確認する。セッションを閉じてしまうと、SSH の設定に不備があった場合に締め出しをくらう。

-
$ ssh teika
-

ポートの遮断

-

デフォルトの 22 番を閉じ、設定したポートだけ空ける。

-
$ sudo ufw deny ssh
-$ sudo ufw allow *******
-$ sudo ufw enable
-$ sudo ufw reload
-$ sudo ufw status
-

ここでもう一度 SSH の接続確認を挟む。

-

GitHub 用の SSH 鍵

-

GitHub に置いてある private リポジトリをサーバから clone したいので、SSH 鍵を生成して置いておく。

-
$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/github.key
-$ cat ~/.ssh/github.key.pub
-

GitHub の設定画面 から、この公開鍵を追加する。

-
$ vi ~/.ssh/config
-

設定はこう。

-
Host github.com
-    HostName github.com
-    User git
-    IdentityFile ~/.ssh/github.key
-

最後に接続できるか確認しておく。

-
ssh -T github.com
-

パッケージの更新

-
$ sudo apt update
-$ sudo apt upgrade
-$ sudo apt update
-$ sudo apt upgrade
-$ sudo apt autoremove
-

サイトホスティング用のセットアップ

-

DNS に IP アドレスを登録する

-

このサーバは固定の IP アドレスがあるので、A レコードに直接入れるだけで済んだ。

-

使うソフトウェアのインストール

-
$ sudo apt install docker docker-compose git make
-

メインユーザが Docker を使えるように

-
sudo adduser ********** docker
-

HTTP/HTTPS を通す

-

80 番と 443 番を空ける。

-
$ sudo ufw allow 80/tcp
-$ sudo ufw allow 443/tcp
-$ sudo ufw reload
-$ sudo ufw status
-

リポジトリのクローン

-
$ cd
-$ git clone git@github.com:nsfisis/nsfisis.dev.git
-$ cd nsfisis.dev
-$ git submodule update --init
-

certbot で証明書取得

-
$ docker-compose up -d acme-challenge
-$ make setup
-

サーバを稼動させる

-
$ make serve
-

感想

-

(業務でなく) 個人だと数年ぶりのサーバセットアップで、これだけでも割と時間を食ってしまった。とはいえ式年遷宮は楽しいので、これからも定期的にやっていきたい。コンテナデプロイにしたい気持ちもあるのだが、色々実験したい関係上、本物のサーバも欲しくはある。次の式年遷宮では、手順の一部だけでも自動化したいところ。

-]]> - - - - diff --git a/docs/tags/note-to-self/index.html b/docs/tags/note-to-self/index.html deleted file mode 100644 index 0539b70..0000000 --- a/docs/tags/note-to-self/index.html +++ /dev/null @@ -1,57 +0,0 @@ - - - - - - - - note-to-self | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -

note-to-self

- -
-
-

[備忘録] このサイト用の VPS をセットアップしたときのメモ

-
-
-

GitHub Pages でホストしていたこのサイトを VPS へ移行したので、 -そのときにやったことのメモ。99 % 自分用。

-
-
- Posted on -
- -
- - - - - - diff --git a/docs/tags/note-to-self/page/1/index.html b/docs/tags/note-to-self/page/1/index.html deleted file mode 100644 index 3d56366..0000000 --- a/docs/tags/note-to-self/page/1/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - - https://blog.nsfisis.dev/tags/note-to-self/ - - - - - - diff --git a/docs/tags/page/1/index.html b/docs/tags/page/1/index.html deleted file mode 100644 index 2dbd4ae..0000000 --- a/docs/tags/page/1/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - - https://blog.nsfisis.dev/tags/ - - - - - - diff --git a/docs/tags/php/feed.xml b/docs/tags/php/feed.xml deleted file mode 100644 index 32be73a..0000000 --- a/docs/tags/php/feed.xml +++ /dev/null @@ -1,1493 +0,0 @@ - - - - php on REPL: Rest-Eat-Program Loop - https://blog.nsfisis.dev/tags/php/ - Recent content in php on REPL: Rest-Eat-Program Loop - Hugo -- gohugo.io - ja-JP - Sun, 23 Oct 2022 09:54:07 +0900 - - PHPerKaigi 2023: ボツになったトークン問題 その 1 - https://blog.nsfisis.dev/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1/ - Sun, 23 Oct 2022 09:54:07 +0900 - - https://blog.nsfisis.dev/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1/ - はじめに -

2023 年 3 月 23 日から 25 日にかけて開催予定 (記事執筆時点) の、PHPerKaigi 2023 において、昨年と同様に、弊社デジタルサーカス株式会社 から、トークン問題を出題予定である。

-

昨年のトークン問題の記事はこちら: PHPerKaigi 2022 トークン問題の解説

-

すでに 2023 年用の問題は作成済みであるが、その制作過程の中でいくつかボツ問ができた。せっかくなので、PHPerKaigi 開催を待つ間に紹介しようと思う。

-

10 月から 2 月まで、毎月 1 記事ずつ公開していく予定 (忘れていなければ)。

-

問題

-

注意: これはボツ問なので、得られたトークンを PHPerKaigi で入力してもポイントにはならない。

-
<?php
-
-$π = $argv[1] ?? null;
-if ($π === null) {
-  exit('No input.');
-}
-$π = trim($π);
-if (!is_numeric($π)) {
-  exit('Invalid input.');
-}
-
-$s = implode(array_map(chr(...), str_split($π, 2)));
-
-preg_match('/(\x23.+?) /', $s, $m);
-$t = $m[1] ?? '';
-
-if (md5($t) === '056e831a4146bf123e8ea16613303d2e') {
-  echo "Token: {$t}\n";
-} else {
-  echo "Failed.\n";
-}
-

トークン入手方法

-

ソースを見るとわかるとおり、$argv[1] を参照している。それを $π なる変数に代入しているので、円周率を渡してみる。

-
$ php Q.php 3.14
-Failed.
-

失敗してしまった。精度を上げてみる。

-
$ php Q.php 3.1415
-Failed.
-

だめだった。これを成功するまで繰り返す。

-

最初にトークンが得られるのは、小数点以下 16 桁目まで入力したときで、こうなる。

-
$ php Q.php 3.1415926535897932
-Token: #YO
-

めでたくトークン「#YO」が手に入った。

-

解説

-

短いので頭から追っていく。

-
$π = $argv[1] ?? null;
-if ($π === null) {
-  exit('No input.');
-}
-$π = trim($π);
-if (!is_numeric($π)) {
-  exit('Invalid input.');
-}
-

入力のバリデーション部分。数値のみ受け付ける。

-
$s = implode(array_map(chr(...), str_split($π, 2)));
-

$π を 2 文字ごとに区切り (str_split)、数値を ASCII コードと見做して文字に変換 (chr) して結合 (implode) している。

-

例えば、$π が '656667' だったとすると、65、66、67 に対応した 'A'、'B'、'C' へと変換され、'ABC' になる。

-
$π = '656667';
-$s = implode(array_map(chr(...), str_split($π, 2)));
-echo $s;
-// => ABC
-
preg_match('/(\x23.+?) /', $s, $m);
-$t = $m[1] ?? '';
-

正規表現でマッチングしている。\x23 は # と同じであることに留意すると、この正規表現は「# から始まる 2 以上の長さ (含 #) の文字列で、最初に現れるスペースまで」にマッチする。つまりこれは、PHPerKaigi におけるトークンである。

-

なお、# を直接書いていないのは、/#.+?) / と書くと、#.+?) という意図せぬトークンが登録されてしまうからである。

-
if (md5($t) === '056e831a4146bf123e8ea16613303d2e') {
-  echo "Token: {$t}\n";
-} else {
-  echo "Failed.\n";
-}
-

最後にトークンのハッシュ値を見て、想定解かどうかを確認する。

-

おわりに

-

円周率を何桁も計算して ASCII コード経由で文字列化すれば、トークンっぽいものがどこかで出てくるのではないか、と考えて生まれた作品。

-

最初は真面目に円周率の計算プログラムを組んでいたのだが、いざ動かしてみるとやけに浅いところにあったので驚いた (ちなみに、それでも M_PI や pi() では精度が足りない)。見つけたときは狂喜したものの、冷静になってみると大して面白くなかったのでボツになった。むしろ、100 万桁目くらいに埋まっていてくれたほうがよかったかもしれない。

-]]> - - - - [PHP] fizzbuzz を書く。1行あたり2文字で。 - https://blog.nsfisis.dev/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line/ - Thu, 29 Sep 2022 00:50:52 +0900 - - https://blog.nsfisis.dev/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line/ - 記事の構成について -

この記事は、普通の fizzbuzz を徐々に変形して最終形にしていく、という構成で書かれている。最終形を見てどのような仕組みで動いているのか解読してから解説を読みたい、というかたがいれば、 このページ にソースコードがあるので、そちらを先に見てほしい。

-

レギュレーション

-

PHP で、次のような制約の下に fizzbuzz を書いた。

-
    -
  • 1行あたりの文字数は2文字までに収めること (ただし <?php タグは除く) -
      -
    • 厳密な定義: <?php タグ以降のソースコードが、2 byte ごとに ラインフィード (LF) で区切られること
      • -
    -
    • -
  • スペースやタブを使用しないこと
    • -
  • ループのアンロールをしないこと -
      -
    • 100 回ループの代わりに 100 回コードをコピペ、というのは禁止
      • -
    -
    • -
  • PHP 7.4〜8.1 で動作すること
    • -
  • 実行時に Notice や Warning が出ないこと
    • -
  • 標準的なインストール構成の PHP で実現できること (デフォルトで有効になっていない拡張等を使わないこと)
    • -
-

備考: PHP には short_open_tag というオプションがあり、これを有効にするとファイル冒頭の <?php の代わりに <? を使うことができ、文字どおり1行2文字で書ける。ただ、このオプションはデフォルト off になっている環境が多いようなので、今回は使わないことにした。

-

主な障害

-

1行あたりの文字数など、適当に改行を挟めばいいだけではないのか？

-

特に、C言語でこのような試みをおこなったことがあるかたならそう思うだろう。事実、Cでのこの制約はほとんど無意味に等しい。

-
#\
-i\
-n\
-c\
-l\
-u\
-d\
-e\
-<\
-s\
-t\
-d\
-i\
-o\
-.\
-h\
->\
-/*
-*/
-i\
-n\
-t\
-/*
-*/
-m\
-a\
-i\
-n(
-){
-f\
-o\
-r(
-i\
-n\
-t\
-/*
-*/
-i=
-1;
-i<
-1\
-0\
-0;
-i\
-+\
-+)
-if
-(i
-%\
-15
-==
-0)
-p\
-r\
-i\
-n\
-t\
-f(
-"\
-F\
-i\
-z\
-z\
-B\
-u\
-z\
-z\
-%\
-c\
-",
-10
-);
-
-/* あとは同じように普通のプログラムを変形するだけなので省略 */
-

バックスラッシュを使った行継続がトークンを区切らない、というのがポイントだ。

-

さて、PHP ではそもそもバックスラッシュを行継続に使うことができない。これにより、「3文字以上からなるトークンが一切使えない」という制約が課される。例えば、echo で出力することや、for でループすること、new でインスタンスを生成することができない。特に、出力は fizzbuzz をどんなアルゴリズムで実装しようとおこなわなければならないので、できないのは致命的である。

-

当然、名前が3文字以上ある関数も使えない。なお、標準 PHP の範囲内において、名前が 2文字以下の関数は以下のとおりである:

-
    -
  • _: gettext のエイリアス
    • -
  • dl: 拡張モジュールをロードする
    • -
  • pi: 円周率を返す
    • -
-

(環境によって多少は変わるかも)

-

2文字の関数を定義しまくった拡張モジュールを用意しておいて dl() で読み込む行為は、レギュレーションで定めた

-
-
    -
  • 標準的なインストール構成の PHP で実現できること (デフォルトで有効になっていない拡張等を使わないこと)
    • -
-
-

に反する (というより、「それだとおもしろくもなんともないので、このルールを足した」というのが正しい)。

-

また、2文字だと文字列がまともに書けないのも辛い。'' だけで 2文字使うので、「1文字の文字列リテラル」というものを書くことができない。PHP では文字列リテラル中に生の改行が書けるので

-
$a
-='
-a'
-;;
-

とすると $a は "\na" になるのだが、余計な改行が入ってしまう。

-

これらの障害をどのように乗り越えるのか、次節から見ていく。

-

解説

-

普通の (?) fizzbuzz

-

まずは普通に書くとしよう。

-
<?php
-
-for ($i = 1; $i < 100; $i++) {
-  echo (($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n";
-}
-

素直に書いた fizzbuzz とは言い難いが、このくらいは普通だということにしておかないと、この先がやっていられないので許してほしい。

-

for の排除

-

for は、3文字もある長いキーワードである。こんなものは使えない。array_ 系の関数を使って、適当に置き換えるとしよう。

-
<?php
-
-$s = range(1, 100);
-array_walk(
-  $s,
-  fn($i) =>
-    printf((($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n"),
-);
-

array_walk や range、printf といった for よりも長いトークンが現れてしまったが、これは次節で直すことにする。なお、echo は文 (statement) であり式 (expression) ではないので、式である printf に置き換えた。

-

関数呼び出しの短縮

-

range、array_walk、printf は長すぎるのでどうにかせねばならない。ここで、PHP の可変関数を使う。可変関数とは、関数名が文字列として入った変数を経由して、関数を呼び出す機能である。

-
<?php
-
-$r = 'range';
-$w = 'array_walk';
-$p = 'printf';
-
-$s = $r(1, 100);
-$w(
-  $s,
-  fn($i) =>
-    $p((($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n"),
-);
-

これで関数を呼び出している所は短くなった。では、$r や $w や $p、また 'Fizz' や 'Buzz' はどうやって 1行2文字に収めるのか。次のテクニックへ移ろう。

-

余談: PHP 8.x で動作しなくてもいいなら

-

今回使ったテクニックを説明する前に、余談として、文字列リテラルの短縮法として今回採用しなかったものを紹介する。

-
-
    -
  • PHP 7.4〜8.1 で動作すること
    • -
-
-

というルールがない場合、「未定義の定数が評価された場合、その定数の名前が値になる」という PHP 7.x までの仕様が利用できる。例えば、 Fizz という文字列が欲しければ、次のようにする。

-
$f
-=F
-.i
-.z
-.z
-;;
-

こうして簡単に文字列を作れる。なお、この仕様は 7.x 時点でも警告を受けるので、@ 演算子を使って抑制してやるとよい。

-
$f
-=@
-F.
-@i
-.#
-@z
-.#
-@z
-;;
-

むしろ、このことがわかっていたからこそ PHP 8.x での動作を要件に課したところがある。

-

文字列リテラルの短縮

-

実際に使った手法の説明に移る。

-

ずばり、文字列同士のビット演算を使う。PHP では、文字列同士でビット演算 (&、|、^) をした場合、文字列の各バイトごとに指定したビット演算がなされ、それを結合したものが演算結果となる。

-
$a = "12345";
-$b = "world";
-
-// $a ^ $b は次のコードと同じ
-$result = '';
-for ($i = 0; $i < min(strlen($a), strlen($b)); $i++) {
-  $result .= $a[$i] ^ $b[$i];
-}
-
-echo $result;
-// => F]AXQ
-

これを踏まえ、次のコードを見てみよう。

-
$x = "x\nOm\n";
-$y = "\nk!\no";
-$r = $x ^ $y;
-echo "$r\n";
-

実行すると、range が表示される。さて、PHP では文字列リテラル中に生の改行を直接書いてもよいのだった (「主な障害」の節を参照のこと)。書きかえてみよう。

-
$x
-='x
-Om
-';
-$y
-='
-k!
-o'
-;
-
-$r = $x ^ $y;
-echo "$r\n";
-

さらに # を使って適当に調整すると、次のようになる。

-
$x
-=#
-'x
-Om
-';
-$y
-='
-k!
-o'
-;#
-$r
-=#
-$x
-^#
-$y
-;#
-
-echo "$r\n";
-

1行あたり2文字で、range という文字列を生成することに成功した。他の必要な文字列にも、同様の処理をほどこす。

-

備考: Buzz 中にある小文字の u は、このロジックだと non-printable な文字になってしまう。ここまでのテクニックを駆使すれば回避するのはそう難しくないので、考えてみてほしい。

-

完成系

-

完成したものがこちら。

-
<?php
-
-$x
-=#
-'i
-S'
-;;
-$y
-='
-b!
-';
-$c
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'x
-Om
-';
-$y
-='
-k!
-o'
-;#
-$r
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'k
-Sk
-~}
-Ma
-';
-$y
-='
-x!
-s!
-k!
-';
-$w
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'z
-Hd
-G'
-;#
-$y
-='
-x!
-~!
-';
-$p
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'L
-[p
-';
-$y
-='
-c!
-';
-$f
-=#
-$x
-^#
-$y
-;#
-$x
-=#
-'H
-[p
-';
-$y
-='
-_!
-';
-$b
-=#
-$x
-^#
-$y
-;#
-$b
-[1
-]=
-$c
-(#
-13
-*9
-);
-$s
-=#
-$r
-(1
-,(
-10
-**
-2)
-);
-$w
-(#
-$s
-,#
-fn
-(#
-$i
-)#
-=>
-$p
-((
-(#
-$i
-%3
-?#
-''
-:#
-$f
-).
-(#
-$i
-%5
-?#
-''
-:#
-$b
-)?
-:#
-$i
-)#
-.'
-')
-);
-

感想など

-

PHP は、スクリプト言語の中だとシンタックスシュガーが少ない (体感)。この挑戦は不可能に思われたが、PHP マニュアルとにらめっこしていたらなんとかなった。

-

みんなもプログラムを細長くしよう。

-

余談2: 別解

-

PHP では、バッククォートを使ってシェルを呼び出せる。これは shell_exec 関数と等価である。さて、PHP ではバックスラッシュによる行継続が使えないと書いたが、シェルでは使える (当然だが、呼び出されるシェルに依存する。Bash なら大丈夫だろう。知らんけど)。

-
<?php
-
-printf(`
-e\
-c\
-h\
-o\
- \
-1\
-2\
-3\
-`);
-

なお、ここでは簡単のため出力に printf をそのまま使っているが、実際には printf という文字列を合成して可変関数で呼び出す。

-

ただし、これでは

-
-
    -
  • スペースやタブを使用しないこと
    • -
-
-

に違反してしまう。スペースが使えないと引数とコマンドを区切れない。これは困った。

-

もうこれ以上は不可能だと思っていたのだが、この記事の執筆中に解決する方法を思いついたので載せておく。

-
<?php
-
-$c = 'chr';
-
-${
-'_
-'}
-=#
-$c
-(#
-32
-).
-$c
-(#
-92
-);
-
-printf(`
-e\
-c\
-h\
-o\
-${
-'_
-'}
-1\
-2\
-3\
-`);
-

先程と同じく、chr や printf を生成する部分は長くなるので省いた。

-
${
-'_
-'}
-

は変数で、中にはスペースとエスケープが入っている (chr(32) . chr(92))。シェルに渡されている文字列は次のようになる。

-
e\
-c\
-h\
-o\
- \
-1\
-2\
-3\
-

これは、前掲したコマンドと同じだ。かくして、スペースを陽に書かずにシェルをおおよそ自由に扱えるようになった。Fizzbuzz のワンライナーくらいすぐ書けるだろうから、あとはなんとかなるだろう (試してないけど)。

-

ということでこれは別解ということにしておく。

-

ちなみに、PHP 8.2 からは、この記法で Warning が出るようになるようだ。

-
${
-'_
-'}
-

最新版で警告が出るというのも美しくないので、私としては本編の解法を推す。

-]]> - - - - PHP カンファレンス沖縄で出題されたコードゴルフの問題を解いてみた - https://blog.nsfisis.dev/posts/2022-08-27/php-conference-okinawa-code-golf/ - Sat, 27 Aug 2022 18:55:28 +0900 - - https://blog.nsfisis.dev/posts/2022-08-27/php-conference-okinawa-code-golf/ - はじめに -

本日 PHP カンファレンス沖縄 2022 が開催された (らしい)。

-

カンファレンスには参加できなかったものの、懇親会の LT で出題されたコードゴルフの問題が Twitter に流れてきたので、解いてみた。

-

ツイート: https://twitter.com/m3m0r7/status/1563397620231712772
-スライド: https://speakerdeck.com/memory1994/php-conference-okinawa-2022-extra?slide=3

-

解

-

細かいレギュレーションは不明だったので、勝手に定めた。

-
    -
  • コマンドライン引数の第1引数で受けとる
    • -
  • 結果は標準出力に出す
    • -
  • コンマの直後にはスペースを1つ置く
    • -
  • 末尾コンマは禁止
    • -
  • 数字でないものは入ってこないものとする
    • -
  • 負数は入ってこないものとする
    • -
-

書いたものがこちら:

-
[<?php $n=$argv[1];foreach([1e4,5e3,2e3,1e3,500,100,50,10,5,1]as$x)for(;$n>=$x;$n-=$x)$r[]=$x;echo implode(', ',$r??[]);?>]
-

しめて 123 バイトとなった (末尾改行を含めずにカウント)。

-

こちらは改行とスペースを追加したバージョン:

-
[<?php
-
-$n = $argv[1];
-foreach ([1e4, 5e3, 2e3, 1e3, 500, 100, 50, 10, 5, 1] as $x)
-  for (; $n >= $x; $n -= $x)
-    $r[] = $x;
-echo implode(', ', $r ?? []);
-
-?>]
-

使用したテクニック

-

指数表記

-

割と多くの言語のゴルフで使えるテクニック。e を用いた指数表記で、大きな数を短く表す。このコードでは 10000、5000、2000、1000 を指数表記している。

-

foreach や for の中身を1つの文に

-

foreach、for、if などの後ろには、通常 { を続けて複数の文を連ねるが、中身の文を1つにしてしまえば、{ と } を省略できる。C言語などでも使える。

-

$r に初期値を入れない

-

PHP では、$r[] = ... のような配列の末尾に追加する式を実行したとき、$r が未定義だった場合は $r を勝手に定義して空の配列で初期化してくれる。これを利用すると、$r = []; のような初期化が不要になる。

-

ただし、プログラムに 0 が渡されるとループを一度も回らないので、$r が未定義になってしまい、implode() に渡すところでエラーになる。それを防ぐために $r ?? [] を使っている。

-

もし 0 が渡されたケースを無視するなら、これが不要になるので 4 バイト縮む。

-

PHP タグの外に文字列を置く

-

PHP では、<?php ?> で囲われた部分の外側にある文字列は、そのまま出力される。今回のケースでは、先頭と末尾に必ず [ と ] を出力するので、そのまま書いてやればよい。

-

おわりに

-

最後になりましたが、めもりー さん、楽しい問題をありがとうございました。

-]]> - - - - PHPerKaigi 2022 - https://blog.nsfisis.dev/posts/2022-05-01/phperkaigi-2022/ - Sun, 01 May 2022 09:41:39 +0900 - - https://blog.nsfisis.dev/posts/2022-05-01/phperkaigi-2022/ - はじめに -

2022-04-09 から 2022-04-11 にかけて開催された、PHPerKaigi 2022 に、一般参加者として参加した。 -弊社デジタルサーカス株式会社 はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。

-

昨年のレポートはこちら。

-

感想

-

厳選おすすめトーク

-

多くの素晴らしいトークの中から、特におすすめのものを 5つ選んだ。是非聞いてほしい。引用部分は、リンク先プロポーザルから引用している。

-

予防に勝る防御なし - 堅牢なコードを導く様々な設計のヒント

-
-

PHP はバージョンを追う毎に型宣言、例外、表明、列挙型などの機能が大幅に強化され、堅牢なコードを書くための機能が充実してきました。それらの機能はどう使うと効果的なのでしょうか。

-

本講演では PHP 8.1 をベースにして、誤りを想定してチェックするのではなく、そもそも誤りにくい設計とはどのようなものか、つまり「予防」の観点を軸足に、堅牢なコードを導くための様々な設計のヒントをご紹介します。

-
-

PHPのエラーを理解して適切なエラーハンドリングを学ぼう

-
-

PHPを使ってるとよく遭遇する Fatal error / Parse error / Warning / Notice 理解していますか？
-これらのエラー文を理解することで、すぐにエラーの原因に気付き適切に対象できる様になります！
-またそれらを理解した上でのエラーハンドリングを学びましょう。

-
-

エラー監視とテスト体制への改善作戦

-
-

毎日流れてくるエラーに皆さんはどう向き合ってますか？
-エラーを出さない事が一番ですが、完全に塞ぐ事は難しいと考えます。
-サービス運用の中で本番環境から発生するエラー（サーバー・クライアントサイド・サードパーティ起因のエラー）への監視体制と、
-エラー・バグ防御のためチームで行っているテストコード文化づくりの話をします。

-
-

ISUCON11のPHP実装は、何を考え、どのようにして作られていたのか

-
-

昨年開催されたISUCON11にて問題（参考実装）のPHPへの移植を担当させていただきました。

-

最終的なソースコードこそシンプルなWebアプリケーションではありますが、その裏には
-・「（私の思う）良い設計」を実現するための意思決定
-・「ISUCONの問題」という位置付けに由来する取捨選択
-・移植中に遭遇したトラブルとその解決策
-といった文脈や葛藤が存在しています。

-

本発表はそれらを共有することで
-・PHPアプリケーションの設計、実装事例として役立ててもらう
-・ISUCONの言語移植に興味を持ってもらう
-・ISUCON問題移植の「実装や設計の練習をする教材」としての可能性を知ってもらう
-ことを目的とします。

-
-

チームの仕事はまわっていたけど、メンバーはそれぞれモヤモヤを抱えていた話──40名の大規模開発チームで1on1ログを公開してみた

-
-

サイボウズの大企業向けグループウェアのGaroon（ガルーン）は、PHPで開発されている20年目の製品です。ガルーン開発チームは日本で40名、ベトナムで50名の計90名ほどのチームになっています。また、コロナ禍でフルリモートでの活動がこの2年ほど継続してきました。

-

フルリモートになっても仕事はまわっており、継続的にリリースはしていましたが、一方でお互いの考えていることや感じている問題意識が見えづらくなり、モヤモヤを抱えているメンバーが増えていました。

-

このセッションでは、そういう状況で私がチーム外からジョインし、聴き役に徹しながら見える化することで状況を改善していった取り組みを紹介します。同じように大きなチームやリモートワークで難しさを感じている人に、難しさの原因への気づきや取り組みへのヒントがあれば幸いです。

-
-

トークン問題の作成

-

今回は、PHPer チャレンジ用に弊社のトークン問題を 3題作成した。こちらについては別途記事にしているので、そちらを参照されたい。

-

PHPer チャレンジ

-

1位になった。
-また、賞品として Echo Show 15 をいただいた。

-

カンファレンス全体への感想

-

去年の参加レポ では、こんなことを書いた。

-
-

1つ個人的な反省点としては、(中略) Discord しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。
-まあ初カンファレンスだし、とお茶を濁しておこう。

-
-

この反省を踏まえ、今年は積極的にほかの場 (公式の Discord サーバや、アンカンファレンス) にも参加した。
-これにより、参加体験の質がはるかに向上した。特に Discord に関しては、登壇者ご本人による補足や、質問への回答などがおこなわれる (ことが多い) ため、特別な理由のない限り、発言はしないまでも参加はしておいたほうが良いと思われる。

-

なお、アンカンファレンスについては、1日目の終わりにトークン問題の解説放送もおこなった。

-

また、今年はオフラインとオンラインのハイブリッド開催であったが、去年の全オンラインと比べて、オンライン参加の体験が落ちていなかったのは、特筆すべきであろう。 -今年は 3回目のワクチン接種が間に合わなかったこともあり現地参加は見送ったのだが、来年は是非オフラインで参加したい。

-

そして来年へ……?

-

PHPerKaigi 2023 があるかどうか存じ上げないが、あるとすれば、次の 4つを目標としたい。

-
    -
  • プロポーザルを出す
    • -
  • PHPer チャレンジのトークン問題を 5題作成する
    • -
  • 現地に行く
    • -
  • PHPer チャレンジで圧勝する
    • -
-
-

最後になりましたが、PHPerKaigi のスタッフ、スポンサー、スピーカーのみなさん、素敵な時間をありがとうございました。

-

ではまた来年。

-]]> - - - - PHPerKaigi 2022 トークン問題の解説 - https://blog.nsfisis.dev/posts/2022-04-09/phperkaigi-2022-tokens/ - Sat, 09 Apr 2022 21:50:19 +0900 - - https://blog.nsfisis.dev/posts/2022-04-09/phperkaigi-2022-tokens/ - はじめに -

本日開始された PHPerKaigi 2022 の PHPer チャレンジにおいて、弊社 デジタルサーカス株式会社 の問題を 3問作成した。この記事では、これらの問題の解説をおこなう。

-

リポジトリはこちら: https://github.com/nsfisis/PHPerKaigi2022-tokens

-

第1問 brainf_ck.php

-

ソースコードはこちら。実行には PHP 8.1 以上が必要なので注意。

-
<?php
-
-declare(strict_types=0O1);
-
-namespace Dgcircus\PHPerKaigi\Y2022;
-
-/**
- * @todo
- * Run this program to acquire a PHPer token.
- */
-
-https://creativecommons.org/publicdomain/zero/1.0/
-
-\error_reporting(~+!'We are hiring!');
-
-$z = fn($f) => (fn($x) => $f(fn(...$xs) => $x($x)(...$xs)))(fn($x) => $f(fn(...$xs) => $x($x)(...$xs)));
-$id = \spl_object_id(...);
-$put = fn($c) => \printf('%c', $c);
-$mm = fn($p, $n) => new \ArrayObject(\array_fill(+!![], $n, $p));
-
-$👉 = fn($m, $p, $b, $e, $mp, $pc) => [++$mp, ++$pc];
-$👈 = fn($m, $p, $b, $e, $mp, $pc) => [--$mp, ++$pc];
-$👍 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, ++$m[$mp]];
-$👎 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, --$m[$mp]];
-$📝 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, $put($m[$mp])];
-$🤡 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) {
-    +!![] => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) {
-      $b => $loop(++$pc, ++$n),
-      $e => $n === +!![] ? ++$pc : $loop(++$pc, --$n),
-      default => $loop(++$pc, $n),
-    })($pc, -![])],
-    default => [$mp, ++$pc],
-};
-$🎪 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) {
-    +!![] => [$mp, ++$pc],
-    default => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) {
-      $e => $loop(--$pc, ++$n),
-      $b => $n === +!![] ? $pc+![] : $loop(--$pc, --$n),
-      default => $loop(--$pc, $n),
-    })($pc, -![])],
-};
-$🐘 = fn($p) => $z(fn($loop) => fn($m, $p, $b, $e, $mp, $pc) =>
-  isset($p[$pc]) && $loop($m, $p, $b, $e, ...($p[$pc]($m, $p, $b, $e, $mp, $pc)))
-)($mm(+!![], +(![].![])), $p, $id($🤡), $id($🎪), +!![], +!![]);
-
-$🐘([
-  $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-  $🤡,
-    $👉, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-    $👈, $👈, $👈, $👈, $👎,
-  $🎪,
-  $👉, $👍, $👍, $👍, $👍, $👍, $📝,
-  $👎, $👎, $📝,
-  $👉, $👎, $👎, $👎, $📝,
-  $👉, $👎, $👎, $👎, $📝,
-  $👎, $👎, $📝,
-  $👎, $📝,
-  $👈, $📝,
-  $👉, $👉, $👎, $👎, $📝,
-  $👍, $👍, $👍, $👍, $👍, $👍, $👍, $📝,
-  $👈, $👎, $👎, $👎, $👎, $📝,
-  $👈, $📝,
-  $👉, $👍, $👍, $📝,
-  $👉, $👎, $📝,
-  $👈, $📝,
-]);
-

この問題は、単に適切なバージョンの PHP で動かせばトークンが得られる。

-

解説

-

絵文字

-

まず目につくのは大量の絵文字だろう。 -PHP は識別子に使用できる文字の範囲が広く、絵文字も使うことができる。

-

プログラム全体

-

Brainf*ck のインタプリタとプログラムになっている。 -Brainf*ck とは、難解プログラミング言語のひとつであり、ここで説明するよりも Wikipedia の該当ページを読んだ方がよい。

-

https://ja.wikipedia.org/wiki/Brainfuck

-

なお、brainf*ck プログラムを普通の書き方で書くと、次のようになる。

-
+ + + + + + + + + +
-[
-  > + + +
-  > + + + + +
-  > + + + + + + + + + + + +
-  > + + + + + + + + + +
-  < < < < -
-]
-> + + + + + .
-- - .
-> - - - .
-> - - - .
-- - .
-- .
-< .
-> > - - .
-+ + + + + + + .
-< - - - - .
-< .
-> + + .
-> - .
-< .
-

実行結果はこちら: https://ideone.com/22VWmb

-

それぞれの絵文字で表された関数が、各命令に対応している。

-
    -
  • $👉: >
    • -
  • $👈: <
    • -
  • $👍: +
    • -
  • $👎: -
    • -
  • $📝: .
    • -
  • $🤡: [
    • -
  • $🎪: ]
    • -
-

, (入力) に対応する関数はない (このプログラムでは使わないので用意していない)。

-

なお、$🐘 はいわゆる main 関数であり、プログラムの実行部分である。

-

絵文字の選択

-

おおよそ意味に合致するよう選んでいるが、$🤡 と $🎪 は弊社デジタルサーカスにちなんでいる。 -また、$🐘 は PHP のマスコットの象に由来する。

-

strict_types

-

declare 文の strict_types に指定できるのは、0 か 1 の数値リテラルだが、 -0x0 や 0b1 のような値も受け付ける。 -今回は、PHP 8.1 から追加された、0O または 0o から始まる八進数リテラルを使った。

-

URL

-

ソースコードのライセンスを示したこの部分だが、

-
https://creativecommons.org/publicdomain/zero/1.0/
-

完全に合法な PHP のコードである。 -https: 部分はラベル、// 以降は行コメントになっている。

-

リテラルなしで数値を生成する

-

ソースコード中に、ほとんど数値リテラルが書かれていないことにお気づきだろうか。 -PHP では、型変換を利用することで任意の整数を作り出すことができる。

-
assert(0 === +!![]);
-assert(1 === +![]);
-assert(2 === ![]+![]);
-assert(3 === ![]+![]+![]);
-assert(10 === +(![].+!![]));
-

[] に ! を適用すると true が返ってくる。それに + -を適用すると、bool から int ヘの型変換が走り、1 が生成される。10 -はさらにトリッキーだ。まず 1 と 0 を作り、. で文字列として結合する -('10')。これに + を適用すると、string から int -への型変換が走り、10 が生まれる (コード量に頓着しないなら、1 を 10 -個足し合わせてももちろん 10 が作れる)。

-

また、error_reporting に指定しているのは -1 である。 -これは、! によって文字列を false にし、+ によって false を 0 にし、さらにビット反転して -1 にしている。

-

if 文なしで条件分岐

-

三項演算子ないし match 式を使うことで、if を一切書かずに条件分岐ができる。 -また、&& / || も使えることがある。 -遅延評価が不要なケースでは、[$t, $f][$cond] のような形で分岐することもできる。

-

while、for 文なしでループ

-

不動点コンビネータを使って無名再帰する (詳しい説明は省略する。これらの単語で検索してほしい)。 -ここでは、一般に Z コンビネータとして知られるものを使った ($z)。

-

実際のところ、$🤡 や $🎪、$🐘 は、一度 Scheme (Lisp の一種) で書いてから PHP に翻訳する形で記述した。

-

なお、PHP は末尾再帰の最適化をおこなわない (少なくとも今のところは) ので、 -あまりに長い brainf*ck プログラムを書くとスタックオーバーフローする。

-

第2問 riddle.php

-

ソースコードはこちら。実行には PHP 8.0 以上が必要なので注意。

-
<?php
-
-/*********************************************************
- * This program displays a PHPer token.                  *
- * Guess 'N'.                                            *
- *                                                       *
- * Hints:                                                *
- * - N itself has no special meaning, e.g., 42, 8128,    *
- *   it is selected at random.                           *
- * - Each element of $token represents a single letter.  *
- * - One letter consists of 5x5 cells.                   *
- * - Remember, the output is a complete PHPer token.     *
- *                                                       *
- * License:                                              *
- *   https://creativecommons.org/publicdomain/zero/1.0/  *
- *********************************************************/
-const N = 0 /* Change it to your answer. */;
-assert(0 <= N && N <= 0b11111_11111_11111_11111_11111);
-
-$token = [
-  0x14B499C,
-  0x0BE34CC, 0x01C9C69,
-  0x0ECA069, 0x01C2449, 0x0FDB166, 0x01C9C69,
-  0x01C1C66, 0x0FC1C47, 0x01C1C66,
-  0x10C5858, 0x1E4E3B8, 0x1A2F2F8,
-];
-foreach ($token as $x) {
-  $x = $x ^ N;
-
-  $x = sprintf('%025b', $x);
-  $x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-  $x = implode("\n", str_split($x, length: 5));
-  echo "{$x}\n\n";
-}
-

さて、この問題はさきほどのように単純に実行しただけでは、謎のブロックが表示されるだけでトークンは得られない。 -トークンを得るためには、ソースコードを読み、定数 N を特定する必要がある。

-

ここでは、私の想定解を解説する。

-

読解

-

まずはソースコードを読んでいく。

-
$token = [
-  // 略
-];
-

数値からなる $token があり、各要素をループしている。

-
  $x = $x ^ N;
-

まずは排他的論理和 (xor) を取り、

-
  $x = sprintf('%025b', $x);
-

二進数に変換して、

-
  $x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-

0 を空白に、1 を # にし、

-
  $x = implode("\n", str_split($x, length: 5));
-

5文字ごとに区切ったあと、改行で結合している。

-

ヒント

-

次に、ソースコードに書いてあるヒントを読んでいく。

-
    -
  • N それ自体は、42 や 8128 といったような特別な意味を持たず、ランダムに決められている
    • -
  • $token の各要素は、1文字を表す
    • -
  • 1文字は 5x5 のセルからなる
    • -
  • 出力されるのは、完全な PHPer トークンである
    • -
-

ここで、PHPer トークンは必ず # 記号から始まることを思いだすと、 -$token の最初の数字 0x14B499C は、変換の結果 # になるのではないかと予想される (なお、このことは、リポジトリの README ファイルに追加ヒントとして書かれている)。

-

解く

-

ここまでわかれば、あと一歩で解ける。すなわち、0x14B499C が # に変換されるような N を見つければよい。

-

N は高々

-
assert(0 <= N && N <= 0b11111_11111_11111_11111_11111);
-

なのでブルートフォースしてもよいが、ここではブルートフォースしない方法を紹介する。

-
<?php
-
-$x = 0x14B499C;
-
-$x = $x ^ N;
-
-$x = sprintf('%025b', $x);
-$x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-$x = implode("\n", str_split($x, length: 5));
-
-assert($x ===
-  " # # \n" .
-  "#####\n" .
-  " # # \n" .
-  "#####\n" .
-  " # # ");
-

この一連の変換に対する逆変換を考えると、次のようになる。

-
<?php
-
-$x =
-  " # # \n" .
-  "#####\n" .
-  " # # \n" .
-  "#####\n" .
-  " # # ";
-
-$x = implode('', explode("\n", $x));
-$x = str_replace(search: [' ', '#'], replace: ['0', '1'], subject: $x);
-$x = bindec($x);
-
-$n = $x ^ 0x14B499C;
-
-echo "N = $n\n";
-

これを実行すると、N が得られる。

-

第3問 toquine.php

-

ソースコードはこちら。

-
<?php
-
-// License: https://creativecommons.org/publicdomain/zero/1.0/
-// This is a quine-like program to generate a PHPer token.
-// Execute it like this: php toquine.php | php | php | php | ...
-
-$s = <<<'Q'
-<?cuc
-// Yvprafr: uggcf://perngvirpbzzbaf.bet/choyvpqbznva/mreb/1.0/
-// Guvf vf n dhvar-yvxr cebtenz gb trarengr n CUCre gbxra.
-// Rkrphgr vg yvxr guvf: cuc gbdhvar.cuc | cuc | cuc | cuc | ...
-%f$f = %f;
-$f = fge_ebg13($f); $kf = [
-%f,
-];
-$g = ahyy.snyfr; sbe ($v = 0; $v <= vagqvi(__YVAR__-035,6); ++$v) vs (!vffrg($kf[$v])) oernx; ryfr
-$g .= vzcybqr("\a", fge_fcyvg(fge_ercynpr(['0','1'], ['  ','##'], fcevags(pue(37) . '025o', $kf[$v])), 012)) . "\a\a";
-$jf = neenl_znc(sa($j) => vzcybqr(', ', $j), neenl_puhax(neenl_znc(sa($k) => fcevags('0k' . pue(37) . '07K', $k), $kf), 10));
-cevags($f, $g, fge_ebg13("<<<'Q'\a{$f}\aQ"), vzcybqr(",\a", $jf));
-Q;
-$s = str_rot13($s); $xs = [
-0x0AFABEA, 0x1F294A7, 0x1F2109F, 0x1F294A7, 0x0002800, 0x1F2109F, 0x0117041, 0x1F294A7, 0x1FAD6B5, 0x1F295B7,
-0x010FC21, 0x1FAD6B5, 0x1151151, 0x010FC21, 0x1F294A7, 0x1F295B7, 0x1FAD6B5, 0x1F294A7, 0x1F295B7, 0x1F8C63F,
-0x1F8C631, 0x1FAD6B5, 0x17AD6BD, 0x17AD6BD, 0x1F8C63F, 0x1F295B7,
-];
-$t = null.false; for ($i = 0; $i <= intdiv(__LINE__-035,6); ++$i) if (!isset($xs[$i])) break; else
-$t .= implode("\n", str_split(str_replace(['0','1'], ['  ','##'], sprintf(chr(37) . '025b', $xs[$i])), 012)) . "\n\n";
-$ws = array_map(fn($w) => implode(', ', $w), array_chunk(array_map(fn($x) => sprintf('0x' . chr(37) . '07X', $x), $xs), 10));
-printf($s, $t, str_rot13("<<<'D'\n{$s}\nD"), implode(",\n", $ws));
-

コメントにもあるとおり、次のようにして実行すれば答えがでてくる。

-
$ php toquine.php | php | php | php | ...
-

実際にはもう少しパイプで繋げなければならない。

-

解説

-

プログラム全体

-

コメントにもあるとおり、これは quine (風) のプログラムになっている。 -Quine とは、自分のソースコードをそっくりそのまま出力するようなプログラムのことである。

-

このプログラムは、実行すると自身とほとんど同じプログラムを出力する。 -異なるのはトークンになっている部分のみである。

-

トークン

-

$xs がトークンに対応している。変換のロジックは riddle.php とほぼ同じなので省略する。

-

状態保持

-

トークンの何文字目まで出力したかを、ソースコードを変えずに (quine なので) 覚えておく必要がある。 -このプログラムでは、トークンが出力されるとソースコードがだんだんと長くなっていくのを利用して、__LINE__ から情報を取得している。

-

ROT 13

-

Quine は、素朴に書くとプログラムの一部が 2回記述されてしまう。 -これがあまり美しくないので、toquine.php では、ROT 13 変換を使って難読化した。

-

それにしてもなぜこんなものが標準ライブラリに……。

-

おわりに

-

解いていただいたみなさん、また、難易度調整につきあっていただいた社内のみなさん、ありがとうございました。

-

今回は直前に作りはじめたのもあり、3問だけかつ使い古されたネタばかりになってしまいましたが、 -来年は 5問、より面白い問題を持っていきます。

-

実はもう作りはじめているので、どうか来年もありますように……。

-]]> - - - - PHPerKaigi 2021 - https://blog.nsfisis.dev/posts/2021-03-30/phperkaigi-2021/ - Tue, 30 Mar 2021 23:22:40 +0900 - - https://blog.nsfisis.dev/posts/2021-03-30/phperkaigi-2021/ - PHPerKaigi 2021 参加レポ -

2021-03-26 から 2021-03-28 にかけて開催された、PHPerKaigi 2021 に一般参加者として参加した。 -弊社デジタルサーカス株式会社 (今年1月から勤務) はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。

-

このようなカンファレンスには初めて参加するのでかねてより心待ちにしていたのだが、生憎2日目から体調を崩してしまい、この記事も途中までとなっている。まだ見ていないセッションも多いが、ひとまず現時点での参加レポを書いておく。

-

発表はトラック A、B に分かれていたのだが、今回はすべて A トラックを視聴している (切り替えるのが面倒だっただけ)。

-

凡例

-
-

発表・スライドのメモ (引用ではない)

-
-

感想など

-

Day 0 前夜祭 (2021/03/27)

-

17:30 [A]

-

PHP で AWS Lambda

-
-

Rails のプロジェクトを PHPer のメンバのみでメンテ -→他のメンバもわかる PHP にリプレースを検討

-

サーバレス

-
    -
  • サーバ・インフラの管理が不要
    • -
  • アプリケーションコードの知識だけで保守可能
    • -
-

ゼロベースで作れる案件が (Railsの件とは別に) あるため、そちらで試験的に導入?

-

AWSの学習 -AWS のドキュメント -DevelopersIO

-

AWS Lambda のカスタムランタイムで PHP を動かす

-

サーバのセットアップや維持管理を気にしなくて良い -サーバーレスで PHP を動かすツールがすでにある -サーバーレス構築はすんなり

-

今は Laravel がルーティングしている -Laravel Livewire を Lambda に載せられないか？ -デプロイ方法は？ -バッチ処理は？ (Lambda は 15分の制限)

-

Lambda でコンテナイメージがサポートされるように

-

抽象化されたもの「だけ」しか知らないよりも具象の理解は助けになる

-
-

AWS Lambda のような Function as a Service はマイクロサービス化における一つの到達点に思えるのだが、これを使って実際に web サービスを作る具体的なイメージがまだ見えない (注: すべて for me として書いている)。

-

PHP on AWS Lambda があれだけ簡単に動かせるのには驚いた。

-

勝手に AWS Lambda だとフットプリントの軽さが求められそう (= PHP + Laravel などでは動かなさそう) だという先入観を持っていたのだが、この発表のデモによればそうでもないらしい。

-

18:10 [A]

-

大規模サイトの SEO

-
-

大規模サイト (100万ページ以上) -Google の基準

-

クロールバジェットを意識したSEO

-

大規模サイトでコンテンツが中頻度 (1回/週) で更新 OR 中規模サイト (10,000以上) でコンテンツが目まぐるしく変更される -これを満たさないなら、クロールバジェットを考えなくてもいい

-

サーチコンソール -「カバレッジ」の「除外」 -多すぎるのは問題→クロールバジェットを浪費している

-
    -
  • クエリの順番を決める
    • -
  • 空の値のルールを決めておく
    • -
  • リダイレクトすればインデックスはうまくいく
    • -
  • リンクが存在する限りクロールはされる
    • -
-

リニューアル前のURL

-

インデックスは移行される -リンクのURLが存在する限り、別のURLとしてクロールされる -リダイレクトされるとはいえ、リニューアル前のURLは移行した方が良い -リニューアルで無視されるようになったパラメータも注意

-

robotes.txt で拒否しているのにクロールされる -一時的に拒否を外して 404 や 301 を読ませる -内部リンクを確認する -JS でのリンクに書き換え

-

クエリパラメータからURLのパスに -/tokyo?area=HOGE → /tokyo/HOGE

-

URL 設計だいじ

-
-

SEO (Search Engine Optimization) は大して知らないので新鮮な話が多かった。その分語れることも少ない……。

-

18:50 [A]

-
-

知覚可能 -操作可能 -理解可能 -堅牢 ちゃんとしたHTMLを書く (閉じタグ・入れ子構造など)

-
    -
  • -

    標準の HTML を適切に使う

    -
    • -
  • -

    WAI-ARIA

    -
    • -
  • -

    キーボードフレンドリー

    -
    • -
  • -

    マシンフレンドリー

    -
    • -
  • -

    SEOフレンドリー

    -
    • -
-

button タグ -→キーボード -h1 タグ -→スクリーンリーダー・クローラ -a タグ

-

WAI-ARIA -HTML では表現できないセマンティクスを追加する

-
    -
  • ロール -
      -
    • 何をするのか？
      • -
    • ユーザーアクションによって変化しない
      • -
    -
    • -
  • プロパティ -
      -
    • 関連づけられたデータ
      • -
    -
    • -
  • ステート -
      -
    • 現在の状態
      • -
    -
    • -
-

まずは標準の HTML 要素で解決する -何でもかんでも WAI-ARIA を使えばいいというものではない

-

マウスホバーでツールチップが出てくるが、キーボード操作では出てこない

-

VoiceOver

-

全ての属性を使う必要はない -あくまでアクセシビリティを上げるための方法の一つにすぎない

-
-

つい最近 WAI-ARIA についての記事を読んだばかりだったので個人的にタイムリーな話題だった。(あまりこの言葉を使いたくないのだが) いわゆる「健常者」にとって、こうした問題を普段の生活の中で意識するのは難しい。だからこそ情報へのアンテナは張っておくようにしたい。

-

19:30 [A]

-

PHP で FUSE

-

個人的に楽しみだった発表。

-
-

VFS (virtual filesystem) vs 具体的なファイルシステム

-

最適な実装方法は状況により異なる

-

アプリケーションに見せるAPIは変えずに実装を隠蔽する→VFS

-

カーネルのプログラムを作るのは難しい

-
    -
  • 権限がデカすぎる
    • -
  • システム全体がクラッシュ
    • -
  • セキュリティリスク
    • -
  • 開発サイクルを回しづらい
    • -
  • ネイティブコードにコンパイルされる言語である必要がある
    • -
-

Filesystem in USEr space (FUSE)

-
    -
  • 特定の C の関数を呼ぶことで filesystem が作れる
    • -
  • FFI を持つ言語なら FUSE が使える
    • -
-

SSHFS / s3fs / Docker Desktop

-

Linux 以外でも使える

-
    -
  • dokany (on Windows)
    • -
  • osxfuse
    • -
-

VFS: システムコールが呼ばれると、ファイルシステムによってコール -FUSE: カーネル空間からユーザ空間へ通信

-

高レベルなラッパで型をつける

-

PHP 以外では Wordpress を FUSE にマウントする実装がある (C, Python など)

-
    -
  • grep できる
    • -
  • sed できる
    • -
  • 編集できる
    • -
-
-

期待通りの興味深い発表だった。FUSE 自体も今回の発表で知ったのだが、これ本体の実装を見るのも面白そうだ。 -この発表を聞きながらファイルシステムにマウントできそうなものを考えていたのだが、およそ木構造をしているものすべてと言えそうだ (ハンマーしか持っていないと云々)。何かできそうだがなかなか思いつかない。

-

Day 1 (2021/03/27)

-

10:50 [A]

-

ATDD

-
-
    -
  • ユーザーストーリー
    • -
  • ユニットテスト
    • -
  • CI/CD
    • -
-

ユーザストーリーの受け入れ条件が曖昧になりがち -デグレチェックがユニットレベルでは収まらない場合、手動で同じシナリオをテストしている

-

Q2の強化 -アジャイルテストの4象限

-

技術面/ビジネス面 -開発チーム支援(コーディング前・コーディング中)/製品批評(コーディング後)

-
    -
  • Q1: 技術面 & チーム支援 -
      -
    • TDD
      • -
    • ユニットテストなど
      • -
    -
    • -
  • Q2: ビジネス面 & チーム支援 -
      -
    • ATDD
      • -
    • ビジネス面の受け入れテストで駆動する
      • -
    -
    • -
-

Agile Alliance -ユーザストーリーのスキルレベルを高める

-

テストピラミッド

-
    -
  • -

    UI Tests

    -
    • -
  • -

    Service Tests

    -
    • -
  • -

    Unit Tests

    -
    • -
  • -

    異なる粒度のテストを書く

    -
    • -
  • -

    高レベルになるほど、持つべきテストは少なくなる

    -
      -
    • ピラミッド型になる
      • -
    -
    • -
-

高レベルテストが多すぎる→アイスクリームコーン　アンチパターン

-

ATDD (Acceptance TDD) -API経由・UI経由での高レベルテスト E2E test

-

ストーリ受け入れテスト

-

入れ子のフィードバックループ -ATDD(外側) と TDD(内側)

-

外部品質・内部品質

-

バーティカルスライスのデリバリー

-
    -
  • cucumber
    • -
  • gauge
    • -
  • behat
    • -
-

ユビキタス言語 -手動テストもspecに書く -自動化は可能だがコスパが悪い -失敗することがわかっているテスト(レッドテスト)はCIから外す -失敗時の原因究明が難しい -饒舌なエラーメッセージ -状況のスナップショット

-

Continuous Testing

-
-

User Acceptance Test (UAT) くらいの規模になると個人開発・趣味開発では触れない領域なので、大いに勉強になった。スライドに添付されている資料が相当に充実していたので、これを読むのが本番といった様相すら感じる。 -高レベルテストの自動化は現在のプロジェクトでも感じており、自動化のチャンスは伺っている。とはいえセッションでも指摘されているように自動化することにコストがかかりすぎる領域があるのも事実で、そのバランスが難しい。

-

11:50 [A]

-

型解析を用いたリファクタリング

-

型のある世界で生きてきた身として大いに楽しみにしていた発表。

-
-
    -
  • PHPStan
    • -
  • Phan
    • -
  • Psalm
    • -
-

autoload も認識できる -bootstrapFiles

-

編集箇所と利用箇所を CI でチェック -ルールレベルを徐々に引き上げていく -警告が多すぎると見落としてしまう・無視されやすくなる

-

型がついていないことによるエラーが多い

-

型よりも詳細な検査 Util_Assert::min

-

SQL を静的解析 -placeholder の型付け

-

警告レベルを低いレベルから導入 -タイプヒントを積極的に書いていく -PHPStan の拡張を追加する

-
-

昨今、動的型付き言語での型宣言・型アノテーション・型ヒントの導入が相次いでいる。長らく静的型付き言語を書いてきた私からすると、ようやく気づいたかといったところだが、ともかく型を導入する言語が増えてきた。 -今のプロジェクトでも新しく追加するコードには型をつけるよう努めているが、どうしても古いコードには型がついていない。個人的には型のないコードに対してどう型を自動的に付けるかという点に興味があり、その点で Ruby の typeprof には注目している。

-

12:30 [A]

-

昼食をとっていた。事前に何か食料を買っておくべきだった。

-

13:10 [A]

-

Documentation as Code

-

この発表も以前から非常に楽しみにしていた。

-
-

開発開始までのオーバーヘッド -新規にチームにジョイン -担当範囲外の機能を理解 -オンボーディングのコスト

-

PHPerKaigi 2020 で発表あり

-

継続的にシステムの理解を助けるドキュメント

-

継続的ドキュメンテーション -システムとドキュメントの乖離

-

書いてあることが間違っている・足りない

-
    -
  • 徐々にずれていく
    • -
  • システムの更新タイミングとドキュメントの更新タイミングに差がある
    • -
-

システムとドキュメントは対応関係がある

-
    -
  • 間違ったドキュメント
    • -
  • 存在しないドキュメント
    • -
-

システムとドキュメントの乖離を定量化する -継続的に -システムの更新に近いタイミングで ドキュメントを更新し続ける

-

Documentation as Code

-

コードと同じツールでドキュメントを書く

-
    -
  • issue tracker
    • -
  • vcs
    • -
  • plain text markup
    • -
  • automation
    • -
-

開発者 -システム -ドキュメント -構造化データ -ソフトウェア

-

システムから構造化データを抽出する -PHPDoc -OpenAPI

-

ビュー 関心ごとに合わせてアーキテクチャを一つ以上の側面(断面)で説明する

-

ビューの単位でドキュメントに

-

スタックトレースからのドキュメント生成

-
-

ドキュメントの管理は現プロジェクトでも課題と感じている。作られた当初は正しくても、実態と乖離していくのを止めるのは困難を極める。全体的に興味深い発表だったが、特にスタックトレースからのドキュメント生成というアイデアに惹かれるものを感じた。スタックトレースという実態と不可分な (乖離しない) 情報を起点にするのは理にかなっている。問題はトレースをいつ、どう取るかだろうか。それを自動化しなければ、実態との乖離が避けられないだろう。

-

14:10 [A]

-

cookie による session 管理

-

全体的に基本的な話だったので特に触れない。Cookie やセッションの話としては非常に分かりやすくまとめられていたので、知らない人が学ぶにはいい教材だろう。

-

14:50 [A]

-

PHP のエラーと例外

-
-

エラー PHPエンジンがエラーを通知する -例外 プログラムが投げる

-

PHP7-8とエラー

-

PHPエンジンのエラーの一部が \Error に変換されるようになった -→ try-catch で捕捉できる

-

\Error は例外とは異なる

-

PHP8 でエラーレベルの引き上げ

-
    -
  • 捕捉すべきもの -
      -
    • recoverable
      • -
    -
    • -
  • 捕捉すべきでないもの -
      -
    • unrecoverable
      • -
    • 開発時に対処できるもの
      • -
    -
    • -
-

例外

-
    -
  • 捕捉して事後処理
    • -
  • 捕捉せず(or 捕捉した上で)さらに上に是非を問う
    • -
-

開発段階で例外を把握し、ハンドリングを考えておく

-

\Throwable \Exception と \Error

-

\Error はキャッチすべきでない

-
    -
  • -

    \Error

    -
      -
    • 本番で起きてはいけない
      • -
    -
    • -
  • -

    \LogicException

    -
      -
    • 本番で起きてはいけない -→生じないのだから捕捉もしない
      • -
    -
    • -
  • -

    \RuntimeException

    -
      -
    • 起こるかもしれないので本番環境でも考慮する
      • -
    -
    • -
-

捕捉して対応するのではなく、未然に防ぐ

-

独自例外を使う -\Exception を投げてしまうと、 -catch (\Exception)せざるを得ない -→catch 範囲が広すぎる

-

SPL の例外を使う

-

例外翻訳 -上位のレイヤが下位のレイヤの例外を捕捉し、上位レイヤのAPIに「翻訳」する -下位レイヤの知識に依存させない

-

@throws -捕捉してほしい例外を書き連ねておく

-

呼び出しもとに負わせたい責任

-
-

PHP を学んでいる途中の私としては、今まさに聞きたい発表だった (現時点で PHP を書き始めてから 4ヶ月ほどになる)。

-

個人的に例外やエラーを最もうまく扱っているのは Go、Swift、Rust、Haskell などのエラーを「値として」扱う言語だと思っている。try-catch は通常の処理フローを完全に壊してしまう上、構文としても重すぎる。値としてのエラー通知は C言語時代への回帰ともいえるが、その頃と異なるのはエラーを暗黙のうちに握り潰すことがないということだ。これらの言語は型を持っており、静的に検証ができる (C のそれはまともな型付けではない。念のため)。

-

PHP のように、すでに例外が言語システムに根ざしている言語ではどうすればよいか。この場合も同じく静的検証の力を借りることになるだろう。

-

15:30 [A]

-

Laravel のメール認証

-

Laravel の知識がない私にはまったくついていけなかった。また、個人的にタイトルがややミスリーディングに感じた。

-

16:10 [A]

-

gRPC

-
-

Unary RPCs -Server streaming RPCs -Client streaming RPCs -Bidirectional streaming RPCs

-

Protobuf

-

実装とAPIが乖離しにくい -自動生成 -複数言語でも相互に使える

-

マイクロサービスのサービス通信 -スマホアプリ -ゲームサーバ

-

PHP では？

-

PHP ではストリーミングが難しい -リクエストごとにプロセスが使い捨て

-

PHP ではgRPCのクライアントしか対応していない

-

gRPC-Web -ブラウザで扱うためのJSライブラリ+プロトコル

-

HTTP/1.1 でも使える -Unary RPC と Server streaming RPC のみ

-

Envoy -Nginx などで相互に gRPC と gRPC-Web で変換

-

Amp -イベント駆動な並行処理のフレームワーク

-

HTTP/2 対応

-

C#のgRPC-Webが楽

-
-

(発表の中でもまさに同じことをおっしゃっていたが) PHP 以外の方が向いているだろう、というのが第一の感想である。gRPC はそれ自体というよりも Protobuf というエコシステムに乗れることのメリットが大きいと感じる。そのエコシステムにうまく乗れない時点で、うーんという感じ。

-

16:50 [A]

-

アーキテクチャテスト

-
-

Independent Core Layer Pattern

-

開発初期のアーキテクチャが崩れる -アーキテクチャ観点のコードレビューができない

-

どこにクラスを置けばよいか？ -ドキュメントがない

-

アーキテクチャ設計に関する知識が属人化・暗黙知化

-

ガイドライン

-
    -
  • 最初にルールを決めるのは簡単
    • -
  • ルール通り作り始めるのも簡単 -
      -
    • →維持するのが難しい、人が決めたものゆえ壊れやすい
      • -
    -
    • -
-

PHP の特性

-
    -
  • クラスは public
    • -
  • 可視性の制御が public / protected / private のみ
    • -
  • 依存関係の制御が困難
    • -
-

アーキテクチャテスト -クラスの依存関係や実装ルールをコードとして表現し、自動テスト化する

-
    -
  • deptrac
    • -
  • phpat
    • -
-

Independent Core Layer Pattern

-

アーキテクチャテストの失敗

-
    -
  • 実装誤り
    • -
  • or アーキテクチャが適切でない -
      -
    • 開発の過程でフィードバックしていく
      • -
    -
    • -
-

モジュラーモノリス→マイクロサービスへ

-
-

Day 2 (2021/03/28)

-

冒頭に書いた通り、2日目から体調が悪くまともに聴けていない。途中までは頭痛を我慢しつつ見ていたのだが、まともに入ってこなかった。

-

残念ではあるが、いずれにせよ見られていない発表は他にもあるので、今週末にでもまとめて見ようと思う。

-

全体の感想

-

Day 2 にほとんど参加できなかったのは残念だが、イベント自体は大変楽しく、また興味深いものであった。自分がまったく知らない領域の話を聞けるのはこうしたイベントならではだと感じる。オンライン開催ゆえ現地に行く必要がなく、気軽に参加できたのも (特に初参加者として) 嬉しいポイントだった。

-

今回、雑談/登壇者への質問等向けに Discord サーバもあったのだが、こちらは参加こそしたものの ROM のままになってしまった。発表に1ウィンドウ、メモを書くのに1ウィンドウ、Discord 表示に 1ウィンドウで私にはもう脳のリソースとディスプレイのスペースが追いつかなかった (さらにいうと Zoom でアンカンファレンスもやっていたようだ。こちらはまったく参加していない)。

-

1つ個人的な反省点としては、一つ一つのセッションを真剣に聞き過ぎたというものがある。もっと適当に聞いておけばよかった。これだけだと大変語弊があるのだが、言い方を変えると、Discord しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。 -まあ初カンファレンスだし、とお茶を濁しておこう。

-

さて、カンファレンスで一つ気になったことがある。それは、Discord という書き込み場所が増えたことでニコ生のコメントの流量が吸い取られてしまったのではないか、という点だ。ニコニコだけ見ていると過疎っているかのように見えた発表も、Discord の方では盛り上がっている、というのを何度か見かけた。ニコニコのコメント方式は盛り上がりを如実に反映するが、逆もまたしかり。Discord があったこと自体はプラスだったと思うが、この点はマイナスだったのではないかと感じる。

-
-

最後になりましたが、毎年の PHPerKaigi 開催にご尽力されている皆様、スピーカーの皆様、楽しい3日間でした。ありがとうございました！ -(ずっと常体で書いてしまったのでいきなり仏頂面から笑顔になったようで気持ち悪い)

-

ではまた来年。

-]]> - - - - diff --git a/docs/tags/php/index.html b/docs/tags/php/index.html deleted file mode 100644 index e38f0a9..0000000 --- a/docs/tags/php/index.html +++ /dev/null @@ -1,117 +0,0 @@ - - - - - - - - php | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -

php

- -
-
-

PHPerKaigi 2023: ボツになったトークン問題 その 1

-
-
-

来年の PHPerKaigi 2023 でデジタルサーカス株式会社から出題予定のトークン問題のうち、 -ボツになった問題を公開する (その 1)。

-
-
- Posted on -
- -
-
-
-

[PHP] fizzbuzz を書く。1行あたり2文字で。

-
-
-

PHP で、fizzbuzz を書いた。ただし、1行あたりに使える文字数は2文字まで。

-
-
- Posted on -
- -
-
-
-

PHP カンファレンス沖縄で出題されたコードゴルフの問題を解いてみた

-
-
-

PHP カンファレンス沖縄の懇親会 LT で出題されたコードゴルフの問題を解いてみた。

-
-
- Posted on -
- -
-
-
-

PHPerKaigi 2022

-
-
-

2022-04-09 から 2022-04-11 にかけて開催された、PHPerKaigi 2022 に参加した。

-
-
- Posted on -
- -
-
-
-

PHPerKaigi 2022 トークン問題の解説

-
-
-

PHPerKaigi 2022 で私が作成した PHPer チャレンジ問題を解説する。

-
-
- Posted on , updated on -
- -
-
-
-

PHPerKaigi 2021

-
-
-

2021-03-26 から 2021-03-28 にかけて開催された、PHPerKaigi 2021 に参加した。

-
-
- Posted on -
- -
- - - - - - diff --git a/docs/tags/php/page/1/index.html b/docs/tags/php/page/1/index.html deleted file mode 100644 index 9d866e9..0000000 --- a/docs/tags/php/page/1/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - - https://blog.nsfisis.dev/tags/php/ - - - - - - diff --git a/docs/tags/phpcon/feed.xml b/docs/tags/phpcon/feed.xml deleted file mode 100644 index b5b8325..0000000 --- a/docs/tags/phpcon/feed.xml +++ /dev/null @@ -1,61 +0,0 @@ - - - - phpcon on REPL: Rest-Eat-Program Loop - https://blog.nsfisis.dev/tags/phpcon/ - Recent content in phpcon on REPL: Rest-Eat-Program Loop - Hugo -- gohugo.io - ja-JP - Sat, 27 Aug 2022 18:55:28 +0900 - - PHP カンファレンス沖縄で出題されたコードゴルフの問題を解いてみた - https://blog.nsfisis.dev/posts/2022-08-27/php-conference-okinawa-code-golf/ - Sat, 27 Aug 2022 18:55:28 +0900 - - https://blog.nsfisis.dev/posts/2022-08-27/php-conference-okinawa-code-golf/ - はじめに -

本日 PHP カンファレンス沖縄 2022 が開催された (らしい)。

-

カンファレンスには参加できなかったものの、懇親会の LT で出題されたコードゴルフの問題が Twitter に流れてきたので、解いてみた。

-

ツイート: https://twitter.com/m3m0r7/status/1563397620231712772
-スライド: https://speakerdeck.com/memory1994/php-conference-okinawa-2022-extra?slide=3

-

解

-

細かいレギュレーションは不明だったので、勝手に定めた。

-
    -
  • コマンドライン引数の第1引数で受けとる
    • -
  • 結果は標準出力に出す
    • -
  • コンマの直後にはスペースを1つ置く
    • -
  • 末尾コンマは禁止
    • -
  • 数字でないものは入ってこないものとする
    • -
  • 負数は入ってこないものとする
    • -
-

書いたものがこちら:

-
[<?php $n=$argv[1];foreach([1e4,5e3,2e3,1e3,500,100,50,10,5,1]as$x)for(;$n>=$x;$n-=$x)$r[]=$x;echo implode(', ',$r??[]);?>]
-

しめて 123 バイトとなった (末尾改行を含めずにカウント)。

-

こちらは改行とスペースを追加したバージョン:

-
[<?php
-
-$n = $argv[1];
-foreach ([1e4, 5e3, 2e3, 1e3, 500, 100, 50, 10, 5, 1] as $x)
-  for (; $n >= $x; $n -= $x)
-    $r[] = $x;
-echo implode(', ', $r ?? []);
-
-?>]
-

使用したテクニック

-

指数表記

-

割と多くの言語のゴルフで使えるテクニック。e を用いた指数表記で、大きな数を短く表す。このコードでは 10000、5000、2000、1000 を指数表記している。

-

foreach や for の中身を1つの文に

-

foreach、for、if などの後ろには、通常 { を続けて複数の文を連ねるが、中身の文を1つにしてしまえば、{ と } を省略できる。C言語などでも使える。

-

$r に初期値を入れない

-

PHP では、$r[] = ... のような配列の末尾に追加する式を実行したとき、$r が未定義だった場合は $r を勝手に定義して空の配列で初期化してくれる。これを利用すると、$r = []; のような初期化が不要になる。

-

ただし、プログラムに 0 が渡されるとループを一度も回らないので、$r が未定義になってしまい、implode() に渡すところでエラーになる。それを防ぐために $r ?? [] を使っている。

-

もし 0 が渡されたケースを無視するなら、これが不要になるので 4 バイト縮む。

-

PHP タグの外に文字列を置く

-

PHP では、<?php ?> で囲われた部分の外側にある文字列は、そのまま出力される。今回のケースでは、先頭と末尾に必ず [ と ] を出力するので、そのまま書いてやればよい。

-

おわりに

-

最後になりましたが、めもりー さん、楽しい問題をありがとうございました。

-]]> - - - - diff --git a/docs/tags/phpcon/index.html b/docs/tags/phpcon/index.html deleted file mode 100644 index d3d3cba..0000000 --- a/docs/tags/phpcon/index.html +++ /dev/null @@ -1,56 +0,0 @@ - - - - - - - - phpcon | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -

phpcon

- -
-
-

PHP カンファレンス沖縄で出題されたコードゴルフの問題を解いてみた

-
-
-

PHP カンファレンス沖縄の懇親会 LT で出題されたコードゴルフの問題を解いてみた。

-
-
- Posted on -
- -
- - - - - - diff --git a/docs/tags/phpcon/page/1/index.html b/docs/tags/phpcon/page/1/index.html deleted file mode 100644 index 736f0cb..0000000 --- a/docs/tags/phpcon/page/1/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - - https://blog.nsfisis.dev/tags/phpcon/ - - - - - - diff --git a/docs/tags/phperkaigi/feed.xml b/docs/tags/phperkaigi/feed.xml deleted file mode 100644 index 439bf91..0000000 --- a/docs/tags/phperkaigi/feed.xml +++ /dev/null @@ -1,974 +0,0 @@ - - - - phperkaigi on REPL: Rest-Eat-Program Loop - https://blog.nsfisis.dev/tags/phperkaigi/ - Recent content in phperkaigi on REPL: Rest-Eat-Program Loop - Hugo -- gohugo.io - ja-JP - Sun, 23 Oct 2022 09:54:07 +0900 - - PHPerKaigi 2023: ボツになったトークン問題 その 1 - https://blog.nsfisis.dev/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1/ - Sun, 23 Oct 2022 09:54:07 +0900 - - https://blog.nsfisis.dev/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1/ - はじめに -

2023 年 3 月 23 日から 25 日にかけて開催予定 (記事執筆時点) の、PHPerKaigi 2023 において、昨年と同様に、弊社デジタルサーカス株式会社 から、トークン問題を出題予定である。

-

昨年のトークン問題の記事はこちら: PHPerKaigi 2022 トークン問題の解説

-

すでに 2023 年用の問題は作成済みであるが、その制作過程の中でいくつかボツ問ができた。せっかくなので、PHPerKaigi 開催を待つ間に紹介しようと思う。

-

10 月から 2 月まで、毎月 1 記事ずつ公開していく予定 (忘れていなければ)。

-

問題

-

注意: これはボツ問なので、得られたトークンを PHPerKaigi で入力してもポイントにはならない。

-
<?php
-
-$π = $argv[1] ?? null;
-if ($π === null) {
-  exit('No input.');
-}
-$π = trim($π);
-if (!is_numeric($π)) {
-  exit('Invalid input.');
-}
-
-$s = implode(array_map(chr(...), str_split($π, 2)));
-
-preg_match('/(\x23.+?) /', $s, $m);
-$t = $m[1] ?? '';
-
-if (md5($t) === '056e831a4146bf123e8ea16613303d2e') {
-  echo "Token: {$t}\n";
-} else {
-  echo "Failed.\n";
-}
-

トークン入手方法

-

ソースを見るとわかるとおり、$argv[1] を参照している。それを $π なる変数に代入しているので、円周率を渡してみる。

-
$ php Q.php 3.14
-Failed.
-

失敗してしまった。精度を上げてみる。

-
$ php Q.php 3.1415
-Failed.
-

だめだった。これを成功するまで繰り返す。

-

最初にトークンが得られるのは、小数点以下 16 桁目まで入力したときで、こうなる。

-
$ php Q.php 3.1415926535897932
-Token: #YO
-

めでたくトークン「#YO」が手に入った。

-

解説

-

短いので頭から追っていく。

-
$π = $argv[1] ?? null;
-if ($π === null) {
-  exit('No input.');
-}
-$π = trim($π);
-if (!is_numeric($π)) {
-  exit('Invalid input.');
-}
-

入力のバリデーション部分。数値のみ受け付ける。

-
$s = implode(array_map(chr(...), str_split($π, 2)));
-

$π を 2 文字ごとに区切り (str_split)、数値を ASCII コードと見做して文字に変換 (chr) して結合 (implode) している。

-

例えば、$π が '656667' だったとすると、65、66、67 に対応した 'A'、'B'、'C' へと変換され、'ABC' になる。

-
$π = '656667';
-$s = implode(array_map(chr(...), str_split($π, 2)));
-echo $s;
-// => ABC
-
preg_match('/(\x23.+?) /', $s, $m);
-$t = $m[1] ?? '';
-

正規表現でマッチングしている。\x23 は # と同じであることに留意すると、この正規表現は「# から始まる 2 以上の長さ (含 #) の文字列で、最初に現れるスペースまで」にマッチする。つまりこれは、PHPerKaigi におけるトークンである。

-

なお、# を直接書いていないのは、/#.+?) / と書くと、#.+?) という意図せぬトークンが登録されてしまうからである。

-
if (md5($t) === '056e831a4146bf123e8ea16613303d2e') {
-  echo "Token: {$t}\n";
-} else {
-  echo "Failed.\n";
-}
-

最後にトークンのハッシュ値を見て、想定解かどうかを確認する。

-

おわりに

-

円周率を何桁も計算して ASCII コード経由で文字列化すれば、トークンっぽいものがどこかで出てくるのではないか、と考えて生まれた作品。

-

最初は真面目に円周率の計算プログラムを組んでいたのだが、いざ動かしてみるとやけに浅いところにあったので驚いた (ちなみに、それでも M_PI や pi() では精度が足りない)。見つけたときは狂喜したものの、冷静になってみると大して面白くなかったのでボツになった。むしろ、100 万桁目くらいに埋まっていてくれたほうがよかったかもしれない。

-]]> - - - - PHPerKaigi 2022 - https://blog.nsfisis.dev/posts/2022-05-01/phperkaigi-2022/ - Sun, 01 May 2022 09:41:39 +0900 - - https://blog.nsfisis.dev/posts/2022-05-01/phperkaigi-2022/ - はじめに -

2022-04-09 から 2022-04-11 にかけて開催された、PHPerKaigi 2022 に、一般参加者として参加した。 -弊社デジタルサーカス株式会社 はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。

-

昨年のレポートはこちら。

-

感想

-

厳選おすすめトーク

-

多くの素晴らしいトークの中から、特におすすめのものを 5つ選んだ。是非聞いてほしい。引用部分は、リンク先プロポーザルから引用している。

-

予防に勝る防御なし - 堅牢なコードを導く様々な設計のヒント

-
-

PHP はバージョンを追う毎に型宣言、例外、表明、列挙型などの機能が大幅に強化され、堅牢なコードを書くための機能が充実してきました。それらの機能はどう使うと効果的なのでしょうか。

-

本講演では PHP 8.1 をベースにして、誤りを想定してチェックするのではなく、そもそも誤りにくい設計とはどのようなものか、つまり「予防」の観点を軸足に、堅牢なコードを導くための様々な設計のヒントをご紹介します。

-
-

PHPのエラーを理解して適切なエラーハンドリングを学ぼう

-
-

PHPを使ってるとよく遭遇する Fatal error / Parse error / Warning / Notice 理解していますか？
-これらのエラー文を理解することで、すぐにエラーの原因に気付き適切に対象できる様になります！
-またそれらを理解した上でのエラーハンドリングを学びましょう。

-
-

エラー監視とテスト体制への改善作戦

-
-

毎日流れてくるエラーに皆さんはどう向き合ってますか？
-エラーを出さない事が一番ですが、完全に塞ぐ事は難しいと考えます。
-サービス運用の中で本番環境から発生するエラー（サーバー・クライアントサイド・サードパーティ起因のエラー）への監視体制と、
-エラー・バグ防御のためチームで行っているテストコード文化づくりの話をします。

-
-

ISUCON11のPHP実装は、何を考え、どのようにして作られていたのか

-
-

昨年開催されたISUCON11にて問題（参考実装）のPHPへの移植を担当させていただきました。

-

最終的なソースコードこそシンプルなWebアプリケーションではありますが、その裏には
-・「（私の思う）良い設計」を実現するための意思決定
-・「ISUCONの問題」という位置付けに由来する取捨選択
-・移植中に遭遇したトラブルとその解決策
-といった文脈や葛藤が存在しています。

-

本発表はそれらを共有することで
-・PHPアプリケーションの設計、実装事例として役立ててもらう
-・ISUCONの言語移植に興味を持ってもらう
-・ISUCON問題移植の「実装や設計の練習をする教材」としての可能性を知ってもらう
-ことを目的とします。

-
-

チームの仕事はまわっていたけど、メンバーはそれぞれモヤモヤを抱えていた話──40名の大規模開発チームで1on1ログを公開してみた

-
-

サイボウズの大企業向けグループウェアのGaroon（ガルーン）は、PHPで開発されている20年目の製品です。ガルーン開発チームは日本で40名、ベトナムで50名の計90名ほどのチームになっています。また、コロナ禍でフルリモートでの活動がこの2年ほど継続してきました。

-

フルリモートになっても仕事はまわっており、継続的にリリースはしていましたが、一方でお互いの考えていることや感じている問題意識が見えづらくなり、モヤモヤを抱えているメンバーが増えていました。

-

このセッションでは、そういう状況で私がチーム外からジョインし、聴き役に徹しながら見える化することで状況を改善していった取り組みを紹介します。同じように大きなチームやリモートワークで難しさを感じている人に、難しさの原因への気づきや取り組みへのヒントがあれば幸いです。

-
-

トークン問題の作成

-

今回は、PHPer チャレンジ用に弊社のトークン問題を 3題作成した。こちらについては別途記事にしているので、そちらを参照されたい。

-

PHPer チャレンジ

-

1位になった。
-また、賞品として Echo Show 15 をいただいた。

-

カンファレンス全体への感想

-

去年の参加レポ では、こんなことを書いた。

-
-

1つ個人的な反省点としては、(中略) Discord しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。
-まあ初カンファレンスだし、とお茶を濁しておこう。

-
-

この反省を踏まえ、今年は積極的にほかの場 (公式の Discord サーバや、アンカンファレンス) にも参加した。
-これにより、参加体験の質がはるかに向上した。特に Discord に関しては、登壇者ご本人による補足や、質問への回答などがおこなわれる (ことが多い) ため、特別な理由のない限り、発言はしないまでも参加はしておいたほうが良いと思われる。

-

なお、アンカンファレンスについては、1日目の終わりにトークン問題の解説放送もおこなった。

-

また、今年はオフラインとオンラインのハイブリッド開催であったが、去年の全オンラインと比べて、オンライン参加の体験が落ちていなかったのは、特筆すべきであろう。 -今年は 3回目のワクチン接種が間に合わなかったこともあり現地参加は見送ったのだが、来年は是非オフラインで参加したい。

-

そして来年へ……?

-

PHPerKaigi 2023 があるかどうか存じ上げないが、あるとすれば、次の 4つを目標としたい。

-
    -
  • プロポーザルを出す
    • -
  • PHPer チャレンジのトークン問題を 5題作成する
    • -
  • 現地に行く
    • -
  • PHPer チャレンジで圧勝する
    • -
-
-

最後になりましたが、PHPerKaigi のスタッフ、スポンサー、スピーカーのみなさん、素敵な時間をありがとうございました。

-

ではまた来年。

-]]> - - - - PHPerKaigi 2022 トークン問題の解説 - https://blog.nsfisis.dev/posts/2022-04-09/phperkaigi-2022-tokens/ - Sat, 09 Apr 2022 21:50:19 +0900 - - https://blog.nsfisis.dev/posts/2022-04-09/phperkaigi-2022-tokens/ - はじめに -

本日開始された PHPerKaigi 2022 の PHPer チャレンジにおいて、弊社 デジタルサーカス株式会社 の問題を 3問作成した。この記事では、これらの問題の解説をおこなう。

-

リポジトリはこちら: https://github.com/nsfisis/PHPerKaigi2022-tokens

-

第1問 brainf_ck.php

-

ソースコードはこちら。実行には PHP 8.1 以上が必要なので注意。

-
<?php
-
-declare(strict_types=0O1);
-
-namespace Dgcircus\PHPerKaigi\Y2022;
-
-/**
- * @todo
- * Run this program to acquire a PHPer token.
- */
-
-https://creativecommons.org/publicdomain/zero/1.0/
-
-\error_reporting(~+!'We are hiring!');
-
-$z = fn($f) => (fn($x) => $f(fn(...$xs) => $x($x)(...$xs)))(fn($x) => $f(fn(...$xs) => $x($x)(...$xs)));
-$id = \spl_object_id(...);
-$put = fn($c) => \printf('%c', $c);
-$mm = fn($p, $n) => new \ArrayObject(\array_fill(+!![], $n, $p));
-
-$👉 = fn($m, $p, $b, $e, $mp, $pc) => [++$mp, ++$pc];
-$👈 = fn($m, $p, $b, $e, $mp, $pc) => [--$mp, ++$pc];
-$👍 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, ++$m[$mp]];
-$👎 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, --$m[$mp]];
-$📝 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, $put($m[$mp])];
-$🤡 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) {
-    +!![] => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) {
-      $b => $loop(++$pc, ++$n),
-      $e => $n === +!![] ? ++$pc : $loop(++$pc, --$n),
-      default => $loop(++$pc, $n),
-    })($pc, -![])],
-    default => [$mp, ++$pc],
-};
-$🎪 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) {
-    +!![] => [$mp, ++$pc],
-    default => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) {
-      $e => $loop(--$pc, ++$n),
-      $b => $n === +!![] ? $pc+![] : $loop(--$pc, --$n),
-      default => $loop(--$pc, $n),
-    })($pc, -![])],
-};
-$🐘 = fn($p) => $z(fn($loop) => fn($m, $p, $b, $e, $mp, $pc) =>
-  isset($p[$pc]) && $loop($m, $p, $b, $e, ...($p[$pc]($m, $p, $b, $e, $mp, $pc)))
-)($mm(+!![], +(![].![])), $p, $id($🤡), $id($🎪), +!![], +!![]);
-
-$🐘([
-  $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-  $🤡,
-    $👉, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-    $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
-    $👈, $👈, $👈, $👈, $👎,
-  $🎪,
-  $👉, $👍, $👍, $👍, $👍, $👍, $📝,
-  $👎, $👎, $📝,
-  $👉, $👎, $👎, $👎, $📝,
-  $👉, $👎, $👎, $👎, $📝,
-  $👎, $👎, $📝,
-  $👎, $📝,
-  $👈, $📝,
-  $👉, $👉, $👎, $👎, $📝,
-  $👍, $👍, $👍, $👍, $👍, $👍, $👍, $📝,
-  $👈, $👎, $👎, $👎, $👎, $📝,
-  $👈, $📝,
-  $👉, $👍, $👍, $📝,
-  $👉, $👎, $📝,
-  $👈, $📝,
-]);
-

この問題は、単に適切なバージョンの PHP で動かせばトークンが得られる。

-

解説

-

絵文字

-

まず目につくのは大量の絵文字だろう。 -PHP は識別子に使用できる文字の範囲が広く、絵文字も使うことができる。

-

プログラム全体

-

Brainf*ck のインタプリタとプログラムになっている。 -Brainf*ck とは、難解プログラミング言語のひとつであり、ここで説明するよりも Wikipedia の該当ページを読んだ方がよい。

-

https://ja.wikipedia.org/wiki/Brainfuck

-

なお、brainf*ck プログラムを普通の書き方で書くと、次のようになる。

-
+ + + + + + + + + +
-[
-  > + + +
-  > + + + + +
-  > + + + + + + + + + + + +
-  > + + + + + + + + + +
-  < < < < -
-]
-> + + + + + .
-- - .
-> - - - .
-> - - - .
-- - .
-- .
-< .
-> > - - .
-+ + + + + + + .
-< - - - - .
-< .
-> + + .
-> - .
-< .
-

実行結果はこちら: https://ideone.com/22VWmb

-

それぞれの絵文字で表された関数が、各命令に対応している。

-
    -
  • $👉: >
    • -
  • $👈: <
    • -
  • $👍: +
    • -
  • $👎: -
    • -
  • $📝: .
    • -
  • $🤡: [
    • -
  • $🎪: ]
    • -
-

, (入力) に対応する関数はない (このプログラムでは使わないので用意していない)。

-

なお、$🐘 はいわゆる main 関数であり、プログラムの実行部分である。

-

絵文字の選択

-

おおよそ意味に合致するよう選んでいるが、$🤡 と $🎪 は弊社デジタルサーカスにちなんでいる。 -また、$🐘 は PHP のマスコットの象に由来する。

-

strict_types

-

declare 文の strict_types に指定できるのは、0 か 1 の数値リテラルだが、 -0x0 や 0b1 のような値も受け付ける。 -今回は、PHP 8.1 から追加された、0O または 0o から始まる八進数リテラルを使った。

-

URL

-

ソースコードのライセンスを示したこの部分だが、

-
https://creativecommons.org/publicdomain/zero/1.0/
-

完全に合法な PHP のコードである。 -https: 部分はラベル、// 以降は行コメントになっている。

-

リテラルなしで数値を生成する

-

ソースコード中に、ほとんど数値リテラルが書かれていないことにお気づきだろうか。 -PHP では、型変換を利用することで任意の整数を作り出すことができる。

-
assert(0 === +!![]);
-assert(1 === +![]);
-assert(2 === ![]+![]);
-assert(3 === ![]+![]+![]);
-assert(10 === +(![].+!![]));
-

[] に ! を適用すると true が返ってくる。それに + -を適用すると、bool から int ヘの型変換が走り、1 が生成される。10 -はさらにトリッキーだ。まず 1 と 0 を作り、. で文字列として結合する -('10')。これに + を適用すると、string から int -への型変換が走り、10 が生まれる (コード量に頓着しないなら、1 を 10 -個足し合わせてももちろん 10 が作れる)。

-

また、error_reporting に指定しているのは -1 である。 -これは、! によって文字列を false にし、+ によって false を 0 にし、さらにビット反転して -1 にしている。

-

if 文なしで条件分岐

-

三項演算子ないし match 式を使うことで、if を一切書かずに条件分岐ができる。 -また、&& / || も使えることがある。 -遅延評価が不要なケースでは、[$t, $f][$cond] のような形で分岐することもできる。

-

while、for 文なしでループ

-

不動点コンビネータを使って無名再帰する (詳しい説明は省略する。これらの単語で検索してほしい)。 -ここでは、一般に Z コンビネータとして知られるものを使った ($z)。

-

実際のところ、$🤡 や $🎪、$🐘 は、一度 Scheme (Lisp の一種) で書いてから PHP に翻訳する形で記述した。

-

なお、PHP は末尾再帰の最適化をおこなわない (少なくとも今のところは) ので、 -あまりに長い brainf*ck プログラムを書くとスタックオーバーフローする。

-

第2問 riddle.php

-

ソースコードはこちら。実行には PHP 8.0 以上が必要なので注意。

-
<?php
-
-/*********************************************************
- * This program displays a PHPer token.                  *
- * Guess 'N'.                                            *
- *                                                       *
- * Hints:                                                *
- * - N itself has no special meaning, e.g., 42, 8128,    *
- *   it is selected at random.                           *
- * - Each element of $token represents a single letter.  *
- * - One letter consists of 5x5 cells.                   *
- * - Remember, the output is a complete PHPer token.     *
- *                                                       *
- * License:                                              *
- *   https://creativecommons.org/publicdomain/zero/1.0/  *
- *********************************************************/
-const N = 0 /* Change it to your answer. */;
-assert(0 <= N && N <= 0b11111_11111_11111_11111_11111);
-
-$token = [
-  0x14B499C,
-  0x0BE34CC, 0x01C9C69,
-  0x0ECA069, 0x01C2449, 0x0FDB166, 0x01C9C69,
-  0x01C1C66, 0x0FC1C47, 0x01C1C66,
-  0x10C5858, 0x1E4E3B8, 0x1A2F2F8,
-];
-foreach ($token as $x) {
-  $x = $x ^ N;
-
-  $x = sprintf('%025b', $x);
-  $x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-  $x = implode("\n", str_split($x, length: 5));
-  echo "{$x}\n\n";
-}
-

さて、この問題はさきほどのように単純に実行しただけでは、謎のブロックが表示されるだけでトークンは得られない。 -トークンを得るためには、ソースコードを読み、定数 N を特定する必要がある。

-

ここでは、私の想定解を解説する。

-

読解

-

まずはソースコードを読んでいく。

-
$token = [
-  // 略
-];
-

数値からなる $token があり、各要素をループしている。

-
  $x = $x ^ N;
-

まずは排他的論理和 (xor) を取り、

-
  $x = sprintf('%025b', $x);
-

二進数に変換して、

-
  $x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-

0 を空白に、1 を # にし、

-
  $x = implode("\n", str_split($x, length: 5));
-

5文字ごとに区切ったあと、改行で結合している。

-

ヒント

-

次に、ソースコードに書いてあるヒントを読んでいく。

-
    -
  • N それ自体は、42 や 8128 といったような特別な意味を持たず、ランダムに決められている
    • -
  • $token の各要素は、1文字を表す
    • -
  • 1文字は 5x5 のセルからなる
    • -
  • 出力されるのは、完全な PHPer トークンである
    • -
-

ここで、PHPer トークンは必ず # 記号から始まることを思いだすと、 -$token の最初の数字 0x14B499C は、変換の結果 # になるのではないかと予想される (なお、このことは、リポジトリの README ファイルに追加ヒントとして書かれている)。

-

解く

-

ここまでわかれば、あと一歩で解ける。すなわち、0x14B499C が # に変換されるような N を見つければよい。

-

N は高々

-
assert(0 <= N && N <= 0b11111_11111_11111_11111_11111);
-

なのでブルートフォースしてもよいが、ここではブルートフォースしない方法を紹介する。

-
<?php
-
-$x = 0x14B499C;
-
-$x = $x ^ N;
-
-$x = sprintf('%025b', $x);
-$x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
-$x = implode("\n", str_split($x, length: 5));
-
-assert($x ===
-  " # # \n" .
-  "#####\n" .
-  " # # \n" .
-  "#####\n" .
-  " # # ");
-

この一連の変換に対する逆変換を考えると、次のようになる。

-
<?php
-
-$x =
-  " # # \n" .
-  "#####\n" .
-  " # # \n" .
-  "#####\n" .
-  " # # ";
-
-$x = implode('', explode("\n", $x));
-$x = str_replace(search: [' ', '#'], replace: ['0', '1'], subject: $x);
-$x = bindec($x);
-
-$n = $x ^ 0x14B499C;
-
-echo "N = $n\n";
-

これを実行すると、N が得られる。

-

第3問 toquine.php

-

ソースコードはこちら。

-
<?php
-
-// License: https://creativecommons.org/publicdomain/zero/1.0/
-// This is a quine-like program to generate a PHPer token.
-// Execute it like this: php toquine.php | php | php | php | ...
-
-$s = <<<'Q'
-<?cuc
-// Yvprafr: uggcf://perngvirpbzzbaf.bet/choyvpqbznva/mreb/1.0/
-// Guvf vf n dhvar-yvxr cebtenz gb trarengr n CUCre gbxra.
-// Rkrphgr vg yvxr guvf: cuc gbdhvar.cuc | cuc | cuc | cuc | ...
-%f$f = %f;
-$f = fge_ebg13($f); $kf = [
-%f,
-];
-$g = ahyy.snyfr; sbe ($v = 0; $v <= vagqvi(__YVAR__-035,6); ++$v) vs (!vffrg($kf[$v])) oernx; ryfr
-$g .= vzcybqr("\a", fge_fcyvg(fge_ercynpr(['0','1'], ['  ','##'], fcevags(pue(37) . '025o', $kf[$v])), 012)) . "\a\a";
-$jf = neenl_znc(sa($j) => vzcybqr(', ', $j), neenl_puhax(neenl_znc(sa($k) => fcevags('0k' . pue(37) . '07K', $k), $kf), 10));
-cevags($f, $g, fge_ebg13("<<<'Q'\a{$f}\aQ"), vzcybqr(",\a", $jf));
-Q;
-$s = str_rot13($s); $xs = [
-0x0AFABEA, 0x1F294A7, 0x1F2109F, 0x1F294A7, 0x0002800, 0x1F2109F, 0x0117041, 0x1F294A7, 0x1FAD6B5, 0x1F295B7,
-0x010FC21, 0x1FAD6B5, 0x1151151, 0x010FC21, 0x1F294A7, 0x1F295B7, 0x1FAD6B5, 0x1F294A7, 0x1F295B7, 0x1F8C63F,
-0x1F8C631, 0x1FAD6B5, 0x17AD6BD, 0x17AD6BD, 0x1F8C63F, 0x1F295B7,
-];
-$t = null.false; for ($i = 0; $i <= intdiv(__LINE__-035,6); ++$i) if (!isset($xs[$i])) break; else
-$t .= implode("\n", str_split(str_replace(['0','1'], ['  ','##'], sprintf(chr(37) . '025b', $xs[$i])), 012)) . "\n\n";
-$ws = array_map(fn($w) => implode(', ', $w), array_chunk(array_map(fn($x) => sprintf('0x' . chr(37) . '07X', $x), $xs), 10));
-printf($s, $t, str_rot13("<<<'D'\n{$s}\nD"), implode(",\n", $ws));
-

コメントにもあるとおり、次のようにして実行すれば答えがでてくる。

-
$ php toquine.php | php | php | php | ...
-

実際にはもう少しパイプで繋げなければならない。

-

解説

-

プログラム全体

-

コメントにもあるとおり、これは quine (風) のプログラムになっている。 -Quine とは、自分のソースコードをそっくりそのまま出力するようなプログラムのことである。

-

このプログラムは、実行すると自身とほとんど同じプログラムを出力する。 -異なるのはトークンになっている部分のみである。

-

トークン

-

$xs がトークンに対応している。変換のロジックは riddle.php とほぼ同じなので省略する。

-

状態保持

-

トークンの何文字目まで出力したかを、ソースコードを変えずに (quine なので) 覚えておく必要がある。 -このプログラムでは、トークンが出力されるとソースコードがだんだんと長くなっていくのを利用して、__LINE__ から情報を取得している。

-

ROT 13

-

Quine は、素朴に書くとプログラムの一部が 2回記述されてしまう。 -これがあまり美しくないので、toquine.php では、ROT 13 変換を使って難読化した。

-

それにしてもなぜこんなものが標準ライブラリに……。

-

おわりに

-

解いていただいたみなさん、また、難易度調整につきあっていただいた社内のみなさん、ありがとうございました。

-

今回は直前に作りはじめたのもあり、3問だけかつ使い古されたネタばかりになってしまいましたが、 -来年は 5問、より面白い問題を持っていきます。

-

実はもう作りはじめているので、どうか来年もありますように……。

-]]> - - - - PHPerKaigi 2021 - https://blog.nsfisis.dev/posts/2021-03-30/phperkaigi-2021/ - Tue, 30 Mar 2021 23:22:40 +0900 - - https://blog.nsfisis.dev/posts/2021-03-30/phperkaigi-2021/ - PHPerKaigi 2021 参加レポ -

2021-03-26 から 2021-03-28 にかけて開催された、PHPerKaigi 2021 に一般参加者として参加した。 -弊社デジタルサーカス株式会社 (今年1月から勤務) はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。

-

このようなカンファレンスには初めて参加するのでかねてより心待ちにしていたのだが、生憎2日目から体調を崩してしまい、この記事も途中までとなっている。まだ見ていないセッションも多いが、ひとまず現時点での参加レポを書いておく。

-

発表はトラック A、B に分かれていたのだが、今回はすべて A トラックを視聴している (切り替えるのが面倒だっただけ)。

-

凡例

-
-

発表・スライドのメモ (引用ではない)

-
-

感想など

-

Day 0 前夜祭 (2021/03/27)

-

17:30 [A]

-

PHP で AWS Lambda

-
-

Rails のプロジェクトを PHPer のメンバのみでメンテ -→他のメンバもわかる PHP にリプレースを検討

-

サーバレス

-
    -
  • サーバ・インフラの管理が不要
    • -
  • アプリケーションコードの知識だけで保守可能
    • -
-

ゼロベースで作れる案件が (Railsの件とは別に) あるため、そちらで試験的に導入?

-

AWSの学習 -AWS のドキュメント -DevelopersIO

-

AWS Lambda のカスタムランタイムで PHP を動かす

-

サーバのセットアップや維持管理を気にしなくて良い -サーバーレスで PHP を動かすツールがすでにある -サーバーレス構築はすんなり

-

今は Laravel がルーティングしている -Laravel Livewire を Lambda に載せられないか？ -デプロイ方法は？ -バッチ処理は？ (Lambda は 15分の制限)

-

Lambda でコンテナイメージがサポートされるように

-

抽象化されたもの「だけ」しか知らないよりも具象の理解は助けになる

-
-

AWS Lambda のような Function as a Service はマイクロサービス化における一つの到達点に思えるのだが、これを使って実際に web サービスを作る具体的なイメージがまだ見えない (注: すべて for me として書いている)。

-

PHP on AWS Lambda があれだけ簡単に動かせるのには驚いた。

-

勝手に AWS Lambda だとフットプリントの軽さが求められそう (= PHP + Laravel などでは動かなさそう) だという先入観を持っていたのだが、この発表のデモによればそうでもないらしい。

-

18:10 [A]

-

大規模サイトの SEO

-
-

大規模サイト (100万ページ以上) -Google の基準

-

クロールバジェットを意識したSEO

-

大規模サイトでコンテンツが中頻度 (1回/週) で更新 OR 中規模サイト (10,000以上) でコンテンツが目まぐるしく変更される -これを満たさないなら、クロールバジェットを考えなくてもいい

-

サーチコンソール -「カバレッジ」の「除外」 -多すぎるのは問題→クロールバジェットを浪費している

-
    -
  • クエリの順番を決める
    • -
  • 空の値のルールを決めておく
    • -
  • リダイレクトすればインデックスはうまくいく
    • -
  • リンクが存在する限りクロールはされる
    • -
-

リニューアル前のURL

-

インデックスは移行される -リンクのURLが存在する限り、別のURLとしてクロールされる -リダイレクトされるとはいえ、リニューアル前のURLは移行した方が良い -リニューアルで無視されるようになったパラメータも注意

-

robotes.txt で拒否しているのにクロールされる -一時的に拒否を外して 404 や 301 を読ませる -内部リンクを確認する -JS でのリンクに書き換え

-

クエリパラメータからURLのパスに -/tokyo?area=HOGE → /tokyo/HOGE

-

URL 設計だいじ

-
-

SEO (Search Engine Optimization) は大して知らないので新鮮な話が多かった。その分語れることも少ない……。

-

18:50 [A]

-
-

知覚可能 -操作可能 -理解可能 -堅牢 ちゃんとしたHTMLを書く (閉じタグ・入れ子構造など)

-
    -
  • -

    標準の HTML を適切に使う

    -
    • -
  • -

    WAI-ARIA

    -
    • -
  • -

    キーボードフレンドリー

    -
    • -
  • -

    マシンフレンドリー

    -
    • -
  • -

    SEOフレンドリー

    -
    • -
-

button タグ -→キーボード -h1 タグ -→スクリーンリーダー・クローラ -a タグ

-

WAI-ARIA -HTML では表現できないセマンティクスを追加する

-
    -
  • ロール -
      -
    • 何をするのか？
      • -
    • ユーザーアクションによって変化しない
      • -
    -
    • -
  • プロパティ -
      -
    • 関連づけられたデータ
      • -
    -
    • -
  • ステート -
      -
    • 現在の状態
      • -
    -
    • -
-

まずは標準の HTML 要素で解決する -何でもかんでも WAI-ARIA を使えばいいというものではない

-

マウスホバーでツールチップが出てくるが、キーボード操作では出てこない

-

VoiceOver

-

全ての属性を使う必要はない -あくまでアクセシビリティを上げるための方法の一つにすぎない

-
-

つい最近 WAI-ARIA についての記事を読んだばかりだったので個人的にタイムリーな話題だった。(あまりこの言葉を使いたくないのだが) いわゆる「健常者」にとって、こうした問題を普段の生活の中で意識するのは難しい。だからこそ情報へのアンテナは張っておくようにしたい。

-

19:30 [A]

-

PHP で FUSE

-

個人的に楽しみだった発表。

-
-

VFS (virtual filesystem) vs 具体的なファイルシステム

-

最適な実装方法は状況により異なる

-

アプリケーションに見せるAPIは変えずに実装を隠蔽する→VFS

-

カーネルのプログラムを作るのは難しい

-
    -
  • 権限がデカすぎる
    • -
  • システム全体がクラッシュ
    • -
  • セキュリティリスク
    • -
  • 開発サイクルを回しづらい
    • -
  • ネイティブコードにコンパイルされる言語である必要がある
    • -
-

Filesystem in USEr space (FUSE)

-
    -
  • 特定の C の関数を呼ぶことで filesystem が作れる
    • -
  • FFI を持つ言語なら FUSE が使える
    • -
-

SSHFS / s3fs / Docker Desktop

-

Linux 以外でも使える

-
    -
  • dokany (on Windows)
    • -
  • osxfuse
    • -
-

VFS: システムコールが呼ばれると、ファイルシステムによってコール -FUSE: カーネル空間からユーザ空間へ通信

-

高レベルなラッパで型をつける

-

PHP 以外では Wordpress を FUSE にマウントする実装がある (C, Python など)

-
    -
  • grep できる
    • -
  • sed できる
    • -
  • 編集できる
    • -
-
-

期待通りの興味深い発表だった。FUSE 自体も今回の発表で知ったのだが、これ本体の実装を見るのも面白そうだ。 -この発表を聞きながらファイルシステムにマウントできそうなものを考えていたのだが、およそ木構造をしているものすべてと言えそうだ (ハンマーしか持っていないと云々)。何かできそうだがなかなか思いつかない。

-

Day 1 (2021/03/27)

-

10:50 [A]

-

ATDD

-
-
    -
  • ユーザーストーリー
    • -
  • ユニットテスト
    • -
  • CI/CD
    • -
-

ユーザストーリーの受け入れ条件が曖昧になりがち -デグレチェックがユニットレベルでは収まらない場合、手動で同じシナリオをテストしている

-

Q2の強化 -アジャイルテストの4象限

-

技術面/ビジネス面 -開発チーム支援(コーディング前・コーディング中)/製品批評(コーディング後)

-
    -
  • Q1: 技術面 & チーム支援 -
      -
    • TDD
      • -
    • ユニットテストなど
      • -
    -
    • -
  • Q2: ビジネス面 & チーム支援 -
      -
    • ATDD
      • -
    • ビジネス面の受け入れテストで駆動する
      • -
    -
    • -
-

Agile Alliance -ユーザストーリーのスキルレベルを高める

-

テストピラミッド

-
    -
  • -

    UI Tests

    -
    • -
  • -

    Service Tests

    -
    • -
  • -

    Unit Tests

    -
    • -
  • -

    異なる粒度のテストを書く

    -
    • -
  • -

    高レベルになるほど、持つべきテストは少なくなる

    -
      -
    • ピラミッド型になる
      • -
    -
    • -
-

高レベルテストが多すぎる→アイスクリームコーン　アンチパターン

-

ATDD (Acceptance TDD) -API経由・UI経由での高レベルテスト E2E test

-

ストーリ受け入れテスト

-

入れ子のフィードバックループ -ATDD(外側) と TDD(内側)

-

外部品質・内部品質

-

バーティカルスライスのデリバリー

-
    -
  • cucumber
    • -
  • gauge
    • -
  • behat
    • -
-

ユビキタス言語 -手動テストもspecに書く -自動化は可能だがコスパが悪い -失敗することがわかっているテスト(レッドテスト)はCIから外す -失敗時の原因究明が難しい -饒舌なエラーメッセージ -状況のスナップショット

-

Continuous Testing

-
-

User Acceptance Test (UAT) くらいの規模になると個人開発・趣味開発では触れない領域なので、大いに勉強になった。スライドに添付されている資料が相当に充実していたので、これを読むのが本番といった様相すら感じる。 -高レベルテストの自動化は現在のプロジェクトでも感じており、自動化のチャンスは伺っている。とはいえセッションでも指摘されているように自動化することにコストがかかりすぎる領域があるのも事実で、そのバランスが難しい。

-

11:50 [A]

-

型解析を用いたリファクタリング

-

型のある世界で生きてきた身として大いに楽しみにしていた発表。

-
-
    -
  • PHPStan
    • -
  • Phan
    • -
  • Psalm
    • -
-

autoload も認識できる -bootstrapFiles

-

編集箇所と利用箇所を CI でチェック -ルールレベルを徐々に引き上げていく -警告が多すぎると見落としてしまう・無視されやすくなる

-

型がついていないことによるエラーが多い

-

型よりも詳細な検査 Util_Assert::min

-

SQL を静的解析 -placeholder の型付け

-

警告レベルを低いレベルから導入 -タイプヒントを積極的に書いていく -PHPStan の拡張を追加する

-
-

昨今、動的型付き言語での型宣言・型アノテーション・型ヒントの導入が相次いでいる。長らく静的型付き言語を書いてきた私からすると、ようやく気づいたかといったところだが、ともかく型を導入する言語が増えてきた。 -今のプロジェクトでも新しく追加するコードには型をつけるよう努めているが、どうしても古いコードには型がついていない。個人的には型のないコードに対してどう型を自動的に付けるかという点に興味があり、その点で Ruby の typeprof には注目している。

-

12:30 [A]

-

昼食をとっていた。事前に何か食料を買っておくべきだった。

-

13:10 [A]

-

Documentation as Code

-

この発表も以前から非常に楽しみにしていた。

-
-

開発開始までのオーバーヘッド -新規にチームにジョイン -担当範囲外の機能を理解 -オンボーディングのコスト

-

PHPerKaigi 2020 で発表あり

-

継続的にシステムの理解を助けるドキュメント

-

継続的ドキュメンテーション -システムとドキュメントの乖離

-

書いてあることが間違っている・足りない

-
    -
  • 徐々にずれていく
    • -
  • システムの更新タイミングとドキュメントの更新タイミングに差がある
    • -
-

システムとドキュメントは対応関係がある

-
    -
  • 間違ったドキュメント
    • -
  • 存在しないドキュメント
    • -
-

システムとドキュメントの乖離を定量化する -継続的に -システムの更新に近いタイミングで ドキュメントを更新し続ける

-

Documentation as Code

-

コードと同じツールでドキュメントを書く

-
    -
  • issue tracker
    • -
  • vcs
    • -
  • plain text markup
    • -
  • automation
    • -
-

開発者 -システム -ドキュメント -構造化データ -ソフトウェア

-

システムから構造化データを抽出する -PHPDoc -OpenAPI

-

ビュー 関心ごとに合わせてアーキテクチャを一つ以上の側面(断面)で説明する

-

ビューの単位でドキュメントに

-

スタックトレースからのドキュメント生成

-
-

ドキュメントの管理は現プロジェクトでも課題と感じている。作られた当初は正しくても、実態と乖離していくのを止めるのは困難を極める。全体的に興味深い発表だったが、特にスタックトレースからのドキュメント生成というアイデアに惹かれるものを感じた。スタックトレースという実態と不可分な (乖離しない) 情報を起点にするのは理にかなっている。問題はトレースをいつ、どう取るかだろうか。それを自動化しなければ、実態との乖離が避けられないだろう。

-

14:10 [A]

-

cookie による session 管理

-

全体的に基本的な話だったので特に触れない。Cookie やセッションの話としては非常に分かりやすくまとめられていたので、知らない人が学ぶにはいい教材だろう。

-

14:50 [A]

-

PHP のエラーと例外

-
-

エラー PHPエンジンがエラーを通知する -例外 プログラムが投げる

-

PHP7-8とエラー

-

PHPエンジンのエラーの一部が \Error に変換されるようになった -→ try-catch で捕捉できる

-

\Error は例外とは異なる

-

PHP8 でエラーレベルの引き上げ

-
    -
  • 捕捉すべきもの -
      -
    • recoverable
      • -
    -
    • -
  • 捕捉すべきでないもの -
      -
    • unrecoverable
      • -
    • 開発時に対処できるもの
      • -
    -
    • -
-

例外

-
    -
  • 捕捉して事後処理
    • -
  • 捕捉せず(or 捕捉した上で)さらに上に是非を問う
    • -
-

開発段階で例外を把握し、ハンドリングを考えておく

-

\Throwable \Exception と \Error

-

\Error はキャッチすべきでない

-
    -
  • -

    \Error

    -
      -
    • 本番で起きてはいけない
      • -
    -
    • -
  • -

    \LogicException

    -
      -
    • 本番で起きてはいけない -→生じないのだから捕捉もしない
      • -
    -
    • -
  • -

    \RuntimeException

    -
      -
    • 起こるかもしれないので本番環境でも考慮する
      • -
    -
    • -
-

捕捉して対応するのではなく、未然に防ぐ

-

独自例外を使う -\Exception を投げてしまうと、 -catch (\Exception)せざるを得ない -→catch 範囲が広すぎる

-

SPL の例外を使う

-

例外翻訳 -上位のレイヤが下位のレイヤの例外を捕捉し、上位レイヤのAPIに「翻訳」する -下位レイヤの知識に依存させない

-

@throws -捕捉してほしい例外を書き連ねておく

-

呼び出しもとに負わせたい責任

-
-

PHP を学んでいる途中の私としては、今まさに聞きたい発表だった (現時点で PHP を書き始めてから 4ヶ月ほどになる)。

-

個人的に例外やエラーを最もうまく扱っているのは Go、Swift、Rust、Haskell などのエラーを「値として」扱う言語だと思っている。try-catch は通常の処理フローを完全に壊してしまう上、構文としても重すぎる。値としてのエラー通知は C言語時代への回帰ともいえるが、その頃と異なるのはエラーを暗黙のうちに握り潰すことがないということだ。これらの言語は型を持っており、静的に検証ができる (C のそれはまともな型付けではない。念のため)。

-

PHP のように、すでに例外が言語システムに根ざしている言語ではどうすればよいか。この場合も同じく静的検証の力を借りることになるだろう。

-

15:30 [A]

-

Laravel のメール認証

-

Laravel の知識がない私にはまったくついていけなかった。また、個人的にタイトルがややミスリーディングに感じた。

-

16:10 [A]

-

gRPC

-
-

Unary RPCs -Server streaming RPCs -Client streaming RPCs -Bidirectional streaming RPCs

-

Protobuf

-

実装とAPIが乖離しにくい -自動生成 -複数言語でも相互に使える

-

マイクロサービスのサービス通信 -スマホアプリ -ゲームサーバ

-

PHP では？

-

PHP ではストリーミングが難しい -リクエストごとにプロセスが使い捨て

-

PHP ではgRPCのクライアントしか対応していない

-

gRPC-Web -ブラウザで扱うためのJSライブラリ+プロトコル

-

HTTP/1.1 でも使える -Unary RPC と Server streaming RPC のみ

-

Envoy -Nginx などで相互に gRPC と gRPC-Web で変換

-

Amp -イベント駆動な並行処理のフレームワーク

-

HTTP/2 対応

-

C#のgRPC-Webが楽

-
-

(発表の中でもまさに同じことをおっしゃっていたが) PHP 以外の方が向いているだろう、というのが第一の感想である。gRPC はそれ自体というよりも Protobuf というエコシステムに乗れることのメリットが大きいと感じる。そのエコシステムにうまく乗れない時点で、うーんという感じ。

-

16:50 [A]

-

アーキテクチャテスト

-
-

Independent Core Layer Pattern

-

開発初期のアーキテクチャが崩れる -アーキテクチャ観点のコードレビューができない

-

どこにクラスを置けばよいか？ -ドキュメントがない

-

アーキテクチャ設計に関する知識が属人化・暗黙知化

-

ガイドライン

-
    -
  • 最初にルールを決めるのは簡単
    • -
  • ルール通り作り始めるのも簡単 -
      -
    • →維持するのが難しい、人が決めたものゆえ壊れやすい
      • -
    -
    • -
-

PHP の特性

-
    -
  • クラスは public
    • -
  • 可視性の制御が public / protected / private のみ
    • -
  • 依存関係の制御が困難
    • -
-

アーキテクチャテスト -クラスの依存関係や実装ルールをコードとして表現し、自動テスト化する

-
    -
  • deptrac
    • -
  • phpat
    • -
-

Independent Core Layer Pattern

-

アーキテクチャテストの失敗

-
    -
  • 実装誤り
    • -
  • or アーキテクチャが適切でない -
      -
    • 開発の過程でフィードバックしていく
      • -
    -
    • -
-

モジュラーモノリス→マイクロサービスへ

-
-

Day 2 (2021/03/28)

-

冒頭に書いた通り、2日目から体調が悪くまともに聴けていない。途中までは頭痛を我慢しつつ見ていたのだが、まともに入ってこなかった。

-

残念ではあるが、いずれにせよ見られていない発表は他にもあるので、今週末にでもまとめて見ようと思う。

-

全体の感想

-

Day 2 にほとんど参加できなかったのは残念だが、イベント自体は大変楽しく、また興味深いものであった。自分がまったく知らない領域の話を聞けるのはこうしたイベントならではだと感じる。オンライン開催ゆえ現地に行く必要がなく、気軽に参加できたのも (特に初参加者として) 嬉しいポイントだった。

-

今回、雑談/登壇者への質問等向けに Discord サーバもあったのだが、こちらは参加こそしたものの ROM のままになってしまった。発表に1ウィンドウ、メモを書くのに1ウィンドウ、Discord 表示に 1ウィンドウで私にはもう脳のリソースとディスプレイのスペースが追いつかなかった (さらにいうと Zoom でアンカンファレンスもやっていたようだ。こちらはまったく参加していない)。

-

1つ個人的な反省点としては、一つ一つのセッションを真剣に聞き過ぎたというものがある。もっと適当に聞いておけばよかった。これだけだと大変語弊があるのだが、言い方を変えると、Discord しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。 -まあ初カンファレンスだし、とお茶を濁しておこう。

-

さて、カンファレンスで一つ気になったことがある。それは、Discord という書き込み場所が増えたことでニコ生のコメントの流量が吸い取られてしまったのではないか、という点だ。ニコニコだけ見ていると過疎っているかのように見えた発表も、Discord の方では盛り上がっている、というのを何度か見かけた。ニコニコのコメント方式は盛り上がりを如実に反映するが、逆もまたしかり。Discord があったこと自体はプラスだったと思うが、この点はマイナスだったのではないかと感じる。

-
-

最後になりましたが、毎年の PHPerKaigi 開催にご尽力されている皆様、スピーカーの皆様、楽しい3日間でした。ありがとうございました！ -(ずっと常体で書いてしまったのでいきなり仏頂面から笑顔になったようで気持ち悪い)

-

ではまた来年。

-]]> - - - - diff --git a/docs/tags/phperkaigi/index.html b/docs/tags/phperkaigi/index.html deleted file mode 100644 index ac09c96..0000000 --- a/docs/tags/phperkaigi/index.html +++ /dev/null @@ -1,93 +0,0 @@ - - - - - - - - phperkaigi | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -

phperkaigi

- -
-
-

PHPerKaigi 2023: ボツになったトークン問題 その 1

-
-
-

来年の PHPerKaigi 2023 でデジタルサーカス株式会社から出題予定のトークン問題のうち、 -ボツになった問題を公開する (その 1)。

-
-
- Posted on -
- -
-
-
-

PHPerKaigi 2022

-
-
-

2022-04-09 から 2022-04-11 にかけて開催された、PHPerKaigi 2022 に参加した。

-
-
- Posted on -
- -
-
-
-

PHPerKaigi 2022 トークン問題の解説

-
-
-

PHPerKaigi 2022 で私が作成した PHPer チャレンジ問題を解説する。

-
-
- Posted on , updated on -
- -
-
-
-

PHPerKaigi 2021

-
-
-

2021-03-26 から 2021-03-28 にかけて開催された、PHPerKaigi 2021 に参加した。

-
-
- Posted on -
- -
- - - - - - diff --git a/docs/tags/phperkaigi/page/1/index.html b/docs/tags/phperkaigi/page/1/index.html deleted file mode 100644 index 38c704d..0000000 --- a/docs/tags/phperkaigi/page/1/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - - https://blog.nsfisis.dev/tags/phperkaigi/ - - - - - - diff --git a/docs/tags/python/feed.xml b/docs/tags/python/feed.xml deleted file mode 100644 index 3b8ba29..0000000 --- a/docs/tags/python/feed.xml +++ /dev/null @@ -1,57 +0,0 @@ - - - - python on REPL: Rest-Eat-Program Loop - https://blog.nsfisis.dev/tags/python/ - Recent content in python on REPL: Rest-Eat-Program Loop - Hugo -- gohugo.io - ja-JP - Sat, 02 Oct 2021 09:32:37 +0900 - - [Python] クロージャとUnboundLocalError: local variable 'x' referenced before assignment - https://blog.nsfisis.dev/posts/2021-10-02/python-unbound-local-error/ - Sat, 02 Oct 2021 09:32:37 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/python-unbound-local-error/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/5d733703afcb35bbf399

-
-

本記事は Python 3.7.6 の動作結果を元にして書かれている。

-

Python でクロージャを作ろうと、次のようなコードを書いた。

-
def f():
-    x = 0
-    def g():
-        x += 1
-    g()
-
-f()
-

関数 g から 関数 f のスコープ内で定義された変数 x を参照し、それに 1 を足そうとしている。 -これを実行すると x += 1 の箇所でエラーが発生する。

-
-

UnboundLocalError: local variable ‘x’ referenced before assignment

-
-

local変数 x が代入前に参照された、とある。これは、f の x を参照するのではなく、新しく別の変数を g 内に作ってしまっているため。 -前述のコードを宣言と代入を便宜上分けて書き直すと次のようになる。var を変数宣言のための構文として擬似的に利用している。

-
# 注: var は正しい Python の文法ではない。上記参照のこと
-def f():
-    var x           #  f の local変数 'x' を宣言
-    x = 0           #  x に 0 を代入
-    def g():        #  f の内部関数 g を定義
-        var x       #  g の local変数 'x' を宣言
-                    #  たまたま f にも同じ名前の変数があるが、それとは別の変数
-        x += 1      #  x に 1 を加算 (x = x + 1 の糖衣構文)
-                    #  加算する前の値を参照しようとするが、まだ代入されていないためエラー
-    g()
-

当初の意図を表現するには、次のように書けばよい。

-
def f():
-    x = 0
-    def g():
-        nonlocal x   ## (*)
-        x += 1
-    g()
-

(*) のように、nonlocal を追加する。これにより一つ外側のスコープ (g の一つ外側 = f) で定義されている x を探しに行くようになる。

-]]> - - - - diff --git a/docs/tags/python/index.html b/docs/tags/python/index.html deleted file mode 100644 index 884872e..0000000 --- a/docs/tags/python/index.html +++ /dev/null @@ -1,56 +0,0 @@ - - - - - - - - python | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -

python

- -
-
-

[Python] クロージャとUnboundLocalError: local variable 'x' referenced before assignment

-
-
-

Python における UnboundLocalError の理由と対処法。

-
-
- Posted on -
- -
- - - - - - diff --git a/docs/tags/python/page/1/index.html b/docs/tags/python/page/1/index.html deleted file mode 100644 index ca045d7..0000000 --- a/docs/tags/python/page/1/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - - https://blog.nsfisis.dev/tags/python/ - - - - - - diff --git a/docs/tags/python3/feed.xml b/docs/tags/python3/feed.xml deleted file mode 100644 index 260f94a..0000000 --- a/docs/tags/python3/feed.xml +++ /dev/null @@ -1,57 +0,0 @@ - - - - python3 on REPL: Rest-Eat-Program Loop - https://blog.nsfisis.dev/tags/python3/ - Recent content in python3 on REPL: Rest-Eat-Program Loop - Hugo -- gohugo.io - ja-JP - Sat, 02 Oct 2021 09:32:37 +0900 - - [Python] クロージャとUnboundLocalError: local variable 'x' referenced before assignment - https://blog.nsfisis.dev/posts/2021-10-02/python-unbound-local-error/ - Sat, 02 Oct 2021 09:32:37 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/python-unbound-local-error/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/5d733703afcb35bbf399

-
-

本記事は Python 3.7.6 の動作結果を元にして書かれている。

-

Python でクロージャを作ろうと、次のようなコードを書いた。

-
def f():
-    x = 0
-    def g():
-        x += 1
-    g()
-
-f()
-

関数 g から 関数 f のスコープ内で定義された変数 x を参照し、それに 1 を足そうとしている。 -これを実行すると x += 1 の箇所でエラーが発生する。

-
-

UnboundLocalError: local variable ‘x’ referenced before assignment

-
-

local変数 x が代入前に参照された、とある。これは、f の x を参照するのではなく、新しく別の変数を g 内に作ってしまっているため。 -前述のコードを宣言と代入を便宜上分けて書き直すと次のようになる。var を変数宣言のための構文として擬似的に利用している。

-
# 注: var は正しい Python の文法ではない。上記参照のこと
-def f():
-    var x           #  f の local変数 'x' を宣言
-    x = 0           #  x に 0 を代入
-    def g():        #  f の内部関数 g を定義
-        var x       #  g の local変数 'x' を宣言
-                    #  たまたま f にも同じ名前の変数があるが、それとは別の変数
-        x += 1      #  x に 1 を加算 (x = x + 1 の糖衣構文)
-                    #  加算する前の値を参照しようとするが、まだ代入されていないためエラー
-    g()
-

当初の意図を表現するには、次のように書けばよい。

-
def f():
-    x = 0
-    def g():
-        nonlocal x   ## (*)
-        x += 1
-    g()
-

(*) のように、nonlocal を追加する。これにより一つ外側のスコープ (g の一つ外側 = f) で定義されている x を探しに行くようになる。

-]]> - - - - diff --git a/docs/tags/python3/index.html b/docs/tags/python3/index.html deleted file mode 100644 index 5e18ffd..0000000 --- a/docs/tags/python3/index.html +++ /dev/null @@ -1,56 +0,0 @@ - - - - - - - - python3 | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -

python3

- -
-
-

[Python] クロージャとUnboundLocalError: local variable 'x' referenced before assignment

-
-
-

Python における UnboundLocalError の理由と対処法。

-
-
- Posted on -
- -
- - - - - - diff --git a/docs/tags/python3/page/1/index.html b/docs/tags/python3/page/1/index.html deleted file mode 100644 index 1c8bbe3..0000000 --- a/docs/tags/python3/page/1/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - - https://blog.nsfisis.dev/tags/python3/ - - - - - - diff --git a/docs/tags/ruby/feed.xml b/docs/tags/ruby/feed.xml deleted file mode 100644 index 50612e5..0000000 --- a/docs/tags/ruby/feed.xml +++ /dev/null @@ -1,230 +0,0 @@ - - - - ruby on REPL: Rest-Eat-Program Loop - https://blog.nsfisis.dev/tags/ruby/ - Recent content in ruby on REPL: Rest-Eat-Program Loop - Hugo -- gohugo.io - ja-JP - Sat, 02 Oct 2021 09:38:50 +0900 - - [Ruby] then キーワードと case in - https://blog.nsfisis.dev/posts/2021-10-02/ruby-then-keyword-and-case-in/ - Sat, 02 Oct 2021 09:38:50 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/ruby-then-keyword-and-case-in/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/787a8cf888a304497223

-
-

TL; DR

-

case - in によるパターンマッチング構文でも、case - when と同じように then が使える (場合によっては使う必要がある)。

-

then とは

-

使われることは稀だが、Ruby では then がキーワードになっている。次のように使う:

-
if cond then
-  puts "Y"
-else
-  puts "N"
-end
-

このキーワードが現れうる場所はいくつかあり、if、unless、rescue、case 構文がそれに当たる。 -上記のように、何か条件を書いた後 then を置き、式がそこで終了していることを示すマーカーとして機能する。

-
# Example:
-
-if x then
-  a
-end
-
-unless x then
-  a
-end
-
-begin
-  a
-rescue then
-  b
-end
-
-case x
-when p then
-  a
-end
-

なぜ普段は書かなくてもよいのか

-

普通 Ruby のコードで then を書くことはない。なぜか。次のコードを実行してみるとわかる。

-
if true puts 'Hello, World!' end
-

次のような構文エラーが出力される。

-
20:1: syntax error, unexpected local variable or method, expecting `then' or ';' or '\n'
-if true puts 'Hello, World!' end
-        ^~~~
-20:1: syntax error, unexpected `end', expecting end-of-input
-...f true puts 'Hello, World!' end
-

二つ目のメッセージは無視して一つ目を読むと、then か ; か改行が来るはずのところ変数だかメソッドだかが現れたことによりエラーとなっているようだ。

-

ポイントは改行が then (や ;) の代わりとなることである。true の後に改行を入れてみる。

-
if true
-puts 'Hello, World!' end
-

無事 Hello, World! と出力されるようになった。

-

なぜ then や ; や改行が必要か

-

なぜ then や ; や改行 (以下 「then 等」) が必要なのだろうか。次の例を見てほしい:

-
if a b end
-

then も ; も改行もないのでエラーになるが、これは条件式がどこまで続いているのかわからないためだ。 -この例は二通りに解釈できる。

-
# a という変数かメソッドの評価結果が truthy なら b という変数かメソッドを評価
-if a then
-  b
-end
-
# a というメソッドに b という変数かメソッドの評価結果を渡して呼び出し、
-# その結果が truthy なら何もしない
-if a(b) then
-end
-

then 等はこの曖昧性を排除するためにあり、条件式は if から then 等までの間にある、ということを明確にする。 -C系の if 後に来る (/) や、Python の :、Rust/Go/Swift などの { も同じ役割を持つ。

-

Ruby の場合、プログラマーが書きやすいよう改行でもって then が代用できるので、ほとんどの場合 then は必要ない。

-

case - in における then

-

ようやく本題にたどり着いた。来る Ruby 3.0 では case と in キーワードを使ったパターンマッチングの構文が入る予定である。この構文でもパターン部との区切りとして then 等が必要になる。 -(現在の) Ruby には formal な形式での文法仕様は存在しないので、yacc の定義ファイルを参照した (yacc の説明は省略)。

-

https://github.com/ruby/ruby/blob/221ca0f8281d39f0dfdfe13b2448875384bbf735/parse.y#L3961-L3986

-
p_case_body	: keyword_in
-		    {
-			SET_LEX_STATE(EXPR_BEG|EXPR_LABEL);
-			p->command_start = FALSE;
-			$<ctxt>1 = p->ctxt;
-			p->ctxt.in_kwarg = 1;
-			$<tbl>$ = push_pvtbl(p);
-		    }
-		    {
-			$<tbl>$ = push_pktbl(p);
-		    }
-		  p_top_expr then
-		    {
-			pop_pktbl(p, $<tbl>3);
-			pop_pvtbl(p, $<tbl>2);
-			p->ctxt.in_kwarg = $<ctxt>1.in_kwarg;
-		    }
-		  compstmt
-		  p_cases
-		    {
-		    /*%%%*/
-			$$ = NEW_IN($4, $7, $8, &@$);
-		    /*% %*/
-		    /*% ripper: in!($4, $7, escape_Qundef($8)) %*/
-		    }
-		;
-

簡略版:

-
p_case_body	: keyword_in p_top_expr then compstmt p_cases
-		;
-

ここで、keyword_in は文字通り in、p_top_expr はいわゆるパターン、then は then キーワードのことではなく、この記事で then 等と呼んでいるもの、つまり then キーワード、;、改行のいずれかである。

-

これにより、case - when による従来の構文と同じように、then 等をパターンの後ろに挿入すればよいことがわかった。つまり次の3通りのいずれかになる:

-
case x
-in 1 then a
-in 2 then b
-in 3 then c
-end
-
-case x
-in 1
-  a
-in 2
-  b
-in 3
-  c
-end
-
-case x
-in 1; a
-in 2; b
-in 3; c
-end
-

ところで、p_top_expr には if による guard clause が書けるので、その場合は if - then と似たような見た目になる。

-
case x
-in 0 then a
-in n if n < 0 then b
-in n then c
-end
-

まとめ

-
    -
  • if や case の条件の後ろには then、;、改行のいずれかが必要 -
      -
    • 通常は改行しておけばよい
      • -
    -
    • -
  • 3.0 で入る予定の case - in でも then 等が必要になる
    • -
  • Ruby の構文を正確に知るには (現状) parse.y を直接読めばよい
    • -
-]]> - - - - [Ruby] 自身を実行している処理系の種類を判定する - https://blog.nsfisis.dev/posts/2021-10-02/ruby-detect-running-implementation/ - Sat, 02 Oct 2021 09:37:50 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/ruby-detect-running-implementation/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/74d7ffeeebc51b20d791

-
-

Ruby という言語には複数の実装があるが、それらをスクリプト上からどのようにして programmatically に見分ければよいだろうか。

-

Object クラスに定義されている RUBY_ENGINE という定数がこの用途に使える。

-

参考: Object::RUBY_ENGINE

-

上記ページの例から引用する:

-
$ ruby-1.9.1 -ve 'p RUBY_ENGINE'
-ruby 1.9.1p0 (2009-03-04 revision 22762) [x86_64-linux]
-"ruby"
-$ jruby -ve 'p RUBY_ENGINE'
-jruby 1.2.0 (ruby 1.8.6 patchlevel 287) (2009-03-16 rev 9419) [i386-java]
-"jruby"
-

それぞれの処理系がどのような値を返すかだが、stack overflow に良い質問と回答があった。

-

What values for RUBY_ENGINE correspond to which Ruby implementations? より引用:

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
RUBY_ENGINEImplementation
<undefined>MRI < 1.9
‘ruby’MRI >= 1.9 or REE
‘jruby’JRuby
‘macruby’MacRuby
‘rbx’Rubinius
‘maglev’MagLev
‘ironruby’IronRuby
‘cardinal’Cardinal
-
-

なお、この質問・回答は 2014年になされたものであり、値は変わっている可能性がある。MRI (aka CRuby) については執筆時現在 (2020/12/8) も 'ruby' が返ってくることを確認済み。

-

この表にない主要な処理系として、mruby は 'mruby' を返す。

-

mruby 該当部分のソース より引用:

-
/*
- * Ruby engine.
- */
-#define MRUBY_RUBY_ENGINE  "mruby"
-
]]> - - - - diff --git a/docs/tags/ruby/index.html b/docs/tags/ruby/index.html deleted file mode 100644 index a23cbbf..0000000 --- a/docs/tags/ruby/index.html +++ /dev/null @@ -1,68 +0,0 @@ - - - - - - - - ruby | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -

ruby

- -
-
-

[Ruby] then キーワードと case in

-
-
-

Ruby 3.0 で追加される case in 構文と、then キーワードについて。

-
-
- Posted on -
- -
-
-
-

[Ruby] 自身を実行している処理系の種類を判定する

-
-
-

Ruby には複数の実装があるが、自身を実行している処理系の種類をスクリプト上からどのように判定すればよいだろうか。

-
-
- Posted on -
- -
- - - - - - diff --git a/docs/tags/ruby/page/1/index.html b/docs/tags/ruby/page/1/index.html deleted file mode 100644 index 9374bc8..0000000 --- a/docs/tags/ruby/page/1/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - - https://blog.nsfisis.dev/tags/ruby/ - - - - - - diff --git a/docs/tags/ruby3/feed.xml b/docs/tags/ruby3/feed.xml deleted file mode 100644 index 530cc62..0000000 --- a/docs/tags/ruby3/feed.xml +++ /dev/null @@ -1,155 +0,0 @@ - - - - ruby3 on REPL: Rest-Eat-Program Loop - https://blog.nsfisis.dev/tags/ruby3/ - Recent content in ruby3 on REPL: Rest-Eat-Program Loop - Hugo -- gohugo.io - ja-JP - Sat, 02 Oct 2021 09:38:50 +0900 - - [Ruby] then キーワードと case in - https://blog.nsfisis.dev/posts/2021-10-02/ruby-then-keyword-and-case-in/ - Sat, 02 Oct 2021 09:38:50 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/ruby-then-keyword-and-case-in/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/787a8cf888a304497223

-
-

TL; DR

-

case - in によるパターンマッチング構文でも、case - when と同じように then が使える (場合によっては使う必要がある)。

-

then とは

-

使われることは稀だが、Ruby では then がキーワードになっている。次のように使う:

-
if cond then
-  puts "Y"
-else
-  puts "N"
-end
-

このキーワードが現れうる場所はいくつかあり、if、unless、rescue、case 構文がそれに当たる。 -上記のように、何か条件を書いた後 then を置き、式がそこで終了していることを示すマーカーとして機能する。

-
# Example:
-
-if x then
-  a
-end
-
-unless x then
-  a
-end
-
-begin
-  a
-rescue then
-  b
-end
-
-case x
-when p then
-  a
-end
-

なぜ普段は書かなくてもよいのか

-

普通 Ruby のコードで then を書くことはない。なぜか。次のコードを実行してみるとわかる。

-
if true puts 'Hello, World!' end
-

次のような構文エラーが出力される。

-
20:1: syntax error, unexpected local variable or method, expecting `then' or ';' or '\n'
-if true puts 'Hello, World!' end
-        ^~~~
-20:1: syntax error, unexpected `end', expecting end-of-input
-...f true puts 'Hello, World!' end
-

二つ目のメッセージは無視して一つ目を読むと、then か ; か改行が来るはずのところ変数だかメソッドだかが現れたことによりエラーとなっているようだ。

-

ポイントは改行が then (や ;) の代わりとなることである。true の後に改行を入れてみる。

-
if true
-puts 'Hello, World!' end
-

無事 Hello, World! と出力されるようになった。

-

なぜ then や ; や改行が必要か

-

なぜ then や ; や改行 (以下 「then 等」) が必要なのだろうか。次の例を見てほしい:

-
if a b end
-

then も ; も改行もないのでエラーになるが、これは条件式がどこまで続いているのかわからないためだ。 -この例は二通りに解釈できる。

-
# a という変数かメソッドの評価結果が truthy なら b という変数かメソッドを評価
-if a then
-  b
-end
-
# a というメソッドに b という変数かメソッドの評価結果を渡して呼び出し、
-# その結果が truthy なら何もしない
-if a(b) then
-end
-

then 等はこの曖昧性を排除するためにあり、条件式は if から then 等までの間にある、ということを明確にする。 -C系の if 後に来る (/) や、Python の :、Rust/Go/Swift などの { も同じ役割を持つ。

-

Ruby の場合、プログラマーが書きやすいよう改行でもって then が代用できるので、ほとんどの場合 then は必要ない。

-

case - in における then

-

ようやく本題にたどり着いた。来る Ruby 3.0 では case と in キーワードを使ったパターンマッチングの構文が入る予定である。この構文でもパターン部との区切りとして then 等が必要になる。 -(現在の) Ruby には formal な形式での文法仕様は存在しないので、yacc の定義ファイルを参照した (yacc の説明は省略)。

-

https://github.com/ruby/ruby/blob/221ca0f8281d39f0dfdfe13b2448875384bbf735/parse.y#L3961-L3986

-
p_case_body	: keyword_in
-		    {
-			SET_LEX_STATE(EXPR_BEG|EXPR_LABEL);
-			p->command_start = FALSE;
-			$<ctxt>1 = p->ctxt;
-			p->ctxt.in_kwarg = 1;
-			$<tbl>$ = push_pvtbl(p);
-		    }
-		    {
-			$<tbl>$ = push_pktbl(p);
-		    }
-		  p_top_expr then
-		    {
-			pop_pktbl(p, $<tbl>3);
-			pop_pvtbl(p, $<tbl>2);
-			p->ctxt.in_kwarg = $<ctxt>1.in_kwarg;
-		    }
-		  compstmt
-		  p_cases
-		    {
-		    /*%%%*/
-			$$ = NEW_IN($4, $7, $8, &@$);
-		    /*% %*/
-		    /*% ripper: in!($4, $7, escape_Qundef($8)) %*/
-		    }
-		;
-

簡略版:

-
p_case_body	: keyword_in p_top_expr then compstmt p_cases
-		;
-

ここで、keyword_in は文字通り in、p_top_expr はいわゆるパターン、then は then キーワードのことではなく、この記事で then 等と呼んでいるもの、つまり then キーワード、;、改行のいずれかである。

-

これにより、case - when による従来の構文と同じように、then 等をパターンの後ろに挿入すればよいことがわかった。つまり次の3通りのいずれかになる:

-
case x
-in 1 then a
-in 2 then b
-in 3 then c
-end
-
-case x
-in 1
-  a
-in 2
-  b
-in 3
-  c
-end
-
-case x
-in 1; a
-in 2; b
-in 3; c
-end
-

ところで、p_top_expr には if による guard clause が書けるので、その場合は if - then と似たような見た目になる。

-
case x
-in 0 then a
-in n if n < 0 then b
-in n then c
-end
-

まとめ

-
    -
  • if や case の条件の後ろには then、;、改行のいずれかが必要 -
      -
    • 通常は改行しておけばよい
      • -
    -
    • -
  • 3.0 で入る予定の case - in でも then 等が必要になる
    • -
  • Ruby の構文を正確に知るには (現状) parse.y を直接読めばよい
    • -
-]]> - - - - diff --git a/docs/tags/ruby3/index.html b/docs/tags/ruby3/index.html deleted file mode 100644 index b204a64..0000000 --- a/docs/tags/ruby3/index.html +++ /dev/null @@ -1,56 +0,0 @@ - - - - - - - - ruby3 | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -

ruby3

- -
-
-

[Ruby] then キーワードと case in

-
-
-

Ruby 3.0 で追加される case in 構文と、then キーワードについて。

-
-
- Posted on -
- -
- - - - - - diff --git a/docs/tags/ruby3/page/1/index.html b/docs/tags/ruby3/page/1/index.html deleted file mode 100644 index 15caf8a..0000000 --- a/docs/tags/ruby3/page/1/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - - https://blog.nsfisis.dev/tags/ruby3/ - - - - - - diff --git a/docs/tags/rust/feed.xml b/docs/tags/rust/feed.xml deleted file mode 100644 index 60f98d3..0000000 --- a/docs/tags/rust/feed.xml +++ /dev/null @@ -1,143 +0,0 @@ - - - - rust on REPL: Rest-Eat-Program Loop - https://blog.nsfisis.dev/tags/rust/ - Recent content in rust on REPL: Rest-Eat-Program Loop - Hugo -- gohugo.io - ja-JP - Sat, 02 Oct 2021 09:39:27 +0900 - - Rust のプリミティブ型はどこからやって来るか - https://blog.nsfisis.dev/posts/2021-10-02/rust-where-are-primitive-types-from/ - Sat, 02 Oct 2021 09:39:27 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/rust-where-are-primitive-types-from/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/9a429432258bbcd6c565

-
-

前置き

-

Rust において、プリミティブ型の名前は予約語でない。したがって、次のコードは合法である。

-
#![allow(non_camel_case_types)]
-#![allow(dead_code)]
-
-struct bool;
-struct char;
-struct i8;
-struct i16;
-struct i32;
-struct i64;
-struct i128;
-struct isize;
-struct u8;
-struct u16;
-struct u32;
-struct u64;
-struct u128;
-struct usize;
-struct f32;
-struct f64;
-struct str;
-

では、普段単に bool と書いたとき、この bool は一体どこから来ているのか。rustc のソースを追ってみた。

-
-

前提知識: 一般的なコンパイラの構造、用語。rustc そのものの知識は不要 (というよりも筆者自身がよく知らない)

-
-

調査

-

調査に使用したソース (調査時点での最新 master)

-

https://github.com/rust-lang/rust/tree/511ed9f2356af365ad8affe046b3dd33f7ac3c98

-

どのようにして調べるか。rustc の構造には詳しくないため、すぐに当たりをつけるのは難しい。

-

大雑把な構造としては、compiler フォルダ以下に rustc_* という名前のクレートが数十個入っている。これがどうやら rustc コマンドの実装部のようだ。

-

rustc はセルフホストされている (= rustc 自身が Rust で書かれている) ので、bool や char などで適当に検索をかけてもノイズが多すぎて話にならない。 -しかし、お誂え向きなことに i128/u128 というコンパイラ自身が使うことがなさそうな型が存在するのでこれを使って git grep してみる。

-
$ git grep "\bi128\b" | wc      # i128
-     165    1069   15790
-
-$ git grep "\bu128\b" | wc      # u128
-     293    2127   26667
-
-$ git grep "\bbool\b" | wc      # cf. bool の結果
-    3563   23577  294659
-

165 程度であれば探すことができそうだ。今回は、クレート名を見ておおよその当たりをつけた。

-
$ git grep "\bi128\b"
-...
-rustc_resolve/src/lib.rs:        table.insert(sym::i128, Int(IntTy::I128));
-...
-

rustc_resolve というのはいかにも名前解決を担いそうなクレート名である。該当箇所を見てみる。

-
/// Interns the names of the primitive types.
-///
-/// All other types are defined somewhere and possibly imported, but the primitive ones need
-/// special handling, since they have no place of origin.
-struct PrimitiveTypeTable {
-    primitive_types: FxHashMap<Symbol, PrimTy>,
-}
-
-impl PrimitiveTypeTable {
-    fn new() -> PrimitiveTypeTable {
-        let mut table = FxHashMap::default();
-
-        table.insert(sym::bool, Bool);
-        table.insert(sym::char, Char);
-        table.insert(sym::f32, Float(FloatTy::F32));
-        table.insert(sym::f64, Float(FloatTy::F64));
-        table.insert(sym::isize, Int(IntTy::Isize));
-        table.insert(sym::i8, Int(IntTy::I8));
-        table.insert(sym::i16, Int(IntTy::I16));
-        table.insert(sym::i32, Int(IntTy::I32));
-        table.insert(sym::i64, Int(IntTy::I64));
-        table.insert(sym::i128, Int(IntTy::I128));
-        table.insert(sym::str, Str);
-        table.insert(sym::usize, Uint(UintTy::Usize));
-        table.insert(sym::u8, Uint(UintTy::U8));
-        table.insert(sym::u16, Uint(UintTy::U16));
-        table.insert(sym::u32, Uint(UintTy::U32));
-        table.insert(sym::u64, Uint(UintTy::U64));
-        table.insert(sym::u128, Uint(UintTy::U128));
-        Self { primitive_types: table }
-    }
-}
-

これは初めに列挙したプリミティブ型の一覧と一致している。doc comment にも、

-
-

All other types are defined somewhere and possibly imported, but the primitive ones need special handling, since they have no place of origin.

-
-

とある。次はこの struct の使用箇所を追う。追うと言っても使われている箇所は次の一箇所しかない。なお説明に不要な箇所は大きく削っている。

-
    /// This resolves the identifier `ident` in the namespace `ns` in the current lexical scope.
-    /// (略)
-    fn resolve_ident_in_lexical_scope(
-        &mut self,
-        mut ident: Ident,
-        ns: Namespace,
-        // (略)
-    ) -> Option<LexicalScopeBinding<'a>> {
-        // (略)
-
-        if ns == TypeNS {
-            if let Some(prim_ty) = self.primitive_type_table.primitive_types.get(&ident.name) {
-                let binding =
-                    (Res::PrimTy(*prim_ty), ty::Visibility::Public, DUMMY_SP, ExpnId::root())
-                        .to_name_binding(self.arenas);
-                return Some(LexicalScopeBinding::Item(binding));
-            }
-        }
-
-        None
-    }
-

関数名や doc comment が示している通り、この関数は識別子 (identifier, ident) を現在のレキシカルスコープ内で解決 (resolve) する。 -if ns == TypeNS のブロック内では、primitive_type_table (上記の PrimitiveTypeTable::new() で作られた変数) に含まれている識別子 (bool、i32 など) かどうか判定し、そうであればそれに紐づけられたプリミティブ型を返している。

-

なお、ns は「名前空間」を示す変数である。Rust における名前空間はC言語におけるそれとほとんど同じで、今探している名前が関数名/変数名なのか型なのかマクロなのかを区別している。この if は、プリミティブ型に解決されるのは型を探しているときだけだ、と言っている。

-

重要なのは、これが resolve_ident_in_lexical_scope() の最後に書かれている点である。つまり、最初に挙げたプリミティブ型の識別子は、「名前解決の最終段階で」、「他に同名の型が見つかっていなければ」プリミティブ型として解決される。

-

動作がわかったところで、例として次のコードを考える。

-
#![allow(non_camel_case_types)]
-
-struct bool;
-
-fn main() {
-    let _: bool = bool;
-}
-

ここで main() の bool は struct bool として解決される。なぜなら、プリミティブ型の判定をする前に bool という名前の別の型が見つかるからだ。

-

まとめ

-

Rust のプリミティブ型は予約語ではない。名前解決の最終段階で特別扱いされ、他に同名の型が見つかっていなければ対応するプリミティブ型に解決される。

-]]> - - - - diff --git a/docs/tags/rust/index.html b/docs/tags/rust/index.html deleted file mode 100644 index 7b89cc4..0000000 --- a/docs/tags/rust/index.html +++ /dev/null @@ -1,56 +0,0 @@ - - - - - - - - rust | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -

rust

- -
-
-

Rust のプリミティブ型はどこからやって来るか

-
-
-

Rust のプリミティブ型は予約語ではなく普通の識別子である。どのようにこれが名前解決されるのかを調べた。

-
-
- Posted on -
- -
- - - - - - diff --git a/docs/tags/rust/page/1/index.html b/docs/tags/rust/page/1/index.html deleted file mode 100644 index 5cf7d43..0000000 --- a/docs/tags/rust/page/1/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - - https://blog.nsfisis.dev/tags/rust/ - - - - - - diff --git a/docs/tags/vim/feed.xml b/docs/tags/vim/feed.xml deleted file mode 100644 index 73bb677..0000000 --- a/docs/tags/vim/feed.xml +++ /dev/null @@ -1,191 +0,0 @@ - - - - vim on REPL: Rest-Eat-Program Loop - https://blog.nsfisis.dev/tags/vim/ - Recent content in vim on REPL: Rest-Eat-Program Loop - Hugo -- gohugo.io - ja-JP - Sat, 02 Oct 2021 09:37:25 +0900 - - Vimで選択した行の順番を入れ替える - https://blog.nsfisis.dev/posts/2021-10-02/vim-swap-order-of-selected-lines/ - Sat, 02 Oct 2021 09:37:25 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/vim-swap-order-of-selected-lines/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/4fefb361d9a693803520

-
-

バージョン情報

-

:version の一部

-
-

VIM - Vi IMproved 8.2 (2019 Dec 12, compiled Jan 26 2020 11:30:30) -macOS version -Included patches: 1-148 -Huge version without GUI.

-
-

よく紹介されている手法

-

tac / tail

-

tac や tail -r などの外部コマンドを ! を使って呼び出し、置き換える。

-
-

:h v_!

-
-

tac コマンドや tail の -r オプションは環境によって利用できないことがあり、複数の環境を行き来する場合に採用しづらい

-

:g/^/m0

-

こちらは外部コマンドに頼らず、Vim の機能のみを使う。g は :global コマンドの、m は :move コマンドの略

-

:global コマンドは :[range]global/{pattern}/[command] のように使い、[range] で指定された範囲の行のうち、{pattern} で指定された検索パターンにマッチする行に対して、順番に [command] で指定された Ex コマンドを呼び出す。

-
-

:h :global

-
-

:move コマンドは [range]:move {address} のように使い、[range] で指定された範囲の行を {address} で指定された位置に移動させる。

-
-

:h :move

-
-

:g/^/m0 のように組み合わせると、「すべての行を1行ずつ 0行目(1行目の上)に動かす」という動きをする。これは確かに行の入れ替えになっている。

-

なお、:g/^/m0 は全ての行を入れ替えるが、:N,Mg/^/mN-1 とすることで N行目から M行目を処理範囲とするよう拡張できる。手でこれを入力するわけにはいかないので、次のようなコマンドを用意する。

-
command! -bar -range=%
-    \ Reverse
-    \ <line1>,<line2>g/^/m<line1>-1
-

これは望みの動作をするが、実際に実行してみると全行がハイライトされてしまう。次節で詳細を述べる。

-

:g/^/m0 の問題点

-

:global コマンドは各行に対してマッチングを行う際、現在の検索パターンを上書きしてしまう。^ は行の先頭にマッチするため、結果として全ての行がハイライトされてしまう。'hlsearch' オプションを無効にしている場合その限りではないが、その場合でも直前の検索パターンが失われてしまうと n コマンドなどの際に不便である。

-
-

:h @/

-
-

解決策

-
-

[2020/9/28追記] -より簡潔な方法を見つけたので次節に追記した

-
-

前述した :Reverse コマンドの定義を少し変えて、次のようにする:

-
function! s:reverse_lines(from, to) abort
-    execute printf("%d,%dg/^/m%d", a:from, a:to, a:from - 1)
-endfunction
-
-command! -bar -range=%
-    \ Reverse
-    \ call <SID>reverse_lines(<line1>, <line2>)
-

実行しているコマンドが変わったわけではないが、関数呼び出しを経由するようにした。これだけで前述の問題が解決する。

-

この理由は、ユーザー定義関数を実行する際は検索パターンが一度保存され、実行が終了したあと復元されるため。結果として検索パターンが ^ で上書きされることがなくなる。

-

Vim のヘルプから該当箇所を引用する (強調は筆者による)。

-
-

:h autocmd-searchpat

-

Autocommands do not change the current search patterns. Vim saves the current -search patterns before executing autocommands then restores them after the -autocommands finish. This means that autocommands do not affect the strings -highlighted with the ‘hlsearch’ option.

-
-

これは autocommand の実行に関しての記述だが、これと同じことがユーザー定義関数の実行時にも適用される。このことは :nohlsearch のヘルプにある。同じく該当箇所を引用する (強調は筆者による)。

-
-

:h :nohlsearch

-

(略) This command doesn’t work in an autocommand, because -the highlighting state is saved and restored when -executing autocommands |autocmd-searchpat|. -Same thing for when invoking a user function.

-
-

この仕様により、:g/^/m0 の呼び出しをユーザー定義関数に切り出すことで上述の問題を解決できる。

-

解決策 (改訂版)

-
-

[2020/9/28追記] -より簡潔な方法を見つけたため追記する

-
-
command! -bar -range=%
-    \ Reverse
-    \ keeppatterns <line1>,<line2>g/^/m<line1>-1
-

まさにこのための Exコマンド、:keeppatterns が存在する。:keeppatterns {command} のように使い、読んで字の如く、後ろに続く Exコマンドを「現在の検索パターンを保ったまま」実行する。はるかに分かりやすく意図を表現できる。

-
-

:h :keeppatterns

-
-

コピペ用再掲

-
" License: Public Domain
-
-command! -bar -range=%
-    \ Reverse
-    \ keeppatterns <line1>,<line2>g/^/m<line1>-1
-
]]> - - - - [Vim] autocmd events の BufWrite/BufWritePre の違い - https://blog.nsfisis.dev/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre/ - Sat, 02 Oct 2021 09:37:12 +0900 - - https://blog.nsfisis.dev/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre/ - この記事は Qiita から移植してきたものです。 -元 URL: https://qiita.com/nsfisis/items/79ab4db8564032de0b25

-
-

TL; DR

-

違いはない。ただのエイリアス。

-

調査記録

-

Vim の autocmd events には似通った名前のものがいくつかある。大抵は :help に説明があるが、この記事のタイトルにある2つを含めた以下のイベントには、その違いについて説明がない。

-
    -
  • BufRead/BufReadPost
    • -
  • BufWrite/BufWritePre
    • -
  • BufAdd/BufCreate
    • -
-

このうち、BufAdd/BufCreate に関しては、:help BufCreate に

-
-

The BufCreate event is for historic reasons.

-
-

とあり、おそらくは BufAdd のエイリアスであろうということがわかる。他の2組も同様ではないかと予想されるが、確認のため vim と neovim のソースコードを調査した。

-
-

ソースコードへのリンク -vim (調査時点での master branch) -neovim (上に同じ)

-
-

vim のソースコード

-

以下は、autocmd events の名前と内部で使われている整数値とのマッピングを定義している箇所である。見ての通り、上でエイリアスではないかと述べた3組には、それぞれ同じ内部値が使われている。

-

https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L85-L86

-
    {"BufAdd",		EVENT_BUFADD},
-    {"BufCreate",	EVENT_BUFADD},
-

https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L95-L97

-
    {"BufRead",		EVENT_BUFREADPOST},
-    {"BufReadCmd",	EVENT_BUFREADCMD},
-    {"BufReadPost",	EVENT_BUFREADPOST},
-

https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L103-L105

-
    {"BufWrite",	EVENT_BUFWRITEPRE},
-    {"BufWritePost",	EVENT_BUFWRITEPOST},
-    {"BufWritePre",	EVENT_BUFWRITEPRE},
-

neovim のソースコード

-

neovim の場合でも同様のマッピングが定義されているが、こちらの場合は Lua で書かれている。以下にある通り、はっきり aliases と書かれている。

-

https://github.com/neovim/neovim/blob/71d4f5851f068eeb432af34850dddda8cc1c71e3/src/nvim/auevents.lua#L119-L124

-
  aliases = {
-    BufCreate = 'BufAdd',
-    BufRead = 'BufReadPost',
-    BufWrite = 'BufWritePre',
-    FileEncoding = 'EncodingChanged',
-  },
-

ところで、上では取り上げなかった FileEncoding だが、これは :help FileEncoding にしっかりと書いてある。

-
                                                           *FileEncoding*
-FileEncoding                    Obsolete.  It still works and is equivalent
-                                to |EncodingChanged|.
-

まとめ

-

記事タイトルについて言えば、どちらも変わらないので好きな方を使えばよい。あえて言えば、次のようになるだろう。

-
    -
  • BufAdd/BufCreate -
      -
    • → BufCreate は歴史的な理由により (“for historic reasons”) 存在しているため、新しい方 (BufAdd) を使う
      • -
    -
    • -
  • BufRead/BufReadPost -
      -
    • → BufReadPre との対称性のため、あるいは BufWritePost との対称性のため BufReadPost を使う
      • -
    -
    • -
  • BufWrite/BufWritePre -
      -
    • → BufWritePost との対称性のため、あるいは BufReadPre との対称性のため BufWritePre を使う
      • -
    -
    • -
  • FileEncoding/EncodingChanged -
      -
    • → FileEncoding は “Obsolete” と明言されているので、EncodingChanged を使う
      • -
    -
    • -
-

ところでこの調査で知ったのだが、BufRead と BufWrite は上にある通り発火するタイミングが「後」と「前」で対称性がない。可能なら Pre/Post 付きのものを使った方が分かりやすいだろう。

-]]> - - - - diff --git a/docs/tags/vim/index.html b/docs/tags/vim/index.html deleted file mode 100644 index 5964ab8..0000000 --- a/docs/tags/vim/index.html +++ /dev/null @@ -1,68 +0,0 @@ - - - - - - - - vim | REPL: Rest-Eat-Program Loop - - - - - - - - - - - - - - - -
- -
-
- -

vim

- -
-
-

Vimで選択した行の順番を入れ替える

-
-
-

Vim で選択した行の順番を入れ替える方法。

-
-
- Posted on -
- -
-
-
-

[Vim] autocmd events の BufWrite/BufWritePre の違い

-
-
-

Vim の autocmd events における BufWrite/BufWritePre がどう違うのかを調べた結果、違いはないことがわかった。

-
-
- Posted on -
- -
- - - - - - diff --git a/docs/tags/vim/page/1/index.html b/docs/tags/vim/page/1/index.html deleted file mode 100644 index 52be41d..0000000 --- a/docs/tags/vim/page/1/index.html +++ /dev/null @@ -1,10 +0,0 @@ - - - - https://blog.nsfisis.dev/tags/vim/ - - - - - - diff --git a/lib/command.rb b/lib/command.rb new file mode 100644 index 0000000..81692b3 --- /dev/null +++ b/lib/command.rb @@ -0,0 +1,152 @@ +module NulDoc + class Command + def initialize(config) + @config = config + @content_dir = @config[:content_dir] + @dest_dir = @config[:dest_dir] + @template_dir = @config[:template_dir] + @parser = NulDoc::Parser.new( + { + 'author' => @config[:author], + 'site-copyright-year' => @config[:site_copyright_year], + 'site-name' => @config[:site_name], + 'source-highlighter' => 'rouge', + 'reproducible' => true, + 'sectids' => false, + }, + @content_dir, + @template_dir, + ) + end + + def run + posts = generate_posts(@content_dir + '/posts') + generate_tags(posts) + generate_posts_list(posts) + end + + private + + def generate_posts(source_dir) + post_files = collect_post_files(source_dir) + posts = parse_posts(post_files) + output_posts(posts) + posts + end + + def collect_post_files(source_dir) + file_paths = [] + Dir.glob('**/*.adoc', base: source_dir, sort: true) do |path| + file_paths << "#{source_dir}/#{path}" + end + file_paths + end + + def parse_posts(post_file_paths) + post_file_paths.map { @parser.parse_file(_1) } + end + + def output_posts(posts) + posts.each do |post| + destination_file_path = post.attributes['source-file-path'] + .sub(@content_dir, @dest_dir) + .sub('.adoc', '/index.html') + destination_dir = File.dirname(destination_file_path) + unless Dir.exist?(destination_dir) + FileUtils.makedirs(destination_dir) + end + open(destination_file_path, 'w') do |f| + f.puts(post.convert) + end + end + end + + def generate_tags(posts) + tags_and_posts = collect_tags(posts) + tag_docs = build_tag_docs(tags_and_posts) + output_tags(tag_docs) + end + + def collect_tags(posts) + tags_and_posts = {} + posts.each do |post| + post.attributes['tags'].each do |tag| + tags_and_posts[tag] ||= [] + tags_and_posts[tag] << post + end + end + tags_and_posts + .transform_values {|posts| + posts.sort_by {|post| + post.attributes['revision-history'].first.date # created_at + }.reverse + } + .sort_by {|tag, _| tag.slug } + .to_h + end + + def build_tag_docs(tags_and_posts) + tags_and_posts.map do |tag, posts| + [tag, build_tag_doc(tag, posts)] + end + end + + def build_tag_doc(tag, posts) + erb = ERB.new(File.read(@template_dir + '/tag.html.erb')) + erb.result_with_hash({ + tag: tag, + posts: posts, + author: @config[:author], + site_copyright_year: @config[:site_copyright_year], + site_name: @config[:site_name], + lang: 'ja-JP', # TODO + copyright_year: posts.last.attributes['revision-history'].first.date.year, + description: "タグ「#{tag.label}」のついた記事一覧", + }) + end + + def output_tags(tag_docs) + tag_docs.each do |tag, html| + destination_file_path = "#{@dest_dir}/tags/#{tag.slug}/index.html" + destination_dir = File.dirname(destination_file_path) + unless Dir.exist?(destination_dir) + FileUtils.makedirs(destination_dir) + end + open(destination_file_path, 'w') do |f| + f.puts(html) + end + end + end + + def generate_posts_list(posts) + html = build_posts_list_doc(posts) + output_posts_list(html) + end + + def build_posts_list_doc(posts) + erb = ERB.new(File.read(@template_dir + '/posts_list.html.erb')) + erb.result_with_hash({ + posts: posts.reverse, + author: @config[:author], + site_copyright_year: @config[:site_copyright_year], + site_name: @config[:site_name], + lang: 'ja-JP', # TODO + copyright_year: @config[:site_copyright_year], + description: "記事一覧", + doctitle: "Posts", + header_title: "Posts", + }) + end + + def output_posts_list(html) + destination_file_path = "#{@dest_dir}/posts/index.html" + destination_dir = File.dirname(destination_file_path) + unless Dir.exist?(destination_dir) + FileUtils.makedirs(destination_dir) + end + open(destination_file_path, 'w') do |f| + f.puts(html) + end + end + end +end diff --git a/lib/extensions/document_title_processor.rb b/lib/extensions/document_title_processor.rb new file mode 100644 index 0000000..fd25844 --- /dev/null +++ b/lib/extensions/document_title_processor.rb @@ -0,0 +1,15 @@ +module Nuldoc + module Extensions + class DocumentTitleProcessor < Asciidoctor::Extensions::TreeProcessor + def process(doc) + doc.title = substitute_document_title(doc.title) + end + + private + + def substitute_document_title(title) + title.sub(/\A\[(.+?)\] /, '【\1】') + end + end + end +end diff --git a/lib/extensions/lang_attribute_processor.rb b/lib/extensions/lang_attribute_processor.rb new file mode 100644 index 0000000..65511bc --- /dev/null +++ b/lib/extensions/lang_attribute_processor.rb @@ -0,0 +1,9 @@ +module Nuldoc + module Extensions + class LangAttributeProcessor < Asciidoctor::Extensions::TreeProcessor + def process(doc) + doc.attributes['lang'] ||= 'ja-JP' + end + end + end +end diff --git a/lib/extensions/revision_history_processor.rb b/lib/extensions/revision_history_processor.rb new file mode 100644 index 0000000..f416de0 --- /dev/null +++ b/lib/extensions/revision_history_processor.rb @@ -0,0 +1,27 @@ +module Nuldoc + module Extensions + class RevisionHistoryProcessor < Asciidoctor::Extensions::TreeProcessor + def process(doc) + revisions = [] + i = 1 + loop do + break unless (rev = doc.attributes["revision-#{i}"]) + revisions << parse_revision(rev) + i += 1 + end + doc.attributes['revision-history'] = revisions + end + + private + + def parse_revision(rev) + m = rev.match(/\A(\d\d\d\d-\d\d-\d\d) (.*)\z/) + raise unless m + Revision.new( + date: Date.parse(m[1], '%Y-%m-%d'), + remark: m[2], + ) + end + end + end +end diff --git a/lib/extensions/section_id_validator.rb b/lib/extensions/section_id_validator.rb new file mode 100644 index 0000000..2ad496c --- /dev/null +++ b/lib/extensions/section_id_validator.rb @@ -0,0 +1,29 @@ +module Nuldoc + module Extensions + class SectionIdValidator < Asciidoctor::Extensions::TreeProcessor + def process(doc) + errors = [] + (doc.find_by(context: :section) {_1.level > 0}).each do |section| + errors << validate_section(section) + end + error_message = errors.compact.join("\n") + unless error_message.empty? + raise "SectionIdValidator (#{doc.attributes['source-file-path']}):\n#{error_message}" + end + end + + private + + def validate_section(section) + id = section.id + unless id + return "Section '#{section.title}': each section MUST have an id." + end + unless id.match?(/\A[-0-9a-z]+\z/) + return "Section '#{section.title}' (##{id}): section id MUST consist of either hyphen, digits or lowercases." + end + nil + end + end + end +end diff --git a/lib/extensions/source_id_processor.rb b/lib/extensions/source_id_processor.rb new file mode 100644 index 0000000..13813e0 --- /dev/null +++ b/lib/extensions/source_id_processor.rb @@ -0,0 +1,12 @@ +module Nuldoc + module Extensions + class SourceIdProcessor < Asciidoctor::Extensions::TreeProcessor + def process(doc) + errors = [] + (doc.find_by(context: :listing) {_1.style == 'source'}).each do |source| + source.id = "source.#{source.id}" + end + end + end + end +end diff --git a/lib/extensions/source_id_validator.rb b/lib/extensions/source_id_validator.rb new file mode 100644 index 0000000..6e04deb --- /dev/null +++ b/lib/extensions/source_id_validator.rb @@ -0,0 +1,32 @@ +module Nuldoc + module Extensions + class SourceIdValidator < Asciidoctor::Extensions::TreeProcessor + def process(doc) + errors = [] + (doc.find_by(context: :listing) {_1.style == 'source'}).each do |source| + errors << validate_section(source) + end + error_message = errors.compact.join("\n") + unless error_message.empty? + raise "SourceIdValidator (#{doc.attributes['source-file-path']}):\n#{error_message}" + end + end + + private + + def validate_section(source) + id = source.id + unless id + return "Each source MUST have an id." + end + if id.start_with?('source.') + return "Source id (##{id}) MUST NOT start with 'source.', which is appended by `nul`." + end + unless id.match?(/\A[-0-9a-z]+\z/) + return "Source id (##{id}) MUST consist of either hypen, digits or lowercases." + end + nil + end + end + end +end diff --git a/lib/extensions/tags_processor.rb b/lib/extensions/tags_processor.rb new file mode 100644 index 0000000..efbd2a8 --- /dev/null +++ b/lib/extensions/tags_processor.rb @@ -0,0 +1,20 @@ +module Nuldoc + module Extensions + class TagsProcessor < Asciidoctor::Extensions::TreeProcessor + def process(doc) + doc.attributes['tags'] = convert_tags(doc.attributes['tags']) + end + + private + + def convert_tags(tags) + return [] unless tags + + tags + .split(',') + .map(&:strip) + .map { Tag.from_slug(_1) } + end + end + end +end diff --git a/lib/parser.rb b/lib/parser.rb new file mode 100644 index 0000000..8ae3303 --- /dev/null +++ b/lib/parser.rb @@ -0,0 +1,54 @@ +module NulDoc + class Parser + def initialize(common_attributes, content_dir, template_dir) + @common_attributes = common_attributes + @content_dir = content_dir + @template_dir = template_dir + end + + def parse_file(file_path) + Asciidoctor.load_file( + file_path, + backend: :html5, + doctype: :article, + standalone: true, + safe: :unsafe, + template_dirs: [@template_dir], + template_engine: 'erb', + attributes: @common_attributes.merge({ + 'source-file-path' => file_path, + 'href' => file_path.sub(@content_dir, '').sub('.adoc', '/'), + }), + extension_registry: Asciidoctor::Extensions.create do + tree_processor Nuldoc::Extensions::RevisionHistoryProcessor + tree_processor Nuldoc::Extensions::DocumentTitleProcessor + tree_processor Nuldoc::Extensions::LangAttributeProcessor + # tree_processor Nuldoc::Extensions::SectionIdValidator + # tree_processor Nuldoc::Extensions::SourceIdValidator + tree_processor Nuldoc::Extensions::TagsProcessor + + # MUST BE AT THE END + tree_processor Nuldoc::Extensions::SourceIdProcessor + end, + ) + end + + def parse_string(s, copyright_year) + Asciidoctor.convert( + s, + backend: :html5, + doctype: :article, + safe: :unsafe, + template_dirs: [@template_dir], + template_engine: 'erb', + attributes: @common_attributes.merge({ + 'copyright-year' => copyright_year, + }), + extension_registry: Asciidoctor::Extensions.create do + tree_processor Nuldoc::Extensions::LangAttributeProcessor + tree_processor Nuldoc::Extensions::TagsProcessor + end, + ) + end + end +end diff --git a/lib/revision.rb b/lib/revision.rb new file mode 100644 index 0000000..b986a14 --- /dev/null +++ b/lib/revision.rb @@ -0,0 +1,3 @@ +module Nuldoc + Revision = Struct.new(:date, :remark, keyword_init: true) +end diff --git a/lib/tag.rb b/lib/tag.rb new file mode 100644 index 0000000..a7c13b2 --- /dev/null +++ b/lib/tag.rb @@ -0,0 +1,26 @@ +module Nuldoc + Tag = Struct.new(:slug, :label, keyword_init: true) do + LABELS = { + 'conference' => 'カンファレンス', + 'cpp' => 'C++', + 'cpp17' => 'C++ 17', + 'note-to-self' => '備忘録', + 'php' => 'PHP', + 'phpcon' => 'PHP カンファレンス', + 'phperkaigi' => 'PHPerKaigi', + 'python' => 'Python', + 'python3' => 'Python 3', + 'ruby' => 'Ruby', + 'ruby3' => 'Ruby 3', + 'rust' => 'Rust', + 'vim' => 'Vim', + } + + def self.from_slug(slug) + Tag.new( + slug: slug, + label: (LABELS[slug] || raise("No label for tag '#{slug}'")), + ) + end + end +end diff --git a/nginx.conf b/nginx.conf index 7b84774..9097f28 100644 --- a/nginx.conf +++ b/nginx.conf @@ -8,6 +8,9 @@ server { error_page 404 /404.html; + # TODO + rewrite ^/$ /posts/ redirect; + rewrite ^/posts/(my-first-post)/?$ /posts/2021-03-05/$1/ permanent; rewrite ^/posts/(phperkaigi-2021)/?$ /posts/2021-03-30/$1/ permanent; rewrite ^/posts/(cpp-you-can-use-keywords-in-attributes)/?$ /posts/2021-10-02/$1/ permanent; diff --git a/nuldoc.rb b/nuldoc.rb new file mode 100644 index 0000000..363383e --- /dev/null +++ b/nuldoc.rb @@ -0,0 +1,24 @@ +require 'date' +require 'fileutils' +require 'asciidoctor' + +require_relative 'lib/command' +require_relative 'lib/parser' +require_relative 'lib/extensions/document_title_processor' +require_relative 'lib/extensions/lang_attribute_processor' +require_relative 'lib/extensions/revision_history_processor' +require_relative 'lib/extensions/section_id_validator' +require_relative 'lib/extensions/source_id_processor' +require_relative 'lib/extensions/source_id_validator' +require_relative 'lib/extensions/tags_processor' +require_relative 'lib/revision' +require_relative 'lib/tag' + +NulDoc::Command.new({ + author: 'nsfisis', + site_name: 'REPL: Rest-Eat-Program Loop', + site_copyright_year: 2021, + content_dir: __dir__ + '/content', + dest_dir: __dir__ + '/public', + template_dir: __dir__ + '/templates', +}).run diff --git a/public/custom.css b/public/custom.css new file mode 100644 index 0000000..d3b1672 --- /dev/null +++ b/public/custom.css @@ -0,0 +1,29 @@ +/* Place a custom css file in your own project to use this. */ +.post-content h1, +.post-content h2, +.post-content h3, +.post-content h4, +.post-content h5, +.post-content h6 { + border-bottom: var(--primary) solid 1px; +} + +.post-content h1::before, +.post-content h2::before, +.post-content h3::before, +.post-content h4::before, +.post-content h5::before, +.post-content h6::before { + color: var(--secondary); + padding-right: 0.3rem; +} + +.post-content h2::before { content: '#'; } +.post-content h3::before { content: '##'; } +.post-content h4::before { content: '###'; } +.post-content h5::before { content: '####'; } +.post-content h6::before { content: '#####'; } + +li.revision { + list-style: inside; +} diff --git a/public/favicon.svg b/public/favicon.svg new file mode 100644 index 0000000..d122ea1 --- /dev/null +++ b/public/favicon.svg @@ -0,0 +1,62 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/public/hl.css b/public/hl.css new file mode 100644 index 0000000..fabe9de --- /dev/null +++ b/public/hl.css @@ -0,0 +1,214 @@ +/* ruby -rrouge -e 'puts Rouge::Themes::Github.render(scope: ".highlight")' */ +.highlight table td { padding: 5px; } +.highlight table pre { margin: 0; } +.highlight .cm { + color: #999988; + font-style: italic; +} +.highlight .cp { + color: #999999; + font-weight: bold; +} +.highlight .c1 { + color: #999988; + font-style: italic; +} +.highlight .cs { + color: #999999; + font-weight: bold; + font-style: italic; +} +.highlight .c, .highlight .ch, .highlight .cd, .highlight .cpf { + color: #999988; + font-style: italic; +} +.highlight .err { + color: #a61717; + background-color: #e3d2d2; +} +.highlight .gd { + color: #000000; + background-color: #ffdddd; +} +.highlight .ge { + color: #000000; + font-style: italic; +} +.highlight .gr { + color: #aa0000; +} +.highlight .gh { + color: #999999; +} +.highlight .gi { + color: #000000; + background-color: #ddffdd; +} +.highlight .go { + color: #888888; +} +.highlight .gp { + color: #555555; +} +.highlight .gs { + font-weight: bold; +} +.highlight .gu { + color: #aaaaaa; +} +.highlight .gt { + color: #aa0000; +} +.highlight .kc { + color: #000000; + font-weight: bold; +} +.highlight .kd { + color: #000000; + font-weight: bold; +} +.highlight .kn { + color: #000000; + font-weight: bold; +} +.highlight .kp { + color: #000000; + font-weight: bold; +} +.highlight .kr { + color: #000000; + font-weight: bold; +} +.highlight .kt { + color: #445588; + font-weight: bold; +} +.highlight .k, .highlight .kv { + color: #000000; + font-weight: bold; +} +.highlight .mf { + color: #009999; +} +.highlight .mh { + color: #009999; +} +.highlight .il { + color: #009999; +} +.highlight .mi { + color: #009999; +} +.highlight .mo { + color: #009999; +} +.highlight .m, .highlight .mb, .highlight .mx { + color: #009999; +} +.highlight .sa { + color: #000000; + font-weight: bold; +} +.highlight .sb { + color: #d14; +} +.highlight .sc { + color: #d14; +} +.highlight .sd { + color: #d14; +} +.highlight .s2 { + color: #d14; +} +.highlight .se { + color: #d14; +} +.highlight .sh { + color: #d14; +} +.highlight .si { + color: #d14; +} +.highlight .sx { + color: #d14; +} +.highlight .sr { + color: #009926; +} +.highlight .s1 { + color: #d14; +} +.highlight .ss { + color: #990073; +} +.highlight .s, .highlight .dl { + color: #d14; +} +.highlight .na { + color: #008080; +} +.highlight .bp { + color: #999999; +} +.highlight .nb { + color: #0086B3; +} +.highlight .nc { + color: #445588; + font-weight: bold; +} +.highlight .no { + color: #008080; +} +.highlight .nd { + color: #3c5d5d; + font-weight: bold; +} +.highlight .ni { + color: #800080; +} +.highlight .ne { + color: #990000; + font-weight: bold; +} +.highlight .nf, .highlight .fm { + color: #990000; + font-weight: bold; +} +.highlight .nl { + color: #990000; + font-weight: bold; +} +.highlight .nn { + color: #555555; +} +.highlight .nt { + color: #000080; +} +.highlight .vc { + color: #008080; +} +.highlight .vg { + color: #008080; +} +.highlight .vi { + color: #008080; +} +.highlight .nv, .highlight .vm { + color: #008080; +} +.highlight .ow { + color: #000000; + font-weight: bold; +} +.highlight .o { + color: #000000; + font-weight: bold; +} +.highlight .w { + color: #bbbbbb; +} +.highlight { + background-color: #f8f8f8; +} \ No newline at end of file diff --git a/public/posts/2021-03-05/my-first-post/index.html b/public/posts/2021-03-05/my-first-post/index.html new file mode 100644 index 0000000..fbf7237 --- /dev/null +++ b/public/posts/2021-03-05/my-first-post/index.html @@ -0,0 +1,71 @@ + + + + + + + + + + + My First Post | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+
+

My First Post

+ +
+
+
+

更新履歴

+
    + +
  1. + : 公開 +
    2. + +
+
+ + + + + +
+

+ + Test + +

+
+
+

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod +tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim +veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea +commodo consequat. Duis aute irure dolor in reprehenderit in voluptate +velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint +occaecat cupidatat non proident, sunt in culpa qui officia deserunt +mollit anim id est laborum.

+
+
+
+
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/public/posts/2021-03-30/phperkaigi-2021/index.html b/public/posts/2021-03-30/phperkaigi-2021/index.html new file mode 100644 index 0000000..46fce9b --- /dev/null +++ b/public/posts/2021-03-30/phperkaigi-2021/index.html @@ -0,0 +1,1195 @@ + + + + + + + + + + + PHPerKaigi 2021 | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+
+

PHPerKaigi 2021

+ + + +
+
+
+

更新履歴

+
    + +
  1. + : 公開 +
    2. + +
+
+ + + + + +
+

+ + PHPerKaigi 2021 参加レポ + +

+
+
+

2021-03-26 から 2021-03-28 +にかけて開催された、 PHPerKaigi 2021 +に一般参加者として参加した。 +弊社 デジタルサーカス株式会社 +(今年1月から勤務) +はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。

+
+
+

このようなカンファレンスには初めて参加するのでかねてより心待ちにしていたのだが、生憎2日目から体調を崩してしまい、この記事も途中までとなっている。まだ見ていないセッションも多いが、ひとまず現時点での参加レポを書いておく。

+
+
+

発表はトラック A、B に分かれていたのだが、今回はすべて A +トラックを視聴している (切り替えるのが面倒だっただけ)。

+
+ + + + + +
+

+ + 凡例 + +

+
+
+
+
+

発表・スライドのメモ (引用ではない)

+
+
+
+
+

感想など

+
+
+
+ + + + + +
+

+ + Day 0 前夜祭 (2021/03/27) + +

+
+ + + + + +
+

+ + 17:30 [A] + +

+
+
+

PHP で AWS Lambda

+
+
+
+
+

Rails のプロジェクトを PHPer のメンバのみでメンテ →他のメンバもわかる +PHP にリプレースを検討

+
+
+
    +
  • +

    サーバレス

    +
    • +
  • +

    サーバ・インフラの管理が不要

    +
    • +
  • +

    アプリケーションコードの知識だけで保守可能

    +
    • +
+
+
+

ゼロベースで作れる案件が (Railsの件とは別に) +あるため、そちらで試験的に導入?

+
+
+

AWSの学習 AWS のドキュメント DevelopersIO

+
+
+

AWS Lambda のカスタムランタイムで PHP を動かす

+
+
+

サーバのセットアップや維持管理を気にしなくて良い サーバーレスで PHP +を動かすツールがすでにある サーバーレス構築はすんなり

+
+
+

今は Laravel がルーティングしている Laravel Livewire を Lambda +に載せられないか？ デプロイ方法は？ バッチ処理は？ (Lambda は +15分の制限)

+
+
+

Lambda でコンテナイメージがサポートされるように

+
+
+

抽象化されたもの「だけ」しか知らないよりも具象の理解は助けになる

+
+
+
+
+

AWS Lambda のような Function as a Service +はマイクロサービス化における一つの到達点に思えるのだが、これを使って実際に +web サービスを作る具体的なイメージがまだ見えない (注: すべて for me +として書いている)。

+
+
+

PHP on AWS Lambda があれだけ簡単に動かせるのには驚いた。

+
+
+

勝手に AWS Lambda だとフットプリントの軽さが求められそう (= PHP
+Laravel などでは動かなさそう) +だという先入観を持っていたのだが、この発表のデモによればそうでもないらしい。

+
+
+
+ + + + + +
+

+ + 18:10 [A] + +

+
+
+

大規模サイトの SEO

+
+
+
+
+

大規模サイト (100万ページ以上) Google の基準

+
+
+

クロールバジェットを意識したSEO

+
+
+

大規模サイトでコンテンツが中頻度 (1回/週) で更新 OR 中規模サイト +(10,000以上) でコンテンツが目まぐるしく変更される +これを満たさないなら、クロールバジェットを考えなくてもいい

+
+
+

サーチコンソール 「カバレッジ」の「除外」 +多すぎるのは問題→クロールバジェットを浪費している

+
+
+
    +
  • +

    クエリの順番を決める

    +
    • +
  • +

    空の値のルールを決めておく

    +
    • +
  • +

    リダイレクトすればインデックスはうまくいく

    +
    • +
  • +

    リンクが存在する限りクロールはされる

    +
    • +
+
+
+

リニューアル前のURL

+
+
+

インデックスは移行される +リンクのURLが存在する限り、別のURLとしてクロールされる +リダイレクトされるとはいえ、リニューアル前のURLは移行した方が良い +リニューアルで無視されるようになったパラメータも注意

+
+
+

robotes.txt で拒否しているのにクロールされる 一時的に拒否を外して 404 や +301 を読ませる 内部リンクを確認する JS でのリンクに書き換え

+
+
+

クエリパラメータからURLのパスに /tokyo?area=HOGE → /tokyo/HOGE

+
+
+

URL 設計だいじ

+
+
+
+
+

SEO (Search Engine Optimization) +は大して知らないので新鮮な話が多かった。その分語れることも少ない……。

+
+
+
+ + + + + +
+

+ + 18:50 [A] + +

+
+
+
+
+

知覚可能 操作可能 理解可能 堅牢 ちゃんとしたHTMLを書く +(閉じタグ・入れ子構造など)

+
+
+
    +
  • +

    標準の HTML を適切に使う

    +
    • +
  • +

    WAI-ARIA

    +
    • +
  • +

    キーボードフレンドリー

    +
    • +
  • +

    マシンフレンドリー

    +
    • +
  • +

    SEOフレンドリー

    +
    • +
+
+
+

button タグ →キーボード h1 タグ →スクリーンリーダー・クローラ a タグ

+
+
+

WAI-ARIA HTML では表現できないセマンティクスを追加する

+
+
+
    +
  • +

    ロール

    +
    +
      +
    • +

      何をするのか？

      +
      • +
    • +

      ユーザーアクションによって変化しない

      +
      • +
    +
    +
    • +
  • +

    プロパティ

    +
    +
      +
    • +

      関連づけられたデータ

      +
      • +
    +
    +
    • +
  • +

    ステート

    +
    +
      +
    • +

      現在の状態

      +
      • +
    +
    +
    • +
+
+
+

まずは標準の HTML 要素で解決する 何でもかんでも WAI-ARIA +を使えばいいというものではない

+
+
+

マウスホバーでツールチップが出てくるが、キーボード操作では出てこない

+
+
+

VoiceOver

+
+
+

全ての属性を使う必要はない +あくまでアクセシビリティを上げるための方法の一つにすぎない

+
+
+
+
+

つい最近 WAI-ARIA +についての記事を読んだばかりだったので個人的にタイムリーな話題だった。(あまりこの言葉を使いたくないのだが) +いわゆる「健常者」にとって、こうした問題を普段の生活の中で意識するのは難しい。だからこそ情報へのアンテナは張っておくようにしたい。

+
+
+
+ + + + + +
+

+ + 19:30 [A] + +

+
+
+

PHP で FUSE

+
+
+

個人的に楽しみだった発表。

+
+
+
+
+

VFS (virtual filesystem) vs 具体的なファイルシステム

+
+
+

最適な実装方法は状況により異なる

+
+
+

アプリケーションに見せるAPIは変えずに実装を隠蔽する→VFS

+
+
+

カーネルのプログラムを作るのは難しい +* 権限がデカすぎる +* システム全体がクラッシュ +* セキュリティリスク +* 開発サイクルを回しづらい +* ネイティブコードにコンパイルされる言語である必要がある

+
+
+

Filesystem in USEr space (FUSE)

+
+
+
    +
  • +

    特定の C の関数を呼ぶことで filesystem が作れる

    +
    • +
  • +

    FFI を持つ言語なら FUSE が使える

    +
    • +
+
+
+

SSHFS / s3fs / Docker Desktop

+
+
+

Linux 以外でも使える

+
+
+
    +
  • +

    dokany (on Windows)

    +
    • +
  • +

    osxfuse

    +
    • +
+
+
+

VFS: システムコールが呼ばれると、ファイルシステムによってコール FUSE: +カーネル空間からユーザ空間へ通信

+
+
+

高レベルなラッパで型をつける

+
+
+

PHP 以外では Wordpress を FUSE にマウントする実装がある (C, Python など)

+
+
+
    +
  • +

    grep できる

    +
    • +
  • +

    sed できる

    +
    • +
  • +

    編集できる

    +
    • +
+
+
+
+
+

期待通りの興味深い発表だった。FUSE +自体も今回の発表で知ったのだが、これ本体の実装を見るのも面白そうだ。 +この発表を聞きながらファイルシステムにマウントできそうなものを考えていたのだが、およそ木構造をしているものすべてと言えそうだ +(ハンマーしか持っていないと云々)。何かできそうだがなかなか思いつかない。

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

+ + Day 1 (2021/03/27) + +

+
+ + + + + +
+

+ + 10:50 [A] + +

+
+
+

ATDD

+
+
+
+
+
    +
  • +

    ユーザーストーリー

    +
    • +
  • +

    ユニットテスト

    +
    • +
  • +

    CI/CD

    +
    • +
+
+
+

ユーザストーリーの受け入れ条件が曖昧になりがち +デグレチェックがユニットレベルでは収まらない場合、手動で同じシナリオをテストしている

+
+
+

Q2の強化 アジャイルテストの4象限

+
+
+

技術面/ビジネス面 +開発チーム支援(コーディング前・コーディング中)/製品批評(コーディング後)

+
+
+
    +
  • +

    Q1: 技術面 & チーム支援

    +
    +
      +
    • +

      TDD

      +
      • +
    • +

      ユニットテストなど

      +
      • +
    +
    +
    • +
  • +

    Q2: ビジネス面 & チーム支援

    +
    +
      +
    • +

      ATDD

      +
      • +
    • +

      ビジネス面の受け入れテストで駆動する

      +
      • +
    +
    +
    • +
+
+
+

Agile Alliance ユーザストーリーのスキルレベルを高める

+
+
+

テストピラミッド

+
+
+
    +
  • +

    UI Tests

    +
    • +
  • +

    Service Tests

    +
    • +
  • +

    Unit Tests

    +
    • +
  • +

    異なる粒度のテストを書く

    +
    • +
  • +

    高レベルになるほど、持つべきテストは少なくなる

    +
    +
      +
    • +

      ピラミッド型になる

      +
      • +
    +
    +
    • +
+
+
+

高レベルテストが多すぎる→アイスクリームコーン　アンチパターン

+
+
+

ATDD (Acceptance TDD) API経由・UI経由での高レベルテスト E2E test

+
+
+

ストーリ受け入れテスト

+
+
+

入れ子のフィードバックループ ATDD(外側) と TDD(内側)

+
+
+

外部品質・内部品質

+
+
+

バーティカルスライスのデリバリー

+
+
+
    +
  • +

    cucumber

    +
    • +
  • +

    gauge

    +
    • +
  • +

    behat

    +
    • +
+
+
+

ユビキタス言語 手動テストもspecに書く 自動化は可能だがコスパが悪い +失敗することがわかっているテスト(レッドテスト)はCIから外す +失敗時の原因究明が難しい 饒舌なエラーメッセージ 状況のスナップショット

+
+
+

Continuous Testing

+
+
+
+
+

User Acceptance Test (UAT) +くらいの規模になると個人開発・趣味開発では触れない領域なので、大いに勉強になった。スライドに添付されている資料が相当に充実していたので、これを読むのが本番といった様相すら感じる。 +高レベルテストの自動化は現在のプロジェクトでも感じており、自動化のチャンスは伺っている。とはいえセッションでも指摘されているように自動化することにコストがかかりすぎる領域があるのも事実で、そのバランスが難しい。

+
+
+
+ + + + + +
+

+ + 11:50 [A] + +

+
+
+

型解析を用いたリファクタリング

+
+
+

型のある世界で生きてきた身として大いに楽しみにしていた発表。

+
+
+
+
+
    +
  • +

    PHPStan

    +
    • +
  • +

    Phan

    +
    • +
  • +

    Psalm

    +
    • +
+
+
+

autoload も認識できる bootstrapFiles

+
+
+

編集箇所と利用箇所を CI でチェック ルールレベルを徐々に引き上げていく +警告が多すぎると見落としてしまう・無視されやすくなる

+
+
+

型がついていないことによるエラーが多い

+
+
+

型よりも詳細な検査 Util_Assert::min

+
+
+

SQL を静的解析 placeholder の型付け

+
+
+

警告レベルを低いレベルから導入 タイプヒントを積極的に書いていく PHPStan +の拡張を追加する

+
+
+
+
+

昨今、動的型付き言語での型宣言・型アノテーション・型ヒントの導入が相次いでいる。長らく静的型付き言語を書いてきた私からすると、ようやく気づいたかといったところだが、ともかく型を導入する言語が増えてきた。 +今のプロジェクトでも新しく追加するコードには型をつけるよう努めているが、どうしても古いコードには型がついていない。個人的には型のないコードに対してどう型を自動的に付けるかという点に興味があり、その点で +Ruby の typeprof には注目している。

+
+
+
+ + + + + +
+

+ + 12:30 [A] + +

+
+
+

昼食をとっていた。事前に何か食料を買っておくべきだった。

+
+
+
+ + + + + +
+

+ + 13:10 [A] + +

+
+
+

Documentation as Code

+
+
+

この発表も以前から非常に楽しみにしていた。

+
+
+
+
+

開発開始までのオーバーヘッド 新規にチームにジョイン +担当範囲外の機能を理解 オンボーディングのコスト

+
+
+

PHPerKaigi 2020 で発表あり

+
+
+

継続的にシステムの理解を助けるドキュメント

+
+
+

継続的ドキュメンテーション システムとドキュメントの乖離

+
+
+

書いてあることが間違っている・足りない * 徐々にずれていく * +システムの更新タイミングとドキュメントの更新タイミングに差がある

+
+
+

システムとドキュメントは対応関係がある * 間違ったドキュメント * +存在しないドキュメント

+
+
+

システムとドキュメントの乖離を定量化する 継続的に +システムの更新に近いタイミングで ドキュメントを更新し続ける

+
+
+

Documentation as Code

+
+
+

コードと同じツールでドキュメントを書く * issue tracker * vcs * plain +text markup * automation

+
+
+

開発者 システム ドキュメント 構造化データ ソフトウェア

+
+
+

システムから構造化データを抽出する PHPDoc OpenAPI

+
+
+

ビュー 関心ごとに合わせてアーキテクチャを一つ以上の側面(断面)で説明する

+
+
+

ビューの単位でドキュメントに

+
+
+

スタックトレースからのドキュメント生成

+
+
+
+
+

ドキュメントの管理は現プロジェクトでも課題と感じている。作られた当初は正しくても、実態と乖離していくのを止めるのは困難を極める。全体的に興味深い発表だったが、特にスタックトレースからのドキュメント生成というアイデアに惹かれるものを感じた。スタックトレースという実態と不可分な +(乖離しない) +情報を起点にするのは理にかなっている。問題はトレースをいつ、どう取るかだろうか。それを自動化しなければ、実態との乖離が避けられないだろう。

+
+
+
+ + + + + +
+

+ + 14:10 [A] + +

+
+
+

cookie による session 管理

+
+
+

全体的に基本的な話だったので特に触れない。Cookie +やセッションの話としては非常に分かりやすくまとめられていたので、知らない人が学ぶにはいい教材だろう。

+
+
+
+ + + + + +
+

+ + 14:50 [A] + +

+
+
+

PHP のエラーと例外

+
+
+
+
+

エラー PHPエンジンがエラーを通知する 例外 プログラムが投げる

+
+
+

PHP7-8とエラー

+
+
+

PHPエンジンのエラーの一部が に変換されるようになった → try-catch +で捕捉できる

+
+
+

は例外とは異なる

+
+
+

PHP8 でエラーレベルの引き上げ

+
+
+
    +
  • +

    捕捉すべきもの

    +
    +
      +
    • +

      recoverable

      +
      • +
    +
    +
    • +
  • +

    捕捉すべきでないもの

    +
    +
      +
    • +

      unrecoverable

      +
      • +
    • +

      開発時に対処できるもの

      +
      • +
    +
    +
    • +
+
+
+

例外 * 捕捉して事後処理 * 捕捉せず(or 捕捉した上で)さらに上に是非を問う

+
+
+

開発段階で例外を把握し、ハンドリングを考えておく

+
+
+

と

+
+
+

はキャッチすべきでない

+
+
+
    +
  • +

    +
    +
      +
    • +

      本番で起きてはいけない

      +
      • +
    +
    +
    • +
  • +

    +
    +
      +
    • +

      本番で起きてはいけない →生じないのだから捕捉もしない

      +
      • +
    +
    +
    • +
  • +

    +
    +
      +
    • +

      起こるかもしれないので本番環境でも考慮する

      +
      • +
    +
    +
    • +
+
+
+

捕捉して対応するのではなく、未然に防ぐ

+
+
+

独自例外を使う を投げてしまうと、 catch ()せざるを得ない →catch +範囲が広すぎる

+
+
+

SPL の例外を使う

+
+
+

例外翻訳 +上位のレイヤが下位のレイヤの例外を捕捉し、上位レイヤのAPIに「翻訳」する +下位レイヤの知識に依存させない

+
+
+

@throws 捕捉してほしい例外を書き連ねておく

+
+
+

呼び出しもとに負わせたい責任

+
+
+
+
+

PHP を学んでいる途中の私としては、今まさに聞きたい発表だった (現時点で +PHP を書き始めてから 4ヶ月ほどになる)。

+
+
+

個人的に例外やエラーを最もうまく扱っているのは Go、Swift、Rust、Haskell +などのエラーを「値として」扱う言語だと思っている。try-catch +は通常の処理フローを完全に壊してしまう上、構文としても重すぎる。値としてのエラー通知は +C言語時代への回帰ともいえるが、その頃と異なるのはエラーを暗黙のうちに握り潰すことがないということだ。これらの言語は型を持っており、静的に検証ができる +(C のそれはまともな型付けではない。念のため)。

+
+
+

PHP +のように、すでに例外が言語システムに根ざしている言語ではどうすればよいか。この場合も同じく静的検証の力を借りることになるだろう。

+
+
+
+ + + + + +
+

+ + 15:30 [A] + +

+
+
+

Laravel のメール認証

+
+
+

Laravel +の知識がない私にはまったくついていけなかった。また、個人的にタイトルがややミスリーディングに感じた。

+
+
+
+ + + + + +
+

+ + 16:10 [A] + +

+
+
+

gRPC

+
+
+
+
+

Unary RPCs Server streaming RPCs Client streaming RPCs Bidirectional +streaming RPCs

+
+
+

Protobuf

+
+
+

実装とAPIが乖離しにくい 自動生成 複数言語でも相互に使える

+
+
+

マイクロサービスのサービス通信 スマホアプリ ゲームサーバ

+
+
+

PHP では？

+
+
+

PHP ではストリーミングが難しい リクエストごとにプロセスが使い捨て

+
+
+

PHP ではgRPCのクライアントしか対応していない

+
+
+

gRPC-Web ブラウザで扱うためのJSライブラリ+プロトコル

+
+
+

HTTP/1.1 でも使える Unary RPC と Server streaming RPC のみ

+
+
+

Envoy Nginx などで相互に gRPC と gRPC-Web で変換

+
+
+

Amp イベント駆動な並行処理のフレームワーク

+
+
+

HTTP/2 対応

+
+
+

C#のgRPC-Webが楽

+
+
+
+
+

(発表の中でもまさに同じことをおっしゃっていたが) PHP +以外の方が向いているだろう、というのが第一の感想である。gRPC +はそれ自体というよりも Protobuf +というエコシステムに乗れることのメリットが大きいと感じる。そのエコシステムにうまく乗れない時点で、うーんという感じ。

+
+
+
+ + + + + +
+

+ + 16:50 [A] + +

+
+
+

アーキテクチャテスト

+
+
+
+
+

Independent Core Layer Pattern

+
+
+

開発初期のアーキテクチャが崩れる +アーキテクチャ観点のコードレビューができない

+
+
+

どこにクラスを置けばよいか？ ドキュメントがない

+
+
+

アーキテクチャ設計に関する知識が属人化・暗黙知化

+
+
+

ガイドライン * 最初にルールを決めるのは簡単 * +ルール通り作り始めるのも簡単 * +→維持するのが難しい、人が決めたものゆえ壊れやすい

+
+
+

PHP の特性 * クラスは public * 可視性の制御が public / protected / +private のみ * 依存関係の制御が困難

+
+
+

アーキテクチャテスト +クラスの依存関係や実装ルールをコードとして表現し、自動テスト化する

+
+
+
    +
  • +

    deptrac

    +
    • +
  • +

    phpat

    +
    • +
+
+
+

Independent Core Layer Pattern

+
+
+

アーキテクチャテストの失敗 * 実装誤り * or アーキテクチャが適切でない * +開発の過程でフィードバックしていく

+
+
+

モジュラーモノリス→マイクロサービスへ

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

+ + Day 2 (2021/03/28) + +

+
+
+

冒頭に書いた通り、2日目から体調が悪くまともに聴けていない。途中までは頭痛を我慢しつつ見ていたのだが、まともに入ってこなかった。

+
+
+

残念ではあるが、いずれにせよ見られていない発表は他にもあるので、今週末にでもまとめて見ようと思う。

+
+
+
+ + + + + +
+

+ + 全体の感想 + +

+
+
+

Day 2 +にほとんど参加できなかったのは残念だが、イベント自体は大変楽しく、また興味深いものであった。自分がまったく知らない領域の話を聞けるのはこうしたイベントならではだと感じる。オンライン開催ゆえ現地に行く必要がなく、気軽に参加できたのも +(特に初参加者として) 嬉しいポイントだった。

+
+
+

今回、雑談/登壇者への質問等向けに Discord +サーバもあったのだが、こちらは参加こそしたものの ROM +のままになってしまった。発表に1ウィンドウ、メモを書くのに1ウィンドウ、Discord +表示に +1ウィンドウで私にはもう脳のリソースとディスプレイのスペースが追いつかなかった +(さらにいうと Zoom +でアンカンファレンスもやっていたようだ。こちらはまったく参加していない)。

+
+
+

1つ個人的な反省点としては、一つ一つのセッションを真剣に聞き過ぎたというものがある。もっと適当に聞いておけばよかった。これだけだと大変語弊があるのだが、言い方を変えると、Discord +しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。 +まあ初カンファレンスだし、とお茶を濁しておこう。

+
+
+

さて、カンファレンスで一つ気になったことがある。それは、Discord +という書き込み場所が増えたことでニコ生のコメントの流量が吸い取られてしまったのではないか、という点だ。ニコニコだけ見ていると過疎っているかのように見えた発表も、Discord +の方では盛り上がっている、というのを何度か見かけた。ニコニコのコメント方式は盛り上がりを如実に反映するが、逆もまたしかり。Discord +があったこと自体はプラスだったと思うが、この点はマイナスだったのではないかと感じる。

+
+
+
+

最後になりましたが、毎年の PHPerKaigi +開催にご尽力されている皆様、スピーカーの皆様、楽しい3日間でした。ありがとうございました！ +(ずっと常体で書いてしまったのでいきなり仏頂面から笑顔になったようで気持ち悪い)

+
+
+

ではまた来年。

+
+
+
+
+
+
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/public/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes/index.html b/public/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes/index.html new file mode 100644 index 0000000..16a8188 --- /dev/null +++ b/public/posts/2021-10-02/cpp-you-can-use-keywords-in-attributes/index.html @@ -0,0 +1,209 @@ + + + + + + + + + + + 【C++】属性構文の属性名にはキーワードが使える | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+
+

【C++】属性構文の属性名にはキーワードが使える

+ + + +
+
+
+

更新履歴

+
    + +
  1. + : Qiita から移植 +
    2. + +
+
+
+

この記事は Qiita から移植してきたものです。 元 URL: +https://qiita.com/nsfisis/items/94090937bcf860cfa93b

+
+
+
+

タイトル落ち。まずはこのコードを見て欲しい。

+
+
+
+
#include <iostream>
+
+[[alignas]] [[alignof]] [[and]] [[and_eq]] [[asm]] [[auto]] [[bitand]]
+[[bitor]] [[bool]] [[break]] [[case]] [[catch]] [[char]] [[char16_t]]
+[[char32_t]] [[class]] [[compl]] [[const]] [[const_cast]] [[constexpr]]
+[[continue]] [[decltype]] [[default]] [[delete]] [[do]] [[double]]
+[[dynamic_cast]] [[else]] [[enum]] [[explicit]] [[export]] [[extern]] [[false]]
+[[final]] [[float]] [[for]] [[friend]] [[goto]] [[if]] [[inline]] [[int]]
+[[long]] [[mutable]] [[namespace]] [[new]] [[noexcept]] [[not]] [[not_eq]]
+[[nullptr]] [[operator]] [[or]] [[or_eq]] [[override]] [[private]]
+[[protected]] [[public]] [[register]] [[reinterpret_cast]] [[return]] [[short]]
+[[signed]] [[sizeof]] [[static]] [[static_assert]] [[static_cast]] [[struct]]
+[[switch]] [[template]] [[this]] [[thread_local]] [[throw]] [[true]] [[try]]
+[[typedef]] [[typeid]] [[typename]] [[union]] [[unsigned]]
+[[virtual]] [[void]] [[volatile]] [[wchar_t]] [[while]] [[xor]] [[xor_eq]]
+// [[using]]
+int main() {
+    std::cout << "Hello, World!" << std::endl;
+}
+
+
+
+
+
+

コンパイラのバージョン $ clang++ –version Apple clang version 11.0.0 +(clang-1100.0.33.8) Target: x86_64-apple-darwin19.6.0 Thread model: +posix InstalledDir: +/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin

+
+
+

コンパイルコマンド (C17指定) $ clang –std=c++17 hoge.cpp

+
+
+
+
+

この記事から得られるものはこれ以上ないので以下は蛇足になる。

+
+
+

別件で cppreference.com の +identifier +のページ を読んでいた時、次の文が目に止まった。

+
+
+
+
+
    +
  • +

    the identifiers that are keywords cannot be used for other purposes;

    +
    +
      +
    • +

      The only place they can be used as non-keywords is in an +attribute-token. (e.g.  is a valid attribute) (since C++11)

      +
      • +
    +
    +
    • +
+
+
+
+
+

キーワードでも属性として指定する場合は非キーワードとして使えるらしい。 +実際にやってみる。

+
+
+

同サイトの keywords のページ +から一覧を拝借し、上のコードが出来上がった (C++17 +においてキーワードでないものなど、一部省いている)。 大量の警告 (unknown +attribute `〇〇' ignored) +がコンパイラから出力されるが、コンパイルできる。

+
+
+

上のコードでは をコメントアウトしているが、これは using +キーワードのみ属性構文の中で意味を持つからであり、このコメントアウトを外すとコンパイルに失敗する。

+
+
+
+
// using の例
+[[using foo: attr1, attr2]] int x; // [[foo::attr1, foo::attr2]] の糖衣構文
+
+
+
+

C++17 の仕様も見てみる (正確には標準化前のドラフト)。

+
+
+

引用元: https://timsong-cpp.github.io/cppwp/n4659/dcl.attr#grammar-4

+
+
+
+
+

If a keyword or an alternative token that satisfies the syntactic +requirements of an identifier is contained in an attribute-token, it is +considered an identifier.

+
+
+
+
+

「identifier の構文上の要件を満たすキーワードまたは代替トークンが +attribute-token に含まれている場合、identifier +とみなされる」とある。どうやら間違いないようだ。

+
+
+

ところで、代替トークン (alternative token) とは and (&) や bitor +(|) などのことだが、identifier +の構文上の要件を満たさないような代替トークンなどあるのか？ +疑問に思って調べたところ、代替トークンという語にはダイグラフも含まれるらしい +(参考: +同ドラフト)

+
+
+
    +
  • +

    <% → {

    +
    • +
  • +

    %> → }

    +
    • +
  • +

    <: → [

    +
    • +
  • +

    :> → ]

    +
    • +
  • +

    %: → #

    +
    • +
  • +

    %:%: → ##

    +
    • +
+
+
+

「identifier +の構文上の要件を満たさないような代替トークン」はこれらが当てはまると思われる。

+
+
+

調べた感想: 字句解析器か構文解析器が辛そう

+
+
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/public/posts/2021-10-02/python-unbound-local-error/index.html b/public/posts/2021-10-02/python-unbound-local-error/index.html new file mode 100644 index 0000000..20e1e0e --- /dev/null +++ b/public/posts/2021-10-02/python-unbound-local-error/index.html @@ -0,0 +1,131 @@ + + + + + + + + + + + 【Python】クロージャとUnboundLocalError: local variable 'x' referenced before assignment | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+
+

【Python】クロージャとUnboundLocalError: local variable 'x' referenced before assignment

+ + + +
+
+
+

更新履歴

+
    + +
  1. + : Qiita から移植 +
    2. + +
+
+
+

この記事は Qiita から移植してきたものです。 元 URL: +https://qiita.com/nsfisis/items/5d733703afcb35bbf399

+
+
+
+

本記事は Python 3.7.6 の動作結果を元にして書かれている。

+
+
+

Python でクロージャを作ろうと、次のようなコードを書いた。

+
+
+
+
def f():
+    x = 0
+    def g():
+        x += 1
+    g()
+
+f()
+
+
+
+

関数 g から 関数 f のスコープ内で定義された変数 x を参照し、それに +1 を足そうとしている。 これを実行すると x += 1 +の箇所でエラーが発生する。

+
+
+
+
+

UnboundLocalError: local variable `x' referenced before assignment

+
+
+
+
+

local変数 x が代入前に参照された、とある。これは、f の x +を参照するのではなく、新しく別の変数を g 内に作ってしまっているため。 +前述のコードを宣言と代入を便宜上分けて書き直すと次のようになる。var +を変数宣言のための構文として擬似的に利用している。

+
+
+
+
# 注: var は正しい Python の文法ではない。上記参照のこと
+def f():
+    var x           #  f の local変数 'x' を宣言
+    x = 0           #  x に 0 を代入
+    def g():        #  f の内部関数 g を定義
+        var x       #  g の local変数 'x' を宣言
+                    #  たまたま f にも同じ名前の変数があるが、それとは別の変数
+        x += 1      #  x に 1 を加算 (x = x + 1 の糖衣構文)
+                    #  加算する前の値を参照しようとするが、まだ代入されていないためエラー
+    g()
+
+
+
+

当初の意図を表現するには、次のように書けばよい。

+
+
+
+
def f():
+    x = 0
+    def g():
+        nonlocal x   ## (*)
+        x += 1
+    g()
+
+
+
+

(*) のように、nonlocal を追加する。これにより一つ外側のスコープ (g +の一つ外側 = f) で定義されている x を探しに行くようになる。

+
+
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/public/posts/2021-10-02/ruby-detect-running-implementation/index.html b/public/posts/2021-10-02/ruby-detect-running-implementation/index.html new file mode 100644 index 0000000..6fe62d7 --- /dev/null +++ b/public/posts/2021-10-02/ruby-detect-running-implementation/index.html @@ -0,0 +1,167 @@ + + + + + + + + + + + 【Ruby】自身を実行している処理系の種類を判定する | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+
+

【Ruby】自身を実行している処理系の種類を判定する

+ + + +
+
+
+

更新履歴

+
    + +
  1. + : Qiita から移植 +
    2. + +
+
+
+

この記事は Qiita から移植してきたものです。 元 URL: +https://qiita.com/nsfisis/items/74d7ffeeebc51b20d791

+
+
+
+

Ruby +という言語には複数の実装があるが、それらをスクリプト上からどのようにして +programmatically に見分ければよいだろうか。

+
+
+

Object クラスに定義されている RUBY_ENGINE +という定数がこの用途に使える。

+
+
+

参考: +Object::RUBY_ENGINE

+
+
+

上記ページの例から引用する:

+
+
+
+
$ ruby-1.9.1 -ve 'p RUBY_ENGINE'
+ruby 1.9.1p0 (2009-03-04 revision 22762) [x86_64-linux]
+"ruby"
+$ jruby -ve 'p RUBY_ENGINE'
+jruby 1.2.0 (ruby 1.8.6 patchlevel 287) (2009-03-16 rev 9419) [i386-java]
+"jruby"
+
+
+
+

それぞれの処理系がどのような値を返すかだが、stack overflow +に良い質問と回答があった。

+
+
+

What values for RUBY_ENGINE +correspond to which Ruby implementations? より引用:

+
+
+
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
RUBY_ENGINEImplementation

<undefined>

MRI < 1.9

`ruby'

MRI >= 1.9 or REE

`jruby'

JRuby

`macruby'

MacRuby

`rbx'

Rubinius

`maglev'

MagLev

`ironruby'

IronRuby

`cardinal'

Cardinal

+
+
+
+

なお、この質問・回答は +2014年になされたものであり、値は変わっている可能性がある。MRI (aka +CRuby) については執筆時現在 (2020/12/8) も 'ruby' +が返ってくることを確認済み。

+
+
+

この表にない主要な処理系として、https://mruby.org[mruby] は 'mruby' +を返す。

+
+
+

mruby +該当部分のソース より引用:

+
+
+
+
/*
+ * Ruby engine.
+ */
+#define MRUBY_RUBY_ENGINE  "mruby"
+
+
+
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/public/posts/2021-10-02/ruby-then-keyword-and-case-in/index.html b/public/posts/2021-10-02/ruby-then-keyword-and-case-in/index.html new file mode 100644 index 0000000..7ddf636 --- /dev/null +++ b/public/posts/2021-10-02/ruby-then-keyword-and-case-in/index.html @@ -0,0 +1,392 @@ + + + + + + + + + + + 【Ruby】then キーワードと case in | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+
+

【Ruby】then キーワードと case in

+ + + +
+
+
+

更新履歴

+
    + +
  1. + : Qiita から移植 +
    2. + +
+
+
+
+
+

この記事は Qiita から移植してきたものです。 元 URL: +https://qiita.com/nsfisis/items/787a8cf888a304497223

+
+
+
+
+ + + + + +
+

+ + TL; DR + +

+
+
+

case - in によるパターンマッチング構文でも、case - when +と同じように then が使える (場合によっては使う必要がある)。

+
+
+
+ + + + + +
+

+ + then とは + +

+
+
+

使われることは稀だが、Ruby では then +がキーワードになっている。次のように使う:

+
+
+
+
if cond then
+  puts "Y"
+else
+  puts "N"
+end
+
+
+
+

このキーワードが現れうる場所はいくつかあり、if、unless、rescue、case +構文がそれに当たる。 上記のように、何か条件を書いた後 then +を置き、式がそこで終了していることを示すマーカーとして機能する。

+
+
+
+
# Example:
+
+if x then
+  a
+end
+
+unless x then
+  a
+end
+
+begin
+  a
+rescue then
+  b
+end
+
+case x
+when p then
+  a
+end
+
+
+
+
+ + + + + +
+

+ + なぜ普段は書かなくてもよいのか + +

+
+
+

普通 Ruby のコードで then +を書くことはない。なぜか。次のコードを実行してみるとわかる。

+
+
+
+
if true puts 'Hello, World!' end
+
+
+
+

次のような構文エラーが出力される。

+
+
+
+
20:1: syntax error, unexpected local variable or method, expecting `then' or ';' or '\n'
+if true puts 'Hello, World!' end
+        ^~~~
+20:1: syntax error, unexpected `end', expecting end-of-input
+...f true puts 'Hello, World!' end
+
+
+
+

二つ目のメッセージは無視して一つ目を読むと、then か ; +か改行が来るはずのところ変数だかメソッドだかが現れたことによりエラーとなっているようだ。

+
+
+

ポイントは改行が then (や ;) の代わりとなることである。true +の後に改行を入れてみる。

+
+
+
+
if true
+puts 'Hello, World!' end
+
+
+
+

無事 Hello, World! と出力されるようになった。

+
+
+
+ + + + + +
+

+ + なぜ then や ; や改行が必要か + +

+
+
+

なぜ then や ; や改行 (以下 「then 等」) +が必要なのだろうか。次の例を見てほしい:

+
+
+
+
if a b end
+
+
+
+

then も ; +も改行もないのでエラーになるが、これは条件式がどこまで続いているのかわからないためだ。 +この例は二通りに解釈できる。

+
+
+
+
# a という変数かメソッドの評価結果が truthy なら b という変数かメソッドを評価
+if a then
+  b
+end
+
+
+
+
+
# a というメソッドに b という変数かメソッドの評価結果を渡して呼び出し、
+# その結果が truthy なら何もしない
+if a(b) then
+end
+
+
+
+

then 等はこの曖昧性を排除するためにあり、条件式は if から then +等までの間にある、ということを明確にする。 C系の if 後に来る (/) +や、Python の :、Rust/Go/Swift などの { も同じ役割を持つ。

+
+
+

Ruby の場合、プログラマーが書きやすいよう改行でもって then +が代用できるので、ほとんどの場合 then は必要ない。

+
+
+
+ + + + + +
+

+ + case - in における then + +

+
+
+

ようやく本題にたどり着いた。来る Ruby 3.0 では case と in +キーワードを使ったパターンマッチングの構文が入る予定である。この構文でもパターン部との区切りとして +then 等が必要になる。 (現在の) Ruby には formal +な形式での文法仕様は存在しないので、yacc の定義ファイルを参照した (yacc +の説明は省略)。

+
+
+

https://github.com/ruby/ruby/blob/221ca0f8281d39f0dfdfe13b2448875384bbf735/parse.y#L3961-L3986

+
+
+
+
p_case_body : keyword_in
+            {
+            SET_LEX_STATE(EXPR_BEG|EXPR_LABEL);
+            p->command_start = FALSE;
+            $<ctxt>1 = p->ctxt;
+            p->ctxt.in_kwarg = 1;
+            $<tbl>$ = push_pvtbl(p);
+            }
+            {
+            $<tbl>$ = push_pktbl(p);
+            }
+          p_top_expr then
+            {
+            pop_pktbl(p, $<tbl>3);
+            pop_pvtbl(p, $<tbl>2);
+            p->ctxt.in_kwarg = $<ctxt>1.in_kwarg;
+            }
+          compstmt
+          p_cases
+            {
+            /*%%%*/
+            $$ = NEW_IN($4, $7, $8, &@$);
+            /*% %*/
+            /*% ripper: in!($4, $7, escape_Qundef($8)) %*/
+            }
+        ;
+
+
+
+

簡略版:

+
+
+
+
p_case_body : keyword_in p_top_expr then compstmt p_cases
+        ;
+
+
+
+

ここで、keyword_in は文字通り in、p_top_expr +はいわゆるパターン、then は then +キーワードのことではなく、この記事で then 等と呼んでいるもの、つまり +then キーワード、;、改行のいずれかである。

+
+
+

これにより、case - when による従来の構文と同じように、then +等をパターンの後ろに挿入すればよいことがわかった。つまり次の3通りのいずれかになる:

+
+
+
+
case x
+in 1 then a
+in 2 then b
+in 3 then c
+end
+
+case x
+in 1
+  a
+in 2
+  b
+in 3
+  c
+end
+
+case x
+in 1; a
+in 2; b
+in 3; c
+end
+
+
+
+

ところで、p_top_expr には if による guard clause +が書けるので、その場合は if - then と似たような見た目になる。

+
+
+
+
case x
+in 0 then a
+in n if n < 0 then b
+in n then c
+end
+
+
+
+
+ + + + + +
+

+ + まとめ + +

+
+
+
    +
  • +

    if や case の条件の後ろには then、;、改行のいずれかが必要

    +
    +
      +
    • +

      通常は改行しておけばよい

      +
      • +
    +
    +
    • +
  • +

    3.0 で入る予定の case - in でも then 等が必要になる

    +
    • +
  • +

    Ruby の構文を正確に知るには (現状) parse.y を直接読めばよい

    +
    • +
+
+
+
+
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/public/posts/2021-10-02/rust-where-are-primitive-types-from/index.html b/public/posts/2021-10-02/rust-where-are-primitive-types-from/index.html new file mode 100644 index 0000000..27f2632 --- /dev/null +++ b/public/posts/2021-10-02/rust-where-are-primitive-types-from/index.html @@ -0,0 +1,317 @@ + + + + + + + + + + + Rust のプリミティブ型はどこからやって来るか | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+
+

Rust のプリミティブ型はどこからやって来るか

+ + + +
+
+
+

更新履歴

+
    + +
  1. + : Qiita から移植 +
    2. + +
+
+
+
+
+

この記事は Qiita から移植してきたものです。 元 URL: +https://qiita.com/nsfisis/items/9a429432258bbcd6c565

+
+
+
+
+ + + + + +
+

+ + 前置き + +

+
+
+

Rust +において、プリミティブ型の名前は予約語でない。したがって、次のコードは合法である。

+
+
+
+
#![allow(non_camel_case_types)]
+#![allow(dead_code)]
+
+struct bool;
+struct char;
+struct i8;
+struct i16;
+struct i32;
+struct i64;
+struct i128;
+struct isize;
+struct u8;
+struct u16;
+struct u32;
+struct u64;
+struct u128;
+struct usize;
+struct f32;
+struct f64;
+struct str;
+
+
+
+

では、普段単に bool と書いたとき、この bool +は一体どこから来ているのか。rustc のソースを追ってみた。

+
+
+
+
+

前提知識: 一般的なコンパイラの構造、用語。rustc そのものの知識は不要 +(というよりも筆者自身がよく知らない)

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

+ + 調査 + +

+
+
+

調査に使用したソース (調査時点での最新 master)

+
+
+

https://github.com/rust-lang/rust/tree/511ed9f2356af365ad8affe046b3dd33f7ac3c98

+
+
+

どのようにして調べるか。rustc +の構造には詳しくないため、すぐに当たりをつけるのは難しい。

+
+
+

大雑把な構造としては、compiler フォルダ以下に rustc_* +という名前のクレートが数十個入っている。これがどうやら rustc +コマンドの実装部のようだ。

+
+
+

rustc はセルフホストされている (= rustc 自身が Rust で書かれている) +ので、bool や char +などで適当に検索をかけてもノイズが多すぎて話にならない。 +しかし、お誂え向きなことに i128/u128 +というコンパイラ自身が使うことがなさそうな型が存在するのでこれを使って +git grep してみる。

+
+
+
+
$ git grep "\bi128\b" | wc      # i128
+     165    1069   15790
+
+$ git grep "\bu128\b" | wc      # u128
+     293    2127   26667
+
+$ git grep "\bbool\b" | wc      # cf. bool の結果
+    3563   23577  294659
+
+
+
+

165 +程度であれば探すことができそうだ。今回は、クレート名を見ておおよその当たりをつけた。

+
+
+
+
$ git grep "\bi128\b"
+...
+rustc_resolve/src/lib.rs:        table.insert(sym::i128, Int(IntTy::I128));
+...
+
+
+
+

rustc_resolve +というのはいかにも名前解決を担いそうなクレート名である。該当箇所を見てみる。

+
+
+
+
/// Interns the names of the primitive types.
+///
+/// All other types are defined somewhere and possibly imported, but the primitive ones need
+/// special handling, since they have no place of origin.
+struct PrimitiveTypeTable {
+    primitive_types: FxHashMap<Symbol, PrimTy>,
+}
+
+impl PrimitiveTypeTable {
+    fn new() -> PrimitiveTypeTable {
+        let mut table = FxHashMap::default();
+
+        table.insert(sym::bool, Bool);
+        table.insert(sym::char, Char);
+        table.insert(sym::f32, Float(FloatTy::F32));
+        table.insert(sym::f64, Float(FloatTy::F64));
+        table.insert(sym::isize, Int(IntTy::Isize));
+        table.insert(sym::i8, Int(IntTy::I8));
+        table.insert(sym::i16, Int(IntTy::I16));
+        table.insert(sym::i32, Int(IntTy::I32));
+        table.insert(sym::i64, Int(IntTy::I64));
+        table.insert(sym::i128, Int(IntTy::I128));
+        table.insert(sym::str, Str);
+        table.insert(sym::usize, Uint(UintTy::Usize));
+        table.insert(sym::u8, Uint(UintTy::U8));
+        table.insert(sym::u16, Uint(UintTy::U16));
+        table.insert(sym::u32, Uint(UintTy::U32));
+        table.insert(sym::u64, Uint(UintTy::U64));
+        table.insert(sym::u128, Uint(UintTy::U128));
+        Self { primitive_types: table }
+    }
+}
+
+
+
+

これは初めに列挙したプリミティブ型の一覧と一致している。doc comment +にも、

+
+
+
+
+

All other types are defined somewhere and possibly imported, but the +primitive ones need special handling, since they have no place of +origin.

+
+
+
+
+

とある。次はこの struct +の使用箇所を追う。追うと言っても使われている箇所は次の一箇所しかない。なお説明に不要な箇所は大きく削っている。

+
+
+
+
    /// This resolves the identifier `ident` in the namespace `ns` in the current lexical scope.
+    /// (略)
+    fn resolve_ident_in_lexical_scope(
+        &mut self,
+        mut ident: Ident,
+        ns: Namespace,
+        // (略)
+    ) -> Option<LexicalScopeBinding<'a>> {
+        // (略)
+
+        if ns == TypeNS {
+            if let Some(prim_ty) = self.primitive_type_table.primitive_types.get(&ident.name) {
+                let binding =
+                    (Res::PrimTy(*prim_ty), ty::Visibility::Public, DUMMY_SP, ExpnId::root())
+                        .to_name_binding(self.arenas);
+                return Some(LexicalScopeBinding::Item(binding));
+            }
+        }
+
+        None
+    }
+
+
+
+

関数名や doc comment が示している通り、この関数は識別子 (identifier, +ident) を現在のレキシカルスコープ内で解決 (resolve) する。 +if ns == TypeNS のブロック内では、primitive_type_table (上記の +PrimitiveTypeTable::new() で作られた変数) に含まれている識別子 +(bool、i32 など) +かどうか判定し、そうであればそれに紐づけられたプリミティブ型を返している。

+
+
+

なお、ns は「名前空間」を示す変数である。Rust +における名前空間はC言語におけるそれとほとんど同じで、今探している名前が関数名/変数名なのか型なのかマクロなのかを区別している。この +if +は、プリミティブ型に解決されるのは型を探しているときだけだ、と言っている。

+
+
+

重要なのは、これが resolve_ident_in_lexical_scope() +の最後に書かれている点である。つまり、最初に挙げたプリミティブ型の識別子は、「名前解決の最終段階で」、「他に同名の型が見つかっていなければ」プリミティブ型として解決される。

+
+
+

動作がわかったところで、例として次のコードを考える。

+
+
+
+
#![allow(non_camel_case_types)]
+
+struct bool;
+
+fn main() {
+    let _: bool = bool;
+}
+
+
+
+

ここで main() の bool は struct bool +として解決される。なぜなら、プリミティブ型の判定をする前に bool +という名前の別の型が見つかるからだ。

+
+
+
+ + + + + +
+

+ + まとめ + +

+
+
+

Rust +のプリミティブ型は予約語ではない。名前解決の最終段階で特別扱いされ、他に同名の型が見つかっていなければ対応するプリミティブ型に解決される。

+
+
+
+
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/public/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre/index.html b/public/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre/index.html new file mode 100644 index 0000000..94912ed --- /dev/null +++ b/public/posts/2021-10-02/vim-difference-between-autocmd-bufwrite-and-bufwritepre/index.html @@ -0,0 +1,299 @@ + + + + + + + + + + + 【Vim】autocmd events の BufWrite/BufWritePre の違い | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+
+

【Vim】autocmd events の BufWrite/BufWritePre の違い

+ +
    + +
  • + Vim +
    • + +
+ +
+
+
+

更新履歴

+
    + +
  1. + : Qiita から移植 +
    2. + +
+
+
+
+
+

この記事は Qiita から移植してきたものです。 元 URL: +https://qiita.com/nsfisis/items/79ab4db8564032de0b25

+
+
+
+
+ + + + + +
+

+ + TL; DR + +

+
+
+

違いはない。ただのエイリアス。

+
+
+
+ + + + + +
+

+ + 調査記録 + +

+
+
+

Vim の autocmd events には似通った名前のものがいくつかある。大抵は +:help +に説明があるが、この記事のタイトルにある2つを含めた以下のイベントには、その違いについて説明がない。

+
+
+
    +
  • +

    BufRead/BufReadPost

    +
    • +
  • +

    BufWrite/BufWritePre

    +
    • +
  • +

    BufAdd/BufCreate

    +
    • +
+
+
+

このうち、BufAdd/BufCreate に関しては、:help BufCreate に

+
+
+
+
+

The BufCreate event is for historic reasons.

+
+
+
+
+

とあり、おそらくは BufAdd +のエイリアスであろうということがわかる。他の2組も同様ではないかと予想されるが、確認のため +vim と neovim のソースコードを調査した。

+
+
+
+
+

ソースコードへのリンク +vim +(調査時点での master branch) +neovim +(上に同じ)

+
+
+
+ + + + + +
+

+ + vim のソースコード + +

+
+
+

以下は、autocmd events +の名前と内部で使われている整数値とのマッピングを定義している箇所である。見ての通り、上でエイリアスではないかと述べた3組には、それぞれ同じ内部値が使われている。

+
+
+

https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L85-L86

+
+
+
+
    {"BufAdd",      EVENT_BUFADD},
+    {"BufCreate",   EVENT_BUFADD},
+
+
+
+

https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L95-L97

+
+
+
+
    {"BufRead",     EVENT_BUFREADPOST},
+    {"BufReadCmd",  EVENT_BUFREADCMD},
+    {"BufReadPost", EVENT_BUFREADPOST},
+
+
+
+

https://github.com/vim/vim/blob/8e6be34338f13a6a625f19bcef82019c9adc65f2/src/autocmd.c#L103-L105

+
+
+
+
    {"BufWrite",    EVENT_BUFWRITEPRE},
+    {"BufWritePost",    EVENT_BUFWRITEPOST},
+    {"BufWritePre", EVENT_BUFWRITEPRE},
+
+
+
+
+ + + + + +
+

+ + neovim のソースコード + +

+
+
+

neovim の場合でも同様のマッピングが定義されているが、こちらの場合は Lua +で書かれている。以下にある通り、はっきり aliases と書かれている。

+
+
+

https://github.com/neovim/neovim/blob/71d4f5851f068eeb432af34850dddda8cc1c71e3/src/nvim/auevents.lua#L119-L124

+
+
+
+
  aliases = {
+    BufCreate = 'BufAdd',
+    BufRead = 'BufReadPost',
+    BufWrite = 'BufWritePre',
+    FileEncoding = 'EncodingChanged',
+  },
+
+
+
+

ところで、上では取り上げなかった FileEncoding だが、これは +:help FileEncoding にしっかりと書いてある。

+
+
+
+
                                                           *FileEncoding*
+FileEncoding                    Obsolete.  It still works and is equivalent
+                                to |EncodingChanged|.
+
+
+
+
+ + + + + +
+

+ + まとめ + +

+
+
+

記事タイトルについて言えば、どちらも変わらないので好きな方を使えばよい。あえて言えば、次のようになるだろう。

+
+
+
    +
  • +

    BufAdd/BufCreate

    +
    +
      +
    • +

      → BufCreate は歴史的な理由により (`for historic reasons'') +存在しているため、新しい方 (`BufAdd) を使う

      +
      • +
    +
    +
    • +
  • +

    BufRead/BufReadPost

    +
    +
      +
    • +

      → BufReadPre との対称性のため、あるいは BufWritePost +との対称性のため BufReadPost を使う

      +
      • +
    +
    +
    • +
  • +

    BufWrite/BufWritePre

    +
    +
      +
    • +

      → BufWritePost との対称性のため、あるいは BufReadPre +との対称性のため BufWritePre を使う

      +
      • +
    +
    +
    • +
  • +

    FileEncoding/EncodingChanged

    +
    +
      +
    • +

      → FileEncoding は `Obsolete'' +と明言されているので、`EncodingChanged を使う

      +
      • +
    +
    +
    • +
+
+
+

ところでこの調査で知ったのだが、BufRead と BufWrite +は上にある通り発火するタイミングが「後」と「前」で対称性がない。可能なら +Pre/Post 付きのものを使った方が分かりやすいだろう。

+
+
+
+
+
+
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/public/posts/2021-10-02/vim-swap-order-of-selected-lines/index.html b/public/posts/2021-10-02/vim-swap-order-of-selected-lines/index.html new file mode 100644 index 0000000..2b66f2e --- /dev/null +++ b/public/posts/2021-10-02/vim-swap-order-of-selected-lines/index.html @@ -0,0 +1,366 @@ + + + + + + + + + + + Vimで選択した行の順番を入れ替える | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+
+

Vimで選択した行の順番を入れ替える

+ +
    + +
  • + Vim +
    • + +
+ +
+
+
+

更新履歴

+
    + +
  1. + : Qiita から移植 +
    2. + +
+
+
+
+
+

この記事は Qiita から移植してきたものです。 元 URL: +https://qiita.com/nsfisis/items/4fefb361d9a693803520

+
+
+
+
+ + + + + +
+

+ + バージョン情報 + +

+
+
+

:version の一部

+
+
+
+
+

VIM - Vi IMproved 8.2 (2019 Dec 12, compiled Jan 26 2020 11:30:30) macOS +version Included patches: 1-148 Huge version without GUI.

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

+ + よく紹介されている手法 + +

+
+ + + + + +
+

+ + tac / tail + +

+
+
+

tac や tail -r などの外部コマンドを ! +を使って呼び出し、置き換える。

+
+
+
+
+

:h v_!

+
+
+
+
+

tac コマンドや tail の -r +オプションは環境によって利用できないことがあり、複数の環境を行き来する場合に採用しづらい

+
+
+
+ + + + + +
+

+ + :g/^/m0 + +

+
+
+

こちらは外部コマンドに頼らず、Vim の機能のみを使う。g は :global +コマンドの、m は :move コマンドの略

+
+
+

:global コマンドは :[range]global/{pattern}/[command] +のように使い、[range] で指定された範囲の行のうち、{pattern} +で指定された検索パターンにマッチする行に対して、順番に [command] +で指定された Ex コマンドを呼び出す。

+
+
+
+
+

:h :global

+
+
+
+
+

:move コマンドは [range]:move {address} のように使い、[range] +で指定された範囲の行を {address} で指定された位置に移動させる。

+
+
+
+
+

:h :move

+
+
+
+
+

:g/^/m0 のように組み合わせると、「すべての行を1行ずつ +0行目(1行目の上)に動かす」という動きをする。これは確かに行の入れ替えになっている。

+
+
+

なお、:g/^/m0 は全ての行を入れ替えるが、:N,Mg/^/mN-1 とすることで +N行目から +M行目を処理範囲とするよう拡張できる。手でこれを入力するわけにはいかないので、次のようなコマンドを用意する。

+
+
+
+
command! -bar -range=%
+    \ Reverse
+    \ <line1>,<line2>g/^/m<line1>-1
+
+
+
+

これは望みの動作をするが、実際に実行してみると全行がハイライトされてしまう。次節で詳細を述べる。

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

+ + :g/^/m0 の問題点 + +

+
+
+

:global +コマンドは各行に対してマッチングを行う際、現在の検索パターンを上書きしてしまう。^ +は行の先頭にマッチするため、結果として全ての行がハイライトされてしまう。'hlsearch' +オプションを無効にしている場合その限りではないが、その場合でも直前の検索パターンが失われてしまうと +n コマンドなどの際に不便である。

+
+
+
+
+

:h @/

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

+ + 解決策 + +

+
+
+
+
+

[2020/9/28追記] より簡潔な方法を見つけたので次節に追記した

+
+
+
+
+

前述した :Reverse コマンドの定義を少し変えて、次のようにする:

+
+
+
+
function! s:reverse_lines(from, to) abort
+    execute printf("%d,%dg/^/m%d", a:from, a:to, a:from - 1)
+endfunction
+
+command! -bar -range=%
+    \ Reverse
+    \ call <SID>reverse_lines(<line1>, <line2>)
+
+
+
+

実行しているコマンドが変わったわけではないが、関数呼び出しを経由するようにした。これだけで前述の問題が解決する。

+
+
+

この理由は、ユーザー定義関数を実行する際は検索パターンが一度保存され、実行が終了したあと復元されるため。結果として検索パターンが +^ で上書きされることがなくなる。

+
+
+

Vim のヘルプから該当箇所を引用する (強調は筆者による)。

+
+
+
+
+

:h autocmd-searchpat

+
+
+

Autocommands do not change the current search patterns. Vim saves the +current search patterns before executing autocommands then restores them +after the autocommands finish. This means that autocommands do not +affect the strings highlighted with the `hlsearch' option.

+
+
+
+
+

これは autocommand +の実行に関しての記述だが、これと同じことがユーザー定義関数の実行時にも適用される。このことは +:nohlsearch のヘルプにある。同じく該当箇所を引用する +(強調は筆者による)。

+
+
+
+
+

:h :nohlsearch

+
+
+

(略) This command doesn’t work in an autocommand, because the +highlighting state is saved and restored when executing autocommands +|autocmd-searchpat|. Same thing for when invoking a user function.

+
+
+
+
+

この仕様により、:g/^/m0 +の呼び出しをユーザー定義関数に切り出すことで上述の問題を解決できる。

+
+
+
+ + + + + +
+

+ + 解決策 (改訂版) + +

+
+
+
+
+

[2020/9/28追記] より簡潔な方法を見つけたため追記する

+
+
+
+
+
+
command! -bar -range=%
+    \ Reverse
+    \ keeppatterns <line1>,<line2>g/^/m<line1>-1
+
+
+
+

まさにこのための Exコマンド、:keeppatterns +が存在する。:keeppatterns {command} +のように使い、読んで字の如く、後ろに続く +Exコマンドを「現在の検索パターンを保ったまま」実行する。はるかに分かりやすく意図を表現できる。

+
+
+
+
+

:h :keeppatterns

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

+ + コピペ用再掲 + +

+
+
+
+
" License: Public Domain
+
+command! -bar -range=%
+    \ Reverse
+    \ keeppatterns <line1>,<line2>g/^/m<line1>-1
+
+
+
+
+
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/public/posts/2022-04-09/phperkaigi-2022-tokens/index.html b/public/posts/2022-04-09/phperkaigi-2022-tokens/index.html new file mode 100644 index 0000000..afb6eac --- /dev/null +++ b/public/posts/2022-04-09/phperkaigi-2022-tokens/index.html @@ -0,0 +1,876 @@ + + + + + + + + + + + PHPerKaigi 2022 トークン問題の解説 | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+
+

PHPerKaigi 2022 トークン問題の解説

+ + + +
+
+
+

更新履歴

+
    + +
  1. + : 公開 +
    2. + +
  2. + : 2問目、3問目の解説を追加、1問目に加筆 +
    3. + +
+
+ + + + + +
+

+ + はじめに + +

+
+
+

本日開始された PHPerKaigi 2022 の PHPer +チャレンジにおいて、弊社 +デジタルサーカス株式会社 の問題を +3問作成した。この記事では、これらの問題の解説をおこなう。

+
+
+

リポジトリはこちら: https://github.com/nsfisis/PHPerKaigi2022-tokens

+
+
+
+ + + + + +
+

+ + 第1問 brainf_ck.php + +

+
+
+

ソースコードはこちら。実行には PHP 8.1 以上が必要なので注意。

+
+
+
+
<?php
+
+declare(strict_types=0O1);
+
+namespace Dgcircus\PHPerKaigi\Y2022;
+
+/**
+ * @todo
+ * Run this program to acquire a PHPer token.
+ */
+
+https://creativecommons.org/publicdomain/zero/1.0/
+
+\error_reporting(~+!'We are hiring!');
+
+$z = fn($f) => (fn($x) => $f(fn(...$xs) => $x($x)(...$xs)))(fn($x) => $f(fn(...$xs) => $x($x)(...$xs)));
+$id = \spl_object_id(...);
+$put = fn($c) => \printf('%c', $c);
+$mm = fn($p, $n) => new \ArrayObject(\array_fill(+!![], $n, $p));
+
+$👉 = fn($m, $p, $b, $e, $mp, $pc) => [++$mp, ++$pc];
+$👈 = fn($m, $p, $b, $e, $mp, $pc) => [--$mp, ++$pc];
+$👍 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, ++$m[$mp]];
+$👎 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, --$m[$mp]];
+$📝 = fn($m, $p, $b, $e, $mp, $pc) => [$mp, ++$pc, $put($m[$mp])];
+$🤡 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) {
+    +!![] => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) {
+      $b => $loop(++$pc, ++$n),
+      $e => $n === +!![] ? ++$pc : $loop(++$pc, --$n),
+      default => $loop(++$pc, $n),
+    })($pc, -![])],
+    default => [$mp, ++$pc],
+};
+$🎪 = fn($m, $p, $b, $e, $mp, $pc) => match ($m[$mp]) {
+    +!![] => [$mp, ++$pc],
+    default => [$mp, $z(fn($loop) => fn($pc, $n) => match ($id($p[$pc])) {
+      $e => $loop(--$pc, ++$n),
+      $b => $n === +!![] ? $pc+![] : $loop(--$pc, --$n),
+      default => $loop(--$pc, $n),
+    })($pc, -![])],
+};
+$🐘 = fn($p) => $z(fn($loop) => fn($m, $p, $b, $e, $mp, $pc) =>
+  isset($p[$pc]) && $loop($m, $p, $b, $e, ...($p[$pc]($m, $p, $b, $e, $mp, $pc)))
+)($mm(+!![], +(![].![])), $p, $id($🤡), $id($🎪), +!![], +!![]);
+
+$🐘([
+  $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
+  $🤡,
+    $👉, $👍, $👍, $👍,
+    $👉, $👍, $👍, $👍, $👍, $👍,
+    $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
+    $👉, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍, $👍,
+    $👈, $👈, $👈, $👈, $👎,
+  $🎪,
+  $👉, $👍, $👍, $👍, $👍, $👍, $📝,
+  $👎, $👎, $📝,
+  $👉, $👎, $👎, $👎, $📝,
+  $👉, $👎, $👎, $👎, $📝,
+  $👎, $👎, $📝,
+  $👎, $📝,
+  $👈, $📝,
+  $👉, $👉, $👎, $👎, $📝,
+  $👍, $👍, $👍, $👍, $👍, $👍, $👍, $📝,
+  $👈, $👎, $👎, $👎, $👎, $📝,
+  $👈, $📝,
+  $👉, $👍, $👍, $📝,
+  $👉, $👎, $📝,
+  $👈, $📝,
+]);
+
+
+
+

この問題は、単に適切なバージョンの PHP で動かせばトークンが得られる。

+
+ + + + + +
+

+ + 解説 + +

+
+ + + + + +
+

+ + 絵文字 + +

+
+
+

まず目につくのは大量の絵文字だろう。 PHP +は識別子に使用できる文字の範囲が広く、絵文字も使うことができる。

+
+
+
+ + + + + +
+

+ + プログラム全体 + +

+
+
+

Brainf*ck のインタプリタとプログラムになっている。 Brainf*ck +とは、難解プログラミング言語のひとつであり、ここで説明するよりも +Wikipedia の該当ページを読んだ方がよい。

+
+
+

https://ja.wikipedia.org/wiki/Brainfuck

+
+
+

なお、brainf*ck プログラムを普通の書き方で書くと、次のようになる。

+
+
+
+
+ + + + + + + + + +
+[
+  > + + +
+  > + + + + +
+  > + + + + + + + + + + + +
+  > + + + + + + + + + +
+  < < < < -
+]
+> + + + + + .
+- - .
+> - - - .
+> - - - .
+- - .
+- .
+< .
+> > - - .
++ + + + + + + .
+< - - - - .
+< .
+> + + .
+> - .
+< .
+
+
+
+

実行結果はこちら: https://ideone.com/22VWmb

+
+
+

それぞれの絵文字で表された関数が、各命令に対応している。

+
+
+
    +
  • +

    $👉: >

    +
    • +
  • +

    $👈: <

    +
    • +
  • +

    $👍: +

    +
    • +
  • +

    $👎: -

    +
    • +
  • +

    $📝: .

    +
    • +
  • +

    $🤡: [

    +
    • +
  • +

    $🎪: ]

    +
    • +
+
+
+

, (入力) に対応する関数はない +(このプログラムでは使わないので用意していない)。

+
+
+

なお、$🐘 はいわゆる main 関数であり、プログラムの実行部分である。

+
+
+
+ + + + + +
+

+ + 絵文字の選択 + +

+
+
+

おおよそ意味に合致するよう選んでいるが、$🤡 と $🎪 +は弊社デジタルサーカスにちなんでいる。 また、$🐘 は PHP +のマスコットの象に由来する。

+
+
+
+ + + + + +
+

+ + strict_types + +

+
+
+

declare 文の strict_types に指定できるのは、0 か 1 +の数値リテラルだが、 0x0 や 0b1 のような値も受け付ける。 今回は、PHP +8.1 から追加された、0O または 0o から始まる八進数リテラルを使った。

+
+
+
+ + + + + +
+

+ + URL + +

+
+
+

ソースコードのライセンスを示したこの部分だが、

+
+
+
+
https://creativecommons.org/publicdomain/zero/1.0/
+
+
+
+

完全に合法な PHP のコードである。 https: 部分はラベル、// +以降は行コメントになっている。

+
+
+
+ + + + + +
+

+ + リテラルなしで数値を生成する + +

+
+
+

ソースコード中に、ほとんど数値リテラルが書かれていないことにお気づきだろうか。 +PHP では、型変換を利用することで任意の整数を作り出すことができる。

+
+
+
+
assert(0 === +!![]);
+assert(1 === +![]);
+assert(2 === ![]+![]);
+assert(3 === ![]+![]+![]);
+assert(10 === +(![].+!![]));
+
+
+
+

[] に ! を適用すると true が返ってくる。それに + +を適用すると、bool から int ヘの型変換が走り、1 が生成される。10 +はさらにトリッキーだ。まず 1 と 0 を作り、. で文字列として結合する +('10')。これに + を適用すると、string から int +への型変換が走り、10 が生まれる (コード量に頓着しないなら、1 を 10 +個足し合わせてももちろん 10 が作れる)。

+
+
+

また、error_reporting に指定しているのは -1 である。 これは、! +によって文字列を false にし、+ によって false を 0 +にし、さらにビット反転して -1 にしている。

+
+
+
+ + + + + +
+

+ + if 文なしで条件分岐 + +

+
+
+

三項演算子ないし match 式を使うことで、if +を一切書かずに条件分岐ができる。 また、&& / || も使えることがある。 +遅延評価が不要なケースでは、[$t, $f][$cond] +のような形で分岐することもできる。

+
+
+
+ + + + + +
+

+ + while、for 文なしでループ + +

+
+
+

不動点コンビネータを使って無名再帰する +(詳しい説明は省略する。これらの単語で検索してほしい)。 ここでは、一般に +Z コンビネータとして知られるものを使った ($z)。

+
+
+

実際のところ、$🤡 や $🎪、$🐘 は、一度 Scheme (Lisp の一種) +で書いてから PHP に翻訳する形で記述した。

+
+
+

なお、PHP は末尾再帰の最適化をおこなわない (少なくとも今のところは) +ので、 あまりに長い brainf*ck +プログラムを書くとスタックオーバーフローする。

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

+ + 第2問 riddle.php + +

+
+
+

ソースコードはこちら。実行には PHP 8.0 以上が必要なので注意。

+
+
+
+
<?php
+
+/*********************************************************
+ * This program displays a PHPer token.                  *
+ * Guess 'N'.                                            *
+ *                                                       *
+ * Hints:                                                *
+ * - N itself has no special meaning, e.g., 42, 8128,    *
+ *   it is selected at random.                           *
+ * - Each element of $token represents a single letter.  *
+ * - One letter consists of 5x5 cells.                   *
+ * - Remember, the output is a complete PHPer token.     *
+ *                                                       *
+ * License:                                              *
+ *   https://creativecommons.org/publicdomain/zero/1.0/  *
+ *********************************************************/
+const N = 0 /* Change it to your answer. */;
+assert(0 <= N && N <= 0b11111_11111_11111_11111_11111);
+
+$token = [
+  0x14B499C,
+  0x0BE34CC, 0x01C9C69,
+  0x0ECA069, 0x01C2449, 0x0FDB166, 0x01C9C69,
+  0x01C1C66, 0x0FC1C47, 0x01C1C66,
+  0x10C5858, 0x1E4E3B8, 0x1A2F2F8,
+];
+foreach ($token as $x) {
+  $x = $x ^ N;
+
+  $x = sprintf('%025b', $x);
+  $x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
+  $x = implode("\n", str_split($x, length: 5));
+  echo "{$x}\n\n";
+}
+
+
+
+

さて、この問題はさきほどのように単純に実行しただけでは、謎のブロックが表示されるだけでトークンは得られない。 +トークンを得るためには、ソースコードを読み、定数 N +を特定する必要がある。

+
+
+

ここでは、私の想定解を解説する。

+
+ + + + + +
+

+ + 読解 + +

+
+
+

まずはソースコードを読んでいく。

+
+
+
+
$token = [
+  // 略
+];
+
+
+
+

数値からなる $token があり、各要素をループしている。

+
+
+
+
  $x = $x ^ N;
+
+
+
+

まずは排他的論理和 (xor) を取り、

+
+
+
+
  $x = sprintf('%025b', $x);
+
+
+
+

二進数に変換して、

+
+
+
+
  $x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
+
+
+
+

0 を空白に、1 を # にし、

+
+
+
+
  $x = implode("\n", str_split($x, length: 5));
+
+
+
+

5文字ごとに区切ったあと、改行で結合している。

+
+
+
+ + + + + +
+

+ + ヒント + +

+
+
+

次に、ソースコードに書いてあるヒントを読んでいく。

+
+
+
    +
  • +

    N それ自体は、42 や 8128 +といったような特別な意味を持たず、ランダムに決められている

    +
    • +
  • +

    $token の各要素は、1文字を表す

    +
    • +
  • +

    1文字は 5x5 のセルからなる

    +
    • +
  • +

    出力されるのは、完全な PHPer トークンである

    +
    • +
+
+
+

ここで、PHPer トークンは必ず 記号から始まることを思いだすと、 +$token の最初の数字 0x14B499C は、変換の結果 +になるのではないかと予想される (なお、このことは、リポジトリの README +ファイルに追加ヒントとして書かれている)。

+
+
+
+ + + + + +
+

+ + 解く + +

+
+
+

ここまでわかれば、あと一歩で解ける。すなわち、0x14B499C が # +に変換されるような N を見つければよい。

+
+
+

N は高々

+
+
+
+
assert(0 <= N && N <= 0b11111_11111_11111_11111_11111);
+
+
+
+

なのでブルートフォースしてもよいが、ここではブルートフォースしない方法を紹介する。

+
+
+
+
<?php
+
+$x = 0x14B499C;
+
+$x = $x ^ N;
+
+$x = sprintf('%025b', $x);
+$x = str_replace(search: ['0', '1'], replace: [' ', '#'], subject: $x);
+$x = implode("\n", str_split($x, length: 5));
+
+assert($x ===
+  " # # \n" .
+  "#####\n" .
+  " # # \n" .
+  "#####\n" .
+  " # # ");
+
+
+
+

この一連の変換に対する逆変換を考えると、次のようになる。

+
+
+
+
<?php
+
+$x =
+  " # # \n" .
+  "#####\n" .
+  " # # \n" .
+  "#####\n" .
+  " # # ";
+
+$x = implode('', explode("\n", $x));
+$x = str_replace(search: [' ', '#'], replace: ['0', '1'], subject: $x);
+$x = bindec($x);
+
+$n = $x ^ 0x14B499C;
+
+echo "N = $n\n";
+
+
+
+

これを実行すると、N が得られる。

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

+ + 第3問 toquine.php + +

+
+
+

ソースコードはこちら。

+
+
+
+
<?php
+
+// License: https://creativecommons.org/publicdomain/zero/1.0/
+// This is a quine-like program to generate a PHPer token.
+// Execute it like this: php toquine.php | php | php | php | ...
+
+$s = <<<'Q'
+<?cuc
+// Yvprafr: uggcf://perngvirpbzzbaf.bet/choyvpqbznva/mreb/1.0/
+// Guvf vf n dhvar-yvxr cebtenz gb trarengr n CUCre gbxra.
+// Rkrphgr vg yvxr guvf: cuc gbdhvar.cuc | cuc | cuc | cuc | ...
+%f$f = %f;
+$f = fge_ebg13($f); $kf = [
+%f,
+];
+$g = ahyy.snyfr; sbe ($v = 0; $v <= vagqvi(__YVAR__-035,6); ++$v) vs (!vffrg($kf[$v])) oernx; ryfr
+$g .= vzcybqr("\a", fge_fcyvg(fge_ercynpr(['0','1'], ['  ','##'], fcevags(pue(37) . '025o', $kf[$v])), 012)) . "\a\a";
+$jf = neenl_znc(sa($j) => vzcybqr(', ', $j), neenl_puhax(neenl_znc(sa($k) => fcevags('0k' . pue(37) . '07K', $k), $kf), 10));
+cevags($f, $g, fge_ebg13("<<<'Q'\a{$f}\aQ"), vzcybqr(",\a", $jf));
+Q;
+$s = str_rot13($s); $xs = [
+0x0AFABEA, 0x1F294A7, 0x1F2109F, 0x1F294A7, 0x0002800, 0x1F2109F, 0x0117041, 0x1F294A7, 0x1FAD6B5, 0x1F295B7,
+0x010FC21, 0x1FAD6B5, 0x1151151, 0x010FC21, 0x1F294A7, 0x1F295B7, 0x1FAD6B5, 0x1F294A7, 0x1F295B7, 0x1F8C63F,
+0x1F8C631, 0x1FAD6B5, 0x17AD6BD, 0x17AD6BD, 0x1F8C63F, 0x1F295B7,
+];
+$t = null.false; for ($i = 0; $i <= intdiv(__LINE__-035,6); ++$i) if (!isset($xs[$i])) break; else
+$t .= implode("\n", str_split(str_replace(['0','1'], ['  ','##'], sprintf(chr(37) . '025b', $xs[$i])), 012)) . "\n\n";
+$ws = array_map(fn($w) => implode(', ', $w), array_chunk(array_map(fn($x) => sprintf('0x' . chr(37) . '07X', $x), $xs), 10));
+printf($s, $t, str_rot13("<<<'D'\n{$s}\nD"), implode(",\n", $ws));
+
+
+
+

コメントにもあるとおり、次のようにして実行すれば答えがでてくる。

+
+
+
+
$ php toquine.php | php | php | php | ...
+
+
+
+

実際にはもう少しパイプで繋げなければならない。

+
+ + + + + +
+

+ + 解説 + +

+
+ + + + + +
+

+ + プログラム全体 + +

+
+
+

コメントにもあるとおり、これは quine (風) のプログラムになっている。 +Quine +とは、自分のソースコードをそっくりそのまま出力するようなプログラムのことである。

+
+
+

このプログラムは、実行すると自身とほとんど同じプログラムを出力する。 +異なるのはトークンになっている部分のみである。

+
+
+
+ + + + + +
+

+ + トークン + +

+
+
+

$xs がトークンに対応している。変換のロジックは riddle.php +とほぼ同じなので省略する。

+
+
+
+ + + + + +
+

+ + 状態保持 + +

+
+
+

トークンの何文字目まで出力したかを、ソースコードを変えずに (quine +なので) 覚えておく必要がある。 +このプログラムでは、トークンが出力されるとソースコードがだんだんと長くなっていくのを利用して、LINE +から情報を取得している。

+
+
+
+ + + + + +
+

+ + ROT 13 + +

+
+
+

Quine は、素朴に書くとプログラムの一部が 2回記述されてしまう。 +これがあまり美しくないので、toquine.php では、ROT 13 +変換を使って難読化した。

+
+
+

それにしてもなぜこんなものが標準ライブラリに……。

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

+ + おわりに + +

+
+
+

解いていただいたみなさん、また、難易度調整につきあっていただいた社内のみなさん、ありがとうございました。

+
+
+

今回は直前に作りはじめたのもあり、3問だけかつ使い古されたネタばかりになってしまいましたが、 +来年は 5問、より面白い問題を持っていきます。

+
+
+

実はもう作りはじめているので、どうか来年もありますように……。

+
+
+
+
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/public/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal/index.html b/public/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal/index.html new file mode 100644 index 0000000..628d3f8 --- /dev/null +++ b/public/posts/2022-04-24/term-banner-write-tool-showing-banner-in-terminal/index.html @@ -0,0 +1,222 @@ + + + + + + + + + + + term-banner: ターミナルにバナーを表示するツールを書いた | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+
+

term-banner: ターミナルにバナーを表示するツールを書いた

+ +
+
+
+

更新履歴

+
    + +
  1. + : 公開 +
    2. + +
  2. + : -f オプションについて追記 +
    3. + +
+
+ + + + + +
+

+ + はじめに + +

+
+
+

こんなものを作った。

+
+
+
+
$ term-banner 'Hello, World!' 'こんにちは、' '世界！'
+
+
+
+

image::https://raw.githubusercontent.com/nsfisis/term-banner/main/screenshot.png[term-banner +のスクリーンショット]

+
+
+

コマンドライン引数として渡した文字列をターミナルに大きく表示する。

+
+
+

リポジトリはこちら: https://github.com/nsfisis/term-banner

+
+
+
+ + + + + +
+

+ + Motivation + +

+
+
+

以前、https://github.com/nsfisis/big-clock-mode[big-clock-mode] +という似たようなプログラムを書いた。 これは tmux の :clock-mode +コマンドに着想を得たもので、:clock-mode +よりも大きく現在時刻を表示する。

+
+
+

big-clock-mode +を開発したのは、次のようなシチュエーションで使うためである。 +弊社では現在リモートワークが基本だが、web +会議などで画面共有しているときに、休憩を挟んで特定の時刻から再開する、ということがある。 +こういったケースで、画面上に現在の時刻を大きめに表示しておくと、モニタから離れても遠くから時刻がわかるので便利である。

+
+
+

それこそタイマアプリか何かを使えばいいのだが、ターミナルに棲むいきものとしては、住処から離れたくないわけだ。

+
+
+

しばらく便利に使っていたのだが、ひとつ不満点が出てきた。それは、再開する時刻がいつだったかを覚えておかなければならないということだ。 +どこかにメモしておいてもいいが、せっかくなら現在時刻とともに表示させておきたい。

+
+
+

そんなわけで、「任意の文字列をターミナルに表示する」プログラムを書く運びとなった。 +まあ、作らなくても探せばあると思うが、作りたいものは作りたいので知ったことではない。

+
+
+
+ + + + + +
+

+ + プログラム + +

+
+
+

全体の流れは次のようになっている。

+
+
+
    +
  1. +

    フォントファイルを読み込む

    +
    2. +
  2. +

    コマンドライン引数を Shift-JIS に変換する (フォントが Shift-JIS +基準で並んでいるため)

    +
    3. +
  3. +

    1文字ずつレンダリングしていく

    +
    4. +
+
+
+

big-clock-mode が Go 製なので、今回も Go で書いた。 PNG +が標準ライブラリにあったり、Shift-JIS +のエンコーディングが準標準ライブラリにあったりしたのは助かった。

+
+
+

フォントファイルは go:embed +で実行ファイルに埋め込んでいるので、ビルド後はワンバイナリで動く。 +仕事ではスクリプト言語ばかり書いているが、やはりコンパイル言語はいい。

+
+
+
+ + + + + +
+

+ + フォント + +

+
+
+

フリーの 8x8 +ビットマップフォントである、https://littlelimit.net/misaki.htm[美咲フォント +2021-05-05a 版] を使わせていただいた。

+
+
+

はじめは自分でポチポチ打っていたのだが、「き」くらいまでやって挫折した。 +同じく 8x8 +で作っていたのだが、平仮名でさえも、この小さなキャンバスにはとても収められない。

+
+
+

美咲フォントは、平仮名・片仮名に留まらず、JIS +第一・第二水準の漢字までサポートしている。 +第二水準ともなると一生お目にかかることのない字の方が多いくらいだが、これをこの大きさで書くというのは、もはや芸術の域である。

+
+
+

さらに言うと、実のところ美咲フォントは実サイズ 7x7 +で作られており、余白が設けられている。 +これは、単純にそのまま並べても字間・行間を確保できるようにという配慮である。 +おかげでコーディングまで楽になった。

+
+
+

ゴシック体と明朝体があったが、私の好みで明朝体の方にした。 +ただ、ゴシック体の方が見やすい気がするので、フォントを選べるように後ほど拡張するかもしれない。

+
+
+

2022-04-27 追記: -f オプションで選べるようにした。

+
+
+
+ + + + + +
+

+ + おわりに + +

+
+
+

あなたもターミナルに住んでみませんか？

+
+
+
+
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/public/posts/2022-05-01/phperkaigi-2022/index.html b/public/posts/2022-05-01/phperkaigi-2022/index.html new file mode 100644 index 0000000..4168136 --- /dev/null +++ b/public/posts/2022-05-01/phperkaigi-2022/index.html @@ -0,0 +1,324 @@ + + + + + + + + + + + PHPerKaigi 2022 | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+
+

PHPerKaigi 2022

+ + + +
+
+
+

更新履歴

+
    + +
  1. + : 公開 +
    2. + +
+
+ + + + + +
+

+ + はじめに + +

+
+
+

2022-04-09 から 2022-04-11 +にかけて開催された、https://phperkaigi.jp/2022/[PHPerKaigi 2022] +に、一般参加者として参加した。 +弊社https://www.dgcircus.com/[デジタルサーカス株式会社] +はダイヤモンドスポンサーとなっており、スポンサー枠のチケットを使わせていただいた。

+
+
+

昨年のレポートはこちら。

+
+
+
+ + + + + +
+

+ + 感想 + +

+
+ + + + + +
+

+ + 厳選おすすめトーク + +

+
+
+

多くの素晴らしいトークの中から、特におすすめのものを +5つ選んだ。是非聞いてほしい。引用部分は、リンク先プロポーザルから引用している。

+
+
+

予防に勝る防御なし +- 堅牢なコードを導く様々な設計のヒント

+
+
+
+
+

PHP +はバージョンを追う毎に型宣言、例外、表明、列挙型などの機能が大幅に強化され、堅牢なコードを書くための機能が充実してきました。それらの機能はどう使うと効果的なのでしょうか。

+
+
+

本講演では PHP 8.1 +をベースにして、誤りを想定してチェックするのではなく、そもそも誤りにくい設計とはどのようなものか、つまり「予防」の観点を軸足に、堅牢なコードを導くための様々な設計のヒントをご紹介します。

+
+
+
+
+

PHPのエラーを理解して適切なエラーハンドリングを学ぼう

+
+
+
+
+

PHPを使ってるとよく遭遇する Fatal error / Parse error / Warning / Notice +理解していますか？
+これらのエラー文を理解することで、すぐにエラーの原因に気付き適切に対象できる様になります！
+またそれらを理解した上でのエラーハンドリングを学びましょう。

+
+
+
+
+

エラー監視とテスト体制への改善作戦

+
+
+
+
+

毎日流れてくるエラーに皆さんはどう向き合ってますか？
+エラーを出さない事が一番ですが、完全に塞ぐ事は難しいと考えます。
+サービス運用の中で本番環境から発生するエラー（サーバー・クライアントサイド・サードパーティ起因のエラー）への監視体制と、
+エラー・バグ防御のためチームで行っているテストコード文化づくりの話をします。

+
+
+
+
+

ISUCON11のPHP実装は、何を考え、どのようにして作られていたのか

+
+
+
+
+

昨年開催されたISUCON11にて問題（参考実装）のPHPへの移植を担当させていただきました。

+
+
+

最終的なソースコードこそシンプルなWebアプリケーションではありますが、その裏には
+・「（私の思う）良い設計」を実現するための意思決定
+・「ISUCONの問題」という位置付けに由来する取捨選択
+・移植中に遭遇したトラブルとその解決策
+といった文脈や葛藤が存在しています。

+
+
+

本発表はそれらを共有することで
+・PHPアプリケーションの設計、実装事例として役立ててもらう
+・ISUCONの言語移植に興味を持ってもらう
+・ISUCON問題移植の「実装や設計の練習をする教材」としての可能性を知ってもらう
+ことを目的とします。

+
+
+
+
+

チームの仕事はまわっていたけど、メンバーはそれぞれモヤモヤを抱えていた話──40名の大規模開発チームで1on1ログを公開してみた

+
+
+
+
+

サイボウズの大企業向けグループウェアのGaroon（ガルーン）は、PHPで開発されている20年目の製品です。ガルーン開発チームは日本で40名、ベトナムで50名の計90名ほどのチームになっています。また、コロナ禍でフルリモートでの活動がこの2年ほど継続してきました。

+
+
+

フルリモートになっても仕事はまわっており、継続的にリリースはしていましたが、一方でお互いの考えていることや感じている問題意識が見えづらくなり、モヤモヤを抱えているメンバーが増えていました。

+
+
+

このセッションでは、そういう状況で私がチーム外からジョインし、聴き役に徹しながら見える化することで状況を改善していった取り組みを紹介します。同じように大きなチームやリモートワークで難しさを感じている人に、難しさの原因への気づきや取り組みへのヒントがあれば幸いです。

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

+ + トークン問題の作成 + +

+
+
+

今回は、PHPer チャレンジ用に弊社のトークン問題を +3題作成した。こちらについては別途記事にしているので、そちらを参照されたい。

+
+
+
+ + + + + +
+

+ + PHPer チャレンジ + +

+
+
+

1位になった。
+また、賞品として Echo Show 15 +をいただいた。

+
+
+
+ + + + + +
+

+ + カンファレンス全体への感想 + +

+
+
+

去年の参加レポ +では、こんなことを書いた。

+
+
+
+
+

1つ個人的な反省点としては、(中略) Discord +しかりアンカンファレンスしかり「このイベントのこの瞬間にしかないコンテンツ」に触れずに、後から見返せる発表やスライドに注力してしまった、ということだ。発表の詳細な見直しはあとからできるのだから、今しかできないことを考えるべきだった。
+まあ初カンファレンスだし、とお茶を濁しておこう。

+
+
+
+
+

この反省を踏まえ、今年は積極的にほかの場 (公式の Discord +サーバや、アンカンファレンス) にも参加した。
+これにより、参加体験の質がはるかに向上した。特に Discord +に関しては、登壇者ご本人による補足や、質問への回答などがおこなわれる +(ことが多い) +ため、特別な理由のない限り、発言はしないまでも参加はしておいたほうが良いと思われる。

+
+
+

なお、アンカンファレンスについては、1日目の終わりにhttps://fortee.jp/phperkaigi-2022/unconference/view/d332797a-8921-4706-a7e2-ee72640c9b5e[トークン問題の解説放送]もおこなった。

+
+
+

また、今年はオフラインとオンラインのハイブリッド開催であったが、去年の全オンラインと比べて、オンライン参加の体験が落ちていなかったのは、特筆すべきであろう。 +今年は +3回目のワクチン接種が間に合わなかったこともあり現地参加は見送ったのだが、来年は是非オフラインで参加したい。

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

+ + そして来年へ……? + +

+
+
+

PHPerKaigi 2023 があるかどうか存じ上げないが、あるとすれば、次の +4つを目標としたい。

+
+
+
    +
  • +

    プロポーザルを出す

    +
    • +
  • +

    PHPer チャレンジのトークン問題を 5題作成する

    +
    • +
  • +

    現地に行く

    +
    • +
  • +

    PHPer チャレンジで圧勝する

    +
    • +
+
+
+
+

最後になりましたが、PHPerKaigi +のスタッフ、スポンサー、スピーカーのみなさん、素敵な時間をありがとうございました。

+
+
+

ではまた来年。

+
+
+
+
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/public/posts/2022-08-27/php-conference-okinawa-code-golf/index.html b/public/posts/2022-08-27/php-conference-okinawa-code-golf/index.html new file mode 100644 index 0000000..471678a --- /dev/null +++ b/public/posts/2022-08-27/php-conference-okinawa-code-golf/index.html @@ -0,0 +1,276 @@ + + + + + + + + + + + PHP カンファレンス沖縄で出題されたコードゴルフの問題を解いてみた | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+
+

PHP カンファレンス沖縄で出題されたコードゴルフの問題を解いてみた

+ + + +
+
+
+

更新履歴

+
    + +
  1. + : 公開 +
    2. + +
+
+ + + + + +
+

+ + はじめに + +

+
+
+

本日 PHP カンファレンス沖縄 2022 +が開催された (らしい)。

+
+
+

カンファレンスには参加できなかったものの、懇親会の LT +で出題されたコードゴルフの問題が Twitter に流れてきたので、解いてみた。

+
+
+

ツイート: https://twitter.com/m3m0r7/status/1563397620231712772
+スライド: +https://speakerdeck.com/memory1994/php-conference-okinawa-2022-extra?slide=3

+
+
+
+ + + + + +
+

+ + 解 + +

+
+
+

細かいレギュレーションは不明だったので、勝手に定めた。

+
+
+
    +
  • +

    コマンドライン引数の第1引数で受けとる

    +
    • +
  • +

    結果は標準出力に出す

    +
    • +
  • +

    コンマの直後にはスペースを1つ置く

    +
    • +
  • +

    末尾コンマは禁止

    +
    • +
  • +

    数字でないものは入ってこないものとする

    +
    • +
  • +

    負数は入ってこないものとする

    +
    • +
+
+
+

書いたものがこちら:

+
+
+
+
[<?php $n=$argv[1];foreach([1e4,5e3,2e3,1e3,500,100,50,10,5,1]as$x)for(;$n>=$x;$n-=$x)$r[]=$x;echo implode(', ',$r??[]);?>]
+
+
+
+

しめて 123 バイトとなった (末尾改行を含めずにカウント)。

+
+
+

こちらは改行とスペースを追加したバージョン:

+
+
+
+
[<?php
+
+$n = $argv[1];
+foreach ([1e4, 5e3, 2e3, 1e3, 500, 100, 50, 10, 5, 1] as $x)
+  for (; $n >= $x; $n -= $x)
+    $r[] = $x;
+echo implode(', ', $r ?? []);
+
+?>]
+
+
+
+
+ + + + + +
+

+ + 使用したテクニック + +

+
+ + + + + +
+

+ + 指数表記 + +

+
+
+

割と多くの言語のゴルフで使えるテクニック。e +を用いた指数表記で、大きな数を短く表す。このコードでは +10000、5000、2000、1000 を指数表記している。

+
+
+
+ + + + + +
+

+ + foreach や for の中身を1つの文に + +

+
+
+

foreach、for、if などの後ろには、通常 { +を続けて複数の文を連ねるが、中身の文を1つにしてしまえば、{ と } +を省略できる。C言語などでも使える。

+
+
+
+ + + + + +
+

+ + $r に初期値を入れない + +

+
+
+

PHP では、$r[] = …​ +のような配列の末尾に追加する式を実行したとき、$r が未定義だった場合は +$r +を勝手に定義して空の配列で初期化してくれる。これを利用すると、$r = []; +のような初期化が不要になる。

+
+
+

ただし、プログラムに 0 が渡されるとループを一度も回らないので、$r +が未定義になってしまい、implode() +に渡すところでエラーになる。それを防ぐために $r ?? [] を使っている。

+
+
+

もし 0 が渡されたケースを無視するなら、これが不要になるので 4 +バイト縮む。

+
+
+
+ + + + + +
+

+ + PHP タグの外に文字列を置く + +

+
+
+

PHP では、<?php ?> +で囲われた部分の外側にある文字列は、そのまま出力される。今回のケースでは、先頭と末尾に必ず +[ と ] を出力するので、そのまま書いてやればよい。

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

+ + おわりに + +

+
+
+

最後になりましたが、https://twitter.com/m3m0r7[めもりー] +さん、楽しい問題をありがとうございました。

+
+
+
+
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/public/posts/2022-08-31/support-for-communty-is-employee-benefits/index.html b/public/posts/2022-08-31/support-for-communty-is-employee-benefits/index.html new file mode 100644 index 0000000..e452599 --- /dev/null +++ b/public/posts/2022-08-31/support-for-communty-is-employee-benefits/index.html @@ -0,0 +1,140 @@ + + + + + + + + + + + 弊社の PHP Foundation への寄付に寄せて | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+
+

弊社の PHP Foundation への寄付に寄せて

+ +
+
+
+

更新履歴

+
    + +
  1. + : 公開 +
    2. + +
+
+ + + + + +
+

+ + はじめに + +

+
+
+

注: +これは私個人の意見であり、所属する組織を代表するものではありません。

+
+
+

先日、私の勤める デジタルサーカス株式会社 が +PHP Foundation へ $2,000 +の寄付をおこないました。

+
+
+

記事: https://www.dgcircus.com/news/581

+
+
+

本件を社内でしつこく推進した1人として、推進の理由等を書き残しておきます。

+
+
+
+ + + + + +
+

+ + なぜ？ + +

+
+
+

組織としての寄付理由は前掲した記事に譲るとして、ここでは、私が社内でこの件を推進した理由について書くことにします。

+
+
+

当時の考えを端的にまとめた社内チャットの投稿があったので、それを引用します:

+
+
+
+
+

結局これを通したい (私の中での) +最大の理由が、「自分の勤める会社が、これをやる会社であってほしい」というのがあり、↑にしても、感情ベースの理由しか出せていないというのが説得力に欠けている理由なのだと思いますが、寄付の報告が流れてきたり、OSS +のフリーライドの話が流れてきたりするたびに、自尊心が毀損される、というか +(これは大袈裟すぎる表現で、実際にはそこまで明確に傷ついているわけではありませんが)。

+
+
+

追記: 「肩身が狭くなる」というのがより適切でした。

+
+
+
+
+

※文中の「↑にしても」は、ここに載せていない別の投稿を指しています。

+
+
+

OSS を金銭的に支援したり、技術カンファレンスへ協賛したり (あるいは +CTO がカンファレンスを年2で主催したり: +iOSDC PHPerKaigi) +といった行為は、コミュニティへの貢献であると同時に、社員に対する精神的福利厚生でもあると言えるでしょう +(知らんけど)。これらは、技術や技術者を大切にする組織である、ということの、対外的にも対内的にも強力なメッセージなのです。

+
+
+

以上が、私が社内で寄付の件を進めた (かなり私的な) 理由です。

+
+
+
+ + + + + +
+

+ + おわりに + +

+
+
+

最終的に社としての寄付まで漕ぎ着けられたのは、もちろん私の力ではなく役員の方々の決定によるものです。この場を借りて感謝申し上げます。

+
+
+
+
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/public/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line/index.html b/public/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line/index.html new file mode 100644 index 0000000..c2dc8ab --- /dev/null +++ b/public/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line/index.html @@ -0,0 +1,929 @@ + + + + + + + + + + + 【PHP】fizzbuzz を書く。1行あたり2文字で。 | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+
+

【PHP】fizzbuzz を書く。1行あたり2文字で。

+ +
    + +
  • + PHP +
    • + +
+ +
+
+
+

更新履歴

+
    + +
  1. + : 公開 +
    2. + +
  2. + : 小さな文言の修正・変更 +
    3. + +
+
+ + + + + +
+

+ + 記事の構成について + +

+
+
+

この記事は、普通の fizzbuzz +を徐々に変形して最終形にしていく、という構成で書かれている。最終形を見てどのような仕組みで動いているのか解読してから解説を読みたい、というかたがいれば、 +このページ +にソースコードがあるので、そちらを先に見てほしい。

+
+
+
+ + + + + +
+

+ + レギュレーション + +

+
+
+

PHP で、次のような制約の下に fizzbuzz を書いた。

+
+
+
    +
  • +

    1行あたりの文字数は2文字までに収めること (ただし <?php タグは除く)

    +
    +
      +
    • +

      厳密な定義: <?php タグ以降のソースコードが、2 byte ごとに +ラインフィード (LF) で区切られること

      +
      • +
    +
    +
    • +
  • +

    スペースやタブを使用しないこと

    +
    • +
  • +

    ループのアンロールをしないこと

    +
    +
      +
    • +

      100 回ループの代わりに 100 回コードをコピペ、というのは禁止

      +
      • +
    +
    +
    • +
  • +

    PHP 7.4〜8.1 で動作すること

    +
    • +
  • +

    実行時に Notice や Warning が出ないこと

    +
    • +
  • +

    標準的なインストール構成の PHP で実現できること +(デフォルトで有効になっていない拡張等を使わないこと)

    +
    • +
+
+
+

備考: PHP には short_open_tag +というオプションがあり、これを有効にするとファイル冒頭の <?php +の代わりに <? +を使うことができ、文字どおり1行2文字で書ける。ただ、このオプションはデフォルト +off になっている環境が多いようなので、今回は使わないことにした。

+
+
+
+ + + + + +
+

+ + 主な障害 + +

+
+
+

1行あたりの文字数など、適当に改行を挟めばいいだけではないのか？

+
+
+

特に、C言語でこのような試みをおこなったことがあるかたならそう思うだろう。事実、Cでのこの制約はほとんど無意味に等しい。

+
+
+
+
#\
+i\
+n\
+c\
+l\
+u\
+d\
+e\
+<\
+s\
+t\
+d\
+i\
+o\
+.\
+h\
+>\
+/*
+*/
+i\
+n\
+t\
+/*
+*/
+m\
+a\
+i\
+n(
+){
+f\
+o\
+r(
+i\
+n\
+t\
+/*
+*/
+i=
+1;
+i<
+1\
+0\
+0;
+i\
++\
++)
+if
+(i
+%\
+15
+==
+0)
+p\
+r\
+i\
+n\
+t\
+f(
+"\
+F\
+i\
+z\
+z\
+B\
+u\
+z\
+z\
+%\
+c\
+",
+10
+);
+
+/* あとは同じように普通のプログラムを変形するだけなので省略 */
+
+
+
+

バックスラッシュを使った行継続がトークンを区切らない、というのがポイントだ。

+
+
+

さて、PHP +ではそもそもバックスラッシュを行継続に使うことができない。これにより、「3文字以上からなるトークンが一切使えない」という制約が課される。例えば、echo +で出力することや、for でループすること、new +でインスタンスを生成することができない。特に、出力は fizzbuzz +をどんなアルゴリズムで実装しようとおこなわなければならないので、できないのは致命的である。

+
+
+

当然、名前が3文字以上ある関数も使えない。なお、標準 PHP +の範囲内において、名前が 2文字以下の関数は以下のとおりである:

+
+
+
    +
  • +

    _: gettext のエイリアス

    +
    • +
  • +

    dl: 拡張モジュールをロードする

    +
    • +
  • +

    pi: 円周率を返す

    +
    • +
+
+
+

(環境によって多少は変わるかも)

+
+
+

2文字の関数を定義しまくった拡張モジュールを用意しておいて dl() +で読み込む行為は、レギュレーションで定めた

+
+
+
+
+
    +
  • +

    標準的なインストール構成の PHP で実現できること +(デフォルトで有効になっていない拡張等を使わないこと)

    +
    • +
+
+
+
+
+

に反する +(というより、「それだとおもしろくもなんともないので、このルールを足した」というのが正しい)。

+
+
+

また、2文字だと文字列がまともに書けないのも辛い。'' だけで +2文字使うので、「1文字の文字列リテラル」というものを書くことができない。PHP +では文字列リテラル中に生の改行が書けるので

+
+
+
+
$a
+='
+a'
+;;
+
+
+
+

とすると $a は "\na" になるのだが、余計な改行が入ってしまう。

+
+
+

これらの障害をどのように乗り越えるのか、次節から見ていく。

+
+
+
+ + + + + +
+

+ + 解説 + +

+
+ + + + + +
+

+ + 普通の (?) fizzbuzz + +

+
+
+

まずは普通に書くとしよう。

+
+
+
+
<?php
+
+for ($i = 1; $i < 100; $i++) {
+  echo (($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n";
+}
+
+
+
+

素直に書いた fizzbuzz +とは言い難いが、このくらいは普通だということにしておかないと、この先がやっていられないので許してほしい。

+
+
+
+ + + + + +
+

+ + for の排除 + +

+
+
+

for +は、3文字もある長いキーワードである。こんなものは使えない。array_ +系の関数を使って、適当に置き換えるとしよう。

+
+
+
+
<?php
+
+$s = range(1, 100);
+array_walk(
+  $s,
+  fn($i) =>
+    printf((($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n"),
+);
+
+
+
+

array_walk や range、printf といった for +よりも長いトークンが現れてしまったが、これは次節で直すことにする。なお、echo +は文 (statement) であり式 (expression) ではないので、式である printf +に置き換えた。

+
+
+
+ + + + + +
+

+ + 関数呼び出しの短縮 + +

+
+
+

range、array_walk、printf +は長すぎるのでどうにかせねばならない。ここで、PHP +の可変関数を使う。可変関数とは、関数名が文字列として入った変数を経由して、関数を呼び出す機能である。

+
+
+
+
<?php
+
+$r = 'range';
+$w = 'array_walk';
+$p = 'printf';
+
+$s = $r(1, 100);
+$w(
+  $s,
+  fn($i) =>
+    $p((($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n"),
+);
+
+
+
+

これで関数を呼び出している所は短くなった。では、$r や $w や +$p、また 'Fizz' や 'Buzz' はどうやって +1行2文字に収めるのか。次のテクニックへ移ろう。

+
+
+
+ + + + + +
+

+ + 余談: PHP 8.x で動作しなくてもいいなら + +

+
+
+

今回使ったテクニックを説明する前に、余談として、文字列リテラルの短縮法として今回採用しなかったものを紹介する。

+
+
+
+
+
    +
  • +

    PHP 7.4〜8.1 で動作すること

    +
    • +
+
+
+
+
+

というルールがない場合、「未定義の定数が評価された場合、その定数の名前が値になる」という +PHP 7.x までの仕様が利用できる。例えば、 Fizz +という文字列が欲しければ、次のようにする。

+
+
+
+
$f
+=F
+.i
+.z
+.z
+;;
+
+
+
+

こうして簡単に文字列を作れる。なお、この仕様は 7.x +時点でも警告を受けるので、@ 演算子を使って抑制してやるとよい。

+
+
+
+
$f
+=@
+F.
+@i
+.#
+@z
+.#
+@z
+;;
+
+
+
+

むしろ、このことがわかっていたからこそ PHP 8.x +での動作を要件に課したところがある。

+
+
+
+ + + + + +
+

+ + 文字列リテラルの短縮 + +

+
+
+

実際に使った手法の説明に移る。

+
+
+

ずばり、文字列同士のビット演算を使う。PHP では、文字列同士でビット演算 +(&、|、^) +をした場合、文字列の各バイトごとに指定したビット演算がなされ、それを結合したものが演算結果となる。

+
+
+
+
$a = "12345";
+$b = "world";
+
+// $a ^ $b は次のコードと同じ
+$result = '';
+for ($i = 0; $i < min(strlen($a), strlen($b)); $i++) {
+  $result .= $a[$i] ^ $b[$i];
+}
+
+echo $result;
+// => F]AXQ
+
+
+
+

これを踏まえ、次のコードを見てみよう。

+
+
+
+
$x = "x\nOm\n";
+$y = "\nk!\no";
+$r = $x ^ $y;
+echo "$r\n";
+
+
+
+

実行すると、range が表示される。さて、PHP +では文字列リテラル中に生の改行を直接書いてもよいのだった +(「主な障害」の節を参照のこと)。書きかえてみよう。

+
+
+
+
$x
+='x
+Om
+';
+$y
+='
+k!
+o'
+;
+
+$r = $x ^ $y;
+echo "$r\n";
+
+
+
+

さらに # を使って適当に調整すると、次のようになる。

+
+
+
+
$x
+=#
+'x
+Om
+';
+$y
+='
+k!
+o'
+;#
+$r
+=#
+$x
+^#
+$y
+;#
+
+echo "$r\n";
+
+
+
+

1行あたり2文字で、range +という文字列を生成することに成功した。他の必要な文字列にも、同様の処理をほどこす。

+
+
+

備考: Buzz 中にある小文字の u は、このロジックだと non-printable +な文字になってしまう。ここまでのテクニックを駆使すれば回避するのはそう難しくないので、考えてみてほしい。

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

+ + 完成系 + +

+
+
+

完成したものがこちら。

+
+
+
+
<?php
+
+$x
+=#
+'i
+S'
+;;
+$y
+='
+b!
+';
+$c
+=#
+$x
+^#
+$y
+;#
+$x
+=#
+'x
+Om
+';
+$y
+='
+k!
+o'
+;#
+$r
+=#
+$x
+^#
+$y
+;#
+$x
+=#
+'k
+Sk
+~}
+Ma
+';
+$y
+='
+x!
+s!
+k!
+';
+$w
+=#
+$x
+^#
+$y
+;#
+$x
+=#
+'z
+Hd
+G'
+;#
+$y
+='
+x!
+~!
+';
+$p
+=#
+$x
+^#
+$y
+;#
+$x
+=#
+'L
+[p
+';
+$y
+='
+c!
+';
+$f
+=#
+$x
+^#
+$y
+;#
+$x
+=#
+'H
+[p
+';
+$y
+='
+_!
+';
+$b
+=#
+$x
+^#
+$y
+;#
+$b
+[1
+]=
+$c
+(#
+13
+*9
+);
+$s
+=#
+$r
+(1
+,(
+10
+**
+2)
+);
+$w
+(#
+$s
+,#
+fn
+(#
+$i
+)#
+=>
+$p
+((
+(#
+$i
+%3
+?#
+''
+:#
+$f
+).
+(#
+$i
+%5
+?#
+''
+:#
+$b
+)?
+:#
+$i
+)#
+.'
+')
+);
+
+
+
+
+ + + + + +
+

+ + 感想など + +

+
+
+

PHP は、スクリプト言語の中だとシンタックスシュガーが少ない +(体感)。この挑戦は不可能に思われたが、PHP +マニュアルとにらめっこしていたらなんとかなった。

+
+
+

みんなもプログラムを細長くしよう。

+
+
+
+ + + + + +
+

+ + 余談2: 別解 + +

+
+
+

PHP では、バッククォートを使ってシェルを呼び出せる。これは shell_exec +関数と等価である。さて、PHP +ではバックスラッシュによる行継続が使えないと書いたが、シェルでは使える +(当然だが、呼び出されるシェルに依存する。Bash +なら大丈夫だろう。知らんけど)。

+
+
+
+
<?php
+
+printf(`
+e\
+c\
+h\
+o\
+ \
+1\
+2\
+3\
+`);
+
+
+
+

なお、ここでは簡単のため出力に printf をそのまま使っているが、実際には +printf という文字列を合成して可変関数で呼び出す。

+
+
+

ただし、これでは

+
+
+
+
+
    +
  • +

    スペースやタブを使用しないこと

    +
    • +
+
+
+
+
+

に違反してしまう。スペースが使えないと引数とコマンドを区切れない。これは困った。

+
+
+

もうこれ以上は不可能だと思っていたのだが、この記事の執筆中に解決する方法を思いついたので載せておく。

+
+
+
+
<?php
+
+$c = 'chr';
+
+${
+'_
+'}
+=#
+$c
+(#
+32
+).
+$c
+(#
+92
+);
+
+printf(`
+e\
+c\
+h\
+o\
+${
+'_
+'}
+1\
+2\
+3\
+`);
+
+
+
+

先程と同じく、chr や printf を生成する部分は長くなるので省いた。

+
+
+
+
${
+'_
+'}
+
+
+
+

は変数で、中にはスペースとエスケープが入っている +(chr(32) . chr(92))。シェルに渡されている文字列は次のようになる。

+
+
+
+
e\
+c\
+h\
+o\
+ \
+1\
+2\
+3\
+
+
+
+

これは、前掲したコマンドと同じだ。かくして、スペースを陽に書かずにシェルをおおよそ自由に扱えるようになった。Fizzbuzz +のワンライナーくらいすぐ書けるだろうから、あとはなんとかなるだろう +(試してないけど)。

+
+
+

ということでこれは別解ということにしておく。

+
+
+

ちなみに、PHP 8.2 からは、この記法で Warning が出るようになるようだ。

+
+
+
+
${
+'_
+'}
+
+
+
+

最新版で警告が出るというのも美しくないので、私としては本編の解法を推す。

+
+
+
+
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/public/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1/index.html b/public/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1/index.html new file mode 100644 index 0000000..efb7239 --- /dev/null +++ b/public/posts/2022-10-23/phperkaigi-2023-unused-token-quiz-1/index.html @@ -0,0 +1,291 @@ + + + + + + + + + + + PHPerKaigi 2023: ボツになったトークン問題 その 1 | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+
+

PHPerKaigi 2023: ボツになったトークン問題 その 1

+ + + +
+
+
+

更新履歴

+
    + +
  1. + : 公開 +
    2. + +
+
+ + + + + +
+

+ + はじめに + +

+
+
+

2023 年 3 月 23 日から 25 日にかけて開催予定 (記事執筆時点) +の、 PHPerKaigi 2023 +において、昨年と同様に、弊社 デジタルサーカス株式会社 +から、トークン問題を出題予定である。

+
+
+

昨年のトークン問題の記事はこちら: +PHPerKaigi 2022 +トークン問題の解説

+
+
+

すでに 2023 +年用の問題は作成済みであるが、その制作過程の中でいくつかボツ問ができた。せっかくなので、PHPerKaigi +開催を待つ間に紹介しようと思う。

+
+
+

10 月から 2 月まで、毎月 1 記事ずつ公開していく予定 (忘れていなければ)。

+
+
+
+ + + + + +
+

+ + 問題 + +

+
+
+

注意: これはボツ問なので、得られたトークンを PHPerKaigi +で入力してもポイントにはならない。

+
+
+
+
<?php
+
+$π = $argv[1] ?? null;
+if ($π === null) {
+  exit('No input.');
+}
+$π = trim($π);
+if (!is_numeric($π)) {
+  exit('Invalid input.');
+}
+
+$s = implode(array_map(chr(...), str_split($π, 2)));
+
+preg_match('/(\x23.+?) /', $s, $m);
+$t = $m[1] ?? '';
+
+if (md5($t) === '056e831a4146bf123e8ea16613303d2e') {
+  echo "Token: {$t}\n";
+} else {
+  echo "Failed.\n";
+}
+
+
+
+
+ + + + + +
+

+ + トークン入手方法 + +

+
+
+

ソースを見るとわかるとおり、$argv[1] を参照している。それを $π +なる変数に代入しているので、円周率を渡してみる。

+
+
+
+
$ php Q.php 3.14
+Failed.
+
+
+
+

失敗してしまった。精度を上げてみる。

+
+
+
+
$ php Q.php 3.1415
+Failed.
+
+
+
+

だめだった。これを成功するまで繰り返す。

+
+
+

最初にトークンが得られるのは、小数点以下 16 +桁目まで入力したときで、こうなる。

+
+
+
+
$ php Q.php 3.1415926535897932
+Token: #YO
+
+
+
+

めでたくトークン「#YO」が手に入った。

+
+
+
+ + + + + +
+

+ + 解説 + +

+
+
+

短いので頭から追っていく。

+
+
+
+
$π = $argv[1] ?? null;
+if ($π === null) {
+  exit('No input.');
+}
+$π = trim($π);
+if (!is_numeric($π)) {
+  exit('Invalid input.');
+}
+
+
+
+

入力のバリデーション部分。数値のみ受け付ける。

+
+
+
+
$s = implode(array_map(chr(...), str_split($π, 2)));
+
+
+
+

$π を 2 文字ごとに区切り (str_split)、数値を ASCII +コードと見做して文字に変換 (chr) して結合 (implode) している。

+
+
+

例えば、$π が '656667' だったとすると、65、66、67 に対応した +'A'、'B'、'C' へと変換され、'ABC' になる。

+
+
+
+
$π = '656667';
+$s = implode(array_map(chr(...), str_split($π, 2)));
+echo $s;
+// => ABC
+
+
+
+
+
preg_match('/(\x23.+?) /', $s, $m);
+$t = $m[1] ?? '';
+
+
+
+

正規表現でマッチングしている。\x23 は # +と同じであることに留意すると、この正規表現は「# から始まる 2 +以上の長さ (含 #) +の文字列で、最初に現れるスペースまで」にマッチする。つまりこれは、PHPerKaigi +におけるトークンである。

+
+
+

なお、# を直接書いていないのは、/#.+?) / と書くと、#.+?) +という意図せぬトークンが登録されてしまうからである。

+
+
+
+
if (md5($t) === '056e831a4146bf123e8ea16613303d2e') {
+  echo "Token: {$t}\n";
+} else {
+  echo "Failed.\n";
+}
+
+
+
+

最後にトークンのハッシュ値を見て、想定解かどうかを確認する。

+
+
+
+ + + + + +
+

+ + おわりに + +

+
+
+

円周率を何桁も計算して ASCII +コード経由で文字列化すれば、トークンっぽいものがどこかで出てくるのではないか、と考えて生まれた作品。

+
+
+

最初は真面目に円周率の計算プログラムを組んでいたのだが、いざ動かしてみるとやけに浅いところにあったので驚いた +(ちなみに、それでも M_PI や pi() +では精度が足りない)。見つけたときは狂喜したものの、冷静になってみると大して面白くなかったのでボツになった。むしろ、100 +万桁目くらいに埋まっていてくれたほうがよかったかもしれない。

+
+
+
+
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/public/posts/2022-10-28/setup-server-for-this-site/index.html b/public/posts/2022-10-28/setup-server-for-this-site/index.html new file mode 100644 index 0000000..c070c03 --- /dev/null +++ b/public/posts/2022-10-28/setup-server-for-this-site/index.html @@ -0,0 +1,630 @@ + + + + + + + + + + + 【備忘録】このサイト用の VPS をセットアップしたときのメモ | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+
+

【備忘録】このサイト用の VPS をセットアップしたときのメモ

+ + + +
+
+
+

更新履歴

+
    + +
  1. + : 公開 +
    2. + +
+
+ + + + + +
+

+ + はじめに + +

+
+
+

これまでこの blog は GitHub Pages でホストしていたのだが、先日 VPS +に移行した。そのときにおこなったサーバのセットアップ作業を書き残しておく。99 +% 自分用の備忘録。別のベンダに移したりしたくなったら見に来る。

+
+
+

未来の自分へ: 特に自動化してないので、せいぜい苦しんでくれ。

+
+
+
+ + + + + +
+

+ + VPS + +

+
+
+

さくらの VPS の 2 GB +プラン。そこまで真面目に選定していないので、困ったら移動するかも。

+
+
+
+ + + + + +
+

+ + 事前準備 + +

+
+ + + + + +
+

+ + サーバのホスト名を決める + +

+
+
+

モチベーションが上がるという効能がある。今回は藤原定家から取って +``teika'' +にした。たいていいつも源氏物語の帖か小倉百人一首の歌人から選んでいる。

+
+
+
+ + + + + +
+

+ + SSH の鍵生成 + +

+
+
+

ローカルマシンで鍵を生成する。

+
+
+
+
$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/teika.key
+$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/github2teika.key
+
+
+
+

teika.key はローカルからサーバへの接続用、github2teika.key +は、GitHub Actions からサーバへのデプロイ用。

+
+
+
+ + + + + +
+

+ + SSH の設定 + +

+
+
+

.ssh/config に設定しておく。

+
+
+
+
Host teika
+    HostName **********
+    User **********
+    Port **********
+    IdentityFile ~/.ssh/teika.key
+
+
+
+
+
+
+ + + + + +
+

+ + 基本のセットアップ + +

+
+ + + + + +
+

+ + SSH 接続 + +

+
+
+

VPS 契約時に設定した管理者ユーザとパスワードを使ってログインする。

+
+
+
+ + + + + +
+

+ + ユーザを作成する + +

+
+
+

管理者ユーザで作業すると危ないので、メインで使うユーザを作成する。sudo +グループに追加して sudo できるようにし、su で切り替え。

+
+
+
+
$ sudo adduser **********
+$ sudo adduser ********** sudo
+$ su **********
+$ cd
+
+
+
+
+ + + + + +
+

+ + ホスト名を変える + +

+
+
+
+
$ sudo hostname teika
+
+
+
+
+ + + + + +
+

+ + 公開鍵を置く + +

+
+
+
+
$ mkdir ~/.ssh
+$ chmod 700 ~/.ssh
+$ vi ~/.ssh/authorized_keys
+
+
+
+

authorized_keys には、ローカルで生成した ~/.ssh/teika.key.pub と +~/.ssh/github2teika.key.pub の内容をコピーする。

+
+
+
+ + + + + +
+

+ + SSH の設定 + +

+
+
+

SSH の設定を変更し、少しでも安全にしておく。

+
+
+
+
$ sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak
+$ sudo vi /etc/ssh/sshd_config
+
+
+
+
    +
  • +

    Port を変更

    +
    • +
  • +

    PermitRootLogin を no に

    +
    • +
  • +

    PasswordAuthentication を no に

    +
    • +
+
+
+

そして設定を反映。

+
+
+
+
$ sudo systemctl restart sshd
+$ sudo systemctl status sshd
+
+
+
+
+ + + + + +
+

+ + SSH で接続確認 + +

+
+
+

今の SSH +セッションは閉じずに、ターミナルを別途開いて疎通確認する。セッションを閉じてしまうと、SSH +の設定に不備があった場合に締め出しをくらう。

+
+
+
+
$ ssh teika
+
+
+
+
+ + + + + +
+

+ + ポートの遮断 + +

+
+
+

デフォルトの 22 番を閉じ、設定したポートだけ空ける。

+
+
+
+
$ sudo ufw deny ssh
+$ sudo ufw allow *******
+$ sudo ufw enable
+$ sudo ufw reload
+$ sudo ufw status
+
+
+
+

ここでもう一度 SSH の接続確認を挟む。

+
+
+
+ + + + + +
+

+ + GitHub 用の SSH 鍵 + +

+
+
+

GitHub に置いてある private リポジトリをサーバから clone したいので、SSH +鍵を生成して置いておく。

+
+
+
+
$ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/github.key
+$ cat ~/.ssh/github.key.pub
+
+
+
+

GitHub の設定画面 +から、この公開鍵を追加する。

+
+
+
+
$ vi ~/.ssh/config
+
+
+
+

設定はこう。

+
+
+
+
Host github.com
+    HostName github.com
+    User git
+    IdentityFile ~/.ssh/github.key
+
+
+
+

最後に接続できるか確認しておく。

+
+
+
+
ssh -T github.com
+
+
+
+
+ + + + + +
+

+ + パッケージの更新 + +

+
+
+
+
$ sudo apt update
+$ sudo apt upgrade
+$ sudo apt update
+$ sudo apt upgrade
+$ sudo apt autoremove
+
+
+
+
+
+
+ + + + + +
+

+ + サイトホスティング用のセットアップ + +

+
+ + + + + +
+

+ + DNS に IP アドレスを登録する + +

+
+
+

このサーバは固定の IP アドレスがあるので、A +レコードに直接入れるだけで済んだ。

+
+
+
+ + + + + +
+

+ + 使うソフトウェアのインストール + +

+
+
+
+
$ sudo apt install docker docker-compose git make
+
+
+
+
+ + + + + +
+

+ + メインユーザが Docker を使えるように + +

+
+
+
+
sudo adduser ********** docker
+
+
+
+
+ + + + + +
+

+ + HTTP/HTTPS を通す + +

+
+
+

80 番と 443 番を空ける。

+
+
+
+
$ sudo ufw allow 80/tcp
+$ sudo ufw allow 443/tcp
+$ sudo ufw reload
+$ sudo ufw status
+
+
+
+
+ + + + + +
+

+ + リポジトリのクローン + +

+
+
+
+
$ cd
+$ git clone git@github.com:nsfisis/nsfisis.dev.git
+$ cd nsfisis.dev
+$ git submodule update --init
+
+
+
+
+ + + + + +
+

+ + certbot で証明書取得 + +

+
+
+
+
$ docker-compose up -d acme-challenge
+$ make setup
+
+
+
+
+ + + + + +
+

+ + サーバを稼動させる + +

+
+
+
+
$ make serve
+
+
+
+
+
+
+ + + + + +
+

+ + 感想 + +

+
+
+

(業務でなく) +個人だと数年ぶりのサーバセットアップで、これだけでも割と時間を食ってしまった。とはいえ式年遷宮は楽しいので、これからも定期的にやっていきたい。コンテナデプロイにしたい気持ちもあるのだが、色々実験したい関係上、本物のサーバも欲しくはある。次の式年遷宮では、手順の一部だけでも自動化したいところ。

+
+
+
+
+
+
+
+ © 2021 nsfisis +
+ + diff --git a/public/posts/index.html b/public/posts/index.html new file mode 100644 index 0000000..029251b --- /dev/null +++ b/public/posts/index.html @@ -0,0 +1,315 @@ + + + + + + + + + + + + + + + + + + + + Posts | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+

Posts

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ © 2021 nsfisis +
+ + diff --git a/public/style.css b/public/style.css new file mode 100644 index 0000000..ef2dea5 --- /dev/null +++ b/public/style.css @@ -0,0 +1,480 @@ +/* + * Paper + * A simple, clean, flexible Hugo theme + * https://github.com/nanxiaobei/hugo-paper + * Designed by MR.LEE (https://mrlee.me/) + * Updated in 2020.6.12 + */ + +/* Theme +-------------------------------------------------- */ +:root { + --gap: 24px; + --content-gap: 40px; + --nav-width: 1024px; + --main-width: 640px; + --header-height: 60px; + --footer-height: 60px; + --radius: 8px; + + --theme: #fff; + --entry: #fff; + --primary: rgba(0, 0, 0, 0.88); + --secondary: rgba(0, 0, 0, 0.56); + --tertiary: rgba(0, 0, 0, 0.16); + --content: rgba(0, 0, 0, 0.88); + + --code-bg: #f5f5f5; + --border: #eee; +} +.list { + background: var(--code-bg); +} +/* Reset +-------------------------------------------------- */ +*, +*::before, +*::after { + box-sizing: border-box; +} +html { + -webkit-tap-highlight-color: transparent; +} +body { + margin: 0; + color: var(--primary); + font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, + 'Open Sans', 'Helvetica Neue', sans-serif; + font-size: 18px; + line-height: 1.8; + word-break: break-word; + background: var(--theme); +} +article, +aside, +figcaption, +figure, +footer, +header, +hgroup, +main, +nav, +section { + display: block; +} +h1, +h2, +h3, +h4, +h5, +h6 { + margin-top: 0; + margin-bottom: 0; + color: var(--primary); + line-height: 1.2; +} +p { + margin-top: 0; + margin-bottom: 0; +} +strong, +b { + font-weight: bold; +} +ul { + margin: 0; + padding: 0; +} +a { + color: var(--primary); + text-decoration: none; +} +figure { + margin: 0; +} +table { + width: 100%; + border-collapse: collapse; + border-spacing: 0; +} +button, +input, +textarea { + padding: 0; + font: inherit; + background: transparent; + border: 0; + -webkit-appearance: none; +} +button, +input[type='button'], +input[type='submit'] { + cursor: pointer; +} +input, +textarea { + padding: 0; + border: 0; + outline: 0; +} +input:-webkit-autofill, +textarea:-webkit-autofill { + box-shadow: 0 0 0 50px var(--theme) inset; +} +img { + display: block; + max-width: 100%; +} +/* Header +-------------------------------------------------- */ +.nav { + display: flex; + flex-wrap: wrap; + justify-content: space-between; + max-width: calc(var(--nav-width) + var(--gap) * 2); + margin-left: auto; + margin-right: auto; +} +.nav a { + display: block; + line-height: var(--header-height); +} +.logo, +.menu { + margin-left: var(--gap); + margin-right: var(--gap); +} +.logo a { + font-size: 24px; + font-weight: 700; +} +.menu { + display: flex; + list-style: none; + word-break: keep-all; + overflow-x: auto; +} +.menu li + li { + margin-left: var(--gap); +} +.menu a { + font-size: 16px; +} +/* Main +-------------------------------------------------- */ +.main { + position: relative; + min-height: calc(100vh - var(--header-height) - var(--footer-height)); + max-width: calc(var(--main-width) + var(--gap) * 2); + margin-left: auto; + margin-right: auto; + padding: var(--gap); +} +.page-header { + margin-bottom: 24px; +} +.page-header h1 { + font-size: 40px; +} +.pagination { + display: flex; +} +.pagination a { + color: var(--theme); + font-size: 13px; + line-height: 36px; + background: var(--primary); + border-radius: calc(36px / 2); +} +.pagination .prev { + padding-left: 16px; + padding-right: 18px; +} +.pagination .next { + margin-left: auto; + padding-left: 18px; + padding-right: 16px; +} +/* Post entry +-------------------------------------------------- */ +.post-entry { + position: relative; + margin-bottom: var(--gap); + padding: var(--gap); + background: var(--entry); + border-radius: var(--radius); + transition: transform 0.1s; +} +.post-entry:active { + transform: scale(0.96); +} +.tag-entry .entry-content, +.tag-entry .entry-footer { + display: none; +} +.entry-header h2 { + font-size: 24px; +} +.entry-content { + margin-top: 8px; + margin-bottom: 8px; + color: var(--secondary); + font-size: 14px; + line-height: 1.6; + overflow: hidden; + display: -webkit-box; + -webkit-box-orient: vertical; + -webkit-line-clamp: 2; +} +.entry-footer { + color: var(--secondary); + font-size: 13px; +} +.entry-link { + position: absolute; + left: 0; + right: 0; + top: 0; + bottom: 0; +} +/* Post single +-------------------------------------------------- */ +.post-header { + margin-top: 24px; + margin-bottom: var(--content-gap); +} +.post-title { + margin-bottom: 2px; + font-size: 40px; + transform: translateX(-2px); +} +.post-meta { + color: var(--secondary); + font-size: 14px; +} +.post-content { + color: var(--content); +} +.post-content h1 { + margin-top: 40px; + margin-bottom: 32px; +} +.post-content h2 { + margin-top: 32px; + margin-bottom: 24px; +} +.post-content h3, +.post-content h4, +.post-content h5, +.post-content h6 { + margin-top: 24px; + margin-bottom: 16px; +} +.post-content h1 { + font-size: 40px; +} +.post-content h2 { + font-size: 32px; +} +.post-content h3 { + font-size: 24px; +} +.post-content h4 { + font-size: 16px; +} +.post-content h5 { + font-size: 14px; +} +.post-content h6 { + font-size: 12px; +} +.post-content a { + box-shadow: 0 1px 0 var(--primary); +} +.post-content a code { + margin-left: 0; + margin-right: 0; + border-radius: 0; + box-shadow: 0 -1px 0 var(--primary) inset; +} +.post-content del { + text-decoration: none; + background: linear-gradient(to right, var(--primary) 100%, transparent 0) 0 50% / 1px 1px repeat-x; +} +.post-content p, +.post-content ul, +.post-content ol, +.post-content dl { + margin-bottom: var(--content-gap); +} +.post-content ul, +.post-content ol { + padding-left: 20px; +} +.post-content li { + margin-top: 5px; +} +.post-content li p { + margin-bottom: 0; +} +.post-content dl { + display: flex; + flex-wrap: wrap; + margin: 0; +} +.post-content dt { + width: 25%; + font-weight: 700; +} +.post-content dd { + width: 75%; + margin-left: 0; + padding-left: 10px; +} +.post-content dt ~ dt, +.post-content dd ~ dd { + margin-top: 10px; +} +.post-content table { + margin-bottom: 32px; +} +.post-content table th, +.post-content table:not(.highlighttable) td { + min-width: 80px; + padding: 12px 8px; + line-height: 1.5; + border-bottom: 1px solid var(--border); +} +.post-content table th { + font-size: 14px; + text-align: left; +} +.post-content table:not(.highlighttable) td code:only-child { + margin-left: 0; + margin-right: 0; +} +.post-content .highlight, +.post-content pre { + margin-left: calc(var(--gap) * -1); + margin-right: calc(var(--gap) * -1); + margin-bottom: 32px; + border-radius: var(--radius); + overflow-x: auto; +} +.post-content ul pre { + margin-left: calc(var(--gap) * -2); +} +.post-content .highlight pre { + margin: 0; +} +/* table */ +.post-content .highlighttable { + table-layout: fixed; +} +.post-content .highlighttable td:first-child { + width: 40px; +} +.post-content .highlighttable td .linenodiv { + padding-right: 0 !important; +} +.post-content .highlighttable td .linenodiv pre, +.post-content .highlighttable td .highlight { + margin-bottom: 0; +} +.post-content .highlighttable td .highlight pre code::-webkit-scrollbar { + display: none; +} +/* inline */ +.post-content .highlight span { + background: transparent !important; +} + +.post-content code { + margin-left: 4px; + margin-right: 4px; + padding: 4px 6px; + font-family: Menlo, Monaco, 'Courier New', Courier, monospace; + font-size: 0.78em; + line-height: 1.5; + background: var(--code-bg); + border-radius: 2px; +} +.post-content pre code { + display: block; + margin-left: 0; + margin-right: 0; + padding: var(--gap); + background: transparent; + border-radius: 0; +} +.post-content blockquote { + margin: 0 0 0 calc(var(--gap) * -1); + padding: 0 0 0 21px; + border-left: 3px solid var(--primary); +} +.post-content hr { + height: 1px; + margin-top: 56px; + margin-bottom: 56px; + background: var(--tertiary); + border-top: 0; + border-bottom: 0; +} +.post-content iframe { + max-width: 100%; +} +.post-tags li { + display: inline-block; +} +.post-tags li + li { + margin-left: 3px; +} +.post-tags a { + display: block; + padding-left: 14px; + padding-right: 14px; + color: var(--secondary); + font-size: 14px; + line-height: 34px; + background: var(--code-bg); + border-radius: 4px; +} +.post-tags a:hover { + background: var(--border); +} +/* Footer +-------------------------------------------------- */ +.footer { + max-width: calc(var(--main-width) + var(--gap) * 2); + margin-left: auto; + margin-right: auto; + padding: calc((var(--footer-height) - var(--gap)) / 2) var(--gap); + color: var(--secondary); + font-size: 12px; + text-align: center; + line-height: 24px; +} +.footer span { + margin-left: 1px; + margin-right: 1px; +} +.footer a { + color: inherit; +} +.footer a:hover { + color: var(--primary); + border-bottom: 1px solid var(--primary); +} +/* 404 +-------------------------------------------------- */ +.not-found { + position: absolute; + left: 0; + right: 0; + display: flex; + align-items: center; + justify-content: center; + height: 80%; + font-size: 160px; + font-weight: 700; +} diff --git a/public/tags/conference/index.html b/public/tags/conference/index.html new file mode 100644 index 0000000..4423eee --- /dev/null +++ b/public/tags/conference/index.html @@ -0,0 +1,107 @@ + + + + + + + + + + + + + + + + + + + + カンファレンス | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+

カンファレンス

+
+ + + + + + + + + +
+
+ © 2021 nsfisis +
+ + diff --git a/public/tags/cpp/index.html b/public/tags/cpp/index.html new file mode 100644 index 0000000..5cc157b --- /dev/null +++ b/public/tags/cpp/index.html @@ -0,0 +1,59 @@ + + + + + + + + + + + + + + + + + + + + C++ | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+

C++

+
+ + + +
+
+ © 2021 nsfisis +
+ + diff --git a/public/tags/cpp17/index.html b/public/tags/cpp17/index.html new file mode 100644 index 0000000..5585a26 --- /dev/null +++ b/public/tags/cpp17/index.html @@ -0,0 +1,59 @@ + + + + + + + + + + + + + + + + + + + + C++ 17 | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+

C++ 17

+
+ + + +
+
+ © 2021 nsfisis +
+ + diff --git a/public/tags/note-to-self/index.html b/public/tags/note-to-self/index.html new file mode 100644 index 0000000..4cdabd6 --- /dev/null +++ b/public/tags/note-to-self/index.html @@ -0,0 +1,59 @@ + + + + + + + + + + + + + + + + + + + + 備忘録 | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+

備忘録

+
+ + + +
+
+ © 2021 nsfisis +
+ + diff --git a/public/tags/php/index.html b/public/tags/php/index.html new file mode 100644 index 0000000..cd9a853 --- /dev/null +++ b/public/tags/php/index.html @@ -0,0 +1,139 @@ + + + + + + + + + + + + + + + + + + + + PHP | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+

PHP

+
+ + + + + + + + + + + + + +
+
+ © 2021 nsfisis +
+ + diff --git a/public/tags/phpcon/index.html b/public/tags/phpcon/index.html new file mode 100644 index 0000000..45fe74f --- /dev/null +++ b/public/tags/phpcon/index.html @@ -0,0 +1,59 @@ + + + + + + + + + + + + + + + + + + + + PHP カンファレンス | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+

PHP カンファレンス

+
+ + + +
+
+ © 2021 nsfisis +
+ + diff --git a/public/tags/phperkaigi/index.html b/public/tags/phperkaigi/index.html new file mode 100644 index 0000000..e59c245 --- /dev/null +++ b/public/tags/phperkaigi/index.html @@ -0,0 +1,107 @@ + + + + + + + + + + + + + + + + + + + + PHPerKaigi | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+

PHPerKaigi

+
+ + + + + + + + + +
+
+ © 2021 nsfisis +
+ + diff --git a/public/tags/python/index.html b/public/tags/python/index.html new file mode 100644 index 0000000..b15dfb6 --- /dev/null +++ b/public/tags/python/index.html @@ -0,0 +1,59 @@ + + + + + + + + + + + + + + + + + + + + Python | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+

Python

+
+ + + +
+
+ © 2021 nsfisis +
+ + diff --git a/public/tags/python3/index.html b/public/tags/python3/index.html new file mode 100644 index 0000000..2824a04 --- /dev/null +++ b/public/tags/python3/index.html @@ -0,0 +1,59 @@ + + + + + + + + + + + + + + + + + + + + Python 3 | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+

Python 3

+
+ + + +
+
+ © 2021 nsfisis +
+ + diff --git a/public/tags/ruby/index.html b/public/tags/ruby/index.html new file mode 100644 index 0000000..40c7b4f --- /dev/null +++ b/public/tags/ruby/index.html @@ -0,0 +1,75 @@ + + + + + + + + + + + + + + + + + + + + Ruby | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+

Ruby

+
+ + + + + +
+
+ © 2021 nsfisis +
+ + diff --git a/public/tags/ruby3/index.html b/public/tags/ruby3/index.html new file mode 100644 index 0000000..47a47b7 --- /dev/null +++ b/public/tags/ruby3/index.html @@ -0,0 +1,59 @@ + + + + + + + + + + + + + + + + + + + + Ruby 3 | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+

Ruby 3

+
+ + + +
+
+ © 2021 nsfisis +
+ + diff --git a/public/tags/rust/index.html b/public/tags/rust/index.html new file mode 100644 index 0000000..da5efee --- /dev/null +++ b/public/tags/rust/index.html @@ -0,0 +1,59 @@ + + + + + + + + + + + + + + + + + + + + Rust | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+

Rust

+
+ + + +
+
+ © 2021 nsfisis +
+ + diff --git a/public/tags/vim/index.html b/public/tags/vim/index.html new file mode 100644 index 0000000..e76b079 --- /dev/null +++ b/public/tags/vim/index.html @@ -0,0 +1,75 @@ + + + + + + + + + + + + + + + + + + + + Vim | REPL: Rest-Eat-Program Loop + + + + + +
+ +
+
+
+

Vim

+
+ + + + + +
+
+ © 2021 nsfisis +
+ + diff --git a/static/custom.css b/static/custom.css new file mode 100644 index 0000000..d3b1672 --- /dev/null +++ b/static/custom.css @@ -0,0 +1,29 @@ +/* Place a custom css file in your own project to use this. */ +.post-content h1, +.post-content h2, +.post-content h3, +.post-content h4, +.post-content h5, +.post-content h6 { + border-bottom: var(--primary) solid 1px; +} + +.post-content h1::before, +.post-content h2::before, +.post-content h3::before, +.post-content h4::before, +.post-content h5::before, +.post-content h6::before { + color: var(--secondary); + padding-right: 0.3rem; +} + +.post-content h2::before { content: '#'; } +.post-content h3::before { content: '##'; } +.post-content h4::before { content: '###'; } +.post-content h5::before { content: '####'; } +.post-content h6::before { content: '#####'; } + +li.revision { + list-style: inside; +} diff --git a/static/favicon.svg b/static/favicon.svg new file mode 100644 index 0000000..d122ea1 --- /dev/null +++ b/static/favicon.svg @@ -0,0 +1,62 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/static/hl.css b/static/hl.css new file mode 100644 index 0000000..fabe9de --- /dev/null +++ b/static/hl.css @@ -0,0 +1,214 @@ +/* ruby -rrouge -e 'puts Rouge::Themes::Github.render(scope: ".highlight")' */ +.highlight table td { padding: 5px; } +.highlight table pre { margin: 0; } +.highlight .cm { + color: #999988; + font-style: italic; +} +.highlight .cp { + color: #999999; + font-weight: bold; +} +.highlight .c1 { + color: #999988; + font-style: italic; +} +.highlight .cs { + color: #999999; + font-weight: bold; + font-style: italic; +} +.highlight .c, .highlight .ch, .highlight .cd, .highlight .cpf { + color: #999988; + font-style: italic; +} +.highlight .err { + color: #a61717; + background-color: #e3d2d2; +} +.highlight .gd { + color: #000000; + background-color: #ffdddd; +} +.highlight .ge { + color: #000000; + font-style: italic; +} +.highlight .gr { + color: #aa0000; +} +.highlight .gh { + color: #999999; +} +.highlight .gi { + color: #000000; + background-color: #ddffdd; +} +.highlight .go { + color: #888888; +} +.highlight .gp { + color: #555555; +} +.highlight .gs { + font-weight: bold; +} +.highlight .gu { + color: #aaaaaa; +} +.highlight .gt { + color: #aa0000; +} +.highlight .kc { + color: #000000; + font-weight: bold; +} +.highlight .kd { + color: #000000; + font-weight: bold; +} +.highlight .kn { + color: #000000; + font-weight: bold; +} +.highlight .kp { + color: #000000; + font-weight: bold; +} +.highlight .kr { + color: #000000; + font-weight: bold; +} +.highlight .kt { + color: #445588; + font-weight: bold; +} +.highlight .k, .highlight .kv { + color: #000000; + font-weight: bold; +} +.highlight .mf { + color: #009999; +} +.highlight .mh { + color: #009999; +} +.highlight .il { + color: #009999; +} +.highlight .mi { + color: #009999; +} +.highlight .mo { + color: #009999; +} +.highlight .m, .highlight .mb, .highlight .mx { + color: #009999; +} +.highlight .sa { + color: #000000; + font-weight: bold; +} +.highlight .sb { + color: #d14; +} +.highlight .sc { + color: #d14; +} +.highlight .sd { + color: #d14; +} +.highlight .s2 { + color: #d14; +} +.highlight .se { + color: #d14; +} +.highlight .sh { + color: #d14; +} +.highlight .si { + color: #d14; +} +.highlight .sx { + color: #d14; +} +.highlight .sr { + color: #009926; +} +.highlight .s1 { + color: #d14; +} +.highlight .ss { + color: #990073; +} +.highlight .s, .highlight .dl { + color: #d14; +} +.highlight .na { + color: #008080; +} +.highlight .bp { + color: #999999; +} +.highlight .nb { + color: #0086B3; +} +.highlight .nc { + color: #445588; + font-weight: bold; +} +.highlight .no { + color: #008080; +} +.highlight .nd { + color: #3c5d5d; + font-weight: bold; +} +.highlight .ni { + color: #800080; +} +.highlight .ne { + color: #990000; + font-weight: bold; +} +.highlight .nf, .highlight .fm { + color: #990000; + font-weight: bold; +} +.highlight .nl { + color: #990000; + font-weight: bold; +} +.highlight .nn { + color: #555555; +} +.highlight .nt { + color: #000080; +} +.highlight .vc { + color: #008080; +} +.highlight .vg { + color: #008080; +} +.highlight .vi { + color: #008080; +} +.highlight .nv, .highlight .vm { + color: #008080; +} +.highlight .ow { + color: #000000; + font-weight: bold; +} +.highlight .o { + color: #000000; + font-weight: bold; +} +.highlight .w { + color: #bbbbbb; +} +.highlight { + background-color: #f8f8f8; +} \ No newline at end of file diff --git a/static/style.css b/static/style.css new file mode 100644 index 0000000..ef2dea5 --- /dev/null +++ b/static/style.css @@ -0,0 +1,480 @@ +/* + * Paper + * A simple, clean, flexible Hugo theme + * https://github.com/nanxiaobei/hugo-paper + * Designed by MR.LEE (https://mrlee.me/) + * Updated in 2020.6.12 + */ + +/* Theme +-------------------------------------------------- */ +:root { + --gap: 24px; + --content-gap: 40px; + --nav-width: 1024px; + --main-width: 640px; + --header-height: 60px; + --footer-height: 60px; + --radius: 8px; + + --theme: #fff; + --entry: #fff; + --primary: rgba(0, 0, 0, 0.88); + --secondary: rgba(0, 0, 0, 0.56); + --tertiary: rgba(0, 0, 0, 0.16); + --content: rgba(0, 0, 0, 0.88); + + --code-bg: #f5f5f5; + --border: #eee; +} +.list { + background: var(--code-bg); +} +/* Reset +-------------------------------------------------- */ +*, +*::before, +*::after { + box-sizing: border-box; +} +html { + -webkit-tap-highlight-color: transparent; +} +body { + margin: 0; + color: var(--primary); + font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, + 'Open Sans', 'Helvetica Neue', sans-serif; + font-size: 18px; + line-height: 1.8; + word-break: break-word; + background: var(--theme); +} +article, +aside, +figcaption, +figure, +footer, +header, +hgroup, +main, +nav, +section { + display: block; +} +h1, +h2, +h3, +h4, +h5, +h6 { + margin-top: 0; + margin-bottom: 0; + color: var(--primary); + line-height: 1.2; +} +p { + margin-top: 0; + margin-bottom: 0; +} +strong, +b { + font-weight: bold; +} +ul { + margin: 0; + padding: 0; +} +a { + color: var(--primary); + text-decoration: none; +} +figure { + margin: 0; +} +table { + width: 100%; + border-collapse: collapse; + border-spacing: 0; +} +button, +input, +textarea { + padding: 0; + font: inherit; + background: transparent; + border: 0; + -webkit-appearance: none; +} +button, +input[type='button'], +input[type='submit'] { + cursor: pointer; +} +input, +textarea { + padding: 0; + border: 0; + outline: 0; +} +input:-webkit-autofill, +textarea:-webkit-autofill { + box-shadow: 0 0 0 50px var(--theme) inset; +} +img { + display: block; + max-width: 100%; +} +/* Header +-------------------------------------------------- */ +.nav { + display: flex; + flex-wrap: wrap; + justify-content: space-between; + max-width: calc(var(--nav-width) + var(--gap) * 2); + margin-left: auto; + margin-right: auto; +} +.nav a { + display: block; + line-height: var(--header-height); +} +.logo, +.menu { + margin-left: var(--gap); + margin-right: var(--gap); +} +.logo a { + font-size: 24px; + font-weight: 700; +} +.menu { + display: flex; + list-style: none; + word-break: keep-all; + overflow-x: auto; +} +.menu li + li { + margin-left: var(--gap); +} +.menu a { + font-size: 16px; +} +/* Main +-------------------------------------------------- */ +.main { + position: relative; + min-height: calc(100vh - var(--header-height) - var(--footer-height)); + max-width: calc(var(--main-width) + var(--gap) * 2); + margin-left: auto; + margin-right: auto; + padding: var(--gap); +} +.page-header { + margin-bottom: 24px; +} +.page-header h1 { + font-size: 40px; +} +.pagination { + display: flex; +} +.pagination a { + color: var(--theme); + font-size: 13px; + line-height: 36px; + background: var(--primary); + border-radius: calc(36px / 2); +} +.pagination .prev { + padding-left: 16px; + padding-right: 18px; +} +.pagination .next { + margin-left: auto; + padding-left: 18px; + padding-right: 16px; +} +/* Post entry +-------------------------------------------------- */ +.post-entry { + position: relative; + margin-bottom: var(--gap); + padding: var(--gap); + background: var(--entry); + border-radius: var(--radius); + transition: transform 0.1s; +} +.post-entry:active { + transform: scale(0.96); +} +.tag-entry .entry-content, +.tag-entry .entry-footer { + display: none; +} +.entry-header h2 { + font-size: 24px; +} +.entry-content { + margin-top: 8px; + margin-bottom: 8px; + color: var(--secondary); + font-size: 14px; + line-height: 1.6; + overflow: hidden; + display: -webkit-box; + -webkit-box-orient: vertical; + -webkit-line-clamp: 2; +} +.entry-footer { + color: var(--secondary); + font-size: 13px; +} +.entry-link { + position: absolute; + left: 0; + right: 0; + top: 0; + bottom: 0; +} +/* Post single +-------------------------------------------------- */ +.post-header { + margin-top: 24px; + margin-bottom: var(--content-gap); +} +.post-title { + margin-bottom: 2px; + font-size: 40px; + transform: translateX(-2px); +} +.post-meta { + color: var(--secondary); + font-size: 14px; +} +.post-content { + color: var(--content); +} +.post-content h1 { + margin-top: 40px; + margin-bottom: 32px; +} +.post-content h2 { + margin-top: 32px; + margin-bottom: 24px; +} +.post-content h3, +.post-content h4, +.post-content h5, +.post-content h6 { + margin-top: 24px; + margin-bottom: 16px; +} +.post-content h1 { + font-size: 40px; +} +.post-content h2 { + font-size: 32px; +} +.post-content h3 { + font-size: 24px; +} +.post-content h4 { + font-size: 16px; +} +.post-content h5 { + font-size: 14px; +} +.post-content h6 { + font-size: 12px; +} +.post-content a { + box-shadow: 0 1px 0 var(--primary); +} +.post-content a code { + margin-left: 0; + margin-right: 0; + border-radius: 0; + box-shadow: 0 -1px 0 var(--primary) inset; +} +.post-content del { + text-decoration: none; + background: linear-gradient(to right, var(--primary) 100%, transparent 0) 0 50% / 1px 1px repeat-x; +} +.post-content p, +.post-content ul, +.post-content ol, +.post-content dl { + margin-bottom: var(--content-gap); +} +.post-content ul, +.post-content ol { + padding-left: 20px; +} +.post-content li { + margin-top: 5px; +} +.post-content li p { + margin-bottom: 0; +} +.post-content dl { + display: flex; + flex-wrap: wrap; + margin: 0; +} +.post-content dt { + width: 25%; + font-weight: 700; +} +.post-content dd { + width: 75%; + margin-left: 0; + padding-left: 10px; +} +.post-content dt ~ dt, +.post-content dd ~ dd { + margin-top: 10px; +} +.post-content table { + margin-bottom: 32px; +} +.post-content table th, +.post-content table:not(.highlighttable) td { + min-width: 80px; + padding: 12px 8px; + line-height: 1.5; + border-bottom: 1px solid var(--border); +} +.post-content table th { + font-size: 14px; + text-align: left; +} +.post-content table:not(.highlighttable) td code:only-child { + margin-left: 0; + margin-right: 0; +} +.post-content .highlight, +.post-content pre { + margin-left: calc(var(--gap) * -1); + margin-right: calc(var(--gap) * -1); + margin-bottom: 32px; + border-radius: var(--radius); + overflow-x: auto; +} +.post-content ul pre { + margin-left: calc(var(--gap) * -2); +} +.post-content .highlight pre { + margin: 0; +} +/* table */ +.post-content .highlighttable { + table-layout: fixed; +} +.post-content .highlighttable td:first-child { + width: 40px; +} +.post-content .highlighttable td .linenodiv { + padding-right: 0 !important; +} +.post-content .highlighttable td .linenodiv pre, +.post-content .highlighttable td .highlight { + margin-bottom: 0; +} +.post-content .highlighttable td .highlight pre code::-webkit-scrollbar { + display: none; +} +/* inline */ +.post-content .highlight span { + background: transparent !important; +} + +.post-content code { + margin-left: 4px; + margin-right: 4px; + padding: 4px 6px; + font-family: Menlo, Monaco, 'Courier New', Courier, monospace; + font-size: 0.78em; + line-height: 1.5; + background: var(--code-bg); + border-radius: 2px; +} +.post-content pre code { + display: block; + margin-left: 0; + margin-right: 0; + padding: var(--gap); + background: transparent; + border-radius: 0; +} +.post-content blockquote { + margin: 0 0 0 calc(var(--gap) * -1); + padding: 0 0 0 21px; + border-left: 3px solid var(--primary); +} +.post-content hr { + height: 1px; + margin-top: 56px; + margin-bottom: 56px; + background: var(--tertiary); + border-top: 0; + border-bottom: 0; +} +.post-content iframe { + max-width: 100%; +} +.post-tags li { + display: inline-block; +} +.post-tags li + li { + margin-left: 3px; +} +.post-tags a { + display: block; + padding-left: 14px; + padding-right: 14px; + color: var(--secondary); + font-size: 14px; + line-height: 34px; + background: var(--code-bg); + border-radius: 4px; +} +.post-tags a:hover { + background: var(--border); +} +/* Footer +-------------------------------------------------- */ +.footer { + max-width: calc(var(--main-width) + var(--gap) * 2); + margin-left: auto; + margin-right: auto; + padding: calc((var(--footer-height) - var(--gap)) / 2) var(--gap); + color: var(--secondary); + font-size: 12px; + text-align: center; + line-height: 24px; +} +.footer span { + margin-left: 1px; + margin-right: 1px; +} +.footer a { + color: inherit; +} +.footer a:hover { + color: var(--primary); + border-bottom: 1px solid var(--primary); +} +/* 404 +-------------------------------------------------- */ +.not-found { + position: absolute; + left: 0; + right: 0; + display: flex; + align-items: center; + justify-content: center; + height: 80%; + font-size: 160px; + font-weight: 700; +} diff --git a/templates/document.html.erb b/templates/document.html.erb new file mode 100644 index 0000000..9d93696 --- /dev/null +++ b/templates/document.html.erb @@ -0,0 +1,69 @@ +<% _main_stylesheet = '/style.css' %> +<% _author = attr 'author' %> +<% _description = attr 'description' %> +<% _lang = attr 'lang' %> +<% _site_copyright_year = attr 'site-copyright-year' %> +<% _copyright_year = attr 'copyright-year' %> +<% _revisions = attr 'revision-history' %> +<% _site_name = attr 'site-name' %> +<% _tags = attr 'tags' %> +<% _doctitle = doctitle %> +<% _header_title = header.title %> +<% _content = content %> + + + + + + + + + + + <%= _doctitle %> | <%= _site_name %> + + + + + +
+ +
+
+
+
+

<%= _header_title %>

+ <% if not _tags.empty? %> + + <% end %> +
+
+
+

更新履歴

+
    + <% for revision in _revisions %> +
  1. + : <%= revision.remark %> +
    2. + <% end %> +
+
+ <%= _content %> +
+
+
+
+ © <%= _site_copyright_year %> <%= _author %> +
+ + diff --git a/templates/feed.xml.erb b/templates/feed.xml.erb new file mode 100644 index 0000000..7ebd1ba --- /dev/null +++ b/templates/feed.xml.erb @@ -0,0 +1,27 @@ +<% _feed_title = feed_title %> +<% _link = link %> +<% _description = description %> +<% _lang = lang %> +<% _last_build_date = last_build_date %> +<% _feed_link = feed_link %> +<% _posts = posts %> + + + + <%= _feed_title %> + <%= _link %> + <%= _description %> + <%= _lang %> + <%= _last_build_date %> + + <% for post in _posts %> + + <%= post.title %> + <%= post.href %> + <%= post.updated_on %> + <%= post.href %> + ]]> + + <% end %> + + diff --git a/templates/posts_list.html.erb b/templates/posts_list.html.erb new file mode 100644 index 0000000..2227241 --- /dev/null +++ b/templates/posts_list.html.erb @@ -0,0 +1,59 @@ +<% _main_stylesheet = '/style.css' %> +<% _author = author %> +<% _description = description %> +<% _lang = lang %> +<% _site_copyright_year = site_copyright_year %> +<% _copyright_year = copyright_year %> +<% _site_name = site_name %> +<% _doctitle = doctitle %> +<% _header_title = header_title %> +<% _posts = posts %> + + + + + + + + + + <%= _doctitle %> | <%= _site_name %> + + + + + +
+ +
+
+
+

<%= _header_title %>

+
+ <% for post in _posts %> + + <% end %> +
+
+ © <%= _site_copyright_year %> <%= _author %> +
+ + diff --git a/templates/section.html.erb b/templates/section.html.erb new file mode 100644 index 0000000..1510595 --- /dev/null +++ b/templates/section.html.erb @@ -0,0 +1,19 @@ +<% _level = level %> +<% _role = role %> +<% _id = id %> +<% _title = caption ? captioned_title : title %> +<% _content = content %> +
"> + id="<%= _id %>" class="section-header"> + <% if _id %> + + <%= _title %> + + <% else %> + <%= _title %> + <% end %> + > +
+ <%= _content %> +
+
diff --git a/templates/sitemap.xml.erb b/templates/sitemap.xml.erb new file mode 100644 index 0000000..304b1c6 --- /dev/null +++ b/templates/sitemap.xml.erb @@ -0,0 +1,11 @@ +<% _base_url = base_url %> +<% _pages = pages %> + + + <% for page in _pages %> + + <%= _base_url %><%= page.href %> + <%= page.updated_on %> + + <% end %> + diff --git a/templates/tag.html.erb b/templates/tag.html.erb new file mode 100644 index 0000000..7fd23cd --- /dev/null +++ b/templates/tag.html.erb @@ -0,0 +1,59 @@ +<% _main_stylesheet = '/style.css' %> +<% _author = author %> +<% _description = description %> +<% _lang = lang %> +<% _site_copyright_year = site_copyright_year %> +<% _copyright_year = copyright_year %> +<% _site_name = site_name %> +<% _doctitle = tag.label %> +<% _header_title = tag.label %> +<% _posts = posts %> + + + + + + + + + + <%= _doctitle %> | <%= _site_name %> + + + + + +
+ +
+
+
+

<%= _header_title %>

+
+ <% for post in _posts %> + + <% end %> +
+
+ © <%= _site_copyright_year %> <%= _author %> +
+ + diff --git a/themes/mypaper/LICENSE b/themes/mypaper/LICENSE deleted file mode 100644 index 415f6f2..0000000 --- a/themes/mypaper/LICENSE +++ /dev/null @@ -1,22 +0,0 @@ -MIT License - -Copyright (c) 2020 nanxiaobei -Copyright (c) 2022 nsfisis - -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. diff --git a/themes/mypaper/README.md b/themes/mypaper/README.md deleted file mode 100644 index a90ab3d..0000000 --- a/themes/mypaper/README.md +++ /dev/null @@ -1 +0,0 @@ -This is my modified version of [paper](https://github.com/nanxiaobei/hugo-paper/) theme. diff --git a/themes/mypaper/i18n/ja.yaml b/themes/mypaper/i18n/ja.yaml deleted file mode 100644 index 30b412d..0000000 --- a/themes/mypaper/i18n/ja.yaml +++ /dev/null @@ -1,5 +0,0 @@ -- id: prev_page - translation: "前のページ" - -- id: next_page - translation: "次のページ" diff --git a/themes/mypaper/layouts/404.html b/themes/mypaper/layouts/404.html deleted file mode 100644 index ab966ff..0000000 --- a/themes/mypaper/layouts/404.html +++ /dev/null @@ -1,3 +0,0 @@ -{{- partial "header.html" . }} -
404
-{{- partial "footer.html" . }} diff --git a/themes/mypaper/layouts/_default/list.html b/themes/mypaper/layouts/_default/list.html deleted file mode 100644 index 053951f..0000000 --- a/themes/mypaper/layouts/_default/list.html +++ /dev/null @@ -1,45 +0,0 @@ -{{- partial "header.html" . }} - -{{- $scope := .Site }} -{{- if .Title }} -

{{ .Title }}

{{ $scope = . }} -{{ end }} - -{{- $paginator := .Paginate (where $scope.RegularPages ".Params.type" "!=" "page") }} - -{{- range $index, $page := $paginator.Pages }} - -{{- $class := "post-entry" }} -{{- if .Data.Term }} -{{- $class = "post-entry tag-entry" }} -{{- end }} -
-
-

{{ .Title }}

-
-
-

{{ .Summary | plainify | htmlUnescape }}

-
-
- {{- $date := .Date.Format "2006-01-02" }} - {{- $lastmod := .Lastmod.Format "2006-01-02" }} - Posted on {{ if ne $date $lastmod }}, updated on {{ end }} -
- -
-{{- end }} - -{{- if gt $paginator.TotalPages 1 }} - -{{- end }} - -{{- partial "footer.html" . }} diff --git a/themes/mypaper/layouts/_default/rss.xml b/themes/mypaper/layouts/_default/rss.xml deleted file mode 100644 index 8626dca..0000000 --- a/themes/mypaper/layouts/_default/rss.xml +++ /dev/null @@ -1,39 +0,0 @@ -{{- $pctx := . -}} -{{- if .IsHome -}}{{ $pctx = .Site }}{{- end -}} -{{- $pages := slice -}} -{{- if or $.IsHome $.IsSection -}} -{{- $pages = $pctx.RegularPages -}} -{{- else -}} -{{- $pages = $pctx.Pages -}} -{{- end -}} -{{- $limit := .Site.Config.Services.RSS.Limit -}} -{{- if ge $limit 1 -}} -{{- $pages = $pages | first $limit -}} -{{- end -}} -{{- printf "" | safeHTML }} - - - {{ if eq .Title .Site.Title }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{.}} on {{ end }}{{ .Site.Title }}{{ end }} - {{ .Permalink }} - Recent content {{ if ne .Title .Site.Title }}{{ with .Title }}in {{.}} {{ end }}{{ end }}on {{ .Site.Title }} - Hugo -- gohugo.io{{ with .Site.LanguageCode }} - {{.}}{{end}}{{ with .Site.Author.email }} - {{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}{{end}}{{ with .Site.Author.email }} - {{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}{{end}}{{ with .Site.Copyright }} - {{.}}{{end}}{{ if not .Date.IsZero }} - {{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}{{ end }} - {{- with .OutputFormats.Get "RSS" -}} - {{ printf "" .Permalink .MediaType | safeHTML }} - {{- end -}} - {{ range $pages }} - - {{ .Title }} - {{ .Permalink }} - {{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }} - {{ with .Site.Author.email }}{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}{{end}} - {{ .Permalink }} - {{ " - - {{ end }} - - diff --git a/themes/mypaper/layouts/_default/single.html b/themes/mypaper/layouts/_default/single.html deleted file mode 100644 index 2156f37..0000000 --- a/themes/mypaper/layouts/_default/single.html +++ /dev/null @@ -1,30 +0,0 @@ -{{- partial "header.html" . }} - -
-
-

{{ .Title }}

- {{- if .Params.tags }} -
    - {{- range .Params.tags }} - {{- $href := print (absURL "tags/") (urlize .) }} -
  • {{ . }}
    • - {{- end }} -
- {{- end }} -
-
- {{- if .Params.changelog }} -
-

更新履歴

-
    - {{- range $date, $remark := .Params.changelog }} -
  • {{ $date }}: {{ $remark }}
    • - {{- end }} -
-
- {{- end }} - {{ .Content }} -
-
- -{{- partial "footer.html" . }} diff --git a/themes/mypaper/layouts/partials/footer.html b/themes/mypaper/layouts/partials/footer.html deleted file mode 100644 index a7798d7..0000000 --- a/themes/mypaper/layouts/partials/footer.html +++ /dev/null @@ -1,12 +0,0 @@ - - - - - - diff --git a/themes/mypaper/layouts/partials/header.html b/themes/mypaper/layouts/partials/header.html deleted file mode 100644 index 830acd5..0000000 --- a/themes/mypaper/layouts/partials/header.html +++ /dev/null @@ -1,54 +0,0 @@ - - - - - - - - {{ if .Title }}{{ .Title }} | {{ end }}{{ .Site.Title }} - - {{- if eq .Kind "page" }} - - - {{- else }} - - - {{- end }} - - - - - - - - {{- hugo.Generator }} - - {{ range .AlternativeOutputFormats -}} - {{ printf `` .Rel .MediaType.Type .Permalink $.Site.Title | safeHTML }} - {{ end -}} - - {{- if eq (getenv "HUGO_ENV") "production" | or (eq .Site.Params.env "production") }} - {{- template "_internal/google_analytics_async.html" . }} - {{- template "_internal/opengraph.html" . }} - {{- end }} - - -
- -
-
diff --git a/themes/mypaper/layouts/shortcodes/collapse.html b/themes/mypaper/layouts/shortcodes/collapse.html deleted file mode 100644 index b92ad01..0000000 --- a/themes/mypaper/layouts/shortcodes/collapse.html +++ /dev/null @@ -1,12 +0,0 @@ -{{ if .Get "content" }} -{{ if .Get "summary" }} -{{ else }} -{{ warnf "missing value for param 'summary': %s" .Position }} -{{ end }} -{{ else }} -{{ errorf "missing value for param 'content': %s" .Position }} -{{ end }} -

- {{ .Get "summary" | markdownify }} - {{ .Get "content" | markdownify }} -

diff --git a/themes/mypaper/layouts/sitemap.xml b/themes/mypaper/layouts/sitemap.xml deleted file mode 100644 index 74851b5..0000000 --- a/themes/mypaper/layouts/sitemap.xml +++ /dev/null @@ -1,12 +0,0 @@ -{{ printf "" | safeHTML }} - - {{ range .Data.Pages }} - {{- if .Permalink -}} - - {{ .Permalink }}{{ if not .Lastmod.IsZero }} - {{ safeHTML ( .Lastmod.Format "2006-01-02-07:00" ) }}{{ end }} - - {{- end -}} - {{ end }} - diff --git a/themes/mypaper/static/an-old-hope.min.css b/themes/mypaper/static/an-old-hope.min.css deleted file mode 100644 index 936fba3..0000000 --- a/themes/mypaper/static/an-old-hope.min.css +++ /dev/null @@ -1 +0,0 @@ -.hljs-comment,.hljs-quote{color:#B6B18B}.hljs-variable,.hljs-template-variable,.hljs-tag,.hljs-name,.hljs-selector-id,.hljs-selector-class,.hljs-regexp,.hljs-deletion{color:#EB3C54}.hljs-number,.hljs-built_in,.hljs-builtin-name,.hljs-literal,.hljs-type,.hljs-params,.hljs-meta,.hljs-link{color:#E7CE56}.hljs-attribute{color:#EE7C2B}.hljs-string,.hljs-symbol,.hljs-bullet,.hljs-addition{color:#4FB4D7}.hljs-title,.hljs-section{color:#78BB65}.hljs-keyword,.hljs-selector-tag{color:#B45EA4}.hljs{display:block;overflow-x:auto;background:#1C1D21;color:#c0c5ce;padding:.5em}.hljs-emphasis{font-style:italic}.hljs-strong{font-weight:bold} \ No newline at end of file diff --git a/themes/mypaper/static/custom.css b/themes/mypaper/static/custom.css deleted file mode 100644 index f492b95..0000000 --- a/themes/mypaper/static/custom.css +++ /dev/null @@ -1,26 +0,0 @@ -/* Place a custom css file in your own project to use this. */ -.post-content h1, -.post-content h2, -.post-content h3, -.post-content h4, -.post-content h5, -.post-content h6 { - border-bottom: var(--primary) solid 1px; -} - -.post-content h1::before, -.post-content h2::before, -.post-content h3::before, -.post-content h4::before, -.post-content h5::before, -.post-content h6::before { - color: var(--secondary); - padding-right: 0.3rem; -} - -.post-content h1::before { content: '#'; } -.post-content h2::before { content: '##'; } -.post-content h3::before { content: '###'; } -.post-content h4::before { content: '####'; } -.post-content h5::before { content: '#####'; } -.post-content h6::before { content: '######'; } diff --git a/themes/mypaper/static/favicon.svg b/themes/mypaper/static/favicon.svg deleted file mode 100644 index d122ea1..0000000 --- a/themes/mypaper/static/favicon.svg +++ /dev/null @@ -1,62 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/themes/mypaper/static/highlight.min.js b/themes/mypaper/static/highlight.min.js deleted file mode 100644 index ce50ad7..0000000 --- a/themes/mypaper/static/highlight.min.js +++ /dev/null @@ -1,1122 +0,0 @@ -/*! - Highlight.js v11.0.0-beta1 (git: bc7ef3d912) - (c) 2006-2021 Ivan Sagalaev and other contributors - License: BSD-3-Clause - */ -var hljs=function(){"use strict";var e={exports:{}};function n(e){ -return e instanceof Map?e.clear=e.delete=e.set=()=>{ -throw Error("map is read-only")}:e instanceof Set&&(e.add=e.clear=e.delete=()=>{ -throw Error("set is read-only") -}),Object.freeze(e),Object.getOwnPropertyNames(e).forEach((t=>{var a=e[t] -;"object"!=typeof a||Object.isFrozen(a)||n(a)})),e} -e.exports=n,e.exports.default=n;var t=e.exports;class a{constructor(e){ -void 0===e.data&&(e.data={}),this.data=e.data,this.isMatchIgnored=!1} -ignoreMatch(){this.isMatchIgnored=!0}}function i(e){ -return e.replace(/&/g,"&").replace(//g,">").replace(/"/g,""").replace(/'/g,"'") -}function s(e,...n){const t=Object.create(null);for(const n in e)t[n]=e[n] -;return n.forEach((e=>{for(const n in e)t[n]=e[n]})),t}const r=e=>!!e.kind -;class o{constructor(e,n){ -this.buffer="",this.classPrefix=n.classPrefix,e.walk(this)}addText(e){ -this.buffer+=i(e)}openNode(e){if(!r(e))return;let n=e.kind -;n=e.sublanguage?"language-"+n:((e,{prefix:n})=>{if(e.includes(".")){ -const t=e.split(".") -;return[`${n}${t.shift()}`,...t.map(((e,n)=>`${e}${"_".repeat(n+1)}`))].join(" ") -}return`${n}${e}`})(n,{prefix:this.classPrefix}),this.span(n)}closeNode(e){ -r(e)&&(this.buffer+="")}value(){return this.buffer}span(e){ -this.buffer+=``}}class l{constructor(){this.rootNode={ -children:[]},this.stack=[this.rootNode]}get top(){ -return this.stack[this.stack.length-1]}get root(){return this.rootNode}add(e){ -this.top.children.push(e)}openNode(e){const n={kind:e,children:[]} -;this.add(n),this.stack.push(n)}closeNode(){ -if(this.stack.length>1)return this.stack.pop()}closeAllNodes(){ -for(;this.closeNode(););}toJSON(){return JSON.stringify(this.rootNode,null,4)} -walk(e){return this.constructor._walk(e,this.rootNode)}static _walk(e,n){ -return"string"==typeof n?e.addText(n):n.children&&(e.openNode(n), -n.children.forEach((n=>this._walk(e,n))),e.closeNode(n)),e}static _collapse(e){ -"string"!=typeof e&&e.children&&(e.children.every((e=>"string"==typeof e))?e.children=[e.children.join("")]:e.children.forEach((e=>{ -l._collapse(e)})))}}class c extends l{constructor(e){super(),this.options=e} -addKeyword(e,n){""!==e&&(this.openNode(n),this.addText(e),this.closeNode())} -addText(e){""!==e&&this.add(e)}addSublanguage(e,n){const t=e.root -;t.kind=n,t.sublanguage=!0,this.add(t)}toHTML(){ -return new o(this,this.options).value()}finalize(){return!0}}function d(e){ -return e?"string"==typeof e?e:e.source:null}function g(e){return b("(?=",e,")")} -function u(e){return b("(?:",e,")?")}function b(...e){ -return e.map((e=>d(e))).join("")}function m(...e){return"("+((e=>{ -const n=e[e.length-1] -;return"object"==typeof n&&n.constructor===Object?(e.splice(e.length-1,1),n):{} -})(e).capture?"":"?:")+e.map((e=>d(e))).join("|")+")"}function p(e){ -return RegExp(e.toString()+"|").exec("").length-1} -const _=/\[(?:[^\\\]]|\\.)*\]|\(\??|\\([1-9][0-9]*)|\\./ -;function f(e,{joinWith:n}){let t=0;return e.map((e=>{t+=1;const n=t -;let a=d(e),i="";for(;a.length>0;){const e=_.exec(a);if(!e){i+=a;break} -i+=a.substring(0,e.index), -a=a.substring(e.index+e[0].length),"\\"===e[0][0]&&e[1]?i+="\\"+(Number(e[1])+n):(i+=e[0], -"("===e[0]&&t++)}return i})).map((e=>`(${e})`)).join(n)} -const h="[a-zA-Z]\\w*",E="[a-zA-Z_]\\w*",y="\\b\\d+(\\.\\d+)?",N="(-?)(\\b0[xX][a-fA-F0-9]+|(\\b\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?)",w="\\b(0b[01]+)",v={ -begin:"\\\\[\\s\\S]",relevance:0},O={scope:"string",begin:"'",end:"'", -illegal:"\\n",contains:[v]},M={scope:"string",begin:'"',end:'"',illegal:"\\n", -contains:[v]},x=(e,n,t={})=>{const a=s({scope:"comment",begin:e,end:n, -contains:[]},t);a.contains.push({scope:"doctag", -begin:"[ ]*(?=(TODO|FIXME|NOTE|BUG|OPTIMIZE|HACK|XXX):)", -end:/(TODO|FIXME|NOTE|BUG|OPTIMIZE|HACK|XXX):/,excludeBegin:!0,relevance:0}) -;const i=m("I","a","is","so","us","to","at","if","in","it","on",/[A-Za-z]+['](d|ve|re|ll|t|s|n)/,/[A-Za-z]+[-][a-z]+/,/[A-Za-z][a-z]{2,}/) -;return a.contains.push({begin:b(/[ ]+/,"(",i,/[.]?[:]?([.][ ]|[ ])/,"){3}")}),a -},S=x("//","$"),k=x("/\\*","\\*/"),A=x("#","$");var C=Object.freeze({ -__proto__:null,MATCH_NOTHING_RE:/\b\B/,IDENT_RE:h,UNDERSCORE_IDENT_RE:E, -NUMBER_RE:y,C_NUMBER_RE:N,BINARY_NUMBER_RE:w, -RE_STARTERS_RE:"!|!=|!==|%|%=|&|&&|&=|\\*|\\*=|\\+|\\+=|,|-|-=|/=|/|:|;|<<|<<=|<=|<|===|==|=|>>>=|>>=|>=|>>>|>>|>|\\?|\\[|\\{|\\(|\\^|\\^=|\\||\\|=|\\|\\||~", -SHEBANG:(e={})=>{const n=/^#![ ]*\// -;return e.binary&&(e.begin=b(n,/.*\b/,e.binary,/\b.*/)),s({scope:"meta",begin:n, -end:/$/,relevance:0,"on:begin":(e,n)=>{0!==e.index&&n.ignoreMatch()}},e)}, -BACKSLASH_ESCAPE:v,APOS_STRING_MODE:O,QUOTE_STRING_MODE:M,PHRASAL_WORDS_MODE:{ -begin:/\b(a|an|the|are|I'm|isn't|don't|doesn't|won't|but|just|should|pretty|simply|enough|gonna|going|wtf|so|such|will|you|your|they|like|more)\b/ -},COMMENT:x,C_LINE_COMMENT_MODE:S,C_BLOCK_COMMENT_MODE:k,HASH_COMMENT_MODE:A, -NUMBER_MODE:{scope:"number",begin:y,relevance:0},C_NUMBER_MODE:{scope:"number", -begin:N,relevance:0},BINARY_NUMBER_MODE:{scope:"number",begin:w,relevance:0}, -REGEXP_MODE:{begin:/(?=\/[^/\n]*\/)/,contains:[{scope:"regexp",begin:/\//, -end:/\/[gimuy]*/,illegal:/\n/,contains:[v,{begin:/\[/,end:/\]/,relevance:0, -contains:[v]}]}]},TITLE_MODE:{scope:"title",begin:h,relevance:0}, -UNDERSCORE_TITLE_MODE:{scope:"title",begin:E,relevance:0},METHOD_GUARD:{ -begin:"\\.\\s*[a-zA-Z_]\\w*",relevance:0},END_SAME_AS_BEGIN:e=>Object.assign(e,{ -"on:begin":(e,n)=>{n.data._beginMatch=e[1]},"on:end":(e,n)=>{ -n.data._beginMatch!==e[1]&&n.ignoreMatch()}})});function T(e,n){ -"."===e.input[e.index-1]&&n.ignoreMatch()}function R(e,n){ -void 0!==e.className&&(e.scope=e.className,delete e.className)}function D(e,n){ -n&&e.beginKeywords&&(e.begin="\\b("+e.beginKeywords.split(" ").join("|")+")(?!\\.)(?=\\b|\\s)", -e.__beforeBegin=T,e.keywords=e.keywords||e.beginKeywords,delete e.beginKeywords, -void 0===e.relevance&&(e.relevance=0))}function I(e,n){ -Array.isArray(e.illegal)&&(e.illegal=m(...e.illegal))}function B(e,n){ -if(e.match){ -if(e.begin||e.end)throw Error("begin & end are not supported with match") -;e.begin=e.match,delete e.match}}function L(e,n){ -void 0===e.relevance&&(e.relevance=1)}const $=(e,n)=>{if(!e.beforeMatch)return -;if(e.starts)throw Error("beforeMatch cannot be used with starts") -;const t=Object.assign({},e);Object.keys(e).forEach((n=>{delete e[n] -})),e.keywords=t.keywords,e.begin=b(t.beforeMatch,g(t.begin)),e.starts={ -relevance:0,contains:[Object.assign(t,{endsParent:!0})] -},e.relevance=0,delete t.beforeMatch -},z=["of","and","for","in","not","or","if","then","parent","list","value"] -;function F(e,n,t="keyword"){const a=Object.create(null) -;return"string"==typeof e?i(t,e.split(" ")):Array.isArray(e)?i(t,e):Object.keys(e).forEach((t=>{ -Object.assign(a,F(e[t],n,t))})),a;function i(e,t){ -n&&(t=t.map((e=>e.toLowerCase()))),t.forEach((n=>{const t=n.split("|") -;a[t[0]]=[e,j(t[0],t[1])]}))}}function j(e,n){ -return n?Number(n):(e=>z.includes(e.toLowerCase()))(e)?0:1}const U={},P=e=>{ -console.error(e)},K=(e,...n)=>{console.log("WARN: "+e,...n)},q=(e,n)=>{ -U[`${e}/${n}`]||(console.log(`Deprecated as of ${e}. ${n}`),U[`${e}/${n}`]=!0) -},H=Error();function Z(e,n,{key:t}){let a=0;const i=e[t],s={},r={} -;for(let e=1;e<=n.length;e++)r[e+a]=i[e],s[e+a]=!0,a+=p(n[e-1]) -;e[t]=r,e[t]._emit=s,e[t]._multi=!0}function G(e){(e=>{ -e.scope&&"object"==typeof e.scope&&null!==e.scope&&(e.beginScope=e.scope, -delete e.scope)})(e),"string"==typeof e.beginScope&&(e.beginScope={ -_wrap:e.beginScope}),"string"==typeof e.endScope&&(e.endScope={_wrap:e.endScope -}),(e=>{if(Array.isArray(e.begin)){ -if(e.skip||e.excludeBegin||e.returnBegin)throw P("skip, excludeBegin, returnBegin not compatible with beginScope: {}"), -H -;if("object"!=typeof e.beginScope||null===e.beginScope)throw P("beginScope must be object"), -H;Z(e,e.begin,{key:"beginScope"}),e.begin=f(e.begin,{joinWith:""})}})(e),(e=>{ -if(Array.isArray(e.end)){ -if(e.skip||e.excludeEnd||e.returnEnd)throw P("skip, excludeEnd, returnEnd not compatible with endScope: {}"), -H -;if("object"!=typeof e.endScope||null===e.endScope)throw P("endScope must be object"), -H;Z(e,e.end,{key:"endScope"}),e.end=f(e.end,{joinWith:""})}})(e)}function W(e){ -function n(n,t){return RegExp(d(n),"m"+(e.case_insensitive?"i":"")+(t?"g":""))} -class t{constructor(){ -this.matchIndexes={},this.regexes=[],this.matchAt=1,this.position=0} -addRule(e,n){ -n.position=this.position++,this.matchIndexes[this.matchAt]=n,this.regexes.push([n,e]), -this.matchAt+=p(e)+1}compile(){0===this.regexes.length&&(this.exec=()=>null) -;const e=this.regexes.map((e=>e[1]));this.matcherRe=n(f(e,{joinWith:"|" -}),!0),this.lastIndex=0}exec(e){this.matcherRe.lastIndex=this.lastIndex -;const n=this.matcherRe.exec(e);if(!n)return null -;const t=n.findIndex(((e,n)=>n>0&&void 0!==e)),a=this.matchIndexes[t] -;return n.splice(0,t),Object.assign(n,a)}}class a{constructor(){ -this.rules=[],this.multiRegexes=[], -this.count=0,this.lastIndex=0,this.regexIndex=0}getMatcher(e){ -if(this.multiRegexes[e])return this.multiRegexes[e];const n=new t -;return this.rules.slice(e).forEach((([e,t])=>n.addRule(e,t))), -n.compile(),this.multiRegexes[e]=n,n}resumingScanAtSamePosition(){ -return 0!==this.regexIndex}considerAll(){this.regexIndex=0}addRule(e,n){ -this.rules.push([e,n]),"begin"===n.type&&this.count++}exec(e){ -const n=this.getMatcher(this.regexIndex);n.lastIndex=this.lastIndex -;let t=n.exec(e) -;if(this.resumingScanAtSamePosition())if(t&&t.index===this.lastIndex);else{ -const n=this.getMatcher(0);n.lastIndex=this.lastIndex+1,t=n.exec(e)} -return t&&(this.regexIndex+=t.position+1, -this.regexIndex===this.count&&this.considerAll()),t}} -if(e.compilerExtensions||(e.compilerExtensions=[]), -e.contains&&e.contains.includes("self"))throw Error("ERR: contains `self` is not supported at the top-level of a language. See documentation.") -;return e.classNameAliases=s(e.classNameAliases||{}),function t(i,r){const o=i -;if(i.isCompiled)return o -;[R,B,G,$].forEach((e=>e(i,r))),e.compilerExtensions.forEach((e=>e(i,r))), -i.__beforeBegin=null,[D,I,L].forEach((e=>e(i,r))),i.isCompiled=!0;let l=null -;return"object"==typeof i.keywords&&i.keywords.$pattern&&(i.keywords=Object.assign({},i.keywords), -l=i.keywords.$pattern, -delete i.keywords.$pattern),l=l||/\w+/,i.keywords&&(i.keywords=F(i.keywords,e.case_insensitive)), -o.keywordPatternRe=n(l,!0), -r&&(i.begin||(i.begin=/\B|\b/),o.beginRe=n(i.begin),i.end||i.endsWithParent||(i.end=/\B|\b/), -i.end&&(o.endRe=n(i.end)), -o.terminatorEnd=d(i.end)||"",i.endsWithParent&&r.terminatorEnd&&(o.terminatorEnd+=(i.end?"|":"")+r.terminatorEnd)), -i.illegal&&(o.illegalRe=n(i.illegal)), -i.contains||(i.contains=[]),i.contains=[].concat(...i.contains.map((e=>(e=>(e.variants&&!e.cachedVariants&&(e.cachedVariants=e.variants.map((n=>s(e,{ -variants:null},n)))),e.cachedVariants?e.cachedVariants:Q(e)?s(e,{ -starts:e.starts?s(e.starts):null -}):Object.isFrozen(e)?s(e):e))("self"===e?i:e)))),i.contains.forEach((e=>{t(e,o) -})),i.starts&&t(i.starts,r),o.matcher=(e=>{const n=new a -;return e.contains.forEach((e=>n.addRule(e.begin,{rule:e,type:"begin" -}))),e.terminatorEnd&&n.addRule(e.terminatorEnd,{type:"end" -}),e.illegal&&n.addRule(e.illegal,{type:"illegal"}),n})(o),o}(e)}function Q(e){ -return!!e&&(e.endsWithParent||Q(e.starts))}const X=i,V=s,J=Symbol("nomatch") -;var Y=(e=>{const n=Object.create(null),i=Object.create(null),s=[];let r=!0 -;const o="Could not find the language '{}', did you forget to load/include a language module?",l={ -disableAutodetect:!0,name:"Plain text",contains:[]};let d={ -ignoreUnescapedHTML:!1,noHighlightRe:/^(no-?highlight)$/i, -languageDetectRe:/\blang(?:uage)?-([\w-]+)\b/i,classPrefix:"hljs-", -cssSelector:"pre code",languages:null,__emitter:c};function g(e){ -return d.noHighlightRe.test(e)}function u(e,n,t,a){let i="",s="" -;"object"==typeof n?(i=e, -t=n.ignoreIllegals,s=n.language,a=void 0):(q("10.7.0","highlight(lang, code, ...args) has been deprecated."), -q("10.7.0","Please use highlight(code, options) instead.\nhttps://github.com/highlightjs/highlight.js/issues/2277"), -s=e,i=n),void 0===t&&(t=!0);const r={code:i,language:s};N("before:highlight",r) -;const o=r.result?r.result:b(r.language,r.code,t,a) -;return o.code=r.code,N("after:highlight",o),o}function b(e,t,i,s){ -const l=Object.create(null);function c(){if(!M.keywords)return void S.addText(k) -;let e=0;M.keywordPatternRe.lastIndex=0;let n=M.keywordPatternRe.exec(k),t="" -;for(;n;){t+=k.substring(e,n.index) -;const i=w.case_insensitive?n[0].toLowerCase():n[0],s=(a=i,M.keywords[a]);if(s){ -const[e,a]=s -;if(S.addText(t),t="",l[i]=(l[i]||0)+1,l[i]<=7&&(A+=a),e.startsWith("_"))t+=n[0];else{ -const t=w.classNameAliases[e]||e;S.addKeyword(n[0],t)}}else t+=n[0] -;e=M.keywordPatternRe.lastIndex,n=M.keywordPatternRe.exec(k)}var a -;t+=k.substr(e),S.addText(t)}function g(){null!=M.subLanguage?(()=>{ -if(""===k)return;let e=null;if("string"==typeof M.subLanguage){ -if(!n[M.subLanguage])return void S.addText(k) -;e=b(M.subLanguage,k,!0,x[M.subLanguage]),x[M.subLanguage]=e._top -}else e=m(k,M.subLanguage.length?M.subLanguage:null) -;M.relevance>0&&(A+=e.relevance),S.addSublanguage(e._emitter,e.language) -})():c(),k=""}function u(e,n){let t=1;for(;void 0!==n[t];){if(!e._emit[t]){t++ -;continue}const a=w.classNameAliases[e[t]]||e[t],i=n[t] -;a?S.addKeyword(i,a):(k=i,c(),k=""),t++}}function p(e,n){ -return e.scope&&"string"==typeof e.scope&&S.openNode(w.classNameAliases[e.scope]||e.scope), -e.beginScope&&(e.beginScope._wrap?(S.addKeyword(k,w.classNameAliases[e.beginScope._wrap]||e.beginScope._wrap), -k=""):e.beginScope._multi&&(u(e.beginScope,n),k="")),M=Object.create(e,{parent:{ -value:M}}),M}function _(e,n,t){let i=((e,n)=>{const t=e&&e.exec(n) -;return t&&0===t.index})(e.endRe,t);if(i){if(e["on:end"]){const t=new a(e) -;e["on:end"](n,t),t.isMatchIgnored&&(i=!1)}if(i){ -for(;e.endsParent&&e.parent;)e=e.parent;return e}} -if(e.endsWithParent)return _(e.parent,n,t)}function f(e){ -return 0===M.matcher.regexIndex?(k+=e[0],1):(R=!0,0)}function E(e){ -const n=e[0],a=t.substr(e.index),i=_(M,e,a);if(!i)return J;const s=M -;M.endScope&&M.endScope._wrap?(g(), -S.addKeyword(n,M.endScope._wrap)):M.endScope&&M.endScope._multi?(g(), -u(M.endScope,e)):s.skip?k+=n:(s.returnEnd||s.excludeEnd||(k+=n), -g(),s.excludeEnd&&(k=n));do{ -M.scope&&!M.isMultiClass&&S.closeNode(),M.skip||M.subLanguage||(A+=M.relevance), -M=M.parent}while(M!==i.parent) -;return i.starts&&p(i.starts,e),s.returnEnd?0:n.length}let y={};function N(n,s){ -const o=s&&s[0];if(k+=n,null==o)return g(),0 -;if("begin"===y.type&&"end"===s.type&&y.index===s.index&&""===o){ -if(k+=t.slice(s.index,s.index+1),!r){const n=Error(`0 width match regex (${e})`) -;throw n.languageName=e,n.badRule=y.rule,n}return 1} -if(y=s,"begin"===s.type)return(e=>{ -const n=e[0],t=e.rule,i=new a(t),s=[t.__beforeBegin,t["on:begin"]] -;for(const t of s)if(t&&(t(e,i),i.isMatchIgnored))return f(n) -;return t.skip?k+=n:(t.excludeBegin&&(k+=n), -g(),t.returnBegin||t.excludeBegin||(k=n)),p(t,e),t.returnBegin?0:n.length})(s) -;if("illegal"===s.type&&!i){ -const e=Error('Illegal lexeme "'+o+'" for mode "'+(M.scope||"")+'"') -;throw e.mode=M,e}if("end"===s.type){const e=E(s);if(e!==J)return e} -if("illegal"===s.type&&""===o)return 1 -;if(T>1e5&&T>3*s.index)throw Error("potential infinite loop, way more iterations than matches") -;return k+=o,o.length}const w=h(e) -;if(!w)throw P(o.replace("{}",e)),Error('Unknown language: "'+e+'"') -;const v=W(w);let O="",M=s||v;const x={},S=new d.__emitter(d);(()=>{const e=[] -;for(let n=M;n!==w;n=n.parent)n.scope&&e.unshift(n.scope) -;e.forEach((e=>S.openNode(e)))})();let k="",A=0,C=0,T=0,R=!1;try{ -for(M.matcher.considerAll();;){ -T++,R?R=!1:M.matcher.considerAll(),M.matcher.lastIndex=C -;const e=M.matcher.exec(t);if(!e)break;const n=N(t.substring(C,e.index),e) -;C=e.index+n}return N(t.substr(C)),S.closeAllNodes(),S.finalize(),O=S.toHTML(),{ -language:e,value:O,relevance:A,illegal:!1,_emitter:S,_top:M}}catch(n){ -if(n.message&&n.message.includes("Illegal"))return{language:e,value:X(t), -illegal:!0,relevance:0,_illegalBy:{message:n.message,index:C, -context:t.slice(C-100,C+100),mode:n.mode,resultSoFar:O},_emitter:S};if(r)return{ -language:e,value:X(t),illegal:!1,relevance:0,errorRaised:n,_emitter:S,_top:M} -;throw n}}function m(e,t){t=t||d.languages||Object.keys(n);const a=(e=>{ -const n={value:X(e),illegal:!1,relevance:0,_top:l,_emitter:new d.__emitter(d)} -;return n._emitter.addText(e),n})(e),i=t.filter(h).filter(y).map((n=>b(n,e,!1))) -;i.unshift(a);const s=i.sort(((e,n)=>{ -if(e.relevance!==n.relevance)return n.relevance-e.relevance -;if(e.language&&n.language){if(h(e.language).supersetOf===n.language)return 1 -;if(h(n.language).supersetOf===e.language)return-1}return 0})),[r,o]=s,c=r -;return c.secondBest=o,c}function p(e){let n=null;const t=(e=>{ -let n=e.className+" ";n+=e.parentNode?e.parentNode.className:"" -;const t=d.languageDetectRe.exec(n);if(t){const n=h(t[1]) -;return n||(K(o.replace("{}",t[1])), -K("Falling back to no-highlight mode for this block.",e)),n?t[1]:"no-highlight"} -return n.split(/\s+/).find((e=>g(e)||h(e)))})(e);if(g(t))return -;N("before:highlightElement",{el:e,language:t -}),!d.ignoreUnescapedHTML&&e.children.length>0&&(console.warn("One of your code blocks includes unescaped HTML. This is a potentially serious security risk."), -console.warn("https://github.com/highlightjs/highlight.js/issues/2886"), -console.warn(e)),n=e;const a=n.textContent,s=t?u(a,{language:t,ignoreIllegals:!0 -}):m(a);N("after:highlightElement",{el:e,result:s,text:a -}),e.innerHTML=s.value,((e,n,t)=>{const a=n&&i[n]||t -;e.classList.add("hljs"),e.classList.add("language-"+a) -})(e,t,s.language),e.result={language:s.language,re:s.relevance, -relevance:s.relevance},s.secondBest&&(e.secondBest={ -language:s.secondBest.language,relevance:s.secondBest.relevance})}let _=!1 -;function f(){ -"loading"!==document.readyState?document.querySelectorAll(d.cssSelector).forEach(p):_=!0 -}function h(e){return e=(e||"").toLowerCase(),n[e]||n[i[e]]} -function E(e,{languageName:n}){"string"==typeof e&&(e=[e]),e.forEach((e=>{ -i[e.toLowerCase()]=n}))}function y(e){const n=h(e) -;return n&&!n.disableAutodetect}function N(e,n){const t=e;s.forEach((e=>{ -e[t]&&e[t](n)}))} -"undefined"!=typeof window&&window.addEventListener&&window.addEventListener("DOMContentLoaded",(()=>{ -_&&f()}),!1),Object.assign(e,{highlight:u,highlightAuto:m,highlightAll:f, -highlightElement:p, -highlightBlock:e=>(q("10.7.0","highlightBlock will be removed entirely in v12.0"), -q("10.7.0","Please use highlightElement now."),p(e)),configure:e=>{d=V(d,e)}, -initHighlighting:()=>{ -f(),q("10.6.0","initHighlighting() deprecated. Use highlightAll() now.")}, -initHighlightingOnLoad:()=>{ -f(),q("10.6.0","initHighlightingOnLoad() deprecated. Use highlightAll() now.") -},registerLanguage:(t,a)=>{let i=null;try{i=a(e)}catch(e){ -if(P("Language definition for '{}' could not be registered.".replace("{}",t)), -!r)throw e;P(e),i=l} -i.name||(i.name=t),n[t]=i,i.rawDefinition=a.bind(null,e),i.aliases&&E(i.aliases,{ -languageName:t})},unregisterLanguage:e=>{delete n[e] -;for(const n of Object.keys(i))i[n]===e&&delete i[n]}, -listLanguages:()=>Object.keys(n),getLanguage:h,registerAliases:E, -autoDetection:y,inherit:V,addPlugin:e=>{(e=>{ -e["before:highlightBlock"]&&!e["before:highlightElement"]&&(e["before:highlightElement"]=n=>{ -e["before:highlightBlock"](Object.assign({block:n.el},n)) -}),e["after:highlightBlock"]&&!e["after:highlightElement"]&&(e["after:highlightElement"]=n=>{ -e["after:highlightBlock"](Object.assign({block:n.el},n))})})(e),s.push(e)} -}),e.debugMode=()=>{r=!1},e.safeMode=()=>{r=!0},e.versionString="11.0.0-beta1" -;for(const e in C)"object"==typeof C[e]&&t(C[e]);return Object.assign(e,C),e -})({});const ee=e=>({IMPORTANT:{scope:"meta",begin:"!important"},HEXCOLOR:{ -scope:"number",begin:"#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})"}, -ATTRIBUTE_SELECTOR_MODE:{scope:"selector-attr",begin:/\[/,end:/\]/,illegal:"$", -contains:[e.APOS_STRING_MODE,e.QUOTE_STRING_MODE]},CSS_NUMBER_MODE:{ -scope:"number", -begin:e.NUMBER_RE+"(%|em|ex|ch|rem|vw|vh|vmin|vmax|cm|mm|in|pt|pc|px|deg|grad|rad|turn|s|ms|Hz|kHz|dpi|dpcm|dppx)?", -relevance:0} -}),ne=["a","abbr","address","article","aside","audio","b","blockquote","body","button","canvas","caption","cite","code","dd","del","details","dfn","div","dl","dt","em","fieldset","figcaption","figure","footer","form","h1","h2","h3","h4","h5","h6","header","hgroup","html","i","iframe","img","input","ins","kbd","label","legend","li","main","mark","menu","nav","object","ol","p","q","quote","samp","section","span","strong","summary","sup","table","tbody","td","textarea","tfoot","th","thead","time","tr","ul","var","video"],te=["any-hover","any-pointer","aspect-ratio","color","color-gamut","color-index","device-aspect-ratio","device-height","device-width","display-mode","forced-colors","grid","height","hover","inverted-colors","monochrome","orientation","overflow-block","overflow-inline","pointer","prefers-color-scheme","prefers-contrast","prefers-reduced-motion","prefers-reduced-transparency","resolution","scan","scripting","update","width","min-width","max-width","min-height","max-height"],ae=["active","any-link","blank","checked","current","default","defined","dir","disabled","drop","empty","enabled","first","first-child","first-of-type","fullscreen","future","focus","focus-visible","focus-within","has","host","host-context","hover","indeterminate","in-range","invalid","is","lang","last-child","last-of-type","left","link","local-link","not","nth-child","nth-col","nth-last-child","nth-last-col","nth-last-of-type","nth-of-type","only-child","only-of-type","optional","out-of-range","past","placeholder-shown","read-only","read-write","required","right","root","scope","target","target-within","user-invalid","valid","visited","where"],ie=["after","backdrop","before","cue","cue-region","first-letter","first-line","grammar-error","marker","part","placeholder","selection","slotted","spelling-error"],se=["align-content","align-items","align-self","animation","animation-delay","animation-direction","animation-duration","animation-fill-mode","animation-iteration-count","animation-name","animation-play-state","animation-timing-function","auto","backface-visibility","background","background-attachment","background-clip","background-color","background-image","background-origin","background-position","background-repeat","background-size","border","border-bottom","border-bottom-color","border-bottom-left-radius","border-bottom-right-radius","border-bottom-style","border-bottom-width","border-collapse","border-color","border-image","border-image-outset","border-image-repeat","border-image-slice","border-image-source","border-image-width","border-left","border-left-color","border-left-style","border-left-width","border-radius","border-right","border-right-color","border-right-style","border-right-width","border-spacing","border-style","border-top","border-top-color","border-top-left-radius","border-top-right-radius","border-top-style","border-top-width","border-width","bottom","box-decoration-break","box-shadow","box-sizing","break-after","break-before","break-inside","caption-side","clear","clip","clip-path","color","column-count","column-fill","column-gap","column-rule","column-rule-color","column-rule-style","column-rule-width","column-span","column-width","columns","content","counter-increment","counter-reset","cursor","direction","display","empty-cells","filter","flex","flex-basis","flex-direction","flex-flow","flex-grow","flex-shrink","flex-wrap","float","font","font-display","font-family","font-feature-settings","font-kerning","font-language-override","font-size","font-size-adjust","font-smoothing","font-stretch","font-style","font-variant","font-variant-ligatures","font-variation-settings","font-weight","height","hyphens","icon","image-orientation","image-rendering","image-resolution","ime-mode","inherit","initial","justify-content","left","letter-spacing","line-height","list-style","list-style-image","list-style-position","list-style-type","margin","margin-bottom","margin-left","margin-right","margin-top","marks","mask","max-height","max-width","min-height","min-width","nav-down","nav-index","nav-left","nav-right","nav-up","none","normal","object-fit","object-position","opacity","order","orphans","outline","outline-color","outline-offset","outline-style","outline-width","overflow","overflow-wrap","overflow-x","overflow-y","padding","padding-bottom","padding-left","padding-right","padding-top","page-break-after","page-break-before","page-break-inside","perspective","perspective-origin","pointer-events","position","quotes","resize","right","src","tab-size","table-layout","text-align","text-align-last","text-decoration","text-decoration-color","text-decoration-line","text-decoration-style","text-indent","text-overflow","text-rendering","text-shadow","text-transform","text-underline-position","top","transform","transform-origin","transform-style","transition","transition-delay","transition-duration","transition-property","transition-timing-function","unicode-bidi","vertical-align","visibility","white-space","widows","width","word-break","word-spacing","word-wrap","z-index"].reverse(),re=ae.concat(ie) -;var oe="\\.([0-9](_*[0-9])*)",le="[0-9a-fA-F](_*[0-9a-fA-F])*",ce={ -className:"number",variants:[{ -begin:`(\\b([0-9](_*[0-9])*)((${oe})|\\.)?|(${oe}))[eE][+-]?([0-9](_*[0-9])*)[fFdD]?\\b` -},{begin:`\\b([0-9](_*[0-9])*)((${oe})[fFdD]?\\b|\\.([fFdD]\\b)?)`},{ -begin:`(${oe})[fFdD]?\\b`},{begin:"\\b([0-9](_*[0-9])*)[fFdD]\\b"},{ -begin:`\\b0[xX]((${le})\\.?|(${le})?\\.(${le}))[pP][+-]?([0-9](_*[0-9])*)[fFdD]?\\b` -},{begin:"\\b(0|[1-9](_*[0-9])*)[lL]?\\b"},{begin:`\\b0[xX](${le})[lL]?\\b`},{ -begin:"\\b0(_*[0-7])*[lL]?\\b"},{begin:"\\b0[bB][01](_*[01])*[lL]?\\b"}], -relevance:0};function de(e,n,t){return-1===t?"":e.replace(n,(a=>de(e,n,t-1)))} -const ge="[A-Za-z$_][0-9A-Za-z$_]*",ue=["as","in","of","if","for","while","finally","var","new","function","do","return","void","else","break","catch","instanceof","with","throw","case","default","try","switch","continue","typeof","delete","let","yield","const","class","debugger","async","await","static","import","from","export","extends"],be=["true","false","null","undefined","NaN","Infinity"],me=["Intl","DataView","Number","Math","Date","String","RegExp","Object","Function","Boolean","Error","Symbol","Set","Map","WeakSet","WeakMap","Proxy","Reflect","JSON","Promise","Float64Array","Int16Array","Int32Array","Int8Array","Uint16Array","Uint32Array","Float32Array","Array","Uint8Array","Uint8ClampedArray","ArrayBuffer","BigInt64Array","BigUint64Array","BigInt"],pe=["EvalError","InternalError","RangeError","ReferenceError","SyntaxError","TypeError","URIError"],_e=["setInterval","setTimeout","clearInterval","clearTimeout","require","exports","eval","isFinite","isNaN","parseFloat","parseInt","decodeURI","decodeURIComponent","encodeURI","encodeURIComponent","escape","unescape"],fe=["arguments","this","super","console","window","document","localStorage","module","global"],he=[].concat(_e,me,pe) -;function Ee(e){const n=ge,t={begin:/<[A-Za-z0-9\\._:-]+/, -end:/\/[A-Za-z0-9\\._:-]+>|\/>/,isTrulyOpeningTag:(e,n)=>{ -const t=e[0].length+e.index,a=e.input[t];"<"!==a?">"===a&&(((e,{after:n})=>{ -const t="",x={ -match:[/const|var|let/,/\s+/,n,/\s*/,/=\s*/,g(M)],className:{1:"keyword", -3:"title.function"},contains:[f]};return{name:"Javascript", -aliases:["js","jsx","mjs","cjs"],keywords:a,exports:{PARAMS_CONTAINS:_}, -illegal:/#(?![$_A-z])/,contains:[e.SHEBANG({label:"shebang",binary:"node", -relevance:5}),{label:"use_strict",className:"meta",relevance:10, -begin:/^\s*['"]use (strict|asm)['"]/ -},e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,l,c,d,u,r,E,{className:"attr", -begin:n+g(":"),relevance:0},x,{ -begin:"("+e.RE_STARTERS_RE+"|\\b(case|return|throw)\\b)\\s*", -keywords:"return throw case",relevance:0,contains:[u,e.REGEXP_MODE,{ -className:"function",begin:M,returnBegin:!0,end:"\\s*=>",contains:[{ -className:"params",variants:[{begin:e.UNDERSCORE_IDENT_RE,relevance:0},{ -className:null,begin:/\(\s*\)/,skip:!0},{begin:/\(/,end:/\)/,excludeBegin:!0, -excludeEnd:!0,keywords:a,contains:_}]}]},{begin:/,/,relevance:0},{match:/\s+/, -relevance:0},{variants:[{begin:"<>",end:""},{begin:t.begin, -"on:begin":t.isTrulyOpeningTag,end:t.end}],subLanguage:"xml",contains:[{ -begin:t.begin,end:t.end,skip:!0,contains:["self"]}]}]},y,{ -beginKeywords:"while if switch catch for"},{ -begin:"\\b(?!function)"+e.UNDERSCORE_IDENT_RE+"\\([^()]*(\\([^()]*(\\([^()]*\\)[^()]*)*\\)[^()]*)*\\)\\s*\\{", -returnBegin:!0,label:"func.def",contains:[f,e.inherit(e.TITLE_MODE,{begin:n, -className:"title.function"})]},{match:/\.\.\./,relevance:0},v,{match:"\\$"+n, -relevance:0},{match:[/\bconstructor(?=\s*\()/],className:{1:"title.function"}, -contains:[f]},N,{relevance:0,match:/\b[A-Z][A-Z_]+\b/, -className:"variable.constant"},h,O,{match:/\$[(.]/}]}} -const ye=e=>b(/\b/,e,/\w$/.test(e)?/\b/:/\B/),Ne=["Protocol","Type"].map(ye),we=["init","self"].map(ye),ve=["Any","Self"],Oe=["actor","associatedtype","async","await",/as\?/,/as!/,"as","break","case","catch","class","continue","convenience","default","defer","deinit","didSet","do","dynamic","else","enum","extension","fallthrough",/fileprivate\(set\)/,"fileprivate","final","for","func","get","guard","if","import","indirect","infix",/init\?/,/init!/,"inout",/internal\(set\)/,"internal","in","is","lazy","let","mutating","nonmutating",/open\(set\)/,"open","operator","optional","override","postfix","precedencegroup","prefix",/private\(set\)/,"private","protocol",/public\(set\)/,"public","repeat","required","rethrows","return","set","some","static","struct","subscript","super","switch","throws","throw",/try\?/,/try!/,"try","typealias",/unowned\(safe\)/,/unowned\(unsafe\)/,"unowned","var","weak","where","while","willSet"],Me=["false","nil","true"],xe=["assignment","associativity","higherThan","left","lowerThan","none","right"],Se=["#colorLiteral","#column","#dsohandle","#else","#elseif","#endif","#error","#file","#fileID","#fileLiteral","#filePath","#function","#if","#imageLiteral","#keyPath","#line","#selector","#sourceLocation","#warn_unqualified_access","#warning"],ke=["abs","all","any","assert","assertionFailure","debugPrint","dump","fatalError","getVaList","isKnownUniquelyReferenced","max","min","numericCast","pointwiseMax","pointwiseMin","precondition","preconditionFailure","print","readLine","repeatElement","sequence","stride","swap","swift_unboxFromSwiftValueWithType","transcode","type","unsafeBitCast","unsafeDowncast","withExtendedLifetime","withUnsafeMutablePointer","withUnsafePointer","withVaList","withoutActuallyEscaping","zip"],Ae=m(/[/=\-+!*%<>&|^~?]/,/[\u00A1-\u00A7]/,/[\u00A9\u00AB]/,/[\u00AC\u00AE]/,/[\u00B0\u00B1]/,/[\u00B6\u00BB\u00BF\u00D7\u00F7]/,/[\u2016-\u2017]/,/[\u2020-\u2027]/,/[\u2030-\u203E]/,/[\u2041-\u2053]/,/[\u2055-\u205E]/,/[\u2190-\u23FF]/,/[\u2500-\u2775]/,/[\u2794-\u2BFF]/,/[\u2E00-\u2E7F]/,/[\u3001-\u3003]/,/[\u3008-\u3020]/,/[\u3030]/),Ce=m(Ae,/[\u0300-\u036F]/,/[\u1DC0-\u1DFF]/,/[\u20D0-\u20FF]/,/[\uFE00-\uFE0F]/,/[\uFE20-\uFE2F]/),Te=b(Ae,Ce,"*"),Re=m(/[a-zA-Z_]/,/[\u00A8\u00AA\u00AD\u00AF\u00B2-\u00B5\u00B7-\u00BA]/,/[\u00BC-\u00BE\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u00FF]/,/[\u0100-\u02FF\u0370-\u167F\u1681-\u180D\u180F-\u1DBF]/,/[\u1E00-\u1FFF]/,/[\u200B-\u200D\u202A-\u202E\u203F-\u2040\u2054\u2060-\u206F]/,/[\u2070-\u20CF\u2100-\u218F\u2460-\u24FF\u2776-\u2793]/,/[\u2C00-\u2DFF\u2E80-\u2FFF]/,/[\u3004-\u3007\u3021-\u302F\u3031-\u303F\u3040-\uD7FF]/,/[\uF900-\uFD3D\uFD40-\uFDCF\uFDF0-\uFE1F\uFE30-\uFE44]/,/[\uFE47-\uFEFE\uFF00-\uFFFD]/),De=m(Re,/\d/,/[\u0300-\u036F\u1DC0-\u1DFF\u20D0-\u20FF\uFE20-\uFE2F]/),Ie=b(Re,De,"*"),Be=b(/[A-Z]/,De,"*"),Le=["autoclosure",b(/convention\(/,m("swift","block","c"),/\)/),"discardableResult","dynamicCallable","dynamicMemberLookup","escaping","frozen","GKInspectable","IBAction","IBDesignable","IBInspectable","IBOutlet","IBSegueAction","inlinable","main","nonobjc","NSApplicationMain","NSCopying","NSManaged",b(/objc\(/,Ie,/\)/),"objc","objcMembers","propertyWrapper","requires_stored_property_inits","resultBuilder","testable","UIApplicationMain","unknown","usableFromInline"],$e=["iOS","iOSApplicationExtension","macOS","macOSApplicationExtension","macCatalyst","macCatalystApplicationExtension","watchOS","watchOSApplicationExtension","tvOS","tvOSApplicationExtension","swift"] -;var ze=Object.freeze({__proto__:null,grmr_bash:e=>{const n={},t={begin:/\$\{/, -end:/\}/,contains:["self",{begin:/:-/,contains:[n]}]};Object.assign(n,{ -className:"variable",variants:[{ -begin:b(/\$[\w\d#@][\w\d_]*/,"(?![\\w\\d])(?![$])")},t]});const a={ -className:"subst",begin:/\$\(/,end:/\)/,contains:[e.BACKSLASH_ESCAPE]},i={ -begin:/<<-?\s*(?=\w+)/,starts:{contains:[e.END_SAME_AS_BEGIN({begin:/(\w+)/, -end:/(\w+)/,className:"string"})]}},s={className:"string",begin:/"/,end:/"/, -contains:[e.BACKSLASH_ESCAPE,n,a]};a.contains.push(s);const r={begin:/\$\(\(/, -end:/\)\)/,contains:[{begin:/\d+#[0-9a-f]+/,className:"number"},e.NUMBER_MODE,n] -},o=e.SHEBANG({binary:"(fish|bash|zsh|sh|csh|ksh|tcsh|dash|scsh)",relevance:10 -}),l={className:"function",begin:/\w[\w\d_]*\s*\(\s*\)\s*\{/,returnBegin:!0, -contains:[e.inherit(e.TITLE_MODE,{begin:/\w[\w\d_]*/})],relevance:0};return{ -name:"Bash",aliases:["sh"],keywords:{$pattern:/\b[a-z._-]+\b/, -keyword:["if","then","else","elif","fi","for","while","in","do","done","case","esac","function"], -literal:["true","false"], -built_in:"break cd continue eval exec exit export getopts hash pwd readonly return shift test times trap umask unset alias bind builtin caller command declare echo enable help let local logout mapfile printf read readarray source type typeset ulimit unalias set shopt autoload bg bindkey bye cap chdir clone comparguments compcall compctl compdescribe compfiles compgroups compquote comptags comptry compvalues dirs disable disown echotc echoti emulate fc fg float functions getcap getln history integer jobs kill limit log noglob popd print pushd pushln rehash sched setcap setopt stat suspend ttyctl unfunction unhash unlimit unsetopt vared wait whence where which zcompile zformat zftp zle zmodload zparseopts zprof zpty zregexparse zsocket zstyle ztcp" -},contains:[o,e.SHEBANG(),l,r,e.HASH_COMMENT_MODE,i,s,{className:"",begin:/\\"/ -},{className:"string",begin:/'/,end:/'/},n]}},grmr_c:e=>{ -const n=e.COMMENT("//","$",{contains:[{begin:/\\\n/}] -}),t="[a-zA-Z_]\\w*::",a="(decltype\\(auto\\)|"+u(t)+"[a-zA-Z_]\\w*"+u("<[^<>]+>")+")",i={ -className:"type",variants:[{begin:"\\b[a-z\\d_]*_t\\b"},{ -match:/\batomic_[a-z]{3,6}\b/}]},s={className:"string",variants:[{ -begin:'(u8?|U|L)?"',end:'"',illegal:"\\n",contains:[e.BACKSLASH_ESCAPE]},{ -begin:"(u8?|U|L)?'(\\\\(x[0-9A-Fa-f]{2}|u[0-9A-Fa-f]{4,8}|[0-7]{3}|\\S)|.)", -end:"'",illegal:"."},e.END_SAME_AS_BEGIN({ -begin:/(?:u8?|U|L)?R"([^()\\ ]{0,16})\(/,end:/\)([^()\\ ]{0,16})"/})]},r={ -className:"number",variants:[{begin:"\\b(0b[01']+)"},{ -begin:"(-?)\\b([\\d']+(\\.[\\d']*)?|\\.[\\d']+)((ll|LL|l|L)(u|U)?|(u|U)(ll|LL|l|L)?|f|F|b|B)" -},{ -begin:"(-?)(\\b0[xX][a-fA-F0-9']+|(\\b[\\d']+(\\.[\\d']*)?|\\.[\\d']+)([eE][-+]?[\\d']+)?)" -}],relevance:0},o={className:"meta",begin:/#\s*[a-z]+\b/,end:/$/,keywords:{ -keyword:"if else elif endif define undef warning error line pragma _Pragma ifdef ifndef include" -},contains:[{begin:/\\\n/,relevance:0},e.inherit(s,{className:"string"}),{ -className:"string",begin:/<.*?>/},n,e.C_BLOCK_COMMENT_MODE]},l={ -className:"title",begin:u(t)+e.IDENT_RE,relevance:0 -},c=u(t)+e.IDENT_RE+"\\s*\\(",d={ -keyword:["asm","auto","break","case","const","continue","default","do","else","enum","extern","for","fortran","goto","if","inline","register","restrict","return","sizeof","static","struct","switch","typedef","union","volatile","while","_Alignas","_Alignof","_Atomic","_Generic","_Noreturn","_Static_assert","_Thread_local","alignas","alignof","noreturn","static_assert","thread_local","_Pragma"], -type:["float","double","signed","unsigned","int","short","long","char","void","_Bool","_Complex","_Imaginary","_Decimal32","_Decimal64","_Decimal128","complex","bool","imaginary"], -literal:"true false NULL", -built_in:"std string wstring cin cout cerr clog stdin stdout stderr stringstream istringstream ostringstream auto_ptr deque list queue stack vector map set pair bitset multiset multimap unordered_set unordered_map unordered_multiset unordered_multimap priority_queue make_pair array shared_ptr abort terminate abs acos asin atan2 atan calloc ceil cosh cos exit exp fabs floor fmod fprintf fputs free frexp fscanf future isalnum isalpha iscntrl isdigit isgraph islower isprint ispunct isspace isupper isxdigit tolower toupper labs ldexp log10 log malloc realloc memchr memcmp memcpy memset modf pow printf putchar puts scanf sinh sin snprintf sprintf sqrt sscanf strcat strchr strcmp strcpy strcspn strlen strncat strncmp strncpy strpbrk strrchr strspn strstr tanh tan vfprintf vprintf vsprintf endl initializer_list unique_ptr" -},g=[o,i,n,e.C_BLOCK_COMMENT_MODE,r,s],b={variants:[{begin:/=/,end:/;/},{ -begin:/\(/,end:/\)/},{beginKeywords:"new throw return else",end:/;/}], -keywords:d,contains:g.concat([{begin:/\(/,end:/\)/,keywords:d, -contains:g.concat(["self"]),relevance:0}]),relevance:0},m={ -begin:"("+a+"[\\*&\\s]+)+"+c,returnBegin:!0,end:/[{;=]/,excludeEnd:!0, -keywords:d,illegal:/[^\w\s\*&:<>.]/,contains:[{begin:"decltype\\(auto\\)", -keywords:d,relevance:0},{begin:c,returnBegin:!0,contains:[e.inherit(l,{ -className:"title.function"})],relevance:0},{relevance:0,match:/,/},{ -className:"params",begin:/\(/,end:/\)/,keywords:d,relevance:0, -contains:[n,e.C_BLOCK_COMMENT_MODE,s,r,i,{begin:/\(/,end:/\)/,keywords:d, -relevance:0,contains:["self",n,e.C_BLOCK_COMMENT_MODE,s,r,i]}] -},i,n,e.C_BLOCK_COMMENT_MODE,o]};return{name:"C",aliases:["h"],keywords:d, -disableAutodetect:!0,illegal:"=]/,contains:[{ -beginKeywords:"final class struct"},e.TITLE_MODE]}]),exports:{preprocessor:o, -strings:s,keywords:d}}},grmr_cpp:e=>{const n=e.COMMENT("//","$",{contains:[{ -begin:/\\\n/}] -}),t="[a-zA-Z_]\\w*::",a="(?!struct)(decltype\\(auto\\)|"+u(t)+"[a-zA-Z_]\\w*"+u("<[^<>]+>")+")",i={ -className:"type",begin:"\\b[a-z\\d_]*_t\\b"},s={className:"string",variants:[{ -begin:'(u8?|U|L)?"',end:'"',illegal:"\\n",contains:[e.BACKSLASH_ESCAPE]},{ -begin:"(u8?|U|L)?'(\\\\(x[0-9A-Fa-f]{2}|u[0-9A-Fa-f]{4,8}|[0-7]{3}|\\S)|.)", -end:"'",illegal:"."},e.END_SAME_AS_BEGIN({ -begin:/(?:u8?|U|L)?R"([^()\\ ]{0,16})\(/,end:/\)([^()\\ ]{0,16})"/})]},r={ -className:"number",variants:[{begin:"\\b(0b[01']+)"},{ -begin:"(-?)\\b([\\d']+(\\.[\\d']*)?|\\.[\\d']+)((ll|LL|l|L)(u|U)?|(u|U)(ll|LL|l|L)?|f|F|b|B)" -},{ -begin:"(-?)(\\b0[xX][a-fA-F0-9']+|(\\b[\\d']+(\\.[\\d']*)?|\\.[\\d']+)([eE][-+]?[\\d']+)?)" -}],relevance:0},o={className:"meta",begin:/#\s*[a-z]+\b/,end:/$/,keywords:{ -keyword:"if else elif endif define undef warning error line pragma _Pragma ifdef ifndef include" -},contains:[{begin:/\\\n/,relevance:0},e.inherit(s,{className:"string"}),{ -className:"string",begin:/<.*?>/},n,e.C_BLOCK_COMMENT_MODE]},l={ -className:"title",begin:u(t)+e.IDENT_RE,relevance:0 -},c=u(t)+e.IDENT_RE+"\\s*\\(",d={ -type:["bool","char","char16_t","char32_t","char8_t","double","float","int","long","short","void","wchar_t","any","array","async","auto_ptr","barrier","binary_semaphore","bitset","complex","condition_variable","condition_variable_any","counting_semaphore","deque","false_type","function","future","imaginary","initializer_list","istringstream","jthread","latch","list","lock_guard","map","multimap","multiset","mutex","optional","ostringstream","packaged_task","pair","promise","priority_queue","queue","recursive_mutex","recursive_timed_mutex","scoped_lock","set","shared_future","shared_lock","shared_mutex","shared_timed_mutex","shared_ptr","stack","string","string_view","stringstream","timed_mutex","thread","true_type","tuple","unique_lock","unique_ptr","unordered_map","unordered_multimap","unordered_multiset","unordered_set","variant","vector","weak_ptr","wstring","wstring_view"], -keyword:["alignas","alignof","and","and_eq","asm","atomic_cancel","atomic_commit","atomic_noexcept","auto","bitand","bitor","break","case","catch","class","co_await","co_return","co_yield","compl","concept","const","const_cast|10","consteval","constexpr","constinit","continue","decltype","default","delete","do","dynamic_cast|10","else","enum","explicit","export","extern","false","final","for","friend","goto","if","import","inline","module","mutable","namespace","new","noexcept","not","not_eq","nullptr","operator","or","or_eq","override","private","protected","public","reflexpr","register","reinterpret_cast|10","requires","return","signed","sizeof","static","static_assert","static_cast|10","struct","switch","synchronized","template","this","thread_local","throw","transaction_safe","transaction_safe_dynamic","true","try","typedef","typeid","typename","union","unsigned","using","virtual","volatile","while","xor","xor_eq,"], -built_in:["_Bool","_Complex","_Imaginary"], -literal:["NULL","false","nullopt","nullptr","true"]},m={ -className:"function.dispatch",relevance:0,keywords:{ -_hint:["abort","abs","acos","apply","as_const","asin","atan","atan2","calloc","ceil","cerr","cin","clog","cos","cosh","cout","declval","endl","exchange","exit","exp","fabs","floor","fmod","forward","fprintf","fputs","free","frexp","fscanf","future","invoke","isalnum","isalpha","iscntrl","isdigit","isgraph","islower","isprint","ispunct","isspace","isupper","isxdigit","labs","launder","ldexp","log","log10","make_pair","make_shared","make_shared_for_overwrite","make_tuple","make_unique","malloc","memchr","memcmp","memcpy","memset","modf","move","pow","printf","putchar","puts","realloc","scanf","sin","sinh","snprintf","sprintf","sqrt","sscanf","std","stderr","stdin","stdout","strcat","strchr","strcmp","strcpy","strcspn","strlen","strncat","strncmp","strncpy","strpbrk","strrchr","strspn","strstr","swap","tan","tanh","terminate","to_underlying","tolower","toupper","vfprintf","visit","vprintf","vsprintf"] -}, -begin:b(/\b/,/(?!decltype)/,/(?!if)/,/(?!for)/,/(?!while)/,e.IDENT_RE,g(/(<[^<>]+>|)\s*\(/)) -},p=[m,o,i,n,e.C_BLOCK_COMMENT_MODE,r,s],_={variants:[{begin:/=/,end:/;/},{ -begin:/\(/,end:/\)/},{beginKeywords:"new throw return else",end:/;/}], -keywords:d,contains:p.concat([{begin:/\(/,end:/\)/,keywords:d, -contains:p.concat(["self"]),relevance:0}]),relevance:0},f={className:"function", -begin:"("+a+"[\\*&\\s]+)+"+c,returnBegin:!0,end:/[{;=]/,excludeEnd:!0, -keywords:d,illegal:/[^\w\s\*&:<>.]/,contains:[{begin:"decltype\\(auto\\)", -keywords:d,relevance:0},{begin:c,returnBegin:!0,contains:[l],relevance:0},{ -begin:/::/,relevance:0},{begin:/:/,endsWithParent:!0,contains:[s,r]},{ -relevance:0,match:/,/},{className:"params",begin:/\(/,end:/\)/,keywords:d, -relevance:0,contains:[n,e.C_BLOCK_COMMENT_MODE,s,r,i,{begin:/\(/,end:/\)/, -keywords:d,relevance:0,contains:["self",n,e.C_BLOCK_COMMENT_MODE,s,r,i]}] -},i,n,e.C_BLOCK_COMMENT_MODE,o]};return{name:"C++", -aliases:["cc","c++","h++","hpp","hh","hxx","cxx"],keywords:d,illegal:"",keywords:d,contains:["self",i]},{begin:e.IDENT_RE+"::",keywords:d},{ -match:[/\b(?:enum(?:\s+(?:class|struct))?|class|struct|union)/,/\s+/,/\w+/], -className:{1:"keyword",3:"title.class"}}])}},grmr_csharp:e=>{const n={ -keyword:["abstract","as","base","break","case","class","const","continue","do","else","event","explicit","extern","finally","fixed","for","foreach","goto","if","implicit","in","interface","internal","is","lock","namespace","new","operator","out","override","params","private","protected","public","readonly","record","ref","return","sealed","sizeof","stackalloc","static","struct","switch","this","throw","try","typeof","unchecked","unsafe","using","virtual","void","volatile","while"].concat(["add","alias","and","ascending","async","await","by","descending","equals","from","get","global","group","init","into","join","let","nameof","not","notnull","on","or","orderby","partial","remove","select","set","unmanaged","value|0","var","when","where","with","yield"]), -built_in:["bool","byte","char","decimal","delegate","double","dynamic","enum","float","int","long","nint","nuint","object","sbyte","short","string","ulong","uint","ushort"], -literal:["default","false","null","true"]},t=e.inherit(e.TITLE_MODE,{ -begin:"[a-zA-Z](\\.?\\w)*"}),a={className:"number",variants:[{ -begin:"\\b(0b[01']+)"},{ -begin:"(-?)\\b([\\d']+(\\.[\\d']*)?|\\.[\\d']+)(u|U|l|L|ul|UL|f|F|b|B)"},{ -begin:"(-?)(\\b0[xX][a-fA-F0-9']+|(\\b[\\d']+(\\.[\\d']*)?|\\.[\\d']+)([eE][-+]?[\\d']+)?)" -}],relevance:0},i={className:"string",begin:'@"',end:'"',contains:[{begin:'""'}] -},s=e.inherit(i,{illegal:/\n/}),r={className:"subst",begin:/\{/,end:/\}/, -keywords:n},o=e.inherit(r,{illegal:/\n/}),l={className:"string",begin:/\$"/, -end:'"',illegal:/\n/,contains:[{begin:/\{\{/},{begin:/\}\}/ -},e.BACKSLASH_ESCAPE,o]},c={className:"string",begin:/\$@"/,end:'"',contains:[{ -begin:/\{\{/},{begin:/\}\}/},{begin:'""'},r]},d=e.inherit(c,{illegal:/\n/, -contains:[{begin:/\{\{/},{begin:/\}\}/},{begin:'""'},o]}) -;r.contains=[c,l,i,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,a,e.C_BLOCK_COMMENT_MODE], -o.contains=[d,l,s,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,a,e.inherit(e.C_BLOCK_COMMENT_MODE,{ -illegal:/\n/})];const g={variants:[c,l,i,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE] -},u={begin:"<",end:">",contains:[{beginKeywords:"in out"},t] -},b=e.IDENT_RE+"(<"+e.IDENT_RE+"(\\s*,\\s*"+e.IDENT_RE+")*>)?(\\[\\])?",m={ -begin:"@"+e.IDENT_RE,relevance:0};return{name:"C#",aliases:["cs","c#"], -keywords:n,illegal:/::/,contains:[e.COMMENT("///","$",{returnBegin:!0, -contains:[{className:"doctag",variants:[{begin:"///",relevance:0},{ -begin:"\x3c!--|--\x3e"},{begin:""}]}] -}),e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,{className:"meta",begin:"#", -end:"$",keywords:{ -keyword:"if else elif endif define undef warning error line region endregion pragma checksum" -}},g,a,{beginKeywords:"class interface",relevance:0,end:/[{;=]/, -illegal:/[^\s:,]/,contains:[{beginKeywords:"where class" -},t,u,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{beginKeywords:"namespace", -relevance:0,end:/[{;=]/,illegal:/[^\s:]/, -contains:[t,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{ -beginKeywords:"record",relevance:0,end:/[{;=]/,illegal:/[^\s:]/, -contains:[t,u,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{className:"meta", -begin:"^\\s*\\[(?=[\\w])",excludeBegin:!0,end:"\\]",excludeEnd:!0,contains:[{ -className:"string",begin:/"/,end:/"/}]},{ -beginKeywords:"new return throw await else",relevance:0},{className:"function", -begin:"("+b+"\\s+)+"+e.IDENT_RE+"\\s*(<.+>\\s*)?\\(",returnBegin:!0, -end:/\s*[{;=]/,excludeEnd:!0,keywords:n,contains:[{ -beginKeywords:"public private protected static internal protected abstract async extern override unsafe virtual new sealed partial", -relevance:0},{begin:e.IDENT_RE+"\\s*(<.+>\\s*)?\\(",returnBegin:!0, -contains:[e.TITLE_MODE,u],relevance:0},{className:"params",begin:/\(/,end:/\)/, -excludeBegin:!0,excludeEnd:!0,keywords:n,relevance:0, -contains:[g,a,e.C_BLOCK_COMMENT_MODE] -},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},m]}},grmr_css:e=>{ -const n=ee(e),t=[e.APOS_STRING_MODE,e.QUOTE_STRING_MODE];return{name:"CSS", -case_insensitive:!0,illegal:/[=|'\$]/,keywords:{keyframePosition:"from to"}, -classNameAliases:{keyframePosition:"selector-tag"}, -contains:[e.C_BLOCK_COMMENT_MODE,{begin:/-(webkit|moz|ms|o)-(?=[a-z])/ -},n.CSS_NUMBER_MODE,{className:"selector-id",begin:/#[A-Za-z0-9_-]+/,relevance:0 -},{className:"selector-class",begin:"\\.[a-zA-Z-][a-zA-Z0-9_-]*",relevance:0 -},n.ATTRIBUTE_SELECTOR_MODE,{className:"selector-pseudo",variants:[{ -begin:":("+ae.join("|")+")"},{begin:"::("+ie.join("|")+")"}]},{ -className:"attribute",begin:"\\b("+se.join("|")+")\\b"},{begin:":",end:"[;}]", -contains:[n.HEXCOLOR,n.IMPORTANT,n.CSS_NUMBER_MODE,...t,{ -begin:/(url|data-uri)\(/,end:/\)/,relevance:0,keywords:{built_in:"url data-uri" -},contains:[{className:"string",begin:/[^)]/,endsWithParent:!0,excludeEnd:!0}] -},{className:"built_in",begin:/[\w-]+(?=\()/}]},{begin:g(/@/),end:"[{;]", -relevance:0,illegal:/:/,contains:[{className:"keyword",begin:/@-?\w[\w]*(-\w+)*/ -},{begin:/\s/,endsWithParent:!0,excludeEnd:!0,relevance:0,keywords:{ -$pattern:/[a-z-]+/,keyword:"and or not only",attribute:te.join(" ")},contains:[{ -begin:/[a-z-]+(?=:)/,className:"attribute"},...t,n.CSS_NUMBER_MODE]}]},{ -className:"selector-tag",begin:"\\b("+ne.join("|")+")\\b"}]}},grmr_diff:e=>({ -name:"Diff",aliases:["patch"],contains:[{className:"meta",relevance:10, -match:m(/^@@ +-\d+,\d+ +\+\d+,\d+ +@@/,/^\*\*\* +\d+,\d+ +\*\*\*\*$/,/^--- +\d+,\d+ +----$/) -},{className:"comment",variants:[{ -begin:m(/Index: /,/^index/,/={3,}/,/^-{3}/,/^\*{3} /,/^\+{3}/,/^diff --git/), -end:/$/},{match:/^\*{15}$/}]},{className:"addition",begin:/^\+/,end:/$/},{ -className:"deletion",begin:/^-/,end:/$/},{className:"addition",begin:/^!/, -end:/$/}]}),grmr_go:e=>{const n={ -keyword:["break","default","func","interface","select","case","map","struct","chan","else","goto","package","switch","const","fallthrough","if","range","type","continue","for","import","return","var","go","defer","bool","byte","complex64","complex128","float32","float64","int8","int16","int32","int64","string","uint8","uint16","uint32","uint64","int","uint","uintptr","rune"], -literal:["true","false","iota","nil"], -built_in:["append","cap","close","complex","copy","imag","len","make","new","panic","print","println","real","recover","delete"] -};return{name:"Go",aliases:["golang"],keywords:n,illegal:"{const n={ -className:"number",relevance:0,variants:[{begin:/([+-]+)?[\d]+_[\d_]+/},{ -begin:e.NUMBER_RE}]},t=e.COMMENT();t.variants=[{begin:/;/,end:/$/},{begin:/#/, -end:/$/}];const a={className:"variable",variants:[{begin:/\$[\w\d"][\w\d_]*/},{ -begin:/\$\{(.*?)\}/}]},i={className:"literal", -begin:/\bon|off|true|false|yes|no\b/},s={className:"string", -contains:[e.BACKSLASH_ESCAPE],variants:[{begin:"'''",end:"'''",relevance:10},{ -begin:'"""',end:'"""',relevance:10},{begin:'"',end:'"'},{begin:"'",end:"'"}] -},r={begin:/\[/,end:/\]/,contains:[t,i,a,s,n,"self"],relevance:0 -},o=m(/[A-Za-z0-9_-]+/,/"(\\"|[^"])*"/,/'[^']*'/);return{name:"TOML, also INI", -aliases:["toml"],case_insensitive:!0,illegal:/\S/,contains:[t,{ -className:"section",begin:/\[+/,end:/\]+/},{ -begin:b(o,"(\\s*\\.\\s*",o,")*",g(/\s*=\s*[^#\s]/)),className:"attr",starts:{ -end:/$/,contains:[t,r,i,a,s,n]}}]}},grmr_java:e=>{ -const n="[\xc0-\u02b8a-zA-Z_$][\xc0-\u02b8a-zA-Z_$0-9]*",t=n+de("(?:<"+n+"~~~(?:\\s*,\\s*"+n+"~~~)*>)?",/~~~/g,2),a={ -keyword:["synchronized","abstract","private","var","static","if","const ","for","while","strictfp","finally","protected","import","native","final","void","enum","else","break","transient","catch","instanceof","volatile","case","assert","package","default","public","try","switch","continue","throws","protected","public","private","module","requires","exports","do"], -literal:["false","true","null"], -type:["char","boolean","long","float","int","byte","short","double"], -built_in:["super","this"]},i={className:"meta",begin:"@"+n,contains:[{ -begin:/\(/,end:/\)/,contains:["self"]}]},s={className:"params",begin:/\(/, -end:/\)/,keywords:a,relevance:0,contains:[e.C_BLOCK_COMMENT_MODE],endsParent:!0} -;return{name:"Java",aliases:["jsp"],keywords:a,illegal:/<\/|#/, -contains:[e.COMMENT("/\\*\\*","\\*/",{relevance:0,contains:[{begin:/\w+@/, -relevance:0},{className:"doctag",begin:"@[A-Za-z]+"}]}),{ -begin:/import java\.[a-z]+\./,keywords:"import",relevance:2 -},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,{ -match:[/\b(?:class|interface|enum|extends|implements|new)/,/\s+/,n],className:{ -1:"keyword",3:"title.class"}},{begin:[n,/\s+/,n,/\s+/,/=/],className:{1:"type", -3:"variable",5:"operator"}},{begin:[/record/,/\s+/,n],className:{1:"keyword", -3:"title.class"},contains:[s,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{ -beginKeywords:"new throw return else",relevance:0},{ -begin:["(?:"+t+"\\s+)",e.UNDERSCORE_IDENT_RE,/\s*(?=\()/],className:{ -2:"title.function"},keywords:a,contains:[{className:"params",begin:/\(/, -end:/\)/,keywords:a,relevance:0, -contains:[i,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,ce,e.C_BLOCK_COMMENT_MODE] -},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},ce,i]}},grmr_javascript:Ee, -grmr_json:e=>({name:"JSON",contains:[{className:"attr", -begin:/"(\\.|[^\\"\r\n])*"(?=\s*:)/,relevance:1.01},{match:/[{}[\],:]/, -className:"punctuation",relevance:0},e.QUOTE_STRING_MODE,{ -beginKeywords:"true false null" -},e.C_NUMBER_MODE,e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE],illegal:"\\S"}), -grmr_kotlin:e=>{const n={ -keyword:"abstract as val var vararg get set class object open private protected public noinline crossinline dynamic final enum if else do while for when throw try catch finally import package is in fun override companion reified inline lateinit init interface annotation data sealed internal infix operator out by constructor super tailrec where const inner suspend typealias external expect actual", -built_in:"Byte Short Char Int Long Boolean Float Double Void Unit Nothing", -literal:"true false null"},t={className:"symbol",begin:e.UNDERSCORE_IDENT_RE+"@" -},a={className:"subst",begin:/\$\{/,end:/\}/,contains:[e.C_NUMBER_MODE]},i={ -className:"variable",begin:"\\$"+e.UNDERSCORE_IDENT_RE},s={className:"string", -variants:[{begin:'"""',end:'"""(?=[^"])',contains:[i,a]},{begin:"'",end:"'", -illegal:/\n/,contains:[e.BACKSLASH_ESCAPE]},{begin:'"',end:'"',illegal:/\n/, -contains:[e.BACKSLASH_ESCAPE,i,a]}]};a.contains.push(s);const r={ -className:"meta", -begin:"@(?:file|property|field|get|set|receiver|param|setparam|delegate)\\s*:(?:\\s*"+e.UNDERSCORE_IDENT_RE+")?" -},o={className:"meta",begin:"@"+e.UNDERSCORE_IDENT_RE,contains:[{begin:/\(/, -end:/\)/,contains:[e.inherit(s,{className:"string"})]}] -},l=ce,c=e.COMMENT("/\\*","\\*/",{contains:[e.C_BLOCK_COMMENT_MODE]}),d={ -variants:[{className:"type",begin:e.UNDERSCORE_IDENT_RE},{begin:/\(/,end:/\)/, -contains:[]}]},g=d;return g.variants[1].contains=[d],d.variants[1].contains=[g], -{name:"Kotlin",aliases:["kt","kts"],keywords:n, -contains:[e.COMMENT("/\\*\\*","\\*/",{relevance:0,contains:[{className:"doctag", -begin:"@[A-Za-z]+"}]}),e.C_LINE_COMMENT_MODE,c,{className:"keyword", -begin:/\b(break|continue|return|this)\b/,starts:{contains:[{className:"symbol", -begin:/@\w+/}]}},t,r,o,{className:"function",beginKeywords:"fun",end:"[(]|$", -returnBegin:!0,excludeEnd:!0,keywords:n,relevance:5,contains:[{ -begin:e.UNDERSCORE_IDENT_RE+"\\s*\\(",returnBegin:!0,relevance:0, -contains:[e.UNDERSCORE_TITLE_MODE]},{className:"type",begin://, -keywords:"reified",relevance:0},{className:"params",begin:/\(/,end:/\)/, -endsParent:!0,keywords:n,relevance:0,contains:[{begin:/:/,end:/[=,\/]/, -endsWithParent:!0,contains:[d,e.C_LINE_COMMENT_MODE,c],relevance:0 -},e.C_LINE_COMMENT_MODE,c,r,o,s,e.C_NUMBER_MODE]},c]},{className:"class", -beginKeywords:"class interface trait",end:/[:\{(]|$/,excludeEnd:!0, -illegal:"extends implements",contains:[{ -beginKeywords:"public protected internal private constructor" -},e.UNDERSCORE_TITLE_MODE,{className:"type",begin://,excludeBegin:!0, -excludeEnd:!0,relevance:0},{className:"type",begin:/[,:]\s*/,end:/[<\(,]|$/, -excludeBegin:!0,returnEnd:!0},r,o]},s,{className:"meta",begin:"^#!/usr/bin/env", -end:"$",illegal:"\n"},l]}},grmr_less:e=>{ -const n=ee(e),t=re,a="([\\w-]+|@\\{[\\w-]+\\})",i=[],s=[],r=e=>({ -className:"string",begin:"~?"+e+".*?"+e}),o=(e,n,t)=>({className:e,begin:n, -relevance:t}),l={$pattern:/[a-z-]+/,keyword:"and or not only", -attribute:te.join(" ")},c={begin:"\\(",end:"\\)",contains:s,keywords:l, -relevance:0} -;s.push(e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,r("'"),r('"'),n.CSS_NUMBER_MODE,{ -begin:"(url|data-uri)\\(",starts:{className:"string",end:"[\\)\\n]", -excludeEnd:!0} -},n.HEXCOLOR,c,o("variable","@@?[\\w-]+",10),o("variable","@\\{[\\w-]+\\}"),o("built_in","~?`[^`]*?`"),{ -className:"attribute",begin:"[\\w-]+\\s*:",end:":",returnBegin:!0,excludeEnd:!0 -},n.IMPORTANT);const d=s.concat({begin:/\{/,end:/\}/,contains:i}),g={ -beginKeywords:"when",endsWithParent:!0,contains:[{beginKeywords:"and not" -}].concat(s)},u={begin:a+"\\s*:",returnBegin:!0,end:/[;}]/,relevance:0, -contains:[{begin:/-(webkit|moz|ms|o)-/},{className:"attribute", -begin:"\\b("+se.join("|")+")\\b",end:/(?=:)/,starts:{endsWithParent:!0, -illegal:"[<=$]",relevance:0,contains:s}}]},b={className:"keyword", -begin:"@(import|media|charset|font-face|(-[a-z]+-)?keyframes|supports|document|namespace|page|viewport|host)\\b", -starts:{end:"[;{}]",keywords:l,returnEnd:!0,contains:s,relevance:0}},m={ -className:"variable",variants:[{begin:"@[\\w-]+\\s*:",relevance:15},{ -begin:"@[\\w-]+"}],starts:{end:"[;}]",returnEnd:!0,contains:d}},p={variants:[{ -begin:"[\\.#:&\\[>]",end:"[;{}]"},{begin:a,end:/\{/}],returnBegin:!0, -returnEnd:!0,illegal:"[<='$\"]",relevance:0, -contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,g,o("keyword","all\\b"),o("variable","@\\{[\\w-]+\\}"),{ -begin:"\\b("+ne.join("|")+")\\b",className:"selector-tag" -},o("selector-tag",a+"%?",0),o("selector-id","#"+a),o("selector-class","\\."+a,0),o("selector-tag","&",0),n.ATTRIBUTE_SELECTOR_MODE,{ -className:"selector-pseudo",begin:":("+ae.join("|")+")"},{ -className:"selector-pseudo",begin:"::("+ie.join("|")+")"},{begin:/\(/,end:/\)/, -relevance:0,contains:d},{begin:"!important"}]},_={ -begin:`[\\w-]+:(:)?(${t.join("|")})`,returnBegin:!0,contains:[p]} -;return i.push(e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,b,m,_,u,p),{ -name:"Less",case_insensitive:!0,illegal:"[=>'/<($\"]",contains:i}},grmr_lua:e=>{ -const n="\\[=*\\[",t="\\]=*\\]",a={begin:n,end:t,contains:["self"] -},i=[e.COMMENT("--(?!\\[=*\\[)","$"),e.COMMENT("--\\[=*\\[",t,{contains:[a], -relevance:10})];return{name:"Lua",keywords:{$pattern:e.UNDERSCORE_IDENT_RE, -literal:"true false nil", -keyword:"and break do else elseif end for goto if in local not or repeat return then until while", -built_in:"_G _ENV _VERSION __index __newindex __mode __call __metatable __tostring __len __gc __add __sub __mul __div __mod __pow __concat __unm __eq __lt __le assert collectgarbage dofile error getfenv getmetatable ipairs load loadfile loadstring module next pairs pcall print rawequal rawget rawset require select setfenv setmetatable tonumber tostring type unpack xpcall arg self coroutine resume yield status wrap create running debug getupvalue debug sethook getmetatable gethook setmetatable setlocal traceback setfenv getinfo setupvalue getlocal getregistry getfenv io lines write close flush open output type read stderr stdin input stdout popen tmpfile math log max acos huge ldexp pi cos tanh pow deg tan cosh sinh random randomseed frexp ceil floor rad abs sqrt modf asin min mod fmod log10 atan2 exp sin atan os exit setlocale date getenv difftime remove time clock tmpname rename execute package preload loadlib loaded loaders cpath config path seeall string sub upper len gfind rep find match char dump gmatch reverse byte format gsub lower table setn insert getn foreachi maxn foreach concat sort remove" -},contains:i.concat([{className:"function",beginKeywords:"function",end:"\\)", -contains:[e.inherit(e.TITLE_MODE,{ -begin:"([_a-zA-Z]\\w*\\.)*([_a-zA-Z]\\w*:)?[_a-zA-Z]\\w*"}),{className:"params", -begin:"\\(",endsWithParent:!0,contains:i}].concat(i) -},e.C_NUMBER_MODE,e.APOS_STRING_MODE,e.QUOTE_STRING_MODE,{className:"string", -begin:n,end:t,contains:[a],relevance:5}])}},grmr_makefile:e=>{const n={ -className:"variable",variants:[{begin:"\\$\\("+e.UNDERSCORE_IDENT_RE+"\\)", -contains:[e.BACKSLASH_ESCAPE]},{begin:/\$[@%{ -const n=b(/[A-Z_]/,u(/[A-Z0-9_.-]*:/),/[A-Z0-9_.-]*/),t={className:"symbol", -begin:/&[a-z]+;|&#[0-9]+;|&#x[a-f0-9]+;/},a={begin:/\s/,contains:[{ -className:"keyword",begin:/#?[a-z_][a-z1-9_-]+/,illegal:/\n/}]},i=e.inherit(a,{ -begin:/\(/,end:/\)/}),s=e.inherit(e.APOS_STRING_MODE,{className:"string" -}),r=e.inherit(e.QUOTE_STRING_MODE,{className:"string"}),o={endsWithParent:!0, -illegal:/`]+/}]}]}]};return{name:"HTML, XML", -aliases:["html","xhtml","rss","atom","xjb","xsd","xsl","plist","wsf","svg"], -case_insensitive:!0,contains:[{className:"meta",begin://, -relevance:10,contains:[a,r,s,i,{begin:/\[/,end:/\]/,contains:[{className:"meta", -begin://,contains:[a,i,r,s]}]}]},e.COMMENT(//,{ -relevance:10}),{begin://,relevance:10},t,{ -className:"meta",begin:/<\?xml/,end:/\?>/,relevance:10},{className:"tag", -begin:/)/,end:/>/,keywords:{name:"style"},contains:[o],starts:{ -end:/<\/style>/,returnEnd:!0,subLanguage:["css","xml"]}},{className:"tag", -begin:/)/,end:/>/,keywords:{name:"script"},contains:[o],starts:{ -end:/<\/script>/,returnEnd:!0,subLanguage:["javascript","handlebars","xml"]}},{ -className:"tag",begin:/<>|<\/>/},{className:"tag", -begin:b(//,/>/,/\s/)))),end:/\/?>/,contains:[{className:"name", -begin:n,relevance:0,starts:o}]},{className:"tag",begin:b(/<\//,g(b(n,/>/))), -contains:[{className:"name",begin:n,relevance:0},{begin:/>/,relevance:0, -endsParent:!0}]}]}},grmr_markdown:e=>{const n={begin:/<\/?[A-Za-z_]/,end:">", -subLanguage:"xml",relevance:0},t={variants:[{begin:/\[.+?\]\[.*?\]/,relevance:0 -},{begin:/\[.+?\]\(((data|javascript|mailto):|(?:http|ftp)s?:\/\/).*?\)/, -relevance:2},{begin:b(/\[.+?\]\(/,/[A-Za-z][A-Za-z0-9+.-]*/,/:\/\/.*?\)/), -relevance:2},{begin:/\[.+?\]\([./?&#].*?\)/,relevance:1},{ -begin:/\[.+?\]\(.*?\)/,relevance:0}],returnBegin:!0,contains:[{ -className:"string",relevance:0,begin:"\\[",end:"\\]",excludeBegin:!0, -returnEnd:!0},{className:"link",relevance:0,begin:"\\]\\(",end:"\\)", -excludeBegin:!0,excludeEnd:!0},{className:"symbol",relevance:0,begin:"\\]\\[", -end:"\\]",excludeBegin:!0,excludeEnd:!0}]},a={className:"strong",contains:[], -variants:[{begin:/_{2}/,end:/_{2}/},{begin:/\*{2}/,end:/\*{2}/}]},i={ -className:"emphasis",contains:[],variants:[{begin:/\*(?!\*)/,end:/\*/},{ -begin:/_(?!_)/,end:/_/,relevance:0}]};a.contains.push(i),i.contains.push(a) -;let s=[n,t] -;return a.contains=a.contains.concat(s),i.contains=i.contains.concat(s), -s=s.concat(a,i),{name:"Markdown",aliases:["md","mkdown","mkd"],contains:[{ -className:"section",variants:[{begin:"^#{1,6}",end:"$",contains:s},{ -begin:"(?=^.+?\\n[=-]{2,}$)",contains:[{begin:"^[=-]*$"},{begin:"^",end:"\\n", -contains:s}]}]},n,{className:"bullet",begin:"^[ \t]*([*+-]|(\\d+\\.))(?=\\s+)", -end:"\\s+",excludeEnd:!0},a,i,{className:"quote",begin:"^>\\s+",contains:s, -end:"$"},{className:"code",variants:[{begin:"(`{3,})[^`](.|\\n)*?\\1`*[ ]*"},{ -begin:"(~{3,})[^~](.|\\n)*?\\1~*[ ]*"},{begin:"```",end:"```+[ ]*$"},{ -begin:"~~~",end:"~~~+[ ]*$"},{begin:"`.+?`"},{begin:"(?=^( {4}|\\t))", -contains:[{begin:"^( {4}|\\t)",end:"(\\n)$"}],relevance:0}]},{ -begin:"^[-\\*]{3,}",end:"$"},t,{begin:/^\[[^\n]+\]:/,returnBegin:!0,contains:[{ -className:"symbol",begin:/\[/,end:/\]/,excludeBegin:!0,excludeEnd:!0},{ -className:"link",begin:/:\s*/,end:/$/,excludeBegin:!0}]}]}},grmr_objectivec:e=>{ -const n=/[a-zA-Z@][a-zA-Z0-9_]*/,t={$pattern:n, -keyword:["@interface","@class","@protocol","@implementation"]};return{ -name:"Objective-C",aliases:["mm","objc","obj-c","obj-c++","objective-c++"], -keywords:{$pattern:n, -keyword:["int","float","while","char","export","sizeof","typedef","const","struct","for","union","unsigned","long","volatile","static","bool","mutable","if","do","return","goto","void","enum","else","break","extern","asm","case","short","default","double","register","explicit","signed","typename","this","switch","continue","wchar_t","inline","readonly","assign","readwrite","self","@synchronized","id","typeof","nonatomic","super","unichar","IBOutlet","IBAction","strong","weak","copy","in","out","inout","bycopy","byref","oneway","__strong","__weak","__block","__autoreleasing","@private","@protected","@public","@try","@property","@end","@throw","@catch","@finally","@autoreleasepool","@synthesize","@dynamic","@selector","@optional","@required","@encode","@package","@import","@defs","@compatibility_alias","__bridge","__bridge_transfer","__bridge_retained","__bridge_retain","__covariant","__contravariant","__kindof","_Nonnull","_Nullable","_Null_unspecified","__FUNCTION__","__PRETTY_FUNCTION__","__attribute__","getter","setter","retain","unsafe_unretained","nonnull","nullable","null_unspecified","null_resettable","class","instancetype","NS_DESIGNATED_INITIALIZER","NS_UNAVAILABLE","NS_REQUIRES_SUPER","NS_RETURNS_INNER_POINTER","NS_INLINE","NS_AVAILABLE","NS_DEPRECATED","NS_ENUM","NS_OPTIONS","NS_SWIFT_UNAVAILABLE","NS_ASSUME_NONNULL_BEGIN","NS_ASSUME_NONNULL_END","NS_REFINED_FOR_SWIFT","NS_SWIFT_NAME","NS_SWIFT_NOTHROW","NS_DURING","NS_HANDLER","NS_ENDHANDLER","NS_VALUERETURN","NS_VOIDRETURN"], -literal:["false","true","FALSE","TRUE","nil","YES","NO","NULL"], -built_in:["BOOL","dispatch_once_t","dispatch_queue_t","dispatch_sync","dispatch_async","dispatch_once"] -},illegal:"/,end:/$/,illegal:"\\n" -},e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE]},{className:"class", -begin:"("+t.keyword.join("|")+")\\b",end:/(\{|$)/,excludeEnd:!0,keywords:t, -contains:[e.UNDERSCORE_TITLE_MODE]},{begin:"\\."+e.UNDERSCORE_IDENT_RE, -relevance:0}]}},grmr_perl:e=>{const n=/[dualxmsipngr]{0,12}/,t={ -$pattern:/[\w.]+/, -keyword:"abs accept alarm and atan2 bind binmode bless break caller chdir chmod chomp chop chown chr chroot close closedir connect continue cos crypt dbmclose dbmopen defined delete die do dump each else elsif endgrent endhostent endnetent endprotoent endpwent endservent eof eval exec exists exit exp fcntl fileno flock for foreach fork format formline getc getgrent getgrgid getgrnam gethostbyaddr gethostbyname gethostent getlogin getnetbyaddr getnetbyname getnetent getpeername getpgrp getpriority getprotobyname getprotobynumber getprotoent getpwent getpwnam getpwuid getservbyname getservbyport getservent getsockname getsockopt given glob gmtime goto grep gt hex if index int ioctl join keys kill last lc lcfirst length link listen local localtime log lstat lt ma map mkdir msgctl msgget msgrcv msgsnd my ne next no not oct open opendir or ord our pack package pipe pop pos print printf prototype push q|0 qq quotemeta qw qx rand read readdir readline readlink readpipe recv redo ref rename require reset return reverse rewinddir rindex rmdir say scalar seek seekdir select semctl semget semop send setgrent sethostent setnetent setpgrp setpriority setprotoent setpwent setservent setsockopt shift shmctl shmget shmread shmwrite shutdown sin sleep socket socketpair sort splice split sprintf sqrt srand stat state study sub substr symlink syscall sysopen sysread sysseek system syswrite tell telldir tie tied time times tr truncate uc ucfirst umask undef unless unlink unpack unshift untie until use utime values vec wait waitpid wantarray warn when while write x|0 xor y|0" -},a={className:"subst",begin:"[$@]\\{",end:"\\}",keywords:t},i={begin:/->\{/, -end:/\}/},s={variants:[{begin:/\$\d/},{ -begin:b(/[$%@](\^\w\b|#\w+(::\w+)*|\{\w+\}|\w+(::\w*)*)/,"(?![A-Za-z])(?![@$%])") -},{begin:/[$%@][^\s\w{]/,relevance:0}] -},r=[e.BACKSLASH_ESCAPE,a,s],o=[/!/,/\//,/\|/,/\?/,/'/,/"/,/#/],l=(e,t,a="\\1")=>{ -const i="\\1"===a?a:b(a,t) -;return b(b("(?:",e,")"),t,/(?:\\.|[^\\\/])*?/,i,/(?:\\.|[^\\\/])*?/,a,n) -},c=(e,t,a)=>b(b("(?:",e,")"),t,/(?:\\.|[^\\\/])*?/,a,n),d=[s,e.HASH_COMMENT_MODE,e.COMMENT(/^=\w/,/=cut/,{ -endsWithParent:!0}),i,{className:"string",contains:r,variants:[{ -begin:"q[qwxr]?\\s*\\(",end:"\\)",relevance:5},{begin:"q[qwxr]?\\s*\\[", -end:"\\]",relevance:5},{begin:"q[qwxr]?\\s*\\{",end:"\\}",relevance:5},{ -begin:"q[qwxr]?\\s*\\|",end:"\\|",relevance:5},{begin:"q[qwxr]?\\s*<",end:">", -relevance:5},{begin:"qw\\s+q",end:"q",relevance:5},{begin:"'",end:"'", -contains:[e.BACKSLASH_ESCAPE]},{begin:'"',end:'"'},{begin:"`",end:"`", -contains:[e.BACKSLASH_ESCAPE]},{begin:/\{\w+\}/,relevance:0},{ -begin:"-?\\w+\\s*=>",relevance:0}]},{className:"number", -begin:"(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b", -relevance:0},{ -begin:"(\\/\\/|"+e.RE_STARTERS_RE+"|\\b(split|return|print|reverse|grep)\\b)\\s*", -keywords:"split return print reverse grep",relevance:0, -contains:[e.HASH_COMMENT_MODE,{className:"regexp",variants:[{ -begin:l("s|tr|y",m(...o,{capture:!0}))},{begin:l("s|tr|y","\\(","\\)")},{ -begin:l("s|tr|y","\\[","\\]")},{begin:l("s|tr|y","\\{","\\}")}],relevance:2},{ -className:"regexp",variants:[{begin:/(m|qr)\/\//,relevance:0},{ -begin:c("(?:m|qr)?",/\//,/\//)},{begin:c("m|qr",m(...o,{capture:!0}),/\1/)},{ -begin:c("m|qr",/\(/,/\)/)},{begin:c("m|qr",/\[/,/\]/)},{ -begin:c("m|qr",/\{/,/\}/)}]}]},{className:"function",beginKeywords:"sub", -end:"(\\s*\\(.*?\\))?[;{]",excludeEnd:!0,relevance:5,contains:[e.TITLE_MODE]},{ -begin:"-\\w\\b",relevance:0},{begin:"^__DATA__$",end:"^__END__$", -subLanguage:"mojolicious",contains:[{begin:"^@@.*",end:"$",className:"comment"}] -}];return a.contains=d,i.contains=d,{name:"Perl",aliases:["pl","pm"],keywords:t, -contains:d}},grmr_php:e=>{const n={className:"variable", -begin:"\\$+[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*(?![A-Za-z0-9])(?![$])"},t={ -className:"meta",variants:[{begin:/<\?php/,relevance:10},{begin:/<\?[=]?/},{ -begin:/\?>/}]},a={className:"subst",variants:[{begin:/\$\w+/},{begin:/\{\$/, -end:/\}/}]},i=e.inherit(e.APOS_STRING_MODE,{illegal:null -}),s=e.inherit(e.QUOTE_STRING_MODE,{illegal:null, -contains:e.QUOTE_STRING_MODE.contains.concat(a)}),r=e.END_SAME_AS_BEGIN({ -begin:/<<<[ \t]*(\w+)\n/,end:/[ \t]*(\w+)\b/, -contains:e.QUOTE_STRING_MODE.contains.concat(a)}),o={className:"string", -contains:[e.BACKSLASH_ESCAPE,t],variants:[e.inherit(i,{begin:"b'",end:"'" -}),e.inherit(s,{begin:'b"',end:'"'}),s,i,r]},l={className:"number",variants:[{ -begin:"\\b0b[01]+(?:_[01]+)*\\b"},{begin:"\\b0o[0-7]+(?:_[0-7]+)*\\b"},{ -begin:"\\b0x[\\da-f]+(?:_[\\da-f]+)*\\b"},{ -begin:"(?:\\b\\d+(?:_\\d+)*(\\.(?:\\d+(?:_\\d+)*))?|\\B\\.\\d+)(?:e[+-]?\\d+)?" -}],relevance:0},c={ -keyword:"__CLASS__ __DIR__ __FILE__ __FUNCTION__ __LINE__ __METHOD__ __NAMESPACE__ __TRAIT__ die echo exit include include_once print require require_once array abstract and as binary bool boolean break callable case catch class clone const continue declare default do double else elseif empty enddeclare endfor endforeach endif endswitch endwhile enum eval extends final finally float for foreach from global goto if implements instanceof insteadof int integer interface isset iterable list match|0 mixed new object or private protected public real return string switch throw trait try unset use var void while xor yield", -literal:"false null true", -built_in:"Error|0 AppendIterator ArgumentCountError ArithmeticError ArrayIterator ArrayObject AssertionError BadFunctionCallException BadMethodCallException CachingIterator CallbackFilterIterator CompileError Countable DirectoryIterator DivisionByZeroError DomainException EmptyIterator ErrorException Exception FilesystemIterator FilterIterator GlobIterator InfiniteIterator InvalidArgumentException IteratorIterator LengthException LimitIterator LogicException MultipleIterator NoRewindIterator OutOfBoundsException OutOfRangeException OuterIterator OverflowException ParentIterator ParseError RangeException RecursiveArrayIterator RecursiveCachingIterator RecursiveCallbackFilterIterator RecursiveDirectoryIterator RecursiveFilterIterator RecursiveIterator RecursiveIteratorIterator RecursiveRegexIterator RecursiveTreeIterator RegexIterator RuntimeException SeekableIterator SplDoublyLinkedList SplFileInfo SplFileObject SplFixedArray SplHeap SplMaxHeap SplMinHeap SplObjectStorage SplObserver SplObserver SplPriorityQueue SplQueue SplStack SplSubject SplSubject SplTempFileObject TypeError UnderflowException UnexpectedValueException UnhandledMatchError ArrayAccess Closure Generator Iterator IteratorAggregate Serializable Stringable Throwable Traversable WeakReference WeakMap Directory __PHP_Incomplete_Class parent php_user_filter self static stdClass" -};return{case_insensitive:!0,keywords:c, -contains:[e.HASH_COMMENT_MODE,e.COMMENT("//","$",{contains:[t] -}),e.COMMENT("/\\*","\\*/",{contains:[{className:"doctag",begin:"@[A-Za-z]+"}] -}),e.COMMENT("__halt_compiler.+?;",!1,{endsWithParent:!0, -keywords:"__halt_compiler"}),t,{className:"keyword",begin:/\$this\b/},n,{ -begin:/(::|->)+[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*/},{className:"function", -relevance:0,beginKeywords:"fn function",end:/[;{]/,excludeEnd:!0, -illegal:"[$%\\[]",contains:[{beginKeywords:"use"},e.UNDERSCORE_TITLE_MODE,{ -begin:"=>",endsParent:!0},{className:"params",begin:"\\(",end:"\\)", -excludeBegin:!0,excludeEnd:!0,keywords:c, -contains:["self",n,e.C_BLOCK_COMMENT_MODE,o,l]}]},{className:"class",variants:[{ -beginKeywords:"enum",illegal:/[($"]/},{beginKeywords:"class interface trait", -illegal:/[:($"]/}],relevance:0,end:/\{/,excludeEnd:!0,contains:[{ -beginKeywords:"extends implements"},e.UNDERSCORE_TITLE_MODE]},{ -beginKeywords:"namespace",relevance:0,end:";",illegal:/[.']/, -contains:[e.UNDERSCORE_TITLE_MODE]},{beginKeywords:"use",relevance:0,end:";", -contains:[e.UNDERSCORE_TITLE_MODE]},o,l]}},grmr_php_template:e=>({ -name:"PHP template",subLanguage:"xml",contains:[{begin:/<\?(php|=)?/,end:/\?>/, -subLanguage:"php",contains:[{begin:"/\\*",end:"\\*/",skip:!0},{begin:'b"', -end:'"',skip:!0},{begin:"b'",end:"'",skip:!0},e.inherit(e.APOS_STRING_MODE,{ -illegal:null,className:null,contains:null,skip:!0 -}),e.inherit(e.QUOTE_STRING_MODE,{illegal:null,className:null,contains:null, -skip:!0})]}]}),grmr_plaintext:e=>({name:"Plain text",aliases:["text","txt"], -disableAutodetect:!0}),grmr_python:e=>{const n={$pattern:/[A-Za-z]\w+|__\w+__/, -keyword:["and","as","assert","async","await","break","class","continue","def","del","elif","else","except","finally","for","from","global","if","import","in","is","lambda","nonlocal|10","not","or","pass","raise","return","try","while","with","yield"], -built_in:["__import__","abs","all","any","ascii","bin","bool","breakpoint","bytearray","bytes","callable","chr","classmethod","compile","complex","delattr","dict","dir","divmod","enumerate","eval","exec","filter","float","format","frozenset","getattr","globals","hasattr","hash","help","hex","id","input","int","isinstance","issubclass","iter","len","list","locals","map","max","memoryview","min","next","object","oct","open","ord","pow","print","property","range","repr","reversed","round","set","setattr","slice","sorted","staticmethod","str","sum","super","tuple","type","vars","zip"], -literal:["__debug__","Ellipsis","False","None","NotImplemented","True"], -type:["Any","Callable","Coroutine","Dict","List","Literal","Generic","Optional","Sequence","Set","Tuple","Type","Union"] -},t={className:"meta",begin:/^(>>>|\.\.\.) /},a={className:"subst",begin:/\{/, -end:/\}/,keywords:n,illegal:/#/},i={begin:/\{\{/,relevance:0},s={ -className:"string",contains:[e.BACKSLASH_ESCAPE],variants:[{ -begin:/([uU]|[bB]|[rR]|[bB][rR]|[rR][bB])?'''/,end:/'''/, -contains:[e.BACKSLASH_ESCAPE,t],relevance:10},{ -begin:/([uU]|[bB]|[rR]|[bB][rR]|[rR][bB])?"""/,end:/"""/, -contains:[e.BACKSLASH_ESCAPE,t],relevance:10},{ -begin:/([fF][rR]|[rR][fF]|[fF])'''/,end:/'''/, -contains:[e.BACKSLASH_ESCAPE,t,i,a]},{begin:/([fF][rR]|[rR][fF]|[fF])"""/, -end:/"""/,contains:[e.BACKSLASH_ESCAPE,t,i,a]},{begin:/([uU]|[rR])'/,end:/'/, -relevance:10},{begin:/([uU]|[rR])"/,end:/"/,relevance:10},{ -begin:/([bB]|[bB][rR]|[rR][bB])'/,end:/'/},{begin:/([bB]|[bB][rR]|[rR][bB])"/, -end:/"/},{begin:/([fF][rR]|[rR][fF]|[fF])'/,end:/'/, -contains:[e.BACKSLASH_ESCAPE,i,a]},{begin:/([fF][rR]|[rR][fF]|[fF])"/,end:/"/, -contains:[e.BACKSLASH_ESCAPE,i,a]},e.APOS_STRING_MODE,e.QUOTE_STRING_MODE] -},r="[0-9](_?[0-9])*",o=`(\\b(${r}))?\\.(${r})|\\b(${r})\\.`,l={ -className:"number",relevance:0,variants:[{ -begin:`(\\b(${r})|(${o}))[eE][+-]?(${r})[jJ]?\\b`},{begin:`(${o})[jJ]?`},{ -begin:"\\b([1-9](_?[0-9])*|0+(_?0)*)[lLjJ]?\\b"},{ -begin:"\\b0[bB](_?[01])+[lL]?\\b"},{begin:"\\b0[oO](_?[0-7])+[lL]?\\b"},{ -begin:"\\b0[xX](_?[0-9a-fA-F])+[lL]?\\b"},{begin:`\\b(${r})[jJ]\\b`}]},c={ -className:"comment",begin:g(/# type:/),end:/$/,keywords:n,contains:[{ -begin:/# type:/},{begin:/#/,end:/\b\B/,endsWithParent:!0}]},d={ -className:"params",variants:[{className:"",begin:/\(\s*\)/,skip:!0},{begin:/\(/, -end:/\)/,excludeBegin:!0,excludeEnd:!0,keywords:n, -contains:["self",t,l,s,e.HASH_COMMENT_MODE]}]};return a.contains=[s,l,t],{ -name:"Python",aliases:["py","gyp","ipython"],keywords:n, -illegal:/(<\/|->|\?)|=>/,contains:[t,l,{begin:/\bself\b/},{beginKeywords:"if", -relevance:0},s,c,e.HASH_COMMENT_MODE,{match:[/def/,/\s+/,h],scope:{1:"keyword", -3:"title.function"},contains:[d]},{variants:[{ -match:[/class/,/\s+/,h,/\s*/,/\(\s*/,h,/\s*\)/]},{match:[/class/,/\s+/,h]}], -scope:{1:"keyword",3:"title.class",6:"title.class.inherited"}},{ -className:"meta",begin:/^[\t ]*@/,end:/(?=#)|$/,contains:[l,d,s]}]}}, -grmr_python_repl:e=>({aliases:["pycon"],contains:[{className:"meta",starts:{ -end:/ |$/,starts:{end:"$",subLanguage:"python"}},variants:[{ -begin:/^>>>(?=[ ]|$)/},{begin:/^\.\.\.(?=[ ]|$)/}]}]}),grmr_r:e=>{ -const n=/(?:(?:[a-zA-Z]|\.[._a-zA-Z])[._a-zA-Z0-9]*)|\.(?!\d)/;return{name:"R", -illegal:/->/,keywords:{$pattern:n, -keyword:"function if in break next repeat else for while", -literal:"NULL NA TRUE FALSE Inf NaN NA_integer_|10 NA_real_|10 NA_character_|10 NA_complex_|10", -built_in:"LETTERS letters month.abb month.name pi T F abs acos acosh all any anyNA Arg as.call as.character as.complex as.double as.environment as.integer as.logical as.null.default as.numeric as.raw asin asinh atan atanh attr attributes baseenv browser c call ceiling class Conj cos cosh cospi cummax cummin cumprod cumsum digamma dim dimnames emptyenv exp expression floor forceAndCall gamma gc.time globalenv Im interactive invisible is.array is.atomic is.call is.character is.complex is.double is.environment is.expression is.finite is.function is.infinite is.integer is.language is.list is.logical is.matrix is.na is.name is.nan is.null is.numeric is.object is.pairlist is.raw is.recursive is.single is.symbol lazyLoadDBfetch length lgamma list log max min missing Mod names nargs nzchar oldClass on.exit pos.to.env proc.time prod quote range Re rep retracemem return round seq_along seq_len seq.int sign signif sin sinh sinpi sqrt standardGeneric substitute sum switch tan tanh tanpi tracemem trigamma trunc unclass untracemem UseMethod xtfrm" -},contains:[e.COMMENT(/#'/,/$/,{contains:[{className:"doctag",begin:"@examples", -starts:{contains:[{begin:/\n/},{begin:/#'\s*(?=@[a-zA-Z]+)/,endsParent:!0},{ -begin:/#'/,end:/$/,excludeBegin:!0}]}},{className:"doctag",begin:"@param", -end:/$/,contains:[{className:"variable",variants:[{begin:n},{ -begin:/`(?:\\.|[^`\\])+`/}],endsParent:!0}]},{className:"doctag", -begin:/@[a-zA-Z]+/},{className:"keyword",begin:/\\[a-zA-Z]+/}] -}),e.HASH_COMMENT_MODE,{className:"string",contains:[e.BACKSLASH_ESCAPE], -variants:[e.END_SAME_AS_BEGIN({begin:/[rR]"(-*)\(/,end:/\)(-*)"/ -}),e.END_SAME_AS_BEGIN({begin:/[rR]"(-*)\{/,end:/\}(-*)"/ -}),e.END_SAME_AS_BEGIN({begin:/[rR]"(-*)\[/,end:/\](-*)"/ -}),e.END_SAME_AS_BEGIN({begin:/[rR]'(-*)\(/,end:/\)(-*)'/ -}),e.END_SAME_AS_BEGIN({begin:/[rR]'(-*)\{/,end:/\}(-*)'/ -}),e.END_SAME_AS_BEGIN({begin:/[rR]'(-*)\[/,end:/\](-*)'/}),{begin:'"',end:'"', -relevance:0},{begin:"'",end:"'",relevance:0}]},{relevance:0,className:{ -2:"number"},variants:[{ -match:[/[^a-zA-Z0-9._]/,/0[xX][0-9a-fA-F]+\.[0-9a-fA-F]*[pP][+-]?\d+i?/]},{ -match:[/[^a-zA-Z0-9._]/,/0[xX][0-9a-fA-F]+(?:[pP][+-]?\d+)?[Li]?/]},{ -match:[/[^a-zA-Z0-9._]/,/(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?[Li]?/]}]},{ -begin:"%",end:"%"},{begin:b(/[a-zA-Z][a-zA-Z_0-9]*/,"\\s+<-\\s+")},{begin:"`", -end:"`",contains:[{begin:/\\./}]}]}},grmr_ruby:e=>{ -const n="([a-zA-Z_]\\w*[!?=]?|[-+~]@|<<|>>|=~|===?|<=>|[<>]=?|\\*\\*|[-/+%^&*~`|]|\\[\\]=?)",t={ -keyword:"and then defined module in return redo if BEGIN retry end for self when next until do begin unless END rescue else break undef not super class case require yield alias while ensure elsif or include attr_reader attr_writer attr_accessor __FILE__", -built_in:"proc lambda",literal:"true false nil"},a={className:"doctag", -begin:"@[A-Za-z]+"},i={begin:"#<",end:">"},s=[e.COMMENT("#","$",{contains:[a] -}),e.COMMENT("^=begin","^=end",{contains:[a],relevance:10 -}),e.COMMENT("^__END__","\\n$")],r={className:"subst",begin:/#\{/,end:/\}/, -keywords:t},o={className:"string",contains:[e.BACKSLASH_ESCAPE,r],variants:[{ -begin:/'/,end:/'/},{begin:/"/,end:/"/},{begin:/`/,end:/`/},{begin:/%[qQwWx]?\(/, -end:/\)/},{begin:/%[qQwWx]?\[/,end:/\]/},{begin:/%[qQwWx]?\{/,end:/\}/},{ -begin:/%[qQwWx]?/},{begin:/%[qQwWx]?\//,end:/\//},{begin:/%[qQwWx]?%/, -end:/%/},{begin:/%[qQwWx]?-/,end:/-/},{begin:/%[qQwWx]?\|/,end:/\|/},{ -begin:/\B\?(\\\d{1,3})/},{begin:/\B\?(\\x[A-Fa-f0-9]{1,2})/},{ -begin:/\B\?(\\u\{?[A-Fa-f0-9]{1,6}\}?)/},{ -begin:/\B\?(\\M-\\C-|\\M-\\c|\\c\\M-|\\M-|\\C-\\M-)[\x20-\x7e]/},{ -begin:/\B\?\\(c|C-)[\x20-\x7e]/},{begin:/\B\?\\?\S/},{ -begin:b(/<<[-~]?'?/,g(/(\w+)(?=\W)[^\n]*\n(?:[^\n]*\n)*?\s*\1\b/)), -contains:[e.END_SAME_AS_BEGIN({begin:/(\w+)/,end:/(\w+)/, -contains:[e.BACKSLASH_ESCAPE,r]})]}]},l="[0-9](_?[0-9])*",c={className:"number", -relevance:0,variants:[{ -begin:`\\b([1-9](_?[0-9])*|0)(\\.(${l}))?([eE][+-]?(${l})|r)?i?\\b`},{ -begin:"\\b0[dD][0-9](_?[0-9])*r?i?\\b"},{begin:"\\b0[bB][0-1](_?[0-1])*r?i?\\b" -},{begin:"\\b0[oO][0-7](_?[0-7])*r?i?\\b"},{ -begin:"\\b0[xX][0-9a-fA-F](_?[0-9a-fA-F])*r?i?\\b"},{ -begin:"\\b0(_?[0-7])+r?i?\\b"}]},d={className:"params",begin:"\\(",end:"\\)", -endsParent:!0,keywords:t},u=[o,{className:"class",beginKeywords:"class module", -end:"$|;",illegal:/=/,contains:[e.inherit(e.TITLE_MODE,{ -begin:"[A-Za-z_]\\w*(::\\w+)*(\\?|!)?"}),{begin:"<\\s*",contains:[{ -begin:"("+e.IDENT_RE+"::)?"+e.IDENT_RE,relevance:0}]}].concat(s)},{ -className:"function",begin:b(/def\s+/,g(n+"\\s*(\\(|;|$)")),relevance:0, -keywords:"def",end:"$|;",contains:[e.inherit(e.TITLE_MODE,{begin:n -}),d].concat(s)},{begin:e.IDENT_RE+"::"},{className:"symbol", -begin:e.UNDERSCORE_IDENT_RE+"(!|\\?)?:",relevance:0},{className:"symbol", -begin:":(?!\\s)",contains:[o,{begin:n}],relevance:0},c,{className:"variable", -begin:"(\\$\\W)|((\\$|@@?)(\\w+))(?=[^@$?])(?![A-Za-z])(?![@$?'])"},{ -className:"params",begin:/\|/,end:/\|/,relevance:0,keywords:t},{ -begin:"("+e.RE_STARTERS_RE+"|unless)\\s*",keywords:"unless",contains:[{ -className:"regexp",contains:[e.BACKSLASH_ESCAPE,r],illegal:/\n/,variants:[{ -begin:"/",end:"/[a-z]*"},{begin:/%r\{/,end:/\}[a-z]*/},{begin:"%r\\(", -end:"\\)[a-z]*"},{begin:"%r!",end:"![a-z]*"},{begin:"%r\\[",end:"\\][a-z]*"}] -}].concat(i,s),relevance:0}].concat(i,s);r.contains=u,d.contains=u;const m=[{ -begin:/^\s*=>/,starts:{end:"$",contains:u}},{className:"meta", -begin:"^([>?]>|[\\w#]+\\(\\w+\\):\\d+:\\d+>|(\\w+-)?\\d+\\.\\d+\\.\\d+(p\\d+)?[^\\d][^>]+>)(?=[ ])", -starts:{end:"$",contains:u}}];return s.unshift(i),{name:"Ruby", -aliases:["rb","gemspec","podspec","thor","irb"],keywords:t,illegal:/\/\*/, -contains:[e.SHEBANG({binary:"ruby"})].concat(m).concat(s).concat(u)}}, -grmr_rust:e=>{const n={className:"title.function.invoke",relevance:0, -begin:b(/\b/,/(?!let\b)/,e.IDENT_RE,g(/\s*\(/)) -},t="([ui](8|16|32|64|128|size)|f(32|64))?",a=["drop ","Copy","Send","Sized","Sync","Drop","Fn","FnMut","FnOnce","ToOwned","Clone","Debug","PartialEq","PartialOrd","Eq","Ord","AsRef","AsMut","Into","From","Default","Iterator","Extend","IntoIterator","DoubleEndedIterator","ExactSizeIterator","SliceConcatExt","ToString","assert!","assert_eq!","bitflags!","bytes!","cfg!","col!","concat!","concat_idents!","debug_assert!","debug_assert_eq!","env!","panic!","file!","format!","format_args!","include_bin!","include_str!","line!","local_data_key!","module_path!","option_env!","print!","println!","select!","stringify!","try!","unimplemented!","unreachable!","vec!","write!","writeln!","macro_rules!","assert_ne!","debug_assert_ne!"] -;return{name:"Rust",aliases:["rs"],keywords:{$pattern:e.IDENT_RE+"!?", -type:["i8","i16","i32","i64","i128","isize","u8","u16","u32","u64","u128","usize","f32","f64","str","char","bool","Box","Option","Result","String","Vec"], -keyword:["abstract","as","async","await","become","box","break","const","continue","crate","do","dyn","else","enum","extern","false","final","fn","for","if","impl","in","let","loop","macro","match","mod","move","mut","override","priv","pub","ref","return","self","Self","static","struct","super","trait","true","try","type","typeof","unsafe","unsized","use","virtual","where","while","yield"], -literal:["true","false","Some","None","Ok","Err"],built_in:a},illegal:""},n]}}, -grmr_scss:e=>{const n=ee(e),t=ie,a=ae,i="@[a-z-]+",s={className:"variable", -begin:"(\\$[a-zA-Z-][a-zA-Z0-9_-]*)\\b"};return{name:"SCSS",case_insensitive:!0, -illegal:"[=/|']",contains:[e.C_LINE_COMMENT_MODE,e.C_BLOCK_COMMENT_MODE,{ -className:"selector-id",begin:"#[A-Za-z0-9_-]+",relevance:0},{ -className:"selector-class",begin:"\\.[A-Za-z0-9_-]+",relevance:0 -},n.ATTRIBUTE_SELECTOR_MODE,{className:"selector-tag", -begin:"\\b("+ne.join("|")+")\\b",relevance:0},{className:"selector-pseudo", -begin:":("+a.join("|")+")"},{className:"selector-pseudo", -begin:"::("+t.join("|")+")"},s,{begin:/\(/,end:/\)/,contains:[n.CSS_NUMBER_MODE] -},{className:"attribute",begin:"\\b("+se.join("|")+")\\b"},{ -begin:"\\b(whitespace|wait|w-resize|visible|vertical-text|vertical-ideographic|uppercase|upper-roman|upper-alpha|underline|transparent|top|thin|thick|text|text-top|text-bottom|tb-rl|table-header-group|table-footer-group|sw-resize|super|strict|static|square|solid|small-caps|separate|se-resize|scroll|s-resize|rtl|row-resize|ridge|right|repeat|repeat-y|repeat-x|relative|progress|pointer|overline|outside|outset|oblique|nowrap|not-allowed|normal|none|nw-resize|no-repeat|no-drop|newspaper|ne-resize|n-resize|move|middle|medium|ltr|lr-tb|lowercase|lower-roman|lower-alpha|loose|list-item|line|line-through|line-edge|lighter|left|keep-all|justify|italic|inter-word|inter-ideograph|inside|inset|inline|inline-block|inherit|inactive|ideograph-space|ideograph-parenthesis|ideograph-numeric|ideograph-alpha|horizontal|hidden|help|hand|groove|fixed|ellipsis|e-resize|double|dotted|distribute|distribute-space|distribute-letter|distribute-all-lines|disc|disabled|default|decimal|dashed|crosshair|collapse|col-resize|circle|char|center|capitalize|break-word|break-all|bottom|both|bolder|bold|block|bidi-override|below|baseline|auto|always|all-scroll|absolute|table|table-cell)\\b" -},{begin:":",end:";", -contains:[s,n.HEXCOLOR,n.CSS_NUMBER_MODE,e.QUOTE_STRING_MODE,e.APOS_STRING_MODE,n.IMPORTANT] -},{begin:"@(page|font-face)",keywords:{$pattern:i,keyword:"@page @font-face"}},{ -begin:"@",end:"[{;]",returnBegin:!0,keywords:{$pattern:/[a-z-]+/, -keyword:"and or not only",attribute:te.join(" ")},contains:[{begin:i, -className:"keyword"},{begin:/[a-z-]+(?=:)/,className:"attribute" -},s,e.QUOTE_STRING_MODE,e.APOS_STRING_MODE,n.HEXCOLOR,n.CSS_NUMBER_MODE]}]}}, -grmr_shell:e=>({name:"Shell Session",aliases:["console","shellsession"], -contains:[{className:"meta",begin:/^\s{0,3}[/~\w\d[\]()@-]*[>%$#][ ]?/,starts:{ -end:/[^\\](?=\s*$)/,subLanguage:"bash"}}]}),grmr_sql:e=>{ -const n=e.COMMENT("--","$"),t=["true","false","unknown"],a=["bigint","binary","blob","boolean","char","character","clob","date","dec","decfloat","decimal","float","int","integer","interval","nchar","nclob","national","numeric","real","row","smallint","time","timestamp","varchar","varying","varbinary"],i=["abs","acos","array_agg","asin","atan","avg","cast","ceil","ceiling","coalesce","corr","cos","cosh","count","covar_pop","covar_samp","cume_dist","dense_rank","deref","element","exp","extract","first_value","floor","json_array","json_arrayagg","json_exists","json_object","json_objectagg","json_query","json_table","json_table_primitive","json_value","lag","last_value","lead","listagg","ln","log","log10","lower","max","min","mod","nth_value","ntile","nullif","percent_rank","percentile_cont","percentile_disc","position","position_regex","power","rank","regr_avgx","regr_avgy","regr_count","regr_intercept","regr_r2","regr_slope","regr_sxx","regr_sxy","regr_syy","row_number","sin","sinh","sqrt","stddev_pop","stddev_samp","substring","substring_regex","sum","tan","tanh","translate","translate_regex","treat","trim","trim_array","unnest","upper","value_of","var_pop","var_samp","width_bucket"],s=["create table","insert into","primary key","foreign key","not null","alter table","add constraint","grouping sets","on overflow","character set","respect nulls","ignore nulls","nulls first","nulls last","depth first","breadth first"],r=i,o=["abs","acos","all","allocate","alter","and","any","are","array","array_agg","array_max_cardinality","as","asensitive","asin","asymmetric","at","atan","atomic","authorization","avg","begin","begin_frame","begin_partition","between","bigint","binary","blob","boolean","both","by","call","called","cardinality","cascaded","case","cast","ceil","ceiling","char","char_length","character","character_length","check","classifier","clob","close","coalesce","collate","collect","column","commit","condition","connect","constraint","contains","convert","copy","corr","corresponding","cos","cosh","count","covar_pop","covar_samp","create","cross","cube","cume_dist","current","current_catalog","current_date","current_default_transform_group","current_path","current_role","current_row","current_schema","current_time","current_timestamp","current_path","current_role","current_transform_group_for_type","current_user","cursor","cycle","date","day","deallocate","dec","decimal","decfloat","declare","default","define","delete","dense_rank","deref","describe","deterministic","disconnect","distinct","double","drop","dynamic","each","element","else","empty","end","end_frame","end_partition","end-exec","equals","escape","every","except","exec","execute","exists","exp","external","extract","false","fetch","filter","first_value","float","floor","for","foreign","frame_row","free","from","full","function","fusion","get","global","grant","group","grouping","groups","having","hold","hour","identity","in","indicator","initial","inner","inout","insensitive","insert","int","integer","intersect","intersection","interval","into","is","join","json_array","json_arrayagg","json_exists","json_object","json_objectagg","json_query","json_table","json_table_primitive","json_value","lag","language","large","last_value","lateral","lead","leading","left","like","like_regex","listagg","ln","local","localtime","localtimestamp","log","log10","lower","match","match_number","match_recognize","matches","max","member","merge","method","min","minute","mod","modifies","module","month","multiset","national","natural","nchar","nclob","new","no","none","normalize","not","nth_value","ntile","null","nullif","numeric","octet_length","occurrences_regex","of","offset","old","omit","on","one","only","open","or","order","out","outer","over","overlaps","overlay","parameter","partition","pattern","per","percent","percent_rank","percentile_cont","percentile_disc","period","portion","position","position_regex","power","precedes","precision","prepare","primary","procedure","ptf","range","rank","reads","real","recursive","ref","references","referencing","regr_avgx","regr_avgy","regr_count","regr_intercept","regr_r2","regr_slope","regr_sxx","regr_sxy","regr_syy","release","result","return","returns","revoke","right","rollback","rollup","row","row_number","rows","running","savepoint","scope","scroll","search","second","seek","select","sensitive","session_user","set","show","similar","sin","sinh","skip","smallint","some","specific","specifictype","sql","sqlexception","sqlstate","sqlwarning","sqrt","start","static","stddev_pop","stddev_samp","submultiset","subset","substring","substring_regex","succeeds","sum","symmetric","system","system_time","system_user","table","tablesample","tan","tanh","then","time","timestamp","timezone_hour","timezone_minute","to","trailing","translate","translate_regex","translation","treat","trigger","trim","trim_array","true","truncate","uescape","union","unique","unknown","unnest","update","upper","user","using","value","values","value_of","var_pop","var_samp","varbinary","varchar","varying","versioning","when","whenever","where","width_bucket","window","with","within","without","year","add","asc","collation","desc","final","first","last","view"].filter((e=>!i.includes(e))),l={ -begin:b(/\b/,m(...r),/\s*\(/),relevance:0,keywords:{built_in:r}};return{ -name:"SQL",case_insensitive:!0,illegal:/[{}]|<\//,keywords:{ -$pattern:/\b[\w\.]+/,keyword:((e,{exceptions:n,when:t}={})=>{const a=t -;return n=n||[],e.map((e=>e.match(/\|\d+$/)||n.includes(e)?e:a(e)?e+"|0":e)) -})(o,{when:e=>e.length<3}),literal:t,type:a, -built_in:["current_catalog","current_date","current_default_transform_group","current_path","current_role","current_schema","current_transform_group_for_type","current_user","session_user","system_time","system_user","current_time","localtime","current_timestamp","localtimestamp"] -},contains:[{begin:m(...s),relevance:0,keywords:{$pattern:/[\w\.]+/, -keyword:o.concat(s),literal:t,type:a}},{className:"type", -begin:m("double precision","large object","with timezone","without timezone") -},l,{className:"variable",begin:/@[a-z0-9]+/},{className:"string",variants:[{ -begin:/'/,end:/'/,contains:[{begin:/''/}]}]},{begin:/"/,end:/"/,contains:[{ -begin:/""/}]},e.C_NUMBER_MODE,e.C_BLOCK_COMMENT_MODE,n,{className:"operator", -begin:/[-+*/=%^~]|&&?|\|\|?|!=?|<(?:=>?|<|>)?|>[>=]?/,relevance:0}]}}, -grmr_swift:e=>{const n={match:/\s+/,relevance:0},t=e.COMMENT("/\\*","\\*/",{ -contains:["self"]}),a=[e.C_LINE_COMMENT_MODE,t],i={match:[/\./,m(...Ne,...we)], -className:{2:"keyword"}},s={match:b(/\./,m(...Oe)),relevance:0 -},r=Oe.filter((e=>"string"==typeof e)).concat(["_|0"]),o={variants:[{ -className:"keyword", -match:m(...Oe.filter((e=>"string"!=typeof e)).concat(ve).map(ye),...we)}]},l={ -$pattern:m(/\b\w+/,/#\w+/),keyword:r.concat(Se),literal:Me},c=[i,s,o],d=[{ -match:b(/\./,m(...ke)),relevance:0},{className:"built_in", -match:b(/\b/,m(...ke),/(?=\()/)}],u={match:/->/,relevance:0},p=[u,{ -className:"operator",relevance:0,variants:[{match:Te},{match:`\\.(\\.|${Ce})+`}] -}],_="([0-9a-fA-F]_*)+",f={className:"number",relevance:0,variants:[{ -match:"\\b(([0-9]_*)+)(\\.(([0-9]_*)+))?([eE][+-]?(([0-9]_*)+))?\\b"},{ -match:`\\b0x(${_})(\\.(${_}))?([pP][+-]?(([0-9]_*)+))?\\b`},{ -match:/\b0o([0-7]_*)+\b/},{match:/\b0b([01]_*)+\b/}]},h=(e="")=>({ -className:"subst",variants:[{match:b(/\\/,e,/[0\\tnr"']/)},{ -match:b(/\\/,e,/u\{[0-9a-fA-F]{1,8}\}/)}]}),E=(e="")=>({className:"subst", -match:b(/\\/,e,/[\t ]*(?:[\r\n]|\r\n)/)}),y=(e="")=>({className:"subst", -label:"interpol",begin:b(/\\/,e,/\(/),end:/\)/}),N=(e="")=>({begin:b(e,/"""/), -end:b(/"""/,e),contains:[h(e),E(e),y(e)]}),w=(e="")=>({begin:b(e,/"/), -end:b(/"/,e),contains:[h(e),y(e)]}),v={className:"string", -variants:[N(),N("#"),N("##"),N("###"),w(),w("#"),w("##"),w("###")]},O={ -match:b(/`/,Ie,/`/)},M=[O,{className:"variable",match:/\$\d+/},{ -className:"variable",match:`\\$${De}+`}],x=[{match:/(@|#)available/, -className:"keyword",starts:{contains:[{begin:/\(/,end:/\)/,keywords:$e, -contains:[...p,f,v]}]}},{className:"keyword",match:b(/@/,m(...Le))},{ -className:"meta",match:b(/@/,Ie)}],S={match:g(/\b[A-Z]/),relevance:0,contains:[{ -className:"type", -match:b(/(AV|CA|CF|CG|CI|CL|CM|CN|CT|MK|MP|MTK|MTL|NS|SCN|SK|UI|WK|XC)/,De,"+") -},{className:"type",match:Be,relevance:0},{match:/[?!]+/,relevance:0},{ -match:/\.\.\./,relevance:0},{match:b(/\s+&\s+/,g(Be)),relevance:0}]},k={ -begin://,keywords:l,contains:[...a,...c,...x,u,S]};S.contains.push(k) -;const A={begin:/\(/,end:/\)/,relevance:0,keywords:l,contains:["self",{ -match:b(Ie,/\s*:/),keywords:"_|0",relevance:0 -},...a,...c,...d,...p,f,v,...M,...x,S]},C={begin://,contains:[...a,S] -},T={begin:/\(/,end:/\)/,keywords:l,contains:[{ -begin:m(g(b(Ie,/\s*:/)),g(b(Ie,/\s+/,Ie,/\s*:/))),end:/:/,relevance:0, -contains:[{className:"keyword",match:/\b_\b/},{className:"params",match:Ie}] -},...a,...c,...p,f,v,...x,S,A],endsParent:!0,illegal:/["']/},R={ -match:[/func/,/\s+/,m(O.match,Ie,Te)],className:{1:"keyword",3:"title.function" -},contains:[C,T,n],illegal:[/\[/,/%/]},D={ -match:[/\b(?:subscript|init[?!]?)/,/\s*(?=[<(])/],className:{1:"keyword"}, -contains:[C,T,n],illegal:/\[|%/},I={match:[/operator/,/\s+/,Te],className:{ -1:"keyword",3:"title"}},B={begin:[/precedencegroup/,/\s+/,Be],className:{ -1:"keyword",3:"title"},contains:[S],keywords:[...xe,...Me],end:/}/} -;for(const e of v.variants){const n=e.contains.find((e=>"interpol"===e.label)) -;n.keywords=l;const t=[...c,...d,...p,f,v,...M];n.contains=[...t,{begin:/\(/, -end:/\)/,contains:["self",...t]}]}return{name:"Swift",keywords:l, -contains:[...a,R,D,{beginKeywords:"struct protocol class extension enum actor", -end:"\\{",excludeEnd:!0,keywords:l,contains:[e.inherit(e.TITLE_MODE,{ -className:"title.class",begin:/[A-Za-z$_][\u00C0-\u02B80-9A-Za-z$_]*/}),...c] -},I,B,{beginKeywords:"import",end:/$/,contains:[...a],relevance:0 -},...c,...d,...p,f,v,...M,...x,S,A]}},grmr_typescript:e=>{const n={$pattern:ge, -keyword:ue.concat(["type","namespace","typedef","interface","public","private","protected","implements","declare","abstract","readonly"]), -literal:be, -built_in:he.concat(["any","void","number","boolean","string","object","never","enum"]), -"variable.language":fe},t={className:"meta",begin:"@[A-Za-z$_][0-9A-Za-z$_]*" -},a=(e,n,t)=>{const a=e.contains.findIndex((e=>e.label===n)) -;if(-1===a)throw Error("can not find mode to replace");e.contains.splice(a,1,t) -},i=Ee(e) -;return Object.assign(i.keywords,n),i.exports.PARAMS_CONTAINS.push(t),i.contains=i.contains.concat([t,{ -beginKeywords:"namespace",end:/\{/,excludeEnd:!0},{beginKeywords:"interface", -end:/\{/,excludeEnd:!0,keywords:"interface extends" -}]),a(i,"shebang",e.SHEBANG()),a(i,"use_strict",{className:"meta",relevance:10, -begin:/^\s*['"]use strict['"]/ -}),i.contains.find((e=>"func.def"===e.label)).relevance=0,Object.assign(i,{ -name:"TypeScript",aliases:["ts","tsx"]}),i},grmr_vbnet:e=>{ -const n=/\d{1,2}\/\d{1,2}\/\d{4}/,t=/\d{4}-\d{1,2}-\d{1,2}/,a=/(\d|1[012])(:\d+){0,2} *(AM|PM)/,i=/\d{1,2}(:\d{1,2}){1,2}/,s={ -className:"literal",variants:[{begin:b(/# */,m(t,n),/ *#/)},{ -begin:b(/# */,i,/ *#/)},{begin:b(/# */,a,/ *#/)},{ -begin:b(/# */,m(t,n),/ +/,m(a,i),/ *#/)}]},r=e.COMMENT(/'''/,/$/,{contains:[{ -className:"doctag",begin:/<\/?/,end:/>/}]}),o=e.COMMENT(null,/$/,{variants:[{ -begin:/'/},{begin:/([\t ]|^)REM(?=\s)/}]});return{name:"Visual Basic .NET", -aliases:["vb"],case_insensitive:!0,classNameAliases:{label:"symbol"},keywords:{ -keyword:"addhandler alias aggregate ansi as async assembly auto binary by byref byval call case catch class compare const continue custom declare default delegate dim distinct do each equals else elseif end enum erase error event exit explicit finally for friend from function get global goto group handles if implements imports in inherits interface into iterator join key let lib loop me mid module mustinherit mustoverride mybase myclass namespace narrowing new next notinheritable notoverridable of off on operator option optional order overloads overridable overrides paramarray partial preserve private property protected public raiseevent readonly redim removehandler resume return select set shadows shared skip static step stop structure strict sub synclock take text then throw to try unicode until using when where while widening with withevents writeonly yield", -built_in:"addressof and andalso await directcast gettype getxmlnamespace is isfalse isnot istrue like mod nameof new not or orelse trycast typeof xor cbool cbyte cchar cdate cdbl cdec cint clng cobj csbyte cshort csng cstr cuint culng cushort", -type:"boolean byte char date decimal double integer long object sbyte short single string uinteger ulong ushort", -literal:"true false nothing"}, -illegal:"//|\\{|\\}|endif|gosub|variant|wend|^\\$ ",contains:[{ -className:"string",begin:/"(""|[^/n])"C\b/},{className:"string",begin:/"/, -end:/"/,illegal:/\n/,contains:[{begin:/""/}]},s,{className:"number",relevance:0, -variants:[{begin:/\b\d[\d_]*((\.[\d_]+(E[+-]?[\d_]+)?)|(E[+-]?[\d_]+))[RFD@!#]?/ -},{begin:/\b\d[\d_]*((U?[SIL])|[%&])?/},{begin:/&H[\dA-F_]+((U?[SIL])|[%&])?/},{ -begin:/&O[0-7_]+((U?[SIL])|[%&])?/},{begin:/&B[01_]+((U?[SIL])|[%&])?/}]},{ -className:"label",begin:/^\w+:/},r,o,{className:"meta", -begin:/[\t ]*#(const|disable|else|elseif|enable|end|externalsource|if|region)\b/, -end:/$/,keywords:{ -keyword:"const disable else elseif enable end externalsource if region then"}, -contains:[o]}]}},grmr_yaml:e=>{ -const n="true false yes no null",t="[\\w#;/?:@&=+$,.~*'()[\\]]+",a={ -className:"string",relevance:0,variants:[{begin:/'/,end:/'/},{begin:/"/,end:/"/ -},{begin:/\S+/}],contains:[e.BACKSLASH_ESCAPE,{className:"template-variable", -variants:[{begin:/\{\{/,end:/\}\}/},{begin:/%\{/,end:/\}/}]}]},i=e.inherit(a,{ -variants:[{begin:/'/,end:/'/},{begin:/"/,end:/"/},{begin:/[^\s,{}[\]]+/}]}),s={ -end:",",endsWithParent:!0,excludeEnd:!0,keywords:n,relevance:0},r={begin:/\{/, -end:/\}/,contains:[s],illegal:"\\n",relevance:0},o={begin:"\\[",end:"\\]", -contains:[s],illegal:"\\n",relevance:0},l=[{className:"attr",variants:[{ -begin:"\\w[\\w :\\/.-]*:(?=[ \t]|$)"},{begin:'"\\w[\\w :\\/.-]*":(?=[ \t]|$)'},{ -begin:"'\\w[\\w :\\/.-]*':(?=[ \t]|$)"}]},{className:"meta",begin:"^---\\s*$", -relevance:10},{className:"string", -begin:"[\\|>]([1-9]?[+-])?[ ]*\\n( +)[^ ][^\\n]*\\n(\\2[^\\n]+\\n?)*"},{ -begin:"<%[%=-]?",end:"[%-]?%>",subLanguage:"ruby",excludeBegin:!0,excludeEnd:!0, -relevance:0},{className:"type",begin:"!\\w+!"+t},{className:"type", -begin:"!<"+t+">"},{className:"type",begin:"!"+t},{className:"type",begin:"!!"+t -},{className:"meta",begin:"&"+e.UNDERSCORE_IDENT_RE+"$"},{className:"meta", -begin:"\\*"+e.UNDERSCORE_IDENT_RE+"$"},{className:"bullet",begin:"-(?=[ ]|$)", -relevance:0},e.HASH_COMMENT_MODE,{beginKeywords:n,keywords:{literal:n}},{ -className:"number", -begin:"\\b[0-9]{4}(-[0-9][0-9]){0,2}([Tt \\t][0-9][0-9]?(:[0-9][0-9]){2})?(\\.[0-9]*)?([ \\t])*(Z|[-+][0-9][0-9]?(:[0-9][0-9])?)?\\b" -},{className:"number",begin:e.C_NUMBER_RE+"\\b",relevance:0},r,o,a],c=[...l] -;return c.pop(),c.push(i),s.contains=c,{name:"YAML",case_insensitive:!0, -aliases:["yml"],contains:l}}});const Fe=Y;for(const e of Object.keys(ze)){ -const n=e.replace("grmr_","");Fe.registerLanguage(n,ze[e])}return Fe}() -;"object"==typeof exports&&"undefined"!=typeof module&&(module.exports=hljs); \ No newline at end of file diff --git a/themes/mypaper/static/style.css b/themes/mypaper/static/style.css deleted file mode 100644 index 3666589..0000000 --- a/themes/mypaper/static/style.css +++ /dev/null @@ -1,483 +0,0 @@ -/* - * Paper - * A simple, clean, flexible Hugo theme - * https://github.com/nanxiaobei/hugo-paper - * Designed by MR.LEE (https://mrlee.me/) - * Updated in 2020.6.12 - */ - -/* Theme --------------------------------------------------- */ -:root { - --gap: 24px; - --content-gap: 40px; - --nav-width: 1024px; - --main-width: 640px; - --header-height: 60px; - --footer-height: 60px; - --radius: 8px; - - --theme: #fff; - --entry: #fff; - --primary: rgba(0, 0, 0, 0.88); - --secondary: rgba(0, 0, 0, 0.56); - --tertiary: rgba(0, 0, 0, 0.16); - --content: rgba(0, 0, 0, 0.88); - - --hljs-bg: #1c1d21; - --code-bg: #f5f5f5; - --border: #eee; -} -.list { - background: var(--code-bg); -} -/* Reset --------------------------------------------------- */ -*, -*::before, -*::after { - box-sizing: border-box; -} -html { - -webkit-tap-highlight-color: transparent; -} -body { - margin: 0; - color: var(--primary); - font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, - 'Open Sans', 'Helvetica Neue', sans-serif; - font-size: 18px; - line-height: 1.8; - word-break: break-word; - background: var(--theme); -} -article, -aside, -figcaption, -figure, -footer, -header, -hgroup, -main, -nav, -section { - display: block; -} -h1, -h2, -h3, -h4, -h5, -h6 { - margin-top: 0; - margin-bottom: 0; - color: var(--primary); - line-height: 1.2; -} -p { - margin-top: 0; - margin-bottom: 0; -} -strong, -b { - font-weight: bold; -} -ul { - margin: 0; - padding: 0; -} -a { - color: var(--primary); - text-decoration: none; -} -figure { - margin: 0; -} -table { - width: 100%; - border-collapse: collapse; - border-spacing: 0; -} -button, -input, -textarea { - padding: 0; - font: inherit; - background: transparent; - border: 0; - -webkit-appearance: none; -} -button, -input[type='button'], -input[type='submit'] { - cursor: pointer; -} -input, -textarea { - padding: 0; - border: 0; - outline: 0; -} -input:-webkit-autofill, -textarea:-webkit-autofill { - box-shadow: 0 0 0 50px var(--theme) inset; -} -img { - display: block; - max-width: 100%; -} -/* Header --------------------------------------------------- */ -.nav { - display: flex; - flex-wrap: wrap; - justify-content: space-between; - max-width: calc(var(--nav-width) + var(--gap) * 2); - margin-left: auto; - margin-right: auto; -} -.nav a { - display: block; - line-height: var(--header-height); -} -.logo, -.menu { - margin-left: var(--gap); - margin-right: var(--gap); -} -.logo a { - font-size: 24px; - font-weight: 700; -} -.menu { - display: flex; - list-style: none; - word-break: keep-all; - overflow-x: auto; -} -.menu li + li { - margin-left: var(--gap); -} -.menu a { - font-size: 16px; -} -/* Main --------------------------------------------------- */ -.main { - position: relative; - min-height: calc(100vh - var(--header-height) - var(--footer-height)); - max-width: calc(var(--main-width) + var(--gap) * 2); - margin-left: auto; - margin-right: auto; - padding: var(--gap); -} -.page-header { - margin-bottom: 24px; -} -.page-header h1 { - font-size: 40px; -} -.pagination { - display: flex; -} -.pagination a { - color: var(--theme); - font-size: 13px; - line-height: 36px; - background: var(--primary); - border-radius: calc(36px / 2); -} -.pagination .prev { - padding-left: 16px; - padding-right: 18px; -} -.pagination .next { - margin-left: auto; - padding-left: 18px; - padding-right: 16px; -} -/* Post entry --------------------------------------------------- */ -.post-entry { - position: relative; - margin-bottom: var(--gap); - padding: var(--gap); - background: var(--entry); - border-radius: var(--radius); - transition: transform 0.1s; -} -.post-entry:active { - transform: scale(0.96); -} -.tag-entry .entry-content, -.tag-entry .entry-footer { - display: none; -} -.entry-header h2 { - font-size: 24px; -} -.entry-content { - margin-top: 8px; - margin-bottom: 8px; - color: var(--secondary); - font-size: 14px; - line-height: 1.6; - overflow: hidden; - display: -webkit-box; - -webkit-box-orient: vertical; - -webkit-line-clamp: 2; -} -.entry-footer { - color: var(--secondary); - font-size: 13px; -} -.entry-link { - position: absolute; - left: 0; - right: 0; - top: 0; - bottom: 0; -} -/* Post single --------------------------------------------------- */ -.post-header { - margin-top: 24px; - margin-bottom: var(--content-gap); -} -.post-title { - margin-bottom: 2px; - font-size: 40px; - transform: translateX(-2px); -} -.post-meta { - color: var(--secondary); - font-size: 14px; -} -.post-content { - color: var(--content); -} -.post-content h1 { - margin-top: 40px; - margin-bottom: 32px; -} -.post-content h2 { - margin-top: 32px; - margin-bottom: 24px; -} -.post-content h3, -.post-content h4, -.post-content h5, -.post-content h6 { - margin-top: 24px; - margin-bottom: 16px; -} -.post-content h1 { - font-size: 40px; -} -.post-content h2 { - font-size: 32px; -} -.post-content h3 { - font-size: 24px; -} -.post-content h4 { - font-size: 16px; -} -.post-content h5 { - font-size: 14px; -} -.post-content h6 { - font-size: 12px; -} -.post-content a { - box-shadow: 0 1px 0 var(--primary); -} -.post-content a code { - margin-left: 0; - margin-right: 0; - border-radius: 0; - box-shadow: 0 -1px 0 var(--primary) inset; -} -.post-content del { - text-decoration: none; - background: linear-gradient(to right, var(--primary) 100%, transparent 0) 0 50% / 1px 1px repeat-x; -} -.post-content p, -.post-content ul, -.post-content ol, -.post-content dl { - margin-bottom: var(--content-gap); -} -.post-content ul, -.post-content ol { - padding-left: 20px; -} -.post-content li { - margin-top: 5px; -} -.post-content li p { - margin-bottom: 0; -} -.post-content dl { - display: flex; - flex-wrap: wrap; - margin: 0; -} -.post-content dt { - width: 25%; - font-weight: 700; -} -.post-content dd { - width: 75%; - margin-left: 0; - padding-left: 10px; -} -.post-content dt ~ dt, -.post-content dd ~ dd { - margin-top: 10px; -} -.post-content table { - margin-bottom: 32px; -} -.post-content table th, -.post-content table:not(.highlighttable) td { - min-width: 80px; - padding: 12px 8px; - line-height: 1.5; - border-bottom: 1px solid var(--border); -} -.post-content table th { - font-size: 14px; - text-align: left; -} -.post-content table:not(.highlighttable) td code:only-child { - margin-left: 0; - margin-right: 0; -} -.post-content .highlight, -.post-content pre { - margin-left: calc(var(--gap) * -1); - margin-right: calc(var(--gap) * -1); - margin-bottom: 32px; - background: var(--hljs-bg) !important; - border-radius: var(--radius); - overflow-x: auto; -} -.post-content ul pre { - margin-left: calc(var(--gap) * -2); -} -.post-content .highlight pre { - margin: 0; -} -/* table */ -.post-content .highlighttable { - table-layout: fixed; -} -.post-content .highlighttable td:first-child { - width: 40px; -} -.post-content .highlighttable td .linenodiv { - padding-right: 0 !important; -} -.post-content .highlighttable td .linenodiv pre, -.post-content .highlighttable td .highlight { - margin-bottom: 0; -} -.post-content .highlighttable td .highlight pre code::-webkit-scrollbar { - display: none; -} -/* inline */ -.post-content .highlight span { - background: transparent !important; -} - -.post-content code { - margin-left: 4px; - margin-right: 4px; - padding: 4px 6px; - font-family: Menlo, Monaco, 'Courier New', Courier, monospace; - font-size: 0.78em; - line-height: 1.5; - background: var(--code-bg); - border-radius: 2px; -} -.post-content pre code { - display: block; - margin-left: 0; - margin-right: 0; - padding: var(--gap); - color: rgba(255, 255, 255, 0.8); - background: transparent; - border-radius: 0; -} -.post-content blockquote { - margin: 0 0 0 calc(var(--gap) * -1); - padding: 0 0 0 21px; - border-left: 3px solid var(--primary); -} -.post-content hr { - height: 1px; - margin-top: 56px; - margin-bottom: 56px; - background: var(--tertiary); - border-top: 0; - border-bottom: 0; -} -.post-content iframe { - max-width: 100%; -} -.post-tags li { - display: inline-block; -} -.post-tags li + li { - margin-left: 3px; -} -.post-tags a { - display: block; - padding-left: 14px; - padding-right: 14px; - color: var(--secondary); - font-size: 14px; - line-height: 34px; - background: var(--code-bg); - border-radius: 4px; -} -.post-tags a:hover { - background: var(--border); -} -/* Footer --------------------------------------------------- */ -.footer { - max-width: calc(var(--main-width) + var(--gap) * 2); - margin-left: auto; - margin-right: auto; - padding: calc((var(--footer-height) - var(--gap)) / 2) var(--gap); - color: var(--secondary); - font-size: 12px; - text-align: center; - line-height: 24px; -} -.footer span { - margin-left: 1px; - margin-right: 1px; -} -.footer a { - color: inherit; -} -.footer a:hover { - color: var(--primary); - border-bottom: 1px solid var(--primary); -} -/* 404 --------------------------------------------------- */ -.not-found { - position: absolute; - left: 0; - right: 0; - display: flex; - align-items: center; - justify-content: center; - height: 80%; - font-size: 160px; - font-weight: 700; -} diff --git a/themes/mypaper/theme.toml b/themes/mypaper/theme.toml deleted file mode 100644 index d755a43..0000000 --- a/themes/mypaper/theme.toml +++ /dev/null @@ -1,25 +0,0 @@ -# theme.toml template for a Hugo theme -# See https://github.com/gohugoio/hugoThemes#themetoml for an example - -name = "Mypaper" -license = "MIT" -licenselink = "https://github.com/nsfisis/nsfisis.github.io/blob/main/themes/mypaper/LICENSE" -description = "My modified version of paper theme" -homepage = "https://github.com/nsfisis/nsfisis.github.io/tree/main/themes/mypaper" -tags = ["Responsive", "Simple", "Clean", "Light", "White", "Blog"] -features = ["Responsive", "One Column", "Blog"] -min_version = "0.57.1" - -[[authors]] - name = "nanxiaobei" - homepage = "https://mrlee.me/" - -[[authors]] - name = "nsfisis" - homepage = "https://blog.nsfisis.dev" - -# If porting an existing theme -[original] - name = "paper" - homepage = "https://github.com/nanxiaobei/hugo-paper/" - repo = "https://github.com/nanxiaobei/hugo-paper/" -- cgit v1.2.3-70-g09d2