Awesome
CLI v2 client for phrase
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.33.1
-
Build package: org.openapitools.codegen.languages.GoClientCodegen
For more information, please visit https://developers.phrase.com/api/
Quick Start
This quick start will guide you through the basic steps to get up and running with the Phrase Strings Client.
1. Install
Download and install the client for your platform. See our detailed installation guide for more information.
Homebrew
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.
2. Init
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
3. Upload your locale files
Use the push
command to upload your locale files from your defined sources:
$ phrase push
4. Download your locale files
Use the pull
command to download the most recent locale files back into your project according to your targets:
$ phrase pull
5. Docker
You can also use phrase
through a docker image, without installing the cli on your computer.
$ docker run --rm phrase/phrase-cli:2.33.1 help
Some commands are interactive and require the -it
flag.
$ docker run -it phrase/phrase-cli:2.33.1 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.33.1 pull
You can also use the docker image as base for more complex images.
6. More
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.
Contributing
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.
Further reading
Licenses
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
Author
Get help / support
Please contact support@phrase.com and we can take more direct action toward finding a solution.