electron/atom/common/api/lib/deprecate.coffee

### Deprecate a method. ###
deprecate = (oldName, newName, fn) ->
  warned = false
  ->
    unless warned or process.noDeprecation
      warned = true
      deprecate.warn oldName, newName
    fn.apply this, arguments

### The method is renamed. ###
deprecate.rename = (object, oldName, newName) ->
  warned = false
  newMethod = ->
    unless warned or process.noDeprecation
      warned = true
      deprecate.warn oldName, newName
    this[newName].apply this, arguments
  if typeof object is 'function'
    object.prototype[oldName] = newMethod
  else
    object[oldName] = newMethod

### Forward the method to member. ###
deprecate.member = (object, method, member) ->
  warned = false
  object.prototype[method] = ->
    unless warned or process.noDeprecation
      warned = true
      deprecate.warn method, "#{member}.#{method}"
    this[member][method].apply this[member], arguments

### Deprecate a property. ###
deprecate.property = (object, property, method) ->
  Object.defineProperty object, property,
    get: ->
      warned = false
      unless warned or process.noDeprecation
        warned = true
        deprecate.warn "#{property} property", "#{method} method"
      this[method]()

### Deprecate an event. ###
deprecate.event = (emitter, oldName, newName, fn) ->
  warned = false
  emitter.on newName, (args...) ->
    ### there is listeners for old API. ###
    if @listenerCount(oldName) > 0
      unless warned or process.noDeprecation
        warned = true
        deprecate.warn "'#{oldName}' event", "'#{newName}' event"
      if fn?
        fn.apply this, arguments
      else
        @emit oldName, args...

### Print deprecation warning. ###
deprecate.warn = (oldName, newName) ->
  deprecate.log "#{oldName} is deprecated. Use #{newName} instead."

### Print deprecation message. ###
deprecate.log = (message) ->
  if process.throwDeprecation
    throw new Error(message)
  else if process.traceDeprecation
    console.trace message
  else
    console.warn "(electron) #{message}"

module.exports = deprecate