Ciceron

ciceron is an npm package that translates file comments from an auto-detected language to another language using the DEEPL© API.

Table of Contents

• 🌟 Features
• 📌 Prerequisite
• 📦 Installation
• 📖 Usage
  • 🖥️ CLI Command
    • 💾 Using in global context
    • 🌐 Using npx
• ⚙️ Configuration
• 🈯 Supported Languages
• 🧩 Dependencies
• 📄 License
• ✍🏻 Author

🌟 Features

• Translate file comments from an auto-detected language to another language.
• Replace the original files or generate new files.
• Supports multiple languages.
• Easy to install. Easy to configure. Easy to use.

📌 Prerequisite

You need a DEEPL API key to use ciceron. If you don't have one yet, go to DEEPL to create a free account (up to 500.000 words / months with the free plan ) !

📦 Installation

We recommend installing ciceron globally:

npm i -g ciceron

If you prefer to install ciceron locally, we recommend adding it to your project dev dependencies:

npm i ciceron --save-dev

Then, add a new script in your package.json:

"scripts": {
  "translate": "ciceron translate"
}

Finally, run the following command in your terminal:

npm run translate <file>

You will then be prompted to select the target language and choose whether to replace the original files or generate a new file.

📖 Usage

🖥️ CLI Command

💾 If ciceron is installed globally, run:

ciceron translate <file>

Example

# drag and drop the file
ciceron translate ./src/example.js

# or write the file name in plain text
ciceron translate example.js

You will then be prompted to select the target language and choose whether to replace the original files or generate a new file.

🌐 If ciceron is neither installed globally nor locally, you still can run:

npx ciceron translate <file>

Example

# drag and drop the file
npx ciceron translate ./src/example.js

# or write the file name in plain text
npx ciceron translate example.js

You will then be prompted to select the target language and choose whether to replace the original files or generate a new file.

⚙️ Configuration

ciceron requires a short configuration.

Make sure to install dotenv locally:

npm i dotenv

Set your DEEPL API key in the .env file at the root of your project:

// myproject/.env
DEEPL_API_KEY=your_deepl_api_key

Note: With DEEPL's free offer, you have access to an API credit of 500,000 words per month.

🈯 Supported Languages

ciceron supports the following languages:

• English 🇬🇧
• French 🇫🇷
• German 🇩🇪
• Italian 🇮🇹
• Spanish 🇪🇸
• Dutch 🇳🇱
• Portuguese 🇵🇹
• Japanese 🇯🇵
• Korean 🇰🇷
• Chinese (simplified) 🇨🇳
• Ukrainian 🇺🇦
• Russian 🇷🇺

🧩 Dependencies

• chalk
• commander
• deepl-node
• dotenv
• figlet
• fs-extra
• inquirer

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

✍🏻 Author

Louis-Antonin Lesieur