jss-api 0.5.4

data/lib/jss-api/api_object/site.rb

@@ -0,0 +1,93 @@
+### Copyright 2014 Pixar
+###  
+###    Licensed under the Apache License, Version 2.0 (the "Apache License")
+###    with the following modification; you may not use this file except in
+###    compliance with the Apache License and the following modification to it:
+###    Section 6. Trademarks. is deleted and replaced with:
+###  
+###    6. Trademarks. This License does not grant permission to use the trade
+###       names, trademarks, service marks, or product names of the Licensor
+###       and its affiliates, except as required to comply with Section 4(c) of
+###       the License and to reproduce the content of the NOTICE file.
+###  
+###    You may obtain a copy of the Apache License at
+###  
+###        http://www.apache.org/licenses/LICENSE-2.0
+###  
+###    Unless required by applicable law or agreed to in writing, software
+###    distributed under the Apache License with the above modification is
+###    distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+###    KIND, either express or implied. See the Apache License for the specific
+###    language governing permissions and limitations under the Apache License.
+### 
+###
+
+###
+module JSS
+  
+  #####################################
+  ### Module Variables
+  #####################################
+
+  #####################################
+  ### Module Methods
+  #####################################
+
+  
+  #####################################
+  ### Classes
+  #####################################
+
+  ### 
+  ### A Site in the JSS.
+  ###
+  ### These are simple, in that they only have an ID and a name.
+  ###
+  ### @see JSS::APIObject
+  ### 
+  class Site < JSS::APIObject
+    
+    #####################################
+    ### Mix-Ins
+    #####################################
+    include JSS::Creatable
+    include JSS::Updatable
+    
+    #####################################
+    ### Class Methods
+    #####################################
+         
+    #####################################
+    ### Class Constants
+    #####################################
+    
+    ### The base for REST resources of this class
+    RSRC_BASE = "sites"
+    
+    ### the hash key used for the JSON list output of all objects in the JSS
+    RSRC_LIST_KEY = :sites
+    
+    ### The hash key used for the JSON object output.
+    ### It's also used in various error messages
+    RSRC_OBJECT_KEY = :site
+    
+    ### these keys, as well as :id and :name,  are present in valid API JSON data for this class
+    VALID_DATA_KEYS = []
+    
+    #####################################
+    ### Attributes
+    #####################################
+    
+    #####################################
+    ### Constructor 
+    #####################################
+    
+
+    #####################################
+    ### Public Instance Methods
+    #####################################
+    
+    
+  end # class site
+  
+end # module

data/lib/jss-api/api_object/software_update_server.rb

@@ -0,0 +1,109 @@
+### Copyright 2014 Pixar
+###  
+###    Licensed under the Apache License, Version 2.0 (the "Apache License")
+###    with the following modification; you may not use this file except in
+###    compliance with the Apache License and the following modification to it:
+###    Section 6. Trademarks. is deleted and replaced with:
+###  
+###    6. Trademarks. This License does not grant permission to use the trade
+###       names, trademarks, service marks, or product names of the Licensor
+###       and its affiliates, except as required to comply with Section 4(c) of
+###       the License and to reproduce the content of the NOTICE file.
+###  
+###    You may obtain a copy of the Apache License at
+###  
+###        http://www.apache.org/licenses/LICENSE-2.0
+###  
+###    Unless required by applicable law or agreed to in writing, software
+###    distributed under the Apache License with the above modification is
+###    distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+###    KIND, either express or implied. See the Apache License for the specific
+###    language governing permissions and limitations under the Apache License.
+### 
+###
+
+###
+module JSS
+
+  #####################################
+  ### Module Variables
+  #####################################
+
+  #####################################
+  ### Module Methods
+  #####################################
+
+  #####################################
+  ### Classes
+  #####################################
+
+  ###
+  ### A Software Update Server in the JSS
+  ###
+  ### Only minimally implemented, for access to the APIObject list methods
+  ###
+  ### @see JSS::APIObject
+  ###
+  class SoftwareUpdateServer < JSS::APIObject
+
+    #####################################
+    ### Mix-Ins
+    #####################################
+
+    #####################################
+    ### Class Methods
+    #####################################
+
+    #####################################
+    ### Class Constants
+    #####################################
+
+    ### The base for REST resources of this class
+    RSRC_BASE = "softwareupdateservers"
+
+    ### the hash key used for the JSON list output of all objects in the JSS
+    RSRC_LIST_KEY = :software_update_servers
+
+    ### The hash key used for the JSON object output.
+    ### It's also used in various error messages
+    RSRC_OBJECT_KEY = :software_update_server
+
+    ### these keys, as well as :id and :name,  are present in valid API JSON data for this class
+    VALID_DATA_KEYS = [:set_system_wide, :port]
+
+    #####################################
+    ### Attributes
+    #####################################
+
+    ### @return [String]
+    attr_reader :ip_address
+
+    ### @return [Integer]
+    attr_reader :port
+
+    ### @return [Boolean]
+    attr_reader :set_system_wide
+
+
+    #####################################
+    ### Constructor
+    #####################################
+
+    ###
+    ### @see SS::APIObject#initialize
+    ###
+    def initialize (args = {})
+      super
+      @ip_address = @init_data[:ip_address]
+      @port = @init_data[:port]
+      @set_system_wide = @init_data[:set_system_wide]
+    end
+
+    #####################################
+    ### Public Instance Methods
+    #####################################
+
+
+  end # class NetbootServer
+
+end # module

data/lib/jss-api/api_object/updatable.rb

@@ -0,0 +1,117 @@
+### Copyright 2014 Pixar
+###  
+###    Licensed under the Apache License, Version 2.0 (the "Apache License")
+###    with the following modification; you may not use this file except in
+###    compliance with the Apache License and the following modification to it:
+###    Section 6. Trademarks. is deleted and replaced with:
+###  
+###    6. Trademarks. This License does not grant permission to use the trade
+###       names, trademarks, service marks, or product names of the Licensor
+###       and its affiliates, except as required to comply with Section 4(c) of
+###       the License and to reproduce the content of the NOTICE file.
+###  
+###    You may obtain a copy of the Apache License at
+###  
+###        http://www.apache.org/licenses/LICENSE-2.0
+###  
+###    Unless required by applicable law or agreed to in writing, software
+###    distributed under the Apache License with the above modification is
+###    distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+###    KIND, either express or implied. See the Apache License for the specific
+###    language governing permissions and limitations under the Apache License.
+### 
+###
+
+###
+module JSS
+
+### A mix-in module providing object-updating via the JSS API.
+###
+
+
+
+  #####################################
+  ### Module Variables
+  #####################################
+
+  #####################################
+  ### Module Methods
+  #####################################
+
+  #####################################
+  ### Sub-Modules
+  #####################################
+
+  ###
+  ### A mix-in module that allows objects to be updated in the JSS via the API.
+  ###
+  ### When a JSS::APIObject subclass includes this module, instances of that
+  ### subclass can be modified in the JSS using the {#update} or {APIObject#save} methods.
+  ###
+  ### Such classes should define setter methods for any values that they wish to
+  ### modify, such as the {#name=} method defined here. Those setter methods must:
+  ### - ensure the correctness of the data they accept.
+  ### - set @need_to_update to true, indicating that the local object no longer
+  ###   matches the JSS, and the changes should be pushed to the server with {#update}
+  ###
+  ### Classes mixing this module *must* provide a #rest_xml instance method that returns the XML
+  ### String to be submitted to the API for object updating.
+  ###
+  ### @see APIObject#save
+  ###
+  module Updatable
+
+    #####################################
+    ###  Constants
+    #####################################
+
+    UPDATABLE = true
+
+    #####################################
+    ###  Attributes
+    #####################################
+
+
+    ### @return [Boolean] do we have unsaved changes?
+    attr_reader :need_to_update
+
+
+    #####################################
+    ###  Mixed-in Instance Methods
+    #####################################
+
+    ###
+    ### Change the name of this item
+    ### Remember to #update to push changes to the server.
+    ###
+    ### @param newname[String] the new name
+    ###
+    ### @return [void]
+    ###
+    def name= (newname)
+      raise JSS::UnsupportedError, "Editing #{self.class::RSRC_LIST_KEY} isn't yet supported. Please use other Casper workflows." unless UPDATABLE
+      return nil if @name == newname
+      raise JSS::InvalidDataError, "Names can't be empty!" if newname.to_s.empty?
+      raise JSS::AlreadyExistsError, "A #{self.class::RSRC_OBJECT_KEY} named '#{newname}' already exsists in the JSS" if self.class.all_names(:refresh).include? newname
+      @name = newname
+      @rest_rsrc = "#{self.class::RSRC_BASE}/name/#{URI.escape @name}" if @rest_rsrc.include? '/name/'
+      @need_to_update = true
+    end #  name=(newname)
+
+    ###
+    ### Save changes to the JSS
+    ###
+    ### @return [Boolean] success
+    ###
+    def update
+      raise JSS::UnsupportedError, "Editing #{self.class::RSRC_LIST_KEY} isn't yet supported. Please use other Casper workflows." unless UPDATABLE
+      return nil unless @need_to_update
+      raise JSS::NoSuchItemError, "Not In JSS! Use #create to create this #{self.class::RSRC_OBJECT_KEY} in the JSS before updating it." unless @in_jss
+      JSS::API.put_rsrc  @rest_rsrc, rest_xml
+      @need_to_update = false
+      @id
+    end # update
+
+  end # module Creatable
+
+end # module

data/lib/jss-api/api_object/uploadable.rb

@@ -0,0 +1,138 @@
+### Copyright 2014 Pixar
+###  
+###    Licensed under the Apache License, Version 2.0 (the "Apache License")
+###    with the following modification; you may not use this file except in
+###    compliance with the Apache License and the following modification to it:
+###    Section 6. Trademarks. is deleted and replaced with:
+###  
+###    6. Trademarks. This License does not grant permission to use the trade
+###       names, trademarks, service marks, or product names of the Licensor
+###       and its affiliates, except as required to comply with Section 4(c) of
+###       the License and to reproduce the content of the NOTICE file.
+###  
+###    You may obtain a copy of the Apache License at
+###  
+###        http://www.apache.org/licenses/LICENSE-2.0
+###  
+###    Unless required by applicable law or agreed to in writing, software
+###    distributed under the Apache License with the above modification is
+###    distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+###    KIND, either express or implied. See the Apache License for the specific
+###    language governing permissions and limitations under the Apache License.
+### 
+###
+
+###
+module JSS
+
+  #####################################
+  ### Module Variables
+  #####################################
+
+
+  #####################################
+  ### Module Methods
+  #####################################
+
+  #####################################
+  ### Sub-Modules
+  #####################################
+
+  ###
+  ### A mixin module providing file-upload capabilities to JSSAPIObject subclasses.
+  ###
+  ### Classes mixing in this module are required to define a constant UPLOAD_TYPES
+  ### which is a Hash of :type => :resource pairs, like this:
+  ###
+  ###  UPLOAD_TYPES = {
+  ###     :icon => :mobiledeviceapplicationsicon
+  ###     :app => mobiledeviceapplicationsipa
+  ###     :attachment => mobiledeviceapplications
+  ###   }
+  ###
+  ### with one pair for each type of upload that the class can handle.
+  ### (most of them only handle one, usually :attachment)
+  ###
+  ### When the #upload method is called, one of the keys from that Hash must be specified
+  ###
+  ### Classes with only one upload type may want to redefine #upload to always call super with
+  ### that one type.
+  ###
+  ### ----
+  ###
+  ### Implementation Notes from
+  ### https://casperserver:8443/api/index.htm#!/fileuploads/uploadFiles_post
+  ###
+  ###   POST ...JSSResource/fileuploads/<resource>/<idType>/<id>
+  ###
+  ### You can POST different types of files by entering parameters for <resource>, <idType>, and <id>.
+  ### For example /JSSResource/fileuploads/computers/id/2.
+  ###
+  ### Attachments can be uploaded by specifying computers, mobiledevices, enrollmentprofiles, or
+  ### peripherals as the resource.
+  ###
+  ### Icons can be uploaded by specifying policies, ebooks, or mobiledeviceapplicationsicon as the resource.
+  ###
+  ### A mobile device application can be uploaded by using mobiledeviceapplicationsipa as the resource.
+  ###
+  ### A disk encryption can be uploaded by specifying diskencryptionconfigurations as the resource.
+  ###
+  ### idTypes supported are "id" and "name", although peripheral names are not supported.
+  ###
+  ### A sample command is:
+  ###   curl -k -u user:password https://my.jss:8443/JSSResource/fileuploads/computers/id/2 -F name=@/Users/admin/Documents/Sample.doc -X POST
+  ###
+  ###
+  ###
+  ###
+  module Uploadable
+
+    #####################################
+    ###  Constants
+    #####################################
+
+    UPLOAD_RSRC_PREFIX = "fileuploads"
+
+    #####################################
+    ###  Variables
+    #####################################
+
+
+    #####################################
+    ###  Methods
+    #####################################
+
+    ###
+    ### Upload a file to the JSS via the REST Resource of the
+    ### object to which this module is mixed in.
+    ###
+    ### @param type[Symbol] the type of upload happening.
+    ###   Must be one of the keys defined in the class's UPLOAD_TYPES Hash.
+    ###
+    ### @param local_file[String, Pathname] String or Pathname pointing to the
+    ###   locally-readable file to be uploaded.
+    ###
+    ### @return [String] The xml response from the server.
+    ###
+    def upload(type, local_file)
+
+      ### the thing's gotta be in the JSS, and have an @id
+      raise JSS::NoSuchItemError, 'Create this #{self.class::RSRC_OBJECT_KEY} in the JSS before uploading files to it.' unless @id and @in_jss
+
+      ### the type has to be defined in the class of self.
+      raise JSS::InvalidDataError, "#{self.class::RSRC_LIST_KEY} only take uploads of type: :#{self.class::UPLOAD_TYPES.keys.join(', :')}." unless self.class::UPLOAD_TYPES.keys.include? type
+
+      ### figure out the resource after the UPLOAD_RSRC_PREFIX
+      upload_rsrc = "#{UPLOAD_RSRC_PREFIX}/#{self.class::UPLOAD_TYPES[type]}/id/#{@id}"
+
+      ### make a File object to hand to REST.
+      file = File.new local_file.to_s, 'rb'
+
+      ### upload it!
+      JSS::API.cnx[upload_rsrc].post :name => file
+
+    end # def upload file
+
+  end # module FileUpload
+
+end # module JSS