SEO meta tag and social sharing tag generator (OpenGraph, Twitter Card, Facebook). Python fork of robsonvleite/optimizer (PHP).

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

kauelima21

These details have not been verified by PyPI

Project links

Original PHP

Project description

Optimizer (Python)

Port em Python do pacote PHP coffeecode/optimizer de Robson V. Leite. Gera tags <head> para SEO, Open Graph, Twitter Card e Facebook com uma API fluente — direto ao ponto, sem dependencias.

Python port of the PHP package coffeecode/optimizer by Robson V. Leite. Builds <head> tags for SEO, Open Graph, Twitter Card, and Facebook through a fluent API. Zero dependencies.

Destaques

API fluente: optimize → publisher → open_graph → twitter_card → facebook → render
Tags <title>, <meta>, <link rel=canonical> com escape automatico
Acesso aos dados via atributos: op.title, op.description, op.url, op.image
Pure Python — sem dependencias de runtime

Instalacao

pip install coffeecode-optimizer

Requer Python >= 3.9.

Uso

from coffeecode_optimizer import Optimizer

op = (
    Optimizer()
    .optimize(
        title="Optimizer Happy and @CoffeeCode",
        description="Is a compact and easy-to-use tag creator to optimize your site",
        url="https://www.upinside.com.br/coffeecode/optimizer/example/",
        image="https://www.upinside.com.br/uploads/images/example.jpg",
    )
    .publisher("upinside", "robsonvleite")
    .twitter_card("@robsonvleite", "@robsonvleite", "upinside.com.br", "summary_large_image")
    .open_graph("upinside", "pt_BR", "article")
    .facebook(admins=["626590460695980", "626590460695981"])
)

print(op.render())
print(op.title, op.description)

FastAPI

from fastapi import FastAPI
from fastapi.responses import HTMLResponse
from coffeecode_optimizer import Optimizer

app = FastAPI()

@app.get("/", response_class=HTMLResponse)
def home():
    op = (
        Optimizer()
        .optimize("Title", "Desc", "https://example.com/", "https://example.com/img.jpg")
        .open_graph("example")
        .twitter_card("@me", "@me", "example.com")
    )
    return f"<!doctype html><html><head>{op.render()}</head><body><h1>{op.title}</h1></body></html>"

Flask

from flask import Flask
from coffeecode_optimizer import Optimizer

app = Flask(__name__)

@app.route("/")
def home():
    op = Optimizer().optimize("T", "D", "https://u", "https://i").open_graph("site")
    return f"<!doctype html><html><head>{op.render()}</head></html>"

API

`Optimizer()`

Construtor sem argumentos. Cada chamada de builder retorna self para encadeamento. Encerre com .render().

`optimize(title, description, url, image, follow=True) -> Optimizer`

Emite o conjunto principal: <title>, <meta name="description">, <meta name="robots">, <link rel="canonical">, bloco Open Graph, bloco Twitter Card, bloco itemprop (Schema.org).

`publisher(fb_page, fb_author=None) -> Optimizer`

Emite article:publisher (e opcionalmente article:author) apontando para URLs do Facebook.

`open_graph(site_name, locale="pt_BR", schema="article") -> Optimizer`

Emite og:type, og:site_name, og:locale. Alias openGraph mantido para compatibilidade com a API PHP.

`twitter_card(creator, site, domain, card=None) -> Optimizer`

Emite twitter:card (default summary_large_image), twitter:site, twitter:creator, twitter:domain. Alias twitterCard disponivel.

`facebook(app_id=None, admins=None) -> Optimizer`

Emite fb:app_id OU multiplas fb:admins (mutuamente exclusivos).

`render() -> str`

Concatena todas as tags acumuladas em uma unica string.

`debug(sort=True) -> list[str]`

Retorna a lista de tags ja renderizadas (uma string por tag).

`data(title=None, description=None, url=None, image=None) -> SimpleNamespace`

Define ou consulta o namespace de dados acessivel via op.title, op.url, etc.

Equivalencia com a versao PHP

PHP	Python
`CoffeeCode\Optimizer\Optimizer`	`coffeecode_optimizer.Optimizer`
`CoffeeCode\Optimizer\MetaTags`	`coffeecode_optimizer.MetaTags`
`optimize()`	`optimize()`
`publisher()`	`publisher()`
`openGraph()`	`open_graph()` (alias `openGraph`)
`twitterCard()`	`twitter_card()` (alias `twitterCard`)
`facebook()`	`facebook()`
`render() / debug() / data()`	`render() / debug() / data()`
`SimpleXMLIterator` + `urlencode` round-trip	Lista de dicts + `html.escape` no render

Creditos

API original: Robson V. Leite — coffeecode/optimizer (MIT)
Port Python: Kaue Leal

Licenca

MIT.

Project details

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

kauelima21

These details have not been verified by PyPI

Project links

Original PHP

Release history Release notifications | RSS feed

This version

1.0.0

Apr 30, 2026

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

coffeecode_optimizer-1.0.0.tar.gz (8.5 kB view details)

Uploaded Apr 30, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

coffeecode_optimizer-1.0.0-py3-none-any.whl (7.6 kB view details)

Uploaded Apr 30, 2026 Python 3

File details

Details for the file coffeecode_optimizer-1.0.0.tar.gz.

File metadata

Download URL: coffeecode_optimizer-1.0.0.tar.gz
Upload date: Apr 30, 2026
Size: 8.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for coffeecode_optimizer-1.0.0.tar.gz
Algorithm	Hash digest
SHA256	`9851d9054b5fb05ce6190db83c7e2232f8235416628a7a3d2c34bafbe82a8ca2`
MD5	`3cff63daf6a6e5a32a7308f3fd908130`
BLAKE2b-256	`1faf3cf870995039f49c493cdbdf57020df6fd9515cf074bf05bdf82f9a47c8e`

See more details on using hashes here.

Provenance

The following attestation bundles were made for coffeecode_optimizer-1.0.0.tar.gz:

Publisher: release.yml on kauelima21/coffeecode-optimizer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: coffeecode_optimizer-1.0.0.tar.gz
- Subject digest: 9851d9054b5fb05ce6190db83c7e2232f8235416628a7a3d2c34bafbe82a8ca2
- Sigstore transparency entry: 1414872833
- Sigstore integration time: Apr 30, 2026
Source repository:
- Permalink: kauelima21/coffeecode-optimizer@a7c0fac05941a33044f84b11f6952847a1c6714d
- Branch / Tag: refs/tags/v1.0.0
- Owner: https://github.com/kauelima21
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@a7c0fac05941a33044f84b11f6952847a1c6714d
- Trigger Event: push

File details

Details for the file coffeecode_optimizer-1.0.0-py3-none-any.whl.

File metadata

Download URL: coffeecode_optimizer-1.0.0-py3-none-any.whl
Upload date: Apr 30, 2026
Size: 7.6 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for coffeecode_optimizer-1.0.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`004599f42e8e11bca5d10d317c53250f6723f2abc866b2368315852d3d619297`
MD5	`fc5ce2acc250dc29dcaf992670b2ec1e`
BLAKE2b-256	`dba11192e23186238f0aeb9c61c7eee1fbdbff8c21a3cf5e757344fb4b6b6009`

See more details on using hashes here.

Provenance

The following attestation bundles were made for coffeecode_optimizer-1.0.0-py3-none-any.whl:

Publisher: release.yml on kauelima21/coffeecode-optimizer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: coffeecode_optimizer-1.0.0-py3-none-any.whl
- Subject digest: 004599f42e8e11bca5d10d317c53250f6723f2abc866b2368315852d3d619297
- Sigstore transparency entry: 1414872911
- Sigstore integration time: Apr 30, 2026
Source repository:
- Permalink: kauelima21/coffeecode-optimizer@a7c0fac05941a33044f84b11f6952847a1c6714d
- Branch / Tag: refs/tags/v1.0.0
- Owner: https://github.com/kauelima21
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@a7c0fac05941a33044f84b11f6952847a1c6714d
- Trigger Event: push

coffeecode-optimizer 1.0.0

Navigation

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

Optimizer (Python)

Destaques

Instalacao

Uso

FastAPI

Flask

API

Optimizer()

optimize(title, description, url, image, follow=True) -> Optimizer

publisher(fb_page, fb_author=None) -> Optimizer

open_graph(site_name, locale="pt_BR", schema="article") -> Optimizer

twitter_card(creator, site, domain, card=None) -> Optimizer

facebook(app_id=None, admins=None) -> Optimizer

render() -> str

debug(sort=True) -> list[str]

data(title=None, description=None, url=None, image=None) -> SimpleNamespace

Equivalencia com a versao PHP

Creditos

Licenca

Project details

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

`Optimizer()`

`optimize(title, description, url, image, follow=True) -> Optimizer`

`publisher(fb_page, fb_author=None) -> Optimizer`

`open_graph(site_name, locale="pt_BR", schema="article") -> Optimizer`

`twitter_card(creator, site, domain, card=None) -> Optimizer`

`facebook(app_id=None, admins=None) -> Optimizer`

`render() -> str`

`debug(sort=True) -> list[str]`

`data(title=None, description=None, url=None, image=None) -> SimpleNamespace`