https://github.com/pedro-mendonca/convert-pt-ao90
Conversor de texto em português para a grafia do Acordo Ortográfico de 1990
https://github.com/pedro-mendonca/convert-pt-ao90
acordo-ortografico acordo-ortografico-1990 ao90 conversion converter hacktoberfest hacktoberfest2020 language phpstan portuguese tool
Last synced: 6 months ago
JSON representation
Conversor de texto em português para a grafia do Acordo Ortográfico de 1990
- Host: GitHub
- URL: https://github.com/pedro-mendonca/convert-pt-ao90
- Owner: pedro-mendonca
- License: gpl-3.0
- Created: 2020-10-14T12:46:37.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2025-01-07T00:09:44.000Z (9 months ago)
- Last Synced: 2025-03-10T21:45:51.716Z (7 months ago)
- Topics: acordo-ortografico, acordo-ortografico-1990, ao90, conversion, converter, hacktoberfest, hacktoberfest2020, language, phpstan, portuguese, tool
- Language: PHP
- Homepage: https://packagist.org/packages/pedro-mendonca/convert-pt-ao90
- Size: 5.76 MB
- Stars: 7
- Watchers: 3
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Convert PT AO90
[](https://packagist.org/packages/pedro-mendonca/convert-pt-ao90)
[](https://github.com/pedro-mendonca/Convert-PT-AO90/releases)
[](https://opensource.org/licenses/GPL-3.0)
[](https://github.com/pedro-mendonca/Convert-PT-AO90/actions/workflows/php-compatibility.yml)
[](https://github.com/sponsors/pedro-mendonca)
[](https://github.com/pedro-mendonca/Convert-PT-AO90/actions/workflows/test.yml)
[](https://github.com/pedro-mendonca/Convert-PT-AO90/actions/workflows/coding-standards.yml)
[](https://github.com/pedro-mendonca/Convert-PT-AO90/actions/workflows/static-analysis.yml)
[](https://app.codacy.com/gh/pedro-mendonca/Convert-PT-AO90?utm_source=github.com&utm_medium=referral&utm_content=pedro-mendonca/Convert-PT-AO90&utm_campaign=Badge_Grade)
## Description
Language tool to convert text according to the [Portuguese Language Orthographic Agreement of 1990](https://en.wikipedia.org/wiki/Portuguese_Language_Orthographic_Agreement_of_1990) ([PT AO90](https://pt.wikipedia.org/wiki/Acordo_Ortogr%C3%A1fico_de_1990))
## Installation instructions
Installation can be done with [Composer](https://getcomposer.org/), by requiring this package as a dependency:
```command-line
composer require pedro-mendonca/convert-pt-ao90
```
Make sure to include composer autoload in your project:
```php
/**
* Include Composer autoload.
*/
require 'vendor/autoload.php';
```
If you don't use [Composer](https://getcomposer.org/), you can **install manually** by downloading the [latest release](https://github.com/pedro-mendonca/Convert-PT-AO90/releases/latest), add it to your project folder and **include** the main file in your code:
```php
/**
* Include Convert-PT-AO90.
*/
require_once '/convert-pt-ao90/convert-pt-ao90.php';
```
## Usage
Examples:
1. Convert text string:
```php
$text = 'Não me pélo pelo pêlo de quem pára para resistir!';
$string_ao90 = Convert_PT_AO90\convert_pt_ao90( $text );
echo $string_ao90;
```
2. See more examples and the complete replace pairs in the file [example.php](https://github.com/pedro-mendonca/Convert-PT-AO90/blob/main/example.php).
## Changelog
### 1.3.3
* Fix converting strings with trailing space returning null.
* Update dependencies.
* Add more test cases.
* Tested up to PHP 8.3.
### 1.3.2
* Fix variable type error.
* Add some more replace pairs.
* Rebuild replace pairs.
* Update dependencies.
* Tested only on supported PHP versions (7.4+).
### 1.3.1
* Fix matching for words with exact case on the replace pairs.
### 1.3.0
* Rebuild replace pairs with half the size.
* Improve performance by using only lowercase replace pairs.
* Fix matching words starting with an accented vowel.
* Remove wrong replace pairs about cardinal points (lowercased since 1945).
* Add some more replace pairs.
* Update dependencies.
### 1.2.3
* Rebuild replace pairs.
### 1.2.2
* Fix sentence boundary issue with HTML after ending.
* Add sentence boundary after two new lines.
* Add more tests: new lines followed by HTML.
### 1.2.1
* Fix JSON path issue when used as dependency.
### 1.2.0
* Rebuild code to allow a detailed control over sentence and word boundaries.
* Fix problem of partial find+replace of words, now only whole words can be converted.
* Remove temporary bug fix of partial find+replace (acto->ato).
* Update main replace pairs library.
* Add more custom replace pairs rules.
* Rebuild and add both replace pairs JSON, minified and source (pretty).
* Add more tests for many different types of texts: Multiline, HTML, multiple sentences, etc.
### 1.1.0
* Use a pre-built Replace Pairs JSON file to improve performance (5x faster).
* Simplify Replace Pairs data.
* Bump minimum PHP to 7.2.
* Add Tests! [Run the Convert PT AO90](https://github.com/pedro-mendonca/Convert-PT-AO90/actions/workflows/test.yml) against a [set of text strings](https://github.com/pedro-mendonca/Convert-PT-AO90/blob/main/tests/convert-pt-ao90-test.php#L26:L70) with expected results.
* Add some custom replace pairs rules.
### 1.0.3
* Move CI to GitHub Actions.
* Bump PHPStan Level to 9.
* Add Markdownlint and PHPMD.
* Fix coding standards.
### 1.0.2
* Fix autoload and library path for package installed as composer dependency.
### 1.0.1
* Add Composer install support.
### 1.0.0
* Initial release.