Metadata-Version: 1.1
Name: android-strings-format
Version: 0.1.0
Summary: Android Strings format
Home-page: https://github.com/KonsomeJona/android-strings-format
Author: Jonathan Odul
Author-email: contact@takohi.com
License: MIT
Download-URL: https://github.com/KonsomeJona/android-strings-format/archive/0.1.0.tar.gz
Description: # Android-Strings-Format
        
        This script takes a strings resource as a model and a second one as a target.
        It will format the target strings resource in order to keep the same tags and comments order as the model one.
        Be aware that the target strings resource will be overwritten if no output file has been specified.
        The script will also warn you if a resource is missing inside the target strings.xml file.
        
        You need to run this script inside of the res directory of your Android project.
        Example of usage: python android-strings-format.py --target fr --output formatted_strings.xml
        
        ## Usage
        
        android-strings-format.py [-h] [-m MODEL] -t TARGET
                                         [-o OUTPUT]
        
        *  -h, --help            show this help message and exit
        
        *  --model MODEL, -m MODEL
                                Language code of the strings resource to use as model.
                                If not specified, strings.xml inside the default
                                values directory will be used as the model.
        
        *  --target TARGET, -t TARGET
                                Language code of the strings resource to format
        
        *  --output OUTPUT, -o OUTPUT
                                Path to the output formatted strings resource. If not
                                specified, the target strings resource file will be
                                overwritten.
        
        ## Example
        
        Target inside values directory
        ```
        <?xml version="1.0" encoding="utf-8"?>
        
        <!--
          Copyright 2016 Jonathan Odul
          Blablablabla
        -->
        
        <resources>
            <!-- Application name -->
            <string name="app_name">APP</string>
        
            <!-- Dialog texts -->
            <string name="loading">Loading…</string>
            <string name="loading_data">Loading data…</string>
            <string name="processing">Processing…</string>
            <string name="please_wait">Please wait…</string>
        
            <!-- Dialog button texts -->
            <string name="ok">Ok</string>
            <string name="refresh">Refresh</string>
            <string name="cancel">Cancel</string>
            <string name="quit">Quit</string>
        
            <!-- Error message -->
            <string name="no_sdcard">No SD card mounted.
            \nPlease mount a sd card to use this application.</string>
        
            <!-- Modes -->
            <string-array name="modes">
                <item>Single</item>
                <item>Shuffle</item>
                <item>Repeat</item>
            </string-array>
        
            <!-- Plurals: time_minute -->
            <plurals name="time_minute">
                <item quantity="one">%1$d minute</item>
                <item quantity="other">%1$d minutes</item>
            </plurals>
        
        </resources>
        ```
        
        Model inside values-fr directory
        ```
        <?xml version="1.0" encoding="utf-8"?>
        <resources>
            <!-- Resources not formatted. What a disaster -->
            <string name="app_name">VG Music</string>
        
            <string name="loading">
                Chargement en cours…</string>
            <string name="loading_data">Chargement des données…</string>
        
            <string name="before_leaving">Avant de partir…</string>
            <string name="no_sdcard">Aucune carte SD détéctée.
            \nVeuillez obtenir une carte SD avant d\'utiliser cette application.</string>
        
            <string name="cancel">Annuler</string>
            <string name="quit">Quitter</string>
            <!-- Modes -->
        <string-array name="modes">
                <item>Simple</item>
                <item>Aléatoire</item>
                <item>Répétition</item>
            </string-array>
        
            <string name="processing">Traitement en cours…</string>
        <string name="please_wait">Veuillez patienter quelques instants…</string>
        
            <!-- Plurals: time_minute -->
            <plurals name="time_minute">
                <item quantity="one">%1$d minute</item>
                <item quantity="other">%1$d minutes</item>
            </plurals>
        
            <string name="refresh">Rafraîchir</string>
        
            <!-- To be deleted -->
            <string name="unused_resource">Omelette du fromage</string>
            </resources>
        ```
        
        Running command
        ```
        python android-strings-format.py --target fr --output formatted_strings.xml
        ```
        
        Output
        ```
        Processing with...
            model: values/strings.xml
            target: values-fr/strings.xml
        Warning: resource 'ok' does not exist inside values-fr/strings.xml
        Saved formatted strings resource to: formatted_strings.xml
        ```
        
        formatted_strings.xml
        ```
        <?xml version='1.0' encoding='UTF-8'?>
        <!--
          Copyright 2016 Jonathan Odul
          Blablablabla
        -->
        <resources>
            <!-- Application name -->
            <string name="app_name">VG Music</string>
        
            <!-- Dialog texts -->
            <string name="loading">
                Chargement en cours…</string>
            <string name="loading_data">Chargement des données…</string>
            <string name="processing">Traitement en cours…</string>
            <string name="please_wait">Veuillez patienter quelques instants…</string>
        
            <!-- Dialog button texts -->
            <string name="ok">Ok</string>
            <string name="refresh">Rafraîchir</string>
            <string name="cancel">Annuler</string>
            <string name="quit">Quitter</string>
        
            <!-- Error message -->
            <string name="no_sdcard">Aucune carte SD détéctée.
            \nVeuillez obtenir une carte SD avant d\'utiliser cette application.</string>
        
            <!-- Modes -->
            <string-array name="modes">
                <item>Simple</item>
                <item>Aléatoire</item>
                <item>Répétition</item>
            </string-array>
        
            <!-- Plurals: time_minute -->
            <plurals name="time_minute">
                <item quantity="one">%1$d minute</item>
                <item quantity="other">%1$d minutes</item>
            </plurals>
        
        </resources>
        ```
        
        Much better, right?
        
        CHANGES
        =======
        
        0.1.0 (2017-04-21)
        ------------------
        
        -  Initial release.
Keywords: android localization strings format xml values
Platform: UNKNOWN
Classifier: License :: OSI Approved :: BSD License
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
