portolan 0.1.0.pre.1

data/lib/portolan/type/integer.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Portolan
+  module Type
+    class Integer < Base
+      OPERATORS = %w[eq in gt lt between].freeze
+      RANGE = (-(2**63))..((2**63) - 1)
+
+      def name = 'integer'
+      def label(value, _period = nil) = value.to_i
+
+      def errors_for(value)
+        number = cast(value)
+        return ["`#{value}` is not an integer"] unless number
+        return [] if RANGE.cover?(number)
+
+        ["`#{value}` is outside the integer range, #{RANGE.min} to #{RANGE.max}"]
+      end
+
+      def cast(value)
+        return value if value.is_a?(::Integer)
+
+        Kernel.Integer(value, 10, exception: false) if value.is_a?(::String)
+      end
+    end
+  end
+end

data/lib/portolan/type/string.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Portolan
+  module Type
+    class String < Base
+      OPERATORS = %w[eq in].freeze
+
+      def name = 'string'
+      def errors_for(value) = value.is_a?(::String) || value.is_a?(::Numeric) ? [] : ["`#{value}` is not text"]
+      def cast(value) = value.to_s
+    end
+  end
+end

data/lib/portolan/type.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Portolan
+  module Type
+    CLASSES = {
+      string: String,
+      integer: Integer,
+      decimal: Decimal,
+      boolean: Boolean,
+      date: Date,
+      datetime: DateTime,
+    }.freeze
+    NAMES = CLASSES.keys.freeze
+
+    def self.for(name) = CLASSES.fetch(name).new
+  end
+end

data/lib/portolan/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Portolan
+  VERSION = '0.1.0.pre.1'
+end

data/lib/portolan.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'active_record'
+require 'active_support'
+require 'active_support/core_ext/enumerable'
+require 'active_support/core_ext/object/blank'
+require 'active_support/core_ext/time/calculations'
+
+require_relative 'portolan/version'
+require_relative 'portolan/type/base'
+require_relative 'portolan/type/string'
+require_relative 'portolan/type/enum'
+require_relative 'portolan/type/integer'
+require_relative 'portolan/type/decimal'
+require_relative 'portolan/type/boolean'
+require_relative 'portolan/type/date'
+require_relative 'portolan/type/date_time'
+require_relative 'portolan/type'
+require_relative 'portolan/dimension'
+require_relative 'portolan/dimension/bucket'
+require_relative 'portolan/measure'
+require_relative 'portolan/dataset'
+require_relative 'portolan/registry'
+require_relative 'portolan/query/filter'
+require_relative 'portolan/query/result'
+require_relative 'portolan/query/guard'
+require_relative 'portolan/query/base'
+require_relative 'portolan/query/aggregate'
+
+module Portolan
+  def self.quoted(items) = items.map { |item| "`#{item}`" }.join(', ')
+end

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification
+name: portolan
+version: !ruby/object:Gem::Version
+  version: 0.1.0.pre.1
+platform: ruby
+authors:
+- David Busse
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+description: 'Portolan lets a Rails app chart the datasets it is willing to expose:
+  their dimensions, measures and worked examples. A dashboard or an LLM tool sends
+  a structured request and gets back only what the app has declared, never SQL.'
+email:
+- david@busse.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- lib/portolan.rb
+- lib/portolan/dataset.rb
+- lib/portolan/dimension.rb
+- lib/portolan/dimension/bucket.rb
+- lib/portolan/measure.rb
+- lib/portolan/query/aggregate.rb
+- lib/portolan/query/base.rb
+- lib/portolan/query/filter.rb
+- lib/portolan/query/guard.rb
+- lib/portolan/query/result.rb
+- lib/portolan/registry.rb
+- lib/portolan/type.rb
+- lib/portolan/type/base.rb
+- lib/portolan/type/boolean.rb
+- lib/portolan/type/date.rb
+- lib/portolan/type/date_time.rb
+- lib/portolan/type/decimal.rb
+- lib/portolan/type/enum.rb
+- lib/portolan/type/integer.rb
+- lib/portolan/type/string.rb
+- lib/portolan/version.rb
+homepage: https://github.com/dpbus/portolan
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/dpbus/portolan
+  bug_tracker_uri: https://github.com/dpbus/portolan/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Declared, read-only datasets that reporting code and LLMs can query safely.
+test_files: []