tinylinks 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ff3190a474ea8e4c3d3591730b77295d59d806034dce59410a5ebc08a9d8c540
+  data.tar.gz: 2019b549e6959fabc443a06414a3e1567cf5f38954a5a583834dd0bb2d9aef04
+SHA512:
+  metadata.gz: b6ca05746fc41a5f2ee89a37ce46e60079676bd9b7cc5bacf7c7bce7fdf6251b791f59056efc9ef3d923d05bd04560a03a66bb99cbf664aef652d31266bd1484
+  data.tar.gz: c43ba22c4aeab230476184cc4aaf776b12f40b75e3efeaee1072e24039f39f7265be355dd94744edbc583873d4ca161ea7eb83fc52967b6cc67da05876cceab6

data/bin/tinylinks

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "tinylinks"
+
+Tinylinks::CLI.start(ARGV)

data/lib/tinylinks/auth.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require "json"
+require "fileutils"
+require "time"
+
+module Tinylinks
+  class Auth
+    CREDENTIALS_DIR = File.join(Dir.home, ".config", "tinylinks")
+    CREDENTIALS_FILE = File.join(CREDENTIALS_DIR, "credentials.json")
+
+    def initialize(client: Client.new)
+      @client = client
+    end
+
+    def login
+      grant = @client.post("/device_authorizations")
+      yield(:open_browser, grant["verification_url"]) if block_given?
+
+      poll_for_token(grant["device_code"], grant["interval"], grant["expires_in"])
+    end
+
+    def token
+      return nil unless File.exist?(CREDENTIALS_FILE)
+
+      data = JSON.parse(File.read(CREDENTIALS_FILE))
+      expires_at = Time.parse(data["expires_at"]) if data["expires_at"]
+
+      if expires_at && expires_at <= Time.now
+        nil
+      else
+        data["token"]
+      end
+    end
+
+    def save_token(token, expires_at)
+      FileUtils.mkdir_p(CREDENTIALS_DIR)
+      File.write(CREDENTIALS_FILE, JSON.generate(token: token, expires_at: expires_at))
+    end
+
+    def logged_in?
+      !token.nil?
+    end
+
+    def logout
+      File.delete(CREDENTIALS_FILE) if File.exist?(CREDENTIALS_FILE)
+    end
+
+    private
+
+    def poll_for_token(device_code, interval, expires_in)
+      deadline = Time.now + expires_in
+
+      loop do
+        sleep(interval)
+        raise "Authorization expired" if Time.now >= deadline
+
+        response = @client.post("/device_authorizations/token", {device_code: device_code})
+        save_token(response["token"], response["expires_at"])
+        return response["token"]
+      rescue Client::ApiError => e
+        case e.body["error"]
+        when "authorization_pending"
+          next
+        when "access_denied"
+          raise "Authorization denied by user"
+        when "expired_token"
+          raise "Authorization expired"
+        else
+          raise
+        end
+      end
+    end
+  end
+end

data/lib/tinylinks/cli.rb

@@ -0,0 +1,160 @@
+# frozen_string_literal: true
+
+require "thor"
+
+module Tinylinks
+  class CLI < Thor
+    def self.exit_on_failure?
+      true
+    end
+
+    class_option :help, aliases: "-h", type: :boolean, desc: "Show help for a command"
+
+    no_commands do
+      def invoke_command(command, *args)
+        if options[:help]
+          CLI.command_help(shell, command.name)
+          return
+        end
+        super
+      rescue Client::ApiError => e
+        if e.body.is_a?(Hash) && e.body["errors"]
+          say_error formatter.errors(e.body)
+        else
+          say_error e.message
+        end
+        exit 1
+      end
+    end
+
+    desc "login", "Authenticate with TinyLinks"
+    def login
+      auth = Auth.new
+      if auth.logged_in?
+        say "Already logged in."
+        return
+      end
+
+      say "Starting device authorization..."
+      auth.login do |event, url|
+        if event == :open_browser
+          say "Opening browser for authorization..."
+          say "If it doesn't open, visit: #{url}"
+          system("open", url)
+        end
+      end
+      say "Login successful!"
+    rescue RuntimeError => e
+      say_error "Login failed: #{e.message}"
+      exit 1
+    end
+
+    desc "logout", "Remove stored credentials"
+    def logout
+      Auth.new.logout
+      say "Logged out."
+    end
+
+    desc "list", "List links"
+    method_option :tags, type: :string, desc: "Filter by tags (comma-separated)"
+    method_option :page, type: :numeric, desc: "Page number"
+    def list
+      params = {}
+      params[:tags] = options[:tags] if options[:tags]
+      params[:page] = options[:page] if options[:page]
+      data = client.get("/links", params)
+      say formatter.link_list(data)
+    end
+
+    desc "show ID", "Show a link"
+    def show(id)
+      data = client.get("/links/#{id}")
+      say formatter.link(data["link"])
+    end
+
+    desc "add URL", "Add a new link"
+    method_option :title, type: :string, desc: "Link title"
+    method_option :description, type: :string, desc: "Link description"
+    method_option :tags, type: :string, desc: "Tags (comma-separated)"
+    def add(url)
+      body = {url: url}
+      body[:title] = options[:title] if options[:title]
+      body[:description] = options[:description] if options[:description]
+      body[:tags] = options[:tags].split(",").map(&:strip) if options[:tags]
+      data = client.post("/links", body)
+      say formatter.link(data["link"])
+    end
+
+    desc "edit ID", "Edit a link"
+    method_option :title, type: :string, desc: "Link title"
+    method_option :description, type: :string, desc: "Link description"
+    method_option :tags, type: :string, desc: "Tags (comma-separated)"
+    def edit(id)
+      body = {}
+      body[:title] = options[:title] if options[:title]
+      body[:description] = options[:description] if options[:description]
+      body[:tags] = options[:tags].split(",").map(&:strip) if options[:tags]
+
+      if body.empty?
+        say_error "No changes specified. Use --title, --description, or --tags."
+        exit 1
+      end
+
+      data = client.patch("/links/#{id}", body)
+      say formatter.link(data["link"])
+    end
+
+    desc "search QUERY", "Search links"
+    method_option :page, type: :numeric, desc: "Page number"
+    def search(query)
+      params = {q: query}
+      params[:page] = options[:page] if options[:page]
+      data = client.get("/search", params)
+      say formatter.link_list(data)
+    end
+
+    desc "tags", "List all tags"
+    method_option :sort, type: :string, desc: "Sort order: name (default) or popularity"
+    def tags
+      params = {}
+      params[:sort_by] = options[:sort] if options[:sort]
+      data = client.get("/tags", params)
+      say formatter.tags(data)
+    end
+
+    desc "untagged", "List links without tags"
+    method_option :page, type: :numeric, desc: "Page number"
+    def untagged
+      params = {}
+      params[:page] = options[:page] if options[:page]
+      data = client.get("/untagged", params)
+      say formatter.link_list(data)
+    end
+
+    desc "version", "Show version"
+    def version
+      say "tinylinks #{VERSION}"
+    end
+
+    private
+
+    def client
+      @client ||= begin
+        token = Auth.new.token
+        unless token
+          say_error "Not logged in. Run `tinylinks login` first."
+          exit 1
+        end
+        Client.new(token: token)
+      end
+    end
+
+    def formatter
+      @formatter ||= Formatter.new
+    end
+
+    def say_error(message)
+      $stderr.puts message
+    end
+  end
+end

data/lib/tinylinks/client.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+
+module Tinylinks
+  class Client
+    class ApiError < StandardError
+      attr_reader :status, :body
+
+      def initialize(status, body)
+        @status = status
+        @body = body
+        super("API error #{status}: #{body}")
+      end
+    end
+
+    def initialize(token: nil)
+      @token = token
+    end
+
+    def get(path, params = {})
+      uri = build_uri(path, params)
+      request = Net::HTTP::Get.new(uri)
+      execute(request)
+    end
+
+    def post(path, body = {})
+      uri = build_uri(path)
+      request = Net::HTTP::Post.new(uri)
+      request.body = JSON.generate(body)
+      execute(request)
+    end
+
+    def patch(path, body = {})
+      uri = build_uri(path)
+      request = Net::HTTP::Patch.new(uri)
+      request.body = JSON.generate(body)
+      execute(request)
+    end
+
+    private
+
+    def build_uri(path, params = {})
+      uri = URI("#{API_BASE}#{path}")
+      uri.query = URI.encode_www_form(params) unless params.empty?
+      uri
+    end
+
+    def execute(request)
+      request["Content-Type"] = "application/json"
+      request["Authorization"] = "Bearer #{@token}" if @token
+
+      uri = request.uri
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request(request)
+      end
+
+      body = JSON.parse(response.body)
+
+      unless response.is_a?(Net::HTTPSuccess)
+        raise ApiError.new(response.code.to_i, body)
+      end
+
+      body
+    end
+  end
+end

data/lib/tinylinks/formatter.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Tinylinks
+  class Formatter
+    def link(data)
+      lines = []
+      lines << "#{data["title"] || "(untitled)"} [##{data["id"]}]"
+      lines << "  #{data["url"]}"
+      lines << "  #{data["description"]}" if data["description"] && !data["description"].empty?
+      lines << "  tags: #{data["tags"].join(", ")}" if data["tags"] && !data["tags"].empty?
+      lines.join("\n")
+    end
+
+    def link_list(data)
+      lines = data["links"].map { |l| link(l) }
+      lines << pagination(data["meta"]) if data["meta"]
+      lines.join("\n\n")
+    end
+
+    def tags(data)
+      data["tags"].map { |t| "#{t["name"]} (#{t["count"]})" }.join("\n")
+    end
+
+    def errors(data)
+      data["errors"].flat_map do |field, messages|
+        messages.map { |msg| "#{field} #{msg}" }
+      end.join("\n")
+    end
+
+    private
+
+    def pagination(meta)
+      "Page #{meta["page"]} of #{meta["total_pages"]} (#{meta["total_items"]} total)"
+    end
+  end
+end

data/lib/tinylinks.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Tinylinks
+  VERSION = "0.1.0"
+  BASE_URL = "https://links.pati.to"
+  API_BASE = "#{BASE_URL}/api/v1"
+end
+
+require_relative "tinylinks/client"
+require_relative "tinylinks/auth"
+require_relative "tinylinks/formatter"
+require_relative "tinylinks/cli"

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification
+name: tinylinks
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jaime Rodas
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+description: Command-line interface for the TinyLinks bookmarking API
+executables:
+- tinylinks
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/tinylinks
+- lib/tinylinks.rb
+- lib/tinylinks/auth.rb
+- lib/tinylinks/cli.rb
+- lib/tinylinks/client.rb
+- lib/tinylinks/formatter.rb
+homepage: https://github.com/jaimerodas/tinylinks-cli
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '4.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: CLI for TinyLinks
+test_files: []