{ "info": { "author": "Vladim\u00edr Gorej", "author_email": "gorej@codescale.net", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Web Environment", "Intended Audience :: Developers", "Intended Audience :: Information Technology", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python", "Topic :: Internet :: WWW/HTTP", "Topic :: Utilities" ], "description": "django-brevisurl\n================\n\ndjango-brevisurl is django app for shortening urls. Brevis is a latin word, which means\nshort, so the name brevisurl == shorturl or url shortener. The actual creating of short\nurl is handled by the shortening backend.\n\n\nRequirements\n------------\n\n- python 2.7+\n- django\n\n\nInstallation\n------------\n\nInstall via pypi or copy this module into your project or into your PYTHONPATH.\n\n\n**Put brevisurl into INSTALLED_APPS in your projects settings.py file**\n\n::\n\n INSTALLED_APPS = (\n 'localeurl',\n 'django.contrib.auth',\n 'django.contrib.contenttypes',\n 'django.contrib.sessions',\n 'django.contrib.sites',\n 'django.contrib.admin',\n 'django.contrib.sitemaps',\n 'web',\n 'debug_toolbar',\n 'rosetta',\n 'south',\n 'brevisurl'\n )\n\n\n\n**Run syncdb command to create database tables from brevisurl models**\n\n::\n\n python manage.py syncdb\n\n\nConfiguration\n-------------\n\n**django settings.py constants**\n\n::\n\n # Setting for default brevis backend\n BREVISURL_BACKEND = 'brevisurl.backends.local.BrevisUrlBackend' # Default is 'brevisurl.backends.local.BrevisUrlBackend'\n\n # This bypasses Django Site framework and settings.SITE_ID; if set, brevisurl don't use Django Site framework\n # but uses this settings insted to generate absolute urls\n BREVISURL_BACKEND_LOCAL_DOMAIN = 'http://brevisurl.net/' # Default is None\n\n # Characters that are used to generate tokens for local backend.\n BREVISURL_LOCAL_BACKEND_TOKEN_CHARS = list(string.ascii_letters + string.digits)\n\n # Settings for maximum length for original url (including GET query parameters)\n BREVISURL_LOCAL_ORIGINAL_URL_MAX_LENGTH = 200\n\n # Settings for token length.\n BREVISURL_LOCAL_BACKEND_TOKEN_LENGTH = 5\n\n # Settings for url pattern.\n BREVISURL_LOCAL_BACKEND_URL_PATTERN = r'^(?P[a-zA-Z0-9]{' + str(LOCAL_BACKEND_TOKEN_LENGTH) + r'})$'\n\n # Protocol for local backend.\n BREVISURL_LOCAL_BACKEND_DOMAIN_PROTOCOL = getattr(settings, 'BREVISURL_LOCAL_BACKEND_DOMAIN_PROTOCOL', 'http')\n\n\n**Append brevisurl url patterns to your urls.py at the end of module, if you're using local backend**\n\n::\n\n urlpatterns += patterns('',\n # brevisurl urls\n (r'^', include('brevisurl.urls'))\n )\n\n**To be able to access brevisurl settings add brevisurl.context_processors.brevisurl_data to your context processors**\n\n::\n\n TEMPLATE_CONTEXT_PROCESSORS = (\n 'django.contrib.auth.context_processors.auth',\n 'django.core.context_processors.debug',\n 'django.core.context_processors.request',\n 'django.contrib.messages.context_processors.messages',\n 'brevisurl.context_processors.brevisurl_data'\n )\n\n**Configure site framework**\n\nThis setting is important for local backend only. At least one Site object\nmust be created and configured as current via settings.SITE_ID. For development/production\nswitching I suggest you to use configuration like this. Setting is also important\nwhile using `absurl` templatag. Domain for absolute url is generated from current Site object.\n\n::\n \n if DEBUG:\n SITE_ID = 2 # pk for Site object containing your development domain e.g. 'localhost:8000'\n else:\n SITE_ID = 1 # pk for Site object containing your production domain e.g. 'www.production.net'\n\n\n\nExamples\n--------\n\n**Example 1**\n\nUsing programmatic approach\n\n::\n\n from brevisurl import get_connection\n\n connection = get_connection()\n short_url_obj = connection.shorten_url('http://www.codescale.net/')\n print short_url_obj.shortened_url\n\n\n**Example 2**\n\nUsing programmatic approach with shortcut\n\n::\n\n from brevisurl import shorten_url\n\n shor_url_obj = shorten_url('http://www.codescale.net/')\n print shor_url_obj.shortened_url\n\n\n**Example 3**\n\nUsing brevisurl in templates via filter approach\n\n::\n\n {% load brevisurltags %}\n {% url homepage as homepage_url %}\n {{ homepage_url|shorten_url }}\n\n\n**Example 4**\n\nUsing brevisurl in templates with filtered tag approach.\nbrevisurl comes with special tag called `absurl` that works\nexactly the same as `url` django tag but prepends protocol + domain\nin front of resovled url path.\n\n::\n\n {% load brevisurltags %}\n {% absurl homepage as homepage_url %}\n {{ homepage_url|shorten_url }}\n\n\nTests\n-----\n\n**Tested on evnironment**\n\n- Xubuntu Linux 12.04 LTS precise 64-bit\n- python 2.7.3+\n- python unittest\n- django 1.4.1\n\n**Running tests**\n\nTo run the test run command: ::\n\n $ python manage.py test brevisurl\n\n\nDevelopment setup\n-----------------\n::\n\n $ make bootstrap\n $ python manage.py test brevisurl\n\nTests\n-----\n\n**Tested on evnironment**\n\n- Linux Mint 15 Olivia 64-bit\n- python 2.7.4\n- python unitest\n\n**Running tests**\n\nTo run the tests, execute one of the following command:::\n\n $ python manage.py test brevisurl\n\nOr:::\n\n $ make test\n\n\nAuthor\n------\n\n| char0n (Vladim\u00edr Gorej, CodeScale s.r.o.)\n| email: gorej@codescale.net\n| web: http://www.codescale.net/\n\n\nReferences\n----------\n\n - http://github.com/CodeScaleInc/django-brevisurl\n - http://pypi.python.org/pypi/django-brevisurl/\n - http://www.codescale.net/en/community#django-brevisurl", "description_content_type": null, "docs_url": null, "download_url": "http://github.com/char0n/django-brevisurl/tarball/master", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://www.codescale.net/en/community#django-brevisurl", "keywords": "url short shortener", "license": "BSD", "maintainer": null, "maintainer_email": null, "name": "django-brevisurl", "package_url": "https://pypi.org/project/django-brevisurl/", "platform": "any", "project_url": "https://pypi.org/project/django-brevisurl/", "project_urls": { "Download": "http://github.com/char0n/django-brevisurl/tarball/master", "Homepage": "http://www.codescale.net/en/community#django-brevisurl" }, "release_url": "https://pypi.org/project/django-brevisurl/2.0.3/", "requires_dist": null, "requires_python": null, "summary": "django-brevisurl is django app for shortening urls", "version": "2.0.3" }, "last_serial": 3188421, "releases": { "0.9": [ { "comment_text": "", "digests": { "md5": "d0233bb14ac0b8c1ccbb6bffbd346356", "sha256": "d353d2d637fce8dc8e171b26af9af95ef82956dd61613055195712456d87b1da" }, "downloads": -1, "filename": "django-brevisurl-0.9.tar.gz", "has_sig": false, "md5_digest": "d0233bb14ac0b8c1ccbb6bffbd346356", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8645, "upload_time": "2012-05-28T13:39:33", "url": "https://files.pythonhosted.org/packages/ed/b5/78e26e6a637b9e8759e37f54ba0ad3c71c52f0fdcfedf2f3d16e9ba9f42a/django-brevisurl-0.9.tar.gz" } ], "0.9.1": [ { "comment_text": "", "digests": { "md5": "11f5fd48db1105135766eb030507fcea", "sha256": "1ec477d7d91248b106a552670d67cc8aa1553207a7c04140cf3777bfa6036353" }, "downloads": -1, "filename": "django-brevisurl-0.9.1.tar.gz", "has_sig": false, "md5_digest": "11f5fd48db1105135766eb030507fcea", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9311, "upload_time": "2012-05-29T13:17:49", "url": "https://files.pythonhosted.org/packages/0d/ce/85834c083ece21bfff84a8ee97759aeabf3a4b2a0443936eab2be4afe21c/django-brevisurl-0.9.1.tar.gz" } ], "0.9.2": [ { "comment_text": "", "digests": { "md5": "b91a8ac1361dad1451938a5737e67458", "sha256": "f80e96902d03025eda4b71426f673bcc53b1cefcb3f53c860ea30082985f4e40" }, "downloads": -1, "filename": "django-brevisurl-0.9.2.tar.gz", "has_sig": false, "md5_digest": "b91a8ac1361dad1451938a5737e67458", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9298, "upload_time": "2012-05-29T16:22:13", "url": "https://files.pythonhosted.org/packages/da/30/a8c36b70d1611c7ed326c679149631ebfb3a7058cdd277ca488797064826/django-brevisurl-0.9.2.tar.gz" } ], "0.9.3": [ { "comment_text": "", "digests": { "md5": "877a87d38c946bffd86872936a9c7eda", "sha256": "9685172fa9a2f69e23133f2c9150b94bc034633cf3bbacf9450ef8acad050d74" }, "downloads": -1, "filename": "django-brevisurl-0.9.3.tar.gz", "has_sig": false, "md5_digest": "877a87d38c946bffd86872936a9c7eda", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9396, "upload_time": "2012-05-29T17:19:11", "url": "https://files.pythonhosted.org/packages/30/5b/6fc125580830464a1c372b6db1fc776bd960aef1ad576d7c369fed120210/django-brevisurl-0.9.3.tar.gz" } ], "1.0": [ { "comment_text": "", "digests": { "md5": "479a492baa17d88c4ecf3f1d4cbee769", "sha256": "8cd6c3650c03e011ba77d5c439105183771415289d8c57368d734da3dca31499" }, "downloads": -1, "filename": "django-brevisurl-1.0.tar.gz", "has_sig": false, "md5_digest": "479a492baa17d88c4ecf3f1d4cbee769", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11612, "upload_time": "2012-09-17T13:05:40", "url": "https://files.pythonhosted.org/packages/76/be/8dab2eb45d69abe2811ed4b8c46707719e9c165bcfca99017651f99eb245/django-brevisurl-1.0.tar.gz" } ], "2.0.0": [ { "comment_text": "", "digests": { "md5": "ac037d7ad4d453be8b4fe422b3360f3f", "sha256": "f5545ca117fabcd6cc3a10da1c9e53bea7908c0e437866d314d65c7584cac7fc" }, "downloads": -1, "filename": "django-brevisurl-2.0.0.tar.gz", "has_sig": false, "md5_digest": "ac037d7ad4d453be8b4fe422b3360f3f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14354, "upload_time": "2013-12-07T11:01:48", "url": "https://files.pythonhosted.org/packages/64/ef/81c08be30f94f3f959121fca196ffcd480e13773d2c60738c5afc3c254b5/django-brevisurl-2.0.0.tar.gz" }, { "comment_text": "", "digests": { "md5": "c28ed33acf722e8728367dfbf16f88b7", "sha256": "1265de01de5d5ffc1617829d2ab091b2782f269c4a1657d17c3301ea086affd6" }, "downloads": -1, "filename": "django-brevisurl-2.0.1.tar.gz", "has_sig": false, "md5_digest": "c28ed33acf722e8728367dfbf16f88b7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12988, "upload_time": "2015-07-24T18:42:07", "url": "https://files.pythonhosted.org/packages/06/7a/f1351b54149331f976cd50f164c16899ca24fd7378d485af9941cf37fde3/django-brevisurl-2.0.1.tar.gz" } ], "2.0.1": [], "2.0.2": [ { "comment_text": "", "digests": { "md5": "bfc9208813e29998f318fbcb2ee7eb9e", "sha256": "69c9e1dec7f5f1501319429482a04f9f49d8674e0bb51b62f5f4e7a5f40572a7" }, "downloads": -1, "filename": "django_brevisurl-2.0.2-py2-none-any.whl", "has_sig": false, "md5_digest": "bfc9208813e29998f318fbcb2ee7eb9e", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 22165, "upload_time": "2015-10-19T01:55:08", "url": "https://files.pythonhosted.org/packages/6e/51/df6ccb5e5e029fb9db6eb41da6ef553fb41ecc3be9e488cac2eafb43c402/django_brevisurl-2.0.2-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2940782ed739ed7a275628fc89140a6a", "sha256": "6d3ca24e1f1cbe1697a6db559628049b17c9a7ff06ba0063ac67eb6da21870dc" }, "downloads": -1, "filename": "django-brevisurl-2.0.2.tar.gz", "has_sig": false, "md5_digest": "2940782ed739ed7a275628fc89140a6a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13021, "upload_time": "2015-10-19T01:55:01", "url": "https://files.pythonhosted.org/packages/93/31/59c210e4103e1c35a9a42373cd7c5f005f54b8fb4d6000377916bfa3fd20/django-brevisurl-2.0.2.tar.gz" } ], "2.0.3": [] }, "urls": [] }