멤버들¶

class mozrepl.Mozrepl(port=4242, host=u'127.0.0.1')¶

Bases: object

Firefox MozREPL Add-on에 대한 인터페이스를 제공하는 클래스.

with 구문을 지원합니다.

Parameters:	port (int) – mozrepl Firefox Add-on의 포트. host (unicode) – mozrepl Firefox Add-on의 호스트.

DEFAULT_HOST = u'127.0.0.1'¶

DEFAULT_PORT = 4242¶

connect(port=None, host=None)¶

mozrepl Firefox Add-on과 연결합니다.

연결 대상은 최초 연결된 대상과 같아야 합니다.

Parameters:	port – mozrepl Firefox Add-on의 포트. 생략시, 기존 값을 사용합니다. port – mozrepl Firefox Add-on의 호스트. 생략시, 기존 값을 사용합니다.

disconnect()¶

mozrepl Firefox Add-on과의 연결을 일시적으로 끊습니다.

서버에 저장된 상태까지 삭제하려면, 이 객체를 삭제해야 합니다.

execute(command)¶

명령을 실행합니다.

Attention

오브젝트의 메소드를 사용할때, ‘repl.execute(“repl.home”)()’과 같이 함수의 메소드를 바로 반환 받은 뒤 사용 할 수 없습니다. 이와 같은 방식으로 사용하려면, ‘repl.execute(“repl.home.call”)(Raw(“repl”))’와 같이 호출 오브젝트를 명시적으로 넘겨주거나, ‘repl.execute(“repl”).home()’과 같이 pymozrepl의 자동 바인딩 기능을 사용하십시오.

Attention

하나의 pymozrepl 객체는 독립된 하나의 문맥을 가집니다. 이 문맥은 Firefox mozrepl에서 제공하는 현재 문맥과는 다르다는 점을 주의하십시오.

Attention

javascript repl object를 사용하지 마십시오.

Parameters:	command (unicode) – 명령.
Raises mozrepl.Exception:
	mozrepl Firefox Add-on에서 오류를 던질 경우.
Returns:	Object : mozrepl Firefox Add-on에서 반환받은 값이 object인 경우.
Returns:	Array : mozrepl Firefox Add-on에서 반환받은 값이 array인 경우.
Returns:	Function : mozrepl Firefox Add-on에서 반환받은 값이 function인 경우.
Returns:	그 외에 string, number, bool 등의 기본값은 python에서 대응되는 적절한 기본 타입(int, bool, unicode 등)으로 변환하여 돌려줍니다.

class mozrepl.Exception(error)¶

Bases: exceptions.Exception

mozrepl Firefox Add-on에서 반환한 오류에 대한 정보를 담는 클래스.

javascript Error 객체를 참조 하듯이 속성을 참조하십시오. 단, 메소드에 대한 참조는 지원하지 않습니다.

만약, 현재 객체에 존재하고 있는 이름과 같은 이름의 javascript object 속성에 접근하려면, __getitem__ 메소드를 사용하십시오.

특정 속성이 존재하는가를 검사하려면 __contains__ 메소드를 사용하십시오.

type 모듈¶

class mozrepl.type.Object(repl, uuid)¶

Bases: object

javascript object에 대한 인터페이스를 제공합니다.

• 사전 형식으로 속성에 접근할 수 있습니다(__getitem__, __setitem__, __delitem__).
• 속성 형식으로 속성에 접근 할 수 있습니다(__getattr__, __setattr__, __delattr__).
• __eq__, __contains__ 메소드가 구현되어 있습니다.

만약, 이 객체에 존재하는 속성의 이름과 같은 자바스크립트 오브젝트의 속성에 접근하려면, 사전 형식으로 원소에 접근하십시오.

사용 예는 다음과 같습니다.

>>> import mozrepl
>>> repl = mozrepl.Mozrepl()
>>> a = repl.execute('repl')
>>> b = repl.execute('repl')
>>> a == b # __eq__
True
>>> '_name' in a # __contains__
True
>>> a._name # __getattr__
u'repl'
>>> a['_name'] # __getitem__
u'repl'
>>> a['_name'] = 'pymozrepl' # __setitem__
>>> a['_name']
u'pymozrepl'
>>> del a._name # __delattr__
>>> a._name
None
>>> for key, value in a: # __iter__
...

__iter__()¶

javascript Object에 iterator하게 접근합니다.

Yield:	value; 오브젝트에 ‘__iterator__’ 속성이 존재한다면, Iterator를 사용하여 작업을 수행합니다.
Yield:	별도의 이터레이터가 정의되어 있지 않다면, (key, value) 쌍을 전달합니다.

__unicode__()¶

자바스크립트에서 이 오브젝트에 대한 참조값.

만약, 자바스크립트에서 직접 이 오브젝트에 대해 접근하기를 원한다면, 이 속성을 통해 변수 이름을 얻을 수 있습니다. 예컨데, 다음과 같이 사용 할 수 있습니다.

>>> import mozrepl
>>> repl = mozrepl.Mozrepl()
>>> obj = repl.execute('window')
>>> unicode(obj)
u'__pymozrepl_c8d7323280c54d09809e2dd7d34d1c70.ref["1e1c7ae3-c1fc-4664-b57f-1281bdc1c996"]'
>>> repl.execute('var value = {reference}'.format(reference=obj))

classmethod makeNotinited(repl)¶

초기화되지 않은 참조 오브젝트를 얻습니다.

Parameters:	repl (Mozrepl) – mozrepl.Mozrepl 객체
Returns:	초기화되지 않은 Object 객체.
Return type:	Object

class mozrepl.type.Array(repl, uuid)¶

Bases: mozrepl.type.object.Object

javascript array에 대한 인터페이스를 제공합니다.

__len__, __iter__ 메소드가 구현되어 있습니다.

사용 예는 다음과 같습니다.

>>> import mozrepl
>>> repl = mozrepl.Mozrepl()
>>> array = repl.execute('[1,2,3,4,5,10]')
>>> len(array) # __len__
6
>>> list(array) # __iter__
[1, 2, 3, 4, 5, 10]

__iter__()¶

javascript Object에 iterator하게 접근합니다.

Yield:	value; 0 ~ 마지막 값까지 yield합니다.

class mozrepl.type.Function(repl, uuid)¶

Bases: mozrepl.type.object.Object

javascript function에 대한 인터페이스를 제공합니다.

사용 예는 다음과 같습니다.

>>> import mozrepl
>>> repl = mozrepl.Mozrepl()
>>> func = repl.execute('(function(){ return "mozrepl"; })') #__call__
>>> func()
u'mozrepl'
>>> repl.execute('window').toString() #__call__
u'[object ChromeWindow]'

__call__(*args)¶

javascript Function object를 실행합니다.

입력하는 각 인자는 convertToJs() 함수에서 허용하는 형식을 준수해야 합니다.

class mozrepl.type.Raw(code)¶

자바스크립트 코드를 담는 클래스.

이 클래스로 생성된 코드는 convertToJs() 함수에 의해 변환되지 않고, 입력된 그대로 전달되게 됩니다.

Parameters:	code (unicode) – 자바스크립트 코드.

util 모듈¶

mozrepl.util.convertToJs(obj)¶

입력받은 값을 javascript에서 사용 가능한 값으로 변환합니다.

Parameters:	obj (Object, Function, Array, Raw 외 python 기본 타입.) – 변환할 값. 만약 list와 tuple타입을 인자로 준다면, 포함된 값은 convertToJs() 함수가 변환 할 수 있는 값이어야 합니다.
Returns:	JSON string
Return type:	unicode

mozrepl.util.getAllTabs(repl)¶

접속한 브라우져에 존재하는 모든 탭 오브젝트를 가져옵니다.

Parameters:	repl (Mozrepl) – mozrepl 객체.
Yield:	각 탭 Object 객체.

mozrepl.util.getCookiesFromHost(repl, host)¶

Returns an generator of cookies that would be returned to a given host, ignoring the cookie flags isDomain, isSecure, and isHttpOnly. Therefore, if the specified host is “weather.yahoo.com”, host or domain cookies for “weather.yahoo.com” and “yahoo.com” would both be returned, while a cookie for “my.weather.yahoo.com” would not.

Parameters:	repl (Mozrepl) – mozrepl.Mozrepl 객체 host (unicode) – The host unicode string to look for, such as “google.com”. This should consist only of the host portion of the URI and should not contain a leading dot, port number, or other information.
Yield:	An cookielib.Cookie objects representing the matching cookies.

mozrepl.util.openTab(repl, url, isPrivate=False, inNewWindow=False, inBackground=False, isPinned=False)¶

Opens a new tab. The new tab will open in the active window or in a new window, depending on the inNewWindow option.

Parameters:

repl (Mozrepl) – mozrepl 객체. url (unicode) – String URL to be opened in the new tab. This is a required property. isPrivate (bool) – bool which will determine whether the new tab should be private or not. If your add-on does not support private browsing this will have no effect. See the private-browsing documentation for more information. Defaults to false. inNewWindow (bool) – If present and true, a new browser window will be opened and the URL will be opened in the first tab in that window. This is an optional property. inBackground (bool) – If present and true, the new tab will be opened to the right of the active tab and will not be active. This is an optional property. isPinned (bool) – If present and true, then the new tab will be pinned as an app tab.