{ "info": { "author": "Fusionbox, Inc.", "author_email": "programmers@fusionbox.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Framework :: Django", "Intended Audience :: Developers", "License :: OSI Approved :: Apache Software License", "Natural Language :: English", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4" ], "description": "django-absoluteuri\n==================\n\n.. image:: https://travis-ci.org/fusionbox/django-absoluteuri.png?branch=master\n :target: https://travis-ci.org/fusionbox/django-absoluteuri\n\nAbsolute URI functions and template tags for Django.\n\n\nWhy\n---\n\nThere are times when you need to output an absolute URL (for example, inside an\nemail), but you don't always have access to the request. These utilities use\nthe Sites Framework if available in order to create absolute URIs.\n\n\nInstallation\n------------\n\nInstall django-absoluteuri::\n\n pip install django-absoluteuri\n\nThen add it to your ``INSTALLED_APPS``::\n\n INSTALLED_APPS = (\n # ...\n 'django.contrib.sites',\n 'absoluteuri',\n )\n\ndjango-absoluteuri requires the `Sites Framework\n`_ to be in\n``INSTALLED_APPS`` well and configured as well.\n\n\nSettings\n--------\n\nThe protocol of the uris returned by this library defaults to ``http``. You\ncan specify the protocol with the ``ABSOLUTEURI_PROTOCOL`` setting.\n\n.. code:: python\n\n # settings.py\n ABSOLUTEURI_PROTOCOL = 'https'\n\n # Elsewhere\n >>> absoluteuri.build_absolute_uri('/some/path/')\n 'https://example.com/some/path/'\n\n\nTemplate Tags\n-------------\n\nThere are two template tags, ``absoluteuri`` and ``absolutize``.\n``absoluteuri`` works just like the ``url`` tag, but that it outputs absolute\nURLs.\n\n.. code:: html+django\n\n {% load absoluteuri %}\n\n click here\n\n\n``absolutize`` will take a relative URL and return an absolute URL.\n\n.. code:: html+django\n\n {% load absoluteuri %}\n\n click here\n\n\nFilter\n------\n\nSometimes instead of template tags, it's easier to use filters. You can do that\nas well.\n\n.. code:: html+django\n\n {% load absoluteuri %}\n\n click here\n\nBut there are situations where tag can not be used but filter can.\n\n.. code:: html+django\n\n {% load absoluteuri %}\n\n {% include \"some-other-template.html\" with url=my_object.get_absolute_url|absolutize %}\n\n\nFunctions\n---------\n\nThere are also two functions that django-absoluteuri provides,\n``build_absolute_uri`` and ``reverse``, which are equivalents of\n``request.build_absolute_url`` and ``urlresolvers.reverse``.\n\n.. code:: python\n\n >>> import absoluteuri\n\n >>> my_relative_url = '/path/to/somewhere/'\n >>> absoluteuri.build_absolute_uri(my_relative_url)\n 'http://example.com/path/to/somewhere/'\n >>> absoluteuri.reverse('viewname', kwargs={'foo': 'bar'})\n 'http://example.com/path/to/bar/'\n\n\n.. :changelog:\n\nChangelog\n=========\n\n1.3.0 (2018-09-04)\n------------------\n\n- Add support for Django 2.1. Remove support for Django < 1.11.\n\n\n1.2.0 (2016-02-29)\n------------------\n\n- Add absolutize filter. This deprecates the absolutize tag. [#4]\n\n\n1.1.0 (2015-03-23)\n------------------\n\n- Added ABSOLUTEURI_PROTOCOL settings. [#1]\n- Documented sites framework requirement.\n\n\n1.0.0 (2015-03-17)\n------------------\n\n- First release on PyPI.", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/fusionbox/django-absoluteuri", "keywords": "django-absoluteuri", "license": "Apache 2.0", "maintainer": "", "maintainer_email": "", "name": "django-absoluteuri", "package_url": "https://pypi.org/project/django-absoluteuri/", "platform": "", "project_url": "https://pypi.org/project/django-absoluteuri/", "project_urls": { "Homepage": "https://github.com/fusionbox/django-absoluteuri" }, "release_url": "https://pypi.org/project/django-absoluteuri/1.3.0/", "requires_dist": null, "requires_python": "", "summary": "Absolute URI functions and template tags for Django", "version": "1.3.0" }, "last_serial": 4239265, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "859364ec01645aaa73e4b3250b6e1cb6", "sha256": "b71148b929a3a7d87630e2ab267389123783e4776184f0fcb5fd3837309cbcc2" }, "downloads": -1, "filename": "django-absoluteuri-1.0.0.zip", "has_sig": false, "md5_digest": "859364ec01645aaa73e4b3250b6e1cb6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11883, "upload_time": "2015-03-17T22:50:12", "url": "https://files.pythonhosted.org/packages/10/08/0edef7f5d0a3705d85264debadd7db4935fd40bac70ea0422f815609fe7b/django-absoluteuri-1.0.0.zip" } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "b6a5369336a62666af0f4b9179f25503", "sha256": "8b48c47a50fc18fb32310b5e62bce6785e9752f8b9a1917af0d59c4152c68641" }, "downloads": -1, "filename": "django-absoluteuri-1.1.0.zip", "has_sig": false, "md5_digest": "b6a5369336a62666af0f4b9179f25503", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12918, "upload_time": "2015-03-23T17:56:29", "url": "https://files.pythonhosted.org/packages/40/dc/1106ce80bfe716f53c98dd8b57e45e0c427f8526024b74d3de35b65e0cd3/django-absoluteuri-1.1.0.zip" } ], "1.2.0": [ { "comment_text": "", "digests": { "md5": "713b371e699dcb5fbbed18ab802c80ea", "sha256": "63686fbd838d03e78d6b85ede135e09f93723c52a0b2ed3462d56f7bd637da77" }, "downloads": -1, "filename": "django-absoluteuri-1.2.0.tar.gz", "has_sig": false, "md5_digest": "713b371e699dcb5fbbed18ab802c80ea", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7880, "upload_time": "2016-02-29T23:31:39", "url": "https://files.pythonhosted.org/packages/ca/b0/e6bbb5a8a6f9b2f509b21f799a017793704e16d1b069c00925ed062b5c73/django-absoluteuri-1.2.0.tar.gz" } ], "1.3.0": [ { "comment_text": "", "digests": { "md5": "b9494044d5c4cbd7d702e3c901111c58", "sha256": "2b7cb57748b4f557d2cdb1f74d6cfa197bed7f664b9c2a039094575a1b648e4a" }, "downloads": -1, "filename": "django-absoluteuri-1.3.0.tar.gz", "has_sig": false, "md5_digest": "b9494044d5c4cbd7d702e3c901111c58", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7927, "upload_time": "2018-09-04T22:25:44", "url": "https://files.pythonhosted.org/packages/da/92/eb37eaef8f099c6ceccc4e9d86629dc99a5a228ef1c9215ee66a56ee0d1c/django-absoluteuri-1.3.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "b9494044d5c4cbd7d702e3c901111c58", "sha256": "2b7cb57748b4f557d2cdb1f74d6cfa197bed7f664b9c2a039094575a1b648e4a" }, "downloads": -1, "filename": "django-absoluteuri-1.3.0.tar.gz", "has_sig": false, "md5_digest": "b9494044d5c4cbd7d702e3c901111c58", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7927, "upload_time": "2018-09-04T22:25:44", "url": "https://files.pythonhosted.org/packages/da/92/eb37eaef8f099c6ceccc4e9d86629dc99a5a228ef1c9215ee66a56ee0d1c/django-absoluteuri-1.3.0.tar.gz" } ] }