This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A Django URL shortening app

Project Description

A URL shortening app written in Django.

Shortened URLs will work at either shorty.example.com/short-url or short-url.shorty.example.com (i.e. the short path can either be in the URL, or a subdomain).

Quick Start

Get started with Shorty by following these steps:

  • Install djshorty with pip:

    pip install djshorty
    
  • Add shorty to your INSTALLED_APPS in settings.py:

    INSTALLED_APPS = (
        ...
        'shorty',
        ...
    )
    
  • Either set short.urls as your ROOT_URLCONF, or include it in your own urls.py.

  • Shorty relies on django-autoconfig, which requires the following at the end of settings.py:

    from django_autoconfig.autoconfig import configure_settings
        configure_settings(globals())
    

Settings

Shorty provides the following settings:

  • SHORTY_EXTERNAL_FLAG: If Shorty is deployed in a corporate environment, and you want the ability for some short URLs to resolve outside the company and others to remain internal, set this to True. URLs not marked as ‘external’ will require authentication. This is designed to work with a Single Sign On solution.
  • SHORTY_CANONICAL_DOMAIN: Set this to normalise the domain before redirection. This is useful if you have multiple domains, but the SSO system (see above) requires a single domain to work. For example, if Shorty is primarily deployed at https://shorty.example.com/<short-url>, but you also allow short URLs to resolve at https://<short-url>.shorty.example.com, you may need to set this to 'https://shorty.example.com'. It should include the scheme (http or https), and not end with a trailing slash.

Contributing

To contribute, fork the repo, do your work, and issue a pull request. We ask that contributors adhere to PEP8 standards, and include full tests for all their code.

Release History

Release History

This version
History Node

0.5.2

History Node

0.5.1

History Node

0.5.0

Download Files

Download Files

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
djshorty-0.5.2-py2-none-any.whl (13.7 kB) Copy SHA256 Checksum SHA256 py2 Wheel Aug 3, 2016
djshorty-0.5.2-py3-none-any.whl (13.7 kB) Copy SHA256 Checksum SHA256 py3 Wheel Aug 3, 2016
djshorty-0.5.2.tar.gz (12.7 kB) Copy SHA256 Checksum SHA256 Source Aug 3, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting