asimov-protocol 25.0.0.dev.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a5637897f9892d6930d04dd05d3fe6729ffaf4aebfcec8ccd63df4444392eccd
+  data.tar.gz: 2afaaf2eb574a0e1d034c8f80a0198fe00314ae52afe7768b99d65bbe51a2bc1
+SHA512:
+  metadata.gz: e721955a3fc53a7ffb4fe9c804a1cba3556bb574f43088399b7d96d9a94163980ada973d4474efa3f1d283cd61657caa2712198fb4d6f17db77f67a3484bd903
+  data.tar.gz: dbe2f0020258552720fe883667a3d9821f1102acae77d39faa9a274e9c0f069a99376cc0a025d52f4d2d0a8f577aebd7b5ba220bf797a529e9b6088da29629b4

data/AUTHORS

@@ -0,0 +1 @@
+* Arto Bendiken <arto@asimov.so>

data/CHANGES.md

@@ -0,0 +1,18 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## 25.0.0.dev.4 - 2025-02-15
+
+## 25.0.0.dev.3 - 2025-02-15
+
+## 25.0.0.dev.2 - 2025-02-15
+
+## 25.0.0.dev.1 - 2025-02-12
+
+## 25.0.0.dev.0 - 2025-02-11
+
+## 24.0.0.dev.0 - 2024-06-26

data/README.md

@@ -0,0 +1,53 @@
+# ASIMOV Software Development Kit (SDK) for Ruby
+
+[![License](https://img.shields.io/badge/license-Public%20Domain-blue.svg)](https://unlicense.org)
+[![Compatibility](https://img.shields.io/badge/ruby-3.2%2B-blue)](https://rubygems.org/gems/asimov.rb)
+[![Package](https://img.shields.io/gem/v/asimov.rb)](https://rubygems.org/gems/asimov.rb)
+[![Documentation](https://img.shields.io/badge/rubydoc-latest-blue)](https://rubydoc.info/gems/asimov.rb)
+
+🚧 _We are building in public. This is presently under heavy construction._
+
+## ✨ Features
+
+- 100% free and unencumbered public domain software.
+
+## 🛠️ Prerequisites
+
+- [Ruby] 3.2+
+
+## ⬇️ Installation
+
+### Installation via RubyGems
+
+```bash
+gem install asimov.rb --pre
+```
+
+## 👉 Examples
+
+- [Importing the SDK](#importing-the-sdk)
+
+### Importing the SDK
+
+```ruby
+require 'asimov'
+```
+
+## 📚 Reference
+
+https://rubydoc.info/gems/asimov.rb
+
+## 👨‍💻 Development
+
+```bash
+git clone https://github.com/asimov-platform/asimov.rb.git
+```
+
+- - -
+
+[![Share on Twitter](https://img.shields.io/badge/share%20on-twitter-03A9F4?logo=twitter)](https://twitter.com/share?url=https://github.com/asimov-platform/asimov.rb&text=ASIMOV%20Software%20Development%20Kit%20%28SDK%29%20for%20Ruby)
+[![Share on Reddit](https://img.shields.io/badge/share%20on-reddit-red?logo=reddit)](https://reddit.com/submit?url=https://github.com/asimov-platform/asimov.rb&title=ASIMOV%20Software%20Development%20Kit%20%28SDK%29%20for%20Ruby)
+[![Share on Hacker News](https://img.shields.io/badge/share%20on-hacker%20news-orange?logo=ycombinator)](https://news.ycombinator.com/submitlink?u=https://github.com/asimov-platform/asimov.rb&t=ASIMOV%20Software%20Development%20Kit%20%28SDK%29%20for%20Ruby)
+[![Share on Facebook](https://img.shields.io/badge/share%20on-facebook-1976D2?logo=facebook)](https://www.facebook.com/sharer/sharer.php?u=https://github.com/asimov-platform/asimov.rb)
+
+[Ruby]: https://ruby-lang.org

data/UNLICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+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 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.
+
+For more information, please refer to <https://unlicense.org/>

data/VERSION

@@ -0,0 +1 @@
+25.0.0.dev.4

data/lib/asimov/protocol/account.rb

@@ -0,0 +1,77 @@
+# This is free and unencumbered software released into the public domain.
+
+require "asimov/config"
+require "pathname"
+
+##
+# A user account on the ASIMOV Protocol.
+class ASIMOV::Protocol::Account
+  GRAMMAR = %r{^([^/]+)$}
+
+  ##
+  # @param [String, #to_s] id
+  # @return [ASIMOV::Protocol::Account]
+  def self.parse(id)
+    id = id.to_s
+    unless GRAMMAR.match?(id)
+      raise ArgumentError, "invalid account ID: #{id.inspect}"
+    end
+    self.new(id)
+  end
+
+  ##
+  # @param [String, #to_s] id
+  # @return [void]
+  def initialize(id)
+    @id = id.to_s
+  end
+
+  ##
+  # @return [String]
+  attr_reader :id
+
+  ##
+  # @return [ASIMOV::Protocol::Account]
+  def parent
+    return nil unless self.id.include?('.')
+    self.class.new(self.id.split('.').drop(1).join('.'))
+  end
+
+  ##
+  # @return [Pathname]
+  def path
+    base_path = ASIMOV::Config.path.join("datasets")
+    base_path.join(*self.id.split('.').reverse)
+  end
+
+  ##
+  # @return [String]
+  def to_s
+    self.id
+  end
+
+  ##
+  # @param [String, #to_s] base_uri
+  # @return [String]
+  def to_uri(base_uri)
+    "#{base_uri}/#{self.id}"
+  end
+
+  ##
+  # @param [String, #to_s] base_uri
+  # @return [RDF::Graph]
+  def to_rdf(base_uri)
+    require "rdf"
+    RDF::Graph.new do |graph|
+      self_uri = RDF::URI.new(self.to_uri(base_uri))
+      # TODO
+    end
+  end
+
+  ##
+  # @param  [String, #to_s] dataset_name
+  # @return [ASIMOV::Protocol::Dataset]
+  def find_dataset(dataset_name)
+    ASIMOV::Protocol::Dataset.new("#{self.id}/#{dataset_name}")
+  end
+end # ASIMOV::Protocol::Account

data/lib/asimov/protocol/dataset.rb

@@ -0,0 +1,93 @@
+# This is free and unencumbered software released into the public domain.
+
+##
+# A dataset of knowledge graphs on the ASIMOV Protocol.
+class ASIMOV::Protocol::Dataset
+  GRAMMAR = %r{^([^/]+)/([^/]+)$}
+
+  ##
+  # @param [String, #to_s] id
+  # @return [ASIMOV::Protocol::Dataset]
+  def self.parse(id)
+    id = id.to_s
+    account, name = case id
+      when ASIMOV::Protocol::Account::GRAMMAR then [$1, nil]
+      when GRAMMAR then [$1, $2]
+      else raise ArgumentError, "invalid dataset ID: #{id.inspect}"
+    end
+    self.new(account, name)
+  end
+
+  ##
+  # @param [String, #to_s] account
+  # @param [String, #to_s] name
+  def initialize(account, name)
+    @account, @name = account.to_s, name.to_s
+  end
+
+  ##
+  # The account that owns this dataset.
+  #
+  # @return [ASIMOV::Protocol::Account]
+  attr_reader :account
+  def account
+    ASIMOV::Protocol::Account.new(@account)
+  end
+
+  ##
+  # The machine-readable name of this dataset.
+  #
+  # @return [String]
+  attr_reader :name
+
+  ##
+  # @return [Pathname]
+  def path
+    self.account.path.join(self.name || 'default') # TODO
+  end
+
+  ##
+  # @return [void]
+  def each_graph(&block)
+    [].each(&block) # TODO
+  end
+
+  ##
+  # @return [String]
+  def to_s
+    [@account, @name].compact.join('/')
+  end
+  alias_method :id, :to_s
+
+  ##
+  # @param [String, #to_s] base_uri
+  # @return [String]
+  def to_uri(base_uri)
+    "#{base_uri}/#{self.to_s}"
+  end
+
+  ##
+  # @param [String, #to_s] base_uri
+  # @return [RDF::Graph]
+  def to_rdf(base_uri)
+    require 'rdf'
+    require 'rdf/vocab'
+
+    include RDF
+    include RDF::Vocab
+
+    RDF::Graph.new do |graph|
+      self_uri = RDF::URI(self.to_uri(base_uri)).normalize
+      default_graph = RDF::Node.new
+      graph << [self_uri, RDF.type, SD.Service]
+      graph << [self_uri, RDFS.label, self.name]
+      graph << [self_uri, SD.endpoint, self_uri]
+      graph << [self_uri, SD.supportedLanguage, SD.SPARQL11Query]
+      graph << [self_uri, SD.defaultDataset, self_uri]
+      graph << [self_uri, RDF.type, SD.Dataset]
+      graph << [self_uri, SD.defaultGraph, default_graph]
+      graph << [default_graph, RDF.type, SD.Graph]
+      graph << [default_graph, VOID.triples, 0]
+    end
+  end
+end # ASIMOV::Protocol::Dataset

data/lib/asimov/protocol/directory.rb

@@ -0,0 +1,52 @@
+# This is free and unencumbered software released into the public domain.
+
+##
+# The directory of datasets on the ASIMOV Protocol.
+class ASIMOV::Protocol::Directory
+  ##
+  # @param  [Integer, #to_i] block
+  # @param  [Boolean] local
+  # @yield  [dir]
+  # @yieldparam [ASIMOV::Protocol::Directory] dir
+  # @yieldreturn [void]
+  # @return [ASIMOV::Protocol::Directory]
+  def self.open(block: nil, local: false, &)
+    # TODO: call the registry contract
+    dir = self.new
+    if block_given?
+      yield dir
+    else
+      dir
+    end
+  end
+
+  ##
+  # @param  [String, #to_s] account_id
+  # @return [ASIMOV::Protocol::Account]
+  def find_account(account_id)
+    ASIMOV::Protocol::Account.new(account_id)
+  end
+
+  ##
+  # @param  [String, #to_s] dataset_id
+  # @return [ASIMOV::Protocol::Dataset]
+  def find_dataset(dataset_id)
+    ASIMOV::Protocol::Dataset.new(dataset_id)
+  end
+
+  ##
+  # @yield  [dataset]
+  # @yieldparam [ASIMOV::Protocol::Dataset] dataset
+  # @yieldreturn [void]
+  # @return [void]
+  def each_dataset(&block)
+    return enum_for(__method__) unless block_given?
+    self.datasets.each(&block)
+  end
+
+  ##
+  # @return [Array<ASIMOV::Protocol::Dataset>]
+  def datasets
+    [] # TODO
+  end
+end # ASIMOV::Protocol::Directory

data/lib/asimov/protocol/network.rb

@@ -0,0 +1,6 @@
+# This is free and unencumbered software released into the public domain.
+
+##
+# A blockchain network supported by ASIMOV Protocol.
+class ASIMOV::Protocol::Network
+end # ASIMOV::Protocol::Network

data/lib/asimov/protocol/repository.rb

@@ -0,0 +1,6 @@
+# This is free and unencumbered software released into the public domain.
+
+##
+# A repository of datasets on the ASIMOV Protocol.
+class ASIMOV::Protocol::Repository
+end # ASIMOV::Protocol::Repository

data/lib/asimov/protocol.rb

@@ -0,0 +1,11 @@
+# This is free and unencumbered software released into the public domain.
+
+module ASIMOV; end
+
+module ASIMOV::Protocol; end
+
+require_relative 'protocol/account'
+require_relative 'protocol/dataset'
+require_relative 'protocol/directory'
+require_relative 'protocol/network'
+require_relative 'protocol/repository'

data/lib/asimov-protocol.rb

@@ -0,0 +1,3 @@
+# This is free and unencumbered software released into the public domain.
+
+require_relative "asimov/protocol"

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification
+name: asimov-protocol
+version: !ruby/object:Gem::Version
+  version: 25.0.0.dev.4
+platform: ruby
+authors:
+- ASIMOV Protocol
+bindir: bin
+cert_chain: []
+date: 2025-02-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: asimov-config
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 25.0.0.dev.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 25.0.0.dev.4
+description: ''
+email: support@asimov.so
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- AUTHORS
+- CHANGES.md
+- README.md
+- UNLICENSE
+- VERSION
+- lib/asimov-protocol.rb
+- lib/asimov/protocol.rb
+- lib/asimov/protocol/account.rb
+- lib/asimov/protocol/dataset.rb
+- lib/asimov/protocol/directory.rb
+- lib/asimov/protocol/network.rb
+- lib/asimov/protocol/repository.rb
+homepage: https://sdk.asimov.so
+licenses:
+- Unlicense
+metadata:
+  bug_tracker_uri: https://github.com/asimov-platform/asimov.rb/issues
+  changelog_uri: https://github.com/asimov-platform/asimov.rb/blob/master/CHANGES.md
+  documentation_uri: https://rubydoc.info/gems/asimov-protocol
+  homepage_uri: https://sdk.asimov.so
+  source_code_uri: https://github.com/asimov-platform/asimov.rb
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: ASIMOV Software Development Kit (SDK) for Ruby
+test_files: []