dulacp / igenstrings

Apple genstrings command on steroids by adding merging superpowers

igenstrings

Eventually, all things merge into one, and a river runs through it.

Enhance the genstrings command by adding merging capabilities
Documentation is available at https://igenstrings.readthedocs.org.

Features

• Ensure your files are encoded in UTF-8 (as recommended by Apple now)
• Takes care of runing the genstrings command on all files \*.m, \*.mm and \*.swift
• Merge the results with previous version of the Localizable.string files you may have
• Inform you if it works correctly

Installation

$ pip install igenstrings

Support

Python 2.7 Python 3.4+

Requirements

Ensure your *.strings files are UTF-8 encoded as Apple recommends it now :

It is recommended that you save strings files using the UTF-8 encoding, which is the default encoding for standard strings files. Xcode automatically transcodes strings files from UTF-8 to UTF-16 when they’re copied into the product.

Usage

$ igenstrings ./MyXcodeProjectDir

output

Running the script on path ./MyXcodeProjectDir
Excluded path regex: None
languages found : ['./MyXcodeProjectDir/en.lproj', './MyXcodeProjectDir/fr.lproj']
Job done for language: ./MyXcodeProjectDir/en.lproj
Job done for language: ./MyXcodeProjectDir/fr.lproj

Known Issues

• The Apple genstrings command doesn't like path that contains spaces. So avoid subfolders containing spaces, otherwise the Localizable.string will not be complete
• You need to respect the format used by the genstrings command unless it will breaks. So, to avoid issues use strictly the format below for each translated text. Also do not remove the line break between two fields or it will breaks too.

/* Comment for localizable string */
"Your string" = "Translated string";

/* Comment for localizable string */
"Your string #2" = "Translated string #2";

Credits

Tools used in rendering this package:

• Cookiecutter
• cookiecutter-pypackage

Contact

Pierre Dulac
@_dulacp

License

igenstrings is available under the MIT license. See the LICENSE file for more info.

igenstrings's Issues

Make it possible to save as UTF-8

Looks like Apple now recommends the use of UTF-8 for string files:

It is recommended that you save strings files using the UTF-8 encoding, which is the default encoding for standard strings files. Xcode automatically transcodes strings files from UTF-8 to UTF-16 when they’re copied into the product.

https://developer.apple.com/library/ios/documentation/Cocoa/Conceptual/LoadingResources/Strings/Strings.html

Maybe just expose the encoding parameter in the outer save() method while keeping the current default?

def save(self, output_filename, encoding='utf16'):
   with io.open(output_filename, encoding=encoding, mode='w') as f:

Merge the results ?

Hi,
The program does not merge the results for me...
My old 'Localizable.strings' is modified with string already translated.

Needs to ignore "base.lproj"

Exception: invalid file on valid UTF-8 strings file

INFO:root:Running the script on path
languages found ['/en.lproj']
iconv: /en.lproj/Localizable.strings: No such file or directory
DEBUG:root:"Czech" = "Tchèque";

DEBUG:root:2
ERROR:root:Line 2 of file '/en.lproj/Localizable.strings.old' raising the exception:
ERROR:root:Error: input files have invalid format.
Traceback (most recent call last):
File "/bin/pygenstrings-master/genstring.py", line 264, in
localize(opts.path, opts.excluded_paths)
File "/bin/pygenstrings-master/genstring.py", line 216, in localize
merge(merged, old, new)
File "/bin/pygenstrings-master/genstring.py", line 180, in merge
old = LocalizedFile(old_fname, auto_read=True)
File "/bin/pygenstrings-master/genstring.py", line 82, in init
self.read_from_file(fname)
File "~/bin/pygenstrings-master/genstring.py", line 128, in read_from_file
raise Exception('invalid file')
Exception: invalid file