[Mozprofile](https://github.com/mozilla/mozbase/tree/master/mozprofile) is a python tool for creating and managing profiles for Mozilla’s applications (Firefox, Thunderbird, etc.). In addition to creating profiles, mozprofile can install [addons](https://developer.mozilla.org/en/addons) and set [preferences](https://developer.mozilla.org/En/A_Brief_Guide_to_Mozilla_Preferences). Mozprofile can be utilized from the command line or as an API.
# Command Line Usage
mozprofile may be used to create profiles, set preferences in profiles, or install addons into profiles.
The profile to be operated on may be specified with the –profile switch. If a profile is not specified, one will be created in a temporary directory which will be echoed to the terminal:
(mozmill)> mozprofile /tmp/tmp4q1iEU.mozrunner (mozmill)> ls /tmp/tmp4q1iEU.mozrunner user.js
To run mozprofile from the command line enter: mozprofile –help for a list of options.
# API Usage
To use mozprofile as an API you can import [mozprofile.profile](https://github.com/mozilla/mozbase/tree/master/mozprofile/mozprofile/profile.py) and/or the [AddonManager](https://github.com/mozilla/mozbase/tree/master/mozprofile/mozprofile/addons.py).
mozprofile.profile features a generic Profile class. In addition, subclasses FirefoxProfile and ThundebirdProfile are available with preset preferences for those applications.
# Installing Addons
Addons may be installed individually or from a manifest.
Example:
from mozprofile import FirefoxProfile
# create new profile to pass to mozmill/mozrunner profile = FirefoxProfile(addons=[“adblock.xpi”])
# Setting Preferences
Preferences can be set in several ways:
using the API: You can pass preferences in to the Profile class’s constructor: obj = FirefoxProfile(preferences=[(“accessibility.typeaheadfind.flashBar”, 0)])
using a JSON blob file: mozprofile –preferences myprefs.json
using a .ini file: mozprofile –preferences myprefs.ini
via the command line: mozprofile –pref key:value –pref key:value […]
When setting preferences from an .ini file or the –pref switch, the value will be interpolated as an integer or a boolean (true/false) if possible.
# Setting Permissions
mozprofile also takes care of adding permissions to the profile. See https://github.com/mozilla/mozbase/blob/master/mozprofile/mozprofile/permissions.py
# Resources
Other Mozilla programs offer additional and overlapping functionality for profiles. There is also substantive documentation on profiles and their management.
[ProfileManager](https://developer.mozilla.org/en/Profile_Manager) : XULRunner application for managing profiles. Has a GUI and CLI.
[python-profilemanager](http://k0s.org/mozilla/hg/profilemanager/) : python CLI interface similar to ProfileManager
profile documentation : http://support.mozilla.com/en-US/kb/Profiles
Release files for mozprofile 0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mozprofile-0.1.tar.gz | 13.8 kB | Details |
Release files / mozprofile-0.1.tar.gz
| Download URL | mozprofile-0.1.tar.gz |
|---|---|
| Size | 13.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
47cda6593546e0bea443fb2ba1e5b48d7f7cc6980494ced7b4ea12f3958d4008
|
|
BLAKE2b-256 checksum How to use checksums |
6737ca649b299d79ee7ba74fa4874755dcc6ec45dc174bf4d1657c226cfda532
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
