twenty-server 0.4.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 677398c56ecfd535bdec6de36fbb5507f441963d22efad8e29e80dc73abc77b7
+  data.tar.gz: 00c807ce51fae09f47c08667af8e740f69d2b141676565acfe502dfa71f2a654
+SHA512:
+  metadata.gz: 19de180d8c0c9dfcd51a8dc27cfd6c9b12bd6fa5b40607d5cede8720c797e240d14a377a437a025ad9747e03029d15294f5880c885e0c7bee164b99712df5983
+  data.tar.gz: ef1b9cc9b9d74381c52b4a1d6400429485127dcfcb905258c11e63ccba7888026b94ad3c35b54a535ea41f77baabc5f4343fab72fd092c82eafa5d9b1ef50fed

data/lib/twenty/server/graphql/input/task_input.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Twenty::GraphQL::Input
+  class TaskInput < GraphQL::Schema::InputObject
+    argument :title, String, required: false
+    argument :content, String, required: false
+    argument :project_id, Int, required: false
+    argument :status, "Twenty::GraphQL::Type::TaskStatus", required: false
+  end
+end

data/lib/twenty/server/graphql/input.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module Twenty::GraphQL::Input
+  include GraphQL::Types
+  require_relative "input/task_input"
+end

data/lib/twenty/server/graphql/mutation/complete_task.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Twenty::GraphQL::Mutation
+  class CompleteTask < GraphQL::Schema::Mutation
+    argument :task_id, Int
+    field :ok, Boolean
+    field :errors, [String]
+
+    def resolve(task_id:)
+      task = Twenty::Task.find(task_id)
+      task.update!(status: :complete)
+      {ok: true, errors: []}
+    rescue => ex
+      {ok: false, errors: [ex.message]}
+    end
+  end
+end

data/lib/twenty/server/graphql/mutation/create_task.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Twenty::GraphQL::Mutation
+  class CreateTask < GraphQL::Schema::Mutation
+    field :errors, [String], null: false
+    argument :input, Twenty::GraphQL::Input::TaskInput
+
+    def resolve(input:)
+      Twenty::Task.create input.to_h.merge(status: :backlog)
+      {"errors" => []}
+    rescue => ex
+      {"errors" => [ex.message]}
+    end
+  end
+end

data/lib/twenty/server/graphql/mutation/destroy_task.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Twenty::GraphQL::Mutation
+  class DestroyTask < GraphQL::Schema::Mutation
+    argument :task_id, Int
+    field :ok, Boolean
+    field :errors, [String]
+
+    def resolve(task_id:)
+      task = Twenty::Task.find(task_id)
+      task.destroy!
+      {ok: true, errors: []}
+    rescue => ex
+      {ok: false, errors: [ex.message]}
+    end
+  end
+end

data/lib/twenty/server/graphql/mutation/set_random_project_color.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Twenty::GraphQL::Mutation
+  class SetRandomProjectColor < ::GraphQL::Schema::Mutation
+    argument :project_id, Int, required: true
+
+    field :errors, [String], null: false
+    field :project, "Twenty::GraphQL::Type::Project", null: true
+
+    def resolve(project_id:)
+      project = Twenty::Project.with_pk!(project_id)
+      project.update(color: project.random_color)
+      {errors: [], project:}
+    rescue => ex
+      {errors: [ex.message]}
+    end
+  end
+end

data/lib/twenty/server/graphql/mutation/update_task.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Twenty::GraphQL::Mutation
+  class UpdateTask < GraphQL::Schema::Mutation
+    field :errors, [String], null: false
+    argument :task_id, Int
+    argument :input, Twenty::GraphQL::Input::TaskInput
+
+    def resolve(task_id:, input:)
+      Twenty::Task
+        .with_pk!(task_id)
+        .update(input.to_h)
+      {"errors" => []}
+    rescue => ex
+      {"errors" => [ex.message]}
+    end
+  end
+end

data/lib/twenty/server/graphql/mutation.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Twenty::GraphQL
+  module Mutation
+    require_relative "mutation/destroy_task"
+    require_relative "mutation/complete_task"
+    require_relative "mutation/create_task"
+    require_relative "mutation/update_task"
+    require_relative "mutation/set_random_project_color"
+  end
+end

data/lib/twenty/server/graphql/schema.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Twenty::GraphQL
+  class Schema < GraphQL::Schema
+    query Type::Query
+    mutation Type::Mutation
+  end
+end

data/lib/twenty/server/graphql/type/mutation.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Twenty::GraphQL::Type
+  class Mutation < GraphQL::Schema::Object
+    field :destroy_task, mutation: Twenty::GraphQL::Mutation::DestroyTask
+    field :complete_task, mutation: Twenty::GraphQL::Mutation::CompleteTask
+    field :create_task, mutation: Twenty::GraphQL::Mutation::CreateTask
+    field :update_task, mutation: Twenty::GraphQL::Mutation::UpdateTask
+    field :set_random_project_color, mutation: Twenty::GraphQL::Mutation::SetRandomProjectColor
+  end
+end

data/lib/twenty/server/graphql/type/project.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Twenty::GraphQL::Type
+  class Project < GraphQL::Schema::Object
+    field :id, Int, null: false
+    field :name, String, null: false
+    field :path, String, null: false
+    field :color, String, null: false
+    field :tasks, "[Twenty::GraphQL::Type::Task]", null: false
+  end
+end

data/lib/twenty/server/graphql/type/query.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Twenty::GraphQL::Type
+  class Query < GraphQL::Schema::Object
+    field :find_task, Task, null: true do
+      argument :task_id, Int
+    end
+    field :tasks, [Task], null: false do
+      argument :status, TaskStatus
+      argument :project_id, Int, required: false
+    end
+    field :projects, [Project], null: false
+
+    def find_task(task_id:)
+      Twenty::Task.with_pk!(task_id)
+    end
+
+    def tasks(status:, project_id: nil)
+      tasks = Twenty::Task
+                .by_status(status)
+                .order("updated_at DESC")
+      (project_id ? tasks.where(project_id:) : tasks).all
+    end
+
+    def projects
+      Twenty::Project.all
+    end
+  end
+end

data/lib/twenty/server/graphql/type/task.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Twenty::GraphQL::Type
+  class Task < GraphQL::Schema::Object
+    field :id, Int, null: false
+    field :title, String, null: false
+    field :status, "Twenty::GraphQL::Type::TaskStatus", null: false
+    field :content, String, null: false
+    field :project, "Twenty::GraphQL::Type::Project", null: false
+    field :updated_at, GraphQL::Types::ISO8601DateTime, null: false
+    field :is_ready, Boolean, null: false, method: :ready?
+    field :is_backlogged, Boolean, null: false, method: :backlog?
+    field :is_complete, Boolean, null: false, method: :complete?
+    field :in_progress, Boolean, null: false, method: :in_progress?
+  end
+end

data/lib/twenty/server/graphql/type/task_status.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Twenty::GraphQL::Type
+  class TaskStatus < GraphQL::Schema::Enum
+    value :backlog
+    value :ready
+    value :in_progress
+    value :complete
+  end
+end

data/lib/twenty/server/graphql/type.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Twenty::GraphQL
+  module Type
+    include ::GraphQL::Types
+  end
+  require_relative "type/task_status"
+  require_relative "type/project"
+  require_relative "type/task"
+  require_relative "type/query"
+  require_relative "type/mutation"
+end

data/lib/twenty/server/graphql.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Twenty::GraphQL
+  require "graphql"
+  require_relative "graphql/input"
+  require_relative "graphql/mutation"
+  require_relative "graphql/type"
+  require_relative "graphql/schema"
+end

data/lib/twenty/server/migration/1_create_projects.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+Sequel.migration do
+  up do
+    create_table(:projects) do
+      primary_key :id
+      String :name, null: false
+      String :path, null: false
+      DateTime :created_at
+      DateTime :updated_at
+    end
+    add_index :projects, [:name, :path], unique: true
+  end
+
+  down do
+    drop_table(:projects)
+  end
+end

data/lib/twenty/server/migration/2_create_tasks.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+Sequel.migration do
+  up do
+    create_table(:tasks) do |t|
+      primary_key :id
+      String :title, null: false
+      Text :content, null: false
+      Integer :status, null: false, default: 0
+      DateTime :created_at
+      DateTime :updated_at
+      foreign_key :project_id, :projects, null: false
+    end
+  end
+
+  down do
+    drop_table(:tasks)
+  end
+end

data/lib/twenty/server/migration/3_add_color_to_projects.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+Sequel.migration do
+  up do
+    default = Twenty::ColorableMixin.random_color
+    add_column :projects, :color, :string, null: false, default:
+  end
+
+  down do
+    drop_column :projects, :color
+  end
+end

data/lib/twenty/server/migration.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Twenty::Migration
+  require "sequel/extensions/migration"
+  ##
+  # @return [String]
+  #  Returns the path to twenty's migrations.
+  def self.migrations_path
+    File.join(__dir__, "migration")
+  end
+
+  ##
+  # Runs migrations (if neccessary).
+  # @return [void]
+  def self.run!
+    Sequel::Migrator.run(Twenty.connection, migrations_path)
+  end
+
+  ##
+  # @return [Boolean]
+  #  Returns true when there are pending migrations.
+  def self.pending_migrations?
+    Sequel::Migrator.is_current?(Twenty.connection, migrations_path)
+  end
+end

data/lib/twenty/server/model/mixin/colorable_mixin.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Twenty::ColorableMixin
+  extend self
+
+  COLORS = [
+    "#222222", "#333333", "#444444", "#555555", "#666666",
+    "#777777", "#888888", "#999999", "#AA2222", "#22AA22",
+    "#2222AA", "#AA22AA", "#CC9900", "#0099CC", "#9900CC",
+    "#FF9900", "#00CC99", "#99CC00", "#CC0099", "#990000",
+    "#112233", "#445566", "#778899", "#AA4455", "#5544AA",
+    "#88AA44", "#AA88AA", "#CCBB00", "#1155CC", "#9900BB",
+    "#DD6600", "#00BBCC", "#CC0099", "#BB3300", "#006688",
+    "#993366", "#2200AA", "#557788", "#998877", "#BB4400"
+  ]
+
+  def before_validation
+    super if defined?(super)
+    set_random_color
+  end
+
+  def random_color
+    COLORS.sample
+  end
+
+  private
+
+  def set_random_color
+    return if id
+    self.color = random_color
+  end
+end

data/lib/twenty/server/model/project.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+class Twenty::Project < Sequel::Model
+  include Twenty::Model
+  include Twenty::ColorableMixin
+
+  validates_presence_of :name
+  validates_presence_of :path
+  one_to_many :tasks, class_name: "Twenty::Task"
+
+  ##
+  # @return [String]
+  #  The path to a project.
+  def path
+    super&.sub(Dir.home, "~")
+  end
+end

data/lib/twenty/server/model/task.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+class Twenty::Task < Sequel::Model
+  include Twenty::Model
+
+  plugin(:enum)
+  STATUS_MAP = {backlog: 0, ready: 1, in_progress: 2, complete: 3}
+  STATUS_KEYS = STATUS_MAP.keys
+  enum :status, STATUS_MAP
+
+  def self.by_status(status)
+    if STATUS_KEYS.any? { _1.to_s == status.to_s }
+      public_send(status)
+    else
+      where(id: nil)
+    end
+  end
+
+  validates_presence_of :title
+  validates_presence_of :content
+  validates_presence_of :project
+  validates_inclusion_of :status, in: [STATUS_KEYS, *STATUS_KEYS.map(&:to_s)]
+  many_to_one :project, class_name: "Twenty::Project"
+
+  def status=(v)
+    super(v.to_sym)
+  end
+
+  def status
+    super.to_s
+  end
+end

data/lib/twenty/server/model.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Twenty::Model
+  def self.included(model)
+    model.plugin(:validation_class_methods)
+    model.plugin(:timestamps, update_on_create: true)
+  end
+
+  require_relative "model/mixin/colorable_mixin"
+  require_relative "model/project"
+  require_relative "model/task"
+end

data/lib/twenty/server/path.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Twenty::Path
+  require "tmpdir"
+  extend self
+
+  ##
+  # @return [String]
+  #  Returns the directory where twenty stores persistent data.
+  def datadir
+    File.join(Dir.home, ".local", "share", "twenty")
+  end
+
+  ##
+  # @return [String]
+  #  Returns the directory where twenty stores temporary data.
+  def tmpdir
+    File.join(Dir.tmpdir, "twenty")
+  end
+
+  ##
+  # @return [String]
+  #  Returns the file where twenty can write the PID of
+  #  a web server running in the background.
+  def pidfile
+    File.join(tmpdir, "server.pid")
+  end
+
+  FileUtils.mkdir_p(datadir)
+  FileUtils.mkdir_p(tmpdir)
+end

data/lib/twenty/server/rack/graphql.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Twenty::Rack
+  module GraphQL
+    ##
+    # Extends {Server::Dir Server::Dir} (a static file
+    # Rack application) with a /graphql endpoint.
+    #
+    # @param [Hash] env
+    #  Environment hash.
+    #
+    # @return [Array<Integer, Hash, #each>]
+    #  Returns a response.
+    def call(env)
+      req = Rack::Request.new(env)
+      if req.post? &&
+          req.path == "/graphql"
+        params = JSON.parse(req.body.string)
+        result = Twenty::GraphQL::Schema.execute(
+          params["query"],
+          variables: params["variables"],
+          context: {}
+        )
+        [200, {"content-type" => "application/json"}, [result.to_json]]
+      else
+        super(env)
+      end
+    end
+    Server::Dir.prepend(self)
+  end
+end

data/lib/twenty/server/rack.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Twenty::Rack
+  require "server"
+  require_relative "rack/graphql"
+
+  ##
+  # @param [Hash] options
+  #  A hash of server options.
+  #
+  # @return [Thread]
+  def self.server(options = {})
+    Server.dir(Twenty.build, options.to_h)
+  end
+end

data/share/twenty/server/schema.graphql

@@ -0,0 +1,91 @@
+"""
+Autogenerated return type of CompleteTask.
+"""
+type CompleteTaskPayload {
+  errors: [String!]
+  ok: Boolean
+}
+
+"""
+Autogenerated return type of CreateTask.
+"""
+type CreateTaskPayload {
+  errors: [String!]!
+}
+
+"""
+Autogenerated return type of DestroyTask.
+"""
+type DestroyTaskPayload {
+  errors: [String!]
+  ok: Boolean
+}
+
+"""
+An ISO 8601-encoded datetime
+"""
+scalar ISO8601DateTime @specifiedBy(url: "https://tools.ietf.org/html/rfc3339")
+
+type Mutation {
+  completeTask(taskId: Int!): CompleteTaskPayload
+  createTask(input: TaskInput!): CreateTaskPayload
+  destroyTask(taskId: Int!): DestroyTaskPayload
+  setRandomProjectColor(projectId: Int!): SetRandomProjectColorPayload
+  updateTask(input: TaskInput!, taskId: Int!): UpdateTaskPayload
+}
+
+type Project {
+  color: String!
+  id: Int!
+  name: String!
+  path: String!
+  tasks: [Task!]!
+}
+
+type Query {
+  findTask(taskId: Int!): Task
+  projects: [Project!]!
+  tasks(projectId: Int, status: TaskStatus!): [Task!]!
+}
+
+"""
+Autogenerated return type of SetRandomProjectColor.
+"""
+type SetRandomProjectColorPayload {
+  errors: [String!]!
+  project: Project
+}
+
+type Task {
+  content: String!
+  id: Int!
+  inProgress: Boolean!
+  isBacklogged: Boolean!
+  isComplete: Boolean!
+  isReady: Boolean!
+  project: Project!
+  status: TaskStatus!
+  title: String!
+  updatedAt: ISO8601DateTime!
+}
+
+input TaskInput {
+  content: String
+  projectId: Int
+  status: TaskStatus
+  title: String
+}
+
+enum TaskStatus {
+  backlog
+  complete
+  in_progress
+  ready
+}
+
+"""
+Autogenerated return type of UpdateTask.
+"""
+type UpdateTaskPayload {
+  errors: [String!]!
+}

metadata

@@ -0,0 +1,155 @@
+--- !ruby/object:Gem::Specification
+name: twenty-server
+version: !ruby/object:Gem::Version
+  version: 0.4.0
+platform: ruby
+authors:
+- '0x1eef'
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-04-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sequel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.78'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.78'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: graphql
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+- !ruby/object:Gem::Dependency
+  name: server.rb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: test-unit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.5.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.5.7
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.35'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.35'
+description: HTTP server
+email:
+- 0x1eef@protonmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- "./lib/twenty/server/graphql.rb"
+- "./lib/twenty/server/graphql/input.rb"
+- "./lib/twenty/server/graphql/input/task_input.rb"
+- "./lib/twenty/server/graphql/mutation.rb"
+- "./lib/twenty/server/graphql/mutation/complete_task.rb"
+- "./lib/twenty/server/graphql/mutation/create_task.rb"
+- "./lib/twenty/server/graphql/mutation/destroy_task.rb"
+- "./lib/twenty/server/graphql/mutation/set_random_project_color.rb"
+- "./lib/twenty/server/graphql/mutation/update_task.rb"
+- "./lib/twenty/server/graphql/schema.rb"
+- "./lib/twenty/server/graphql/type.rb"
+- "./lib/twenty/server/graphql/type/mutation.rb"
+- "./lib/twenty/server/graphql/type/project.rb"
+- "./lib/twenty/server/graphql/type/query.rb"
+- "./lib/twenty/server/graphql/type/task.rb"
+- "./lib/twenty/server/graphql/type/task_status.rb"
+- "./lib/twenty/server/migration.rb"
+- "./lib/twenty/server/migration/1_create_projects.rb"
+- "./lib/twenty/server/migration/2_create_tasks.rb"
+- "./lib/twenty/server/migration/3_add_color_to_projects.rb"
+- "./lib/twenty/server/model.rb"
+- "./lib/twenty/server/model/mixin/colorable_mixin.rb"
+- "./lib/twenty/server/model/project.rb"
+- "./lib/twenty/server/model/task.rb"
+- "./lib/twenty/server/path.rb"
+- "./lib/twenty/server/rack.rb"
+- "./lib/twenty/server/rack/graphql.rb"
+- "./share/twenty/server/schema.graphql"
+homepage: https://github.com/0x1eef/twenty#readme
+licenses:
+- 0BSD
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.9
+signing_key:
+specification_version: 4
+summary: HTTP server
+test_files: []