pysusestudio::pysusestudio::pySuseStudio Class Reference

List of all members.

Public Member Functions

def __init__
def buildApiURL
def getAccount
def getApiKey
def getTemplateSets
def getAppliances
def setAppliances
def delAppliances
def getRepositories
def putRepositories
def setRepositories
def delRepositories
def addRepositoryUser
def getSoftware
def putSoftware
def getSoftwareInstalled
def addSoftwarePackage
def delSoftwarePackage
def addSoftwarePattern
def delSoftwarePattern
def banSoftwarePackage
def unbanSoftwarePackage
def searchSoftware
def getImageFiles
def getGPGKeys
def getGPGKey
def setGPGKey
def delGPGKey
def getOverlayFiles
def addOverlayFiles
def getOverlayFile
def getOverlayFileMeta
def putOverlayFile
def putOverlayFileMeta
def delOverlayFile
def getRunningBuilds
def getRunningBuild
def addBuild
def delRunningBuild
def getCompletedBuilds
def getCompletedBuild
def delCompletedBuild
def getRPMs
def getRPMInfo
def getRPM
def addRPM
def putRPM
def delRPM
def getRepositories
def getRepository
def addRepository
def version

Public Attributes

 authenticated
 username
 password

Static Public Attributes

tuple auth_addr = urlparse(self.address)

Member Function Documentation

def pysusestudio::pysusestudio::pySuseStudio::__init__ (   self,
  username = None,
  password = None,
  headers = None,
  host = 'http://susestudio.com' 
) 
pySuseStudio( username = None, password = None, headers = None)

        Instantiates an instance of pySuseStudio. Takes optional parameters for authentication and such (see below).

        Parameters:
username - Your Suse Studio username, if you want Basic (HTTP) Authentication.
password - Your Suse Studio secret key, if you want Basic (HTTP) Authentication.
headers - User agent header.
def pysusestudio::pysusestudio::pySuseStudio::addBuild (   self,
  id,
  force = None,
  version = None,
  image_type = None 
) 
addBuild(id, force=None, version=None, image_type=None)

            Start a new build for the given id appliance. 
            If there already is a build with the same appliance settings (build type and version) 
            an error is returned. In this case a build can be enforced by setting the optional 
            force parameter to true.
            Optionally the appliance version and build type can be set with the version and image_type parameters. 
            
            Parameters:
id - Id of the appliance
force (optional) - Force a build even if it overwrites an already existing build. 
version (optional) - The version of the appliance. 
image_type (optional) -  The format of the build. Supported are 'xen','oem','vmx' and 'iso'.
def pysusestudio::pysusestudio::pySuseStudio::addOverlayFiles (   self,
  id,
  body,
  filename = None,
  path = None,
  owner = None,
  group = None,
  permissions = None,
  enabled = None 
) 
addOverlayFiles(id, body, filename=None, path=None, owner=None, group=None, permissions=None, enabled=None)

            Adds a file to the given id appliance. 
            Optionally, one or more metadata settings can be specified. If those are left out, they 
            can also be change later. 
            
            Parameters:
id - Id of the appliance
body - the entity body to be sent with the request.
filename (optional) - The name of the file in the filesystem. 
path (optional) - The path where the file will be stored. 
owner (optional) - The owner of the file. 
group (optional) - The group of the file. 
permissions (optional) - The permissions of the file. 
enabled (optional) - Used to enable/disable this file for the builds.
def pysusestudio::pysusestudio::pySuseStudio::addRepository (   self,
  repo_url,
  name 
) 
addRepository(repo_url, name)

            Imports a new repository into Studio. Returns the metadata for the created repository
            
            Parameters:
repo_url - Base url of the repository. 
name - Name for the repository.
def pysusestudio::pysusestudio::pySuseStudio::addRepositoryUser (   self,
  id 
) 
addRepositoryUser(id)

            Adds the according user repository (the one containing the uploaded RPMs) to the appliance
            
            Parameters:
id - Id of the appliance
def pysusestudio::pysusestudio::pySuseStudio::addRPM (   self,
  base 
) 
addBuild(base)

            Adds an RPM or archive to the user repository for appliances base 
            
            Parameters:
base - Base system of the RPM or archive, e.g. 11.1 or SLED11.
def pysusestudio::pysusestudio::pySuseStudio::addSoftwarePackage (   self,
  id,
  name,
  version = None,
  repository_id = None 
) 
addSoftwarePackage(id, name, version=None, repository_id=None)

            Add specified package to the given appliance
            
            Parameters:
id - Id of the appliance
name - Name of the package
version (optional) - Version of the package
repository_id (optional) - Repository to pick the package from
def pysusestudio::pysusestudio::pySuseStudio::addSoftwarePattern (   self,
  id,
  name,
  version = None,
  repository_id = None 
) 
addSoftwarePattern(id, name, version=None, repository_id=None)

            Add specified pattern to the given appliance
            
            Parameters:
id - Id of the appliance
name - Name of the pattern
version (optional) - Version of the pattern
repository_id (optional) - Repository to pick the pattern from
def pysusestudio::pysusestudio::pySuseStudio::banSoftwarePackage (   self,
  id,
  name 
) 
banSoftwarePackage(id, name)

            Ban specified package from the given appliance
            
            Parameters:
id - Id of the appliance
name - Name of the package
def pysusestudio::pysusestudio::pySuseStudio::buildApiURL (   self,
  base_url,
  params 
)
def pysusestudio::pysusestudio::pySuseStudio::delAppliances (   self,
  id 
) 
delAppliances(self, id)

        Delete appliance with given id. 
            
            Parameters:
id - Id of the appliance
def pysusestudio::pysusestudio::pySuseStudio::delCompletedBuild (   self,
  id 
) 
delCompletedBuild(id)

            Delete specified completed build
            
            Parameters:
id - Id of the running build
def pysusestudio::pysusestudio::pySuseStudio::delGPGKey (   self,
  id,
  key_id 
) 
delGPGKey(self, id, key_id)

        Deletes the GPG key with the id key_id from the appliance. 
            
            Parameters:
id - Id of the appliance
key_id - Id of the GPG key
def pysusestudio::pysusestudio::pySuseStudio::delOverlayFile (   self,
  id 
) 
delOverlayFile(id)

            Delete specified overlay file
            
            Parameters:
id - Id of the file
def pysusestudio::pysusestudio::pySuseStudio::delRepositories (   self,
  id,
  repo_id 
) 
delRepositories(id, repo_id)

            Remove the specified repository to the given id appliance
            
            Parameters:
id - Id of the appliance
repo_id - Id of the repository
def pysusestudio::pysusestudio::pySuseStudio::delRPM (   self,
  id 
) 
delRPM(id)

            Deletes the RPM or archive with the given id from the user repository
            
            Parameters:
id - id of the uploaded RPM.
def pysusestudio::pysusestudio::pySuseStudio::delRunningBuild (   self,
  id 
) 
delRunningBuild(id)

            Delete specified running build
            
            Parameters:
id - Id of the running build
def pysusestudio::pysusestudio::pySuseStudio::delSoftwarePackage (   self,
  id,
  name 
) 
delSoftwarePackage(id, name)

            Delete specified package from the given appliance
            
            Parameters:
id - Id of the appliance
name - Name of the package
def pysusestudio::pysusestudio::pySuseStudio::delSoftwarePattern (   self,
  id,
  name 
) 
delSoftwarePattern(id, name)

            Delete specified pattern from the given appliance
            
            Parameters:
id - Id of the appliance
name - Name of the pattern
def pysusestudio::pysusestudio::pySuseStudio::getAccount (   self  )  
getAccount()

        Returns information about the account, such as username, email address and disk quota.
def pysusestudio::pysusestudio::pySuseStudio::getApiKey (   self  )  
getApiKey()

        Returns an HTML page which contains the API key flagged as:

        <span class="studio:api_key">ksdjfu93r</span>.
def pysusestudio::pysusestudio::pySuseStudio::getAppliances (   self,
  id = None,
  status = False 
) 
getAppliances(id = None, status = False)

        List all appliances of the current user.  
            
            Parameters:
id - Optional. Id of the appliance
status - Optional. If true get status of given Id appliance
def pysusestudio::pysusestudio::pySuseStudio::getCompletedBuild (   self,
  id 
) 
getCompletedBuild(id)

       Show build info of the build with the given id .
        
            Parameters:
id - Id of the build
def pysusestudio::pysusestudio::pySuseStudio::getCompletedBuilds (   self,
  id 
) 
getCompletedBuilds(id)

        List all completed builds for the appliance with the given id .
        
            Parameters:
id - Id of the appliance
def pysusestudio::pysusestudio::pySuseStudio::getGPGKey (   self,
  id,
  key_id 
) 
getGPGKey(id, key_id)

        Shows information on the GPG key with the id key_id.  
            
            Parameters:
id - Id of the appliance
key_id - Id of the GPG key
def pysusestudio::pysusestudio::pySuseStudio::getGPGKeys (   self,
  id 
) 
getGPGKeys(id)

        List all the GPG keys for the given id appliance.  
            
            Parameters:
id - Id of the appliance
def pysusestudio::pysusestudio::pySuseStudio::getImageFiles (   self,
  id,
  build_id,
  path 
) 
getImageFiles(id, build_id, path)

        Returns the file with the given path from an image.   
            
            Parameters:
id - Id of the appliance
build_id - Id of the build.
path - Path to the file in the built appliance
def pysusestudio::pysusestudio::pySuseStudio::getOverlayFile (   self,
  id 
) 
getOverlayFile(id)

        Return overlay file with the given id .
        
            Parameters:
id - Id of the file
def pysusestudio::pysusestudio::pySuseStudio::getOverlayFileMeta (   self,
  id 
) 
getOverlayFileMeta(id)

        Return overlay file meta data with the given id .
        
            Parameters:
id - Id of the file
def pysusestudio::pysusestudio::pySuseStudio::getOverlayFiles (   self,
  id 
) 
getOverlayFiles(id)

        List all overlay files of the given id appliance.
        
            Parameters:
id - Id of the appliance
def pysusestudio::pysusestudio::pySuseStudio::getRepositories (   self,
  base = None,
  filter = None 
) 
getRepositories(base=None, filter=None)

        Returns a list of repositories. If neither base system nor filter are specified all available repositories 
        are returned. 
        When filtering the results with the filter parameter, the repository name, repository url and repository 
        packages are searched.
        
            Parameters:
base (optional) - Limit the results to repositories with this base system. 
filter (optional) - Only show repositories matching this search string.
def pysusestudio::pysusestudio::pySuseStudio::getRepositories (   self,
  id 
) 
getRepositories(id)

        List all repositories for the given id appliance.  
            
            Parameters:
id - Id of the appliance
def pysusestudio::pysusestudio::pySuseStudio::getRepository (   self,
  id 
) 
getCompletedBuild(id)

       Show information on the repository with the given id .
        
            Parameters:
id - Id of the repository.
def pysusestudio::pysusestudio::pySuseStudio::getRPM (   self,
  id 
) 
getRPM(id)

       Returns the RPM with the given id .
        
            Parameters:
id - Id of the uploaded RPM
def pysusestudio::pysusestudio::pySuseStudio::getRPMInfo (   self,
  id 
) 
getRPMInfo(id)

       Show information on the uploaded RPM with the given id .
        
            Parameters:
id - Id of the uploaded RPM
def pysusestudio::pysusestudio::pySuseStudio::getRPMs (   self,
  base 
) 
getRPMs(base)

        List all uploaded RPMs for the the given base system.
        
            Parameters:
base - Base system of the RPM or archive, e.g. 11.1 or SLED11.
def pysusestudio::pysusestudio::pySuseStudio::getRunningBuild (   self,
  id 
) 
getRunningBuild(id)

       Show status of the build with the given id .
        
            Parameters:
id - Id of the build
def pysusestudio::pysusestudio::pySuseStudio::getRunningBuilds (   self,
  id 
) 
getRunningBuilds(id)

        List all running builds for the appliance with the given id .
        
            Parameters:
id - Id of the appliance
def pysusestudio::pysusestudio::pySuseStudio::getSoftware (   self,
  id 
) 
getSoftware(id)

        List all the software for the given id appliance.  
            
            Parameters:
id - Id of the appliance
def pysusestudio::pysusestudio::pySuseStudio::getSoftwareInstalled (   self,
  id,
  build_id = None 
) 
getSoftwareInstalled(id, build_id)

        List all packages and patterns that are installed. You can either specify the 
        appliance with the id parameter, which will list the software 
        that will installed with the next build or via an build id. That makes it possible 
        to retrieve the installed software for older builds.   
            
            Parameters:
id - Id of the appliance
build_id (optional) - Id of the build.
def pysusestudio::pysusestudio::pySuseStudio::getTemplateSets (   self,
  name = None 
) 
getTemplateSets(name = None)

        List all template sets.
        Template sets are used to group available templates by topic. The 'default'
        template set contains all vanilla SUSE templates, 'mono' contains those that
        are optimized to be used for mono applications, for example. 
            
        Parameters:
            name - Optional. Name of template
def pysusestudio::pysusestudio::pySuseStudio::putOverlayFile (   self,
  id,
  body 
) 
putSoftware(id, body)

        Writes the content of the file with given id.  
            
            Parameters:
id - Id of the file
body - the entity body to be sent with the request
def pysusestudio::pysusestudio::pySuseStudio::putOverlayFileMeta (   self,
  id,
  body 
) 
putSoftware(id, body)

        Writes the content of the file metadata with given id.  
            
            Parameters:
id - Id of the file
body - the entity body to be sent with the request
def pysusestudio::pysusestudio::pySuseStudio::putRepositories (   self,
  id 
) 
putRepositories(id)

        Update the list of repositories of the given id appliance.  
            
            Parameters:
id - Id of the appliance
def pysusestudio::pysusestudio::pySuseStudio::putRPM (   self,
  id,
  body 
) 
putSoftware(id, body)

        Update the content of the RPM or archive with the given id.  
            
            Parameters:
id - Id of the uploaded RPM. 
body - the entity body to be sent with the request.
def pysusestudio::pysusestudio::pySuseStudio::putSoftware (   self,
  id 
) 
putSoftware(id)

        Update the list of repositories of the given id appliance.  
            
            Parameters:
id - Id of the appliance
def pysusestudio::pysusestudio::pySuseStudio::searchSoftware (   self,
  id,
  q,
  all_fields = 'false',
  all_repos = 'false' 
) 
searchSoftware(id, q, all_fields='false', all_repos='false')

            Search all software that matches the given search string. If the all_fields
            parameter is set to true all fields are considered, otherwise only the name of the package 
            or pattern is matched against the search_string. 
            By default only software that is available to the appliance is considered, e.g. the search is limited to the 
            repositories of this appliances. If you want to search in all repositories set the all_repos parameter to 
            true
            
            Parameters:
id - Id of the appliance
q - The search string 
all_fields (optional) - Option to perform the search on all fields. Default is 'false'
all_repos (optional) - Option to perform the search on all repositories. Default is 'false'
def pysusestudio::pysusestudio::pySuseStudio::setAppliances (   self,
  clone_from,
  name = None,
  arch = None 
) 
setAppliances(clone_from, name, arch)

        Create a new appliance by cloning a template or another appliance with the id appliance_id. 
            If name is left out, a name will be generated. If arch is left out a i686 appliance will be created.  
            POST /api/v1/user/appliances?clone_from=<appliance_id>&name=<name>&arch=<arch>
            Parameters:
clone_from - The template the new appliance should be based on. 
name (optional) - The name of appliance 
arch (optional) - The architecture of the appliance (x86_64 or i686)
def pysusestudio::pysusestudio::pySuseStudio::setGPGKey (   self,
  id,
  name,
  target,
  key = None 
) 
setGPGKey(id, name, target, key)

            Uploads a GPG key to the appliance with the given id. The key can either be given as the key parameter 
	    or wrapped as with form-based file uploads in HTML (RFC 1867) in the body of the POST request. 
	    The key will be imported into the keyring that is specified in the target parameter
            
            Parameters:
id - Id of the appliance
name - A name for the key
target - The target specifies in which keyring the key will be imported. Possible values are: 'rpm'
key (optional) - The URL encoded key
def pysusestudio::pysusestudio::pySuseStudio::setRepositories (   self,
  id,
  repo_id 
) 
setRepositories(id, repo_id)

            Add the specified repository to the given id appliance
            
            Parameters:
id - Id of the appliance
repo_id - Id of the repository
def pysusestudio::pysusestudio::pySuseStudio::unbanSoftwarePackage (   self,
  id,
  name 
) 
unbanSoftwarePackage(id, name)

            Unban specified package from the given appliance
            
            Parameters:
id - Id of the appliance
name - Name of the package
def pysusestudio::pysusestudio::pySuseStudio::version (   self  )  
version()

            Print version information

Member Data Documentation

tuple pysusestudio::pysusestudio::pySuseStudio::auth_addr = urlparse(self.address) [static]
pysusestudio::pysusestudio::pySuseStudio::authenticated
pysusestudio::pysusestudio::pySuseStudio::password
pysusestudio::pysusestudio::pySuseStudio::username
The documentation for this class was generated from the following file:
 All Classes Namespaces Files Functions Variables
Generated on Thu Feb 4 19:15:35 2010 for PySuseStudio by  doxygen 1.6.1