Product and locale details for Mozilla products.
>From the original README file:
This library holds information about the current builds of Firefox and Thunderbird that Mozilla ships including: - Latest version numbers for all builds - English and Native names for all languages we support
This is a Django app allowing this data to be used in Django projects. A Django management command can be used as a cron job or called manually to keep the data in sync with Mozilla.
The data source of Mozilla Product Details is a PHP library kept on the Mozilla SVN server, and was originally written so it could be included into PHP projects via an SVN external. A simple svn up would fetch the latest data when it became available.
In the meantime, the Product Details library received an additional JSON feed, allowing non-PHP projects to consume the data. If, however, the consumer is not kept in SVN like the library is, there is no easy way to keep the data up to date.
For Django projects, this app solves that problem.
Install this library using pip:
pip install django-mozilla-product-details
… or by downloading the product_details directory and dropping it into your django project.
Add product_details to your INSTALLED_APPS to enable the management commands.
No configuration should be necessary. However, you can add the following settings to your settings.py file if you disagree with the defaults:
You can further decide where the JSON data should be stored by using a storage backend class. There are 2 provided in the app currently, but it should be easy to create a subclass of product_details.storage.ProductDetailsStorage and store them wherever you like. The two provided are for the filesystem (the default) and the database. To configure which backend it uses set the following:
This app uses Django’s cache framework to store the product data so that the data can be updated on the site without requiring a server restart. The following settings will allow you to control how this works.
To update the data, execute this:
You want to run this once manually after installing the app. To periodically pull in new data, you can make this a cron job.
Note: Please be considerate of the server when adding a cron job. The data does not change often enough to warrant an update every minute or so. Most applications will run perfectly fine if you pull new data once a day or even less frequently. When in doubt, contact the author of this library.
To use the data, just import the library:
from product_details import product_details
The library turns all imported JSON files automatically into Python objects. The contents are perhaps best inspected using IPython.
Product details comes with an implementation of version comparison code for Mozilla-style product versions. Use it like this:
>>> from product_details.version_compare import Version >>> v1 = Version('4.0b10') >>> v2 = Version('4.0b10pre') >>> v1 < v2 False
The second useful part of the version compare code is generating a list of unique versions, sorted by their release date, like this:
>>> from product_details import product_details >>> from product_details.version_compare import version_list >>> version_list(product_details.firefox_history_development_releases) ['3.6.4', '3.6.3', '3.6', '3.6b5', '3.6b4', '3.6b3', '3.6b2', ... ]
While the management task will not overwrite existing files if the server returns bogus data (i.e., an empty document or unparseable JSON data), this library will also never delete a JSON file that was completely removed from the server. This is unlikely to happen very often, though.
You don’t want to import product_details in settings.py as that would cause an import loop (since product_details itself imports django.conf.settings). However, if you must, you can lazily wrap the import like this, mitigating the problem:
from django.utils.functional import lazy MY_LANGUAGES = ('en-US', 'de') class LazyLangs(list): def __new__(self): from product_details import product_details return [(lang.lower(), product_details.languages[lang]['native']) for lang in MY_LANGUAGES] LANGUAGES = lazy(LazyLangs, list)()
Patches are welcome.
To run tests, install tox and run tox from the project root. This will run the tests in Python 2.6 and 2.7. If you don’t have both of those available, install nose and Mock and run the tests in your current Python version by running ./runtests.py.
If you are logged into PyPI as an owner of this package, then just run ./release.sh. It will run the tests, update the JSON data, and build and upload the package to PyPI.
Thanks to jgmize for both of these improvements!
Thanks to Osmose for both of these improvements!
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|File Name & Checksum SHA256 Checksum Help||Version||File Type||Upload Date|
|django_mozilla_product_details-0.12.1-py2.py3-none-any.whl (409.2 kB) Copy SHA256 Checksum SHA256||py2.py3||Wheel||Aug 18, 2016|
|django-mozilla-product-details-0.12.1.tar.gz (287.4 kB) Copy SHA256 Checksum SHA256||–||Source||Aug 18, 2016|