fasteners 0 → 0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 74f760a2fad7e215bac6d9882aa0340dc77e6372
-  data.tar.gz: dc6f2e1d5d5aa64ac60be69c144cad487f89f593
+  metadata.gz: c857bea2cb4ce3c6f21403474044d4bbf108fcc7
+  data.tar.gz: 63c0b294701b3665c84d35bc4474938f8443d493
 SHA512:
-  metadata.gz: 61a21102257cf5bbe5b131a910a75658994e8c516e1bd1eaa8536209ff5535425b19aa8094ec67b08e534167a4b140ed75c7f3e99425d4efa96ddfc0281c7e74
-  data.tar.gz: 44e67a9e43a8c4fd68900bc3fc906759e7610467d2b69ca025122c6889d3bc17071d612837927e90a36d1b9316705fb297e1a5fbc4e32515c1adf33c6b9a4ccd
+  metadata.gz: 9fb53822e5198c65e3630a79768bb567682392869ef997bf8c217e02e2d06c23aff086d1d21ae1ec466ac51b7a6f09873c3be1a5076eda7797795247b784d8fc
+  data.tar.gz: 5390896562cc01222d602912412a8187afee614e3a3faadf0c9c7fc429d48dc5c2137ceb3a52471714e8de2814157f1fdae1edefd248c2ffc025687e6c177af0

data/Gemfile

@@ -1,4 +1,5 @@
 source 'https://rubygems.org'
 
-# Specify your gem's dependencies in fasteners.gemspec
 gemspec
+
+gem 'units', github: 'bfoz/units-ruby'

data/fasteners.gemspec

@@ -4,7 +4,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
     spec.name          = "fasteners"
-    spec.version       = '0'
+    spec.version       = '0.1'
     spec.authors       = ["Brandon Fosdick"]
     spec.email         = ["bfoz@bfoz.net"]
     spec.summary       = %q{Nuts and bolts}
@@ -17,6 +17,8 @@ Gem::Specification.new do |spec|
     spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
     spec.require_paths = ["lib"]
 
+    spec.add_dependency	'units', '~> 2.3'
+
     spec.add_development_dependency "bundler", "~> 1.6"
     spec.add_development_dependency "rake"
 end

data/lib/fasteners.rb

@@ -1,3 +1,10 @@
+require_relative 'fasteners/bolt'
+require_relative 'fasteners/nut'
+require_relative 'fasteners/socket_head_cap_screw'
+require_relative 'fasteners/washer'
+
+require_relative 'fasteners/metric/nut'
+
 module Fasteners
   # Your code goes here...
 end

data/lib/fasteners/bolt.rb

@@ -0,0 +1,28 @@
+module Fasteners
+    # A generic Bolt
+    class Bolt
+	# @!attribute clearance_diameter
+	#   @return [Number]  the diameter of the clearance hole that fits the bolt
+	attr_reader :clearance_diameter
+
+	# @!attribute diameter
+	#   @return [Number]  the diameter of the bolt shaft
+	attr_reader :diameter
+
+	# @!attribute head_diameter
+	#   @return [Number]  the diameter of the bolt head
+	attr_reader :head_diameter
+
+	# @!attribute head_length
+	#   @return [Number]  the length of the bolt head
+	attr_reader :head_length
+
+	# @!attribute length
+	#   @return [Number]  the length of the bolt shaft
+	attr_reader :length
+
+	def initialize(**options)
+	    options.each {|k,v| respond_to?(k) && instance_variable_set("@#{k}", v) }
+	end
+    end
+end

data/lib/fasteners/metric/nut.rb

@@ -0,0 +1,100 @@
+require 'units'
+
+module Fasteners
+    module Metric
+	# http://en.wikipedia.org/wiki/Nut_(hardware)
+	class Nut < Fasteners::Nut
+	    THICKNESS = {
+		2   => 1.6,
+		2.5 => 2,
+		3   => 2.4,
+		4   => 3.2,
+		5   => 4,
+		6   => 5,
+		7   => 5.5,
+		8   => 6.5,
+		10  => 8,
+		12  => 10,
+		14  => 11,
+		16  => 13,
+		18  => 15,
+		20  => 16,
+		24  => 19,
+		30  => 24,
+		36  => 29,
+	    }
+
+	    THIN_THICKNESS = {
+		2   => 1.2,
+		2.5 => 1.6,
+		3   => 1.8,
+		4   => 2.2,
+		5   => 2.7,
+		6   => 3.2,
+		7   => 3.5,
+		8   => 4,
+		10  => 5,
+		12  => 6,
+		14  => 7,
+		16  => 8,
+		18  => 9,
+		20  => 10,
+	    }
+
+	    WIDTH = {
+		1   => 2.5,
+		1.6 => 3.2,
+		2   => 4,
+		2.5 => 5,
+		3   => 5.5,
+		3.5 => 6,
+		4   => 7,
+		5   => 8,
+		6   => 10,
+		7   => 11,
+		8   => 13,
+		10  => 16,
+		12  => 18,
+		14  => 21,
+		16  => 24,
+		18  => 27,
+		20  => 30,
+		22  => 32,
+		24  => 36,
+		27  => 41,
+		30  => 46,
+		36  => 55,
+	    }
+
+	    # @param diameter	[Number]    the nominal diameter of the hole
+	    # @param type	[Symbol]    the type of the {Nut}
+	    # @return [Number]	the thickness of the {Nut} corresponding to the given diameter
+	    def self.thickness(diameter, type)
+		# Remove any units that diameter might have (the Hash doesn't like them)
+		diameter = diameter.value if diameter.respond_to?(:value)
+
+		case type
+		    when :thin then THIN_THICKNESS[diameter] || raise(ArgumentError, "There is no thin version of an M#{diameter} nut")
+		    else
+			THICKNESS[diameter] || raise(ArgumentError, "There is no standard thickness for an M#{diameter} nut")
+		end
+	    end
+
+	    # @param diameter	[Number]    the nominal diameter of the hole
+	    # @return [Number]	the width of the {Nut} between the flats
+	    def self.width(diameter)
+		# Remove any units that diameter might have (the Hash doesn't like them)
+		diameter = diameter.value if diameter.respond_to?(:value)
+
+		WIDTH[diameter] || raise(ArgumentError, "There is no standard width for an M#{diameter} nut")
+	    end
+
+	    def initialize(**options)
+		super **options
+
+		@height = self.class.thickness(hole_diameter, type).mm
+		@width = self.class.width(hole_diameter).mm
+	    end
+	end
+    end
+end

data/lib/fasteners/nut.rb

@@ -0,0 +1,28 @@
+module Fasteners
+    # A generic Nut
+    # http://en.wikipedia.org/wiki/Nut_(hardware)
+    class Nut
+	# @!attribute height
+	#   @return [Number]  the height of the {Nut}
+	attr_reader :height
+	alias :thickness :height
+
+	# @!attribute hole_diameter
+	#   @return [Number]  the nominal diameter of the screw that the {Nut} fits
+	attr_reader :hole_diameter
+	alias :diameter :hole_diameter
+
+	# @!attribute width
+	#   @return [Number]  the width of the {Nut} between the flats (also the wrench size)
+	attr_reader :width
+	alias :indiameter :width
+
+	# @!attribute type
+	#   @return [Symbol]  :hex, :thin, :jam, :nylon (defaults to :hex)
+	attr_reader :type
+
+	def initialize(**options)
+	    options.each {|k,v| respond_to?(k) && instance_variable_set("@#{k}", v) }
+	end
+    end
+end

data/lib/fasteners/socket_head_cap_screw.rb

@@ -0,0 +1,23 @@
+require_relative 'bolt'
+
+module Fasteners
+    # Your standard metric socket head cap screw
+    # http://en.wikipedia.org/wiki/ISO_metric_screw_thread
+    class SocketHeadCapScrew < Bolt
+	# @!attribute socket_diameter
+	#   @return [Number]  the diameter of the socket (the indiameter for hexagonal sockets)
+	attr_reader :socket_diameter
+
+	# @param diameter   [Number]	The nominal diameter of the screw
+	def initialize(diameter, **options)
+	    options[:diameter] = diameter
+	    options[:head_diameter] = 2 * diameter
+	    options[:head_length] = diameter
+
+	    @socket_depth = 0.75 * diameter
+	    @socket_diameter = 0.8 * diameter
+
+	    super **options
+	end
+    end
+end

data/lib/fasteners/washer.rb

@@ -0,0 +1,24 @@
+module Fasteners
+    # A generic Washer
+    # http://en.wikipedia.org/wiki/Washer_(hardware)
+    class Washer
+	# @!attribute thickness
+	#   @return [Number]  the thickness of the {Washer}
+	attr_reader :thickness
+	alias :height :thickness
+
+	# @!attribute inner_diameter
+	#   @return [Number]  the diameter of the hole
+	attr_reader :inner_diameter
+	alias :hole_diameter :inner_diameter
+	alias :diameter :hole_diameter
+
+	# @!attribute outer_diameter
+	#   @return [Number]  the outer diameter  of the {Washer}
+	attr_reader :outer_diameter
+
+	def initialize(**options)
+	    options.each {|k,v| respond_to?(k) && instance_variable_set("@#{k}", v) }
+	end
+    end
+end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: fasteners
 version: !ruby/object:Gem::Version
-  version: '0'
+  version: '0.1'
 platform: ruby
 authors:
 - Brandon Fosdick
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-14 00:00:00.000000000 Z
+date: 2014-11-13 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: units
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.3'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -50,6 +64,11 @@ files:
 - Rakefile
 - fasteners.gemspec
 - lib/fasteners.rb
+- lib/fasteners/bolt.rb
+- lib/fasteners/metric/nut.rb
+- lib/fasteners/nut.rb
+- lib/fasteners/socket_head_cap_screw.rb
+- lib/fasteners/washer.rb
 homepage: http://github.com/bfoz/fasteners-ruby
 licenses:
 - BSD