2014-02-19 13:42:01 -08:00
|
|
|
:mod:`mozversion` --- Get application information
|
|
|
|
|
=================================================
|
|
|
|
|
|
|
|
|
|
`mozversion <https://github.com/mozilla/mozbase/tree/master/mozversion>`_
|
|
|
|
|
provides version information such as the application name and the changesets
|
|
|
|
|
that it has been built from. This is commonly used in reporting or for
|
|
|
|
|
conditional logic based on the application under test.
|
|
|
|
|
|
|
|
|
|
API Usage
|
|
|
|
|
---------
|
|
|
|
|
|
|
|
|
|
.. automodule:: mozversion
|
|
|
|
|
:members: get_version
|
|
|
|
|
|
2014-07-16 03:56:00 -07:00
|
|
|
Examples
|
|
|
|
|
````````
|
|
|
|
|
|
|
|
|
|
Firefox::
|
|
|
|
|
|
|
|
|
|
import mozversion
|
|
|
|
|
|
|
|
|
|
version = mozversion.get_version(binary='/path/to/firefox-bin')
|
|
|
|
|
for (key, value) in sorted(version.items()):
|
|
|
|
|
if value:
|
|
|
|
|
print '%s: %s' % (key, value)
|
|
|
|
|
|
|
|
|
|
Firefox for Android::
|
|
|
|
|
|
|
|
|
|
version = mozversion.get_version(binary='path/to/firefox.apk')
|
|
|
|
|
print version['application_changeset'] # gets hg revision of build
|
|
|
|
|
|
|
|
|
|
FirefoxOS::
|
|
|
|
|
|
|
|
|
|
version = mozversion.get_version(sources='path/to/sources.xml', dm_type='adb')
|
|
|
|
|
print version['gaia_changeset'] # gets gaia git revision
|
2014-02-19 13:42:01 -08:00
|
|
|
|
|
|
|
|
Command Line Usage
|
|
|
|
|
------------------
|
|
|
|
|
|
|
|
|
|
mozversion comes with a command line program, ``mozversion`` which may be used to
|
|
|
|
|
get version information from an application.
|
|
|
|
|
|
|
|
|
|
Usage::
|
|
|
|
|
|
|
|
|
|
mozversion [options]
|
|
|
|
|
|
|
|
|
|
Options
|
|
|
|
|
```````
|
|
|
|
|
|
|
|
|
|
---binary
|
|
|
|
|
'''''''''
|
|
|
|
|
|
2014-05-29 11:57:52 -07:00
|
|
|
This is the path to the target application binary or .apk. If this is omitted
|
|
|
|
|
then the current directory is checked for the existance of an
|
|
|
|
|
application.ini file. If not found, then it is assumed the target
|
|
|
|
|
application is a remote Firefox OS instance.
|
2014-02-19 13:42:01 -08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
---sources
|
|
|
|
|
''''''''''
|
|
|
|
|
|
|
|
|
|
The path to the sources.xml that accompanies the target application (Firefox OS
|
|
|
|
|
only). If this is omitted then the current directory is checked for the
|
|
|
|
|
existance of a sources.xml file.
|
|
|
|
|
|
|
|
|
|
Examples
|
|
|
|
|
````````
|
|
|
|
|
|
|
|
|
|
Firefox::
|
|
|
|
|
|
|
|
|
|
$ mozversion --binary=/path/to/firefox-bin
|
|
|
|
|
application_buildid: 20131205075310
|
|
|
|
|
application_changeset: 39faf812aaec
|
|
|
|
|
application_name: Firefox
|
|
|
|
|
application_repository: http://hg.mozilla.org/releases/mozilla-release
|
|
|
|
|
application_version: 26.0
|
|
|
|
|
platform_buildid: 20131205075310
|
|
|
|
|
platform_changeset: 39faf812aaec
|
|
|
|
|
platform_repository: http://hg.mozilla.org/releases/mozilla-release
|
|
|
|
|
|
2014-05-29 11:57:52 -07:00
|
|
|
Firefox for Android::
|
|
|
|
|
|
|
|
|
|
$ mozversion --binary=/path/to/firefox.apk
|
|
|
|
|
|
2014-02-19 13:42:01 -08:00
|
|
|
Firefox OS::
|
|
|
|
|
|
|
|
|
|
$ mozversion --sources=/path/to/sources.xml
|
|
|
|
|
application_buildid: 20140106040201
|
|
|
|
|
application_changeset: 14ac61461f2a
|
|
|
|
|
application_name: B2G
|
|
|
|
|
application_repository: http://hg.mozilla.org/mozilla-central
|
|
|
|
|
application_version: 29.0a1
|
|
|
|
|
build_changeset: 59605a7c026ff06cc1613af3938579b1dddc6cfe
|
|
|
|
|
device_firmware_date: 1380051975
|
|
|
|
|
device_firmware_version_incremental: 139
|
|
|
|
|
device_firmware_version_release: 4.0.4
|
|
|
|
|
device_id: msm7627a
|
|
|
|
|
gaia_changeset: 9a222ac02db176e47299bb37112ae40aeadbeca7
|
|
|
|
|
gaia_date: 1389005812
|
|
|
|
|
gecko_changeset: 3a2d8af198510726b063a217438fcf2591f4dfcf
|
|
|
|
|
platform_buildid: 20140106040201
|
|
|
|
|
platform_changeset: 14ac61461f2a
|
|
|
|
|
platform_repository: http://hg.mozilla.org/mozilla-central
|
