#
# Copyright 2009 Mozilla Corporation, Zuza Software Foundation
#
# This file is part of translate.
#
# translate is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3 of the License, or
# (at your option) any later version.
#
# translate is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, see <https://www.gnu.org/licenses/>.

"""Convert PHP format .po files to Python format .po files."""

import re
from typing import overload

from translate.convert import convert
from translate.misc.multistring import multistring
from translate.storage import po


class phppo2pypo:
    def convertstore(self, inputstore):
        """
        Convert PHP store to PO.

        Converts a given .po file (PHP Format) to a Python format .po file,
        the difference being how variable substitutions work.  PHP uses a %1$s
        format, and Python uses a {0} format (zero indexed).  This method will
        convert, e.g.:

                I have %2$s apples and %1$s oranges
                    to
                I have {1} apples and {0} oranges

        This method ignores strings with %s as both languages will recognize that.
        """
        thetargetfile = po.pofile()

        for unit in inputstore.units:
            newunit = self.convertunit(unit)
            thetargetfile.addunit(newunit)
        return thetargetfile

    def convertunit(self, unit):
        developer_notes = unit.getnotes(origin="developer")
        translator_notes = unit.getnotes(origin="translator")
        unit.removenotes()
        unit.addnote(self.convertstrings(developer_notes))
        unit.addnote(self.convertstrings(translator_notes))
        unit.source = self.convertstrings(unit.source)
        unit.target = self.convertstrings(unit.target)
        return unit

    @staticmethod
    def convertstring(value: str) -> str:
        return re.sub(r"%(\d)\$s", lambda x: f"{{{int(x.group(1)) - 1}}}", value)

    @overload
    def convertstrings(self, value: str) -> str: ...

    @overload
    def convertstrings(self, value: multistring | list[str]) -> multistring: ...

    def convertstrings(self, value: multistring | list[str] | str) -> multistring | str:
        strings: list[str]
        if isinstance(value, multistring):
            strings = value.strings
        elif isinstance(value, list):
            strings = value
        else:
            return self.convertstring(value)

        result = [self.convertstring(string) for string in strings]

        return multistring(result)


def convertphp2py(inputfile, outputfile, template=None) -> bool:
    """
    Converts from PHP .po format to Python .po format.

    :param inputfile: file handle of the source
    :param outputfile: file handle to write to
    :param template: unused
    """
    convertor = phppo2pypo()
    inputstore = po.pofile(inputfile)
    outputstore = convertor.convertstore(inputstore)
    if outputstore.isempty():
        return False
    outputstore.serialize(outputfile)
    return True


def main(argv=None) -> None:
    """Converts PHP .po files to Python .po files."""
    formats = {"po": ("po", convertphp2py)}
    parser = convert.ConvertOptionParser(formats, description=__doc__)
    parser.run(argv)


if __name__ == "__main__":
    main()
