Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

desacordo_ortografico

Detect and convert between Portuguese orthographies: the pre-1911 etymological writing, the Reforma de 1911, the Brazilian (1943 / 1971) and European (1945 / 1973) standards, and the Acordo Ortográfico de 1990, including the European and Brazilian sub-variants that AO1990 deliberately keeps distinct.

This is a single-purpose library. It does orthography detection and conversion, and nothing else.

  • Convert any text between seven orthographic norms along a graph of historical reforms, with AO1990 dual-form (facto/fato) handling.
  • Detect which orthography a text is written in: an explainable rule scorer, or two shipped zero-dependency learned classifiers (Naive Bayes / averaged perceptron).
  • Guard against sister varieties (Mirandese, Galician, Barranquenho) that look like Portuguese but are not.
  • A deterministic rule engine and curated, sourced exception lexicons. AO1990 word data is reused from tugalex.
  • A command-line tool and a parallel silver benchmark corpus (written by language models, not checked by a person), also published on the Hugging Face Hub.

Why it is not a single find-and-replace

Portuguese spelling is a (variant × era) matrix, not one timeline. Two official standards ran in parallel for most of the 20th century:

European / PALOP:  etymological → 1911 → 1945 → 1973 → AO1990 (PT)
Brazilian:         etymological → 1911 → 1943 → 1971 → AO1990 (BR)

AO1990 still admits divergent European/Brazilian spellings (facto/fato, António/Antônio, receção/recepção). A conversion is therefore a path through a graph of norms, applied edge by edge.

Some edges are clean regex rules (ph→f, trema abolition, the accent drops). Others are irreducibly lexical: which silent consonant drops, which form a norm prefers. Those are driven by curated, sourced data.

Install

pip install desacordo_ortografico    # pulls in tugalex

Use

from desacordo_ortografico import detect, convert, OrthographyConverter

# --- detection -----------------------------------------------------------
detect("a pharmacia do theatro").id          # 'etymological'
detect("Tambêm sei!").id                      # 'reforma_1911'  (1911 spelling)
detect("o facto é óptimo").id                 # 'pt_1973'   (pre-AO1990, European)
detect("a idéia do vôo").id                   # 'br_1971'   (pre-AO1990, Brazilian)
detect("o Antônio é econômico").id            # 'ao1990-br'

# --- conversion ----------------------------------------------------------
convert("pharmacia", "etymological", "ao1990-br")          # 'farmácia'
convert("a acção directa", "pre-ao1990-pt", "ao1990-pt")   # 'a ação direta'
convert("freqüência", "pre-ao1990-br", "ao1990-br")        # 'frequência'
convert("húmido", "ao1990-pt", "ao1990-br")                # 'úmido'

# --- the full result: warnings + dual-form alternatives ------------------
conv = OrthographyConverter()
res = conv.convert("o facto é óptimo", "ao1990-pt", "ao1990-br")
res.text            # 'o facto é óptimo'  (the VOLP lists both forms of each word)
res.alternatives    # {'facto': ['facto', 'fato']}
conv.permitted_spellings("receção", "ao1990-pt")   # ['receção', 'recepção']

Detection: rules or a learned model

detect() defaults to an explainable rule scorer. Two zero-dependency learned models also ship: Naive Bayes and an averaged perceptron over character n-grams, sharing one sparse-dot-product scoring rule. They score higher on sentence-length text (~96% vs ~94% compatible accuracy on the silver corpus, held-out 5-fold CV; see benchmark/):

detect("o Antônio era um génio econômico", method="nb")          # learned
detect("o Antônio era um génio econômico", method="perceptron")  # learned
detect("o Antônio era um génio econômico")                       # rules (default)

The guard runs first in every mode. Rule markers attach to a learned result for explainability.

Sister-language guard

Mirandese, Galician (especially reintegrationist), and Barranquenho look like Portuguese but are not. detect() recognizes and flags them rather than mangling them:

from desacordo_ortografico.guard import NotPortuguese
r = detect("umha cançom da naçom")
isinstance(r, NotPortuguese)   # True
r.name, r.convertible          # ('Galician', False)

CLI

desacordo detect "a pharmacia do theatro"
desacordo convert --from pre-ao1990-pt --to ao1990-pt "a acção directa"
desacordo convert --from ao1990-pt --to ao1990-br --variant br "o facto"
desacordo norms          # list the available orthographic norms

Norms

id reform who / when
etymological pre-1911 pseudo-etymological —
reforma_1911 Reforma Ortográfica de 1911 Portugal, 1911
br_1943 Formulário Ortográfico de 1943 Brazil (ABL)
pt_1945 Convenção Luso-Brasileira de 1945 Portugal + PALOP
br_1971 accent mini-reform (Lei 5.765) Brazil, 1971
pt_1973 accent mini-reform (DL 32/73) Portugal, 1973
ao1990-pt / ao1990-br Acordo Ortográfico de 1990 all CPLP

See docs/orthographies.md for the rule sets and sources.

Reversibility

Forward conversion (toward newer norms) is well defined. Backward conversion is, for several edges, lexical and lossy. Dropping a silent consonant or an accent discards information no rule can recover. ConversionResult.lossless and .warnings report this instead of silently guessing.

  • tugalex — the AO1990 word-map data this library reuses.

License

Apache-2.0.

Metadata

Release files for desacordo-ortografico 0.2.0a2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for desacordo-ortografico 0.2.0a2
File Size Uploaded Provenance Actions
desacordo_ortografico-0.2.0a2.tar.gz 1.0 MB Without provenance Details for desacordo_ortografico-0.2.0a2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for desacordo-ortografico 0.2.0a2
File Interpreter ABI Platform Actions
desacordo_ortografico-0.2.0a2-py3-none-any.whl Python 3 none any Details for desacordo_ortografico-0.2.0a2-py3-none-any.whl

Total release size: 2.0 MB

Release files / desacordo_ortografico-0.2.0a2.tar.gz

Download URL desacordo_ortografico-0.2.0a2.tar.gz
Size 1.0 MB
Tags Source
SHA-256 checksum
How to use checksums
d0fabc8af75e1c900672b410a35d1a3cba92a844d8d76ac4d399c0794b5e6856
BLAKE2b-256 checksum
How to use checksums
e2bc1ce6b3b0cc183a211d9bdabf0ad278103ad725423697322749d00e4cf53c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / desacordo_ortografico-0.2.0a2-py3-none-any.whl

Download URL desacordo_ortografico-0.2.0a2-py3-none-any.whl
Size 1.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
a3bbc62188e4c636db662140f965a78ce8f0d61224792e986cbcd8be0b3237b9
BLAKE2b-256 checksum
How to use checksums
3f07198bb3d2d89823e6b57b4a1fa17c1662ab1937921bf2869a51c276776410
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Security for desacordo-ortografico 0.2.0a2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page