[urgent] requires upgrading Transifex CLI tool about charites HOT 27 CLOSED

@ubukawa
I was removed from this repo by geolonia, I am no longer a member of this repo, also I don't have any permission to review PR. If you need a review, don't ask me again unless UNVT bring me back to the member.

I created PR #157. there is error in CI TX_TOKEN not set, skip tx pull. looks like no tx_token is registered in github repo. Could you register TX_TOKEN in secrets? migration was quite straightforward.

from charites.

Hello @JinIgarashi . Thank you very much for your contribution and letting us know.
I now have my account in Transifex, so please let me join in the project.

I am quite a newbie of this tool, but I will explore it this week.
Thank you.

from charites.

@ubukawa and @hfu, I added both of you as owner of unvt organization in transifex.

from charites.

Thank you @JinIgarashi . Now I can access the project.
Although I checked website, I could not find how I can migrate API, so I have just contacted the transifex support. I will try.

from charites.

@ubukawa it uses transifex-client v0.14.4

Looks like this library is not compatible with new API. Check pypi page.

https://pypi.org/project/transifex-client/

probably you need to use new CLI tool. There is a link (https://github.com/transifex/cli) in pypi.

You can ask other people in Geolonia to fix this issue if you are not sure how to figure out. I heard UNVT has a contract with them to maintain this repository.

from charites.

@ubukawa can you merge PR. Let’s see how CI works

from charites.

@ubukawa I created new PR. changed to use their github action intead of installing manually. hope it will work

#158

from charites.

@ubukawa I saw CI is failing. Looks like your set token having issues. Could you fix CI?

from charites.

@ubukawa CI looks working now. Please close the issue if you confirm

from charites.

Dear @JinIgarashi ,

I contacted transfex and here is the list of endpoints that needs update.

I do not have any idea how I can replace them.
Do you know how we can replace them?
I am not sure which file I should edit.

Thank you very much for your kind advice.

from charites.

@ubukawa, @hfu could you fix transifex CI as soon as possible. I am receiving alert notifications by email everyday and it’s very annoying.

if you can’t figure out soon, could you delete CI, please? Or you can completely delete documentation from this repository if UN open GIS will never want to maintain them.

from charites.

Dear @JinIgarashi ,
Thank you for your message.
I am sorry that I was stuck on updating CI. I will try again.

I am trying to upgrade the "transifex-client" package in docs/pipefile.
As I only see config file in docs/.tx, I could not find where you installed transifex/cli in unvt/charites.
Can you advise where you installed CI, if possible?

I wonder why alert notification email does not come to me as I am also a manager of charites-docs in transifex...

Thank you.
My sincere apology for a number of alert notifications.

from charites.

@ubukawa it is because CI still uses api token generated by my account. Could you kindly generate your own token and replace TX_TOKEN secret in setting page?

from charites.

@ubukawa transifex-client was installed in pipenv. You can delete transifex-client from pipenv, and install new client library in github action. I don't think there is python package which can handle new API

from charites.

Thank you @JinIgarashi .
I do not see any menu to replace the token in the setting page of "charites-docs" project in transifex.
Can you kindly check it?

If there is no python package that can handle with the new API of transifex, I think we can disable it for the time being.
(Until we have the tool, we can use only sphinx to update/manage our English documents.)
What do you think?

If so, we may need to edit build.yml and build-docs.yml, and we would also ask other contributors to see if they are okay with it.
Thank you for your kind advice!

from charites.

@ubukawa for new API client, please refer my previous comment. You should install transifex client in CI itself.

#153 (comment)

please look this to generate token.

https://help.transifex.com/en/articles/6248858-generating-an-api-token

from charites.

Thank you!
I did generate my token, but the issue was that I was not sure where I can replace the token. Now, I found it and successfully replaced.

I am not so good at python as I do not often use it, but let me try with pipfile.

I realized that we have an alert everyday because we run build-docs.yml everyday. At least, by reducing the frequency of the update, we can reduce the alert immediately.
Once we update CLI, we can go back to the original update frequency.

from charites.

Now, I somehow understand the issue.

• We have used Sphinx (for documentation) and Transifex (for multilingual) for the documentation.
• Transifex updated its API, but our tool (transifex-client) no longer supports the latest Transifex API. Every time we run the build-doc.yml, there is an alert.

Here, I think we technically have two options:

• Develop alternative function/workflow with other tool like transifex/cli
• Or, we can just suspend the link to the multilingual part. (And I replaced the Transifex Token with mine)

Within my ability, the first option would be difficult.
So, I prefer the second option, but I may need to share the situation with colleagues.

from charites.

Dear @JinIgarashi ,

I have replaced the TX_Token, but I have not receive any alert so far.
Can you check if you still receive them?

In addition, I would like to propose a minor change in build-docs.yml.
Please approve the following PR? Thank you!

#155

from charites.

Dear @JinIgarashi ,
Thank you for letting me know. Oh, I see. TX_TOKEN is notworking.

I will register it again.
(number + "/" part may not be necessary in transifex token...)

from charites.

Dear @JinIgarashi ,
Thank you! I have merged PR. Thank you!

from charites.

@ubukawa thanks for merging. I saw CI failed.
https://github.com/unvt/charites/actions/runs/4408165680/jobs/7722854078

from charites.

Yes, indeed. I have just seen it. Do you have any advice if you have any?

from charites.

@ubukawa i saw GitHub actions failed

from charites.

https://github.com/opengisch/QField-docs/blob/master/.github/workflows/gh-pages.yml

Maybe we can follow their CI

from charites.

Thank you @JinIgarashi ! I have pasted my token again.

from charites.

Thank you @JinIgarashi !

I moved from New York to Tsukuba in the end of March and I am sorry for the delay in my response.
I have not yet established the working einvironment here, but I will close this issue once I confirm.

Thank you very much for your contirubution!

from charites.