Merge branch 'develop' into tests

Author: bionicman

.gitattributes

@@ -10,7 +10,3 @@
 *.md text
 *.json text
 *.yml text
-
-# Proprietary software authored by Vadim Rõbalko (Habr)
-# Contact: vadim@habr.team
-# License: proprietary (not open source)

CHANGELOG.md

@@ -4,6 +4,26 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0] – 2025-07-25
+
+### Added
+- **New model support**:
+  - **Anthropic Claude** (Haiku 3.5, Sonnet 4, Opus 4) via `AnthropicDriver`
+  - **Google Gemini** (2.0 Flash, 2.5 Flash, 2.5 Flash-Lite, 2.5 Pro) via `GoogleDriver`
+  - **OpenAI GPT Chat** (GPT-4, GPT-4 Turbo, GPT-4o, GPT-4o Mini) via `OpenAiDriver`
+- **HTTP proxy** support (`--proxy` flag / `BBLSLUG_PROXY`) in `HttpClient` and CLI
+- **YAML-based registry** (`resources/models.yaml`) replacing the PHP model config
+
+### Changed
+- **Registry keys & auth flags**:
+  - Renamed `gemini:*` → `google:gemini-*`
+  - Added `ANTHROPIC_API_KEY` and updated `--api-key-google` / `GOOGLE_API_KEY`
+- Updated `README.md` & `Help.php` to list supported models
+- Minor cleanups: JSON payload alignment, code/style tweaks, help text refinements
+
+### Removed
+- Legacy PHP registry (`resources/models.php`)
+
 ## [0.4.0] - 2025-07-21
 ### Added
 - **Model driver abstraction**  

LICENSE

@@ -1,8 +1,21 @@
+MIT License
+
 Copyright (c) 2025 Vadim Rõbalko (Habr)
-All rights reserved.
 
-This software is proprietary and confidential. Unauthorized copying,
-modification, distribution, or use is strictly prohibited without
-explicit permission from the author.
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
 
-Contact: vadim@habr.team
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -2,13 +2,33 @@
 
 **Bblslug** is a versatile translation tool that can be used as both a **CLI utility** and a **PHP library**.
 
-It leverages LLM-based APIs (DeepL, OpenAI, Gemini) to translate plain text or HTML while preserving structure, code blocks, and URLs via placeholder filters.
+It leverages LLM-based APIs to translate plain text or HTML while preserving structure, code blocks, and URLs via placeholder filters.
+
+APIs supported:
+
+- Anthropic (Claude):
+ - `anthropic:claude-haiku-3.5` - Claude Haiku 3.5 (latest)
+ - `anthropic:claude-opus-4` - Claude Opus 4 (20250514)
+ - `anthropic:claude-sonnet-4` - Claude Sonnet 4 (20250514)
+- DeepL
+ - `deepl:free` - DeepL free tier
+ - `deepl:pro` - DeepL pro tier
+- Google (Gemini)
+ - `google:gemini-2.0-flash` - Gemini 2.0 Flash
+ - `google:gemini-2.5-flash` - Gemini 2.5 Flash
+ - `google:gemini-2.5-flash-lite` - Gemini 2.5 Flash Lite
+ - `google:gemini-2.5-pro` - Gemini 2.5 Pro
+- OpenAI (GPT)
+ - `openai:gpt-4` - OpenAI GPT-4
+ - `openai:gpt-4-turbo` - OpenAI GPT-4 Turbo
+ - `openai:gpt-4o` - OpenAI GPT-4o
+ - `openai:gpt-4o-mini` - OpenAI GPT-4o Mini
 
 ## Features
 
 - Supports **html** and **plain text** (`--format=text|html`)
 - Placeholder-based protection with filters: `html_pre`, `html_code`, `url`, etc.
-- Model selection via `--model=vendor:name` (`deepl:free`, `deepl:pro`, `openai:gpt-4o`, `gemini:1.5-pro`, …)
+- Model selection via `--model=vendor:name` (`deepl:pro`, `google:gemini-2.5-flash`, `openai:gpt-4o`, …)
 - Fully configurable backend registry
 - **Dry-run** mode to preview placeholders without making API calls
 - **Verbose** mode (`--verbose`) to print request previews
@@ -28,17 +48,33 @@ chmod +x vendor/bin/bblslug
 2. **Export your API key(s)** before running:
 
  ```bash
+ export ANTHROPIC_API_KEY=...
  export DEEPL_FREE_API_KEY=...
  export DEEPL_PRO_API_KEY=...
+ export GOOGLE_API_KEY=...
  export OPENAI_API_KEY=...
- export GEMINI_API_KEY=...
  ```
 
 3. **Input / output**:
 
  - If `--source` is omitted, Bblslug reads from **STDIN**.
  - If `--translated` is omitted, Bblslug writes to **STDOUT**.
 
+4. **Optional proxy**:
+
+To route requests through a proxy (e.g. HTTP or SOCKS5), use the `--proxy` option or set the `BBLSLUG_PROXY` environment variable:
+
+```bash
+# using CLI flag
+vendor/bin/bblslug --proxy="http://localhost:8888" ...
+
+# or set it globally
+export BBLSLUG_PROXY="socks5h://127.0.0.1:9050"
+```
+
+This works for all HTTP requests and supports authentication (`http://user:pass@host:port`).
+
+
 ### Show available models
 ```bash
 vendor/bin/bblslug --list-models
@@ -141,18 +177,19 @@ $text   = file_get_contents('input.html');
 
 // Call library translate method
 $result = Bblslug::translate(
-    modelKey:   'deepl:pro',                     // Model identifier (e.g. deepl:free, deepl:pro, openai:gpt-4o)
     apiKey:     getenv('DEEPL_PRO_API_KEY'),     // API key for the chosen model
     format:     'html',                          // 'text' or 'html'
+    modelKey:   'deepl:pro',                     // Model identifier (e.g. deepl:free, deepl:pro, openai:gpt-4o)
     text:       $text,                           // Source text or HTML
 
     // optional parameters:
     context:    null,                            // Additional context/prompt (DeepL: context)
     dryRun:     false,                           // If true, only prepare placeholders, no API call
     filters:    ['url', 'html_code'],            // List of placeholder filters
+    proxy:      getenv('BBLSLUG_PROXY'),         // Optional proxy URI (http://..., socks5h://...)
     sourceLang: null,                            // Source language code (optional; autodetect if null)
-    targetLang: null,                            // Target language code (optional; default from registry)
-    verbose:    true                             // If true, prints debug request/response to stderr
+    targetLang: null,                            // Target language code (optional; default from driver settings)
+    verbose:    true,                            // If true, prints debug request/response to stderr
 );
 
 // Result output example
@@ -178,4 +215,4 @@ You can find sample input files under the `examples/` directory.
 
 ## License
 
-Private project, not yet open-source.
+This project is licensed under the MIT License – see the [LICENSE](LICENSE) file for details.

composer.json

@@ -1,12 +1,22 @@
 {
-  "name": "tools/bblslug",
+  "name": "habr/bblslug",
   "description": "CLI translation tool for HTML and plain text using LLM-based APIs.",
-  "license": "proprietary",
+  "keywords": ["translation","LLM","deepl","openai"],
+  "homepage": "https://github.com/habralab/bblslug",
+  "license": "MIT",
   "type": "library",
+  "authors": [
+    {
+      "name": "Vadim Rybalko",
+      "email": "vadim@habr.team",
+      "role": "Lead"
+    }
+  ],
   "require": {
     "php": ">=8.0",
     "ext-curl": "*",
-    "ext-mbstring": "*"
+    "ext-mbstring": "*",
+    "symfony/yaml": "^7.3"
   },
   "require-dev": {
     "squizlabs/php_codesniffer": "^3.13",
@@ -28,11 +38,5 @@
   "scripts": {
     "lint": "vendor/bin/phpcs --standard=phpcs.xml",
     "phpunit": "vendor/bin/phpunit --testdox --colors=always --log-junit .phpunit.junit.xml"
-  },
-  "authors": [
-    {
-      "name": "Vadim Rybalko",
-      "role": "Lead"
-    }
-  ]
+  }
 }