Class: Runcible::Extensions::Unit

Inherits:
Resources::Unit show all
Defined in:
lib/runcible/extensions/unit.rb

Class Method Summary collapse

Methods inherited from Resources::Unit

path, search

Methods inherited from Base

add_http_auth_header, add_oauth_header, call, combine_get_params, config, config=, generate_log_message, generate_payload, get_response, log_debug, log_exception, process_response, required_params

Class Method Details

.all ⇒ RestClient::Response

Retrieves all content of a certain @@type

Returns:

  • (RestClient::Response) —

    list of all content for the given type



37
38
39
 
# File 'lib/runcible/extensions/unit.rb', line 37

def self.all
  self.search(content_type, {})
end

.content_type ⇒ Object

The content type (e.g. rpm, errata)



30
31
32
 
# File 'lib/runcible/extensions/unit.rb', line 30

def self.content_type
  ''
end

.copy(source_repo_id, destination_repo_id, optional = {}) ⇒ RestClient::Response

copy contents from source repo to the destination repo

Parameters:

  • source_repo_id (String) —

    the source repository ID

  • destination_repo_id (String) —

    the destination repository ID

  • optional (Hash) (defaults to: {}) —

    container for all optional parameters

Returns:

  • (RestClient::Response) —

    a task representing the unit copy operation



121
122
123
124
125
126
127
128
129
130
 
# File 'lib/runcible/extensions/unit.rb', line 121

def self.copy(source_repo_id, destination_repo_id, optional={})
  criteria = {:type_ids => [content_type], :filters => {}}
  criteria[:filters]['association'] = {'unit_id' => {'$in' => optional[:ids]}} if optional[:ids]
  criteria[:fields] = {:unit => optional[:fields]} if optional[:fields]

  payload = {:criteria => criteria}
  payload[:override_config] = {:copy_children => optional[:copy_children]} if optional.has_key?(:copy_children)

  Runcible::Extensions::Repository.unit_copy(destination_repo_id, source_repo_id, payload)
end

.find(id, optional = {}) ⇒ RestClient::Response

Retrieves a single content by it’s content ID

Parameters:

  • id (Array) —

    the content ID of the content to retrieve

Returns:

  • (RestClient::Response) —

    the requested content



45
46
47
48
 
# File 'lib/runcible/extensions/unit.rb', line 45

def self.find(id, optional={})
  optional[:include_repos] ||= true
  find_all([id], optional).first
end

.find_all(ids, optional = {}) ⇒ RestClient::Response

Retrieves a set of content by the contents IDs

Parameters:

  • ids (Array) —

    list of content IDs to retrieve

Returns:

  • (RestClient::Response) —

    list of content



54
55
56
57
 
# File 'lib/runcible/extensions/unit.rb', line 54

def self.find_all(ids, optional={})
  optional[:include_repos] ||= true
  self.search(content_type, { :filters => {'id'=> {'$in'=> ids}} }, optional)
end

.find_all_by_unit_ids(ids, fields = [], optional = {}) ⇒ RestClient::Response

Retrieves a set of content by the Pulp unit IDs

Parameters:

  • ids (Array) —

    list of content unit IDs to retrieve

  • fields (Array) (defaults to: []) —

    optional list of to retrieve

Returns:

  • (RestClient::Response) —

    list of content



73
74
75
76
77
78
 
# File 'lib/runcible/extensions/unit.rb', line 73

def self.find_all_by_unit_ids(ids, fields=[], optional={})
  optional[:include_repos] ||= true
  criteria = { :filters => { :_id => { '$in'=> ids } } }
  criteria[:fields] = fields unless fields.empty?
  self.search(content_type, criteria, optional)
end

.find_by_unit_id(id, optional = {}) ⇒ RestClient::Response

Retrieves a single content by it’s unit ID

Parameters:

  • id (Array) —

    the unit ID of the content to retrieve

Returns:

  • (RestClient::Response) —

    the requested content



63
64
65
66
 
# File 'lib/runcible/extensions/unit.rb', line 63

def self.find_by_unit_id(id, optional={})
  optional[:include_repos] ||= true
  find_all_by_unit_ids([id], [], optional).first
end

.unassociate_from_repo(repo_id, filters) ⇒ RestClient::Response

unassociates content units from a repository

Parameters:

  • repo_id (String) —

    the repository ID to remove units from

  • filters (Hash) —

    the filters to find the units this content type to remove

Returns:

  • (RestClient::Response) —

    a task representing the unit unassociate operation



85
86
87
88
89
 
# File 'lib/runcible/extensions/unit.rb', line 85

def self.unassociate_from_repo(repo_id, filters)
  criteria = {:type_ids => [content_type]}
  criteria[:filters] = filters
  Runcible::Extensions::Repository.unassociate_units(repo_id, criteria)
end

.unassociate_ids_from_repo(repo_id, ids) ⇒ RestClient::Response

unassociates content units from a repository

Parameters:

  • repo_id (String) —

    the repository ID to remove units from

  • ids (Array) —

    list of content unit ids of this content type, aka metadata id or content id

    ex: "RHEA-2010:0001" for errata..,
Note rpms do not have ids, so cant use this.

Returns:

  • (RestClient::Response) —

    a task representing the unit unassociate operation



99
100
101
 
# File 'lib/runcible/extensions/unit.rb', line 99

def self.unassociate_ids_from_repo(repo_id, ids)
  unassociate_from_repo(repo_id, :unit => {'id' => {'$in' => ids}})
end

.unassociate_unit_ids_from_repo(repo_id, ids) ⇒ RestClient::Response

unassociates content units from a repository

Parameters:

  • repo_id (String) —

    the repository ID to remove units from

  • ids (Array) —

    list of the unique hash ids of the content unit with respect to this repo. unit_id, _id are other names for this. for example: “efdd2d63-b275-4728-a298-f68cf4c174e7”

Returns:

  • (RestClient::Response) —

    a task representing the unit unassociate operation



111
112
113
 
# File 'lib/runcible/extensions/unit.rb', line 111

def self.unassociate_unit_ids_from_repo(repo_id, ids)
  unassociate_from_repo(repo_id, :association => {'unit_id' => {'$in' => ids}})
end