The Phrase Strings Client is available for all major platforms and lets you access all API endpoints as well as easily sync your locale files between your source code and Phrase.
Phrase Strings is a translation management platform for software projects. You can collaborate on language file translation with your team or order translations through our platform. The API allows you to import locale files, download locale files, tag keys or interact in other ways with the localization data stored in Phrase Strings for your account.
This CLI client was generated by the OpenAPI Generator project.
-
API version: 2.0.0
-
Package version: 2.27.0
-
Build package: org.openapitools.codegen.languages.GoClientCodegen
For more information, please visit https://developers.phrase.com/api/
This quick start will guide you through the basic steps to get up and running with the Phrase Strings Client.
Download and install the client for your platform. See our detailed installation guide for more information.
If you use homebrew, we have provided a tap to make installation easier on Mac OS X:
brew install phrase-cli
The tap is linked to our Formula collection and will be updated, when you call brew update as well.
Initialize your project by executing the init command. This lets you define your preferred locale file format, source files and more.
$ cd /path/to/project
$ phrase init
When using the US datacenter you need to provide a different API host:
$ phrase init --host https://api.us.app.phrase.com/v2
Use the push command to upload your locale files from your defined sources:
$ phrase push
Use the pull command to download the most recent locale files back into your project according to your targets:
$ phrase pull
You can also use phrase through a docker image, without installing the cli on your computer.
$ docker run --rm phrase/phrase-cli:2.27.0 help
Some commands are interactive and require the -it flag.
$ docker run -it phrase/phrase-cli:2.27.0 init
Commands that need to read the config file and write locale files can mount a directory.
$ docker run --volume $(pwd):/code --workdir /code --rm phrase/phrase-cli:2.27.0 pull
You can also use the docker image as base for more complex images.
To see a list of all available commands, simply execute:
$ phrase
To see all supported options for a command, simple use the --help flag:
$ phrase locales list --help
See our detailed guides for in-depth instructions on how to use the Phrase Strings Client.
This tool and it's source code are auto-generated from templates that run against a API specification file. Therefore we can not accept any pull requests in this repository. Please use the GitHub Issue Tracker to report bugs.
phrase-client is licensed under MIT license. (see LICENSE)
Parts of phrase-client use third party libraries which are vendored and licensed under different licenses
Please contact support@phrase.com and we can take more direct action toward finding a solution.