seaport 0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2821b36a643b6520cab8b7866e6640f0bba0fc80eaa9443e80ebb50a6a7f3b63
+  data.tar.gz: 9684a51b2786cfa7455cdc1a048dfe93c438003faebd6709338d98d01deab15e
+SHA512:
+  metadata.gz: a5ea8da66f4d9b948c70c98ede12bc1d237cf5ba82a4ead8ef83e3e020c2b70b24bb39c48f7931297454639d1e793d5a69ac82d68d0c7cc2ac164fb1a7e2286c
+  data.tar.gz: 1baf9d29976cb5dfcacf441b29aafb7ea58d2e62d1ce587f84fa7d50e3f41494e4fd9f6d0a23bb0c01cae6af46d99cf2c6f5cf5f39c7bb261d524db007d8ab8d

data/LICENSE.adoc

@@ -0,0 +1,134 @@
+= Hippocratic License
+
+Version: 2.1.0.
+
+Purpose. The purpose of this License is for the Licensor named above to
+permit the Licensee (as defined below) broad permission, if consistent
+with Human Rights Laws and Human Rights Principles (as each is defined
+below), to use and work with the Software (as defined below) within the
+full scope of Licensor’s copyright and patent rights, if any, in the
+Software, while ensuring attribution and protecting the Licensor from
+liability.
+
+Permission and Conditions. The Licensor grants permission by this
+license ("License"), free of charge, to the extent of Licensor’s
+rights under applicable copyright and patent law, to any person or
+entity (the "Licensee") obtaining a copy of this software and
+associated documentation files (the "Software"), to do everything with
+the Software that would otherwise infringe (i) the Licensor’s copyright
+in the Software or (ii) any patent claims to the Software that the
+Licensor can license or becomes able to license, subject to all of the
+following terms and conditions:
+
+* Acceptance. This License is automatically offered to every person and
+entity subject to its terms and conditions. Licensee accepts this
+License and agrees to its terms and conditions by taking any action with
+the Software that, absent this License, would infringe any intellectual
+property right held by Licensor.
+* Notice. Licensee must ensure that everyone who gets a copy of any part
+of this Software from Licensee, with or without changes, also receives
+the License and the above copyright notice (and if included by the
+Licensor, patent, trademark and attribution notice). Licensee must cause
+any modified versions of the Software to carry prominent notices stating
+that Licensee changed the Software. For clarity, although Licensee is
+free to create modifications of the Software and distribute only the
+modified portion created by Licensee with additional or different terms,
+the portion of the Software not modified must be distributed pursuant to
+this License. If anyone notifies Licensee in writing that Licensee has
+not complied with this Notice section, Licensee can keep this License by
+taking all practical steps to comply within 30 days after the notice. If
+Licensee does not do so, Licensee’s License (and all rights licensed
+hereunder) shall end immediately.
+* Compliance with Human Rights Principles and Human Rights Laws.
+[arabic]
+. Human Rights Principles.
+[loweralpha]
+.. Licensee is advised to consult the articles of the United Nations
+Universal Declaration of Human Rights and the United Nations Global
+Compact that define recognized principles of international human rights
+(the "Human Rights Principles"). Licensee shall use the Software in a
+manner consistent with Human Rights Principles.
+.. Unless the Licensor and Licensee agree otherwise, any dispute,
+controversy, or claim arising out of or relating to (i) Section 1(a)
+regarding Human Rights Principles, including the breach of Section 1(a),
+termination of this License for breach of the Human Rights Principles,
+or invalidity of Section 1(a) or (ii) a determination of whether any Law
+is consistent or in conflict with Human Rights Principles pursuant to
+Section 2, below, shall be settled by arbitration in accordance with the
+Hague Rules on Business and Human Rights Arbitration (the "Rules");
+provided, however, that Licensee may elect not to participate in such
+arbitration, in which event this License (and all rights licensed
+hereunder) shall end immediately. The number of arbitrators shall be one
+unless the Rules require otherwise.
++
+Unless both the Licensor and Licensee agree to the contrary: (1) All
+documents and information concerning the arbitration shall be public and
+may be disclosed by any party; (2) The repository referred to under
+Article 43 of the Rules shall make available to the public in a timely
+manner all documents concerning the arbitration which are communicated
+to it, including all submissions of the parties, all evidence admitted
+into the record of the proceedings, all transcripts or other recordings
+of hearings and all orders, decisions and awards of the arbitral
+tribunal, subject only to the arbitral tribunal’s powers to take such
+measures as may be necessary to safeguard the integrity of the arbitral
+process pursuant to Articles 18, 33, 41 and 42 of the Rules; and (3)
+Article 26(6) of the Rules shall not apply.
+. Human Rights Laws. The Software shall not be used by any person or
+entity for any systems, activities, or other uses that violate any Human
+Rights Laws. "Human Rights Laws" means any applicable laws,
+regulations, or rules (collectively, "Laws") that protect human,
+civil, labor, privacy, political, environmental, security, economic, due
+process, or similar rights; provided, however, that such Laws are
+consistent and not in conflict with Human Rights Principles (a dispute
+over the consistency or a conflict between Laws and Human Rights
+Principles shall be determined by arbitration as stated above). Where
+the Human Rights Laws of more than one jurisdiction are applicable or in
+conflict with respect to the use of the Software, the Human Rights Laws
+that are most protective of the individuals or groups harmed shall
+apply.
+. Indemnity. Licensee shall hold harmless and indemnify Licensor (and
+any other contributor) against all losses, damages, liabilities,
+deficiencies, claims, actions, judgments, settlements, interest, awards,
+penalties, fines, costs, or expenses of whatever kind, including
+Licensor’s reasonable attorneys’ fees, arising out of or relating to
+Licensee’s use of the Software in violation of Human Rights Laws or
+Human Rights Principles.
+* Failure to Comply. Any failure of Licensee to act according to the
+terms and conditions of this License is both a breach of the License and
+an infringement of the intellectual property rights of the Licensor
+(subject to exceptions under Laws, e.g., fair use). In the event of a
+breach or infringement, the terms and conditions of this License may be
+enforced by Licensor under the Laws of any jurisdiction to which
+Licensee is subject. Licensee also agrees that the Licensor may enforce
+the terms and conditions of this License against Licensee through
+specific performance (or similar remedy under Laws) to the extent
+permitted by Laws. For clarity, except in the event of a breach of this
+License, infringement, or as otherwise stated in this License, Licensor
+may not terminate this License with Licensee.
+* Enforceability and Interpretation. If any term or provision of this
+License is determined to be invalid, illegal, or unenforceable by a
+court of competent jurisdiction, then such invalidity, illegality, or
+unenforceability shall not affect any other term or provision of this
+License or invalidate or render unenforceable such term or provision in
+any other jurisdiction; provided, however, subject to a court
+modification pursuant to the immediately following sentence, if any term
+or provision of this License pertaining to Human Rights Laws or Human
+Rights Principles is deemed invalid, illegal, or unenforceable against
+Licensee by a court of competent jurisdiction, all rights in the
+Software granted to Licensee shall be deemed null and void as between
+Licensor and Licensee. Upon a determination that any term or provision
+is invalid, illegal, or unenforceable, to the extent permitted by Laws,
+the court may modify this License to affect the original purpose that
+the Software be used in compliance with Human Rights Principles and
+Human Rights Laws as closely as possible. The language in this License
+shall be interpreted as to its fair meaning and not strictly for or
+against any party.
+* Disclaimer. TO THE FULL EXTENT ALLOWED BY LAW, THIS SOFTWARE COMES
+"AS IS," WITHOUT ANY WARRANTY, EXPRESS OR IMPLIED, AND LICENSOR AND
+ANY OTHER CONTRIBUTOR SHALL NOT BE LIABLE TO ANYONE FOR ANY DAMAGES OR
+OTHER LIABILITY ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE
+OR THIS LICENSE, UNDER ANY KIND OF LEGAL CLAIM.
+
+This Hippocratic License is an link:https://ethicalsource.dev[Ethical Source license] and is offered
+for use by licensors and licensees at their own risk, on an "AS IS" basis, and with no warranties
+express or implied, to the maximum extent permitted by Laws.

data/README.adoc

@@ -0,0 +1,87 @@
+:toc: macro
+:toclevels: 5
+:figure-caption!:
+
+= Seaport
+
+toc::[]
+
+== Features
+
+== Requirements
+
+. link:https://www.ruby-lang.org[Ruby].
+
+== Setup
+
+To install _with_ security, run:
+
+[source,bash]
+----
+# 💡 Skip this line if you already have the public certificate installed.
+gem cert --add <(curl --compressed --location https://undefined.io/gems.pem)
+gem install seaport --trust-policy HighSecurity
+----
+
+To install _without_ security, run:
+
+[source,bash]
+----
+gem install seaport
+----
+
+You can also add the gem directly to your project:
+
+[source,bash]
+----
+bundle add seaport
+----
+
+Once the gem is installed, you only need to require it:
+
+[source,ruby]
+----
+require "seaport"
+----
+
+== Usage
+
+== Development
+
+To contribute, run:
+
+[source,bash]
+----
+git clone https://github.com/undefined/seaport
+cd seaport
+bin/setup
+----
+
+You can also use the IRB console for direct access to all objects:
+
+[source,bash]
+----
+bin/console
+----
+
+== Tests
+
+To test, run:
+
+[source,bash]
+----
+bin/rake
+----
+
+== link:https://undefined.io/policies/license[License]
+
+== link:https://undefined.io/policies/security[Security]
+
+== link:https://undefined.io/policies/contributions[Contributions]
+
+== link:https://undefined.io/projects/seaport/versions[Versions]
+
+== Credits
+
+* Built with link:https://alchemists.io/projects/gemsmith[Gemsmith].
+* Engineered by link:https://undefined.io/team/undefined[Josef Strzibny].

data/exe/seaport

@@ -0,0 +1,6 @@
+#! /usr/bin/env ruby
+# frozen_string_literal: true
+
+require "seaport"
+
+Seaport::CLI::Shell.new.call

data/lib/seaport/cli/shell.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require "sod"
+
+module Seaport
+  module CLI
+    # The main Command Line Interface (CLI) object.
+    class Shell
+      include Import[:defaults_path, :xdg_config, :specification]
+
+      def initialize(context: Sod::Context, dsl: Sod, **)
+        super(**)
+        @context = context
+        @dsl = dsl
+      end
+
+      def call(...) = cli.call(...)
+
+      private
+
+      attr_reader :context, :dsl
+
+      def cli
+        context = build_context
+
+        dsl.new :seaport, banner: specification.banner do
+          on(Sod::Prefabs::Commands::Config, context:)
+          on(Sod::Prefabs::Actions::Version, context:)
+          on Sod::Prefabs::Actions::Help, self
+        end
+      end
+
+      def build_context
+        context[defaults_path:, xdg_config:, version_label: specification.labeled_version]
+      end
+    end
+  end
+end

data/lib/seaport/configuration/contract.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require "dry/schema"
+
+Dry::Schema.load_extensions :monads
+
+module Seaport
+  module Configuration
+    Contract = Dry::Schema.Params
+  end
+end

data/lib/seaport/configuration/defaults.yml

@@ -0,0 +1 @@
+todo: "Add your own attributes here."

data/lib/seaport/configuration/model.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Seaport
+  module Configuration
+    # Defines the configuration model for use throughout the gem.
+    Model = Struct.new
+  end
+end

data/lib/seaport/container.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "cogger"
+require "containable"
+require "etcher"
+require "runcom"
+require "spek"
+
+module Seaport
+  # Provides a global gem container for injection into other objects.
+  module Container
+    extend Containable
+
+    register :registry do
+      Etcher::Registry.new(contract: Configuration::Contract, model: Configuration::Model)
+                      .add_loader(:yaml, self[:defaults_path])
+                      .add_loader(:yaml, self[:xdg_config].active)
+    end
+
+    register(:settings) { Etcher.call(self[:registry]).dup }
+    register(:specification) { Spek::Loader.call "#{__dir__}/../../seaport.gemspec" }
+    register(:defaults_path) { Pathname(__dir__).join("configuration/defaults.yml") }
+    register(:xdg_config) { Runcom::Config.new "seaport/configuration.yml" }
+    register(:logger) { Cogger.new id: "seaport" }
+    register :io, STDOUT
+  end
+end

data/lib/seaport/import.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require "infusible"
+
+module Seaport
+  Import = Infusible[Container]
+end

data/lib/seaport.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require "zeitwerk"
+
+Zeitwerk::Loader.new.then do |loader|
+  loader.inflector.inflect "cli" => "CLI"
+  loader.tag = File.basename __FILE__, ".rb"
+  loader.push_dir __dir__
+  loader.setup
+end
+
+# Main namespace.
+module Seaport
+  def self.loader registry = Zeitwerk::Registry
+    @loader ||= registry.loaders.find { |loader| loader.tag == File.basename(__FILE__, ".rb") }
+  end
+end

data/seaport.gemspec

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+Gem::Specification.new do |spec|
+  spec.name = "seaport"
+  spec.version = "0.0.0"
+  spec.authors = ["Josef Strzibny"]
+  spec.email = ["strzibny@strzibny.name"]
+  spec.homepage = "https://strzibny.name/seaport"
+  spec.summary = ""
+  spec.license = "Hippocratic-2.1"
+
+  spec.metadata = {
+    "bug_tracker_uri" => "https://github.com/undefined/seaport/issues",
+    "changelog_uri" => "https://undefined.io/projects/seaport/versions",
+    "homepage_uri" => "https://undefined.io/projects/seaport",
+    "funding_uri" => "https://github.com/sponsors/undefined",
+    "label" => "Seaport",
+    "rubygems_mfa_required" => "true",
+    "source_code_uri" => "https://github.com/undefined/seaport"
+  }
+
+  # spec.signing_key = Gem.default_key_path
+  # spec.cert_chain = [Gem.default_cert_path]
+
+  spec.required_ruby_version = "~> 3.3"
+  spec.add_dependency "cogger", "~> 0.31"
+  spec.add_dependency "containable", "~> 0.2"
+  spec.add_dependency "dry-monads", "~> 1.6"
+  spec.add_dependency "etcher", "~> 2.7"
+  spec.add_dependency "infusible", "~> 3.12"
+  spec.add_dependency "refinements", "~> 12.10"
+  spec.add_dependency "runcom", "~> 11.10"
+  spec.add_dependency "sod", "~> 0.20"
+  spec.add_dependency "spek", "~> 3.0"
+  spec.add_dependency "zeitwerk", "~> 2.7"
+
+  spec.bindir = "exe"
+  spec.executables << "seaport"
+  spec.extra_rdoc_files = Dir["README*", "LICENSE*"]
+  spec.files = Dir["*.gemspec", "lib/**/*"]
+end

metadata

@@ -0,0 +1,204 @@
+--- !ruby/object:Gem::Specification
+name: seaport
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+platform: ruby
+authors:
+- Josef Strzibny
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2024-11-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: cogger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.31'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.31'
+- !ruby/object:Gem::Dependency
+  name: containable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: dry-monads
+  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: etcher
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+- !ruby/object:Gem::Dependency
+  name: infusible
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: refinements
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.10'
+- !ruby/object:Gem::Dependency
+  name: runcom
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.10'
+- !ruby/object:Gem::Dependency
+  name: sod
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.20'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.20'
+- !ruby/object:Gem::Dependency
+  name: spek
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+description:
+email:
+- strzibny@strzibny.name
+executables:
+- seaport
+extensions: []
+extra_rdoc_files:
+- README.adoc
+- LICENSE.adoc
+files:
+- LICENSE.adoc
+- README.adoc
+- exe/seaport
+- lib/seaport.rb
+- lib/seaport/cli/shell.rb
+- lib/seaport/configuration/contract.rb
+- lib/seaport/configuration/defaults.yml
+- lib/seaport/configuration/model.rb
+- lib/seaport/container.rb
+- lib/seaport/import.rb
+- seaport.gemspec
+homepage: https://strzibny.name/seaport
+licenses:
+- Hippocratic-2.1
+metadata:
+  bug_tracker_uri: https://github.com/undefined/seaport/issues
+  changelog_uri: https://undefined.io/projects/seaport/versions
+  homepage_uri: https://undefined.io/projects/seaport
+  funding_uri: https://github.com/sponsors/undefined
+  label: Seaport
+  rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/undefined/seaport
+post_install_message:
+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.5.16
+signing_key:
+specification_version: 4
+summary: ''
+test_files: []