OpenStack-I18n

Download

openstack-i18n@lists.openstack.org

July 2025

1 participants
2 discussions

[i18n] Sharing CMU Students’ Contributions: Progress on Zanata-to-Weblate Migration
by Ian Y. Choi 29 Jul '25

29 Jul '25

Dear OpenStack Community, Over the past six weeks, Seongsoo and I had the privilege of mentoring a group of four students from Carnegie Mellon University (CMU) [1] as part of our ongoing effort to migrate the OpenStack Internationalization (I18n) platform from Zanata to Weblate. I would like to take this opportunity to highlight the significant and meaningful contributions made by three students, Furqan Saeed, Simon Yu, and Jana Hussien, who recently completed video demos showcasing their work [2] [3]. Project Context As many may know, the I18n SIG has been working to modernize our translation infrastructure by transitioning from Zanata (now unmaintained) to Weblate — an actively developed, open source platform. This project not only ensures the sustainability of our translations, but also offers a valuable learning path for new contributors. Below are the key outcomes achieved by Furqan, Simon and Jana: 1. i18n tools script test codes for Weblate (by Furqan Saeed & Simon Yu) Furqan and Simon focused on bringing robust, production-quality unit testing to the collection of Python scripts and tools responsible for Weblate integration. Furqan’s video [2] demonstrates these efforts. Together, they: Developed a comprehensive suite of ~34 unit tests covering the main Weblate tool files. Used Python’s unittest and mocking strategies to ensure functions behave as expected, even simulating server responses. Noted and addressed gaps in requirements, such as missing library dependencies. Provided clear documentation (README.rst) explaining test infrastructure and file structure. Gained and demonstrated familiarity with OpenStack’s development guidelines, Gerrit workflows, and CI requirements. Their efforts establish a much needed test baseline for future improvements and bring our I18n tooling closer to OpenStack’s best practices. This contribution not only enhances software reliability but also creates a safer, more efficient environment for future contributors. 2. Migration of Zuul infrastructure scripts to Weblate (by Jana Hussien) Jana concentrated on migrating and refactoring the automation scripts that enable daily translation updates in Zuul, shifting from Zanata to Weblate. Her work involved: Analyzing and translating the logic in current scripts to ensure seamless migration, including first-time migration routines for new projects. Developing new scripts to automate creation of Weblate components and upload of translation templates (POT) and PO files; handling language code transformations between platforms. Troubleshooting integration challenges between Weblate’s API/CLI and OpenStack workflows, identifying and overcoming tricky configuration issues related to version control structure. Successfully demonstrating the migration workflow for projects such as trove-dashboard and horizon, with detailed documentation of results. Improving operational resilience by implementing enhanced error handling and summary reporting in the scripts. Discovering and addressing several issues during live testing, and documenting workarounds and plans for future improvements. Jana has also outlined next steps, including integrating these scripts further into the Zuul pipeline, modularizing code, and enhancing public documentation. These contributions represent valuable progress toward a full, sustainable migration to Weblate - benefiting the entire OpenStack community by advancing our translation workflows and broadening global accessibility. On behalf of all mentors (myself, Seongsoo Cho, Goutham Pacha Ravi), I’d like to thank Furqan, Simon, and Jana for their hard work, dedication, and collaborative spirit, and encourage other students and new contributors to get involved. If anyone would like to review their code, documentation, or get involved in this effort, please feel free to reach out or interact directly with their contributions [6-9]! Best regards, Ian Y. Choi (ianychoi) & Seongsoo Cho (seongsoocho) OpenStack I18n SIG & Student Mentors [1] https://lists.openstack.org/archives/list/openstack-discuss@lists.openstack… [2] Video - OpenStack I18n Zanata-to-Weblate Migration: Weblate Tools Unit Test Development (CMU Project Demo) (Furqan), link: https://youtu.be/w966IpBCqeE [3] Video - OpenStack I18n Zanata-to-Weblate Migration: Translation Scripts working on Zuul (CMU Project Demo) (Jana), link: https://youtu.be/RcQweOe-vfo [4] Photo of our kick off meeting: https://photos.app.goo.gl/QhNwBusFZjwvTBzi7 [5] Photos of our final mentoring meeting: Final Mentoring Meeting - https://1drv.ms/f/c/6cc85a64cb418204/EljY3AfrnypGrF6EyDZq83MBDZpLTPt-8VPymj… [6] https://review.opendev.org/c/openstack/i18n/+/953745 (by Furqan, review is welcome) [7] https://review.opendev.org/c/openstack/i18n/+/955982 (by Simon, review is welcome) [8] https://review.opendev.org/c/openstack/i18n/+/955439 (by Jana, working in progress) [9] https://review.opendev.org/c/openstack/trove-dashboard/+/952787 (by Jana, merged)

1 0

Re: [i18n][infra][horizon] Zanata translation job failures after Python 3.8 deprecation
by Ian Y. Choi 10 Jul '25

10 Jul '25

(+openstack-i18n mailing list) Hi all, I’d like to provide a brief update regarding the translation sync issue on Horizon and its plugins. It appears that the problem has been resolved through the patch at https://review.opendev.org/c/openstack/project-config/+/954370. Fortunately, Java 8 seems to be supported on Ubuntu Noble, which helped address the compatibility concerns. Separately, the progress of the Weblate migration is currently being accelerated through the mentoring program. For more details, you can refer to the ongoing updates at https://etherpad.opendev.org/p/2025-July-I18n-Weblate-Migration-Progress . Thank you to everyone who continues to support I18n efforts. /Ian On Sun, Jan 19, 2025 at 11:33 PM Ian Y. Choi <ianyrchoi(a)gmail.com> wrote: > > Thank you for sharing the current situation accurately and providing > suggestions regarding the translation sync issues. > > Due to continuous requests for translation updates while Horizon > updates were pending, I took the initiative to execute the translation > infrastructure sync script locally. > > Following your suggestions, I successfully ran the sync in a local > container environment and uploaded the proposal patch [1]. Detail > commands are pasted as [2]. > > Given that the Weblate migration is still in progress [3], I believe > it would be beneficial to discuss how we can potentially incorporate > the approach into the current infrastructure sync process in future > discussions. > > I understand this is a temporary solution while we work towards > completing the Weblate migration. > > The container-based approach has proven effective for our immediate > needs, and I appreciate your guidance on this matter. > > Thank you, > > /Ian > > [1] https://review.opendev.org/c/openstack/horizon/+/939607 > [2] https://paste.opendev.org/show/b6v9BODjraT8Heie2xW4/ > [3] https://meetings.opendev.org/meetings/openstack_i18n_meeting/2025/ > > On Wed, Oct 30, 2024 at 8:36 AM Clark Boylan <cboylan(a)sapwetik.org> wrote: > > > > On Tue, Oct 29, 2024, at 2:48 PM, Ian Y. Choi wrote: > > > Hi all, > > > > > > During last week's PTG, the I18n SIG identified Zanata translation job > > > failures for Horizon (and likely related plugins). The root cause > > > appears to be Python 3.8 deprecation on Horizon [1]. > > > > > > Failed jobs have been observed on Zuul [2], and translation proposals > > > were made on Gerrit [3]. > > > > > > Since translation sync on Horizon stable branches is functioning > > > correctly, the error message seems to be related to Python 3.8 > > > deprecation: > > > ERROR: Cannot install -r doc/requirements.txt (line 3) due to > > > conflicting package version dependencies. > > > > > > To address this, I'd like to raise two points: > > > > > > 1/ To resolve the issue, would you support updating translation sync > > > jobs with Bionic-based Zuul jobs by either upgrading to Jammy or > > > modifying the Bionic image to support Python >3.8? > > > > The problem with updating the translation sync jobs to Jammy or newer is that the Zanata client requires Java 8 which isn't available on those newer platforms. We can either satisfy the Python requirements or the Java requirements but not both at the same time with extra work. As has been mentioned elsewhere, completing the migration to Weblate removes the need for Zanata client and we can move on from this old platform. > > > > Some ideas on how we might workaround this issue while continuing to use Zanata include: running Zanata client from a container image with the right version of Java installed, or as you suggest installing a newer version of Python on Bionic. We could potentially use the `ensure-python` zuul-jobs role with `python_use_pyenv` set to true and `python_version` set to 3.11 or similar. That would build the newer python version from source on the older platform. We did this with Python 3.12 to get early tests running and it seemed to work. > > > > The problem with these approaches are that they too require work when we could instead focus on completing the Weblate migration. > > > > > > > > 2/ At least me from I18n SIG acknowledges that recognizing these > > > translation job errors was delayed. Moving forward, would it be > > > beneficial to implement periodic (e.g., monthly) reporting on > > > translation job successes and failures? > > > > > > > > > Thank you, > > > > > > /Ian > > > > > > [1] > > > https://docs.openstack.org/releasenotes/horizon/2024.2.html#upgrade-notes > > > [2] > > > https://zuul.opendev.org/t/openstack/builds?job_name=propose-translation-up… > > > [3] > > > https://review.opendev.org/q/owner:proposal-bot+project:openstack/horizon+b…

1 0