lca 0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4ff437267879f30b1fdf073964e93eaf6be5c580a8baefa2fd308b1b7d38de1f
+  data.tar.gz: 6ffcf161a6bd74b41f3ca07ae7ce78e41e8e9fa68f1ff1c5350a1bab5193c9d0
+SHA512:
+  metadata.gz: a2133b1c9680cb1cfb78b26335d449a86b04871fac6357f2a1741dc57434398c40156af1613a691485b168d0cfb62ee41f0c8299829b5594ba6eebfe218499c4
+  data.tar.gz: 65a355dd57bdaf6deffcdffbb567247b6d28a6ac1dd7100631205e4d1337cf123c110aeeb517372ade19f13f166c85c9ee837d25c7441a692942d988cd946b8e

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec
+
+gem "rake", "~> 13.0"
+gem "rspec", "~> 3.0"
+
+gem "activerecord", "~> 6.0"
+gem "activestorage", "~> 6.0"
+gem "actiontext", "~> 6.0"

data/Gemfile.lock

@@ -0,0 +1,115 @@
+PATH
+  remote: .
+  specs:
+    lca (0.1.18)
+      actiontext (~> 6.0)
+      activerecord (~> 6.0)
+      activestorage (~> 6.0)
+      jwt (~> 2.2.3)
+      pg_ltree (~> 1.1.8)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionpack (6.1.4.1)
+      actionview (= 6.1.4.1)
+      activesupport (= 6.1.4.1)
+      rack (~> 2.0, >= 2.0.9)
+      rack-test (>= 0.6.3)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.2.0)
+    actiontext (6.1.4.1)
+      actionpack (= 6.1.4.1)
+      activerecord (= 6.1.4.1)
+      activestorage (= 6.1.4.1)
+      activesupport (= 6.1.4.1)
+      nokogiri (>= 1.8.5)
+    actionview (6.1.4.1)
+      activesupport (= 6.1.4.1)
+      builder (~> 3.1)
+      erubi (~> 1.4)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.1, >= 1.2.0)
+    activejob (6.1.4.1)
+      activesupport (= 6.1.4.1)
+      globalid (>= 0.3.6)
+    activemodel (6.1.4.1)
+      activesupport (= 6.1.4.1)
+    activerecord (6.1.4.1)
+      activemodel (= 6.1.4.1)
+      activesupport (= 6.1.4.1)
+    activestorage (6.1.4.1)
+      actionpack (= 6.1.4.1)
+      activejob (= 6.1.4.1)
+      activerecord (= 6.1.4.1)
+      activesupport (= 6.1.4.1)
+      marcel (~> 1.0.0)
+      mini_mime (>= 1.1.0)
+    activesupport (6.1.4.1)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
+    builder (3.2.4)
+    concurrent-ruby (1.1.9)
+    crass (1.0.6)
+    diff-lcs (1.4.4)
+    erubi (1.10.0)
+    globalid (0.5.2)
+      activesupport (>= 5.0)
+    i18n (1.8.10)
+      concurrent-ruby (~> 1.0)
+    jwt (2.2.3)
+    loofah (2.12.0)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.5.9)
+    marcel (1.0.1)
+    mini_mime (1.1.1)
+    minitest (5.14.4)
+    nokogiri (1.12.4-x86_64-linux)
+      racc (~> 1.4)
+    pg (1.2.3)
+    pg_ltree (1.1.8)
+      activerecord (>= 4.0.0, <= 7.0.0.rc1)
+      pg (>= 0.17.0, < 2)
+    racc (1.5.2)
+    rack (2.2.3)
+    rack-test (1.1.0)
+      rack (>= 1.0, < 3)
+    rails-dom-testing (2.0.3)
+      activesupport (>= 4.2.0)
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.4.2)
+      loofah (~> 2.3)
+    rake (13.0.6)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.2)
+    tzinfo (2.0.4)
+      concurrent-ruby (~> 1.0)
+    zeitwerk (2.4.2)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  actiontext (~> 6.0)
+  activerecord (~> 6.0)
+  activestorage (~> 6.0)
+  lca!
+  rake (~> 13.0)
+  rspec (~> 3.0)
+
+BUNDLED WITH
+   2.2.27

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 CheckThisOut
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 OR COPYRIGHT HOLDERS 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.

data/README.md

@@ -0,0 +1,110 @@
+# LCA
+
+Storing, processing and working with life-cycle assessment data has always been challenging. A multitude of data models and implementations exist already but every one of them makes huge compromises or lacks functionality. 
+
+This gem implements a denormalized database model for life-cycle assessment data as well as several innovative query interfaces. 
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'lca'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install lca
+    
+Upon installing the gem you must run the install process in your Rails application's root:
+
+    $ rails g lca:install
+    
+This will generate a `config/lca.yml` which you may customize to your needs, an initializer and a migration file which you can also customize to add any database columns your models will require.
+
+## Usage
+
+Include the LCA concern into one of your models which will own lifecycle trees (owner model):
+
+```ruby
+    class User < ApplicationRecord
+        include Lca::Lcable
+        # ...
+    end
+```
+
+This will extend your model and enable the following functionality:
+
+```ruby
+    # query with ActiveRecord syntax
+    User.last.lca_cycles
+    User.find_by(name: "Acme").lca_cycles.impacts.select("impact_unit, sum(impact_amount) as total_impact").group(:impact_unit)
+    User.last.lca_cycles.where(...)
+    User.last.lca_cycles.where(...).group(...)
+    User.last.lca_cycles.where(...).limit(...).offset(...)
+    
+    # AR query with ltree syntax
+    User.last.lca_cycles.disabled.match_path("*.CustomProcess.*")
+    User.last.lca_cycles.match_path("*{5,10}.CustomProcess.*.Ecosphere.*")
+    User.last.lca_cycles.active.match_path("*.WhateverProcess.*.Ecosphere.*.CO2Emission.*").where( impact_amount: [100..150]).sum(:impact_amount)
+
+    Lca::Cycle.match_path("Top.Electric Vehicle.*").impacts.match_path("*.CO2*").where( impact_amount: [ 1000..10000 ]).average(:impact_amount)
+    Lca::Cycle::Product.where(name: "Electric Vehicle Battery").impacts.match_path("*.Cobalt.*").sum(:impact_amount)
+    Lca::Process.where(owner: User.last).match_path("*{10,20}.*Assembly, automated.*")
+    Lca::Impact.match_path("*.Transport by truck.*")
+    Lca::Exchange.match_path("*.Oil.*.Ecosphere.*").impacts.sum(:impact_amount)
+    Lca::Product.match_path("*.ElectricVehicle.*").processes.match_path("*.Processing.*").where(location: "EU").impacts.match_path("*.Lithium.*").where(location: ["CN", "Africa"]).sum(:impact_amount)
+        
+    # pg_ltree queries
+    User.last.lca_cycles.last.parent
+    Lca::Process.match_path("*.Manual assembly.*").children
+    
+    # pg_ltree combined with AR syntax
+    User.last.lca_cycles(type: "Lca::Product").children.match_path("*.Retail").children.exchanges
+    
+    # all queries can be directed to a specific partition:
+    Lca::Process.owned_by( owner_id ).match_path("*.Recycling.*").where(impact_unit: "tons CO2/year").impacts.sum(:impact_amount)
+    
+```
+
+The gem also creates some default models:
+
+```ruby
+    Lca::Process::Transport::ByAir.match_path("*.CO2Emission.*").impacts.sum(:impact_amount)
+    Lca::Impact::Ecosphere::Fauna.match_path("*.ResourceExtraction.*").where(impact_unit: "Species killed/year").sum(:impact_amount)
+```
+
+To see what syntax to use for path traversal please check out the following resources:
+* pg_ltree gem https://github.com/sjke/pg_ltree
+* Postgres ltree extension documentation https://www.postgresql.org/docs/9.1/ltree.html
+
+The LCA gem is designed to be compatible with PostgREST. PostgREST is an amazing tool that generates a CRUD REST API for your Postgres database, read more about it here: https://postgrest.org
+
+If the `create_postgrest_roles` setting is on each new owner will be assigned a Postgres role allowing them to access data within their partition using PostgREST. Your owner model will be extended with a `.generate_jwt` method you can use to generate the PostgREST authentication token.
+
+## Roadmap
+
+* more models for various LCA cycles, processes and impacts
+* model validations
+* query objects, including postgres RECURSIVE queries
+* builders
+* seeds/fixtures
+* automated tests
+
+
+## Contributing
+
+Bug reports, pull requests and feature suggestions are welcome on GitHub at https://github.com/nicksterious/lca 
+
+## Sponsors
+
+We welcome any sponsorship through Github Sponsors. All corporate sponsors' logo and URL of choice shall show up within this section.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "lca"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/generators/lca/install_generator.rb

@@ -0,0 +1,26 @@
+require "rails/generators/active_record"
+
+module Lca
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      include ActiveRecord::Generators::Migration
+      source_root File.join(__dir__, "templates")
+
+      def copy_migration
+        migration_template "migration.rb.tt", "db/migrate/install_lca.rb", migration_version: migration_version
+      end
+
+      def copy_initializer
+	    copy_file 'initializer.rb.tt', 'config/initializers/lca.rb'
+      end
+
+      def copy_config
+        copy_file "config.yml.tt", "config/lca.yml"
+      end
+
+      def migration_version
+        "[#{ActiveRecord::VERSION::MAJOR}.#{ActiveRecord::VERSION::MINOR}]"
+      end
+    end
+  end
+end

data/lib/generators/lca/templates/config.yml.tt

@@ -0,0 +1,14 @@
+# the main table will be called "lca_models"
+# partitions will be called "lca_models_X" where X is the owner object ID
+table_name: "lca_models"
+
+# create PG roles for postgrest: anon and owner-specific roles
+create_postgrest_roles: true
+
+# on owner removal, detach the partition but preserve the table and data, or destroy the partition and data
+# if you choose to detach and preserve, in order to avoid table name collisions, make sure owner IDs are not reused
+destroy_partition_on_owner_destroy: true
+
+# jwt secret required for postgrest role switching
+jwt_secret: "supersecret"
+jwt_encryption: "HS256"

data/lib/generators/lca/templates/initializer.rb.tt

@@ -0,0 +1,16 @@
+LCA_OPTIONS ||= begin
+    path = Rails.root.join("config", "lca.yml").to_s
+    if File.exist?(path)
+        YAML.load( ERB.new(File.read(path)).result ).deep_symbolize_keys
+    else
+        {
+            table_name: "lca_models",
+            create_postgrest_roles: true,
+            jwt_secret: "supersecret",
+            jwt_encryption: "HS256",
+            destroy_partition_on_owner_destroy: true
+        }
+    end
+end.merge({
+    database_user: Rails.application.config.database_configuration[ Rails.env ].deep_symbolize_keys[:username]
+})

data/lib/generators/lca/templates/migration.rb.tt

@@ -0,0 +1,61 @@
+class <%= migration_class_name %> < ActiveRecord::Migration<%= migration_version %>
+  def change
+
+    # enable ltree extension
+    begin
+        execute "create extension ltree"
+    rescue
+	   p "LTREE was already enabled"
+    end
+
+    # LCA_OPTIONS[:table_name]
+    execute <<-SQL
+    create table #{ LCA_OPTIONS[:table_name] } (
+	id serial,
+
+	owner_id integer,
+    owner_type text,
+
+	data_external_id text,
+	data_provider text,
+
+	type text,
+	name text,
+
+	parent_id integer,
+    parent_type text,
+
+	path ltree,
+    	path_slug text,
+
+	impact_amount decimal,
+	impact_amount_unit text,
+	impact_factor decimal,
+	impact_precision decimal,
+
+	primary key (id, owner_id)
+    ) partition by list(owner_id)
+SQL
+
+    # TODO do we want to also create an "others" partition?
+    # "CREATE TABLE #{LCA_OPTIONS[:table_name]}_others PARTITION OF #{LCA_OPTIONS[:table_name]} DEFAULT"
+
+    # add indexes
+    add_index LCA_OPTIONS[:table_name], :id
+    add_index LCA_OPTIONS[:table_name], :owner_id
+    add_index LCA_OPTIONS[:table_name], :type
+    add_index LCA_OPTIONS[:table_name], :parent_id
+
+    # next two indexes unfortunately can't be unique since a cycle can appear several times under an owner
+    add_index LCA_OPTIONS[:table_name], :path, using: :gist
+    add_index LCA_OPTIONS[:table_name], [:data_provider, :data_external_id]
+
+    if LCA_OPTIONS[:create_postgrest_roles]
+    	# create postgrest anon user with no privs
+    	# postgrest may pass an user's role using JWT
+    	execute "drop role if exists postgrest_anon"
+    	execute "create role postgrest_anon nologin"
+    	execute "grant postgrest_anon to #{ LCA_OPTIONS[:database_user] }"
+    end
+  end
+end

data/lib/lca/active_record.rb

@@ -0,0 +1,6 @@
+# this still needed?
+# we include the concern manually so there should be no need for this anymore
+ActiveSupport.on_load(:active_record) do
+    puts "tf is AR still being extended?"
+    extend Lca::Lcable
+end

data/lib/lca/builders/builder.rb

@@ -0,0 +1,3 @@
+class Lca::Builder
+
+end

data/lib/lca/models/concerns/lcable.rb

@@ -0,0 +1,84 @@
+require "jwt"
+
+module Lca
+    module Lcable
+    	extend ActiveSupport::Concern
+
+        # def self.included(base)
+        #     ::Lca::Model.class_exec do
+        #         @@owner_class = base.name
+        #     end
+        # end
+
+        included do
+
+    	    has_many :lca_cycles, class_name: "::Lca::Cycle", foreign_key: :owner_id, as: :owner
+    	    after_create :lca_create_storage
+    	    before_destroy :lca_delete_storage
+
+            # instance methods
+        	def lca_role
+        	    "lca_owner_#{id}"
+        	end # role
+
+            # Generates a JWT token the client (SPA) can pass to PostgREST for privilege escalation
+        	def generate_jwt
+        	    payload = { role: self.lca_role }
+        	    ::JWT.encode payload, LCA_OPTIONS[:jwt_secret], LCA_OPTIONS[:jwt_encryption]
+        	end # .generate_jwt
+
+
+            # Returns the LCA table name as configured within config/lca.yml
+        	def lca_table_name
+        	    LCA_OPTIONS[:table_name]
+        	end # .lca_table_name
+
+
+            # Creates LCA table partition and role for owner
+        	def lca_create_storage
+
+        	    # create data partition
+        	    lca_sql "create table if not exists #{lca_table_name}_#{id} partition of #{lca_table_name} for values in (#{id})"
+        	    # TODO create partition indexes
+
+                if LCA_OPTIONS[:create_postgrest_roles]
+            	    # drop role if it exists
+                    lca_sql "drop role if exists lca_owner_#{id}"
+
+                    # create role
+            	    lca_sql "create role lca_owner_#{id}"
+
+        	        # grant privs
+        	        lca_sql "grant all privileges on #{lca_table_name}_#{id} to lca_owner_#{id}"
+                end
+
+        	end # create_storage
+
+
+            # Deletes or detaches the partition and removes the role for this owner
+        	def lca_delete_storage
+
+                if LCA_OPTIONS[:create_postgrest_roles]
+        	        # revoke privs
+        	        lca_sql "REVOKE ALL PRIVILEGES ON #{lca_table_name}_#{id} FROM lca_owner_#{id}"
+
+        	        # delete role
+        	        lca_sql "drop role lca_owner_#{id}"
+                end
+
+                if LCA_OPTIONS[:destroy_partition_on_owner_destroy]
+        	        # delete partition
+        	        lca_sql "drop table if exists #{lca_table_name}_#{id}"
+                else
+                    # detach and forget about it
+                    lca_sql "alter table #{lca_table_name} detach partition lca_owner_#{id}"
+                end
+        	end # delete_storage
+
+            def lca_sql sql
+                ActiveRecord::Base.connection.execute sql
+            end # lca_sql
+
+    	end # ClassMethods
+    end
+end

data/lib/lca/models/concerns/statusable.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+module Lca::Statusable
+
+    extend ActiveSupport::Concern
+
+    included do
+        scope :active, -> { where(status: 1) }
+        scope :inactive, -> { where(status: 0) }
+	alias_method :enabled?, :active?
+	alias_method :enable!, :active!
+	alias_method :on!, :active!
+	alias_method :disabled?, :inactive?
+	alias_method :disable!, :inactive!
+	alias_method :off!, :inactive!
+	alias_method :toggle?, :toggle_status!
+    end
+
+
+    def toggle_status!
+        if active?
+            inactive!
+        else
+            active!
+        end
+    end
+
+    def status?
+	    [:inactive, :active][ status ]
+    end
+
+    def active?
+        status == 1
+    end
+    def inactive?
+        status == 0
+    end
+
+    def active!
+        self.update(status: 1)
+    end
+    def inactive!
+        self.update(status: 0)
+    end
+end

data/lib/lca/models/cycle/activity.rb

@@ -0,0 +1,3 @@
+class Lca::Cycle::Activity < Lca::Cycle
+
+end

data/lib/lca/models/cycle/product.rb

@@ -0,0 +1,6 @@
+class Lca::Cycle::Product < Lca::Cycle
+    # price?
+    # quantity?
+    # life time?
+    # life time unit?
+end

data/lib/lca/models/cycle/service.rb

@@ -0,0 +1,4 @@
+class Lca::Cycle::Service < Lca::Cycle
+    # duration?
+    # price?
+end

data/lib/lca/models/cycle.rb

@@ -0,0 +1,13 @@
+class Lca::Cycle < Lca::Model
+
+    has_many :stages, class_name: "::Lca::Stage", foreign_key: :parent_id, dependent: :destroy
+
+    def subcycles
+        ::Lca::Cycle.match_path("#{path}.*")
+    end
+
+    def processes
+        ::Lca::Process.match_path("#{path}.*")
+    end
+
+end

data/lib/lca/models/exchange.rb

@@ -0,0 +1,4 @@
+class Lca::Exchange < Lca::Model
+    belongs_to :process, class_name: "::Lca::Process", foreign_key: :parent_id
+    has_many :impacts, class_name: "::Lca::Impact", foreign_key: :parent_id, dependent: :destroy
+end

data/lib/lca/models/impact/ecosphere/fauna.rb

@@ -0,0 +1,3 @@
+class Lca::Impact::Ecosphere::Fauna < Lca::Impact::Ecosphere
+
+end

data/lib/lca/models/impact/ecosphere/flora.rb

@@ -0,0 +1,3 @@
+class Lca::Impact::Ecosphere::Flora < Lca::Impact::Ecosphere
+
+end

data/lib/lca/models/impact/ecosphere.rb

@@ -0,0 +1,3 @@
+class Lca::Impact::Ecosphere < Lca::Impact
+
+end

data/lib/lca/models/impact/human_health/cancer.rb

@@ -0,0 +1,3 @@
+class Lca::Impact::HumanHealth::Cancer < Lca::Impact::HumanHealth
+
+end

data/lib/lca/models/impact/human_health.rb

@@ -0,0 +1,3 @@
+class Lca::Impact::HumanHealth < Lca::Impact
+
+end

data/lib/lca/models/impact/technosphere/resource_availability.rb

@@ -0,0 +1,3 @@
+class Lca::Impact::Technosphere::ResourceAvailability < Lca::Impact::Technosphere
+
+end

data/lib/lca/models/impact/technosphere.rb

@@ -0,0 +1,3 @@
+class Lca::Impact::Technosphere < Lca::Impact
+
+end

data/lib/lca/models/impact.rb

@@ -0,0 +1,8 @@
+class Lca::Impact < Lca::Model
+    belongs_to :exchange, class_name: "::Lca::Exchange", foreign_key: :parent_id
+    
+    validates_presence_of :impact_amount
+    validates_presence_of :impact_amount_unit, allow_blank: false
+    validates_presence_of :impact_factor
+    validates_presence_of :impact_precision
+end

data/lib/lca/models/model.rb

@@ -0,0 +1,69 @@
+class Lca::Model < ActiveRecord::Base
+
+    include Lca::Statusable
+
+    self.primary_key = :id
+
+    def self.table_name
+        return ::LCA_OPTIONS[:table_name] if defined? ::LCA_OPTIONS
+        return "lca_models"
+    end
+
+    belongs_to :owner, polymorphic: :true
+
+    scope :match_path, -> (some_path) { where("path ~ ?", "#{some_path}") }
+
+    #has_one_attached :picture
+    #has_rich_text :description
+
+    validates_presence_of :name, allow_blank: false
+    validates_presence_of :path, allow_blank: false
+
+    before_save :set_defaults
+    def set_defaults
+        self.path ||= name.parameterize.gsub("-", ".")
+        self.path_slug = path.parameterize
+    end
+
+
+    # Scoping by owner in order to select the partition
+    #
+    # @param owner_id [Integer] the partition owner
+    def self.owned_by(owner_id)
+        # if we're looking for anything else but an integer, revert to the base class
+        return self if !owner_id.is_a? Integer
+
+        partition_suffix = "_#{owner_id}"
+
+        table = "#{ self.table_name }#{ partition_suffix }"
+
+        ApplicationRecord.connection.schema_cache.clear!
+        return self if !ApplicationRecord.connection.schema_cache.data_source_exists? table
+
+        # duplicate the class
+        model_class = Class.new self
+        original_class_name = self.name
+
+        # ...for this owner
+        class_name = "#{name}#{partition_suffix}"
+
+        # specify the table
+        model_class.define_singleton_method(:table_name) do
+            table
+        end
+
+        # specify the name
+        model_class.define_singleton_method(:name) do
+            class_name
+        end
+
+        # override the STI name lmfao
+        model_class.define_singleton_method(:find_sti_class) do |p|
+            original_class_name.constantize
+        end
+
+        # proceed
+        model_class
+    end # .owned_by
+
+end

data/lib/lca/models/process/raw_resource/extraction.rb

@@ -0,0 +1,3 @@
+class Lca::Process::RawResource::Extraction < Lca::Process::RawResource
+
+end

data/lib/lca/models/process/raw_resource.rb

@@ -0,0 +1,2 @@
+class Lca::Process::RawResource < Lca::Process
+end

data/lib/lca/models/process/transport/by_air.rb

@@ -0,0 +1,3 @@
+class Lca::Process::Transport::ByAir < Lca::Process::Transport
+
+end

data/lib/lca/models/process/transport/by_pigeon.rb

@@ -0,0 +1,2 @@
+class Lca::Process::Transport::ByPigeon < Lca::Process::Transport
+end

data/lib/lca/models/process/transport/by_sea.rb

@@ -0,0 +1,2 @@
+class Lca::Process::Transport::BySea < Lca::Process::Transport
+end

data/lib/lca/models/process/transport/by_truck.rb

@@ -0,0 +1,2 @@
+class Lca::Process::Transport::ByTruck < Lca::Process::Transport
+end

data/lib/lca/models/process/transport.rb

@@ -0,0 +1,2 @@
+class Lca::Process::Transport < Lca::Process
+end

data/lib/lca/models/process.rb

@@ -0,0 +1,10 @@
+class Lca::Process < Lca::Model
+
+    has_many :exchanges, class_name: "::Lca::Exchange", foreign_key: :parent_id, dependent: :destroy
+    has_many :impacts, through: :exchanges
+    belongs_to :stage, class_name: "::Lca::Stage", foreign_key: :parent_id
+
+    def subprocesses
+        ::Lca::Process.where("path ~ ?", "#{path}.*")
+    end
+end

data/lib/lca/models/stage/end_of_life.rb

@@ -0,0 +1,3 @@
+class Lca::Stage::EndOfLife < Lca::Stage
+
+end

data/lib/lca/models/stage/manufacturing.rb

@@ -0,0 +1,3 @@
+class Lca::Stage::Manufacturing < Lca::Stage
+
+end

data/lib/lca/models/stage/retail.rb

@@ -0,0 +1,3 @@
+class Lca::Stage::Retail < Lca::Stage
+
+end

data/lib/lca/models/stage/use.rb

@@ -0,0 +1,3 @@
+class Lca::Stage::Use < Lca::Stage
+
+end

data/lib/lca/models/stage.rb

@@ -0,0 +1,6 @@
+class Lca::Stage < Lca::Model
+
+    belongs_to :cycle, class_name: "::Lca::Cycle", foreign_key: :parent_id
+    has_many :processes, class_name: "::Lca::Process", foreign_key: :parent_id
+
+end

data/lib/lca/queries/cycle/generic.rb

@@ -0,0 +1,3 @@
+class Lca::Queries::Cycle::Generic < Lca::Queries::Query
+
+end

data/lib/lca/queries/impact/generic.rb

@@ -0,0 +1,3 @@
+class Lca::Queries::Impact::Generic < Lca::Queries::Query
+
+end

data/lib/lca/queries/process/generic.rb

@@ -0,0 +1,3 @@
+class Lca::Queries::Process::Generic < Lca::Queries::Query
+
+end

data/lib/lca/queries/query.rb

@@ -0,0 +1,8 @@
+class Lca::Queries::Query
+
+    def valid_input?(v)
+	return false if [ [], "", "0", 0, nil, [""], [0], ["0"], [nil], "all" ].include?(v)
+        return true
+    end
+
+end

data/lib/lca/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Lca
+  VERSION = "0.2"
+end

data/lib/lca.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+require "active_support/all"
+
+require "active_record"
+
+require_relative "lca/version"
+
+require_relative "lca/models/concerns/statusable"
+require_relative "lca/models/model"
+require_relative "lca/models/cycle"
+require_relative "lca/models/stage"
+require_relative "lca/models/process"
+require_relative "lca/models/exchange"
+require_relative "lca/models/impact"
+require_relative "lca/models/cycle/product"
+require_relative "lca/models/cycle/service"
+require_relative "lca/models/cycle/activity"
+require_relative "lca/models/stage/manufacturing"
+require_relative "lca/models/stage/retail"
+require_relative "lca/models/stage/use"
+require_relative "lca/models/stage/end_of_life"
+require_relative "lca/models/process/raw_resource"
+require_relative "lca/models/process/raw_resource/extraction"
+require_relative "lca/models/process/transport"
+require_relative "lca/models/process/transport/by_air"
+require_relative "lca/models/process/transport/by_sea"
+require_relative "lca/models/process/transport/by_pigeon"
+require_relative "lca/models/process/transport/by_truck"
+require_relative "lca/models/exchange"
+require_relative "lca/models/impact/ecosphere"
+require_relative "lca/models/impact/human_health"
+require_relative "lca/models/impact/technosphere"
+require_relative "lca/models/impact/ecosphere/fauna"
+require_relative "lca/models/impact/ecosphere/flora"
+require_relative "lca/models/impact/human_health/cancer"
+require_relative "lca/models/impact/technosphere/resource_availability"
+
+require_relative "lca/models/concerns/lcable"
+require_relative "lca/active_record"
+
+# TODO add query objects and builders
+#require "lca/queries/"
+#require "lca/builders/"
+
+module Lca
+    class Error < StandardError; end
+
+    # Your code goes here...
+
+    class << self
+    	attr_accessor :lca_models
+    	attr_accessor :options
+    end
+
+    self.lca_models = []
+
+    def self.lca_options
+	    @options ||= begin
+    	    path = Rails.root.join("config", "lca.yml").to_s
+    	    if File.exist?(path)
+    		    YAML.load(ERB.new(File.read(path)).result)
+    	    else
+        		{
+        		    table_name: "lca_models",
+        		    jwt_secret: "",
+        		    jwt_encryption: "HS256"
+        		}
+    	    end
+    	end
+    end
+
+    def self.env
+        @env ||= ENV["RAILS_ENV"] || ENV["RACK_ENV"] || "development"
+    end
+end

metadata

@@ -0,0 +1,166 @@
+--- !ruby/object:Gem::Specification
+name: lca
+version: !ruby/object:Gem::Version
+  version: '0.2'
+platform: ruby
+authors:
+- Nick @ Earthster
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2021-09-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: activestorage
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: actiontext
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: pg_ltree
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.8
+- !ruby/object:Gem::Dependency
+  name: jwt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.3
+description: This gem allows storing and querying lifecycle assessment data in a meaningful,
+  comprehensive way using a Postgres ltree structure
+email:
+- nick@earthster.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/generators/lca/install_generator.rb
+- lib/generators/lca/templates/config.yml.tt
+- lib/generators/lca/templates/initializer.rb.tt
+- lib/generators/lca/templates/migration.rb.tt
+- lib/lca.rb
+- lib/lca/active_record.rb
+- lib/lca/builders/builder.rb
+- lib/lca/models/concerns/lcable.rb
+- lib/lca/models/concerns/statusable.rb
+- lib/lca/models/cycle.rb
+- lib/lca/models/cycle/activity.rb
+- lib/lca/models/cycle/product.rb
+- lib/lca/models/cycle/service.rb
+- lib/lca/models/exchange.rb
+- lib/lca/models/impact.rb
+- lib/lca/models/impact/ecosphere.rb
+- lib/lca/models/impact/ecosphere/fauna.rb
+- lib/lca/models/impact/ecosphere/flora.rb
+- lib/lca/models/impact/human_health.rb
+- lib/lca/models/impact/human_health/cancer.rb
+- lib/lca/models/impact/technosphere.rb
+- lib/lca/models/impact/technosphere/resource_availability.rb
+- lib/lca/models/model.rb
+- lib/lca/models/process.rb
+- lib/lca/models/process/raw_resource.rb
+- lib/lca/models/process/raw_resource/extraction.rb
+- lib/lca/models/process/transport.rb
+- lib/lca/models/process/transport/by_air.rb
+- lib/lca/models/process/transport/by_pigeon.rb
+- lib/lca/models/process/transport/by_sea.rb
+- lib/lca/models/process/transport/by_truck.rb
+- lib/lca/models/stage.rb
+- lib/lca/models/stage/end_of_life.rb
+- lib/lca/models/stage/manufacturing.rb
+- lib/lca/models/stage/retail.rb
+- lib/lca/models/stage/use.rb
+- lib/lca/queries/cycle/generic.rb
+- lib/lca/queries/impact/generic.rb
+- lib/lca/queries/process/generic.rb
+- lib/lca/queries/query.rb
+- lib/lca/version.rb
+homepage: https://github.com/nicksterious/lca
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/nicksterious/lca
+  source_code_uri: https://github.com/nicksterious/lca
+  changelog_uri: https://github.com/nicksterious/lca/blob/master/CHANGELOG.md
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: A storage backend for LCA data
+test_files: []