{ "info": { "author": "Florent Messa", "author_email": "florent.messa@gmail.com", "bugtrack_url": null, "classifiers": [ "Environment :: Web Environment", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python", "Topic :: Utilities" ], "description": "===================\ndjango-metasettings\n===================\n\n.. image:: https://secure.travis-ci.org/thoas/django-metasettings.png?branch=master\n :alt: Build Status\n :target: http://travis-ci.org/thoas/django-metasettings\n\nA reusable Django application to control the currency rate and favorite\nlanguage code, inspired by etsy.\n\nFirst you need to request an app id at\n`open exchange rates `_ to import currency rates.\n\nInstallation\n------------\n\n1. To install it, simply ::\n\n pip install django-metasettings\n\n2. Add 'metasettings' to your ``INSTALLED_APPS`` ::\n\n INSTALLED_APPS = (\n 'metasettings',\n )\n\nIf you want to install the dashboard to allow your users to select a language\nand a currency you will have to install urls from metasettings like so ::\n\n # urls.py\n\n from django.conf.urls import patterns, include\n\n urlpatterns = patterns(\n '',\n (r'^', include('metasettings.urls'))\n )\n\nYou can add your proper stylesheet to this dashboard view and have this kind\nof result:\n\n.. image:: http://cl.ly/image/2j0I3V1B0G1w/metasettings.png\n\n\nUsage\n-----\n\nTo import current currency rates, run ::\n\n $ python manage.py sync_rates --app_id=openexchangesratesappid\n\n\nTo import currency rates in a date range, run ::\n\n $ python manage.py sync_rates --app_id=openexchangesratesappid --date_start=2011-10-01 --date_end=2013-10-01\n\nIt will import for each months between the two dates the currency rates.\n\nThe OpenExchangeRates app id can also be stored in the\n``OPENEXCHANGERATES_APP_ID`` Django setting.\n\nIf you can to convert an amount from on currency to another:\n\n.. code-block:: python\n\n from metasettings.models import convert_amount\n\n convert_amount('EUR', 'USD', 15) # ~20 euros\n\n\nBy default it will return a full decimal, if you want a converted integer:\n\n.. code-block:: python\n\n from metasettings.models import convert_amount\n\n convert_amount('EUR', 'USD', 15, ceil=True) # ~20 euros\n\n\nTo retrieve the currency with a client IP Address:\n\n.. code-block:: python\n\n from metasettings.models import get_currency_from_ip_address\n\n get_currency_from_ip_address('78.192.244.8') # EUR\n\nWe are using `GeoIP`_ which gives you the ability to retrieve the country and\nthen we are linking the country to an existing currency.\n\nSo don't forget to import a fresh GeoIP database and be sure to have **GEOIP_PATH**\nin your settings.\n\nWe recommend to use `django-geoip-utils `_\nwhich provides some helpers to manipulate GeoIP API.\n\nCurrencyField\n-------------\n\nA currency field for Django models that provides all ISO 4217 currencies as choices.\n\n``CurrencyField`` is based on Django's ``CharField``, providing choices\ncorresponding to the official ISO 4217 list of currencies (with a default\n``max_length`` of 3).\n\nConsider the following model using a ``CurrencyField``:\n\n.. code-block:: python\n\n from django.db import models\n\n from metasettings.fields import CurrencyField\n\n class Project(models.Model):\n name = models.CharField(max_length=100)\n currency = CurrencyField()\n\nAny ``Project`` instance will have a ``currency`` attribute that you can use to\nget details of the project's currency:\n\n.. code-block:: python\n\n >>> project = Project(name='My project', currency='EUR')\n >>> project.currency\n Currency(code='EUR')\n >>> project.currency.label\n 'Euro'\n >>> project.currency.symbol\n '\u20ac'\n >>> project = Project(name='My project', currency='USD')\n >>> project.currency\n Currency(code='USD')\n >>> project.currency.label\n 'United States Dollar'\n >>> project.currency.symbol\n '$'\n >>> project.currency.trigram\n 'USD'\n\nThis object (``project.currency`` in the example) is a ``Currency`` instance,\nwhich is described below.\n\nUse ``blank_label`` to set the label for the initial blank choice shown in\nforms::\n\n currency = CurrencyField(blank_label='(select currency)')\n\nRoadmap\n-------\n\nsee `issues `_\n\nThis application only includes major currencies, don't hesitate to send\npatch or improvements.\n\nInspirations\n------------\n\n* The ``CurrencyField`` is heavily inspired from ``CountryField`` of the great `django-countries`_\n\n.. _GeoIP: https://docs.djangoproject.com/en/dev/ref/contrib/gis/geoip/\n.. _django-countries: https://github.com/SmileyChris/django-countries", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/thoas/django-metasettings", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "django-metasettings", "package_url": "https://pypi.org/project/django-metasettings/", "platform": "", "project_url": "https://pypi.org/project/django-metasettings/", "project_urls": { "Homepage": "http://github.com/thoas/django-metasettings" }, "release_url": "https://pypi.org/project/django-metasettings/0.3.8/", "requires_dist": null, "requires_python": "", "summary": "A reusable Django application to control the currency rate and favorite language code, inspired by etsy", "version": "0.3.8" }, "last_serial": 5424965, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "19b1de1a6201497f4e508d84c76147da", "sha256": "b747c2d07387bb5a70d85aa26b0783143bd8651cb529ceb96047cf6caf0f84f9" }, "downloads": -1, "filename": "django-metasettings-0.1.tar.gz", "has_sig": true, "md5_digest": "19b1de1a6201497f4e508d84c76147da", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11704, "upload_time": "2013-10-30T10:25:30", "url": "https://files.pythonhosted.org/packages/f0/c6/200cd6711331174fff1fd4d3b9a90f08d0df73bab7374dca6f842ac1d1ac/django-metasettings-0.1.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "af6c8877b675b8e8973d89544c398acb", "sha256": "fc2fa0745e98855b9fd2e2b0f8cdd26a32cdc30de7fac371f278a2d803d55b59" }, "downloads": -1, "filename": "django-metasettings-0.1.1.tar.gz", "has_sig": true, "md5_digest": "af6c8877b675b8e8973d89544c398acb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11872, "upload_time": "2013-11-06T16:49:44", "url": "https://files.pythonhosted.org/packages/d7/b7/6affc845f4ddfe58499637d5d08ce8c68fcc8b47a602e077f86af92167ad/django-metasettings-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "30b9e3a9ac0517285727e63aa05904c4", "sha256": "8c561295e2d2eeb41d09b74189781b345ce47ce4dc3a472d7dabc78bb28814b6" }, "downloads": -1, "filename": "django-metasettings-0.1.2.tar.gz", "has_sig": true, "md5_digest": "30b9e3a9ac0517285727e63aa05904c4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12071, "upload_time": "2014-03-17T21:10:09", "url": "https://files.pythonhosted.org/packages/02/2b/14f910c0cc7025ab2cb1a87d98811ab351f66363d253e83aa4ad5da97c94/django-metasettings-0.1.2.tar.gz" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "3cd527e57520a9193116210dc320fe47", "sha256": "3bcc64b3c0a7de3327fe7c9a7cfd95d584cf97ace01665f614ef31ff83263871" }, "downloads": -1, "filename": "django-metasettings-0.1.3.tar.gz", "has_sig": true, "md5_digest": "3cd527e57520a9193116210dc320fe47", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12099, "upload_time": "2014-03-28T10:28:49", "url": "https://files.pythonhosted.org/packages/7e/23/ff37083de5cb22bdc9ff507914eabc40153e842488a12e0f54348f3f5c30/django-metasettings-0.1.3.tar.gz" } ], "0.1.4": [ { "comment_text": "", "digests": { "md5": "36cfe9b04c7661b36d033d45eb96e04a", "sha256": "ef1d754fdc09835ed08fd8eabfd7cef2f903d359fb24bcdb9a99a6134c6c9a2b" }, "downloads": -1, "filename": "django-metasettings-0.1.4.tar.gz", "has_sig": true, "md5_digest": "36cfe9b04c7661b36d033d45eb96e04a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12593, "upload_time": "2015-02-25T16:50:52", "url": "https://files.pythonhosted.org/packages/6b/89/93c2187c34e8b6f7cda1729f40c2d9e21587d22cd5936ea0c594876e8cc6/django-metasettings-0.1.4.tar.gz" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "b358da1f46ec506e6220f00bc96f0e10", "sha256": "027ce60b91410eee39a254459fa8994a5530ed650166950e4331c192d64246ec" }, "downloads": -1, "filename": "django-metasettings-0.2.tar.gz", "has_sig": true, "md5_digest": "b358da1f46ec506e6220f00bc96f0e10", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17440, "upload_time": "2015-03-11T12:55:14", "url": "https://files.pythonhosted.org/packages/0f/d5/8cac34996161acd13a763c8886c0baa09781ee79fc2956fc5eb036b5cd2c/django-metasettings-0.2.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "031038d97d523cc0ae6857ce35d7122c", "sha256": "2fbb89c19f91f7e85d1e1dbb0a7ba8a886b79efed86c622ea1f3718835072c45" }, "downloads": -1, "filename": "django-metasettings-0.2.1.tar.gz", "has_sig": true, "md5_digest": "031038d97d523cc0ae6857ce35d7122c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17493, "upload_time": "2015-04-02T12:01:22", "url": "https://files.pythonhosted.org/packages/ea/4d/dda6861879253b0e0b8c81d71b789e03a745cce20a18d136030636eafd3d/django-metasettings-0.2.1.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "a8dccb53dc9482d842f11db064273b31", "sha256": "aced785678e028e03c4a6e47873b04c3e2bb0ae543f892aa2bfb9eab9f2df240" }, "downloads": -1, "filename": "django-metasettings-0.2.2.tar.gz", "has_sig": true, "md5_digest": "a8dccb53dc9482d842f11db064273b31", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17559, "upload_time": "2015-04-17T13:30:05", "url": "https://files.pythonhosted.org/packages/e0/37/9b5f68cdf553b501f7b3ac50a3cd7d4cdfe50f87764b5670474ad22f59cc/django-metasettings-0.2.2.tar.gz" } ], "0.2.3": [ { "comment_text": "", "digests": { "md5": "a83e3a7146cd84efef305b08f1a056a3", "sha256": "4a9582dbfeeb3fcde7668ce985d60f7f984adaaeb0e2b1abb219890ca1971e3d" }, "downloads": -1, "filename": "django-metasettings-0.2.3.tar.gz", "has_sig": true, "md5_digest": "a83e3a7146cd84efef305b08f1a056a3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17566, "upload_time": "2015-06-08T15:40:34", "url": "https://files.pythonhosted.org/packages/ad/b2/67036abb576674646d8d2ca4bd193de9fe83a3b1f01bdd033ff96dd0d892/django-metasettings-0.2.3.tar.gz" } ], "0.3": [ { "comment_text": "", "digests": { "md5": "8d516c0860662a04e19461000fc8c171", "sha256": "5bd6df887861634e6fba2eb73222e02c16fea8ed9fd9aa0f342b411575621a4a" }, "downloads": -1, "filename": "django-metasettings-0.3.tar.gz", "has_sig": true, "md5_digest": "8d516c0860662a04e19461000fc8c171", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 24129, "upload_time": "2015-11-04T14:38:47", "url": "https://files.pythonhosted.org/packages/ee/73/4624c4e05fd6658d1588e01a1f638e68650173eb4a9d0e4cfbbec1d32b21/django-metasettings-0.3.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "f16a0ea798a86fad1e900452701be360", "sha256": "9bb99ea5e159bfe7ca6f029453d45b3cb49259e4384065df73c4f2a62e3e0c4a" }, "downloads": -1, "filename": "django-metasettings-0.3.1.tar.gz", "has_sig": true, "md5_digest": "f16a0ea798a86fad1e900452701be360", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 24266, "upload_time": "2015-11-04T17:46:09", "url": "https://files.pythonhosted.org/packages/b1/74/5951f73c2a7eff43410b220bab9bbac824c49d50e6df092d75fc7b6e13cf/django-metasettings-0.3.1.tar.gz" } ], "0.3.2": [ { "comment_text": "", "digests": { "md5": "9cb84b9447d2d32a06d2647f0b12c378", "sha256": "0f1b3c5ddba65d4a1239f6c0c731c964eea29cb004187bddd847cdc89b4cdcb9" }, "downloads": -1, "filename": "django-metasettings-0.3.2.tar.gz", "has_sig": true, "md5_digest": "9cb84b9447d2d32a06d2647f0b12c378", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 24119, "upload_time": "2015-12-21T15:05:38", "url": "https://files.pythonhosted.org/packages/ad/23/9365131d7ae5e4273f22e7950bcc06a64ac265a419c6aab02018e89ae92b/django-metasettings-0.3.2.tar.gz" } ], "0.3.3": [ { "comment_text": "", "digests": { "md5": "0864740fd22daf395a4de67606167d02", "sha256": "398588d7984a95a0865270b3a82fcf5e612e86efba2a534a26552edb4dd4e5fc" }, "downloads": -1, "filename": "django-metasettings-0.3.3.tar.gz", "has_sig": true, "md5_digest": "0864740fd22daf395a4de67606167d02", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 24186, "upload_time": "2016-10-05T05:50:38", "url": "https://files.pythonhosted.org/packages/3f/64/fc0af6d6f9d6e5583456ac167fae521b43e093427c0fde0fa9e2c0b8fb92/django-metasettings-0.3.3.tar.gz" } ], "0.3.4": [ { "comment_text": "", "digests": { "md5": "ee77c30da10eb7c2d868f8a58d5a93df", "sha256": "7bb4d08a31cf574c1172ea5e5d86f95c94e5dc8c10f29a167577b29111de27b1" }, "downloads": -1, "filename": "django-metasettings-0.3.4.tar.gz", "has_sig": true, "md5_digest": "ee77c30da10eb7c2d868f8a58d5a93df", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23950, "upload_time": "2018-01-09T09:55:51", "url": "https://files.pythonhosted.org/packages/23/92/4cb2224d7d072a6a6f2344b53a1b8f82a4b1aad52a51c326fc5535a811ee/django-metasettings-0.3.4.tar.gz" } ], "0.3.5": [ { "comment_text": "", "digests": { "md5": "0e46c41e82b60ba0981133f885b25e61", "sha256": "761e41db458302b5193351da8958917aba339dcfd62f0725f051994c15f0e133" }, "downloads": -1, "filename": "django-metasettings-0.3.5.tar.gz", "has_sig": true, "md5_digest": "0e46c41e82b60ba0981133f885b25e61", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 24162, "upload_time": "2018-06-26T12:26:46", "url": "https://files.pythonhosted.org/packages/5b/df/5e618834d206a8b3f748de8627142cfc590e4ebf964fb82aa38ab63c63cf/django-metasettings-0.3.5.tar.gz" } ], "0.3.6": [ { "comment_text": "", "digests": { "md5": "31a8f4856cf804672db41d8008cf4adb", "sha256": "34181c1294762485de4673660b9dd4f1d21c1a46b2336ff616c74bb6a91a538b" }, "downloads": -1, "filename": "django-metasettings-0.3.6.tar.gz", "has_sig": true, "md5_digest": "31a8f4856cf804672db41d8008cf4adb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23731, "upload_time": "2018-08-06T09:44:03", "url": "https://files.pythonhosted.org/packages/2a/ea/d52d56d529675e6bb5507c22de39ff523b04ef47e4a8589221c1c6ff27d2/django-metasettings-0.3.6.tar.gz" } ], "0.3.7": [ { "comment_text": "", "digests": { "md5": "4efe953b4ed91b306f5738efacc34be9", "sha256": "4f6e088ec491dbfbba070d73b1d0f9857de7695d7f6a89dc2837d820795c5bde" }, "downloads": -1, "filename": "django-metasettings-0.3.7.tar.gz", "has_sig": true, "md5_digest": "4efe953b4ed91b306f5738efacc34be9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23841, "upload_time": "2019-02-01T13:24:35", "url": "https://files.pythonhosted.org/packages/44/b6/29254d216a3975f9cb99e21147530677d386acbfff24ebf540d9307d55b3/django-metasettings-0.3.7.tar.gz" } ], "0.3.8": [ { "comment_text": "", "digests": { "md5": "8869326ca94fadc61825e35df9d585c5", "sha256": "c221fbcfd2a9a43b406be6f9169214d574d35e0705a5ce93ad8f04fdfe35746d" }, "downloads": -1, "filename": "django-metasettings-0.3.8.tar.gz", "has_sig": false, "md5_digest": "8869326ca94fadc61825e35df9d585c5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23773, "upload_time": "2019-06-20T09:55:26", "url": "https://files.pythonhosted.org/packages/09/6d/75d42e910ff6656caae2e24a304dd46978ae36fd5b7554080c9f4d3137fe/django-metasettings-0.3.8.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "8869326ca94fadc61825e35df9d585c5", "sha256": "c221fbcfd2a9a43b406be6f9169214d574d35e0705a5ce93ad8f04fdfe35746d" }, "downloads": -1, "filename": "django-metasettings-0.3.8.tar.gz", "has_sig": false, "md5_digest": "8869326ca94fadc61825e35df9d585c5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23773, "upload_time": "2019-06-20T09:55:26", "url": "https://files.pythonhosted.org/packages/09/6d/75d42e910ff6656caae2e24a304dd46978ae36fd5b7554080c9f4d3137fe/django-metasettings-0.3.8.tar.gz" } ] }