pagecord-cli 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 99eebd4d84788c1c5176bca0d7b1f036bb54ec2acb9e5f6a9f9fef7b63fc5d1d
-  data.tar.gz: 78d6e0b1623c066f1b9f992cf87e7e80c997ef7abfa2d2f4e6893ba6e34c0f8f
+  metadata.gz: 4e6a9d37234707507835ff1e87b324bccfacc7d680515b9674f0f0fa454cd704
+  data.tar.gz: d0628c7e0c4e1273cb24a870f9db83e9ec25da7f01395eae3503f4aa1900f130
 SHA512:
-  metadata.gz: 27842bcc27c07553c69ee4664aad327ab1d1f6155b3eaccc64d66fbcc699d73d543ae09bf2b406f568e6fca1eab83e0976d8f0ed08f62bd30ec63f57e5836796
-  data.tar.gz: 245f7e50410b5b93daca45d14ead9268f447cd9bada1bf580db1c73d3c5ec5d39207f7dacbf09fb21c98cc2debfba5d0b97f39b8e3b931b2d183dee9ead935cd
+  metadata.gz: 300fd7fe1c31e8ab0196b8a8c0d8509819ec2d0882ea3bbbc98a4c34d4aaac22d05325a4197b4fcd5f1ff79480566c7d764acbd1ee173926e31c004f4b91b510
+  data.tar.gz: d016d8f89cf2150b0a25872543603e19fdf87322ec5a9206c3aa532bf50de98f916df3a83de59c9815d530287ffcddae9236b9f4195ee8ad0c3fb3839b2dede6

data/README.md

@@ -8,6 +8,12 @@ Publish local Markdown and HTML files to [Pagecord](https://pagecord.com).
 gem install pagecord-cli
 ```
 
+Needs Ruby 3.2 or newer. The Ruby that ships with macOS is too old, so:
+
+- **macOS**: `brew install ruby`, or a version manager like [mise](https://mise.jdx.dev)
+- **Windows**: [RubyInstaller](https://rubyinstaller.org)
+- **Linux**: your package manager, if it offers 3.2 or newer; otherwise [mise](https://mise.jdx.dev)
+
 ## Login
 
 Generate an API key from **Settings > API** in Pagecord, then save it locally:
@@ -54,6 +60,25 @@ Remove a saved blog:
 pagecord logout myblog
 ```
 
+## Posts and pages
+
+Read and change posts directly, without a local file:
+
+```bash
+pagecord post list                  # published posts, newest first
+pagecord post list --drafts
+pagecord post show TOKEN            # fields, then the HTML content
+pagecord post update TOKEN --content-file post.html --status draft
+pagecord post create --title "Hello" --content-file hello.md
+pagecord post delete TOKEN          # add --permanent to skip the bin
+```
+
+`pagecord page` takes the same commands. Lists are paged 15 at a time; pass
+`--page N` for more. `--content-file` sends Markdown when the file ends `.md`,
+and HTML otherwise. Other flags: `--title`, `--status draft|published`,
+`--slug`, `--published-at`, `--tags`, `--canonical-url`, `--locale` and
+`--hidden`/`--no-hidden`. `--json` prints the full response.
+
 ## Choosing a blog
 
 With one blog configured, every command uses it. With several, set a default

data/lib/pagecord_cli/cli.rb

@@ -45,6 +45,8 @@ module PagecordCLI
       when "blog" then blog
       when "appearance" then appearance
       when "custom-code" then custom_code
+      when "post" then records("posts")
+      when "page" then records("pages")
       when "publish" then publish("published")
       when "draft" then publish("draft")
       else
@@ -193,9 +195,119 @@ module PagecordCLI
 
         settings = client_for(resolve_blog).update_custom_code(params)
         options[:json] ? print_json(settings) : say("Updated custom code")
+        0
+      rescue Client::Error => e
+        raise unless e.status == 422 && params.key?("custom_css")
+
+        raise Error, "#{e.message}.\nCommon causes: nested CSS, or @import from a host other than Google Fonts or Bunny Fonts.\nSee https://help.pagecord.com/custom-css"
+      end
+
+      def records(resource)
+        noun = resource.chomp("s")
+
+        case argv.shift
+        when "list" then list_records(resource)
+        when "show" then show_record(resource)
+        when "create" then create_record(resource, noun)
+        when "update" then update_record(resource, noun)
+        when "delete" then delete_record(resource, noun)
+        else fail_with("Usage: pagecord #{noun} list|show|create|update|delete")
+        end
+      rescue Client::Error => e
+        raise unless e.status == 404
+
+        raise Error, "No #{noun} with that token"
+      end
+
+      def list_records(resource)
+        status = nil
+        page = nil
+        parser do |opts|
+          opts.on("--drafts") { status = "draft" }
+          opts.on("--published") { status = "published" }
+          opts.on("--page N", Integer) { |value| page = value }
+        end.parse!(argv)
+
+        records = client_for(resolve_blog).list(resource, status: status, page: page)
+
+        if options[:json]
+          print_json(records)
+        else
+          records.each do |record|
+            date = record["published_at"].to_s[0, 10]
+            output.puts [ record["token"], date.empty? ? record["status"] : date, record["title"] ].join("  ")
+          end
+        end
+
         0
       end
 
+      def show_record(resource)
+        parser.parse!(argv)
+        token = argv.shift
+        return fail_with("Usage: pagecord #{resource.chomp("s")} show TOKEN") unless token
+
+        record = client_for(resolve_blog).show(resource, token)
+
+        if options[:json]
+          print_json(record)
+        else
+          record.except("content").each { |key, value| output.puts "#{key}: #{value.is_a?(Array) ? value.join(", ") : value}" }
+          output.puts
+          output.puts record["content"]
+        end
+
+        0
+      end
+
+      def create_record(resource, noun)
+        params = record_params
+        record = client_for(resolve_blog).create(resource, params)
+        options[:json] ? print_json(record) : say("Created #{noun} #{record["token"]}")
+        0
+      end
+
+      def update_record(resource, noun)
+        params = record_params
+        token = argv.shift
+        return fail_with("Usage: pagecord #{noun} update TOKEN [options]") unless token
+        return fail_with("Nothing to update") if params.empty?
+
+        record = client_for(resolve_blog).update(resource, token, params)
+        options[:json] ? print_json(record) : say("Updated #{noun} #{record["token"]}")
+        0
+      end
+
+      def delete_record(resource, noun)
+        permanent = false
+        parser { |opts| opts.on("--permanent") { permanent = true } }.parse!(argv)
+        token = argv.shift
+        return fail_with("Usage: pagecord #{noun} delete TOKEN [--permanent]") unless token
+
+        client_for(resolve_blog).delete(resource, token, permanent: permanent)
+        say "Deleted #{noun} #{token}"
+        0
+      end
+
+      def record_params
+        params = {}
+        parser do |opts|
+          opts.on("--title TITLE") { |value| params[:title] = value }
+          opts.on("--content-file PATH") do |path|
+            params[:content] = read_file("content-file", path)
+            params[:content_format] = "markdown" if PostFile::MARKDOWN_EXTENSIONS.include?(File.extname(path).downcase)
+          end
+          opts.on("--status STATUS", %w[draft published]) { |value| params[:status] = value }
+          opts.on("--slug SLUG") { |value| params[:slug] = value }
+          opts.on("--published-at TIME") { |value| params[:published_at] = value }
+          opts.on("--tags TAGS") { |value| params[:tags] = value }
+          opts.on("--canonical-url URL") { |value| params[:canonical_url] = value }
+          opts.on("--[no-]hidden") { |value| params[:hidden] = value }
+          opts.on("--locale LOCALE") { |value| params[:locale] = value }
+        end.parse!(argv)
+        params
+      end
+
       def publish(status)
         overrides = {}
         parser do |opts|
@@ -311,6 +423,12 @@ module PagecordCLI
             pagecord appearance update [options]
             pagecord custom-code show [--css|--footer-html|--head-html|--body-html]
             pagecord custom-code update [options]
+            pagecord post list [--drafts|--published] [--page N]
+            pagecord post show TOKEN
+            pagecord post create [options]
+            pagecord post update TOKEN [options]
+            pagecord post delete TOKEN [--permanent]
+            pagecord page list|show|create|update|delete (as for post)
             pagecord publish FILE [SUBDOMAIN] [options]
             pagecord draft FILE [SUBDOMAIN] [options]
 
@@ -328,6 +446,13 @@ module PagecordCLI
             --hidden
             --locale LOCALE
 
+          Post and page options:
+            --title TITLE
+            --content-file PATH (HTML, or Markdown if it ends .md)
+            --status draft|published
+            --slug, --published-at, --tags, --canonical-url, --locale
+            --hidden, --no-hidden
+
           Appearance options:
             --theme, --font, --width, --layout
             --custom-theme-bg-light, --custom-theme-text-light, --custom-theme-accent-light
@@ -337,6 +462,9 @@ module PagecordCLI
           Custom code options:
             --css, --footer-html, --head-html, --body-html (each takes a file path)
             --enabled true|false
+
+          Custom CSS reference:
+            https://help.pagecord.com/custom-css
         HELP
         0
       end

data/lib/pagecord_cli/client.rb

@@ -30,6 +30,27 @@ module PagecordCLI
       true
     end
 
+    def list(resource, status: nil, page: nil)
+      query = URI.encode_www_form({ status: status, page: page }.compact)
+      request(Net::HTTP::Get.new(uri_for(query.empty? ? resource : "#{resource}?#{query}")))
+    end
+
+    def show(resource, token)
+      request(Net::HTTP::Get.new(uri_for("#{resource}/#{token}")))
+    end
+
+    def create(resource, params)
+      request(json_request(Net::HTTP::Post, resource, params))
+    end
+
+    def update(resource, token, params)
+      request(json_request(Net::HTTP::Patch, "#{resource}/#{token}", params))
+    end
+
+    def delete(resource, token, permanent: false)
+      request(Net::HTTP::Delete.new(uri_for("#{resource}/#{token}#{"?permanent=true" if permanent}")))
+    end
+
     def create_post(params)
       request(json_request(Net::HTTP::Post, "/posts", params))
     end

data/lib/pagecord_cli/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PagecordCLI
-  VERSION = "0.2.2"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pagecord-cli
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - Olly Headey
@@ -46,7 +46,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Publish local files to Pagecord
 test_files: []