translate-projects-django 0.0.2__tar.gz

translate-projects-django-0.0.2/MANIFEST.in

@@ -0,0 +1,2 @@
+include README.md
+include LICENSE

translate-projects-django-0.0.2/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.1
+Name: translate-projects-django
+Version: 0.0.2
+Summary: Translate your django templates easily
+Home-page: https://github.com/translate-projects/translate-projects-django
+Author: Neider Ruiz
+Author-email: contact@neiderruiz.com
+License: MIT
+Platform: UNKNOWN
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 3.0
+Classifier: Framework :: Django :: 3.1
+Classifier: Framework :: Django :: 3.2
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# Translate Projects Django
+
+Effortlessly manage and automate the translation of your Django-based projects with Translate Projects Django. This powerful package streamlines the process of translating your Django templates and messages, making it easier than ever to reach a global audience. Whether you're working on an open-source project or a private enterprise application, Translate Projects Django ensures that your application is ready for internationalization with minimal effort.
+
+[See documentation](https://translateprojects.neiderruiz.com/docs/python/django)
+
+## Features
+
+- **Easy Integration**: Seamlessly integrate with your existing Docusaurus project.
+- **Multi-language Support**: Translate your documentation into multiple languages effortlessly.
+- **Customizable**: Tailor the translation process to fit your project's needs.
+- **Open Source**: Free to use and open to contributions.
+
+
+## Support
+
+If you have any questions, need help, or want to contribute, feel free to reach out:
+
+- **Website**: [neiderruiz.com](https://neiderruiz.com)
+- **GitHub**: [@neiderruiz](https://github.com/neiderruiz)
+- **Twitter**: [@neiderruiz](https://x.com/neiderruiz_)
+- **YouTube**: [Neider Ruiz](https://youtube.com/@neiderruiz)
+
+
+## Support the Project
+
+If you find this project useful, consider buying me a coffee to help me keep improving it. Your support means a lot! ☕
+
+[![Buy me a coffee](https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20coffee&emoji=☕&slug=neiderruiz&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff)](https://www.buymeacoffee.com/neiderruiz)
+

translate-projects-django-0.0.2/README.md

@@ -0,0 +1,29 @@
+# Translate Projects Django
+
+Effortlessly manage and automate the translation of your Django-based projects with Translate Projects Django. This powerful package streamlines the process of translating your Django templates and messages, making it easier than ever to reach a global audience. Whether you're working on an open-source project or a private enterprise application, Translate Projects Django ensures that your application is ready for internationalization with minimal effort.
+
+[See documentation](https://translateprojects.neiderruiz.com/docs/python/django)
+
+## Features
+
+- **Easy Integration**: Seamlessly integrate with your existing Docusaurus project.
+- **Multi-language Support**: Translate your documentation into multiple languages effortlessly.
+- **Customizable**: Tailor the translation process to fit your project's needs.
+- **Open Source**: Free to use and open to contributions.
+
+
+## Support
+
+If you have any questions, need help, or want to contribute, feel free to reach out:
+
+- **Website**: [neiderruiz.com](https://neiderruiz.com)
+- **GitHub**: [@neiderruiz](https://github.com/neiderruiz)
+- **Twitter**: [@neiderruiz](https://x.com/neiderruiz_)
+- **YouTube**: [Neider Ruiz](https://youtube.com/@neiderruiz)
+
+
+## Support the Project
+
+If you find this project useful, consider buying me a coffee to help me keep improving it. Your support means a lot! ☕
+
+[![Buy me a coffee](https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20coffee&emoji=☕&slug=neiderruiz&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff)](https://www.buymeacoffee.com/neiderruiz)

translate-projects-django-0.0.2/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"

translate-projects-django-0.0.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

translate-projects-django-0.0.2/setup.py

@@ -0,0 +1,36 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="translate-projects-django",
+    version="0.0.2",
+    author="Neider Ruiz",
+    author_email="contact@neiderruiz.com",
+    description="Translate your django templates easily",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/translate-projects/translate-projects-django",
+    packages=find_packages(),
+    license="MIT",
+    classifiers=[
+        "Development Status :: 3 - Alpha",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Framework :: Django",
+        "Framework :: Django :: 3.0",
+        "Framework :: Django :: 3.1",
+        "Framework :: Django :: 3.2",
+    ],
+    python_requires=">=3.7",
+    install_requires=[
+        "Django>=3.0",
+        "polib>=1.2.0",
+    ],
+)

translate-projects-django-0.0.2/translate_projects_django/api_utils.py

@@ -0,0 +1,32 @@
+import requests
+from django.conf import settings
+
+def get_translations_from_api(data, source_lang, target_lang, route_file):
+    url_api = f'https://translateprojects.neiderruiz.com/api/general_translations/?source_lang={source_lang}&target_lang={target_lang}'
+    
+    if route_file:
+        url_api += f"&route_file={route_file}"
+    
+    url_api += '&type_project=django'
+
+    token = settings.TRANSLATEFILES_API_TOKEN
+
+    if token:
+        token = f"Token {token}"
+
+    response = requests.post(
+        url_api,
+        json=data,
+        headers={
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+            'Authorization': token,
+        }
+    )
+    if response.status_code == 524:
+        get_translations_from_api(data, source_lang, target_lang, route_file)
+
+    if response.status_code != 200 and response.status_code != 524:
+        raise Exception(f"Error on updating translation data: {response.status_code}")
+    
+    return response.json()

translate-projects-django-0.0.2/translate_projects_django/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class DjangoTranslateFilesConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'translate_projects_django'

translate-projects-django-0.0.2/translate_projects_django/hash_utils.py

@@ -0,0 +1,34 @@
+import hashlib
+
+def base36_encode(number: int) -> str:
+    """
+    Encodes a number into a Base36 string.
+    Args:
+        number (int): The number to encode.
+    Returns:
+        str: The Base36 encoded string.
+    """
+    chars = "0123456789abcdefghijklmnopqrstuvwxyz"
+    result = ""
+    while number:
+        number, i = divmod(number, 36)
+        result = chars[i] + result
+    return result or "0"
+
+def generate_short_hash(text: str, length: int = 15) -> str:
+    """
+    Generates a short hash for a given text using SHA-256 and Base36 encoding.
+    Args:
+        text (str): The text to hash.
+        length (int): The length of the generated hash (default is 15).
+    Returns:
+        str: The short Base36 hash.
+    """
+    # Generate SHA-256 hash from the text
+    hash_bytes = hashlib.sha256(text.encode()).digest()
+    # Convert the hash to an integer
+    hash_int = int.from_bytes(hash_bytes, 'big')
+    # Convert the integer to Base36
+    base36_hash = base36_encode(hash_int)
+    # Return a shorter portion of the hash
+    return base36_hash[:length]  # Adjust the length here if needed

translate-projects-django-0.0.2/translate_projects_django/manage_translations.py

@@ -0,0 +1,61 @@
+from django.core.management import call_command
+from .translation_utils import generate_new_file_po
+from .api_utils import get_translations_from_api
+from .hash_utils import generate_short_hash
+from django.conf import settings
+import polib
+import os
+
+def make_recreate_json(original_translations, data_result_translations):
+    recreate_json = {}
+    for key, value in original_translations.items():
+        simple_hash = generate_short_hash(key)
+        
+        if simple_hash in data_result_translations.keys():
+            recreate_json[key] = data_result_translations[simple_hash]
+            continue
+    return recreate_json
+
+def generate_translations(self, target_lang, locale_dir):
+    default_language = settings.LANGUAGE_CODE
+
+    # Start
+    self.stdout.write(self.style.SUCCESS(f"\n🚀 Starting translation generation for language: {target_lang}"))
+
+    # Step 1: Generate files .po
+    self.stdout.write(self.style.WARNING(f"  Step 1: Generating .po file for '{target_lang}'..."))
+    
+    call_command('makemessages', locale=[target_lang], verbosity=0)
+    
+    self.stdout.write(self.style.SUCCESS(f"    ✔ .po file generated for '{target_lang}'"))
+
+    # Step 2: Read File .po
+    po_file_path = os.path.join(locale_dir, default_language, 'LC_MESSAGES', 'django.po')
+    
+    po = polib.pofile(po_file_path)
+    self.stdout.write(self.style.SUCCESS(f"    ✔ .po file read successfully (entries: {len(po)}))"))
+    
+    original_translations = {entry.msgid: entry.msgstr for entry in po}
+    
+    translations = {
+        generate_short_hash(entry.msgid): entry.msgid
+        for entry in po
+    }
+    
+    self.stdout.write(self.style.SUCCESS(f"    ✔ Hashed translations generated (total: {len(translations)}))"))
+
+    # Step 2: Get translations from API
+    self.stdout.write(self.style.WARNING(f"  Step 2: get translations for '{target_lang}'..."))
+    data_result_translations = get_translations_from_api(translations, default_language, target_lang, f"{default_language}-django.po")
+    self.stdout.write(self.style.SUCCESS(f"    ✔ Translations get (received: {len(data_result_translations)}))"))
+
+    # Step 5: Recreate translations
+    recreate_json = make_recreate_json(original_translations, data_result_translations)
+
+    # Paso 3: Generate new translations file
+    self.stdout.write(self.style.WARNING(f"  Step 3: Generating new translations file for '{target_lang}'..."))
+    generate_new_file_po(po, target_lang, recreate_json, locale_dir)
+    self.stdout.write(self.style.SUCCESS(f"    ✔ New .po file generated for '{target_lang}'"))
+
+    # Finish
+    self.stdout.write(self.style.SUCCESS(f"\n🎉 Successfully completed translation generation for '{target_lang}' ✅\n"))

translate-projects-django-0.0.2/translate_projects_django/management/commands/translate.py

@@ -0,0 +1,64 @@
+from django.core.management.base import BaseCommand
+from django.conf import settings
+import subprocess
+from django.core.management import call_command
+import polib
+import json
+import os
+import requests
+from translate_projects_django.manage_translations import generate_translations
+
+class Command(BaseCommand):
+    help = "Translate the project for a specific language or all languages."
+
+    def add_arguments(self, parser):
+        # Add an optional argument for the locale
+        parser.add_argument(
+            '--locale', 
+            type=str, 
+            help='Specific language to translate, e.g., "ko" for Korean.'
+        )
+
+    def handle(self, *args, **kwargs):
+        # Get the i18n configurations
+        languages = settings.LANGUAGES
+        default_language = settings.LANGUAGE_CODE
+        locale_dir = settings.LOCALE_PATHS[0]
+        
+        # Get the locale argument
+        locale_param = kwargs.get('locale')
+        
+        # Generate translations for the default language ('es' in this case)
+        generate_translations(self, 'es', locale_dir)
+        
+        if locale_param:
+            # Check if the provided locale is valid
+            if locale_param not in dict(languages):
+                self.stdout.write(self.style.ERROR(f"The language '{locale_param}' is not valid."))
+                self.stdout.write(self.style.ERROR(f"Available languages: {', '.join([lang[0] for lang in languages])}"))
+                self.stdout.write(self.style.ERROR(f"You can add the language in the settings.py file under LANGUAGES=[...]"))
+                return
+
+            # Warn if the locale is the same as the default language
+            if locale_param == default_language:
+                self.stdout.write(self.style.WARNING(f"The language '{locale_param}' is not translated, as the default language '{default_language}' has already been translated."))
+                return
+
+            # Translate for the specific locale
+            self.stdout.write(self.style.SUCCESS(f"\n🚀 Translating for language: {locale_param}"))
+            generate_translations(self, locale_param, locale_dir)
+            self.stdout.write(self.style.SUCCESS(f"\n🎉 Translation generation for '{locale_param}' completed successfully ✅\n"))
+
+            # Compile messages
+            self.stdout.write(self.style.WARNING(f"\n🛠 Compiling messages..."))
+            call_command('compilemessages')                
+            return
+
+        # If no specific locale is passed, generate translations for all languages except the default language
+        for code, name in languages:
+            if code != default_language:
+                generate_translations(self, code, locale_dir)
+
+        # Compile messages after translations are generated for all languages
+        self.stdout.write(self.style.WARNING(f"\n🛠 Compiling messages for all languages..."))
+        call_command('compilemessages')

translate-projects-django-0.0.2/translate_projects_django/translation_utils.py

@@ -0,0 +1,31 @@
+import polib
+import os
+
+def generate_new_file_po(current_po, language, recreate_json, locale_dir):
+    # Create a new .po file
+    new_po = polib.POFile()
+
+    # Add metadata to the .po file
+    new_po.metadata = {
+        'Project-Id-Version': '1.0',
+        'Content-Type': 'text/plain; charset=utf-8',
+        'Content-Transfer-Encoding': '8bit',
+        'Language': language,
+    }
+
+    # Copy entries from the original file
+    new_po.extend(current_po)
+
+    # Update msgstr of entries with the data from recreate_json
+    for entry in current_po:
+        if entry.msgid in recreate_json:
+            entry.msgstr = recreate_json[entry.msgid]
+
+    # Create the necessary directories for the new file
+    new_po_file_path = os.path.join(locale_dir, language, 'LC_MESSAGES', 'django.po')
+    os.makedirs(os.path.dirname(new_po_file_path), exist_ok=True)
+
+    # Save the .po file with the updates
+    new_po.save(new_po_file_path)
+
+    return new_po

translate-projects-django-0.0.2/translate_projects_django.egg-info/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.1
+Name: translate-projects-django
+Version: 0.0.2
+Summary: Translate your django templates easily
+Home-page: https://github.com/translate-projects/translate-projects-django
+Author: Neider Ruiz
+Author-email: contact@neiderruiz.com
+License: MIT
+Platform: UNKNOWN
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 3.0
+Classifier: Framework :: Django :: 3.1
+Classifier: Framework :: Django :: 3.2
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# Translate Projects Django
+
+Effortlessly manage and automate the translation of your Django-based projects with Translate Projects Django. This powerful package streamlines the process of translating your Django templates and messages, making it easier than ever to reach a global audience. Whether you're working on an open-source project or a private enterprise application, Translate Projects Django ensures that your application is ready for internationalization with minimal effort.
+
+[See documentation](https://translateprojects.neiderruiz.com/docs/python/django)
+
+## Features
+
+- **Easy Integration**: Seamlessly integrate with your existing Docusaurus project.
+- **Multi-language Support**: Translate your documentation into multiple languages effortlessly.
+- **Customizable**: Tailor the translation process to fit your project's needs.
+- **Open Source**: Free to use and open to contributions.
+
+
+## Support
+
+If you have any questions, need help, or want to contribute, feel free to reach out:
+
+- **Website**: [neiderruiz.com](https://neiderruiz.com)
+- **GitHub**: [@neiderruiz](https://github.com/neiderruiz)
+- **Twitter**: [@neiderruiz](https://x.com/neiderruiz_)
+- **YouTube**: [Neider Ruiz](https://youtube.com/@neiderruiz)
+
+
+## Support the Project
+
+If you find this project useful, consider buying me a coffee to help me keep improving it. Your support means a lot! ☕
+
+[![Buy me a coffee](https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20coffee&emoji=☕&slug=neiderruiz&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff)](https://www.buymeacoffee.com/neiderruiz)
+

translate-projects-django-0.0.2/translate_projects_django.egg-info/SOURCES.txt

@@ -0,0 +1,19 @@
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+translate_projects_django/__init__.py
+translate_projects_django/api_utils.py
+translate_projects_django/apps.py
+translate_projects_django/hash_utils.py
+translate_projects_django/manage_translations.py
+translate_projects_django/translation_utils.py
+translate_projects_django.egg-info/PKG-INFO
+translate_projects_django.egg-info/SOURCES.txt
+translate_projects_django.egg-info/dependency_links.txt
+translate_projects_django.egg-info/requires.txt
+translate_projects_django.egg-info/top_level.txt
+translate_projects_django/management/__init__.py
+translate_projects_django/management/commands/__init__.py
+translate_projects_django/management/commands/translate.py
+translate_projects_django/migrations/__init__.py

translate-projects-django-0.0.2/translate_projects_django.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

translate-projects-django-0.0.2/translate_projects_django.egg-info/requires.txt

@@ -0,0 +1,2 @@
+Django>=3.0
+polib>=1.2.0

translate-projects-django-0.0.2/translate_projects_django.egg-info/top_level.txt

@@ -0,0 +1 @@
+translate_projects_django