This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

Django World Languages (DWL) provides you with language related models:

  • Language
  • Family - Both ISO 639-5 and Glottolog language families
  • Dialect - Slightly different dictions and pronunciations of languages
  • LexicalSimilarity - Similarities between languages

and language metadata:

  • UsedIn - Maps languages to countries they are spoken in
  • Characteristic - Common characteristics of languages (word type orders, number of speech sounds, subject/verb/object order, syllable patterns)
  • Script and ScriptStyle - Characters that are used in languages
  • DevelopmentNote - Development statuses of languages (tags, Bible translations, literacy rates)

Installation

  1. Install it with pip:

    pip install django-world-languages
    
  2. Add world_languages to the INSTALLED_APPS variable in your project’s settings.py file:

    INSTALLED_APPS = [
        # ...
        'world_languages',
        # ...
    ]
    
  3. Create the database tables:

    python manage.py migrate world_languages
    

Configuration

All configuration options should be specified in the LANGUAGE_SETTINGS variable in your project’s settings.py file.

  • PLUGINS - You can specify your own functions to run before and after a language is created. This should be specified as a dictionary mapping signal names to your custom function in dotted-module notation.

    Example

    LANGUAGE_SETTINGS = {
        'PLUGINS': {
            'pre_language': 'custom_app.utils.function_name'
        },
        # ...
    }
    
  • FILES - You can also specify your own URLs where files are hosted.

    Example

    LANGUAGE_SETINGS = {
        # ...
        'FILES': {
            'language': {
                'filename': 'iso-languagecodes.txt',
                'urls': [url_bases['geonames']['dump'] + '{filename}'],
                'fields': [
                    'iso639-3',
                    'iso639-2',
                    'iso639-1',
                    'name',
                ]
            },
            'glottolog': {
                'filename': 'languages.yaml',
                'urls': [url_bases['glottolog']['languoids'] + '{filename}'],
            }
        }
    }
    

Import Data

Once you have created the models and adjusted the settings to your liking, you will need to import data into your database with the provided world_languages management command:

python manage.py world_languages --import=all

TODO

  • Tests
  • Add import signals for all models, not just Language

Reporting Bugs

This package uses regexes to parse downloaded YAML, HTML, and text files from Glottolog, Wikipedia, and Geonames. If you find a bug, especially in the import script, please open an issue on Github.

Release History

Release History

0.1

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-world-languages-0.1.tar.gz (53.8 kB) Copy SHA256 Checksum SHA256 Source May 25, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development 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