binarylogic-shippinglogic 0.9.0 → 1.0.0

data/lib/shippinglogic/fedex/request.rb

@@ -5,7 +5,7 @@ module Shippinglogic
       private
         # Convenience method for sending requests to FedEx
         def request(body)
-          self.class.post(base.options[:test] ? base.options[:test_url] : base.options[:production_url], :body => body)
+          real_class.post(base.options[:test] ? base.options[:test_url] : base.options[:production_url], :body => body)
         end
         
         # Convenience method to create a builder object so that our builder options are consistent across
@@ -42,6 +42,48 @@ module Shippinglogic
             b.Minor minor
           end
         end
+        
+        # A convenience method for building the contact block in your XML request
+        def build_contact(b, type)
+          b.Contact do
+            b.Contact send("#{type}_name") if send("#{type}_name")
+            b.CompanyName send("#{type}_company_name") if send("#{type}_company_name")
+            b.PhoneNumber send("#{type}_phone_number") if send("#{type}_phone_number")
+          end
+        end
+        
+        # A convenience method for building the address block in your XML request
+        def build_address(b, type)
+          b.Address do
+            b.StreetLines send("#{type}_streets") if send("#{type}_streets")
+            b.City send("#{type}_city") if send("#{type}_city")
+            b.StateOrProvinceCode send("#{type}_state") if send("#{type}_state")
+            b.PostalCode send("#{type}_postal_code") if send("#{type}_postal_code")
+            b.CountryCode send("#{type}_country") if send("#{type}_country")
+            b.Residential send("#{type}_residential")
+          end
+        end
+        
+        # A convenience method for building the package block in your XML request
+        def build_package(b)
+          b.PackageCount package_count
+          
+          b.RequestedPackages do
+            b.SequenceNumber 1
+            
+            b.Weight do
+              b.Units package_weight_units
+              b.Value package_weight
+            end
+            
+            b.Dimensions do
+              b.Length package_length
+              b.Width package_width
+              b.Height package_height
+              b.Units package_dimension_units
+            end
+          end
+        end
     end
   end
 end

data/lib/shippinglogic/fedex/response.rb

@@ -16,7 +16,7 @@ module Shippinglogic
         
         # Was the response a success?
         def success?(response)
-          response.is_a?(Hash) && ["SUCCESS", "NOTE"].include?(response[:highest_severity])
+          response.is_a?(Hash) && ["SUCCESS", "NOTE", "WARNING"].include?(response[:highest_severity])
         end
         
         # Cleans the response and returns it in a more 'user friendly' format that is easier

data/lib/shippinglogic/fedex/service.rb

@@ -6,7 +6,8 @@ require "shippinglogic/fedex/validation"
 module Shippinglogic
   class FedEx
     class Service
-      instance_methods.each { |m| undef_method m unless m =~ /(^__|^nil\?$|^class$|^send$|proxy_|^object_id$)/ }
+      alias_method :real_class, :class
+      instance_methods.each { |m| undef_method m unless m =~ /(^__|^real_class$|^send$|^object_id$)/ }
       
       include Attributes
       include HTTParty
@@ -14,6 +15,65 @@ module Shippinglogic
       include Response
       include Validation
       
+      # These constants aren't referenced or used anywhere in this library, they are purely for reference and as a tool for your to use.
+      # Many of the options that these services accept require a value from one of these arrays. The docs will specify which
+      # constant to use. You also might want to include these in a drop down on your interface.
+      #
+      # Lastly, if you want to make these user friendly use a string inflector (humanize or titlize).
+      
+      # label options
+      LABEL_FORMATS = ["COMMON2D", "ERROR", "LABEL_DATA_ONLY", "MAILROOM", "NO_LABEL"]
+      LABEL_FILE_TYPES = ["DIB", "DPL", "EPL2", "GIF", "PDF", "PNG", "ZPLII"]
+      LABEL_STOCK_TYPES = [
+        "PAPER_4X6", "PAPER_4X8", "PAPER_4X9", "PAPER_7X4.75", "PAPER_8.5X11_BOTTOM_HALF_LABEL", "PAPER_8.5X11_TOP_HALF_LABEL",
+        "PAPER_LETTER", "STOCK_4X6", "STOCK_4X6.75_LEADING_DOC_TAB", "STOCK_4X6.75_TRAILING_DOC_TAB", "STOCK_4X8",
+        "STOCK_4X9_LEADING_DOC_TAB", "STOCK_4X9_TRAILING_DOC_TAB"
+      ]
+      LABEL_MASK_OPTIONS = [
+        "CUSTOMS_VALUE", "DIMENSIONS", "DUTIES_AND_TAXES_PAYOR_ACCOUNT_NUMBER", "FREIGHT_PAYOR_ACCOUNT_NUMBER",
+        "PACKAGE_SEQUENCE_AND_COUNT", "SHIPPER_ACCOUNT_NUMBER", "SUPPLEMENTAL_LABEL_DOC_TAB", "TERMS_AND_CONDITIONS",
+        "TOTAL_WEIGHT", "TRANSPORTATION_CHARGES_PAYOR_ACCOUNT_NUMBER"
+      ]
+      
+      # service options
+      REGULAR_SERVICE_TYPES = [
+        "GROUND_HOME_DELIVERY", "FEDEX_GROUND", "FEDEX_EXPRESS_SAVER", "FEDEX_2_DAY", "STANDARD_OVERNIGHT",
+        "PRIORITY_OVERNIGHT", "FIRST_OVERNIGHT"
+      ]
+      REGULAR_SATURDAY_SERVICE_TYPES = ["FEDEX_2_DAY_SATURDAY_DELIVERY", "PRIORITY_OVERNIGHT_SATURDAY_DELIVERY"]
+      FREIGHT_SERVICE_TYPES = ["FEDEX_3_DAY_FREIGHT", "FEDEX_2_DAY_FREIGHT", "FEDEX_1_DAY_FREIGHT"]
+      FREIGHT_SATURDAY_SERVICE_TYPES = [
+        "FEDEX_3_DAY_FREIGHT_SATURDAY_DELIVERY", "FEDEX_2_DAY_FREIGHT_SATURDAY_DELIVERY",
+        "FEDEX_1_DAY_FREIGHT_SATURDAY_DELIVERY"
+      ]
+      INTERNATIONAL_SERVICE_TYPES = ["INTERNATIONAL_GROUND", "INTERNATIONAL_ECONOMY", "INTERNATIONAL_PRIORITY", "INTERNATIONAL_FIRST"]
+      INTERNATIONAL_SATURDAY_TYPES = ["INTERNATIONAL_PRIORITY_SATURDAY_DELIVERY"]
+      INTERNATIONA_FREIGHT_SERVICE_TYPES = ["INTERNATIONAL_ECONOMY_FREIGHT", "INTERNATIONAL_PRIORITY_FREIGHT"]
+      SERVICE_TYPES = REGULAR_SERVICE_TYPES + REGULAR_SATURDAY_SERVICE_TYPES + FREIGHT_SERVICE_TYPES + FREIGHT_SATURDAY_SERVICE_TYPES +
+        INTERNATIONAL_SERVICE_TYPES + INTERNATIONAL_SATURDAY_TYPES + INTERNATIONA_FREIGHT_SERVICE_TYPES
+      
+      # delivery options
+      SIGNATURE_OPTION_TYPES = ["ADULT", "DIRECT", "INDIRECT", "NO_SIGNATURE_REQUIRED", "SERVICE_DEFAULT"]
+      SIGNATURE_IMAGE_TYPES = ["LETTER", "FAX"]
+      SPECIAL_SERVICES = [
+        "APPOINTMENT_DELIVERY", "DANGEROUS_GOODS", "DRY_ICE", "NON_STANDARD_CONTAINER", "PRIORITY_ALERT", "SIGNATURE_OPTION",
+        "FEDEX_FREIGHT", "FEDEX_NATIONAL_FREIGHT", "INSIDE_PICKUP", "INSIDE_DELIVERY", "EXHIBITION", "EXTREME_LENGTH", "FLATBED_TRAILER",
+        "FREIGHT_GUARANTEE", "LIFTGATE_DELIVERY", "LIFTGATE_PICKUP", "LIMITED_ACCESS_DELIVERY", "LIMITED_ACCESS_PICKUP", "PRE_DELIVERY_NOTIFICATION",
+        "PROTECTION_FROM_FREEZING", "REGIONAL_MALL_DELIVERY", "REGIONAL_MALL_PICKUP"
+      ]
+      
+      # misc options
+      DELETION_CONTROL = ["DELETE_ALL_PACKAGES", "DELETE_ONE_PACKAGE", "LEGACY"]
+      EMAIL_TYPES = ["HTML", "TEXT", "WIRELESS"]
+      PAYMENT_TYPES = ["SENDER", "CASH", "CREDIT_CARD"]
+      REFERENCE_TYPES = [
+        "BILL_OF_LADING", "CUSTOMER_REFERENCE", "DEPARTMENT_NUMBER", "INVOICE_NUMER", "P_O_NUMBER",
+        "SHIPMENT_INTEGRITY", "STORE_NUMBER"
+      ]
+      PACKAGE_TYPES = ["FEDEX_ENVELOPE", "FEDEX_PAK", "FEDEX_BOX", "FEDEX_TUBE", "FEDEX_10KG_BOX", "FEDEX_25KG_BOX", "YOUR_PACKAGING"]
+      DROP_OFF_TYPES = ["REGULAR_PICKUP", "REQUEST_COURIER", "DROP_BOX", "BUSINESS_SERVICE_CENTER", "STATION"]
+      RATE_REQUEST_TYPES = ["ACCOUNT", "LIST", "MULTIWEIGHT"]
+      
       attr_accessor :base
       
       # Accepts the base service object as a single parameter so that we can access
@@ -31,7 +91,8 @@ module Shippinglogic
         end
         
         # For each service you need to overwrite this method. This is where you make the call to fedex
-        # and do your magic.
+        # and do your magic. See the child classes for examples on how to define this method. It is very
+        # important that you cache the result into a variable to avoid uneccessary requests.
         def target
           raise ImplementationError.new("You need to implement a target method that the proxy class can delegate method calls to")
         end

data/lib/shippinglogic/fedex/ship.rb

@@ -0,0 +1,227 @@
+module Shippinglogic
+  class FedEx
+    # An interface to the shipe services provided by FedEx. Allows you to create shipments and get various information on the shipment
+    # created. Such as the tracking number, the label image, barcode image, delivery date, etc.
+    #
+    # == Options
+    # === Shipper options
+    #
+    # * <tt>shipper_streets</tt> - street part of the address, separate multiple streets with a new line, dont include blank lines.
+    # * <tt>shipper_city</tt> - city part of the address.
+    # * <tt>shipper_state_</tt> - state part of the address, use state abreviations.
+    # * <tt>shipper_postal_code</tt> - postal code part of the address. Ex: zip for the US.
+    # * <tt>shipper_country</tt> - country code part of the address, use abbreviations, ex: 'US'
+    # * <tt>shipper_residential</tt> - a boolean value representing if the address is redential or not (default: false)
+    #
+    # === Recipient options
+    #
+    # * <tt>recipient_streets</tt> - street part of the address, separate multiple streets with a new line, dont include blank lines.
+    # * <tt>recipient_city</tt> - city part of the address.
+    # * <tt>recipient_state</tt> - state part of the address, use state abreviations.
+    # * <tt>recipient_postal_code</tt> - postal code part of the address. Ex: zip for the US.
+    # * <tt>recipient_country</tt> - country code part of the address, use abbreviations, ex: 'US'
+    # * <tt>recipient_residential</tt> - a boolean value representing if the address is redential or not (default: false)
+    #
+    # === Label options
+    #
+    # * <tt>label_format</tt> - one of LABEL_FORMATS. (default: COMMON2D)
+    # * <tt>label_file_type</tt> - one of LABEL_FILE_TYPES. (default: PDF)
+    # * <tt>label_stock_type</tt> - one of LABEL_STOCK_TYPES. (default: PAPER_8.5X11_TOP_HALF_LABEL)
+    #
+    # === Packaging options
+    #
+    # One thing to note is that FedEx does support multiple package shipments. The problem is that all of the packages must be identical.
+    # FedEx specifically notes in their documentation that mutiple package specifications are not allowed. So your only option for a
+    # multi package shipment is to increase the package_count option and keep the dimensions and weight the same for all packages. Then again,
+    # the documentation for the FedEx web services is terrible, so I could be wrong. Any tests I tried resulted in an error though.
+    #
+    # * <tt>packaging_type</tt> - one of PACKAGE_TYPES. (default: YOUR_PACKAGING)
+    # * <tt>package_count</tt> - the number of packages in your shipment. (default: 1)
+    # * <tt>package_weight</tt> - a single packages weight.
+    # * <tt>package_weight_units</tt> - either LB or KG. (default: LB)
+    # * <tt>package_length</tt> - a single packages length.
+    # * <tt>package_width</tt> - a single packages width.
+    # * <tt>package_height</tt> - a single packages height.
+    # * <tt>package_dimension_units</tt> - either IN or CM. (default: IN)
+    #
+    # === Monetary options
+    #
+    # * <tt>currency_type</tt> - the type of currency. (default: nil, because FedEx will default to your account preferences)
+    # * <tt>insured_value</tt> - the value you want to insure, if any. (default: nil)
+    # * <tt>payment_type</tt> - one of PAYMENT_TYPES. (default: SENDER)
+    # * <tt>payor_account_number</tt> - if the account paying for this ship is different than the account you specified then
+    #   you can specify that here. (default: your account number)
+    # * <tt>payor_country</tt> - the country code for the account number. (default: US)
+    #
+    # === Delivery options
+    #
+    # * <tt>ship_time</tt> - a Time object representing when you want to ship the package. (default: Time.now)
+    # * <tt>service_type</tt> - one of SERVICE_TYPES, this is optional, leave this blank if you want a list of all
+    #   available services. (default: nil)
+    # * <tt>dropoff_type</tt> - one of DROP_OFF_TYPES. (default: REGULAR_PICKUP)
+    # * <tt>special_services_requested</tt> - any exceptions or special services FedEx needs to be aware of, this should be
+    #   one or more of SPECIAL_SERVICES. (default: nil)
+    # * <tt>signature</tt> - one of SIGNATURE_OPTION_TYPES. (default: nil, which defaults to the service default)
+    #
+    # === Misc options
+    #
+    # * <tt>rate_request_types</tt> - one or more of RATE_REQUEST_TYPES. (default: ACCOUNT)
+    #
+    # == Simple Example
+    #
+    # Here is a very simple example. Mix and match the options above to get more accurate rates:
+    #
+    #   fedex = Shippinglogic::FedEx.new(key, password, account, meter)
+    #   shipment = fedex.ship(
+    #     :shipper_postal_code => "10007",
+    #     :shipper_country => "US",
+    #     :recipient_postal_code => "75201",
+    #     :recipient_country_code => "US",
+    #     :package_weight => 24,
+    #     :package_length => 12,
+    #     :package_width => 12,
+    #     :package_height => 12
+    #   )
+    #
+    #   shipment.inspect
+    #   #<Shippinglogic::FedEx::Ship::Shipment rate:big_decimal, currency:string, delivery_date:date, tracking_number:string,
+    #     label:string(base64 decoded), barcode:string(base64 decoded) >
+    #   
+    #   # to show accessor methods
+    #   shipment.tracking_number
+    #   # => "XXXXXXXXXXXXXX"
+    class Ship < Service
+      # The shipment result is an object of this class
+      class Shipment; attr_accessor :rate, :currency, :delivery_date, :tracking_number, :label, :barcode; end
+      
+      VERSION = {:major => 6, :intermediate => 0, :minor => 0}
+      
+      # shipper options
+      attribute :shipper_name,                :string
+      attribute :shipper_company_name,        :string
+      attribute :shipper_phone_number,        :string
+      attribute :shipper_streets,             :string
+      attribute :shipper_city,                :string
+      attribute :shipper_state,               :string
+      attribute :shipper_postal_code,         :string
+      attribute :shipper_country,             :string
+      attribute :shipper_residential,         :boolean,     :default => false
+      
+      # recipient options
+      attribute :recipient_name,              :string
+      attribute :recipient_company_name,      :string
+      attribute :recipient_phone_number,      :string
+      attribute :recipient_streets,           :string
+      attribute :recipient_city,              :string
+      attribute :recipient_state,             :string
+      attribute :recipient_postal_code,       :string
+      attribute :recipient_country,           :string
+      attribute :recipient_residential,       :boolean,     :default => false
+      
+      # label options
+      attribute :label_format,                :string,      :default => "COMMON2D"
+      attribute :label_file_type,             :string,      :default => "PDF"
+      attribute :label_stock_type,            :string,      :default => "PAPER_8.5X11_TOP_HALF_LABEL"
+      
+      # packaging options
+      attribute :packaging_type,              :string,      :default => "YOUR_PACKAGING"
+      attribute :packaging_type,              :string,      :default => "YOUR_PACKAGING"
+      attribute :package_count,               :integer,     :default => 1
+      attribute :package_weight,              :integer
+      attribute :package_weight_units,        :string,      :default => "LB"
+      attribute :package_length,              :integer
+      attribute :package_width,               :integer
+      attribute :package_height,              :integer
+      attribute :package_dimension_units,     :string,      :default => "IN"
+      
+      # monetary options
+      attribute :currency_type,               :string
+      attribute :insured_value,               :big_decimal
+      attribute :payment_type,                :string,      :default => "SENDER"
+      attribute :payor_account_number,        :string,      :default => lambda { |shipment| shipment.base.account }
+      attribute :payor_country,               :string
+      
+      # delivery options
+      attribute :ship_time,                   :datetime,    :default => lambda { |shipment| Time.now }
+      attribute :service_type,                :string
+      attribute :dropoff_type,                :string,      :default => "REGULAR_PICKUP"
+      attribute :special_services_requested,  :array
+      attribute :signature,                   :string
+      
+      # misc options
+      attribute :rate_request_types,          :array,       :default => ["ACCOUNT"]
+      
+      private
+        def target
+          @target ||= parse_response(request(build_request))
+        end
+        
+        # Just building some XML to send off to FedEx using our various options
+        def build_request
+          b = builder
+          xml = b.ProcessShipmentRequest(:xmlns => "http://fedex.com/ws/ship/v#{VERSION[:major]}") do
+            build_authentication(b)
+            build_version(b, "ship", VERSION[:major], VERSION[:intermediate], VERSION[:minor])
+            b.SpecialServicesRequested special_services_requested.join(",") if special_services_requested.any?
+            
+            b.RequestedShipment do
+              b.ShipTimestamp ship_time.xmlschema if ship_time
+              b.DropoffType dropoff_type if dropoff_type
+              b.ServiceType service_type if service_type
+              b.PackagingType packaging_type if packaging_type
+              b.TotalInsuredValue insured_value if insured_value
+              
+              b.Shipper do
+                build_contact(b, :shipper)
+                build_address(b, :shipper)
+              end
+              
+              b.Recipient do
+                build_contact(b, :recipient)
+                build_address(b, :recipient)
+              end
+              
+              b.ShippingChargesPayment do
+                b.PaymentType payment_type if payment_type
+                b.Payor do
+                  b.AccountNumber payor_account_number if payor_account_number
+                  b.CountryCode payor_country if payor_country
+                end
+              end
+              
+              b.LabelSpecification do
+                b.LabelFormatType label_format if label_format
+                b.ImageType label_file_type if label_file_type
+                b.LabelStockType label_stock_type if label_stock_type
+              end
+              
+              if signature
+                b.SignatureOptionDetail do
+                  b.OptionType signature
+                end
+              end
+              
+              b.RateRequestTypes rate_request_types.join(",")
+              build_package(b)
+            end
+          end
+        end
+        
+        # Making sense of the reponse and grabbing the information we need.
+        def parse_response(response)
+          details = response[:completed_shipment_detail]
+          rate = details[:shipment_rating][:shipment_rate_details].first[:total_net_charge]
+          package_details = details[:completed_package_details]
+          
+          shipment = Shipment.new
+          shipment.rate = BigDecimal.new(rate[:amount])
+          shipment.currency = rate[:currency]
+          shipment.delivery_date = Date.parse(details[:routing_detail][:delivery_date])
+          shipment.tracking_number = package_details[:tracking_id][:tracking_number]
+          shipment.label = Base64.decode64(package_details[:label][:parts][:image])
+          shipment.barcode = Base64.decode64(package_details[:barcodes][:common2_d_barcode])
+          shipment
+        end
+    end
+  end
+end

data/lib/shippinglogic/fedex/signature.rb

@@ -0,0 +1,66 @@
+module Shippinglogic
+  class FedEx
+    # An interface to the signature proof of delivery services provided by FedEx. Allows you to get an image
+    # of the signature, or you can tell fedex to fax it to a fax number.
+    #
+    # == Accessor methods / options
+    #
+    # * <tt>tracking_number</tt> - the tracking number
+    # * <tt>image_type</tt> - one of SIGNATURE_IMAGE_TYPES. (default: LETTER)
+    # * <tt>image_file_type</tt> - one of LABEL_FILE_TYPES. (default: PDF)
+    # * <tt>fax_number</tt> - if image_type is set to FAX you must provide a fax number here. (default: nil)
+    #
+    # === Simple Example
+    #
+    # Here is a very simple example:
+    #
+    #   fedex = Shippinglogic::FedEx.new(key, password, account, meter)
+    #   signature = fedex.signature(:tracking_number => "my number")
+    #
+    #   signature.inspect
+    #   # => #<Shippinglogic::FedEx::Signature::Signature image:string(base64 decoded) >
+    #   
+    #   signature.image
+    #   # => "a bunch of garble (write this to a file and save it)"
+    class Signature < Service
+      # Each tracking result is an object of this class
+      class Signature; attr_accessor :image; end
+      
+      VERSION = {:major => 3, :intermediate => 0, :minor => 0}
+      
+      attribute :image_type,      :string,  :default => "LETTER"
+      attribute :image_file_type, :string,  :default => "PDF"
+      attribute :tracking_number, :string
+      attribute :fax_number,      :string
+      
+      private
+        # The parent class Service requires that we define this method. This is our kicker. This method is only
+        # called when we need to deal with information from FedEx. Notice the caching into the @target variable.
+        def target
+          @target ||= parse_response(request(build_request))
+        end
+        
+        # Just building some XML to send off to FedEx. FedEx require this particualr format.
+        def build_request
+          b = builder
+          xml = b.SignatureProofOfDeliveryRequest(:xmlns => "http://fedex.com/ws/track/v#{VERSION[:major]}") do
+            build_authentication(b)
+            build_version(b, "trck", VERSION[:major], VERSION[:intermediate], VERSION[:minor])
+            
+            b.Type image_type
+            b.TrackingNumber tracking_number
+            b.FaxDetail fax_number if fax_number
+            b.LetterFormat image_file_type
+          end
+        end
+        
+        # Grabbing the response from FedEx and making sense of it. There is a lot of unneeded information
+        # in the response.
+        def parse_response(response)
+          signature = Signature.new
+          signature.image = Base64.decode64(response[:letter])
+          signature
+        end
+    end
+  end
+end

data/lib/shippinglogic/fedex/track.rb

@@ -12,9 +12,16 @@ module Shippinglogic
     # Here is a very simple example:
     #
     #   fedex = Shippinglogic::FedEx.new(key, password, account, meter)
-    #   fedex.track(:tracking_number => "my number")
+    #   tracking = fedex.track(:tracking_number => "my number")
+    #   tracking.first
+    #   # => #<Shippinglogic::FedEx::Track::Event @postal_code="95817", @name="Delivered", @state="CA", @residential=false,
+    #   #     @city="Sacramento", @type="DL", @country="US", @occured_at=Mon Dec 08 10:43:37 -0500 2008>
+    #   
+    #   tracking.first.name
+    #   # => "Delivered"
     #
     # === Note
+    #
     # FedEx does support locating packages through means other than a tracking number.
     # These are not supported and probably won't be until someone needs them. It should
     # be fairly simple to add, but I could not think of a reason why anyone would want to track
@@ -28,11 +35,14 @@ module Shippinglogic
       attribute :tracking_number, :string
       
       private
+        # The parent class Service requires that we define this method. This is our kicker. This method is only
+        # called when we need to deal with information from FedEx. Notice the caching into the @target variable.
         def target
-          @target ||= parse_track_response(request(build_track_request))
+          @target ||= parse_response(request(build_request))
         end
         
-        def build_track_request
+        # Just building some XML to send off to FedEx. FedEx require this particualr format.
+        def build_request
           b = builder
           xml = b.TrackRequest(:xmlns => "http://fedex.com/ws/track/v#{VERSION[:major]}") do
             build_authentication(b)
@@ -47,7 +57,9 @@ module Shippinglogic
           end
         end
         
-        def parse_track_response(response)
+        # Grabbing the response from FedEx and making sense of it. There is a lot of unneeded information
+        # in the response.
+        def parse_response(response)
           response[:track_details][:events].collect do |details|
             event = Event.new
             event.name = details[:event_description]