Webmasterwords » Python

Python UCM Client

admin — Fri, 16 Sep 2011 17:03:37 +0000

This package provides a simple client for calling the services on Oracle Content Server 11g via the standard web interface. It can be used in conjunction with any of the services provided by Content Server defined here

Installation

easy_install ucmclient

Examples

Uploading a file to Content Server

from ucmclient import UcmClient, ServiceFailed
 
#connect to ucm with specified hostname and content server port
ucmClient = UcmClient('ucmserver.example.com','16200')
ucmClient.login('weblogic','password')
 
#build a dictionary of service parameters.
ucmServiceData ={
    'dDocTitle':'New Article 1',
    'dDocName':'News_Article_01',
    'dDocType':'News',
    'dDocAuthor':'weblogic',
    'dDocAccount':'weblogic',
    'dSecurityGroup':'Public',
    #files can be submitted using an open file object
    'primaryFile':open('news.txt','r')
}
 
try:
    ucmClient.call_service('CHECKIN_UNIVERSAL',ucmServiceData)
except ServiceFailed as e:
    print 'checkin failed - %s' % e

Searching for files on Content Server

from ucmclient import UcmClient, ServiceFailed
 
ucmClient = UcmClient('ucmserver.example.com','16200')
ucmClient.login('weblogic','password')
 
#Search for files of type News
ucmServiceData = {
        'QueryText':'dDocType`News`',
        'ResultCount':10
}
 
try:
    search = ucmClient.call_service('GET_SEARCH_RESULTS',ucmServiceData)
    #Access resultset by name and iterate through results
    for doc in search.fetch('SearchResults'):
        print doc['dDocName']
 
except ServiceFailed as e:
    print 'search failed - %s' % e

The python "with" statement explained with examples.

admin — Wed, 14 Sep 2011 18:21:32 +0000

Python’s with statement was introduced into the language in version 2.5 and is defined in PEP 343. The python docs provide the following description “The with statement is used to wrap the execution of a block with methods defined by a context manager. This allows common try…except…finally usage patterns to be encapsulated for convenient reuse.” but what does this actually mean?

Lets start with an example:

With File

with open("test.txt") as testfile:
    testcontents = testfile.read()
    print testcontents

This example demonstrates opening and printing the contents of a file “test.txt’ to the stdout. The first thing most people should (hopefully) notice is that when using the “with” statement it is not necessary to close the file after we’ve used it. Thats because the open function provides a context manager which closes the file after use.

In python a context manager in is an object that defines how a resource should be initially setup for use and cleared up after use. It implements two functions __enter__ which is called when the resource is setup and __exit__ when it is no longer needed. Its is the __exit__ method of the open file context manager that ensures the file is closed after use.

Another Context Manager

A very common application functionality is to access a database, add some records and finally commit those updates as a transaction. Using SQLAlchemy it would look something like this:

from sqlalchemy import *
 
db = create_engine('sqlite:///test.db')
dbcon =  db.connect()
transaction = dbcon.begin()
dbcon.execute('insert into NameDB (FirstName, LastName,Age) values ("john","smith",34)')
dbcon.execute('insert into NameDB (FirstName, LastName,Age) values ("dave","smith",37)')
transaction.commit()

You can see that here the resource in question is the database transaction, we set it up before the inserts and close it after the commit. However because the SQLAlchemy transaction object implement a context manager the above code could be written more succinctly as:

from sqlalchemy import *
 
db = create_engine('sqlite:///test.db')
dbcon =  db.connect()
with dbcon.begin():
    dbcon.execute('insert into NameDB (FirstName, LastName,Age) values ("john","smith",34)')
    dbcon.execute('insert into NameDB (FirstName, LastName,Age) values ("dave","smith",37)')

In the next post I will discuss creating your own context managers.

Python Split and Join Examples

admin — Mon, 26 Jan 2009 12:39:01 +0000

Split and join in python are similar to the equivalent functions in most dynamic languages with a few minor differences:

Python Split

Split a sentence into separate words:

sentence = "the cat sat on the mat"
print sentence.split()
['the', 'cat', 'sat', 'on', 'the', 'mat']

Split words separated by a single character:

sentence = "the,cat,sat,on,the,mat"
print sentence.split(',')
['the', 'cat', 'sat', 'on', 'the', 'mat']

Split words separated by a string:

sentence = "theSPACEcatSPACEsatSPACEonSPACEtheSPACEmat"
print sentence.split('SPACE')
['the', 'cat', 'sat', 'on', 'the', 'mat']

Split only the first two words in a comma separated string

sentence = "the,cat,sat,on,the,mat"
print sentence.split(',',2)
['the', 'cat', 'sat,on,the,mat']

Python Join

Join uses a sligthly difference implmentation to what you might be used to. The character that joins the elements is the one upon which the function is called

Joining an array with spaces

>>> ' '.join(['the', 'cat', 'sat', 'on', 'the', 'mat'])
'the cat sat on the mat'

Joining an array with commas

>>> ','.join(['the', 'cat', 'sat', 'on', 'the', 'mat'])
'the,cat,sat,on,the,mat'